TICKIT_TERM_ERASECH(3)

💖 TICKIT_TERM_ERASECH 💖

okay bestie, gather round, because we're talking about tickit_term_erasech from the tickit library manual (section 3, library functions, you know the vibe) ✨

🌸 NAME 🌸

tickit_term_erasech — erase characters from the terminal 🧹

✨ SYNOPSIS ✨

#include <tickit.h>

void tickit_term_erasech(TickitTerm *tt, int count, TickitMaybeBool moveend);

Link with -ltickit. 🔗

🦋 DESCRIPTION 🦋

so tickit_term_erasech() erases count character cells going forward from wherever the cursor is sitting right now, and it does it using the current pen background colour 💅

now here's the tea, because not every terminal is built the same and this is where it gets interesting 🙈 Some terminals literally cannot erase using the background colour. so on those ones, this operation might get implemented by just printing spaces instead. and the consequence of that? the cursor gets moved to the end of the erased region. meanwhile, the other terminals — the ones that can erase with background colour — get to erase without the cursor moving at all. iconic behaviour honestly 👑

that's where the moveend parameter comes in, because it controls where the cursor ends up when this function returns:

• TICKIT_YES — the cursor gets moved to the end of the erased region if that's required. no cap, it's going to the end 🫶
• TICKIT_NO — the cursor gets moved back to its original location if that's required. it stays home, periodt.
• TICKIT_MAYBE — this function just takes whichever behaviour is more optimal on the given terminal. main character energy, it decides for itself ✨

🎀 RETURN VALUE 🎀

tickit_term_erasech() returns no value. that's it, that's the whole thing, it's giving void 💀

🌈 SEE ALSO 🌈

• tickit_term_build(3)
• tickit_term_goto(3)
• tickit_term_print(3)
• tickit_term_setpen(3)
• tickit_term_chpen(3)
• tickit_term(7)
• tickit(7)

okay that's the whole page, you ate it, you understood it, i'm obsessed 🍓💜 this was TICKIT_TERM_ERASECH(3) from the Library Functions Manual — mwah, go erase some cells bestie 🧚💖