std::unique_lock<Mutex>::try_lock
来自cppreference.com
<tbody>
</tbody>
bool try_lock(); |
(C++11 起) | |
尝试锁定关联互斥体而不阻塞。相当于调用 mutex()->try_lock()。
若无关联互斥体或关联互斥体已被此 std::unique_lock 锁定则抛出 std::system_error。
参数
(无)
返回值
若成功得到互斥体的所有权则为 true,否则为 false。
异常
mutex()->try_lock()可能抛出的任何异常(互斥体 (Mutex) 类型在try_lock中不抛异常,但自定义的可锁可以)。
- 若无关联互斥体,则为以 std::errc::operation_not_permitted 为错误码的 std::system_error。
- 若关联互斥体已被此
std::unique_lock锁定,则为以 std::errc::resource_deadlock_would_occur 为错误码的 std::system_error。
示例
以下示例尝试获取一个互斥体,将之锁定并解锁。
运行此代码
#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) 互斥体,若抵达指定时间点互斥体仍不可用则返回 (公开成员函数) | |
| 解锁(即释放其所有权)关联互斥体 (公开成员函数) |