SDL_setenv_unsafe(3)

💖 SDL_setenv_unsafe 💖

okay bestie, so this is a page from the SDL3 FUNCTIONS manual, and today's main character is SDL_setenv_unsafe — the little env-var setter that lowkey does exactly what it says but comes with a vibe warning, so stay with me 🫶

---

✨ NAME ✨

SDL_setenv_unsafe — sets the value of a variable in the environment. that's it, that's the whole job 💅

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_stdinc.h>

int SDL_setenv_unsafe(const char *name, const char *value, int overwrite);

---

🦋 FUNCTION PARAMETERS 🦋

• name — the name of the variable you wanna set, bestie. like the label on the jar 🎀
• value — the value of the variable you're setting. the contents of the jar, if you will ✨
• overwrite — the drama parameter 👀 pass 1 and it will overwrite the variable if it already exists; pass 0 and it just returns success without touching the variable if it's already there. so 0 is the "no thoughts, respect the existing vibe" option 🌈

---

👑 RETURN VALUE 👑

• returns 0 on success 🎉
• returns -1 on error 😭

---

💀 THREAD SAFETY 💀

not me warning you but… this function is not thread safe, periodt.

consider using SDL_SetEnvironmentVariable() instead, fr fr 🫶

---

⭐ AVAILABILITY ⭐

this function is available since SDL 3.2.0 ✨ iconic, honestly.

---

🌈 SEE ALSO 🌈

• SDL_SetEnvironmentVariable(3) — the thread-safe bestie you should probably be using 💖

---

and that's the whole page, babe, you ate it 💅✨

signing off with love: this came from the Simple Directmedia Layer crew, SDL 3.4.18 edition — mwah 💖🎀🦋