std::shared_timed_mutex::lock

来自cppreference.com

 
 
并发支持库
线程
(C++11)
(C++20)
(C++20)
this_thread 命名空间
(C++11)
(C++11)
(C++11)
互斥
(C++11)
(C++11)  
通用锁管理
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
条件变量
(C++11)
信号量
闩与屏障
(C++20)
(C++20)
未来体
(C++11)
(C++11)
(C++11)
(C++11)
安全回收
(C++26)
(C++26)
风险指针





原子类型
(C++11)
(C++20)
原子类型的初始化
(C++11)(C++20 中弃用)
(C++11)(C++20 中弃用)
内存定序
原子操作的自由函数
原子标志的自由函数
 
 
void lock();
(C++14 起)

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

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

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

参数

(无)

返回值

(无)

异常

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

注解

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

共享互斥体不支持直接从共享到独占所有权模式的迁移:必须在以 lock() 获得独占所有权之前用 unlock_shared() 交出共享锁。可为此目的使用 boost::upgrade_mutex

示例

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

#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

参阅

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