RWLock(3pm)

💖 NAME 💖

Coro::RWLock — reader/write locks, bestie. reader. writer. locks. iconic behaviour honestly 🎀

---

✨ SYNOPSIS ✨

okay so here's the whole vibe, copy-paste ready:

use Coro;

$lck = new Coro::RWLock;

$lck->rdlock; # acquire read lock
$lck->unlock; # unlock lock again

# or:
$lck->wrlock; # acquire write lock
$lck->unlock; # unlock lock again

# try a readlock
if ($lck->tryrdlock) {
   ...;
   $l->unlock;
}

# try a write lock
if ($lck->trywrlock) {
   ...;
   $l->unlock;
}

---

🌸 DESCRIPTION 🌸

so this module implements reader/write locks, and no cap it's such a clean concept. a read lock can be acquired for reading by many coroutines in parallel — as long as no writer has locked it. that's the shared access era 💅 a single write lock can be acquired when no readers exist. so basically RWLocks give you either many concurrent readers (and zero writers) OR exactly one writer (and zero readers). pick a lane, periodt.

and good news, you don't have to load Coro::RWLock manually 🫶 it gets loaded automatically when you use Coro and call the new constructor. the module said "not me doing the work for you" 😭

• $l = new Coro::RWLock; — make a brand new reader/writer lock. fresh out the box, main character energy 👑
• $l->rdlock — acquire a read lock. go read, queen 🦋
• $l->tryrdlock — try to acquire a read lock. lowkey the "are we doing this or not" check ⭐
• $l->wrlock — acquire a write lock. one writer at a time, no gatecrashing 🔥
• $l->trywrlock — try to acquire a write lock. same energy, write edition ✨
• $l->unlock — give up a previous rdlock or wrlock. let it go, bestie, you can't hold it forever 🌈

---

💜 AUTHOR/SUPPORT/CONTACT 💜

• Marc A. Lehmann <schmorp@schmorp.de>
• http://software.schmorp.de/pkg/Coro.html

---

and that's the page, babe 💖 this one's from perl v5.40.1, dated 2025-03-21 — stay locked in (the good way, the RWLock way), ily, bye 👑🎀✨