MEMCACHED_TOUCH_BY_KEY(3)

💅 NAME 💅

memcached_touch_by_key — ok bestie, this is the libmemcached documentation for it, and we're gonna get you so comfy with it ✨

---

🎀 SYNOPSIS 🎀

First things first, you gotta bring the header in:

#include <libmemcached/memcached.h>

And when you compile + link, don't forget this icon:

Compile and link with -lmemcached

🌸 memcached_touch()

memcached_return_t memcached_touch(memcached_st *ptr, const char *key,
size_t key_length, time_t expiration)

Parameters

• ptr — a pointer to an initialized memcached_st struct 🫶
• key — the key you wanna touch
• key_length — how long key is, not counting any terminating zero
• expiration — the new expiration, either as a unix timestamp or as a relative expiration time in seconds ⏰

Returns

A memcached_return_t indicating success, periodt.

🦋 memcached_touch_by_key()

memcached_return_t memcached_touch_by_key(memcached_st *ptr, const char
*group_key, size_t group_key_length, const char *key, size_t key_length,
time_t expiration)

Parameters

• ptr — a pointer to an initialized memcached_st struct 🫶
• group_key — the key namespace
• group_key_length — how long group_key is, not counting any terminating zero
• key — the key you wanna touch
• key_length — how long key is, not counting any terminating zero
• expiration — the new expiration, either as a unix timestamp or as a relative expiration time in seconds ⏰

Returns

A memcached_return_t indicating success, slay.

---

✨ DESCRIPTION ✨

So memcached_touch() is the girl who updates the expiration time on a key that already exists — like giving it a little glow-up on its expiry date 💅

And memcached_touch_by_key()? She does the exact same thing, but she takes a master key to go find the value you're talking about. Same energy, extra key, iykyk 🔑

---

💖 RETURN VALUE 💖

You get back a value of type memcached_return_t. When everything goes right, that value is MEMCACHED_SUCCESS 🎉 And if you ever need to turn it into an actual readable string, hit up memcached_strerror() — she'll translate it for you, fr fr.

---

🌈 SEE ALSO 🌈

• memcached(1)
• libmemcached(3)
• memcached_strerror(3)

---

Version 1.1, dated Jul 24, 2025 — that's the whole vibe, bestie. Go touch some keys (the memcached kind, not your phone's) 💜