std::shared_timed_mutex

来自cppreference.com
< cpp‎ | thread
 
 
并发支持库
线程
(C++11)
(C++20)
(C++20)
this_thread 命名空间
(C++11)
(C++11)
(C++11)
原子类型
(C++11)
(C++20)
原子类型的初始化
(C++11)(C++20 中弃用)
(C++11)(C++20 中弃用)
原子操作的自由函数
原子标志的自由函数
内存序
互斥
(C++11)
shared_timed_mutex
(C++14)
通用锁管理
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
条件变量
(C++11)
信号量
闩与屏障
(C++20)
(C++20)
future
(C++11)
(C++11)
(C++11)
(C++11)
 
 
在标头 <shared_mutex> 定义
class shared_timed_mutex;
(C++14 起)

shared_timed_mutex 类是能用于保护数据免受多个线程同时访问的同步原语。与其他促进排他性访问的互斥类型相反,拥有二个层次的访问:

  • 共享 - 多个线程能共享同一互斥的所有权。
  • 排他性 - 仅一个线程能占有互斥。

共享互斥通常用于多个读线程能同时访问同一资源而不导致数据竞争,但只有一个写线程能访问的情形。

以类似 timed_mutex 的行为, shared_timed_mutex 提供通过 try_lock_for()try_lock_until()try_lock_shared_for()try_lock_shared_until() 方法,试图带时限地要求 shared_timed_mutex 所有权的能力。

shared_timed_mutex 类满足共享定时互斥体 (SharedTimedMutex) 标准布局类型 (StandardLayoutType) 的所有要求。

成员函数

构造互斥
(公开成员函数)
销毁互斥
(公开成员函数)
operator=
[被删除]
不可复制赋值
(公开成员函数)
排他性锁定
锁定互斥,若互斥不可用则阻塞
(公开成员函数)
尝试锁定互斥,若互斥不可用则返回
(公开成员函数)
尝试锁定互斥,若互斥在指定的时限时期中不可用则返回
(公开成员函数)
尝试锁定互斥,若直至抵达指定时间点互斥不可用则返回
(公开成员函数)
解锁互斥
(公开成员函数)
共享锁定
为共享所有权锁定互斥,若互斥不可用则阻塞
(公开成员函数)
尝试为共享所有权锁定互斥,若互斥不可用则返回
(公开成员函数)
尝试为共享所有权锁定互斥,若互斥在指定的时限时期中不可用则返回
(公开成员函数)
尝试为共享所有权锁定互斥,若直至抵达指定时间点互斥不可用则返回
(公开成员函数)
解锁互斥(共享所有权)
(公开成员函数)

示例

复制赋值运算符,属于保有能处置多个读者,但只有一个写者的资源

#include <mutex>
#include <shared_mutex>
 
class R
{
    mutable std::shared_timed_mutex mut;
    /* 数据 */
public:
    R& operator=(const R& other)
    {
        // 要求排他性所有权以写入 *this
        std::unique_lock<std::shared_timed_mutex> lhs(mut, std::defer_lock);
        // 要求共享所有权以读取 other
        std::shared_lock<std::shared_timed_mutex> rhs(other.mut, std::defer_lock);
        std::lock(lhs, rhs);
        /* 赋值数据 */
        return *this;
    }
};
 
int main() {
    R r;
}