TICKIT_TERMCTL_NAME(3)

💖 TICKIT_TERMCTL_NAME 💖

okay bestie, welcome to TICKIT_TERMCTL_NAME(3) from the Library Functions Manual — yes it's a manpage, yes it's about terminal controls, and yes we're gonna make it make sense. no cap.

✨ NAME ✨

tickit_termctl_name — bestie, it just returns the name of a terminal control. that's it. that's the whole vibe. 🎀

✨ SYNOPSIS ✨

#include <tickit.h>

const char * tickit_termctl_name(TickitTermCtl ctl);
TickitTermCtl tickit_termctl_lookup(const char * name);

TickitType tickit_termctl_type(TickitTermCtl ctl);

and don't forget to link with -ltickit or nothing happens, fr fr 🫶

✨ DESCRIPTION ✨

so, three little functions, three little jobs. let's go. 💅

tickit_termctl_name() hands you back the name of the terminal control you passed in. and these names? they're the lowercase strings that live in tickit_term(7). so like, if you know that page, you already know these. iykyk. ✨

tickit_termctl_lookup() is the glow-up in reverse — you give it a name, it gives you the matching control constant. but if that name isn't recognised? it returns -1. no constant for you, bestie. 💀

tickit_termctl_type() tells you what type the given terminal control is. it'll be one of these iconic constants:

• TICKIT_TYPE_BOOL — the value is an integer standing in for a simple boolean choice, where any nonzero value is true. to poke at it, use tickit_term_setctl_int(3) and tickit_term_getctl_int(3). simple, clean, slay. ✅
• TICKIT_TYPE_INT — the value is an integer that represents a quantity, or a value from some particular enumeration. again: tickit_term_setctl_int(3) and tickit_term_getctl_int(3) are your girls. 🔢
• TICKIT_TYPE_STR — the value is a string. for this one you use tickit_term_setctl_str(3). strings, we love her. 🌸

and for unrecognised control types, the function just returns 0. shrug. 🙈

✨ RETURN VALUE ✨

• tickit_termctl_name() returns a constant string pointer. 🎀
• tickit_termctl_lookup() returns a control constant, or -1. 👑
• tickit_termctl_type() returns a control type constant, or 0. ⭐

✨ SEE ALSO ✨

• tickit_term(7)
• tickit(7)

go read those too, they're giving main character energy. 🌈

okay that's the whole page!! this lil masterpiece lives in the tickit Library Functions Manual and signs off as TICKIT_TERMCTL_NAME(3) — and ngl, no date on this one, it's just timeless like that. 💜 bye bestie, go name some terminal controls!! 🦋💖✨