CKTIS / C++
std::recursive_mutex — opakované zamykání stejným vláknem
std::recursive_mutex umožňuje stejnému vláknu opakovaně získat tentýž mutex. Ostatní vlákna jej mohou získat až po uvolnění všech úrovní vlastnictví. Každé úspěšné získání vyžaduje samostatné odemknutí.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <mutex>
std::recursive_mutex m;
std::lock_guard<std::recursive_mutex> guard(m);std::recursive_mutex, dostupný v <mutex>, poskytuje výhradní vlastnictví a umožňuje vlastníkovi získat mutex opakovaně. Na rozdíl od std::mutex dovoluje stejnému vláknu znovu zavolat lock() nebo úspěšně zavolat try_lock(), když už mutex vlastní. Neznamená to, že by vlastnictví sdílela různá vlákna.
Každé úspěšné získání zvýší úroveň vnoření a vyžaduje jedno zavolání unlock(). Dokud vlastník neuvolní všechny úrovně, lock() jiného vlákna blokuje a jeho try_lock() vrátí false. Maximální počet úrovní není určen: po jeho dosažení try_lock() selže a lock() vyhodí std::system_error.
Použijte std::lock_guard<std::recursive_mutex>, aby se každé získání uvolnilo při opuštění rozsahu platnosti, a to i při opuštění kvůli výjimce. Mutex musí existovat déle než jeho guards. Zničení vlastněného mutexu nebo ukončení vlákna, které jej stále vlastní, způsobuje nedefinované chování.
V příkladu increment_twice() drží vnější zámek a každé zavolání increment() dočasně přidá další úroveň. Guards uvolní úrovně v opačném pořadí. K předvedení opakovaného získání a deterministického výstupu stačí jedno vlákno; příklad netestuje soupeření vláken. Rekurzivní mutex nenahrazuje promyšlené pořadí zamykání více mutexů.
Příklady
#include <iostream>
#include <mutex>
class Counter {
std::recursive_mutex mutex_;
int value_ = 0;
public:
void increment() {
std::lock_guard<std::recursive_mutex> guard(mutex_);
++value_;
}
int increment_twice() {
std::lock_guard<std::recursive_mutex> guard(mutex_);
increment();
increment();
return value_;
}
};
int main() {
Counter counter;
std::cout << counter.increment_twice() << '\n';
}
Výsledek
2
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.