std::unique_lock<Mutex>::try_lock_for
来自cppreference.com
< 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。
示例
本节未完成 原因:暂无示例 |
参阅
锁定(即获取其所有权)关联互斥体 (公开成员函数) | |
尝试锁定(即获得其所有权)关联互斥体而不阻塞 (公开成员函数) | |
尝试锁定关联的互斥体,以指定时长 ( std::shared_lock<Mutex> 的公开成员函数) | |
尝试锁定(即获得其所有权)关联可定时锁定 (TimedLockable) 互斥体,若抵达指定时间点互斥体仍不可用则返回 (公开成员函数) | |
解锁(即释放其所有权)关联互斥体 (公开成员函数) |