std::recursive_timed_mutex::try_lock_until
template< class Clock, class Duration > bool try_lock_until( const std::chrono::time_point<Clock, Duration>& timeout_time ); |
(自 C++11 起) | |
尝试锁定互斥量。阻塞直到到达指定的 timeout_time (超时) 或获取到锁 (拥有互斥量),以先发生者为准。成功获取锁时返回 true,否则返回 false。
如果 timeout_time 已经过去,则此函数的行为类似于 try_lock()。
Clock
必须满足 Clock 的要求。 如果 std::chrono::is_clock_v<Clock> 为 false,则程序是非良构的。(自 C++20 起)
标准建议使用与 timeout_time 关联的时钟,在这种情况下,可以考虑时钟的调整。因此,阻塞的持续时间可能多于或少于调用时的 timeout_time - Clock::now(),具体取决于调整的方向以及实现是否遵循该调整。由于进程调度或资源争用延迟,该函数也可能阻塞到 timeout_time 之后才返回。
与 try_lock() 一样,即使在 timeout_time 之前的某个时刻,互斥量未被任何其他线程锁定,此函数也可能出现伪失败并返回 false。
先前的在同一互斥量上的 unlock() 操作同步于 (如 std::memory_order 中定义) 此操作,如果它返回 true。
线程可以重复调用递归互斥量上的 try_lock_until
。成功调用 try_lock_until
会增加所有权计数:只有在线程对 unlock 进行匹配次数的调用后,互斥量才会被释放。
所有权级别的最大数量是未指定的。如果超过此数量,则对 try_lock_until
的调用将返回 false。
内容 |
[编辑] 参数
timeout_time | - | 阻塞到此时间点之前的最大时间 |
[编辑] 返回值
如果成功获取锁,则为 true,否则为 false。
[编辑] 异常
由 timeout_time 抛出的任何异常 (标准库提供的时钟、时间点和持续时间永远不会抛出异常)。
[编辑] 示例
本节尚不完整 原因:没有示例 |
缺陷报告
以下行为变更缺陷报告被追溯应用于先前发布的 C++ 标准。
DR | 应用于 | 已发布行为 | 正确行为 |
---|---|---|---|
LWG 2093 | C++11 | try_lock_until 不抛出任何异常 |
抛出与超时相关的异常 |
[编辑] 参见
锁定互斥量,如果互斥量不可用则阻塞 (公共成员函数) | |
尝试锁定互斥量,如果互斥量不可用则返回 (公共成员函数) | |
尝试锁定互斥量,如果互斥量已 在指定的超时持续时间内不可用则返回 (公共成员函数) | |
解锁互斥量 (公共成员函数) | |
C 文档 对于 mtx_timedlock
|