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/

1.0.18                                          February 09, 2014                             MEMCACHED_FETCH(3)