SDL_aligned_free(3)

💖 SDL_aligned_free(3) — the "okay bestie, we're done here" of memory management 💖

So you grabbed a chunk of memory with SDL_aligned_alloc() and now you're like... girl, what do I even do with this? Say less. This is the SDL3 function that hands it back. It lives in the SDL3 FUNCTIONS fam, and it's giving very much "cleanup era." 🧹✨

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_stdinc.h>

void SDL_aligned_free(void *mem);

---

🌸 DESCRIPTION 🌸

Okay so. Once you call this, that pointer is done. Like, no longer valid. Cannot be dereferenced anymore. Not even a little. Don't look at it, don't touch it, don't be like "but what if I just—" no. It's gone, the vibes are gone, move on. 💀

But also, plot twist that's actually very chill of it: if mem is NULL, this function does nothing. No crash, no drama, just a peaceful little no-op. Iconic behaviour honestly. 🫶

---

🎀 FUNCTION PARAMETERS 🎀

• mem — a pointer that was previously returned by SDL_aligned_alloc(), or NULL. That's it, that's the whole vibe check. 🌈

---

🦋 THREAD SAFETY 🦋

Bestie you can call this from any thread. Every single one. Go feral. It's safe. 💅

---

⭐ AVAILABILITY ⭐

This function has been available since SDL 3.2.0. So if you're on something older, respectfully, it's not there yet. 🙈

---

👑 SEE ALSO 👑

• SDL_aligned_alloc(3) — the one that gave you the memory in the first place. The origin story. The main character. Go read it. 📖

---

Simple Directmedia Layer · SDL 3.4.18 — that's the version tag, and it's serving. This page was brought to you by the SDL3 functions crew, and honestly? Freeing memory has never been this cute. Slay, free your pointers, hydrate, and go to bed. 💖✨🎀🦋🌸