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++ 关键词
std::shared_lock
| 定义于头文件 <shared_mutex>
|
||
| template< class Mutex > class shared_lock; |
(C++14 起) | |
类 shared_lock 是通用共享互斥所有权包装器，允许延迟锁定、定时锁定和锁所有权的转移。锁定 shared_lock ，会以共享模式锁定关联的共享互斥（ std::unique_lock 可用于以排他性模式锁定）。
shared_lock 类可移动，但不可复制——它满足可移动构造 (MoveConstructible) 与可移动赋值 (MoveAssignable) 的要求，但不满足可复制构造 (CopyConstructible) 或可复制赋值 (CopyAssignable) 。
为以共享所有权模式等待于共享互斥，可使用 std::condition_variable_any （ std::condition_variable 要求 std::unique_lock 故而只能以唯一所有权模式等待）。
模板形参
| Mutex | - | 要锁定的共享互斥类型。类型必须满足共享互斥体 (SharedMutex) 要求。 |
成员类型
| 类型 | 定义 |
mutex_type
|
Mutex |
成员函数
构造 shared_lock ，可选地锁定提供的互斥 (公开成员函数) | |
| 解锁关联的互斥 (公开成员函数) | |
| 若占有则解锁互斥，然后获得对方的所有权 (公开成员函数) | |
共享锁定 | |
| 锁定关联的互斥 (公开成员函数) | |
| 尝试锁定关联的互斥 (公开成员函数) | |
| 尝试锁定关联的互斥，以指定时长 (公开成员函数) | |
| 尝试锁定关联的互斥，直至指定的时间点 (公开成员函数) | |
| 解锁关联的互斥 (公开成员函数) | |
修改器 | |
| 与另一 shared_lock 交换数据成员 (公开成员函数) | |
| 解除关联 mutex 而不解锁 (公开成员函数) | |
观察器 | |
| 返回指向关联的互斥的指针 (公开成员函数) | |
| 测试锁是否占有其关联的互斥 (公开成员函数) | |
| 测试锁是否占有其关联的互斥 (公开成员函数) | |
非成员函数
std::swap 对 shared_lock 的特化 (函数模板) |
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
| DR | 应用于 | 出版时的行为 | 正确行为 |
|---|---|---|---|
| LWG 2981 | C++17 | 曾提供来自 shared_lock<Mutex> 的冗余推导指引
|
已移除 |