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 default] 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()も参照してください 。