NAME¶
memcached_fetch - Retrieving data from the server
SYNOPSIS¶
#include <libmemcached/memcached.h>
- char *memcached_fetch(memcached_st *ptr,
char *key, size_t *key_length,
size_t *value_length, uint32_t *flags,
memcached_return_t *error)
- Deprecated since version 0.50: Use memcached_fetch_result()
instead.
Compile and link with -lmemcached
DESCRIPTION¶
memcached_fetch() is used to fetch an individual value from the server.
memcached_mget() must always be called before using this method. You
must pass in a key and its length to fetch the object. You must supply three
pointer variables which will give you the state of the returned object. A
uint32_t pointer to contain whatever flags you stored with the value, a
size_t pointer which will be filled with size of of the object, and a
memcached_return_t pointer to hold any error. The object will be
returned upon success and NULL will be returned on failure.
MEMCACHED_END is returned by the *error value when all objects that
have been found are returned. The final value upon
MEMCACHED_END is
null.
Values returned by
memcached_fetch() must be freed by the caller.
All of the above functions are not tested when the
MEMCACHED_BEHAVIOR_USE_UDP has been set. Executing any of these
functions with this behavior on will result in
MEMCACHED_NOT_SUPPORTED
being returned, or for those functions which do not return a
memcached_return_t, the error function parameter will be set to
MEMCACHED_NOT_SUPPORTED.
RETURN¶
memcached_fetch() sets error to to
MEMCACHED_END upon successful
conclusion.
MEMCACHED_NOTFOUND will be return if no keys at all were
found.
MEMCACHED_KEY_TOO_BIG is set to error whenever
memcached_fetch()
was used and the key was set larger then
MEMCACHED_MAX_KEY, which was
the largest key allowed for the original memcached ascii server.
HOME¶
To find out more information please check:
http://libmemcached.org/
SEE ALSO¶
memcached(1) libmemcached(3) memcached_strerror(3)
memcached_fetch_result(3)
AUTHOR¶
Brian Aker
COPYRIGHT¶
2011-2013, Brian Aker DataDifferential,
http://datadifferential.com/