1 /* vim:expandtab:shiftwidth=2:tabstop=2:smarttab:
5 * Copyright (C) 2011 Data Differential, http://datadifferential.com/
6 * Copyright (C) 2006-2009 Brian Aker All rights reserved.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions are
12 * * Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
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
20 * * The names of its contributors may not be used to endorse or
21 * promote products derived from this software without specific prior
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.
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.
45 #include <libmemcached/common.h>
47 static inline void _result_init(memcached_result_st
*self
,
51 self
->item_expiration
= 0;
58 memcached_result_st
*memcached_result_create(const memcached_st
*memc
,
59 memcached_result_st
*ptr
)
61 WATCHPOINT_ASSERT(memc
);
63 /* Saving malloc calls :) */
66 ptr
->options
.is_allocated
= false;
70 ptr
= static_cast<memcached_result_st
*>(libmemcached_malloc(memc
, sizeof(memcached_result_st
)));
75 ptr
->options
.is_allocated
= true;
78 ptr
->options
.is_initialized
= true;
80 _result_init(ptr
, (memcached_st
*)memc
);
82 WATCHPOINT_SET(ptr
->value
.options
.is_initialized
= false);
83 memcached_string_create((memcached_st
*)memc
, &ptr
->value
, 0);
84 WATCHPOINT_ASSERT_INITIALIZED(&ptr
->value
);
85 WATCHPOINT_ASSERT(ptr
->value
.string
== NULL
);
90 void memcached_result_reset(memcached_result_st
*ptr
)
93 memcached_string_reset(&ptr
->value
);
96 ptr
->item_expiration
= 0;
99 void memcached_result_free(memcached_result_st
*ptr
)
104 memcached_string_free(&ptr
->value
);
106 if (memcached_is_allocated(ptr
))
108 WATCHPOINT_ASSERT(ptr
->root
); // Without a root, that means that result was not properly initialized.
109 libmemcached_free(ptr
->root
, ptr
);
113 ptr
->options
.is_initialized
= false;
117 memcached_return_t
memcached_result_set_value(memcached_result_st
*ptr
,
121 if (memcached_failed(memcached_string_append(&ptr
->value
, value
, length
)))
123 return memcached_set_errno(*ptr
->root
, errno
, MEMCACHED_AT
);
126 return MEMCACHED_SUCCESS
;
129 const char *memcached_result_key_value(const memcached_result_st
*self
)
131 return self
->key_length
? self
->item_key
: NULL
;
134 size_t memcached_result_key_length(const memcached_result_st
*self
)
136 return self
->key_length
;
139 const char *memcached_result_value(const memcached_result_st
*self
)
141 const memcached_string_st
*sptr
= &self
->value
;
142 return memcached_string_value(sptr
);
145 size_t memcached_result_length(const memcached_result_st
*self
)
147 const memcached_string_st
*sptr
= &self
->value
;
148 return memcached_string_length(sptr
);
151 uint32_t memcached_result_flags(const memcached_result_st
*self
)
153 return self
->item_flags
;
156 uint64_t memcached_result_cas(const memcached_result_st
*self
)
158 return self
->item_cas
;
161 void memcached_result_set_flags(memcached_result_st
*self
, uint32_t flags
)
163 self
->item_flags
= flags
;
166 void memcached_result_set_expiration(memcached_result_st
*self
, time_t expiration
)
168 self
->item_expiration
= expiration
;