qtimer_start(3)

💖 qtimer_start — start & stop a qtimer timing 💖

okay bestie, welcome to qtimer_start(3) from the libqthread fam 💅 this is the lil duo that turns your timer on and off, and honestly? iconic.

✨ NAME ✨

qtimer_start, qtimer_stop — start/stop a qtimer timing 🎀

🌸 SYNOPSIS 🌸

#include <qthread/qtimer.h>

void
qtimer_start (qtimer_t timer);

void
qtimer_stop (qtimer_t timer);

🦋 DESCRIPTION 🦋

okay so picture this: these two functions start and stop (respectively, bestie, in that order, don't mix them up 🙈) the timing of the qtimer timer. That's it. That's the whole job. Slay. ✨

💀 REAL TALK: before you use either of these, the timer must have been initialized with qtimer_create() and must not have been destroyed with qtimer_destroy(). If you skip the create step or you already yeeted it with destroy, you're in undefined territory and we can't help you, bestie.

now for the vibe check on how to not fumble this 👑

• In general, timers should not be started multiple times in a row without an intervening stop, and they shouldn't be stopped multiple times in a row without an intervening start either. In most cases this will not cause an error — it'll just do a "last operation wins" situation, which is lowkey fine. But still. Don't be messy. 🙏
• Timers should also be started before they are stopped. Again, in most cases this will not cause an error — instead it'll make the value of qtimer_secs() undefined 😭 which is NOT the vibe.

⚠️ and here's the part we need you to actually remember: the safety of mis-using qtimers is not guaranteed. Like, at all. So just... use them correctly? Please? For me? 🥺

🌈 SEE ALSO 🌈

• qtimer_create(3)
• qtimer_destroy(3)
• qtimer_secs(3)

and that's the tea, bestie 🍓 this page came from libqthread and it's dated JUNE 2010 (yeah, vintage, but she still ate 💅). now go forth and start/stop responsibly, mwah 🫶✨