.\" Automatically generated by Pandoc 3.1.3
.\"
.\" 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_create_mutex_recursive" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_create_mutex_recursive - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro.h>

ALLEGRO_MUTEX *al_create_mutex_recursive(void)
\f[R]
.fi
.SH DESCRIPTION
.PP
Create the mutex object (a mutual exclusion device), with support for
\[lq]recursive\[rq] locking.
That is, the mutex will count the number of times it has been locked by
the same thread.
If the caller tries to acquire a lock on the mutex when it already holds
the lock then the count is incremented.
The mutex is only unlocked when the thread releases the lock on the
mutex an equal number of times, i.e.\ the count drops down to zero.
.SH SEE ALSO
.PP
al_create_mutex(3alleg5).