SDL_stack_free(3)

📦
version 3.4.18 · 5 versions
, in fedora 43, fedora 44

💖 SDL_stack_free(3) 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual, where we're talking about SDL_stack_free — the little cleanup macro that goes hand-in-hand with SDL_stack_alloc. It's lowkey iconic, no cap. 🎀

✨ NAME ✨

SDL_stack_free — free memory that was previously allocated with SDL_stack_alloc. that's it, that's the job, and she does it flawlessly 💅

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_stdinc.h>

#define SDL_stack_free(data) ((void)(data))

like. look at her. one line. zero drama. 🦋

💫 DESCRIPTION 💫

okay so here's the tea, and it's actually kind of a slay: SDL_stack_free is smart about how the memory got allocated in the first place.

If SDL used alloca() to allocate this memory, this macro does nothing — well, almost nothing. It still inserts ((void)(data) so that the compiler sees an expression and doesn't get all weird about it. And the memory? It gets automatically released when the function that called SDL_stack_alloc() returns. so you literally don't have to do anything. the stack said "i got it babe" 🫶

If SDL used SDL_malloc(), though? Then it will SDL_free the memory immediately. right then. on the spot. no waiting. ⭐

so basically: whichever way it went down, you call this and you're covered. it's giving "one macro to rule them all" energy. 👑

🎀 MACRO PARAMETERS 🎀

  • data — the pointer, from SDL_stack_alloc(), that you wanna free. that's the one. hand her over. 🙈

🌈 THREAD SAFETY 🌈

It is safe to call this macro from any thread. yes bestie, ANY thread. go wild. multithreaded queen behavior fr fr. 🧚

⭐ AVAILABILITY ⭐

This macro has been available since SDL 3.2.0. so if you're on anything older… babe. upgrade. 😭

💜 SEE ALSO 💜

  • SDL_stack_alloc(3) — the other half of this duo, the one who actually does the allocating. they're a package deal, iykyk. 💖

and that's the whole page!! Simple Directmedia Layer, SDL 3.4.18 — mwah, thank you for coming to my ted talk, stay hydrated, free your stack memory, and remember: she's small, she's simple, and she's perfect. periodt. 💅✨🌸

📦 where this page comes from