命名空间
变体
操作

std::shared_timed_mutex::try_lock_shared_until

来自 cppreference.com
 
 
并发支持库
线程
(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_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() 一样,即使在 timeout_time 之前某个时间点,互斥体没有被任何其他线程锁定,此函数也可能虚假地失败并返回 false

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

如果 try_lock_shared_until 被一个已经以任何模式(共享或独占)拥有 mutex 的线程调用,则行为未定义。

内容

[编辑] 参数

timeout_time - 阻塞的最大时间点

[编辑] 返回值

如果成功获取共享锁所有权,则返回 true,否则返回 false

[编辑] 异常

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

[编辑] 示例

[编辑] 另请参阅

尝试锁定互斥体,如果互斥体在指定时间点之前一直不可用,则返回
unavailable until specified time point has been reached
(公共成员函数) [编辑]
尝试锁定互斥体以进行共享所有权,如果互斥体不可用,则返回
(公共成员函数) [编辑]
尝试以共享方式锁定互斥量,如果互斥量在指定的超时时间内不可用,则返回。

(公共成员函数) [编辑]