命名空间
变体
操作

std::timed_mutex::lock

来自 cppreference.cn
< cpp‎ | thread‎ | timed mutex
 
 
并发支持库
线程
(C++11)
(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++20)
(C++20)
期值
(C++11)
(C++11)
(C++11)
(C++11)
安全回收
(C++26)
危险指针
原子类型
(C++11)
(C++20)
原子类型的初始化
(C++11)(C++20 中已弃用)
(C++11)(C++20 中已弃用)
内存排序
(C++11)(C++26 中已弃用)
原子操作的自由函数
原子标志的自由函数
 
 
void lock();
(C++11 起)

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

如果一个线程已经拥有了互斥锁,而该线程又调用了 lock,则行为是未定义的:例如,程序*可能*会死锁。如果实现可以检测到这种无效使用,则鼓励其抛出 std::system_error,并附带错误条件 resource_deadlock_would_occur,而不是死锁。

在此操作之前对同一互斥锁进行的 unlock() 操作会与此操作*同步*(如 std::memory_order 中所定义)。

目录

[编辑] 参数

(无)

[编辑] 返回值

(无)

[编辑] 异常

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

[编辑] 注意

通常不直接调用 lock()std::unique_lockstd::scoped_lockstd::lock_guard 用于管理独占锁定。


[编辑] 示例

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

#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