GENDERS_ISNODE(3)

💖 GENDERS_ISNODE(3) 💖

okay bestie, welcome to the libgenders corner of the universe ✨ this is the LIBGENDERS manual, and we're doing the node / attribute / value check routines today. yes it's three functions in one page, we're being efficient, we love that for us 🎀

---

✨ NAME ✨

genders_isnode, genders_isattr, genders_isattrval — the node, attribute, and value check routines 💅

---

🦋 SYNOPSIS 🦋

#include <genders.h>

int genders_isnode(genders_t handle, const char *node);

int genders_isattr(genders_t handle, const char *attr);

int genders_isattrval(genders_t handle, const char *attr, const char
*val);

---

🌸 DESCRIPTION 🌸

so here's the vibe. three little yes/no besties, all here to answer your questions about the genders file 💖

• genders_isnode() — tests if the node pointed to by node is listed in the genders file. and bestie, if node is NULL? it tests the current node instead. no cap ✨
• genders_isattr() — tests if the attribute pointed to by attr is listed for some node in the genders file 👑
• genders_isattrval() — tests if the attribute pointed to by attr is equal to the value pointed to by val for some node in the genders file. so like, the attr=val situation, you know the one 🫶

---

🔥 RETURN VALUES 🔥

here's the tea on what you get back ☕

• For genders_isnode(): if node is listed in the genders file, 1 is returned. if it is not listed, 0 is returned.
• For genders_isattr(): if attr is listed in the genders file, 1 is returned. if it is not listed, 0 is returned.
• For genders_isattrval(): if attr=val is listed in the genders file, 1 is returned. if it is not listed, 0 is returned.

and on error? all three of them return -1 😭 and an error code gets returned in handle. you can grab that error code with genders_errnum(3), and a lil description of it with genders_strerror(3). the error codes live in genders.h.

---

💀 ERRORS 💀

the ways things can go wrong, a tragic anthology 🎭

• GENDERS_ERR_NULLHANDLE — the handle parameter is NULL. the genders handle has to be created with genders_handle_create(3) first, bestie, that's the rule 🙈
• GENDERS_ERR_NOTLOADED — genders_load_data(3) has not been called to load genders data. no data, no answers, periodt 💅
• GENDERS_ERR_PARAMETERS — an incorrect parameter has been passed in. we don't know her, she's not on the list 🚫
• GENDERS_ERR_MAGIC — handle has an incorrect magic number ✨🪄 handle does not point to a genders handle, or handle has been destroyed by genders_handle_destroy(3). rip, she's gone 💀

---

🎀 FILES 🎀

/usr/include/genders.h

that's the one, that's the file 🌈

---

👑 SEE ALSO 👑

go read these too, they're iconic, i'm obsessed:

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

---

and that's the whole page, bestie!! 🫶 this lil masterpiece came from LLNL, dated August 2003 (yes she's vintage, she's a classic, we respect our elders 💜), and you'll find her filed under GENDERS_ISNODE(3) in the LIBGENDERS manual. mwah, go forth and check your nodes 💅✨🌸