Memcac..._delete(3pm)

📦
version 1.001801 · 7 versions
, in ubuntu stonking

💖 memcached_delete — deleting keys, but make it a whole moment 💖

okay bestie, gather round, because this is memcached_delete(3pm) from the User Contributed Perl Documentation (section 3pm, yes, the Perl one, she contains multitudes) and she is here to teach you how to Yeet A Key. 🗑️✨

✨ NAME ✨

memcached_delete — Delete a key. That's it. That's the whole job. She deletes. Iconic behaviour, no notes. 💅

📚 LIBRARY 📚

C Client Library for memcached (libmemcached, -lmemcached)

so like, remember to link against it fr fr, otherwise nothing happens and you'll be staring at your terminal like 🧍

🌸 SYNOPSIS 🌸

#include <memcached.h>

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

memcached_return_t
memcached_delete_by_key (memcached_st *ptr,
                         const char *master_key, size_t master_key_length,
                         const char *key, size_t key_length,
                         time_t expiration);

two whole functions, both gorgeous, both doing the lord's work 🫶

💜 DESCRIPTION 💜

memcached_delete() is the one you call when you want to delete a particular key. poof. gone. she said "not today" and meant it. 😌

memcached_delete_by_key() works exactly the same way, but it takes a master key to find the given value. so instead of just handing over the key, you're like "hey, look it up through this one" — iykyk 🦋

🕰️ about that expiration thing 🕰️

okay so this is lowkey the juiciest part and you NEED to know it. Expiration works by placing the item into a delete queue, which means:

  • you won't be able to retrieve it with the "get" command — she's gone from your sight bestie 😭
  • but "add" and "replace" commands with this key will also fail — so she's not fully gone, she's just in her locked-girl era 🔒
  • the "set" command will succeed though (sneaky little loophole, she stays valid) ✨

After the time passes, the item is finally deleted from server memory. like, actually gone gone. rest in peace 🪦🌸

⚠️ please note — the Danga memcached server removed support for expiration in the 1.4 version. so if you're on that, this whole expiration deal is giving ✨nothing✨. adjust your plans accordingly, bestie 💀

🎀 RETURN 🎀

A value of type memcached_return_t is returned. On success, that value will be MEMCACHED_SUCCESS. 🎉

Use memcached_strerror() to translate this value into a printable string — because raw integer codes are not it, and we want words, we want clarity, we want communication 💬💖

🚨 important caveat, do not skip this one: if you are using the non-blocking mode of the library, success only means that the message was queued for delivery. it does NOT mean the thing happened yet. it's giving "I sent the text" not "she read the text", okay?? 😭 main character energy but zero confirmation 🔥

🏠 HOME 🏠

To find out more information please check: <https://launchpad.net/libmemcached>

go click around, she's got lore 👑

👑 AUTHOR 👑

Brian Aker, <brian@tangent.org>

the architect. the blueprint. the moment. we stan 🫶✨

🌈 SEE ALSO 🌈

the whole friend group, go say hi 💜

okay that's the page!! hope you delete responsibly and only when you mean it 💅✨

this lil gem comes to you from perl v5.42.3, dated 2026-08-19, under the Memcac..._delete(3pm) badge — yeah the title got a lil truncated by the manpage renderer, she's mysterious like that 🎀🦋

bye bestie!! mwah 💖

📦 where this page comes from