En esta página

QWaitCondition Class

La clase QWaitCondition proporciona una variable de condición para sincronizar subprocesos. Más información...

Encabezado: #include <QWaitCondition>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Nota: Todas las funciones de esta clase son seguras para subprocesos.

Funciones públicas

QWaitCondition()
~QWaitCondition()
void notify_all()
void notify_one()
bool wait(QMutex *lockedMutex, QDeadlineTimer deadline = QDeadlineTimer(QDeadlineTimer::Forever))
bool wait(QReadWriteLock *lockedReadWriteLock, QDeadlineTimer deadline = QDeadlineTimer(QDeadlineTimer::Forever))
bool wait(QMutex *lockedMutex, unsigned long time)
bool wait(QReadWriteLock *lockedReadWriteLock, unsigned long time)
void wakeAll()
void wakeOne()

Descripción detallada

QWaitCondition permite que un hilo notifique a otros hilos que se ha cumplido algún tipo de condición. Uno o varios hilos pueden bloquearse a la espera de que una instancia de QWaitCondition establezca una condición mediante wakeOne() o wakeAll(). Utiliza wakeOne() para despertar un hilo seleccionado al azar o wakeAll() para despertarlos todos.

Por ejemplo, supongamos que tenemos tres tareas que deben ejecutarse cada vez que el usuario pulse una tecla. Cada tarea podría dividirse en un hilo, cada uno de los cuales tendría un cuerpo de run() como este:

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

Aquí, la variable keyPressed es una variable global de tipo QWaitCondition.

Un cuarto hilo leería las pulsaciones de teclas y activaría los otros tres hilos cada vez que recibiera una, de esta forma:

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

El orden en el que se activan los tres subprocesos no está definido. Además, si algunos de los subprocesos siguen en do_something() cuando se pulsa la tecla, no se activarán (ya que no están esperando a la variable de condición) y, por lo tanto, la tarea no se ejecutará para esa pulsación de tecla. Este problema se puede resolver utilizando un contador y un ` QMutex ` para protegerlo. Por ejemplo, este es el nuevo código para los hilos de trabajo:

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

    do_something();

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

Este es el código del cuarto hilo:

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

El mutex es necesario porque los resultados de dos subprocesos que intentan cambiar el valor de la misma variable simultáneamente son impredecibles.

Las condiciones de espera son una potente primitiva de sincronización de subprocesos. El ejemplo «Productor y consumidor con condiciones de espera» muestra cómo utilizar `QWaitCondition` como alternativa a ` QSemaphore ` para controlar el acceso a un búfer circular compartido por un subproceso productor y un subproceso consumidor.

Véase también « QMutex» , « QSemaphore », « QThread » y «Productor y consumidor mediante condiciones de espera».

Documentación de funciones miembro

QWaitCondition::QWaitCondition()

Crea un nuevo objeto de condición de espera.

[noexcept] QWaitCondition::~QWaitCondition()

Elimina el objeto de condición de espera.

void QWaitCondition::notify_all()

Esta función se ofrece para garantizar la compatibilidad con la STL. Es equivalente a wakeAll().

void QWaitCondition::notify_one()

Esta función se ofrece para garantizar la compatibilidad con la STL. Es equivalente a ` wakeOne()`.

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

Libera el ` lockedMutex ` y espera a que se cumpla la condición de espera. El ` lockedMutex ` debe estar bloqueado inicialmente por el hilo que realiza la llamada. Si ` lockedMutex ` no se encuentra en estado bloqueado, el comportamiento es indefinido. Si ` lockedMutex ` es un mutex recursivo, esta función devuelve el resultado inmediatamente. El ` lockedMutex ` se desbloqueará y el hilo que realiza la llamada se bloqueará hasta que se cumpla cualquiera de estas condiciones:

  • Otro hilo le envíe una señal mediante wakeOne() o wakeAll(). En este caso, esta función devolverá «true».
  • se alcanza el plazo establecido por deadline. Si deadline es QDeadlineTimer::Forever (el valor por defecto), la espera nunca agotará el tiempo de espera (el evento debe ser señalado). Esta función devolverá «false» si la espera ha agotado el tiempo de espera.

El lockedMutex se devolverá al mismo estado de bloqueo. Esta función se proporciona para permitir la transición atómica del estado de bloqueo al estado de espera.

Véanse también wakeOne() y wakeAll().

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

Libera el ` lockedReadWriteLock ` y espera a que se cumpla la condición de espera. El ` lockedReadWriteLock ` debe estar bloqueado inicialmente por el hilo que realiza la llamada. Si el ` lockedReadWriteLock ` no se encuentra en estado bloqueado, esta función devuelve el resultado de inmediato. El ` lockedReadWriteLock ` no debe bloquearse de forma recursiva; de lo contrario, esta función no liberará el bloqueo correctamente. El ` lockedReadWriteLock ` se desbloqueará y el hilo que realiza la llamada se bloqueará hasta que se cumpla una de estas condiciones:

  • Otro hilo le envíe una señal mediante wakeOne() o wakeAll(). En este caso, esta función devolverá «true».
  • se alcance el plazo establecido por ` deadline `. Si ` deadline ` es ` QDeadlineTimer::Forever ` (el valor por defecto), la espera nunca agotará el tiempo de espera (el evento debe ser señalado). Esta función devolverá «false» si la espera ha agotado el tiempo de espera.

El lockedReadWriteLock se devolverá al mismo estado de bloqueo. Esta función se proporciona para permitir la transición atómica del estado de bloqueo al estado de espera.

Véanse también wakeOne() y wakeAll().

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

Libera el objeto ` lockedMutex ` y espera en la condición de espera durante ` time ` milisegundos.

Esta es una función sobrecargada.

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

Libera el objeto « lockedReadWriteLock » y espera en la condición de espera durante « time » milisegundos.

Esta es una función sobrecargada.

void QWaitCondition::wakeAll()

Activa todos los subprocesos que están a la espera de la condición de espera. El orden en el que se activan los subprocesos depende de las políticas de programación del sistema operativo y no se puede controlar ni predecir.

Véase también wakeOne().

void QWaitCondition::wakeOne()

Activa un hilo que está a la espera de la condición de espera. El hilo que se activa depende de las políticas de programación del sistema operativo y no se puede controlar ni predecir.

Si se desea activar un hilo concreto, la solución suele consistir en utilizar diferentes condiciones de espera y hacer que distintos hilos esperen en condiciones diferentes.

Véase también ` wakeAll()`.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.