TICKIT_PEN_REF(3)

okay bestie, you're reading TICKIT_PEN_REF(3) from the Library Functions Manual, and it's literally just about adjusting the refcount of a pen 🖊️✨ Buckle up, it's short but iconic.

🎀 NAME 🎀

tickit_pen_ref, tickit_pen_unref - adjust the refcount of a pen 💅

✨ SYNOPSIS ✨

#include <tickit.h>

TickitPen *tickit_pen_ref(TickitPen *pen);
void tickit_pen_unref(TickitPen *pen);

Link with -ltickit.

🦋 DESCRIPTION 🦋

tickit_pen_ref() increments the stored refcount of the given pen instance by one. It returns the pointer argument itself, so it is useful for chaining — yes bestie, chain it like your favorite playlist 🎧🔥

tickit_pen_unref() decrements the stored refcount of the given pen instance by one. If the refcount drops to zero, the instance is destroyed. That means it will release any resources controlled by it and unbind all the bound event handlers, causing handlers to be invoked with the TICKIT_EV_DESTROY flag if appropriate. So it's giving cleanup, but make it dramatic 💀✨

💖 RETURN VALUE 💖

tickit_pen_ref() returns a pen instance pointer. tickit_pen_unref() returns no value. That's the whole vibe, no cap, periodt.

🌈 SEE ALSO 🌈

• tickit_pen_new(3)
• tickit_pen(7)
• tickit(7)

bye bestie! That was the TICKIT_PEN_REF(3) page from the Library Functions Manual. The footer only says TICKIT_PEN_REF(3) — no version or date listed, so that's the tea 🫶💅✨