GENDERS_PARSE(3)

✨ GENDERS_PARSE ✨

okay bestie, welcome to genders_parse from LIBGENDERS 💖 — this is a <genders.h> girlie and she is literally the one you call when you need to figure out what went wrong with a genders file. no cap.

---

🌸 SYNOPSIS 🌸

#include <genders.h>

int genders_parse(genders_t handle, const char *filename, FILE *stream);

---

🦋 DESCRIPTION 🦋

so genders_parse() parses the genders file that filename points at, and then it outputs info about all the parse errors it found in that genders file to stream. it's giving detective energy 🔍✨

if filename is NULL, she'll go check the default genders file instead. no biggie.

if stream is NULL, the info gets output to standard error. periodt.

---

💅 RETURN VALUES 💅

on success, the number of parse errors discovered is returned. so if there are zero errors, 0 comes back — slay. ✨

on error, -1 is returned, and an error code is returned in handle. you can grab that error code with genders_errnum(3), and get a description of it with genders_strerror(3). the error codes are defined in genders.h. iykyk 💜

---

😭 ERRORS 😭

• GENDERS_ERR_NULLHANDLE — the handle parameter is NULL. bestie, the genders handle must be created with genders_handle_create(3) first, that's not optional 🫶
• GENDERS_ERR_OPEN — the genders file that filename points at cannot be opened for reading. it's just not opening, sorry 💀
• GENDERS_ERR_OVERFLOW — a line in the genders database exceeds the maximum allowed length. too much going on fr fr 🙈
• GENDERS_ERR_MAGIC — handle has an incorrect magic number. basically handle does not point to a genders handle, OR handle has already been destroyed by genders_handle_destroy(3). rip ✨

---

🎀 FILES 🎀

• /usr/include/genders.h

---

🌈 SEE ALSO 🌈

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

---

bestie go read those. not me being obsessed with cross-references 💅

---

okay that's the whole thing!! this page came to you from LLNL, dated August 2003 — vintage but iconic, main character energy forever 👑💖 bye bestie!!