Skip to main content

SDL_HINT_ASSERT

sdl3_sys::hints

Constant SDL_HINT_ASSERT 

Source 
pub const SDL_HINT_ASSERT: *const c_char = _; // {alloc10313<imm>: *const i8}
Expand description

A variable controlling response to SDL_assert failures.

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’s test again.
  • “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.2.0.