projects
/
awesomized
/
libmemcached
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
|
github
raw
|
inline
| side by side
Extend test to report answer.
[awesomized/libmemcached]
/
docs
/
memcached_result_st.pod
diff --git
a/docs/memcached_result_st.pod
b/docs/memcached_result_st.pod
old mode 100755
(executable)
new mode 100644
(file)
index
bd8e21f
..
7fbc394
--- a/
docs/memcached_result_st.pod
+++ b/
docs/memcached_result_st.pod
@@
-1,9
+1,9
@@
=head1 NAME
=head1 NAME
-memcahed_result_create, memcached_result_free,
+memca
c
hed_result_create, memcached_result_free,
memcached_result_key_value, memcached_result_key_length,
memcached_result_value, memcached_result_length,
memcached_result_key_value, memcached_result_key_length,
memcached_result_value, memcached_result_length,
-memcached_result_flags, memcached_result_cas
+memcached_result_flags, memcached_result_cas
- Work with memcached_result_st
=head1 LIBRARY
=head1 LIBRARY
@@
-14,37
+14,39
@@
C Client Library for memcached (libmemcached, -lmemcached)
#include <memcached.h>
#include <memcached.h>
- memcached_result_st *memcached_result_create(memcached_st *ptr,
- memcached_result_st *result);
+ memcached_result_st *
+ memcached_result_create (memcached_st *ptr,
+ memcached_result_st *result);
- void memcached_result_free(memcached_result_st *result);
+ void memcached_result_free
(memcached_result_st *result);
- c
har * memcached_result_key_value
(memcached_result_st *result);
+ c
onst char * memcached_result_key_value
(memcached_result_st *result);
- size_t memcached_result_key_length
(
memcached_result_st *result);
+ size_t memcached_result_key_length
(const
memcached_result_st *result);
- c
har *memcached_result_value
(memcached_result_st *ptr);
+ c
onst char *memcached_result_value
(memcached_result_st *ptr);
- size_t memcached_result_length
(
memcached_result_st *ptr);
+ size_t memcached_result_length
(const
memcached_result_st *ptr);
- uint32_t memcached_result_flags
(
memcached_result_st *result)
+ uint32_t memcached_result_flags
(const
memcached_result_st *result)
- uint64_t memcached_result_cas
(
memcached_result_st *result);
+ uint64_t memcached_result_cas
(const
memcached_result_st *result);
- memcached_return memcached_result_set_value (memcached_result_st *ptr,
- char *value, size_t length)
+ 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_flags
(memcached_result_st *ptr, uint32_t flags)
- void memcached_result_set_expiration(memcached_result_st *ptr, time_t)
+ void memcached_result_set_expiration
(memcached_result_st *ptr, time_t)
=head1 DESCRIPTION
=head1 DESCRIPTION
-libmemcached(3) can optionally return a memcached_result_st which acts as a
+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
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 curre
c
t example of
-this is the CAS return ite
a
m). The structures can also be reused which will
+that future memcached servers may implement (the best curre
n
t 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.
save on calls to malloc(3). It is suggested that you use result objects over
char * return functions.
@@
-64,13
+66,13
@@
memcached_result_key_length() returns the key length associated with the
current result object.
memcached_result_value() returns the result value associated with the
current result object.
memcached_result_value() returns the result value associated with the
-current result object.
+current result object.
memcached_result_length() returns the result length associated with the
memcached_result_length() returns the result length associated with the
-current result object.
+current result object.
memcached_result_flags() returns the flags associated with the
memcached_result_flags() returns the flags associated with the
-current result object.
+current result object.
memcached_result_cas() returns the cas associated with the
current result object. This value will only be available if the server
memcached_result_cas() returns the cas associated with the
current result object. This value will only be available if the server
@@
-82,21
+84,24
@@
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_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
+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).
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
+heap allocated structures.
=head1 RETURN
Varies, see particular functions. All structures must have
=head1 RETURN
Varies, see particular functions. All structures must have
-memcached_result_free() called on them for cleanup purposes. Failure to
+memcached_result_free() called on them for cleanup purposes. Failure to
do this will result in leaked memory.
=head1 HOME
To find out more information please check:
do this will result in leaked memory.
=head1 HOME
To find out more information please check:
-L<http
://tangent.org/552/libmemcached.html
>
+L<http
s://launchpad.net/libmemcached
>
=head1 AUTHOR
=head1 AUTHOR