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