std::unique_lock<Mutex>::try_lock_until
来自cppreference.com
< cpp | thread | unique lock
template< class Clock, class Duration > bool try_lock_until( const std::chrono::time_point<Clock, Duration>& timeout_time ); |
(C++11 起) | |
尝试锁定关联互斥体(即接收其所有权)。阻塞到抵达指定的 timeout_time 或获得锁这两个事件的先达成者为止。成功获得锁时返回 true,否则返回 false。可能阻塞长于抵达 timeout_time
。
相当于调用 mutex()->try_lock_until(timeout_time)。
若无关联互斥体或同一线程已锁定互斥体则抛出 std::system_error。
Clock
必须符合时钟 (Clock) 的要求。若 std::chrono::is_clock_v<Clock> 为 false 则程序非良构。 (C++20 起)
参数
timeout_time | - | 要阻塞到的最大时间点 |
返回值
若成功获得得到互斥体锁有权则为 true,否则为 false。
异常
- mutex()->try_lock_until(timeout_time) 所抛出的任何异常。
- 若无关联互斥体,则为以 std::errc::operation_not_permitted 为错误码的 std::system_error。
- 若已锁定互斥体,则为以 std::errc::resource_deadlock_would_occur 为错误码的 std::system_error。
示例
本节未完成 原因:暂无示例 |
参阅
锁定(即获取其所有权)关联互斥体 (公开成员函数) | |
尝试锁定(即获得其所有权)关联互斥体而不阻塞 (公开成员函数) | |
尝试锁定(即获得其所有权)关联的可定时锁定 (TimedLockable) 互斥体,若互斥体在给定时长中不可用则返回 (公开成员函数) | |
解锁(即释放其所有权)关联互斥体 (公开成员函数) |