SDL_PeepEvents(3) SDL API Reference SDL_PeepEvents(3)

NAME

SDL_PeepEvents - Checks the event queue for messages and optionally
returns them.

SYNOPSIS

#include "SDL.h"

int SDL_PeepEvents(SDL_Event *events, int numevents, SDL_eventaction
action, Uint32 mask);

DESCRIPTION

Checks the event queue for messages and optionally returns them.

If action is SDL_ADDEVENT, up to numevents events will be added to
the back of the event queue.

If action is SDL_PEEKEVENT, up to numevents events at the front of
the event queue, matching mask, will be returned and will not be
removed from the queue.

If action is SDL_GETEVENT, up to numevents events at the front of the
event queue, matching mask, will be returned and will be removed from
the queue.

This function is thread-safe.

RETURN VALUE

This function returns the number of events actually stored, or -1 if
there was an error.

SEE ALSO

SDL_Event, SDL_PollEvent, SDL_PushEvent

SDL Tue 11 Sep 2001, 22:59 SDL_PeepEvents(3)