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

Documentation sur les fonctions membres

QWaitCondition::QWaitCondition()

Crée un nouvel objet de condition d'attente.

[noexcept] QWaitCondition::~QWaitCondition()

Supprime l'objet de condition d'attente.

void QWaitCondition::notify_all()

Cette fonction est fournie à des fins de compatibilité avec la STL. Elle équivaut à ` wakeAll()`.

void QWaitCondition::notify_one()

Cette fonction est fournie à des fins de compatibilité avec la STL. Elle équivaut à ` wakeOne()`.

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

Libère le mutex lockedMutex et attend que la condition d'attente soit remplie. Le mutex lockedMutex doit avoir été verrouillé au préalable par le thread appelant. Si le mutex lockedMutex n'est pas verrouillé, le comportement est indéfini. Si le mutex lockedMutex est un mutex récursif, cette fonction renvoie immédiatement une valeur. Le mutex lockedMutex sera déverrouillé, et le thread appelant se bloquera jusqu'à ce que l'une des deux conditions suivantes soit remplie :

• Un autre thread lui envoie un signal à l’aide de wakeOne() ou wakeAll(). Dans ce cas, cette fonction renvoie « true ».
• le délai spécifié par deadline est atteint. Si deadline est défini sur QDeadlineTimer::Forever (valeur par défaut), l’attente n’expirera jamais (l’événement doit être signalé). Cette fonction renverra « false » si l’attente a expiré.

L’ lockedMutex sera renvoyé dans le même état « verrouillé ». Cette fonction est fournie pour permettre la transition atomique de l’état « verrouillé » à l’état « en attente ».

Voir également wakeOne() et wakeAll().

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

Libère le verrou « lockedReadWriteLock » et attend que la condition d’attente soit remplie. Le verrou « lockedReadWriteLock » doit avoir été initialement verrouillé par le thread appelant. Si le verrou « lockedReadWriteLock » n’est pas verrouillé, cette fonction retourne immédiatement. Le verrou « lockedReadWriteLock » ne doit pas être verrouillé de manière récursive, sinon cette fonction ne libérera pas correctement le verrou. Le verrou « lockedReadWriteLock » sera déverrouillé, et le thread appelant se bloquera jusqu’à ce que l’une des deux conditions suivantes soit remplie :

• Un autre thread lui envoie un signal à l’aide de wakeOne() ou wakeAll(). Dans ce cas, cette fonction renverra « true ».
• le délai spécifié par ` deadline ` est atteint. Si ` deadline ` est défini sur ` QDeadlineTimer::Forever ` (valeur par défaut), alors l'attente n'expirera jamais (l'événement doit être signalé). Cette fonction renvoie `false` si l'attente a expiré.

L’ lockedReadWriteLock sera renvoyé dans le même état « verrouillé ». Cette fonction est fournie pour permettre la transition atomique de l’état « verrouillé » à l’état « en attente ».

Voir également wakeOne() et wakeAll().

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

Libère l'lockedMutex e et attend que la condition d'attente soit remplie pendant time millisecondes.

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

Libère l'lockedReadWriteLock e et attend que la condition d'attente soit remplie pendant time millisecondes.

void QWaitCondition::wakeAll()

Réveille tous les threads en attente de la condition d'attente. L'ordre dans lequel les threads sont réveillés dépend des politiques d'ordonnancement du système d'exploitation et ne peut être ni contrôlé ni prédit.

Voir également wakeOne().

void QWaitCondition::wakeOne()

Réveille un thread en attente d'une condition d'attente. Le thread réveillé dépend des politiques d'ordonnancement du système d'exploitation et ne peut être ni contrôlé ni prédit.

Si vous souhaitez réveiller un thread spécifique, la solution consiste généralement à utiliser différentes conditions d'attente et à faire en sorte que différents threads attendent différentes conditions.

Voir également ` wakeAll()`.