QRecursiveMutex Class

メンバ関数ドキュメント

[constexpr noexcept] 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()も参照のこと 。