Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje