CKTIS / C++
std::recursive_mutex — ponowne blokowanie przez ten sam wątek
std::recursive_mutex pozwala temu samemu wątkowi wielokrotnie przejąć ten sam muteks. Inne wątki mogą go przejąć dopiero po zwolnieniu wszystkich poziomów własności. Każde udane przejęcie wymaga osobnego odblokowania.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <mutex>
std::recursive_mutex m;
std::lock_guard<std::recursive_mutex> guard(m);std::recursive_mutex, dostępny w <mutex>, zapewnia wyłączną własność z możliwością ponownego przejęcia przez właściciela. W odróżnieniu od std::mutex pozwala temu samemu wątkowi ponownie wywołać lock() lub skutecznie wywołać try_lock(), gdy już posiada muteks. Nie oznacza to współdzielenia własności między wątkami.
Każde udane przejęcie zwiększa poziom zagnieżdżenia i wymaga jednego unlock(). Dopóki właściciel nie zwolni wszystkich poziomów, lock() innego wątku blokuje, a jego try_lock() zwraca false. Maksymalna liczba poziomów nie jest określona przez standard: po jej osiągnięciu try_lock() zawodzi, a lock() zgłasza std::system_error.
Stosuj std::lock_guard<std::recursive_mutex>, aby powiązać każde przejęcie ze zwolnieniem przy opuszczaniu zakresu, także wskutek wyjątku. Muteks musi istnieć dłużej niż jego strażnicy. Zniszczenie posiadanego muteksu lub zakończenie wątku, który nadal go posiada, powoduje niezdefiniowane zachowanie.
W przykładzie increment_twice() utrzymuje zewnętrzną blokadę, a każde wywołanie increment() tymczasowo dodaje kolejny poziom. Strażnicy zwalniają poziomy w odwrotnej kolejności. Jeden wątek wystarcza do pokazania ponownego przejęcia i deterministycznego wyniku; przykład nie testuje rywalizacji wątków. Rekurencyjny muteks nie zastępuje przemyślanej kolejności blokowania wielu muteksów.
Przykłady
#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';
}
Wynik
2
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.