git.m6w6.name Git - awesomized/libmemcached/blob - libmemcached/result.h

   1 /* LibMemcached
   2  * Copyright (C) 2006-2009 Brian Aker
   3  * All rights reserved.
   4  *
   5  * Use and distribution licensed under the BSD license.  See
   6  * the COPYING file in the parent directory for full text.
   7  *
   8  * Summary: Functions to manipulate the result structure.
   9  *
  10  */
  11
  12 #ifndef __MEMCACHED_RESULT_H__
  13 #define __MEMCACHED_RESULT_H__
  14
  15 #ifdef __cplusplus
  16 extern "C" {
  17 #endif
  18
  19 struct memcached_result_st {
  20   uint32_t item_flags;
  21   time_t item_expiration;
  22   size_t key_length;
  23   uint64_t item_cas;
  24   const memcached_st *root;
  25   memcached_string_st value;
  26   char item_key[MEMCACHED_MAX_KEY];
  27   struct {
  28     bool is_allocated:1;
  29     bool is_initialized:1;
  30   } options;
  31   /* Add result callback function */
  32 };
  33
  34 /* Result Struct */
  35 LIBMEMCACHED_API
  36 void memcached_result_free(memcached_result_st *result);
  37
  38 LIBMEMCACHED_API
  39 void memcached_result_reset(memcached_result_st *ptr);
  40
  41 LIBMEMCACHED_API
  42 memcached_result_st *memcached_result_create(const memcached_st *ptr,
  43                                              memcached_result_st *result);
  44
  45 static inline const char *memcached_result_key_value(const memcached_result_st *self)
  46 {
  47   return self->key_length ? self->item_key : NULL;
  48 }
  49
  50 static inline size_t memcached_result_key_length(const memcached_result_st *self)
  51 {
  52   return self->key_length;
  53 }
  54
  55 static inline const char *memcached_result_value(const memcached_result_st *self)
  56 {
  57   const memcached_string_st *sptr= &self->value;
  58   return memcached_string_value(sptr);
  59 }
  60
  61 static inline size_t memcached_result_length(const memcached_result_st *self)
  62 {
  63   const memcached_string_st *sptr= &self->value;
  64   return memcached_string_length(sptr);
  65 }
  66
  67 static inline uint32_t memcached_result_flags(const memcached_result_st *self)
  68 {
  69   return self->item_flags;
  70 }
  71
  72 static inline uint64_t memcached_result_cas(const memcached_result_st *self)
  73 {
  74   return self->item_cas;
  75 }
  76
  77 LIBMEMCACHED_API
  78 memcached_return_t memcached_result_set_value(memcached_result_st *ptr, const char *value, size_t length);
  79
  80 static inline void memcached_result_set_flags(memcached_result_st *self, uint32_t flags)
  81 {
  82   self->item_flags= flags;
  83 }
  84
  85 static inline void memcached_result_set_expiration(memcached_result_st *self, time_t expiration)
  86 {
  87   self->item_expiration= expiration;
  88 }
  89
  90 #ifdef __cplusplus
  91 }
  92 #endif
  93
  94 #endif /* __MEMCACHED_RESULT_H__ */