std::shared_lock<Mutex>::try_lock_for
< cpp | thread | shared lock
template< class Rep, class Period > bool try_lock_for( const std::chrono::duration<Rep,Period>& timeout_duration ); |
(C++14 起) | |
尝试以共享模式锁定关联互斥。阻塞直至经过 timeout_duration
或得到锁,之先来到者。成功获得锁时返回 true ,否则返回 false 。等效于调用 mutex()->try_lock_shared_for(timeout_duration) 。
由于调度或资源争夺延迟,此函数可能阻塞长于 timeout_duration
。
标准建议使用稳定时钟。若实现用系统时钟代替,则等待时间亦可能对时钟调节敏感。
若无关联互斥或互斥已被锁则抛出 std::system_error 。
参数
timeout_duration | - | 要阻塞的最大时长 |
返回值
若已成功获得互斥的所有权则为 true ,否则为 false 。
异常
- 任何 mutex()->try_lock_shared_for(timeout_duration) 所抛的异常
- 若无关联互斥,则抛出以 std::errc::operation_not_permitted 为错误码的 std::system_error
- 若互斥已被锁,则抛出以 std::errc::resource_deadlock_would_occur 为错误码的 std::system_error
示例
本节未完成 原因:暂无示例 |
参阅
试图锁定关联的可定时锁定 (TimedLockable) 互斥,若互斥在给定时长中不可用则返回 ( std::unique_lock<Mutex> 的公开成员函数) | |
锁定关联的互斥 (公开成员函数) | |
尝试锁定关联的互斥 (公开成员函数) | |
尝试锁定关联的互斥,直至指定的时间点 (公开成员函数) | |
解锁关联的互斥 (公开成员函数) |