SDL_Unsupported(3)

💖 SDL_Unsupported(3) 💖

okay bestie, gather round, because this is the SDL_Unsupported manual page and it's literally the easiest slay in the whole SDL3 FUNCTIONS lineup 🫶

It's a macro — yes, a macro — whose whole entire job is to standardize error reporting when somebody tries an operation that just... isn't supported. No cap. 💅

---

✨ NAME ✨

SDL_Unsupported — a macro to standardize error reporting on unsupported operations.

Like, that's it. That's the whole vibe. It shows up, it says "nope, not supported," and it does it consistently every single time. Iconic behavior fr fr. 👑

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_error.h>

#define SDL_Unsupported()               SDL_SetError("That operation is not supported")

Look at her. One line. No arguments. No return value. Just pure, unfiltered "this operation is not supported" energy. 🎀

---

🦋 DESCRIPTION 🦋

So here's the tea: this macro simply calls SDL_SetError() with a standardized error string.

Why? For convenience, for consistency, and for clarity. That's the trio. That's the main character energy. ✨

Instead of every single place in your codebase inventing its own little "uhhh this isn't supported sorry" message, you just hit SDL_Unsupported() and boom — the error string is always the exact same, and everyone reading your logs knows exactly what happened. Obsessed. 😭💖

---

🧚 THREAD SAFETY 🧚

It is safe to call this macro from any thread.

Any thread. All the threads. The threads are thriving, and this macro is not about to start drama between them. 🌈

---

⭐ AVAILABILITY ⭐

This macro is available since SDL 3.2.0.

So if you're on anything older than that, bestie... it's giving "not supported" in the most ironic way possible. 💀 (But also, the version you're reading about right now is newer than that, so you're chilling.) 🍓

---

periodt. That's the whole page. Go forth and report your unsupported operations with consistency and grace. 💅🫶

Simple Directmedia Layer — SDL 3.4.18 — SDL_Unsupported(3) 💖✨🎀🦋🌸