al_rest(3)

💅 al_rest(3)

okay so this is a page from the Library Functions Manual — yes, the Library Functions Manual, we're being fancy today — and it's all about al_rest, a lil function from the Allegro 5 API 🎀

---

✨ NAME ✨

al_rest — Allegro 5 API 💖

---

🦋 SYNOPSIS 🦋

#include <allegro5/allegro.h>

void al_rest(double seconds)

like, that's the whole thing. one include, one function. iconic minimalism 💅

---

🌸 DESCRIPTION 🌸

So al_rest waits for the number of seconds you give it. yep, that's the vibe — it tells the system to pause the current thread for however long you asked for ⏸️

Bestie, here's the part you gotta know: on some operating systems the accuracy can be in the order of 10ms. like, "in the order of" — so don't come for me when it's not perfectly precise 😭

That means even something like this:

al_rest(0.000001)

might pause for something like 10ms. yeah. a whole 10ms for a microsecond request. it's giving "close enough" 💀

fr fr, don't build your entire timing system on this being nano-precise, okay? 🙈

Also — and this is the good part — go check out the section on Timer routines for easier ways to time your program without using up all your CPU 🔥 your processor will literally thank you 🫶

---

👑 sign-off 👑

that's the whole page, bestie! this little reference lives in the Allegro reference manual, filed under al_rest(3). no cap, that's genuinely all of it 🌈✨💜