1MEMCACHED_TOUCH_BY_KEY(3)    libmemcached-awesome    MEMCACHED_TOUCH_BY_KEY(3)
2
3
4

NAME

6       memcached_touch_by_key - libmemcached Documentation
7

SYNOPSIS

9       #include <libmemcached/memcached.h>
10              Compile and link with -lmemcached
11
12       memcached_return_t  memcached_touch(memcached_st *ptr, const char *key,
13       size_t key_length, time_t expiration)
14
15              Parameters
16
17                     • ptr -- pointer to initialized memcached_st struct
18
19                     • key -- the key to touch
20
21                     • key_length -- the length of key without any terminating
22                       zero
23
24                     • expiration  -- new expiration as a unix timestamp or as
25                       relative expiration time in seconds
26
27              Returns
28                     memcached_return_t indicating success
29
30       memcached_return_t memcached_touch_by_key(memcached_st *ptr, const char
31       *group_key,   size_t   group_key_length,   const   char   *key,  size_t
32       key_length, time_t expiration)
33
34              Parameters
35
36                     • ptr -- pointer to initialized memcached_st struct
37
38                     • group_key -- the key namespace
39
40                     • group_key_length -- the length of group_key without any
41                       terminating zero
42
43                     • key -- the key to touch
44
45                     • key_length -- the length of key without any terminating
46                       zero
47
48                     • expiration -- new expiration as a unix timestamp or  as
49                       relative expiration time in seconds
50
51              Returns
52                     memcached_return_t indicating success
53

DESCRIPTION

55       memcached_touch()  is used to update the expiration time on an existing
56       key.  memcached_touch_by_key() works the same, but it  takes  a  master
57       key to find the given value.
58

RETURN VALUE

60       A  value of type memcached_return_t is returned.  On success that value
61       will be MEMCACHED_SUCCESS.  Use memcached_strerror() to translate  this
62       value to a printable string.
63

SEE ALSO

65       memcached(1) libmemcached(3) memcached_strerror(3)
66
67
68
69
701.1                              Mar 06, 2023        MEMCACHED_TOUCH_BY_KEY(3)
Impressum