SDL_GetEventFilter(3)

💖 SDL_GetEventFilter 💖

okay bestie, welcome to the SDL_GetEventFilter(3) page, straight out of the SDL3 FUNCTIONS lineup ✨ this one's a little query function and she's lowkey iconic for it.

---

🌸 NAME 🌸

SDL_GetEventFilter — ask the universe (well, SDL) which event filter is currently doing its thing 👑

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_events.h>

bool SDL_GetEventFilter(SDL_EventFilter *filter, void **userdata);

---

🦋 DESCRIPTION 🦋

so here's the vibe: this function lets you "chain" filters 🫶 like, you save the filter that's already there before you swap in your own replacement function, and then your replacement can just call that saved one like nothing ever happened. passing the torch, but make it event handling. 💅

---

🎀 FUNCTION PARAMETERS 🎀

• filter — the current callback function gets stored right here, no cap 📥
• userdata — and the pointer that's passed to the current event filter gets stashed here too 📥

---

⭐ RETURN VALUE ⭐

returns true when it works out 💖 or false if there's literally no event filter set — nothing to report, bestie 😭

---

💜 THREAD SAFETY 💜

you can call this from any thread and it's safe. go off, multithreaded queen 👑

---

🌈 AVAILABILITY 🌈

this one's been around since SDL 3.2.0 — a real one since day one, fr fr ✨

---

🔥 SEE ALSO 🔥

• SDL_SetEventFilter(3) — the partner in crime, the other half of the chain 🫶

---

mwah 💋 that's the whole page, and it comes to you courtesy of Simple Directmedia Layer, version SDL 3.4.18, dated SDL_GetEventFilter(3) — yes the date field is just the title again, she's quirky like that 🙈💅