AL_CREATE_MUTEX_RECURSIVE(3)

💖 al_create_mutex_recursive 💖

okay bestie, this one's from the Allegro 5 API manual — the Library Functions Manual vibe, iykyk. Here's the literal function, no cap:

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

ALLEGRO_MUTEX *al_create_mutex_recursive(void)

🌸 DESCRIPTION 🌸

So al_create_mutex_recursive creates the mutex object — that's a mutual exclusion device, bestie — and it has support for “recursive” locking. The way that works: the mutex counts the number of times it's 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 gets 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. Periodt. 💅

no extra lore here, just the count going up and down exactly like that. 🎀

🦋 SEE ALSO 🦋

• al_create_mutex(3) — that's the cross-reference, bestie, go click it. 🫶

---

cute little sign-off: this page's footer is from the Allegro reference manual, and there's no date printed on it, so I'm not inventing one — that's the whole tea. 🍓