std::recursive_mutex:: try_lock

ミューテックスのロックを試みます。即座に返ります。ロックの取得に成功した場合は true を返し、それ以外の場合は false を返します。

この関数は偽の失敗を起こす可能性があり、他のスレッドによってミューテックスが現在ロックされていない場合でも false を返すことがあります。

スレッドは再帰ミューテックスに対して try_lock を繰り返し呼び出すことができます。 try_lock の呼び出しが成功するたびに所有権カウントが増加します：ミューテックスは、スレッドが対応する回数だけ unlock を呼び出した後にのみ解放されます。

所有権の最大レベル数は未規定です。この数を超えた場合、 try_lock の呼び出しは false を返します。

同じミューテックスに対する前回の unlock() 操作は、この操作が true を返す場合、 synchronizes-with （ std::memory_order で定義される）関係を形成します。なお、この操作が false を返す場合、前回の lock() 操作はこの操作とsynchronizes-with関係を形成しないことに注意してください。

パラメータ

(なし)

戻り値

true ロックの取得が成功した場合、それ以外の場合は false 。

例外

例外を送出しません。

例

#include <iostream>
#include <mutex>
int main()
{
    std::recursive_mutex test;
    if (test.try_lock())
    {
        std::cout << "lock acquired\n";
        test.unlock();
    }
    else
        std::cout << "lock not acquired\n";
    test.lock();
    // non-recursive mutex would return false from try_lock now
    if (test.try_lock())
    {
        std::cout << "lock acquired\n";
        test.unlock(); 
    }
    else
        std::cout << "lock not acquired\n";
    test.unlock();
}

lock acquired
lock acquired

関連項目