TICKIT_WINDOWCTL_NAME(3)

💖 TICKIT_WINDOWCTL_NAME — bestie, it's the name of a window control 💖

okay so this is tickit_windowctl_name(3) from the Library Functions Manual, and it's literally about naming window controls. that's the whole vibe. let's go 🦋

✨ NAME ✨

tickit_windowctl_name — returns the name of a window control. that's it, that's the function, she's simple and she slays 💅

✨ SYNOPSIS ✨

#include <tickit.h>

const char * tickit_windowctl_name(TickitWindowCtl ctl);
TickitWindowCtl tickit_windowctl_lookup(const char * name);

TickitType tickit_windowctl_type(TickitWindowCtl ctl);

Link with -ltickit.

note the Link with -ltickit. — yes queen, you gotta link the library, do not forget her, she will not compile without you 🙈

✨ DESCRIPTION ✨

so like, three functions, three little besties, all working together:

🌸 tickit_windowctl_name()

returns the name of the given window control. these names are the lowercase strings that live over in tickit_window(7) — lowercase, always, no cap.

🌸 tickit_windowctl_lookup()

gives you back the control constant for a given name. and if the name is not recognised? yeah she returns -1. rude but fair. 💀

🌸 tickit_windowctl_type()

returns the type of the given window control, and it's one of these two constants bestie:

• TICKIT_TYPE_BOOL — the value is an integer representing a simple boolean choice, where any nonzero value is true. use tickit_window_setctl_int(3) and tickit_window_getctl_int(3). yes, both. they're a package deal 🫶
• TICKIT_TYPE_INT — the value is an integer representing a quantity, or a value in some particular enumeration. use tickit_window_setctl_int(3) and tickit_window_getctl_int(3) — same duo, iconic behavior 👑

and for unrecognised control types, the function returns 0. not -1, not an error code, just a humble little 0. periodt.

✨ RETURN VALUE ✨

• tickit_windowctl_name() returns a constant string pointer. ✨
• tickit_windowctl_lookup() returns a control constant or -1.
• tickit_windowctl_type() returns a control type constant or 0.

like a little return-value menu. pick your fighter 💜

✨ SEE ALSO ✨

• tickit_window(7)
• tickit(7)

go read those next bestie, iykyk 🌈

and that's the whole page!! this was TICKIT_WINDOWCTL_NAME(3) from the Library Functions Manual, dated and versioned right there in the footer alongside the page title — mwah, tysm for reading, you ate 💖🎀🧚⭐