QRecursiveMutex Class

メンバ関数のドキュメント

[constexpr noexcept default] QRecursiveMutex::QRecursiveMutex()

新しい再帰的ミューテックスを構築します。このミューテックスはロックされていない状態で作成されます。

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

[noexcept] QRecursiveMutex::~QRecursiveMutex()

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

[noexcept(...)] void QRecursiveMutex::lock()

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

同じスレッドから同じミューテックスに対してこの関数を複数回呼び出すことは許可されています。

unlock()も参照してください 。

[noexcept(...), since 6.6] bool QRecursiveMutex::tryLock(QDeadlineTimer timeout = {})

ミューテックスをロックしようと試みます。この関数は、ロックに成功した場合はtrue を返し、失敗した場合はfalse を返します。別のスレッドがミューテックスをロックしている場合、この関数はtimeout が期限切れになり、ミューテックスが利用可能になるまで待機します。

ロックが取得された場合、別のスレッドが正常にロックを行うには、unlock() を使用してミューテックスをアンロックする必要があります。

同じスレッドから同じミューテックスに対してこの関数を複数回呼び出すことは許可されています。

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

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

[noexcept(...)] bool QRecursiveMutex::tryLock(int timeout)

ミューテックスをロックしようと試みます。この関数は、ロックに成功した場合はtrue を返し、失敗した場合はfalse を返します。別のスレッドがミューテックスをロックしている場合、この関数はミューテックスが利用可能になるまで、最大timeout ミリ秒待機します。

注：timeout として負の数を渡すことは、lock() を呼び出すことと同じです。つまり、timeout が負の場合、この関数はミューテックスがロック可能になるまで無限に待機します。

ロックが取得された場合、別のスレッドが正常にロックを行うには、unlock() を使用してミューテックスをアンロックする必要があります。

同じスレッドから同じミューテックスに対してこの関数を複数回呼び出すことは許可されています。

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

[noexcept(...)] bool QRecursiveMutex::try_lock()

ミューテックスをロックしようと試みます。この関数は、ロックが取得できた場合は `true ` を返し、そうでない場合は `false` を返します。

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

template <typename Rep, typename Period> bool QRecursiveMutex::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 QRecursiveMutex::try_lock_until(std::chrono::time_point<Clock, Duration> timePoint)

ミューテックスをロックしようと試みます。この関数は、ロックに成功した場合はtrue を返し、失敗した場合はfalse を返します。別のスレッドがミューテックスをロックしている場合、この関数はtimePoint が解決されるまで、少なくともミューテックスが利用可能になるのを待ちます。

注：すでに期限が切れたtimePoint を渡すことは、try_lock()を呼び出すことと同じです。この動作はtryLock()とは異なります。

ロックが取得された場合、別のスレッドが正常にロックを行うには、unlock() を使用してミューテックスをアンロックする必要があります。

同じスレッドから同じミューテックスに対してこの関数を複数回呼び出すことは許可されています。

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

[noexcept] void QRecursiveMutex::unlock()

ミューテックスをアンロックします。ロックを行ったスレッドとは異なるスレッドでミューテックスのアンロックを試みると、エラーが発生します。ロックされていないミューテックスをアンロックすると、未定義の挙動となります。

lock()も参照してください 。