命名空间
变体
操作

std::recursive_timed_mutex::try_lock_until

来自 cppreference.cn
 
 
并发支持库
线程
(C++11)
(C++20)
this_thread 命名空间
(C++11)
(C++11)
(C++11)
协同取消
互斥
(C++11)
通用锁管理
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11 起)(C++11 起)(C++11 起)(C++11 起)(C++11 起)(C++11 起)
条件变量
(C++11)
信号量
门闩和屏障
(C++20)
(C++20)
期值
(C++11)
(C++11)
(C++11)
(C++11)
安全回收
(C++26)
危险指针
原子类型
(C++11)
(C++20)
原子类型的初始化
(C++11)(C++20 中已弃用)
(C++11)(C++20 中已弃用)
内存排序
(C++11)(C++26 中已弃用)
原子操作的自由函数
(C++11 起)(C++11 起)
(C++11 起)(C++11 起)
(C++20 起)(C++20 起)
原子标志的自由函数
 
 
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() 一样,此函数允许虚假失败并返回 false,即使在 timeout_time 之前某个时刻互斥体未被任何其他线程锁定。

如果返回 true,则同一互斥体上的先前的 unlock() 操作与此操作同步(如 std::memory_order 中所定义)。

线程可以在递归互斥体上重复调用 try_lock_until。成功的 try_lock_until 调用会增加所有权计数:互斥体只有在线程进行了匹配次数的 unlock 调用后才会被释放。

所有权的最大级别数未指定。如果超出此数字,则对 try_lock_until 的调用将返回 false

目录

[编辑] 参数

timeout_time - 最大阻塞时间点

[编辑] 返回值

如果成功获取锁,则为 true,否则为 false

[编辑] 异常

任何由 timeout_time 抛出的异常(标准库提供的时钟、时间点和持续时间从不抛出)。

[编辑] 示例

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告 应用于 发布时的行为 正确的行为
LWG 2093 C++11 try_lock_until 不抛出任何异常 抛出与超时相关的异常

[编辑] 参阅

锁定互斥体,如果互斥体不可用则阻塞
(public member function) [编辑]
尝试锁定互斥体,如果互斥体不可用则返回
(public member function) [编辑]
尝试锁定互斥锁,如果互斥锁在指定超时时间内不可用,则返回
指定超时持续时间不可用
(public member function) [编辑]
解锁互斥体
(public member function) [编辑]
C 文档,关于 mtx_timedlock