命名空间
变体
操作

std::timed_mutex::try_lock_until

来自 cppreference.com
< cpp‎ | thread‎ | timed mutex
 
 
并发支持库
线程
(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++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 中已弃用)
内存排序
用于原子操作的自由函数
用于原子标志的自由函数
 
 
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 为止。

如果对同一个互斥锁调用了先前的 unlock() 操作,则如果它返回 true,该操作将与(按照 std::memory_order 的定义)此操作同步。

如果由已经拥有互斥锁的线程调用 try_lock_until,则行为未定义。

内容

[编辑] 参数

timeout_time - 最大阻塞时间点

[编辑] 返回值

如果成功获取锁,则返回 true,否则返回 false.

[编辑] 异常

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

[编辑] 示例

缺陷报告

以下行为更改缺陷报告已追溯应用于先前发布的 C++ 标准。

DR 应用于 已发布的行为 正确行为
LWG 2093 C++11 try_lock_until 没有抛出任何异常 抛出与超时相关的异常

[编辑] 另请参阅

锁定互斥锁,如果互斥锁不可用则阻塞
(公共成员函数) [编辑]
尝试锁定互斥锁,如果互斥锁不可用则返回
(公共成员函数) [编辑]
尝试锁定互斥锁,如果互斥锁在指定的超时时间内一直不可用,则返回

(公共成员函数) [编辑]
解锁互斥锁
(公共成员函数) [编辑]
C 文档 for mtx_timedlock