QFutureSynchronizer Class
template <typename T> class QFutureSynchronizerLa clase `QFutureSynchronizer` es una clase auxiliar que simplifica la sincronización d QFuture. Más información...
| Encabezado: | #include <QFutureSynchronizer> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los heredados
- QFutureSynchronizer forma parte de las clases de subprocesos.
Funciones públicas
| QFutureSynchronizer() | |
| QFutureSynchronizer(QFuture<T> future) | |
| ~QFutureSynchronizer() | |
| void | addFuture(QFuture<T> future) |
| bool | cancelOnWait() const |
| void | clearFutures() |
| QList<QFuture<T>> | futures() const |
| void | setCancelOnWait(bool enabled) |
| void | setFuture(QFuture<T> future) |
| void | waitForFinished() |
Descripción detallada
QFutureSynchronizer es una clase de plantilla en la que el parámetro de plantilla T especifica el tipo de resultado de los objetos QFuture que se están sincronizando. QFutureSynchronizer simplifica la sincronización de uno o más objetos QFuture. Los «futures» se añaden mediante las funciones « addFuture()» o « setFuture()». La función « futures()» devuelve una lista de «futures». Utiliza « clearFutures()» para eliminar todos los «futures» del QFutureSynchronizer.
La función ` waitForFinished()` espera a que finalicen todos los futuros. El destructor de `QFutureSynchronizer` llama a ` waitForFinished()`, lo que ofrece una forma sencilla de garantizar que todos los futuros hayan finalizado antes de salir de una función:
void someFunction()
{
QFutureSynchronizer<void> synchronizer;
//...
synchronizer.addFuture(QtConcurrent::run(anotherFunction));
synchronizer.addFuture(QtConcurrent::map(list, mapFunction));
return; // QFutureSynchronizer waits for all futures to finish
}El comportamiento de ` waitForFinished()` se puede modificar mediante la función ` setCancelOnWait()`. Al llamar a ` setCancelOnWait(true)`, ` waitForFinished()` cancelará todas las futuras antes de esperar a que finalicen. Se puede consultar el estado de la función «cancelación en espera» mediante la función ` cancelOnWait()`.
Véase también QFuture, QFutureWatcher y Qt Concurrent.
Documentación de funciones de miembro
QFutureSynchronizer::QFutureSynchronizer()
Crea un objeto QFutureSynchronizer.
[explicit] QFutureSynchronizer::QFutureSynchronizer(QFuture<T> future)
Crea un objeto `QFutureSynchronizer` y comienza a supervisar ` future ` llamando a ` addFuture()`.
Véase también addFuture().
QFutureSynchronizer::~QFutureSynchronizer()
Llama a la función ` waitForFinished()` para garantizar que todos los «futures» hayan finalizado antes de destruir este ` QFutureSynchronizer`.
Véase también waitForFinished().
void QFutureSynchronizer::addFuture(QFuture<T> future)
Añade « future » a la lista de futuros gestionados.
Véase también futures().
bool QFutureSynchronizer::cancelOnWait() const
Devuelve ` true ` si la función «cancel-on-wait» está activada; en caso contrario, devuelve `false`. Si «cancel-on-wait» está activada, la función ` waitForFinished()` cancelará todos los futuros antes de esperar a que finalicen.
Véase también setCancelOnWait() y waitForFinished().
void QFutureSynchronizer::clearFutures()
Elimina todos los futuros gestionados de esta página: QFutureSynchronizer.
Véase también addFuture() y setFuture().
QList<QFuture<T>> QFutureSynchronizer::futures() const
Devuelve una lista de todos los futuros gestionados.
Véase también addFuture() y setFuture().
void QFutureSynchronizer::setCancelOnWait(bool enabled)
Activa o desactiva la función de cancelación en espera según el argumento « enabled ». Si « enabled » es verdadero, la función « waitForFinished()» cancelará todos los futuros antes de esperar a que finalicen.
Véase también cancelOnWait() y waitForFinished().
void QFutureSynchronizer::setFuture(QFuture<T> future)
Establece future como el único futuro gestionado por este QFutureSynchronizer. Se trata de una función de conveniencia que llama a waitForFinished(), a continuación a clearFutures() y, por último, pasa future a addFuture().
Véanse también addFuture(), waitForFinished() y clearFutures().
void QFutureSynchronizer::waitForFinished()
Espera a que finalicen todos los «futures». Si cancelOnWait() devuelve true, cada «future» se cancela antes de esperar a que finalicen.
Véase también cancelOnWait() y setCancelOnWait().
© 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.