std::shared_timed_mutex::try_lock_shared_until
来自cppreference.com
< 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
前某点互斥不为任何其他线程所锁定。
若此操作返回 true ,则同一互斥上先前的 unlock() 操作同步于(定义于 std::memory_order )它。
若已以任何模式(共享或排他性)占有 mutex
的线程调用 try_lock_shared_until
,则行为未定义。
参数
timeout_time | - | 要阻塞到的最大时间点 |
返回值
若成功获得锁则为 true ,否则为 false 。
异常
任何时钟、时间点或时长在执行中抛出的异常(标准库提供的时钟、时间点及时长决不抛出)
示例
本节未完成 原因:暂无示例 |
参阅
尝试锁定互斥,若直至抵达指定时间点互斥不可用则返回 (公开成员函数) | |
尝试为共享所有权锁定互斥,若互斥不可用则返回 (公开成员函数) | |
尝试为共享所有权锁定互斥,若互斥在指定的时限时期中不可用则返回 (公开成员函数) |