-.TH "MEMCACHED_RESULT_CAS" "3" "April 13, 2011" "0.47" "libmemcached"
+.TH "MEMCACHED_RESULT_CAS" "3" "April 13, 2012" "1.0.6" "libmemcached"
.SH NAME
memcached_result_cas \- Working with result sets
.
..
.\" Man page generated from reStructeredText.
.
-.sp
-Work with memcached_result_st
-.SH LIBRARY
-.sp
-C Client Library for memcached (libmemcached, \-lmemcached)
.SH SYNOPSIS
.sp
-.nf
-.ft C
-#include <libmemcached/memcached.h>
-
-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)
-.ft P
-.fi
+#include <libmemcached/memcached_pool.h>
+.INDENT 0.0
+.TP
+.B memcached_result_st
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \fI\%memcached_result_st\fP * memcached_result_create(memcached_st\fI\ *ptr\fP, \fI\%memcached_result_st\fP\fI\ *result\fP)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B void memcached_result_free(\fI\%memcached_result_st\fP\fI\ *result\fP)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B const char * memcached_result_key_value(\fI\%memcached_result_st\fP\fI\ *result\fP)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B size_t memcached_result_key_length(const \fI\%memcached_result_st\fP\fI\ *result\fP)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B const char *memcached_result_value(\fI\%memcached_result_st\fP\fI\ *ptr\fP)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B size_t memcached_result_length(const \fI\%memcached_result_st\fP\fI\ *ptr\fP)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B uint32_t memcached_result_flags(const \fI\%memcached_result_st\fP\fI\ *result\fP)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B uint64_t memcached_result_cas(const \fI\%memcached_result_st\fP\fI\ *result\fP)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B memcached_return_t memcached_result_set_value(\fI\%memcached_result_st\fP\fI\ *ptr\fP, const char\fI\ *value\fP, size_t\fI\ length\fP)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B void memcached_result_set_flags(\fI\%memcached_result_st\fP\fI\ *ptr\fP, uint32_t\fI\ flags\fP)
+.UNINDENT
+.INDENT 0.0
+.TP
+.B void memcached_result_set_expiration(\fI\%memcached_result_st\fP\fI\ *ptr\fP, time_t)
+.UNINDENT
+.sp
+Compile and link with \-lmemcachedutil \-lmemcached
.SH DESCRIPTION
.sp
-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 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.
+libmemcached(3) can optionally return a \fI\%memcached_result_st\fP 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 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.
.sp
-The structure of memcached_result_st has been encapsulated, you should not
-write code to directly access members of the structure.
+The structure of \fI\%memcached_result_st\fP has been encapsulated, you should
+not write code to directly access members of the structure.
.sp
-memcached_result_create() will either allocate memory for a
-memcached_result_st or will initialize a structure passed to it.
+\fI\%memcached_result_create()\fP will either allocate memory for a
+\fI\%memcached_result_st\fP or will initialize a structure passed to it.
.sp
-memcached_result_free() will deallocate any memory attached to the
-structure. If the structure was also alloacted, it will deallocate it.
+\fI\%memcached_result_free()\fP will deallocate any memory attached to the
+structure. If the structure was also allocated, it will deallocate it.
.sp
-memcached_result_key_value() returns the key value associated with the
+\fI\%memcached_result_key_value()\fP returns the key value associated with the
current result object.
.sp
-memcached_result_key_length() returns the key length associated with the
-current result object.
+\fI\%memcached_result_key_length()\fP returns the key length associated with
+the current result object.
.sp
-memcached_result_value() returns the result value associated with the
+\fI\%memcached_result_value()\fP returns the result value associated with the
current result object.
.sp
-memcached_result_length() returns the result length associated with the
-current result object.
+\fI\%memcached_result_length()\fP returns the result length associated with
+the current result object.
.sp
-memcached_result_flags() returns the flags associated with the
+\fI\%memcached_result_flags()\fP returns the flags associated with the
current result object.
.sp
-memcached_result_cas() returns the cas associated with the
+\fI\%memcached_result_cas()\fP returns the cas associated with the
current result object. This value will only be available if the server
-testss it.
+tests it.
.sp
-memcached_result_set_value() takes a byte array and a size and sets
+\fI\%memcached_result_set_value()\fP takes a byte array and a size and sets
the result to this value. This function is used for trigger responses.
.sp
-void memcached_result_set_flags() takes a result structure and stores
-a new value for the flags field.
+\fI\%memcached_result_set_flags()\fP takes a result structure and stores a new
+value for the flags field.
.sp
-void memcached_result_set_expiration(A) takes a result structure and stores
+\fI\%memcached_result_set_expiration()\fP takes a result structure and stores
a new value for the expiration field (this is only used by read through
triggers).
.sp
.SH RETURN
.sp
Varies, see particular functions. All structures must have
-memcached_result_free() called on them for cleanup purposes. Failure to
-do this will result in leaked memory.
+\fI\%memcached_result_free()\fP called on them for cleanup purposes. Failure
+to do this will result in leaked memory.
.SH HOME
.sp
To find out more information please check:
-\fI\%https://launchpad.net/libmemcached\fP
+\fI\%http://libmemcached.org/\fP
.SH SEE ALSO
.sp
\fImemcached(1)\fP \fIlibmemcached(3)\fP \fImemcached_strerror(3)\fP
projects / m6w6 / libmemcached / blobdiff