TICKIT_STRINGPOS_ZERO(3)

💖 TICKIT_STRINGPOS_ZERO 💖

okay bestie, so this one lives in section 3 of the Library Functions Manual — that's the "library calls" section, iykyk. It's called tickit_stringpos_zero, and it is exactly as extra as it sounds. 🎀

✨ NAME ✨

tickit_stringpos_zero — clear the fields of a string position counter. that's it. that's the whole job. and it does it flawlessly. 💅

🌸 SYNOPSIS 🌸

#include <tickit.h>

void tickit_stringpos_zero(TickitStringPos *pos);

and don't forget, you gotta link with -ltickit or nothing's gonna happen, no cap. 🫶

🦋 DESCRIPTION 🦋

so tickit_stringpos_zero() takes your pos — a TickitStringPos — and sets its four counter fields to zero. all four. every single one. zeroed. done. slay. ✨

now here's the tea: this operation is already done implicitly by tickit_utf8_count(3), so like, you're not obligated to call it yourself. 🙈

but here's where it eats: this function is genuinely useful when you want to initialise a counter to zeros before entering a loop, and then call tickit_utf8_countmore(3) on every iteration instead. it's giving setup-girl. it's giving pre-game. it's giving main character energy at the top of your for-loop. 💖

not me hyping up a function whose entire personality is "writes zero four times" 😭 but honestly? iconic. consistency queen. she knows what she is.

🔥 RETURN VALUE 🔥

tickit_stringpos_zero() returns no value. nothing. void. she gives you nothing back and honestly that's the vibe. 🫶

👑 SEE ALSO 👑

• tickit_utf8_count(3)
• tickit_stringpos_limit_bytes(3)
• tickit(7)

and that's the whole page bestie, go forth and zero those counters 🌈⭐

this little angel comes to you courtesy of the Library Functions Manual — the TICKIT_STRINGPOS_ZERO(3) page, no date stamped on it, just vibes and a void return. mwah. 💜🎀