al_free(3)

💖 al_free(3) — bestie edition 💖

okay so this is al_free(3) from the Library Functions Manual, and it's giving Allegro 5 API realness. ✨

✨ NAME ✨

al_free — Allegro 5 API 👑

🎀 SYNOPSIS 🎀

              #include <allegro5/allegro.h>

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

🌸 DESCRIPTION 🌸

Like free() in the C standard library, but plot twist: the implementation may be overridden. 💅

Also, on Windows, a memory block allocated by one DLL must be freed from the same DLL. no cap — same DLL, bestie. So in the few places where an Allegro function returns a pointer that must be freed, you must use al_free(3) for portability to Windows. 🫶

This is a macro. 🦋

🦋 SEE ALSO 🦋

• al_malloc(3)
• al_free_with_context(3)

💖 from the Allegro reference manual — no date on this page, bestie — periodt 💖