TICKIT_TERM_CTLNAME(3)

💖 TICKIT_TERM_CTLNAME 💖

okay bestie, welcome to tickit_term_ctlname(3) — it lives in the Library Functions Manual (section 3, the "functions" girlies), and it's literally all about naming terminal controls and looking them up. no cap, it's a tiny page but it's iconic. ✨

---

🎀 NAME 🎀

tickit_term_ctlname — return the name of a terminal control

---

🌸 SYNOPSIS 🌸

#include <tickit.h>

const char * tickit_term_ctlname(TickitTermCtl ctl);
TickitTermCtl tickit_term_lookup_ctl(const char * name);

TickitType tickit_term_ctltype(TickitTermCtl ctl);

Link with -ltickit.

---

💅 DESCRIPTION 💅

okay so, three little functions, three little jobs. let's go 🫶

tickit_term_ctlname() hands you back the name of the terminal control you passed in. and these names? they're the lowercase strings, the exact ones listed over in tickit_term(7). so if you're like "what do they even call this thing" — boom, answered. 💖

tickit_term_lookup_ctl() does the reverse glow-up: you give it a name, it gives you the control constant. but if the name isn't recognised? it returns -1. no constant for you, sorry babe. 🙈

tickit_term_ctltype() tells you the type of a given terminal control, and it comes back as one of these constants:

• TICKIT_TYPE_BOOL — the value is an integer standing in for a simple boolean choice, where any nonzero value counts as true. reach for tickit_term_setctl_int(3) and tickit_term_getctl_int(3) for this one. 💅
• TICKIT_TYPE_INT — the value is an integer representing a quantity, or a value from some particular enumeration. same duo: tickit_term_setctl_int(3) and tickit_term_getctl_int(3). 🔥
• TICKIT_TYPE_STR — the value is a string. use tickit_term_setctl_str(3) for this vibe. 🦋

and for control types it doesn't recognise? the function returns 0. that's it, that's the whole personality. ✨

---

🌈 RETURN VALUE 🌈

• tickit_term_ctlname() returns a constant string pointer. 📌
• tickit_term_lookup_ctl() returns a control constant, or -1. 💀
• tickit_term_ctltype() returns a control type constant, or 0. 👑

---

👑 SEE ALSO 👑

tickit_term(7), tickit(7)

---

and that's the whole page, bestie!! mwah 💖 this was TICKIT_TERM_CTLNAME(3) from the Library Functions Manual — the tickit crew's section-3 page, dated the way man pages are dated, and yes, the title is still <rainbow>TICKIT_TERM_CTLNAME(3)</rainbow> at the bottom too because tradition is tradition. slay, go name some terminal controls. 🎀✨