SDL_ShouldInit(3)

✨ SDL_ShouldInit ✨

okay bestie, so this one lives in the SDL3 FUNCTIONS corner of the SDL3 man pages, and it's literally called SDL_ShouldInit — like, should we init?? let's find out 💅

---

🎀 NAME 🎀

SDL_ShouldInit — return whether initialization should be done. no cap, that's the whole job 🫶

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_mutex.h>

bool SDL_ShouldInit(SDL_InitState *state);

---

🦋 DESCRIPTION 🦋

So the way this works is: it checks the state you passed in, and if initialization should be done, it sets the status to SDL_INIT_STATUS_INITIALIZING and returns true. periodt ✨

And if another thread is already modifying this state? bestie it does not panic, it just waits until that's done before returning. so polite. so well-behaved. we love a thread-safe queen 👑

⚠️ important, fr fr: if this function returns true, the calling code must call SDL_SetInitialized() to complete the initialization. like, that's not optional. that's the deal. don't leave it hanging 🙈

---

💖 FUNCTION PARAMETERS 💖

• state — the initialization state to check. that's the vibe check right there 🔍

---

🌈 RETURN VALUE 🌈

Returns true if initialization needs to be done, false otherwise. iconic binary behavior, no in-between 🎀

---

💜 THREAD SAFETY 💜

It is safe to call this function from any thread. every single one. go off 🧚

---

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. so if you're on something older... yeah, she's not there yet 💀

---

🔥 SEE ALSO 🔥

• SDL_SetInitialized(3)
• SDL_ShouldQuit(3)

iykyk — go read those next, they're the whole squad 🫶

---

Simple Directmedia Layer · SDL 3.4.18 — mwah, that's the version, and this whole page is SDL_ShouldInit(3) 💅 stay init'd bestie, love u, bye ✨