名稱空間
變體
操作

std::mutex::lock

來自 cppreference.com
< cpp‎ | thread‎ | 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 的呼叫將阻塞執行,直到獲取到鎖。

如果持有 mutex 的執行緒再次呼叫 lock,則行為未定義:例如,程式*可能*會死鎖。建議能夠檢測無效用法的實現丟擲帶有錯誤條件 resource_deadlock_would_occurstd::system_error,而不是死鎖。

此操作與同一互斥量上的先前 unlock() 操作*同步*(如 std::memory_order 中定義)。

目錄

[編輯] 引數

(無)

[編輯] 返回值

(無)

[編輯] 異常

發生錯誤時丟擲 std::system_error,包括底層作業系統中阻止 lock 滿足其規範的錯誤。在丟擲任何異常的情況下,互斥量未鎖定。

[編輯] 注意

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 documentation for mtx_lock