al_destroy_sample(3alleg5)

💖 al_destroy_sample 💖

okay bestie, welcome to the Allegro 5 API corner of the Allegro reference manual ✨ this one's short and sweet and honestly kinda iconic 🎀

---

🌸 NAME 🌸

al_destroy_sample — Allegro 5 API 💅

---

✨ SYNOPSIS ✨

#include <allegro5/allegro_audio.h>

void al_destroy_sample(ALLEGRO_SAMPLE *spl)

---

🦋 DESCRIPTION 🦋

okay so. this is the moment where your sample says its goodbyes and moves out 🫶 this function frees the sample data structure. no cap, it's gone, it's giving closure 💀

and here's the little detail you do NOT wanna skip, bestie: if that sample was created with the free_buf parameter set to true, then the buffer gets freed too, using al_free(3alleg5) ✨ so like, double cleanup, the whole vibe gets swept away 🌈

also, and this is the part that's lowkey important: this function will stop any sample instances which may be playing the buffer referenced by the ALLEGRO_SAMPLE(3alleg5) 🛑 so no zombie audio haunting you after you've already said bye. she's thorough, she's responsible, she's the main character 👑

⚠️ heads up: don't go using that ALLEGRO_SAMPLE after this, bestie. it's been freed. that's a one-way trip 🙈

---

🌟 SEE ALSO 🌟

• al_destroy_sample_instance(3alleg5)
• al_stop_sample(3alleg5)
• al_stop_samples(3alleg5)

---

k bye, this page came straight out of the Allegro reference manual — al_destroy_sample(3alleg5), mwah 💋 slay, go free your samples responsibly 🎀💖✨