std::shared_timed_mutex:: lock

ミューテックスをロックします。他のスレッドが既にミューテックスをロックしている場合、 lock の呼び出しはロックが取得されるまで実行をブロックします。

もし lock が、あらかじめ何らかのモード（共有または排他）で mutex を所有しているスレッドによって呼び出された場合、動作は未定義です。

同じミューテックスに対する以前の unlock() 操作は、この操作と synchronize-with （ std::memory_order で定義される通り）関係を持ちます。

例外

エラーが発生した場合、 std::system_error をスローします。これには、 lock がその仕様を満たすのを妨げる基盤オペレーティングシステムからのエラーも含まれます。例外がスローされた場合、ミューテックスはロックされません。

注記

lock() は通常直接呼び出されません： std::unique_lock 、 std::scoped_lock 、および std::lock_guard が排他ロックの管理に使用されます。

共有ミューテックスは共有所有モードから排他所有モードへの直接移行をサポートしません：排他所有を lock() で取得する前に、 unlock_shared() で共有ロックを解放する必要があります。 boost::upgrade_mutex がこの目的で使用できます。

例

#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

関連項目