En esta página

QtTaskTree::Iterator Class

class QtTaskTree::Iterator

Clase base que se utiliza como iterador dentro del elemento «For». Más información...

Cabecera: #include <qtasktree.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS TaskTree)
target_link_libraries(mytarget PRIVATE Qt6::TaskTree)
qmake: QT += tasktree
Desde: Qt 6.11
Heredado por:

QtTaskTree::ForeverIterator, QtTaskTree::ListIterator, QtTaskTree::RepeatIterator y QtTaskTree::UntilIterator

Estado: Vista previa tecnológica

Esta clase se encuentra en fase de avance tecnológico y está sujeta a cambios.

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

Iterator(QtTaskTree::Iterator &&other)
qsizetype iteration() const

Descripción detallada

Véase también For, ForeverIterator, RepeatIterator, UntilIterator y ListIterator.

Documentación de las funciones de miembro

[constexpr noexcept default] Iterator::Iterator(QtTaskTree::Iterator &&other)

Crea una instancia de ` Iterator` mediante la construcción «move».

qsizetype Iterator::iteration() const

Devuelve el índice de iteración del controlador que se está ejecutando actualmente dentro del cuerpo de un elemento « Do » de la construcción « For » (Iterator) >> « ». Utiliza esta función únicamente desde el interior del cuerpo del controlador de cualquier elemento « GroupItem » situado en el cuerpo « Do » de la receta; de lo contrario, es posible que se produzca un fallo del sistema. Asegúrate de que se pasa « Iterator » al elemento « For ».

Ejemplo de uso:

const QList<std::chrono::seconds> timeouts = { 5s, 1s, 3s };
const ListIterator iterator(timeouts);

const auto onSetup = [iterator](std::chrono::milliseconds &timeout) {
    timeout = *iterator;
    qDebug() << "Starting" << iterator.iteration() << "iteration with timeout"
            << *iterator << "segundos.";
};
const auto onDone = [iterator] {
    qDebug() << "Finished" << iterator.iteration() << "iteration with timeout"
            << *iterator <<  «segundos.»;
};

const Group sequentialRecipe = For(iterator) >> Do {
    QTimeoutTask(onSetup, onDone)
};

const Group parallelRecipe = For(iterator) >> Do {
    parallel,
    QTimeoutTask(onSetup, onDone)
};

El resultado al ejecutar ` sequentialRecipe ` será:

Starting 0 iteration with timeout 5s seconds.
Finished 0 iteration with timeout 5s seconds.
Starting 1 iteration with timeout 1s seconds.
Finished 1 iteration with timeout 1s seconds.
Starting 2 iteration with timeout 3s seconds.
Finished 2 iteration with timeout 3s seconds.

En modo secuencial, se garantiza que se mantenga el orden de los índices de iteración en los manejadores «done».

El resultado al ejecutar « parallelRecipe » será:

Starting 0 iteration with timeout 5s seconds.
Starting 1 iteration with timeout 1s seconds.
Starting 2 iteration with timeout 3s seconds.
Finished 1 iteration with timeout 1s seconds.
Finished 2 iteration with timeout 3s seconds.
Finished 0 iteration with timeout 5s seconds.

En modo paralelo, no se garantiza que se mantenga el orden de los índices de iteración en los controladores «done», y este depende del orden en que finalicen las tareas. El índice de iteración devuelto dentro del controlador «done» del cuerpo paralelo de « Do » coincide con el índice de la iteración original para el controlador «setup» correspondiente, por lo que es posible que el orden de los índices de iteración en los controladores «done» posteriores no sea ascendente.

© 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.