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 （デフォルト）に設定されている場合、待機はタイムアウトすることはありません（イベントがシグナルされる必要があります）。待機がタイムアウトした場合は、この関数はfalseを返します。

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 （デフォルト）に設定されている場合、待機はタイムアウトすることはありません（イベントがシグナルされなければなりません）。待機がタイムアウトした場合、この関数はfalseを返します。

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()

待機条件を満たしているすべてのスレッドを目覚めさせます。スレッドが目覚める順序は、オペレーティングシステムのスケジューリングポリシーに依存するため、制御したり予測したりすることはできません。

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

void QWaitCondition::wakeOne()

待機条件を満たしているスレッドを1つ目覚めさせます。どのスレッドが目覚めるかはオペレーティングシステムのスケジューリングポリシーに依存するため、制御したり予測したりすることはできません。

特定のスレッドを復帰させたい場合は、通常、異なる待機条件を使用し、異なるスレッドに異なる条件で待機させるという方法をとります。

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