命名空间
变体
操作

std::shared_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++20)
(C++20)
期物
(C++11)
(C++11)
(C++11)
(C++11)
安全回收
(C++26)
Hazard 指针
原子类型
(C++11)
(C++20)
原子类型的初始化
(C++11)(在 C++20 中弃用)
(C++11)(在 C++20 中弃用)
内存顺序
(C++11)(在 C++26 中弃用)
原子操作的自由函数
原子标志的自由函数
 
 
template< class Clock, class Duration >
bool try_lock_until( const std::chrono::time_point<Clock, Duration>& timeout_time );
(since C++14)

尝试锁定互斥锁。阻塞直到到达指定的 timeout_time (超时) 或获取锁 (拥有互斥锁),以先到者为准。成功获取锁时返回 true,否则返回 false

如果 timeout_time 已经过去,则此函数的行为类似于 try_lock()

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 由已在任何模式(共享或独占)下拥有互斥锁的线程调用,则行为未定义。

内容

[编辑] 参数

timeout_time - 阻塞到此最晚时间点

[编辑] 返回值

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

[编辑] 异常

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

[编辑] 示例

[编辑] 参见

锁定互斥锁,如果互斥锁不可用则阻塞
(公共成员函数) [编辑]
尝试锁定互斥锁,如果互斥锁不可用则返回
(公共成员函数) [编辑]
尝试锁定互斥锁,如果互斥锁已
在指定的超时持续时间内不可用则返回
(公共成员函数) [编辑]
解锁互斥锁
(公共成员函数) [编辑]
C 文档 关于 mtx_timedlock