1MEMCACHED_FETCH(3)               libmemcached               MEMCACHED_FETCH(3)
2
3
4

NAME

6       memcached_fetch - Retrieving data from the server
7

SYNOPSIS

9       #include <libmemcached/memcached.h>
10
11       char *memcached_fetch(memcached_st *ptr, char *key, size_t *key_length,
12       size_t *value_length, uint32_t *flags, memcached_return_t *error)
13              Deprecated  since  version  0.50:  Use  memcached_fetch_result()
14              instead.
15
16       Compile and link with -lmemcached
17

DESCRIPTION

19       memcached_fetch() is used to fetch an individual value from the server.
20       memcached_mget() must always be called before using this  method.   You
21       must  pass in a key and its length to fetch the object. You must supply
22       three pointer variables which will give you the state of  the  returned
23       object.   A  uint32_t pointer to contain whatever flags you stored with
24       the value, a size_t pointer which will be filled with size  of  of  the
25       object,  and a memcached_return_t pointer to hold any error. The object
26       will be returned upon success and NULL will  be  returned  on  failure.
27       MEMCACHED_END  is  returned  by  the *error value when all objects that
28       have been found are returned. The final  value  upon  MEMCACHED_END  is
29       null.
30
31       Values returned by memcached_fetch() must be freed by the caller.
32
33       All  of  the  above  functions are not tested when the MEMCACHED_BEHAV‐
34       IOR_USE_UDP has been set. Executing any of these  functions  with  this
35       behavior  on  will result in MEMCACHED_NOT_SUPPORTED being returned, or
36       for those functions which do not return a memcached_return_t, the error
37       function parameter will be set to MEMCACHED_NOT_SUPPORTED.
38

RETURN

40       memcached_fetch()  sets  error to to MEMCACHED_END upon successful con‐
41       clusion.  MEMCACHED_NOTFOUND will be return if  no  keys  at  all  were
42       found.
43
44       MEMCACHED_KEY_TOO_BIG  is  set  to error whenever memcached_fetch() was
45       used and the key was set larger then MEMCACHED_MAX_KEY, which  was  the
46       largest key allowed for the original memcached ascii server.
47

HOME

49       To find out more information please check: http://libmemcached.org/
50

SEE ALSO

52       memcached(1)       libmemcached(3)      memcached_strerror(3)      mem‐
53       cached_fetch_result(3)
54

AUTHOR

56       Brian Aker
57

59       2011-2013, Brian Aker DataDifferential, http://datadifferential.com/
60
61
62
63
641.0.16                         January 31, 2013             MEMCACHED_FETCH(3)
Impressum