Provided by: libsdl3-doc_3.2.20+ds-2_all bug

NAME

       SDL_assert_release - An assertion test that is performed even in release builds.

SYNOPSIS

       #include <SDL3/SDL_assert.h>

       #define SDL_assert_release(condition) SDL_disabled_assert(condition)

DESCRIPTION

       This  macro  is  enabled when the SDL_ASSERT_LEVEL is >= 1, otherwise it is disabled. This is meant to be
       for tests that are cheap to make and extremely unlikely to fail; generally it is frowned upon to have  an
       assertion  failure  in  a  release build, so these assertions generally need to be of more than life-and-
       death importance if there's a chance they might trigger. You should almost always consider handling these
       cases more gracefully than an assert allows.

       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. *

MACRO PARAMETERS

       condition
              boolean value to test.

THREAD SAFETY

       It is safe to call this macro from any thread.

AVAILABILITY

       This macro is available since SDL 3.2.0.

Simple Directmedia Layer                           SDL 3.2.20                              SDL_assert_release(3)