X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2Fmemcached_result_st.pod;h=a8f3977ee884ed861e6e5924e82b9fa46c11423d;hb=15082495242e0baf2248f255e8dac8eb286e81f2;hp=89d4e81612556bdcb59a03fdcc0077ef705b2184;hpb=f626f20a53bc94fd8a206b7c49af9d0ef9840f24;p=m6w6%2Flibmemcached diff --git a/docs/memcached_result_st.pod b/docs/memcached_result_st.pod old mode 100755 new mode 100644 index 89d4e816..a8f3977e --- a/docs/memcached_result_st.pod +++ b/docs/memcached_result_st.pod @@ -1,6 +1,6 @@ =head1 NAME -memcahed_result_create, memcached_result_free, +memcached_result_create, memcached_result_free, memcached_result_key_value, memcached_result_key_length, memcached_result_value, memcached_result_length, memcached_result_flags, memcached_result_cas @@ -31,13 +31,20 @@ C Client Library for memcached (libmemcached, -lmemcached) uint64_t memcached_result_cas(memcached_result_st *result); + memcached_return memcached_result_set_value (memcached_result_st *ptr, + 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) + =head1 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 -that future memcached servers may implement (the best currect example of -this is the CAS return iteam). The structures can also be reused which will +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 save on calls to malloc(3). It is suggested that you use result objects over char * return functions. @@ -69,6 +76,16 @@ memcached_result_cas() returns the cas associated with the current result object. This value will only be available if the server supports 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. + +void memcached_result_set_flags() takes a result structure and stores +a new value for the flags field. + +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). + =head1 RETURN