SDL_DestroyProperties(3)

✨ SDL_DestroyProperties ✨

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual, page SDL_DestroyProperties(3), and babes this one is short and sweet πŸ’–

🌸 NAME 🌸

SDL_DestroyProperties β€” destroy a group of properties. that's it. that's the whole job. she's a closer, not a starter πŸŽ€


πŸ¦‹ SYNOPSIS πŸ¦‹

#include <SDL3/SDL_properties.h>

void SDL_DestroyProperties(SDL_PropertiesID props);

πŸ’… DESCRIPTION πŸ’…

so basically: every single property gets deleted, and their cleanup functions will be called, if any. like, all of them. the whole group. gone. and if any of those properties had a cleanup function attached, bestie, that function runs β€” that's the whole vibe. it's giving "spring cleaning but for a property group" 🧹✨


πŸ“ FUNCTION PARAMETERS πŸ“

  • props β€” the properties to destroy. hand her the group and she'll handle it, no cap 🫢

πŸ”₯ THREAD SAFETY πŸ”₯

ok this is the important one, do NOT skip it. you should not call this function while these properties are locked, or while other threads might be setting or getting values from these properties. that's a race condition waiting to happen and it is NOT the cute kind of chaos πŸ˜­πŸ’€

⭐ AVAILABILITY ⭐

this function has been available since SDL 3.2.0. she's been here, she's been slaying, periodt πŸ‘‘

🌈 SEE ALSO 🌈

  • SDL_CreateProperties(3) β€” the one who makes the group in the first place, because you gotta build it before you can destroy it, iykyk πŸ’œ

and that's the tea πŸŽ€ this page came to you courtesy of Simple Directmedia Layer, version SDL 3.4.18 β€” mwah, stay safe out there, and don't destroy properties you don't own 🫢✨

πŸ“¦ where this page comes from