Fix for 1278834
[awesomized/libmemcached] / libmemcached / result.cc
1 /* vim:expandtab:shiftwidth=2:tabstop=2:smarttab:
2 *
3 * Libmemcached library
4 *
5 * Copyright (C) 2011-2013 Data Differential, http://datadifferential.com/
6 * Copyright (C) 2006-2009 Brian Aker All rights reserved.
7 *
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions are
10 * met:
11 *
12 * * Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 *
15 * * Redistributions in binary form must reproduce the above
16 * copyright notice, this list of conditions and the following disclaimer
17 * in the documentation and/or other materials provided with the
18 * distribution.
19 *
20 * * The names of its contributors may not be used to endorse or
21 * promote products derived from this software without specific prior
22 * written permission.
23 *
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
25 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
26 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
27 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
28 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
29 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
30 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
31 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
32 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
33 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
34 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
35 *
36 */
37
38
39 /*
40 memcached_result_st are used to internally represent the return values from
41 memcached. We use a structure so that long term as identifiers are added
42 to memcached we will be able to absorb new attributes without having
43 to addjust the entire API.
44 */
45 #include <libmemcached/common.h>
46
47 static inline void _result_init(memcached_result_st *self,
48 Memcached *memc)
49 {
50 self->item_flags= 0;
51 self->item_expiration= 0;
52 self->key_length= 0;
53 self->item_cas= 0;
54 self->root= memc;
55 self->numeric_value= UINT64_MAX;
56 self->count= 0;
57 self->item_key[0]= 0;
58 }
59
60 memcached_result_st *memcached_result_create(const memcached_st *shell,
61 memcached_result_st *ptr)
62 {
63 const Memcached* memc= memcached2Memcached(shell);
64
65 /* Saving malloc calls :) */
66 if (ptr)
67 {
68 ptr->options.is_allocated= false;
69 }
70 else
71 {
72 ptr= libmemcached_xmalloc(memc, memcached_result_st);
73
74 if (not ptr)
75 {
76 return NULL;
77 }
78
79 ptr->options.is_allocated= true;
80 }
81
82 ptr->options.is_initialized= true;
83
84 _result_init(ptr, (memcached_st *)memc);
85
86 WATCHPOINT_SET(ptr->value.options.is_initialized= false);
87 memcached_string_create((memcached_st*)memc, &ptr->value, 0);
88 WATCHPOINT_ASSERT_INITIALIZED(&ptr->value);
89 WATCHPOINT_ASSERT(ptr->value.string == NULL);
90
91 return ptr;
92 }
93
94 void memcached_result_reset(memcached_result_st *ptr)
95 {
96 ptr->key_length= 0;
97 memcached_string_reset(&ptr->value);
98 ptr->item_flags= 0;
99 ptr->item_cas= 0;
100 ptr->item_expiration= 0;
101 ptr->numeric_value= UINT64_MAX;
102 }
103
104 void memcached_result_free(memcached_result_st *ptr)
105 {
106 if (ptr == NULL)
107 {
108 return;
109 }
110
111 memcached_string_free(&ptr->value);
112 ptr->numeric_value= UINT64_MAX;
113
114 if (memcached_is_allocated(ptr))
115 {
116 WATCHPOINT_ASSERT(ptr->root); // Without a root, that means that result was not properly initialized.
117 libmemcached_free(ptr->root, ptr);
118 }
119 else
120 {
121 ptr->count= 0;
122 ptr->options.is_initialized= false;
123 }
124 }
125
126 void memcached_result_reset_value(memcached_result_st *ptr)
127 {
128 memcached_string_reset(&ptr->value);
129 }
130
131 memcached_return_t memcached_result_set_value(memcached_result_st *ptr,
132 const char *value,
133 size_t length)
134 {
135 if (memcached_failed(memcached_string_append(&ptr->value, value, length)))
136 {
137 return memcached_set_errno(*ptr->root, errno, MEMCACHED_AT);
138 }
139
140 return MEMCACHED_SUCCESS;
141 }
142
143 const char *memcached_result_key_value(const memcached_result_st *self)
144 {
145 return self->key_length ? self->item_key : NULL;
146 }
147
148 size_t memcached_result_key_length(const memcached_result_st *self)
149 {
150 return self->key_length;
151 }
152
153 const char *memcached_result_value(const memcached_result_st *self)
154 {
155 const memcached_string_st *sptr= &self->value;
156 return memcached_string_value(sptr);
157 }
158
159 size_t memcached_result_length(const memcached_result_st *self)
160 {
161 const memcached_string_st *sptr= &self->value;
162 return memcached_string_length(sptr);
163 }
164
165 char *memcached_result_take_value(memcached_result_st *self)
166 {
167 memcached_string_st *sptr= &self->value;
168 return memcached_string_take_value(sptr);
169 }
170
171 uint32_t memcached_result_flags(const memcached_result_st *self)
172 {
173 return self->item_flags;
174 }
175
176 uint64_t memcached_result_cas(const memcached_result_st *self)
177 {
178 return self->item_cas;
179 }
180
181 void memcached_result_set_flags(memcached_result_st *self, uint32_t flags)
182 {
183 self->item_flags= flags;
184 }
185
186 void memcached_result_set_expiration(memcached_result_st *self, time_t expiration)
187 {
188 self->item_expiration= expiration;
189 }