table of contents
SDL_assert_always(3) | SDL3 FUNCTIONS | SDL_assert_always(3) |
NAME¶
SDL_assert_always - An assertion test that is always performed.
HEADER FILE¶
Defined in SDL3/SDL_assert.h
SYNOPSIS¶
#include "SDL3/SDL.h"
#define SDL_assert_always(condition) SDL_enabled_assert(condition)
DESCRIPTION¶
This macro is always enabled no matter what
SDL_ASSERT_LEVEL
is set to. You almost never want to use this, as it could trigger on an
end-user's system, crashing your program.
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.
THREAD SAFETY¶
It is safe to call this macro from any thread.
AVAILABILITY¶
This macro is available since SDL 3.1.3.
SDL 3.1.6 | Simple Directmedia Layer |