MIX_Quit(3)

✨ MIX_Quit(3) ✨

okay bestie, this is the other half of the SDL_mixer care routine 💖 it lives in the SDL_mixer3 FUNCTIONS crew, and it's the "k bye, turning the lights off" function. let's get into it.

---

🌸 NAME 🌸

MIX_Quit — deinitialize the SDL_mixer library. that's it, that's the girl. she packs up the whole vibe. 🎀

---

✨ SYNOPSIS ✨

#include <SDL3_mixer/SDL_mixer.h>

void MIX_Quit(void);

no arguments, no return value, no drama. just vibes and cleanup 💅

---

🦋 DESCRIPTION 🦋

so here's the tea: you must call this when you're done with the library. like, probably at the very end of your program. it's the last song of the night, the closing credits, the "okay everyone out of the pool" moment 🏊♀️

good news though — it's totally safe to call this multiple times. the library is not gonna quadruple-deinitialize on you, she's smarter than that. it'll only actually deinitialize once, and that happens when you've called this function the same number of times MIX_Init was successfully called. matching energy, fr fr. 👑

and once you've successfully deinitialized the library? it's safe to call MIX_Init to reinitialize it for further use. so like, you can leave the party and come back later, no hard feelings 🫶

on successful deinitialization, SDL_mixer will destroy almost all created objects, including objects of type:

• MIX_Mixer
• MIX_Track
• MIX_Audio
• MIX_Group
• MIX_AudioDecoder

...which is to say: it's possible a single call to this function will clean up anything it allocated, stop all audio output, close audio devices, etc. she's doing a full closet cleanout, no mercy. 🔥

⚠️ do NOT attempt to destroy objects after this call. like, don't. they're gone, bestie. touching them is giving undefined behaviour energy and we don't do that here 💀

that said, the app is still encouraged to manage its resources carefully and clean up first — treat this function as a safety net against memory leaks, not as your whole personality. be a responsible main character 🌈

---

😭 THREAD SAFETY 😭

this function is not thread safe. so don't be out here calling it from five threads at once thinking you're clever. you're not. put the threads down. 🙈

---

⭐ AVAILABILITY ⭐

this function has been available since SDL_mixer 3.0.0. so it's been doing its little cleanup dance for a minute now 👑

---

💜 SEE ALSO 💜

• MIX_Init(3) — the other half of the duo. she starts, this one stops. iconic pairing tbh 🎀

---

and that's the page!! SDL_mixer 3.2.4, page MIX_Quit(3), written up with love. now go call your init/quit pairs like a good bestie and take care of your memory leaks 💖✨🦋