1MEMCACHED_FETCH(3) libmemcached MEMCACHED_FETCH(3)
2
3
4
6 memcached_fetch - Retrieving data from the server
7
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
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
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
49 To find out more information please check: http://libmemcached.org/
50
52 memcached(1) libmemcached(3) memcached_strerror(3) mem‐
53 cached_fetch_result(3)
54
56 Brian Aker
57
59 2011-2013, Brian Aker DataDifferential, http://datadifferential.com/
60
61
62
63
641.0.18 February 09, 2014 MEMCACHED_FETCH(3)