std::recursive_mutex
来自cppreference.com
定义于头文件 <mutex>
|
||
class recursive_mutex; |
(C++11 起) | |
recursive_mutex
类是同步原语,能用于保护共享数据免受从个多线程同时访问。
recursive_mutex
提供排他性递归所有权语义:
- 调用方线程在从它成功调用
lock
或try_lock
开始的时期里占有recursive_mutex
。此时期间,线程可以进行对lock
或try_lock
的附加调用。所有权的时期在线程调用unlock
匹配次数时结束。 - 线程占有
recursive_mutex
时,若其他所有线程试图要求recursive_mutex
的所有权,则它们将阻塞(对于调用lock
)或收到 false 返回值(对于调用try_lock
)。 - 可锁定
recursive_mutex
次数的最大值是未指定的,但抵达该数后,对lock
的调用将抛出 std::system_error 而对try_lock
的调用将返回 false 。
若 recursive_mutex
在仍为某线程占有时被销毁,则程序行为未定义。 recursive_mutex
类满足互斥体 (Mutex) 和标准布局类型 (StandardLayoutType) 的所有要求。
成员类型
成员类型 | 定义 |
native_handle_type (可选)
|
实现定义 |
成员函数
构造互斥 (公开成员函数) | |
销毁互斥 (公开成员函数) | |
operator= [被删除] |
不可复制赋值 (公开成员函数) |
锁定 | |
锁定互斥,若互斥不可用则阻塞 (公开成员函数) | |
尝试锁定互斥,若互斥不可用则返回 (公开成员函数) | |
解锁互斥 (公开成员函数) | |
原生句柄 | |
返回底层实现定义的原生句柄 (公开成员函数) |
示例
recursive_mutex
的使用场景之一是保护类中的共享状态,而类的成员函数可能相互调用
运行此代码
#include <iostream> #include <thread> #include <mutex> class X { std::recursive_mutex m; std::string shared; public: void fun1() { std::lock_guard<std::recursive_mutex> lk(m); shared = "fun1"; std::cout << "in fun1, shared variable is now " << shared << '\n'; } void fun2() { std::lock_guard<std::recursive_mutex> lk(m); shared = "fun2"; std::cout << "in fun2, shared variable is now " << shared << '\n'; fun1(); // 递归锁在此处变得有用 std::cout << "back in fun2, shared variable is " << shared << '\n'; }; }; int main() { X x; std::thread t1(&X::fun1, &x); std::thread t2(&X::fun2, &x); t1.join(); t2.join(); }
可能的输出:
in fun1, shared variable is now fun1 in fun2, shared variable is now fun2 in fun1, shared variable is now fun1 back in fun2, shared variable is fun1