Namespaces
Variants

std::shared_timed_mutex:: lock

From cppreference.net

Concurrency support library
Threads
(C++11)
(C++20)
this_thread namespace
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
Generic lock management
Condition variables
(C++11)
Semaphores
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
Safe reclamation
Hazard pointers
Atomic types
(C++11)
(C++20)
Initialization of atomic types
(C++11) (deprecated in C++20)
(C++11) (deprecated in C++20)
Memory ordering
(C++11) (deprecated in C++26)
Free functions for atomic operations
Free functions for atomic flags
void lock ( ) ;
(C++14 起)

锁定互斥锁。若其他线程已锁定该互斥锁,调用 lock 将阻塞执行直至获得锁。

如果已以任何模式(共享或独占)拥有 mutex 的线程调用 lock ,则行为未定义。

同一互斥量上的先前 unlock() 操作与此操作形成 同步关系 (定义参见 std::memory_order )。

目录

异常

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

注释

lock() 通常不直接调用:使用 std::unique_lock std::scoped_lock std::lock_guard 来管理独占锁定。

共享互斥锁不支持从共享所有权模式直接转换为独占所有权模式:必须先通过 unlock_shared() 释放共享锁,才能通过 lock() 获得独占所有权。为此可使用 boost::upgrade_mutex 实现该功能。

示例

此示例展示了如何使用 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

参见

尝试锁定互斥锁,若互斥锁不可用则立即返回
(公开成员函数)
解锁互斥锁
(公开成员函数)
C 文档 关于 mtx_lock