QMutex Class

int number = 6;

void method1()
{
    number *= 5;
    number /= 4;
}

void method2()
{
    number *= 3;
    number /= 2;
}

// method1()
number *= 5;        // number is now 30
number /= 4;        // number is now 7

// method2()
number *= 3;        // number is now 21
number /= 2;        // number is now 10

// Thread 1 calls method1()
number *= 5;        // number is now 30

// Thread 2 calls method2().
//
// Most likely Thread 1 has been put to sleep by the operating
// system to allow Thread 2 to run.
number *= 3;        // number is now 90
number /= 2;        // number is now 45

// Thread 1 finishes executing.
number /= 4;        // number is now 11, instead of 10

QMutex mutex;
int number = 6;

void method1()
{
    mutex.lock();
    number *= 5;
    number /= 4;
    mutex.unlock();
}

void method2()
{
    mutex.lock();
    number *= 3;
    number /= 2;
    mutex.unlock();
}

メンバ関数ドキュメント

[constexpr noexcept] QMutex::QMutex()

新しいミューテックスを構築する。ミューテックスはアンロック状態で作成される。

[noexcept] QMutex::~QMutex()

ミューテックスを破棄する。

[noexcept] void QMutex::lock()

ミューテックスをロックする。他のスレッドがミューテックスをロックしている場合、そのスレッドがロックを解除するまで、この呼び出しはブロックされる。

同じスレッドから同じミューテックスに対してこの関数を複数回呼び出すと、デッドロックが発生する。

unlock()も参照のこと 。

[noexcept, since 6.6] bool QMutex::tryLock(QDeadlineTimer timer)

ミューテックスのロックを試みる。この関数は、ロックが得られた場合はtrue を返し、そうでない場合はfalse を返す。他のスレッドがミューテックスをロックしている場合、この関数はtimer の期限が切れるまで、ミューテックスが使用可能になるまで待機する。

ロックが取得された場合、他のスレッドがミューテックスを正常にロックする前に、unlock() でロックを解除しなければならない。

同じスレッドから同じミューテックスに対してこの関数を複数回呼び出すと、デッドロックが発生します。

この関数は Qt 6.6 で導入されました。

lock() およびunlock()も参照してください 。

[noexcept] bool QMutex::tryLock(int timeout)

ミューテックスのロックを試みる。この関数は、ロックが得られた場合はtrue を返し、そうでない場合はfalse を返す。他のスレッドがミューテックスをロックしている場合、この関数は、ミューテックスが使用可能になるまで最大timeout ミリ秒待機する。

注意:timeout に負の数を渡すと、lock() を呼び出すのと同じことになる。つまり、timeout が負の場合、この関数はミューテックスがロックできるまで永遠に待つことになる。

ロックが取得された場合、他のスレッドが正常にロックできるようになる前に、unlock() でミューテックスをアンロックしなければならない。

同じスレッドから同じミューテックスに対してこの関数を複数回呼び出すと、デッドロックが発生する。

lock() およびunlock()も参照のこと 。

[noexcept] bool QMutex::tryLock()

これはオーバーロードされた関数である。

ミューテックスのロックを試みる。この関数は、ロックが得られた場合はtrue を返し、そうでない場合はfalse を返す。

ロックが取得された場合、他のスレッドがロックに成功する前に、unlock() でミューテックスをアンロックしなければならない。

同じスレッドから同じミューテックスに対してこの関数を複数回呼び出すと、デッドロックが 発生する。

lock() およびunlock()も参照のこと 。

[noexcept] bool QMutex::try_lock()

ミューテックスのロックを試みる。この関数は、ロックが得られた場合はtrue を返し、そうでない場合はfalse を返す。

この関数は、標準ライブラリの概念Lockable との互換性のために提供されている。tryLock() と等価である。

template <typename Rep, typename Period> bool QMutex::try_lock_for(std::chrono::duration<Rep, Period> duration)

ミューテックスのロックを試みる。この関数は、ロックが得られた場合はtrue を返し、そうでない場合はfalse を返す。他のスレッドがミューテックスをロックしている場合、この関数は、ミューテックスが使用可能になるまで少なくともduration 待つ。

注意:duration に負の継続時間を渡すことは、try_lock() を呼び出すことと等価である。この動作はtryLock() とは異なる。

ロックが取得された場合、他のスレッドがそのミューテックスを正常にロックする前に、unlock() でロックを解除しなければならない。

同じスレッドから同じミューテックスに対してこの関数を複数回呼び出すと、デッドロックが 発生する。

lock() およびunlock()も参照のこと 。

template <typename Clock, typename Duration> bool QMutex::try_lock_until(std::chrono::time_point<Clock, Duration> timePoint)

ミューテックスのロックを試みる。この関数は、ロックが得られた場合はtrue を返し、そうでない場合はfalse を返す。他のスレッドがミューテックスをロックしている場合、この関数は少なくともtimePoint が利用可能になるまで待つ。

注意：すでに渡されたtimePoint を渡すことは、try_lock （）を呼び出すことと同じである。この動作はtryLock() とは異なる。

ロックが取得された場合、他のスレッドが正常にロックする前に、unlock （）でミューテックスをアンロックしなければならない。

同じスレッドから同じミューテックスに対してこの関数を複数回呼び出すと、デッドロックが 発生する。

lock() およびunlock()も参照のこと 。

[noexcept] void QMutex::unlock()

ミューテックスのロックを解除する。ロックしたスレッドとは別のスレッドでミューテックスのロックを解除しようとすると、エラーになる。ロックされていないミューテックスのロックを解除すると、未定義の動作になる。

lock()も参照のこと 。