SDL_SetHintWithPriority(3)

📦
version 3.4.18 · 9 versions
, in fedora 43, fedora 44

💖 SDL_SetHintWithPriority 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual — this one's about setting a hint with a specific priority, and it's lowkey iconic once you get the vibe. ✨

🌸 NAME 🌸

SDL_SetHintWithPriority — set a hint with a specific priority. that's it, that's the whole job. 💅

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_hints.h>

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

✨ DESCRIPTION ✨

so here's the tea, bestie: the priority is what controls the behavior when you're setting a hint that already has a value. 🫖

Hints will replace existing hints of their priority and lower. that's the rule, no cap.

And listen — environment variables are considered to have override priority. so like, if the env is talking, it's the main character and everything else is a supporting role. 👑

🎀 FUNCTION PARAMETERS 🎀

  • name — the hint to set. which one are we messing with today, queen?
  • value — the value of the hint variable. the actual content, the moment, the vibe.
  • priority — the SDL_HintPriority level for the hint. how loud do you want this hint to be?

💜 RETURN VALUE 💜

Returns true on success or false on failure. if it flopped, call SDL_GetError() for more information — she will tell you exactly what went wrong, fr fr. 😭

🔥 THREAD SAFETY 🔥

It is safe to call this function from any thread. yes, ANY thread. go off, multi-threaded legend. 🧚

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. vintage-ish but make it fresh. 🍓

🌈 SEE ALSO 🌈

Simple Directmedia Layer · SDL 3.4.18 · SDL_SetHintWithPriority(3) — mwah, that's the whole page, tysm for reading, go set some hints and slay 💖✨🎀🦋👑

📦 where this page comes from