TICKIT_TERM_REF(3)

💖 TICKIT_TERM_REF(3) 💖

ok so bestie, welcome to the Library Functions Manual entry for TICKIT_TERM_REF(3) — yes the manual name is literally part of the title, we love a self-referential moment ✨

🌸 NAME 🌸

tickit_term_ref, tickit_term_unref — adjust the refcount of a terminal 🎀

🦋 SYNOPSIS 🦋

#include <tickit.h>

TickitTerm *tickit_term_ref(TickitTerm *tt);
void tickit_term_unref(TickitTerm *tt);

Link with -ltickit.

✨ DESCRIPTION ✨

ok so here's the tea, bestie ☕

tickit_term_ref() bumps the stored refcount of the terminal instance you hand it by one. and the cute part? it hands you back the exact same pointer argument, so you can chain it like it's nothing. it's giving "return the vibe you came in with" 💅

tickit_term_unref() does the opposite — it drops the stored refcount by one. and if that refcount hits zero? boom, the instance is destroyed 💀

when that happens, it releases every resource the instance was controlling, and it unbinds all the bound event handlers — which means handlers get invoked with the TICKIT_EV_DESTROY flag if that's appropriate for them. so yeah, your handlers get one last little goodbye moment 🫶

heads up though: it will not close any filehandles associated with the instance. those are not its problem, no cap 🙈

⭐ RETURN VALUE ⭐

• tickit_term_ref() returns a terminal instance pointer 👑
• tickit_term_unref() returns no value. nothing. silence. it's done its job and left the group chat 😭

🌈 SEE ALSO 🌈

tickit_term_build(3), tickit_term(7), tickit(7)

and that's the whole page bestie, TICKIT_TERM_REF(3), Library Functions Manual, periodt 💜 go refcount responsibly, mwah 🎀✨