SDL_InvalidParamError(3)

💖 NAME 💖

SDL_InvalidParamError — a macro to standardize error reporting on unsupported operations, bestie ✨

So this is from the SDL3 FUNCTIONS manual, and it's giving "I make your error messages not a mess" energy, fr fr 💅

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_error.h>

#define SDL_InvalidParamError(param)    SDL_SetError("Parameter '%s' is invalid", (param))

Like, that's the whole thing. A tiny macro with main character energy 👑

---

🦋 DESCRIPTION 🦋

Okay so here's the tea: this macro literally just calls SDL_SetError() with a standardized error string. That's it. That's the vibe. It's for convenience, consistency, and clarity — three things we absolutely love in this house 🫶

Inside SDL, there's a common usage pattern that looks like this:

bool MyFunction(const char *str) {
    if (!str) {
        return SDL_InvalidParamError("str");  // returns false.
    }
    DoSomething(str);
    return true;
}

See how clean that is? If str is NULL, it returns SDL_InvalidParamError("str"), which returns false, and the error message is already handled. No chaos, no mess, no "wait what went wrong" moments. Iconic behavior, honestly 💀✨

---

🧚 THREAD SAFETY 🧚

Good news bestie: it is safe to call this macro from any thread. No cap. Go wild, multi-threaded queen 👑

---

🌸 AVAILABILITY 🌸

This macro has been available since SDL 3.2.0. So if you're on something older… girl, upgrade 😭

---

Lowkey obsessed with how a one-line macro can carry so much responsibility. It's giving "small but mighty." Periodt 💅

---

Simple Directmedia Layer made this, it's from the SDL 3.4.18 era, and that's the whole page. Byeee, go standardize your errors and slay 🎀🌈💖