al_peek_next_event - Man Page

#include <allegro5/allegro.h>

bool al_peek_next_event(ALLEGRO_EVENT_QUEUE *queue, ALLEGRO_EVENT *ret_event)

Copy the contents of the next event in the event queue specified into ret_event and return true. The original event packet will remain at the head of the queue. If the event queue is actually empty, this function returns false and the contents of ret_event are unspecified.

ALLEGRO_EVENT(3), al_get_next_event(3), al_drop_next_event(3)

al_emit_user_event(3), al_get_next_event(3), al_is_event_queue_empty(3), al_unref_user_event(3).