al_get_next_event(3)

💖 NAME 💖

al_get_next_event — Allegro 5 API, bestie. This one’s from the Library Functions Manual, and it’s literally giving “pop the next event off the queue” energy. ✨

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

bool al_get_next_event(ALLEGRO_EVENT_QUEUE *queue, ALLEGRO_EVENT *ret_event)

So yes: it takes an ALLEGRO_EVENT_QUEUE * called queue, an ALLEGRO_EVENT * called ret_event, and returns a bool. No cap. 💅

🎀 DESCRIPTION 🎀

Okay bestie, here’s the tea: al_get_next_event takes the next event out of the event queue specified, copies the contents into ret_event, and returns true. The original event will be removed from the queue — gone, bye, no take-backs. 🦋

If the event queue is empty, it returns false, and the contents of ret_event are unspecified. That word is doing a lot of work, bestie — the manual is not promising you anything cute in there. 🙈

🦋 SEE ALSO 🦋

• ALLEGRO_EVENT(3)
• al_peek_next_event(3)
• al_wait_for_event(3)

---

xoxo, the Allegro reference manual 💖 — that’s the source/version on the footer, and there’s literally no date listed on this page, so no fake date, bestie. al_get_next_event(3) out. 💅