CKTIS / C++
std::recursive_mutex — herhaald vergrendelen door dezelfde thread
Met std::recursive_mutex kan dezelfde thread dezelfde mutex meerdere keren vergrendelen. Andere threads kunnen de mutex pas vergrendelen nadat alle eigendomsniveaus zijn vrijgegeven. Voor elke geslaagde vergrendeling is een afzonderlijke ontgrendeling nodig.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <mutex>
std::recursive_mutex m;
std::lock_guard<std::recursive_mutex> guard(m);std::recursive_mutex, beschikbaar in <mutex>, biedt exclusief eigendom en staat toe dat de eigenaar de mutex herhaaldelijk vergrendelt. Anders dan bij std::mutex kan dezelfde thread opnieuw lock() aanroepen of met succes try_lock() aanroepen terwijl die de mutex al bezit. Dit betekent niet dat threads het eigendom delen.
Elke geslaagde vergrendeling verhoogt het nestingniveau en vereist één aanroep van unlock(). Totdat de eigenaar alle niveaus heeft vrijgegeven, blokkeert de lock()-aanroep van een andere thread en retourneert diens try_lock() false. Het maximale aantal niveaus is niet gespecificeerd: zodra dat is bereikt, mislukt try_lock() en gooit lock() std::system_error.
Gebruik std::lock_guard<std::recursive_mutex> om elke vergrendeling te koppelen aan vrijgave bij het verlaten van de scope, ook wanneer dat door een uitzondering gebeurt. De mutex moet langer bestaan dan de bijbehorende guards. Een mutex vernietigen terwijl die in bezit is, of een thread beëindigen terwijl die de mutex nog bezit, leidt tot ongedefinieerd gedrag.
In het voorbeeld houdt increment_twice() de buitenste vergrendeling vast en voegt elke aanroep van increment() tijdelijk een niveau toe. De guards geven de niveaus in omgekeerde volgorde vrij. Eén thread volstaat om herhaald vergrendelen en een deterministische uitvoer te laten zien; het voorbeeld test geen threadcontentie. Een recursive mutex vervangt geen doordachte vergrendelingsvolgorde voor meerdere mutexen.
Voorbeelden
#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';
}
Resultaat
2
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.