SDL_SetPointerProperty(3)

💖 SDL_SetPointerProperty 💖

okay bestie, welcome to SDL3 FUNCTIONS — today's episode is all about SDL_SetPointerProperty, and honestly? she's a lil legend. ✨

---

🌸 NAME 🌸

SDL_SetPointerProperty — sets a pointer property inside a group of properties. that's it, that's the whole job, and she does it flawlessly. 💅

---

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_properties.h>

bool SDL_SetPointerProperty(SDL_PropertiesID props, const char *name, void *value);

---

🎀 FUNCTION PARAMETERS 🎀

• props — the properties you wanna modify. the lil group of properties. your canvas. 🎨
• name — the name of the property you're modifying. yep, just the name. identify yourself queen. 👑
• value — the new value of the property, or NULL to delete the property. so like, passing NULL here is you saying "and scene, we're done here." 💀

---

✨ RETURN VALUE ✨

returns true on success or false on failure. and if it fails? call SDL_GetError() for more info, because she WILL tell you what went wrong, no cap. 😭

---

🧚 THREAD SAFETY 🧚

it is safe to call this function from any thread. literally any of them. go wild. 🫶

---

💜 AVAILABILITY 💜

this function is available since SDL 3.2.0. so if you're on something older... bestie. upgrade. 🙈

---

🌈 SEE ALSO 🌈

the whole friend group, fr fr:

• SDL_GetPointerProperty(3)
• SDL_HasProperty(3)
• SDL_SetBooleanProperty(3)
• SDL_SetFloatProperty(3)
• SDL_SetNumberProperty(3)
• SDL_SetPointerPropertyWithCleanup(3)
• SDL_SetStringProperty(3)

---

lowkey reminder: value being NULL doesn't set a null pointer property, it deletes the property. that's not a vibe, that's a whole different operation. don't get it twisted. 💖

---

and that's the page!! brought to you by Simple Directmedia Layer, version SDL 3.4.18. go forth and set those pointer properties, bestie, you're gonna slay. 🍓💅🎀