.\" 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_lock_mutex" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_lock_mutex - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro.h>

void al_lock_mutex(ALLEGRO_MUTEX *mutex)
\f[R]
.fi
.SH DESCRIPTION
.PP
Acquire the lock on \f[V]mutex\f[R].
If the mutex is already locked by another thread, the call will block
until the mutex becomes available and locked.
.PP
If the mutex is already locked by the calling thread, then the behaviour
depends on whether the mutex was created with al_create_mutex(3alleg5)
or al_create_mutex_recursive(3alleg5).
In the former case, the behaviour is undefined; the most likely
behaviour is deadlock.
In the latter case, the count in the mutex will be incremented and the
call will return immediately.
.SH SEE ALSO
.PP
al_unlock_mutex(3alleg5).
.PP
\f[B]We don\[cq]t yet have al_mutex_trylock.\f[R]