al_free(3alleg5)

✨ al_free — Allegro 5 API ✨

okay bestie, welcome to al_free from the Allegro 5 API 💖 this one's a lil macro that frees memory, and honestly it's giving "responsible queen" energy. let's get into it 🫶

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

#define al_free(p) \
   (al_free_with_context((p), __LINE__, __FILE__, __func__))

no cap, that's the whole thing 👑 it's a macro, not a real function, so it sneaks in some extra context (your line number, your file, your function name) before handing off to the actual worker.

---

💅 DESCRIPTION 💅

so basically al_free is like free() from the C standard library… except the implementation may be overridden ✨ that's the whole plot twist. same vibes, but Allegro-friendly.

now here's the part you actually need to remember, bestie, because it WILL bite you:

on Windows, a memory block that was allocated by one DLL has to be freed from the same DLL. periodt. that's just how it is on that platform 😭

so in the few places where an Allegro function hands you back a pointer that you're supposed to free, you must use al_free instead of plain old free() — that's what makes your code portable to Windows. do not skip this, fr fr 💀

and just to be super clear one more time: this is a macro. 🦋

lowkey important: it's a macro, not a function — so don't go taking its address or doing weird function-pointer shenanigans with it 🙈

---

🎀 SEE ALSO 🎀

• al_malloc(3alleg5)
• al_free_with_context(3alleg5)

---

that's the page, bestie! this was al_free(3alleg5) straight out of the Allegro reference manual 🧚💜 go forth and free your memory responsibly, you main character 🫶✨