al_peek_next_event(3)

🦋 al_peek_next_event(3) 🦋

Hey bestie, welcome to the Library Functions Manual — this page is from the Allegro 5 API, and it’s lowkey iconic for anyone who’s ever wanted to look at an event without actually removing it. 👀✨

---

✨ NAME ✨

al_peek_next_event — Allegro 5 API. The function that lets you peek at the next event like a nosy bestie, no cap. 💅

📜 SYNOPSIS 📜

#include <allegro5/allegro.h>

bool al_peek_next_event(ALLEGRO_EVENT_QUEUE *queue, ALLEGRO_EVENT *ret_event)

💖 DESCRIPTION 💖

Okay so here’s the tea: al_peek_next_event copies the contents of the next event in the event queue you specified into ret_event, and then it returns true. ✨ The original event packet stays right at the head of the queue — it does not get removed, so everyone can keep looking at it. Iconic behavior, honestly.

If the event queue is actually empty, this function returns false, and the contents of ret_event are unspecified — so don’t trust whatever’s chilling in there, bestie. 😭💀

👀 SEE ALSO 👀

• ALLEGRO_EVENT(3)
• al_get_next_event(3)
• al_drop_next_event(3)

---

Okay that’s the whole vibe! 💖 Source/version: Allegro reference manual · page: al_peek_next_event(3) · date: the footer didn’t give one, bestie, so no cap — that’s all she wrote. 🎀