std::mutex::lock

void lock();		(C++11 起)

锁定互斥体。若另一线程已锁定此互斥体，则对 lock 的调用将阻塞执行，直至获得锁。

若为已占有此 mutex 的线程调用 lock，则行为未定义：例如，程序可能死锁。鼓励能检测非法使用的实现抛出以 resource_deadlock_would_occur 为错误条件的 std::system_error，而不是死锁。

同一互斥体上先前的 unlock() 操作同步于（定义于 std::memory_order）此操作。

参数

（无）

返回值

（无）

异常

错误发生时抛出 std::system_error，包括妨碍 lock 满足其规定的源自底层操作系统的错误。在抛出任何异常的情况下，不锁定互斥体。

注解

通常不直接调用 lock()：用 std::unique_lock 与 std::lock_guard 管理排他性锁定。

示例

此示例演示 lock 与 unlock 能如何用于保护共享数据。

运行此代码

#include <chrono>
#include <iostream>
#include <mutex>
#include <thread>
 
int g_num = 0;  // 为 g_num_mutex 所保护
std::mutex g_num_mutex;
 
void slow_increment(int id) 
{
    for (int i = 0; i < 3; ++i)
    {
        g_num_mutex.lock(); 
        ++g_num;
        // 注意，此互斥体也同步输出
        std::cout << "id: " << id << ", g_num: " << g_num << '\n';
        g_num_mutex.unlock();
 
        std::this_thread::sleep_for(std::chrono::milliseconds(234));
    }
}
 
int main()
{
    std::thread t1(slow_increment, 0);
    std::thread t2(slow_increment, 1);
    t1.join();
    t2.join();
}

可能的输出：

id: 0, g_num: 1
id: 1, g_num: 2
id: 1, g_num: 3
id: 0, g_num: 4
id: 0, g_num: 5
id: 1, g_num: 6

参阅

try_lock	尝试锁定互斥体，若互斥体不可用则返回 (公开成员函数)
unlock	解锁互斥体 (公开成员函数)

编译器支持
自立实现与有宿主实现
语言
标准库
标准库标头
具名要求
功能特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
技术规范
符号索引
外部库

成员函数
mutex::mutex
mutex::~mutex
锁定
mutex::lock
mutex::try_lock
mutex::unlock
本机句柄
mutex::native_handle

std::mutex::lock

参数

返回值

异常

注解

示例

参阅

导航