---
name: "SDL_InvalidParamError"
section: "3"
platform: "linux"
package: "libsdl3-doc"
version: "3.2.10+ds-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/SDL_InvalidParamError"
---

# SDL\_InvalidParamError(3)

A macro to standardize error reporting on unsupported operations.

## NAME

SDL\_InvalidParamError - A macro to standardize error reporting on unsupported operations.

## HEADER FILE

Defined in SDL3/SDL\_error.h

## SYNOPSIS

```
#include "SDL3/SDL.h"
```

**#define SDL\_InvalidParamError(param)    SDL\_SetError(***Parameter***'%s'***is***invalid",***(param))*

## DESCRIPTION

This simply calls  **SDL\_SetError** () with a standardized error string, for convenience, consistency, and clarity.

A common usage pattern inside SDL is this:

-

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

## THREAD SAFETY

It is safe to call this macro from any thread.

## AVAILABILITY

This macro is available since SDL 3.2.0.