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 ( ) ;
(начиная с C++11)

Пытается захватить (т.е. получить владение) связанным мьютексом без блокировки. Фактически вызывает mutex ( ) - > try_lock ( ) .

std::system_error выбрасывается, если нет связанного мьютекса или если мьютекс уже заблокирован этим std::unique_lock .

Содержание

Параметры

(нет)

Возвращаемое значение

true если владение мьютексом было успешно получено, false в противном случае.

Исключения

  • Любые исключения, выбрасываемые mutex ( ) - > try_lock ( ) ( Mutex типы не выбрасывают исключения в try_lock , но пользовательские Lockable могут).

Пример

Следующие примеры пытаются захватить мьютекс, который был заблокирован и разблокирован.

#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();
}

Вывод:

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

Смотрите также

блокирует (т.е. получает владение) связанный мьютекс
(публичная функция-член)
пытается заблокировать (т.е. получить владение) связанный TimedLockable мьютекс, возвращает управление если мьютекс был недоступен в течение указанного времени
(публичная функция-член)
пытается заблокировать (т.е. получить владение) связанный TimedLockable мьютекс, возвращает управление если мьютекс был недоступен до достижения указанной временной точки
(публичная функция-член)
разблокирует (т.е. освобождает владение) связанный мьютекс
(публичная функция-член)