C++ 参考手册

位置：首页 > C++ 参考手册 >线程支持库 >std::shared_timed_mutex > std::shared_timed_mutex::lock

std::shared_timed_mutex::lock

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

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

若已以任何模式（共享或排他性）占有 mutex 的线程调用 lock ，则行为未定义。

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

参数

（无）

返回值

（无）

异常

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

注意

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

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

示例

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

运行此代码
#include <iostream>
#include <chrono>
#include <thread>
#include <mutex>
 
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 << " => " << g_num << '\n';
        g_num_mutex.unlock();
 
        std::this_thread::sleep_for(std::chrono::seconds(1));
    }
}
 
int main()
{
    std::thread t1(slow_increment, 0);
    std::thread t2(slow_increment, 1);
    t1.join();
    t2.join();
}

可能的输出： 

0 => 1
1 => 2
0 => 3
1 => 4
0 => 5
1 => 6

参阅

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