Clear events of a specific type from the event queue.
This will unconditionally remove any events from the queue that match
type. If you need to remove a range of event types, use SDL_FlushEvents()
instead.
It's also normal to just ignore events you don't care about in your event
loop without calling this function.
This function only affects currently queued events. If you want to make
sure that all pending OS events are flushed, you can call SDL_PumpEvents()
on the main thread immediately before the flush call.
If you have user events with custom data that needs to be freed, you should
use SDL_PeepEvents() to remove and clean up those events before calling
this function.
\param type the type of event to be cleared; see SDL_EventType for details.
\threadsafety It is safe to call this function from any thread.
\since This function is available since SDL 3.2.0.
Clear events of a specific type from the event queue.
This will unconditionally remove any events from the queue that match type. If you need to remove a range of event types, use SDL_FlushEvents() instead.
It's also normal to just ignore events you don't care about in your event loop without calling this function.
This function only affects currently queued events. If you want to make sure that all pending OS events are flushed, you can call SDL_PumpEvents() on the main thread immediately before the flush call.
If you have user events with custom data that needs to be freed, you should use SDL_PeepEvents() to remove and clean up those events before calling this function.
\param type the type of event to be cleared; see SDL_EventType for details.
\threadsafety It is safe to call this function from any thread.
\since This function is available since SDL 3.2.0.
\sa SDL_FlushEvents