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