SDL_UnlockRWLock(3)

✨ SDL_UnlockRWLock(3) ✨

okay bestie so this one is from the SDL3 FUNCTIONS collection — yeah, the manpage crew, manual name and all, we're just vibing here 💅

---

🌸 NAME 🌸

SDL_UnlockRWLock — unlock the read/write lock. that's it. that's the whole job. 🔓

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_mutex.h>

void SDL_UnlockRWLock(SDL_RWLock *rwlock);

---

💖 DESCRIPTION 💖

Use this function to unlock the rwlock, and lowkey it does not care whether it was locked for read-only or write operations — either way, this is your girl. 💅

Now here's the part where it gets cute: it is legal for the owning thread to lock an already-locked read-only lock. Yes bestie, she's re-entrant like that. ✨ But — and this is the catch — it must unlock it the same number of times before it is actually made available for other threads in the system. That's what they call a "recursive rwlock". Count your unlocks, fr fr. 🔢

⚠️ And now the scary part: it is illegal to unlock a rwlock that has not been locked by the current thread. Doing that = undefined behavior. Not "oopsie" behavior, not "probably fine" behavior — undefined. Do not. 🚫💀

---

🫶 FUNCTION PARAMETERS 🫶

• rwlock — the rwlock to unlock. the one. the only. your problematic fave. 🎀

---

🔥 THREAD SAFETY 🔥

This call must be paired with a previous locking call on the same thread. no solo unlocks. no unlocking someone else's lock. it's giving committed relationship, not situationship. 🫶✨

---

🌈 AVAILABILITY 🌈

This function is available since SDL 3.2.0. so if you're on something older, no she is not there, don't go looking. 👑

---

💜 SEE ALSO 💜

• SDL_LockRWLockForReading(3)
• SDL_LockRWLockForWriting(3)
• SDL_TryLockRWLockForReading(3)
• SDL_TryLockRWLockForWriting(3)

go lock something, then come back and unlock it the same number of times. iykyk. 🦋

---

okay that's the whole page, and a lil sign-off for the credits because they ate: this came to you from Simple Directmedia Layer, version SDL 3.4.18 — iconic, no cap. mwah. 💖🎀🦋