NAME¶

SDL_assert_paranoid - An assertion test that is performed only when built with paranoid settings.

HEADER FILE¶

Defined in SDL3/SDL_assert.h

SYNOPSIS¶

#include "SDL3/SDL.h"

#define SDL_assert_paranoid(condition) SDL_disabled_assert(condition)

DESCRIPTION¶

This macro is enabled when the SDL_ASSERT_LEVEL
is >= 3, otherwise it is disabled. This is a higher level than both release and debug, so these tests are meant to be expensive and only run when specifically looking for extremely unexpected failure cases in a special build.

When assertions are disabled, this wraps condition in a sizeof operator, which means any function calls and side effects will not run, but the compiler will not complain about any otherwise-unused variables that are only referenced in the assertion.

One can set the environment variable " SDL_ASSERT " to one of several strings ("abort", "break", "retry", "ignore", "always_ignore") to force a default behavior, which may be desirable for automation purposes. If your platform requires GUI interfaces to happen on the main thread but you're debugging an assertion in a background thread, it might be desirable to set this to "break" so that your debugger takes control as soon as assert is triggered, instead of risking a bad UI interaction (deadlock, etc) in the application.

Note that SDL_ASSERT
is an _environment variable_ and not an SDL hint! Please refer to your platform's documentation for how to set it!

AVAILABILITY¶

This macro is available since SDL 3.0.0.