.\" Automatically generated by Pandoc 3.6.1 .\" .TH "al_peek_next_event" "3" "" "Allegro reference manual" .SH NAME al_peek_next_event \- Allegro 5 API .SH SYNOPSIS .IP .EX #include \f[B]\f[R] bool al_peek_next_event(ALLEGRO_EVENT_QUEUE *queue, ALLEGRO_EVENT *ret_event) .EE .SH DESCRIPTION Copy the contents of the next event in the event queue specified into \f[CR]ret_event\f[R] 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 \f[CR]ret_event\f[R] are unspecified. .SH SEE ALSO ALLEGRO_EVENT(3), al_get_next_event(3), al_drop_next_event(3)