.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "al_peek_next_event" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_peek_next_event - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro.h>

bool al_peek_next_event(ALLEGRO_EVENT_QUEUE *queue, ALLEGRO_EVENT *ret_event)
\f[R]
.fi
.SH DESCRIPTION
.PP
Copy the contents of the next event in the event queue specified into
\f[V]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[V]ret_event\f[R] are unspecified.
.SH SEE ALSO
.PP
ALLEGRO_EVENT(3alleg5), al_get_next_event(3alleg5),
al_drop_next_event(3alleg5)