NAME
SDL_SetHintWithPriority - Set a hint with a specific priority.
HEADER FILE
Defined in SDL3/SDL_hints.h
SYNOPSIS
#include "SDL3/SDL.h"
bool SDL_SetHintWithPriority(const char *name, const char *value, SDL_HintPriority priority);
DESCRIPTION
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.
FUNCTION 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
•(3), SDL_GetHint(3), •(3), SDL_ResetHint(3), •(3), SDL_SetHint(3)