X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fmemcached_result_st.rst;h=fab6c4a41b0c93f1a398efb30c2f7293d33600e7;hb=6dab5e4d5dfb6145966a3efa48a41cf7e609c9ad;hp=818b4991eba531d44aef75685794da0bfcf62294;hpb=e668c212d13197abf5d8e2ddc7916057c94325b6;p=awesomized%2Flibmemcached diff --git a/docs/memcached_result_st.rst b/docs/memcached_result_st.rst index 818b4991..fab6c4a4 100644 --- a/docs/memcached_result_st.rst +++ b/docs/memcached_result_st.rst @@ -2,53 +2,40 @@ Working with result sets ======================== +.. index:: object: memcached_result_st Work with memcached_result_st -------- -LIBRARY -------- +-------- +SYNOPSIS +-------- +#include -C Client Library for memcached (libmemcached, -lmemcached) +.. c:function:: memcached_result_st * memcached_result_create (memcached_st *ptr, memcached_result_st *result); +.. c:function:: void memcached_result_free (memcached_result_st *result); --------- -SYNOPSIS --------- +.. c:function:: const char * memcached_result_key_value (memcached_result_st *result); + +.. c:function:: size_t memcached_result_key_length (const memcached_result_st *result); + +.. c:function:: const char *memcached_result_value (memcached_result_st *ptr); + +.. c:function:: size_t memcached_result_length (const memcached_result_st *ptr); + +.. c:function:: uint32_t memcached_result_flags (const memcached_result_st *result) + +.. c:function:: uint64_t memcached_result_cas (const memcached_result_st *result); + +.. c:function:: memcached_return_t memcached_result_set_value (memcached_result_st *ptr, const char *value, size_t length) +.. c:function:: void memcached_result_set_flags (memcached_result_st *ptr, uint32_t flags) +.. c:function:: void memcached_result_set_expiration (memcached_result_st *ptr, time_t) -.. code-block:: perl - - #include - - memcached_result_st * - memcached_result_create (memcached_st *ptr, - memcached_result_st *result); - - void memcached_result_free (memcached_result_st *result); - - const char * memcached_result_key_value (memcached_result_st *result); - - size_t memcached_result_key_length (const memcached_result_st *result); - - const char *memcached_result_value (memcached_result_st *ptr); - - size_t memcached_result_length (const memcached_result_st *ptr); - - uint32_t memcached_result_flags (const memcached_result_st *result) - - uint64_t memcached_result_cas (const memcached_result_st *result); - - memcached_return_t - memcached_result_set_value (memcached_result_st *ptr, - const char *value, size_t length) - - void memcached_result_set_flags (memcached_result_st *ptr, uint32_t flags) - - void memcached_result_set_expiration (memcached_result_st *ptr, time_t) +Compile and link with -lmemcachedutil -lmemcached @@ -59,9 +46,9 @@ DESCRIPTION libmemcached(3) can optionally return a memcached_result_st which acts as a result object. The result objects have added benefits over the character -pointer returns in that they are forward compatible with new return items +pointer returns, in that they are forward compatible with new return items that future memcached servers may implement (the best current example of -this is the CAS return item). The structures can also be reused which will +this is the CAS return item). The structures can also be reused, which will save on calls to malloc(3). It is suggested that you use result objects over char \* return functions. @@ -72,7 +59,7 @@ memcached_result_create() will either allocate memory for a memcached_result_st or will initialize a structure passed to it. memcached_result_free() will deallocate any memory attached to the -structure. If the structure was also alloacted, it will deallocate it. +structure. If the structure was also allocated, it will deallocate it. memcached_result_key_value() returns the key value associated with the current result object. @@ -91,7 +78,7 @@ current result object. memcached_result_cas() returns the cas associated with the current result object. This value will only be available if the server -testss it. +tests it. memcached_result_set_value() takes a byte array and a size and sets the result to this value. This function is used for trigger responses. @@ -124,7 +111,7 @@ HOME To find out more information please check: -`https://launchpad.net/libmemcached `_ +`http://libmemcached.org/ `_ --------