SDL_FilterEvents(3)

SDL_FilterEvents3

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

Usage

#include "SDL3/SDL.h"

void SDL_FilterEvents(SDL_EventFilter filter, void *userdata);

Header file

Defined in SDL3/SDL_events.h

Overview

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.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.