MEMCACHED_FREE(3)

✨ MEMCACHED_FREE — the libmemcached girlies' guide 💅

okay bestie, welcome to the libmemcached-awesome page for memcached_free, aka the "please clean up after yourself" era of your life 🧹✨

---

🌸 SYNOPSIS 🌸

#include <libmemcached/memcached.h>
       Compile and link with -lmemcached

typedef struct memcached_st memcached_st

memcached_st *memcached_create(memcached_st *ptr)

       Parameters
              ptr -- pointer to user-allocated memcached_st struct or
              null pointer

       Returns
              pointer to initialized memcached_st struct

void memcached_free(memcached_st *ptr)

       Parameters
              ptr -- pointer to initialized memcached_st struct to
              destroy and possibly free

memcached_st *memcached_clone(memcached_st *destination, memcached_st
*source)

       Parameters

              • destination -- pointer to user-allocated memcached_st
                struct or null pointer

              • source -- pointer to initialized memcached_st struct to
                copy from

       Returns
              pointer to newly initialized destination, copied from
              source

void memcached_servers_reset(memcached_st *ptr)

       Parameters
              ptr -- pointer to initialized memcached_st struct

like, four whole functions in one synopsis?? it's giving ✨family portrait✨ no cap 📸

---

💖 DESCRIPTION 💖

memcached_create() is the moment you bring a memcached_st structure into existence so all your other libmemcached functions have someone to talk to when they wanna communicate with the server 🫶 You should either pass it a statically declared memcached_st, or a NULL. and if you hand it a NULL? she allocates a structure for you, queen behavior, we love a self-sufficient icon 👑

bestie, listen — when you write a new application, use memcached() instead of memcached_create(). it's the glow-up, fr fr. 💅

memcached_clone() is like memcached_create() but with main character energy — she copies the defaults and the list of servers straight from the source memcached_st pointer 🦋 And if you pass a null as the source argument to clone? that's literally the same as just calling memcached_create(), no difference, periodt. And if the destination argument is NULL, a memcached_st gets allocated for you too ✨

memcached_servers_reset() is the "clean slate" button — it lets you zero out the list of servers that the memcached_st has 🧼 not me wiping the whole server list like it's my camera roll 🙈

now the important part: to clean up the memory associated with a memcached_st structure, you should pass it to memcached_free() when you're done using it 💀🔥 And honestly? memcached_free() is the only way to make sure all the memory is deallocated when you finish using the structure. the only one. no shortcuts, no sneaky alternatives, don't try it 😭

⚠️ you may wish to avoid using memcached_create() or memcached_clone() with a stack based allocation. the most common issues related to ABI safety involve heap allocated structures. so like… stack allocation is lowkey a red flag here 🚩 heap girls, this is your moment 👑

---

⭐ RETURN VALUE ⭐

memcached_create() returns a pointer to the memcached_st that was created (or initialized) 🎀 On an allocation failure, it returns NULL. sad girl hours 😭

memcached_clone() returns a pointer to the memcached_st that was created (or initialized) 🌈 On an allocation failure, it returns NULL. same energy, same heartbreak 💔

---

👀 SEE ALSO 👀

• memcached(1)
• libmemcached(3)

---

and that's the whole page bestie, you ate that 🍓 go forth and free your memory responsibly, iykyk 💜

mwah 💋 — this was MEMCACHED_FREE(3) from libmemcached-awesome, version 1.1, dated Jul 24, 2025. slay, bye!! 🎀✨