.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "al_free" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_free - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro.h>

#define al_free(p) \[rs]
   (al_free_with_context((p), __LINE__, __FILE__, __func__))
\f[R]
.fi
.SH DESCRIPTION
.PP
Like free() in the C standard library, but the implementation may be
overridden.
.PP
Additionally, on Windows, a memory block allocated by one DLL must be
freed from the same DLL.
In the few places where an Allegro function returns a pointer that must
be freed, you must use al_free(3alleg5) for portability to Windows.
.PP
This is a macro.
.SH SEE ALSO
.PP
al_malloc(3alleg5), al_free_with_context(3alleg5)