SDL_CreateProperties(3)

✨ SDL_CreateProperties(3) ✨

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual, and today's main character is literally a function that hands you a whole lil bag of properties 💖

---

🎀 NAME 🎀

SDL_CreateProperties — create a group of properties.

like. a little squad. a friend group. for your properties. 💅

---

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_properties.h>

SDL_PropertiesID SDL_CreateProperties(void);

no arguments, no drama, she just takes zero things and gives you a whole group 🫶

---

🌸 DESCRIPTION 🌸

So here's the tea: all properties are automatically destroyed when SDL_Quit() is called. 🔥

Which is lowkey the best part?? Like you don't even have to remember to clean up, the cleanup is just... handled. iconic behaviour honestly. SDL_Quit() comes through and sweeps everything away, periodt.

---

👑 RETURN VALUE 👑

She returns an ID for a new group of properties ✨ — or 0 on failure 😭.

And if you get that 0? Do not panic, bestie. Just call SDL_GetError() for more information, she will tell you exactly what went wrong 🍓

---

💜 THREAD SAFETY 💜

It is safe to call this function from any thread. 🌈

No cap. Every thread. Go off, multitask, she's not gonna be weird about it 🙈

---

⭐ AVAILABILITY ⭐

This function is available since SDL 3.2.0. 🦋

(so if you're on something older, that's giving ancient, and she's simply not there yet 💀)

---

🌈 SEE ALSO 🌈

• SDL_DestroyProperties(3) — the other half of the duo, go say hi 👋

---

not me writing a whole love letter to a property container. anyway. she's useful, she's thread-safe, and she cleans up after herself. vibe check: passed 💅✨

---

Simple Directmedia Layer · SDL 3.4.18 · and yes, this was SDL_CreateProperties(3) the whole time 🎀

mwah, go make some properties, ily, bye 🫶💖🌸