iv_init(3)

💖 iv_init(3) — the ivykis programmer's manual, but make it cute 💖

okay bestie, so you know how ivykis is a whole event loop library and you're like "how do I even start"? that's this page. welcome to iv_init, iv_deinit, and iv_inited — the holy trinity of turning ivykis on and off. no cap, this is the very first page you read. iykyk. 🎀

✨ NAME ✨

iv_init, iv_deinit, iv_inited — initialise and deinitialise ivykis 💅

🌸 SYNOPSIS 🌸

#include <iv.h>

void iv_init(void);
void iv_deinit(void);
int iv_inited(void);

🦋 DESCRIPTION 🦋

So iv_init initialises the current thread's ivykis event loop. that's it, that's the vibe. ✨

Every thread that wants to use ivykis must call iv_init before any other ivykis functions are called. like, before anything. no skipping the line, bestie, it's giving "you must be this tall to ride" 😭

now here's the important lore: the very first call to iv_init in a process must run to completion before other threads are allowed to call iv_init. but! subsequent calls to iv_init can be done concurrently. so the first one is the main character and everyone else has to wait for her to finish her entrance. 👑

iv_deinit frees all resources allocated by ivykis in this thread, and should be called before this thread exits. yes literally, clean up after yourself, it's the polite thing to do 🫶

iv_inited returns true if iv_init has been called in this thread. and the second you call iv_deinit, it will return false. she keeps receipts, she knows. 💀

👑 SEE ALSO 👑

• ivykis(3)
• iv_examples(3)

and that's the whole page, bestie!! 🍓 go forth and initialise responsibly. this was ivykis programmer's manual content, dated 2010-09-05 — yes she's an elder but she still ate and she's still iconic, periodt. 💜🧚⭐