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

CKTIS / C++

std::unique_lock — flexibilní správa zámku mutexu

std::unique_lock je přesouvatelný, ale nekopírovatelný RAII objekt z <mutex>, který spravuje vlastnictví zámku mutexu. Umožňuje odložit zamknutí, odemknout před opuštěním rozsahu platnosti a znovu zamknout. Jeho destruktor mutex odemkne pouze tehdy, pokud objekt zámek stále vlastní.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

#include <mutex>
std::unique_lock<Mutex> lock(mutex);
std::unique_lock<Mutex> lock(mutex, std::defer_lock);

std::unique_lock<Mutex> z <mutex> spravuje vlastnictví zámku, nikoli dobu života mutexu. Používá RAII: pokud objekt zámek vlastní, jeho destruktor zavolá na mutexu unlock(), a to i tehdy, když k opuštění rozsahu platnosti dojde kvůli výjimce. Mutex musí zůstat platný po celou dobu, kdy je s ním objekt spojen. Objekt lze přesouvat, ale nelze jej kopírovat.

Konstrukce pouze s mutexem zavolá jeho lock(). Značka std::defer_lock vytvoří spojení bez zamknutí; std::try_to_lock provede neblokující pokus, jehož výsledek lze ověřit pomocí owns_lock() nebo převodem na bool. std::adopt_lock vyžaduje, aby aktuální vlákno již vlastnilo výhradní zámek mutexu; nejde o způsob, jak zámek získat.

Pomocí lock() a unlock() můžete změnit stav před opuštěním rozsahu platnosti. Nevolejte lock(), pokud objekt zámek již vlastní, ani unlock(), pokud jej nevlastní. Mutex musí splňovat požadavky BasicLockable; operace pokusu o zamknutí navíc vyžadují Lockable, zatímco try_lock_for() a try_lock_until() vyžadují TimedLockable. Použití std::unique_lock samo o sobě nepřidává mutexu podporu časových limitů.

Nezaměňujte release() za unlock(): release() vrátí ukazatel na mutex a zruší spojení, ale mutex neodemkne. Odpovědnost za případné potřebné odemknutí přechází na volající kód. Příklad ukazuje odložené zamknutí, explicitní odemknutí a opětovné zamknutí, po kterém destruktor zámek uvolní. Jediné vlákno zajišťuje deterministický výstup; příklad nepředvádí soupeření vláken.

Příklady

#include <iostream>
#include <mutex>

int main() {
    std::mutex mutex;
    int value = 0;
    {
        std::unique_lock<std::mutex> lock(mutex, std::defer_lock);
        std::cout << std::boolalpha << lock.owns_lock() << '\n';
        lock.lock();
        ++value;
        std::cout << lock.owns_lock() << ' ' << value << '\n';
        lock.unlock();
        std::cout << lock.owns_lock() << '\n';
        lock.lock();
    }
    std::cout << value << '\n';
}

Výsledek

false
true 1
false
1

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