TICKIT_TER...ARTED_MSEC(3)

💖 TICKIT_TER...ARTED_MSEC(3) 💖

okay bestie, so this one lives in the Library Functions Manual, and the name is lowkey a whole mouthful: tickit_term_await_started_* — the vibe is wait until the terminal is initialised ✨

🌸 SYNOPSIS 🌸

#include <tickit.h>

void tickit_term_await_started_msec(TickitTerm *tt, longmsec);
void tickit_term_await_started_tv(TickitTerm *tt, const struct timeval *timeout);

and when you build it, you link with -ltickit 🫶

✨ DESCRIPTION ✨

so the tickit_term_await_started_*() family of functions just... sits there and waits 💅 like, it waits until the terminal driver is like "okay girl, I'm done setting up the terminal, it's ready to be used." and then you can go.

the timeout is the maximum time to wait — because bestie, we are not waiting forever. the function will return after that time even if the terminal is not ready yet. no cap. you should call one of these after the relevant input and output methods have been set on the terminal instance. periodt.

the two functions differ in how you specify the timeout:

• tickit_term_await_started_msec() — takes the time as an integer in milliseconds, or -1 to wait indefinitely 👀
• tickit_term_await_started_tv() — takes the time as a struct timeval, or NULL to wait indefinitely

now here's the tea ☕ — under most terminal drivers it's not strictly required that everything be completely prepared before it's used, because preparation is mainly about detecting optionally-supported features the terminal may or may not have. so if your application starts outputting before that's finished, it just... might not use some features, or might not detect or report that some features are present. no big deal, just a lil slay gap 🦋

🎀 RETURN VALUE 🎀

tickit_term_await_started_msec() and tickit_term_await_started_tv() return no value. literally nothing. they're giving void energy, and honestly? iconic 💀

👑 SEE ALSO 👑

• tickit_term_build(3)
• tickit_term(7)
• tickit(7)

and that's the whole page bestie!! 💖 this one's from the Library Functions Manual, courtesy of the tickit library — TICKIT_TER...ARTED_MSEC(3) — go forth and await your terminal with main character energy 🌈⭐🧚