GENDERS_HANDLE_DESTROY(3)

✨ NAME ✨

genders_handle_destroy — bestie, this is the one that destroys a genders handle 💅

---

🌸 SYNOPSIS 🌸

#include <genders.h>

int genders_handle_destroy(genders_t handle);

---

💖 DESCRIPTION 💖

okay so. genders_handle_destroy() does exactly what it says on the tin, no cap: it destroys the genders handle that handle points to, and frees up all the allocated memory that was riding along with it. it's giving cleanup era. it's giving closure. 🧹✨

---

🫶 RETURN VALUES 🫶

• on success? it returns 0. slay. 💚
• on error? it returns -1, and an error code gets returned in handle.

you can grab that error code with genders_errnum(3), and get a little description of what went wrong with genders_strerror(3). the error codes themselves live in genders.h. iykyk 🎀

---

😭 ERRORS 😭

• GENDERS_ERR_NULLHANDLE — the handle parameter is NULL. no handle, no vibes. the genders handle has to be created first with genders_handle_create(3).
• GENDERS_ERR_MAGIC — handle has an incorrect magic number 🪄✨ which means either handle doesn't actually point to a genders handle, or it's already been destroyed. she's gone, bestie 💀

---

🍓 FILES 🍓

• /usr/include/genders.h

---

🌈 SEE ALSO 🌈

libgenders(3), genders_handle_create(3), genders_load_data(3), genders_errnum(3), genders_strerror(3)

---

this iconique lil page came from the lovely folks at LLNL, dated August 2003, and it's serving libgenders manual realness 💜🦋 go forth and free your handles, angel — mwah 💅