42
.B memcached_result_st * memcached_result_create (memcached_st *ptr, memcached_result_st *result);
46
.B void memcached_result_free (memcached_result_st *result);
50
.B const char * memcached_result_key_value (memcached_result_st *result);
54
.B size_t memcached_result_key_length (const memcached_result_st *result);
58
.B const char *memcached_result_value (memcached_result_st *ptr);
62
.B size_t memcached_result_length (const memcached_result_st *ptr);
42
.B \fI\%memcached_result_st\fP * memcached_result_create(memcached_st\fI\ *ptr\fP, \fI\%memcached_result_st\fP\fI\ *result\fP)
46
.B void memcached_result_free(\fI\%memcached_result_st\fP\fI\ *result\fP)
50
.B const char * memcached_result_key_value(\fI\%memcached_result_st\fP\fI\ *result\fP)
54
.B size_t memcached_result_key_length(const \fI\%memcached_result_st\fP\fI\ *result\fP)
58
.B const char *memcached_result_value(\fI\%memcached_result_st\fP\fI\ *ptr\fP)
62
.B size_t memcached_result_length(const \fI\%memcached_result_st\fP\fI\ *ptr\fP)
96
96
The structure of \fI\%memcached_result_st\fP has been encapsulated, you should
97
97
not write code to directly access members of the structure.
99
\fBmemcached_result_create()\fP will either allocate memory for a
99
\fI\%memcached_result_create()\fP will either allocate memory for a
100
100
\fI\%memcached_result_st\fP or will initialize a structure passed to it.
102
\fBmemcached_result_free()\fP will deallocate any memory attached to the
102
\fI\%memcached_result_free()\fP will deallocate any memory attached to the
103
103
structure. If the structure was also allocated, it will deallocate it.
105
\fBmemcached_result_key_value()\fP returns the key value associated with the
105
\fI\%memcached_result_key_value()\fP returns the key value associated with the
106
106
current result object.
108
\fBmemcached_result_key_length()\fP returns the key length associated with
108
\fI\%memcached_result_key_length()\fP returns the key length associated with
109
109
the current result object.
111
\fBmemcached_result_value()\fP returns the result value associated with the
111
\fI\%memcached_result_value()\fP returns the result value associated with the
112
112
current result object.
114
\fBmemcached_result_length()\fP returns the result length associated with
114
\fI\%memcached_result_length()\fP returns the result length associated with
115
115
the current result object.
117
117
\fI\%memcached_result_flags()\fP returns the flags associated with the
118
118
current result object.
120
\fBmemcached_result_cas()\fP returns the cas associated with the
120
\fI\%memcached_result_cas()\fP returns the cas associated with the
121
121
current result object. This value will only be available if the server
124
124
\fI\%memcached_result_set_value()\fP takes a byte array and a size and sets
125
125
the result to this value. This function is used for trigger responses.
127
\fBvoid memcached_result_set_flags()\fP takes a result structure and stores
128
a new value for the flags field.
127
\fI\%memcached_result_set_flags()\fP takes a result structure and stores a new
128
value for the flags field.
130
\fBvoid memcached_result_set_expiration(A)()\fP takes a result structure and stores a new value for the expiration field (this is only used by read
130
\fI\%memcached_result_set_expiration()\fP takes a result structure and stores
131
a new value for the expiration field (this is only used by read through
133
134
You may wish to avoid using memcached_result_create(3) with a
134
135
stack based allocation. The most common issues related to ABI safety involve
138
139
Varies, see particular functions. All structures must have
139
\fBmemcached_result_free()\fP called on them for cleanup purposes. Failure
140
\fI\%memcached_result_free()\fP called on them for cleanup purposes. Failure
140
141
to do this will result in leaked memory.