devela::_dep::sdl3::sys::hints

Function SDL_SetHintWithPriority

pub unsafe extern "C" fn SDL_SetHintWithPriority(
    name: *const i8,
    value: *const i8,
    priority: SDL_HintPriority,
) -> bool
Available on crate feature dep_sdl3 only.
Expand description

Set a hint with a specific priority.

The priority controls the behavior when setting a hint that already has a value. Hints will replace existing hints of their priority and lower. Environment variables are considered to have override priority.

§Parameters

  • name: the hint to set.
  • value: the value of the hint variable.
  • priority: the SDL_HintPriority level for the hint.

§Return value

Returns true on success or false on failure; call SDL_GetError() for more information.

§Thread safety

It is safe to call this function from any thread.

§Availability

This function is available since SDL 3.2.0.

§See also