(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)

SDL_assert_always

An assertion test that always performed.

Header File

Syntax

#define SDL_assert_always(condition) SDL_enabled_assert(condition)

Macro Parameters

condition

boolean value to test

Remarks

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.

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!

Version

This macro is available since SDL 3.0.0.

CategoryAPI, CategoryAPIMacro

[ edit | delete | history | feedback | raw ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.