al_get_next_event - Man Page

#include <allegro5/allegro.h>

bool al_get_next_event(ALLEGRO_EVENT_QUEUE *queue, ALLEGRO_EVENT *ret_event)

Take the next event out of the event queue specified, and copy the contents into ret_event, returning true. The original event will be removed from the queue. If the event queue is empty, return false and the contents of ret_event are unspecified.

ALLEGRO_EVENT(3), al_peek_next_event(3), al_wait_for_event(3)

al_emit_user_event(3), al_is_event_queue_empty(3), al_peek_next_event(3), al_unref_user_event(3), al_wait_for_event(3).