std::shared_timed_mutex::try_lock_shared_until
来自 cppreference.cn
< cpp | thread | shared timed mutex
template< class Clock, class Duration > bool try_lock_shared_until( const std::chrono::time_point<Clock,Duration>& timeout_time ); |
(C++14 起) | |
尝试以共享模式锁定互斥量。阻塞直到达到指定的 timeout_time 或获得锁,以先发生者为准。成功获得锁时返回 true,否则返回 false。
如果 timeout_time 已经过去,此函数的行为类似于 try_lock_shared()。
Clock
必须满足 Clock 要求。 如果 std::chrono::is_clock_v<Clock> 为 false,则程序格式错误。(自 C++20 起)
标准建议使用与 timeout_time 绑定的时钟,在这种情况下可以考虑时钟的调整。因此,阻塞的持续时间可能会比调用时 timeout_time - Clock::now() 更长或更短,具体取决于调整方向以及实现是否遵循该调整。该函数还可能由于进程调度或资源争用延迟而阻塞到 timeout_time 之后。
与 try_lock_shared() 一样,此函数允许虚假失败并返回 false,即使在 timeout_time 之前某个时刻互斥量没有被任何其他线程锁定。
如果同一互斥量上的先前 unlock() 操作返回 true,则它与此操作“同步”(如 std::memory_order 中所定义)。
如果 `try_lock_shared_until` 被一个已经以任何模式(共享或独占)拥有 `mutex` 的线程调用,则行为未定义。
目录 |
[编辑] 参数
timeout_time | - | 最大阻塞时间点 |
[编辑] 返回值
如果成功获取共享锁所有权,则为 true,否则为 false。
[编辑] 异常
在执行过程中,时钟 (clock)、时间点 (time_point) 或持续时间 (duration) 抛出的任何异常(标准库提供的时钟、时间点和持续时间永远不会抛出异常)。
[编辑] 示例
本节不完整 原因:无示例 |
[编辑] 参阅
尝试锁定互斥锁,如果互斥锁在指定超时时间内不可用,则返回 在指定时间点之前不可用 (公共成员函数) | |
尝试以共享所有权锁定互斥体,如果互斥体不可用则返回 (公共成员函数) | |
尝试以共享所有权锁定互斥锁,如果互斥锁在指定超时时间内不可用,则返回 指定超时持续时间不可用 (公共成员函数) |