SDL_FilterEvents - Man Page

Run a specific filter function on the current event queue, removing any events for which the filter returns false.

Synopsis

#include <SDL3/SDL_events.h>

void SDL_FilterEvents(SDL_EventFilter filter, void *userdata);

Description

See SDL_SetEventFilter() for more information. Unlike SDL_SetEventFilter(), this function does not change the filter permanently, it only uses the supplied filter until this function returns.

Function Parameters

filter

the SDL_EventFilter function to call when an event happens.

userdata

a pointer that is passed to filter.

Thread Safety

It is safe to call this function from any thread.

Availability

This function is available since SDL 3.2.0.

See Also

SDL_GetEventFilter(3), SDL_SetEventFilter(3)

Info

SDL 3.2.16 Simple Directmedia Layer SDL3 FUNCTIONS