std::unique_lock<Mutex>::try_lock
来自cppreference.com
< cpp | thread | unique lock
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) 互斥体,若抵达指定时间点互斥体仍不可用则返回 (公开成员函数) | |
解锁(即释放其所有权)关联互斥体 (公开成员函数) |