.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "MEMCACHED_TOUCH_BY_KEY" "3" "Mar 11, 2024" "1.1" "libmemcached-awesome"
.SH NAME
memcached_touch_by_key \- libmemcached Documentation
.SH SYNOPSIS
.INDENT 0.0
.TP
.B #include <libmemcached/memcached.h>
Compile and link with \-lmemcached
.UNINDENT
.INDENT 0.0
.TP
.B \fI\%memcached_return_t\fP memcached_touch(\fI\%memcached_st\fP *ptr, const char *key, size_t key_length, time_t expiration) 
.INDENT 7.0
.TP
.B Parameters
.INDENT 7.0
.IP \(bu 2
\fBptr\fP \-\- pointer to initialized \fI\%memcached_st\fP struct
.IP \(bu 2
\fBkey\fP \-\- the key to touch
.IP \(bu 2
\fBkey_length\fP \-\- the length of \fI\%key\fP without any terminating zero
.IP \(bu 2
\fBexpiration\fP \-\- new expiration as a unix timestamp or as relative expiration time in seconds
.UNINDENT
.TP
.B Returns
\fI\%memcached_return_t\fP indicating success
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fI\%memcached_return_t\fP memcached_touch_by_key(\fI\%memcached_st\fP *ptr, const char *group_key, size_t group_key_length, const char *key, size_t key_length, time_t expiration) 
.INDENT 7.0
.TP
.B Parameters
.INDENT 7.0
.IP \(bu 2
\fBptr\fP \-\- pointer to initialized \fI\%memcached_st\fP struct
.IP \(bu 2
\fBgroup_key\fP \-\- the \fI\%key\fP namespace
.IP \(bu 2
\fBgroup_key_length\fP \-\- the length of \fI\%group_key\fP without any terminating zero
.IP \(bu 2
\fBkey\fP \-\- the key to touch
.IP \(bu 2
\fBkey_length\fP \-\- the length of \fI\%key\fP without any terminating zero
.IP \(bu 2
\fBexpiration\fP \-\- new expiration as a unix timestamp or as relative expiration time in seconds
.UNINDENT
.TP
.B Returns
\fI\%memcached_return_t\fP indicating success
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
\fI\%memcached_touch()\fP is used to update the expiration time on an existing key.
\fI\%memcached_touch_by_key()\fP works the same, but it takes a master key
to find the given value.
.SH RETURN VALUE
.sp
A value of type \fI\%memcached_return_t\fP is returned.
On success that value will be \fI\%MEMCACHED_SUCCESS\fP\&.
Use \fI\%memcached_strerror()\fP to translate this value to a printable
string.
.SH SEE ALSO
.sp
\fBmemcached(1)\fP
\fBlibmemcached(3)\fP
\fBmemcached_strerror(3)\fP
.\" Generated by docutils manpage writer.
.