std::unique_lock<Mutex>::try_lock_for
来自 cppreference.cn
< cpp | thread | unique lock
template< class Rep, class Period > bool try_lock_for( const std::chrono::duration<Rep, Period>& timeout_duration ); |
(自 C++11 起) | |
尝试锁定(即,取得所有权)关联的互斥量。阻塞直到指定的 timeout_duration 经过或获取到锁,以先发生者为准。成功获取锁时返回 true,否则返回 false。实际调用 mutex()->try_lock_for(timeout_duration)。
由于调度或资源争用延迟,此函数可能会阻塞超过 timeout_duration 的时间。
标准建议使用稳定时钟来测量持续时间。如果实现使用系统时钟,则等待时间也可能对时钟调整敏感。
如果没有关联的互斥量或互斥量已被此 std::unique_lock 锁定,则会抛出 std::system_error。
目录 |
[编辑] 参数
timeout_duration | - | 最大阻塞持续时间 |
[编辑] 返回值
true 如果已成功获取互斥量的所有权,否则为 false。
[编辑] 异常
- 由 mutex()->try_lock_for(timeout_duration) 抛出的任何异常。
- 如果没有关联的互斥量,则 std::system_error,错误代码为 std::errc::operation_not_permitted。
- 如果互斥量已被锁定,则 std::system_error,错误代码为 std::errc::resource_deadlock_would_occur。
[编辑] 示例
本节内容不完整 原因:没有示例 |
[编辑] 参见
锁定(即,取得所有权)关联的互斥量 (公共成员函数) | |
尝试锁定(即,取得所有权)关联的互斥量,不阻塞 (公共成员函数) | |
尝试在指定的持续时间内锁定关联的互斥量 ( std::shared_lock<Mutex> 的公共成员函数) | |
尝试锁定(即,取得所有权)关联的 TimedLockable 互斥量,如果互斥量在指定的时刻之前不可用则返回 (公共成员函数) | |
解锁(即,释放所有权)关联的互斥量 (公共成员函数) |