std::unique_lock<Mutex>::try_lock

来自cppreference.com
< cpp‎ | thread‎ | unique lock
 
 
并发支持库
线程
(C++11)
(C++20)
(C++20)
this_thread 命名空间
(C++11)
(C++11)
(C++11)
互斥
(C++11)
(C++11)  
通用锁管理
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
条件变量
(C++11)
信号量
闩与屏障
(C++20)
(C++20)
未来体
(C++11)
(C++11)
(C++11)
(C++11)
安全回收
(C++26)
(C++26)
风险指针





原子类型
(C++11)
(C++20)
原子类型的初始化
(C++11)(C++20 中弃用)
(C++11)(C++20 中弃用)
内存定序
原子操作的自由函数
原子标志的自由函数
 
 
bool try_lock();
(C++11 起)

尝试锁定关联互斥体而不阻塞。相当于调用 mutex()->try_lock()

若无关联互斥体或关联互斥体已被此 std::unique_lock 锁定则抛出 std::system_error

参数

(无)

返回值

若成功得到互斥体的所有权则为 true,否则为 false

异常

  • mutex()->try_lock() 可能抛出的任何异常(互斥体 (Mutex) 类型在 try_lock 中不抛异常,但自定义的可锁可以)。

示例

以下示例尝试获取一个互斥体,将之锁定并解锁。

#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)
    {
        // 获取锁之前等待几秒钟。
        std::this_thread::sleep_for(wait);
 
        std::unique_lock<std::mutex> lock(counter_mutex, std::defer_lock);
        if (lock.try_lock())
            std::cout << '#' << id << ", 已获得锁。\n";
        else
        {
            std::cout << '#' << id << ", 获得锁失败。\n";
            return;
        }
 
        // 将锁保留一段时间。
        std::this_thread::sleep_for(acquire);
 
        std::cout << '#' << id << ", 释放锁(通过析构函数)。\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, 已获得锁。
#1, 获得锁失败。
#0, 释放锁(通过析构函数)。
#2, 已获得锁。
#2, 释放锁(通过析构函数)。

参阅

锁定(即获取其所有权)关联互斥体
(公开成员函数)
尝试锁定(即获得其所有权)关联的可定时锁定 (TimedLockable) 互斥体,若互斥体在给定时长中不可用则返回
(公开成员函数)
尝试锁定(即获得其所有权)关联可定时锁定 (TimedLockable) 互斥体,若抵达指定时间点互斥体仍不可用则返回
(公开成员函数)
解锁(即释放其所有权)关联互斥体
(公开成员函数)