NAME¶

SDL_HINT_ASSERT - A variable controlling response to SDL_assert
failures.

HEADER FILE¶

Defined in SDL3/SDL_hints.h

SYNOPSIS¶

#include "SDL3/SDL.h"

#define SDL_HINT_ASSERT SDL_ASSERT"

DESCRIPTION¶

The variable can be set to the following case-sensitive values:

• "abort": Program terminates immediately.

• "break": Program triggers a debugger breakpoint.

• "retry": Program reruns the SDL_assert

• "ignore": Program continues on, ignoring this assertion failure this
time.

• "always_ignore": Program continues on, ignoring this assertion failure
for the rest of the run.

Note that SDL_SetAssertionHandler
offers a programmatic means to deal with assertion failures through a callback, and this hint is largely intended to be used via environment variables by end users and automated tools.

This hint should be set before an assertion failure is triggered and can be changed at any time.

AVAILABILITY¶

This hint is available since SDL 3.1.3.