std::unique_lock<Mutex>::try_lock_for
来自 cppreference.cn
< 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 互斥体,如果互斥体在指定时间点之前都不可用,则返回 (公有成员函数) | |
解锁(即释放)关联的互斥量 (公有成员函数) |