al_wait_for_event(3)

💖 al_wait_for_event(3) 💖

okay bestie, welcome to the Library Functions Manual corner of the Allegroverse — this one is short, sweet, and lowkey a whole waiting vibe. ✨

🌸 NAME 🌸

al_wait_for_event — Allegro 5 API.

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

void al_wait_for_event(ALLEGRO_EVENT_QUEUE *queue, ALLEGRO_EVENT *ret_event)

🦋 DESCRIPTION 🦋

So like, this function waits until the event queue you specified is non-empty. It just sits there with main character energy until something shows up. 💅

If ret_event is not NULL, the first event in the queue gets copied into ret_event and removed from the queue. Snatched, archived, no longer in the queue — periodt. 🎀

If ret_event is NULL, the first event is left at the head of the queue. Not me leaving it right there for later, but yes exactly that. 💀

bestie, this function is literally just waiting. that’s the job. no cap. 🫶

🌈 SEE ALSO 🌈

• ALLEGRO_EVENT(3)
• al_wait_for_event_timed(3)
• al_wait_for_event_until(3)
• al_get_next_event(3)

---

later bestie! 💜 source/version: Allegro reference manual; page: al_wait_for_event(3); date: not printed in this footer (mysterious, iconic, we move). 🦋