QWaitCondition Class

forever {
    mutex.lock();
    keyPressed.wait(&mutex);
    do_something();
    mutex.unlock();
}

forever {
    getchar();
    keyPressed.wakeAll();
}

forever {
    mutex.lock();
    keyPressed.wait(&mutex);
    ++count;
    mutex.unlock();

    do_something();

    mutex.lock();
    --count;
    mutex.unlock();
}

forever {
    getchar();

    mutex.lock();
    // Sleep until there are no busy worker threads
    while (count > 0) {
        mutex.unlock();
        sleep(1);
        mutex.lock();
    }
    keyPressed.wakeAll();
    mutex.unlock();
}

メンバ関数ドキュメント

QWaitCondition::QWaitCondition()

新しい待機条件オブジェクトを構築する。

[noexcept] QWaitCondition::~QWaitCondition()

待機状態オブジェクトを破棄する。

void QWaitCondition::notify_all()

この関数は STL との互換性のために提供されている。wakeAll() と同等です。

void QWaitCondition::notify_one()

この関数は STL との互換性のために提供されている。wakeOne() と同等です。

bool QWaitCondition::wait(QMutex *lockedMutex, QDeadlineTimer deadline = QDeadlineTimer(QDeadlineTimer::Forever))

lockedMutex を解放し、待機条件で待つ。lockedMutex は、呼び出し元のスレッドによって最初にロックされていなければならない。lockedMutex がロック状態でない場合、動作は未定義である。lockedMutex が再帰的ミューテックスの場合、この関数は即座に戻る。lockedMutex はロック解除され、呼び出し元のスレッドは、これらの条件のいずれかが満たされるまでブロックされる：

• 別のスレッドがwakeOne() またはwakeAll() を使用してシグナルを送る。この場合、この関数はtrueを返す。
• deadline で指定された期限に達した。deadline がQDeadlineTimer::Forever (デフォルト)である場合、wait はタイムアウトしません (イベントはシグナルされなければなりません)。待ち時間がタイムアウトした場合、この関数は偽を返します。

lockedMutex は同じロック状態に戻される。この関数は、ロック状態から待機状態へのアトミックな遷移を可能にするために用意されている。

wakeOne() およびwakeAll()も参照のこと 。

bool QWaitCondition::wait(QReadWriteLock *lockedReadWriteLock, QDeadlineTimer deadline = QDeadlineTimer(QDeadlineTimer::Forever))

lockedReadWriteLock を解放し、待機条件で待つ。lockedReadWriteLock は、呼び出し元のスレッドによって最初にロックされていなければならない。lockedReadWriteLock がロック状態でない場合、この関数は直ちに戻る。lockedReadWriteLock を再帰的にロックしてはならない。さもないと、この関数はロックを適切に解放しない。lockedReadWriteLock はロック解除され、呼び出し元のスレッドはこれらの条件のいずれかが満たされるまでブロックされる：

• 別のスレッドがwakeOne() またはwakeAll() を使用してシグナルを送る。この場合、この関数はtrueを返す。
• deadline で指定された期限に達した。deadline がQDeadlineTimer::Forever (デフォルト)である場合、wait はタイムアウトしません (イベントはシグナルされなければなりません)。待ち時間がタイムアウトした場合、この関数は偽を返します。

lockedReadWriteLock は同じロック状態に戻される。この関数は、ロック状態から待機状態へのアトミックな遷移を可能にするために用意されている。

wakeOne() およびwakeAll()も参照のこと 。

bool QWaitCondition::wait(QMutex *lockedMutex, unsigned long time)

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

lockedMutex を解放し、time ミリ秒待機する。

bool QWaitCondition::wait(QReadWriteLock *lockedReadWriteLock, unsigned long time)

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

lockedReadWriteLock を解放し、time ミリ秒待機する。

void QWaitCondition::wakeAll()

wait条件で待機しているすべてのスレッドを起動する。スレッドが起動される順番はオペレーティングシステムのスケジューリングポリシーに依存し、制御や予測はできない。

wakeOne()も参照のこと 。

void QWaitCondition::wakeOne()

待ち状態で待機しているスレッドを1つ起こす。ウェイクアップされるスレッドはオペレーティングシステムのスケジューリングポリシーに依存し、制御したり予測したりすることはできません。

特定のスレッドをウェイクアップさせたい場合は、通常、異なる待機条件を使用し、異なるスレッドを異なる条件で待機させることで解決する。

wakeAll()も参照のこと 。