X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fmemcached_result_st.rst;h=3cd9afe2bd873060ebe88a79c5de3cb3280d56f1;hb=38d70dfdb082834652ff8823ad7f35067e720b1a;hp=8bc43e26032c0803ad0e20b0949dca4b0d2dccf2;hpb=16ba6539e831e2abcef9dcf56fa26e3a0d5c7f91;p=m6w6%2Flibmemcached diff --git a/docs/memcached_result_st.rst b/docs/memcached_result_st.rst index 8bc43e26..3cd9afe2 100644 --- a/docs/memcached_result_st.rst +++ b/docs/memcached_result_st.rst @@ -2,32 +2,29 @@ Working with result sets ======================== -.. index:: object: memcached_result_st - -Work with memcached_result_st - - -------- SYNOPSIS -------- #include -.. c:function:: memcached_result_st * memcached_result_create (memcached_st *ptr, memcached_result_st *result); +.. c:type:: memcached_result_st + +.. 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); +.. c:function:: void memcached_result_free (memcached_result_st *result) -.. c:function:: const char * memcached_result_key_value (memcached_result_st *result); +.. 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:: size_t memcached_result_key_length (const memcached_result_st *result) -.. c:function:: const char *memcached_result_value (memcached_result_st *ptr); +.. 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:: 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:: 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) @@ -55,39 +52,40 @@ objects over char \* return functions. The structure of :c:type:`memcached_result_st` has been encapsulated, you should not write code to directly access members of the structure. -:c:func:`memcached_result_create()` will either allocate memory for a +:c:func:`memcached_result_create` will either allocate memory for a :c:type:`memcached_result_st` or will initialize a structure passed to it. -:c:func:`memcached_result_free()` will deallocate any memory attached to the +:c:func:`memcached_result_free` will deallocate any memory attached to the structure. If the structure was also allocated, it will deallocate it. -:c:func:`memcached_result_key_value()` returns the key value associated with the +:c:func:`memcached_result_key_value` returns the key value associated with the current result object. -:c:func:`memcached_result_key_length()` returns the key length associated with +:c:func:`memcached_result_key_length` returns the key length associated with the current result object. -:c:func:`memcached_result_value()` returns the result value associated with the +:c:func:`memcached_result_value` returns the result value associated with the current result object. -:c:func:`memcached_result_length()` returns the result length associated with +:c:func:`memcached_result_length` returns the result length associated with the current result object. -:c:func:`memcached_result_flags()` returns the flags associated with the +:c:func:`memcached_result_flags` returns the flags associated with the current result object. -:c:cune:`memcached_result_cas()` returns the cas associated with the +:c:func:`memcached_result_cas` returns the cas associated with the current result object. This value will only be available if the server tests it. -:c:func:`memcached_result_set_value()` takes a byte array and a size and sets +:c:func:`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. -:c:func:`void memcached_result_set_flags()` takes a result structure and stores -a new value for the flags field. +:c:func:`memcached_result_set_flags` takes a result structure and stores a new +value for the flags field. -:c:func:`void memcached_result_set_expiration(A)` takes a result structure and stores a new value for the expiration field (this is only used by read -through triggers). +:c:func:`memcached_result_set_expiration` takes a result structure and stores +a new value for the expiration field (this is only used by read through +triggers). You may wish to avoid using memcached_result_create(3) with a stack based allocation. The most common issues related to ABI safety involve @@ -100,7 +98,7 @@ RETURN Varies, see particular functions. All structures must have -:c:func:`memcached_result_free()` called on them for cleanup purposes. Failure +:c:func:`memcached_result_free` called on them for cleanup purposes. Failure to do this will result in leaked memory.