Namespaces
Variants

std::shared_timed_mutex:: try_lock_shared_for

From cppreference.net
Concurrency support library
Threads
(C++11)
(C++20)
this_thread namespace
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
Generic lock management
Condition variables
(C++11)
Semaphores
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
Safe reclamation
Hazard pointers
Atomic types
(C++11)
(C++20)
Initialization of atomic types
(C++11) (deprecated in C++20)
(C++11) (deprecated in C++20)
Memory ordering
(C++11) (deprecated in C++26)
Free functions for atomic operations
Free functions for atomic flags
template < class Rep, class Period >
bool try_lock_shared_for ( const std:: chrono :: duration < Rep,Period > & timeout_duration ) ;
(C++14 起)

尝试以共享模式锁定互斥锁。阻塞直到指定的 timeout_duration 时间耗尽或成功获取共享锁(以先发生者为准)。成功获取锁时返回 true ,否则返回 false

如果 timeout_duration 小于或等于 timeout_duration. zero ( ) ,该函数的行为类似于 try_lock_shared()

该函数可能因调度或资源竞争延迟而阻塞超过 timeout_duration 时长。

标准建议使用稳定时钟来测量持续时间。如果实现使用系统时钟替代,等待时间也可能对时钟调整敏感。

try_lock_shared() 类似,此函数允许虚假失败,即使在 timeout_duration 期间的某个时间点互斥锁未被任何其他线程锁定,也可能返回 false

同一互斥量上的先前 unlock() 操作与此操作形成 同步关系 (定义参见 std::memory_order ),若本操作返回 true

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

目录

参数

timeout_duration - 阻塞等待的最长持续时间

返回值

true 表示锁获取成功,否则为 false

异常

任何在运行过程中由 clock、time_point 或 duration 抛出的异常(标准库提供的时钟、时间点和持续时间从不抛出异常)。

示例

参见

尝试以共享模式锁定互斥量,若互斥量不可用则立即返回
(公开成员函数)
尝试以共享模式锁定互斥量,若在到达指定时间点前
互斥量始终不可用则返回
(公开成员函数)
尝试锁定互斥量,若互斥量在指定的超时时间内
持续不可用则返回
(公开成员函数)