Namespaces
Variants

std::unique_lock<Mutex>:: try_lock

From cppreference.net
Concurrency support library
Threads
(C++11)
(C++20)
this_thread namespace
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
Generic lock management
Condition variables
(C++11)
Semaphores
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
Safe reclamation
Hazard pointers
Atomic types
(C++11)
(C++20)
Initialization of atomic types
(C++11) (deprecated in C++20)
(C++11) (deprecated in C++20)
Memory ordering
(C++11) (deprecated in C++26)
Free functions for atomic operations
Free functions for atomic flags
bool try_lock ( ) ;
(depuis C++11)

Tente de verrouiller (c'est-à-dire de prendre la propriété de) le mutex associé sans bloquer. Appelle effectivement mutex ( ) - > try_lock ( ) .

std::system_error est levée s'il n'y a pas de mutex associé ou si le mutex est déjà verrouillé par ce std::unique_lock .

Table des matières

Paramètres

(aucun)

Valeur de retour

true si la propriété du mutex a été acquise avec succès, false sinon.

Exceptions

  • Toute exception levée par mutex ( ) - > try_lock ( ) ( les types Mutex ne lèvent pas d'exception dans try_lock , mais un Lockable personnalisé pourrait le faire).

Exemple

Les exemples suivants tentent d'acquérir un mutex qui a été verrouillé et déverrouillé.

#include <chrono>
#include <iostream>
#include <mutex>
#include <thread>
#include <vector>
using namespace std::chrono_literals;
int main()
{
    std::mutex counter_mutex;
    std::vector<std::thread> threads;
    using Id = int;
    auto worker_task = [&](Id id, std::chrono::seconds wait, std::chrono::seconds acquire)
    {
        // wait for a few seconds before acquiring lock.
        std::this_thread::sleep_for(wait);
        std::unique_lock<std::mutex> lock(counter_mutex, std::defer_lock);
        if (lock.try_lock())
            std::cout << '#' << id << ", lock acquired.\n";
        else
        {
            std::cout << '#' << id << ", failed acquiring lock.\n";
            return;
        }
        // keep the lock for a while.
        std::this_thread::sleep_for(acquire);
        std::cout << '#' << id << ", releasing lock (via destructor).\n";
    };
    threads.emplace_back(worker_task, Id{0}, 0s, 2s);
    threads.emplace_back(worker_task, Id{1}, 1s, 0s);
    threads.emplace_back(worker_task, Id{2}, 3s, 0s);
    for (auto& thread : threads)
        thread.join();
}

Sortie :

#0, lock acquired.
#1, failed acquiring lock.
#0, releasing lock (via destructor).
#2, lock acquired.
#2, releasing lock (via destructor).

Voir aussi

verrouille (c'est-à-dire prend la possession de) le mutex associé
(fonction membre publique)
tente de verrouiller (c'est-à-dire prend la possession de) le mutex TimedLockable associé, retourne si le mutex est resté indisponible pendant la durée spécifiée
(fonction membre publique)
tente de verrouiller (c'est-à-dire prend la possession de) le mutex TimedLockable associé, retourne si le mutex est resté indisponible jusqu'à ce que le point temporel spécifié soit atteint
(fonction membre publique)
déverrouille (c'est-à-dire libère la possession de) le mutex associé
(fonction membre publique)