std::mutex::lock

[编辑模板]

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

锁定互斥锁。如果另一个线程已经锁定了互斥锁，则调用 lock 将阻塞执行，直到获取到锁。

如果 lock 被已经拥有 mutex 的线程调用，则行为是未定义的：例如，程序可能会死锁。鼓励能够检测到无效使用的实现抛出 std::system_error，错误条件为 resource_deadlock_would_occur，而不是死锁。

对同一互斥锁的先前 unlock() 操作与 (如 std::memory_order 中定义) 此操作同步。

内容

1 参数
2 返回值
3 异常
4 备注
5 示例
6 另请参见

[编辑] 参数

(无)

[编辑] 返回值

(无)

[编辑] 异常

当发生错误时抛出 std::system_error，包括来自底层操作系统的错误，这些错误将阻止 lock 满足其规范。在抛出任何异常的情况下，互斥锁不会被锁定。

[编辑] 备注

lock() 通常不会直接调用：std::unique_lock、std::scoped_lock 和 std::lock_guard 用于管理独占锁定。

[编辑] 示例

此示例展示了如何使用 lock 和 unlock 来保护共享数据。

运行此代码

#include <chrono>
#include <iostream>
#include <mutex>
#include <thread>
 
int g_num = 0; // protected by 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;
        // note, that the mutex also syncronizes the output
        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 文档 for mtx_lock

编译器支持
独立和托管
语言
标准库
标准库头文件
命名需求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用实用程序库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

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

cppreference.com

命名空间

变体

视图

操作