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 否则为 false。
[编辑] 异常
- mutex()->try_lock_shared_for(timeout_duration) 抛出的任何异常。
- 如果没有关联的互斥锁,则抛出 std::system_error,错误代码为 std::errc::operation_not_permitted。
- 如果互斥锁已被锁定,则抛出 std::system_error,错误代码为 std::errc::resource_deadlock_would_occur。
[编辑] 示例
本节尚不完整 原因:没有示例 |
[编辑] 参见
尝试锁定(即获取所有权)关联的 TimedLockable 互斥锁,如果互斥锁在指定的时间段内不可用则返回 (std::unique_lock<Mutex> 的公共成员函数) | |
锁定关联的互斥锁 (公共成员函数) | |
尝试锁定关联的互斥锁 (公共成员函数) | |
尝试锁定关联的互斥锁,直到指定的时间点 (公共成员函数) | |
解锁关联的互斥锁 (公共成员函数) |