std::shared_timed_mutex::try_lock_shared_for
来自 cppreference.cn
< cpp | thread | shared timed mutex
template< class Rep, class Period > bool try_lock_shared_for( const std::chrono::duration<Rep,Period>& timeout_duration ); |
(C++14 起) | |
尝试以共享模式锁定互斥量。阻塞直到指定的 timeout_duration 已过去或者共享锁被获取,以先发生者为准。成功获取锁时返回 true,否则返回 false。
如果 timeout_duration 小于或等于 timeout_duration.zero(),则此函数的行为与 try_lock_shared() 相同。
由于调度或资源竞争延迟,此函数可能会阻塞超过 timeout_duration 的时间。
标准建议使用稳定时钟来测量持续时间。如果实现使用系统时钟,则等待时间也可能对时钟调整敏感。
与 try_lock_shared() 类似,此函数允许虚假失败并返回 false,即使在 timeout_duration 期间的某个时刻,互斥量并未被任何其他线程锁定。
如果返回 true,则此操作与在同一互斥量上先前的 unlock() 操作同步(如 std::memory_order 中定义)。
如果一个线程已经以任何模式(共享或独占)拥有 mutex
,然后调用 try_lock_shared_for
,则行为是未定义的。
目录 |
[编辑] 参数
timeout_duration | - | 最大阻塞持续时间 |
[编辑] 返回值
如果成功获取锁,则为 true,否则为 false。
[编辑] 异常
在执行过程中,时钟 (clock)、时间点 (time_point) 或持续时间 (duration) 抛出的任何异常(标准库提供的时钟、时间点和持续时间永远不会抛出异常)。
[编辑] 示例
本节不完整 原因:无示例 |
[编辑] 参阅
尝试以共享所有权锁定互斥体,如果互斥体不可用则返回 (public member function) | |
尝试以共享所有权锁定互斥锁,如果互斥锁在指定超时时间内不可用,则返回 在指定时间点之前不可用 (public member function) | |
尝试锁定互斥锁,如果互斥锁在指定超时时间内不可用,则返回 指定超时持续时间不可用 (public member function) |