std::recursive_mutex
来自 cppreference.cn
| 定义于头文件 <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 (可选*) |
实现定义的 |
[编辑] 成员函数
| 构造互斥体 (public 成员函数) | |
| 销毁互斥体 (public 成员函数) | |
| operator= [已删除] |
不可复制赋值 (public 成员函数) |
加锁 | |
| 锁定互斥体，如果互斥体不可用则阻塞 (public 成员函数) | |
| 尝试锁定互斥体，如果互斥体不可用则返回 (public 成员函数) | |
| 解锁互斥体 (public 成员函数) | |
原生句柄 | |
| 返回底层实现定义的原生句柄对象 (public 成员函数) | |
[编辑] 示例
recursive_mutex 的一个用例是保护一个类的共享状态，该类的成员函数可能会相互调用。
运行此代码
#include <iostream> #include <mutex> #include <thread> 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(); // recursive lock becomes useful here 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
[编辑] 参阅
| (C++11) |
提供基本的互斥设施 (类) |
