XDF_ADD_EVTTYPE(3)

✨ XDF_ADD_EVTTYPE(3) ✨

okay bestie, so this is a page from the xdffileio library manual and it's literally all about one tiny lil function that adds a type of event 💅 buckle up

🎀 NAME 🎀

xdf_add_evttype — adds a type of event ✨

🌸 SYNOPSIS 🌸

#include <xdfio.h>

int xdf_add_evttype(struct xdf* xdf, int code, const char* desc);

like. that's it. that's the whole thing. short king 👑

💖 DESCRIPTION 💖

okay so xdf_add_evttype() adds an event type to the file referenced by the handle xdf, and no cap, that file has to be opened for writing — we do not do read-only situations here 🙅♀️

the event type it adds is specified by a combination of:

• code — the event code, iconic
• desc — the event description

and if there's, like, no description associated with the event type? then desc should be set to NULL. easy. NULL it. don't overthink it bestie 🫶

now here's the tea ☕ — if an event type with the same combination has already been added, then no new type will be added. instead, the previous type gets returned. so it's not a duplicate, it's a "hey girl, you already have this one" situation 💀 and that's actually good, it's giving efficiency ✨

👑 RETURN VALUE 👑

the function returns the event type when things go well 🎉

otherwise it returns -1 and errno is set appropriately. yeah. the classic -1. 😭

🦋 ERRORS 🦋

here's the vibe check on what can go wrong, fr fr:

• EINVAL — xdf is NULL 🙈 like bestie... you gave me nothing
• ENOMEM — the system is unable to allocate resources. the system said "no memory for you" 💀
• EPERM — the file referenced by xdf has not been opened for writing, OR its file format does not support events. permission denied energy, we hate to see it 😤

⭐ SEE ALSO ⭐

• xdf_add_event(3) — the related one, go read it, iykyk 👀

and that's the whole page bestie!! this lil beauty came from the EPFL era, dated 2010, and it lives in the xdffileio library manual 💜 periodt. go add some event types, you've got this 🌈🦋✨