git.m6w6.name Git - m6w6/libmemcached/blob - libmemcached/result.cc

   1 /*  vim:expandtab:shiftwidth=2:tabstop=2:smarttab:
   2  *
   3  *  Libmemcached library
   4  *
   5  *  Copyright (C) 2011 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_st *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 *memc,
  61                                              memcached_result_st *ptr)
  62 {
  63   WATCHPOINT_ASSERT(memc);
  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 uint32_t memcached_result_flags(const memcached_result_st *self)
 166 {
 167   return self->item_flags;
 168 }
 169
 170 uint64_t memcached_result_cas(const memcached_result_st *self)
 171 {
 172   return self->item_cas;
 173 }
 174
 175 void memcached_result_set_flags(memcached_result_st *self, uint32_t flags)
 176 {
 177   self->item_flags= flags;
 178 }
 179
 180 void memcached_result_set_expiration(memcached_result_st *self, time_t expiration)
 181 {
 182   self->item_expiration= expiration;
 183 }