SDL_FlushEvents(3)

✨ SDL_FlushEvents ✨

okay so bestie, welcome to the SDL3 FUNCTIONS corner of the manual, and today's main character is SDL_FlushEvents(3) 💅

---

🌸 NAME 🌸

SDL_FlushEvents — clear events of a range of types from the event queue 🧹✨

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_events.h>

void SDL_FlushEvents(Uint32 minType, Uint32 maxType);

---

🦋 DESCRIPTION 🦋

This will unconditionally remove any events from the queue that are in the range of minType to maxType, inclusive. no vibe check, no "hmm should i", it just yeets them. 🗑️

If you need to remove a single event type, use SDL_FlushEvent() instead — that's the solo version, this one is the group chat. 💬

ngl it's also completely normal to just ignore events you don't care about in your event loop without calling this function at all. like, living your life and simply not responding? valid. 🙈

This function only affects currently queued events. So 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. pump first, then flush. that's the order, fr fr. 🔥

---

💖 FUNCTION PARAMETERS 💖

• minType — the low end of event type to be cleared, inclusive; see SDL_EventType for details. the bottom of the range, she's the floor 🫶
• maxType — the high end of event type to be cleared, inclusive; see SDL_EventType for details. the top of the range, she's the ceiling 👑

---

🌈 THREAD SAFETY 🌈

It is safe to call this function from any thread. literally any of them. go off, all your threads can do this 💜

---

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. if you're on something older... babe, we need to talk 😭

---

👑 SEE ALSO 👑

• SDL_FlushEvent(3)

---

Simple Directmedia Layer made this, and this lil doc is sitting on SDL 3.4.18 🌸 so yeah — mwah, kisses from the SDL 3.4.18 era, thanks for reading bestie, you ate this page fr fr 💅✨🎀