SDL_SetHintWithPriority(3)

SDL_SetHintWithPriority3

Set a hint with a specific priority.

Usage

#include "SDL3/SDL.h"

bool SDL_SetHintWithPriority(const char *name, const char *value, SDL_HintPriority priority);

Header file

Defined in SDL3/SDL_hints.h

Overview

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.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.