C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 类型支持（基本类型、RTTI、类型特性）
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- std::shared_timed_mutex
- std::shared_lock
- std::swap(std::shared_lock)
- std::shared_lock<Mutex>::release
- std::shared_lock<Mutex>::mutex
- std::shared_lock<Mutex>::owns_lock
- std::shared_lock<Mutex>::operator bool
- std::shared_lock<Mutex>::try_lock_for
- std::shared_lock<Mutex>::try_lock_until
- std::shared_lock<Mutex>::unlock
- std::shared_lock<Mutex>::swap
- std::shared_lock<Mutex>::shared_lock
- std::shared_lock<Mutex>::~shared_lock
- std::shared_lock<Mutex>::operator=
- std::shared_lock<Mutex>::lock
- std::shared_lock<Mutex>::try_lock
- std::thread
- std::stop_token
- std::stop_source
- std::stop_callback
- std::this_thread::get_id
- std::lock_guard
- std::hardware_destructive_interference_size, std::hardware_constructive_interference_size
- std::counting_semaphore, std::binary_semaphore
- std::jthread
- cpp/thread/barrier
- std::future
- std::this_thread::yield
- std::this_thread::sleep_for
- std::this_thread::sleep_until
- std::mutex
- std::recursive_mutex
- std::shared_mutex
- std::timed_mutex
- std::recursive_timed_mutex
- std::scoped_lock
- std::unique_lock
- std::defer_lock_t, std::try_to_lock_t, std::adopt_lock_t
- std::lock
- std::try_lock
- std::defer_lock, std::try_to_lock, std::adopt_lock
- std::once_flag
- std::call_once
- std::condition_variable
- std::condition_variable_any
- std::notify_all_at_thread_exit
- std::cv_status
- std::latch
- std::promise
- std::shared_future
- std::packaged_task
- std::async
- std::launch
- std::future_status
- std::future_error
- std::future_category
- std::future_errc
- 注释
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
位置：首页 > C++ 参考手册 >线程支持库 >std::shared_lock > std::shared_lock<Mutex>::try_lock_for
std::shared_lock<Mutex>::try_lock_for
| 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> 的公开成员函数) | |
| 锁定关联的互斥 (公开成员函数) | |
| 尝试锁定关联的互斥 (公开成员函数) | |
| 尝试锁定关联的互斥，直至指定的时间点 (公开成员函数) | |
| 解锁关联的互斥 (公开成员函数) |