al_wait_for_event_until(3alleg5)

✨ NAME ✨

al_wait_for_event_until — bestie, this is the Allegro 5 API function that sits there and waits for an event to show up, but like, only for as long as you tell it to 💅

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

bool al_wait_for_event_until(ALLEGRO_EVENT_QUEUE *queue,
   ALLEGRO_EVENT *ret_event, ALLEGRO_TIMEOUT *timeout)

---

💖 DESCRIPTION 💖

Okay so picture this: you've got an event queue, and you want it to be non-empty. That's literally the whole assignment. al_wait_for_event_until waits until the event queue you specified is not empty, no cap 🫶

Now here's where the plot splits, depending on what you pass in:

• If ret_event is not NULL, then the first event in the queue gets copied into ret_event and removed from the queue. Slay, it's yours now ✨
• If ret_event is NULL, then the first event just stays right there at the head of the queue. Not me leaving it exactly where I found it 💀

Meanwhile, timeout decides how long you're willing to wait for all this. And here's the vibe check:

• If the call times out, false is returned 😭
• Otherwise, if an event did occur, true is returned 👑

Heads up bestie: for compatibility with all platforms, timeout must be 2,147,483.647 seconds or less. Like, that's the ceiling. Don't be out here asking for more, it's giving incompatible 🚫

---

🦋 SEE ALSO 🦋

• ALLEGRO_EVENT(3alleg5)
• ALLEGRO_TIMEOUT(3alleg5)
• al_init_timeout(3alleg5)
• al_wait_for_event(3alleg5)
• al_wait_for_event_timed(3alleg5)

---

and that's the whole page, bestie — brought to you by the Allegro reference manual, page al_wait_for_event_until(3alleg5) (manual allegro5, section 3, the classics). go wait for your events, but like, with a timeout. periodt 💜🎀