QtTaskTree::Iterator Class

Dokumentation zu den Mitgliedsfunktionen

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

Erstellt eine Instanz von „ Iterator “ mithilfe von „Move“.

qsizetype Iterator::iteration() const

Gibt den Iterationsindex des aktuell ausgeführten Handlers innerhalb eines „ Do “-Körpers des Konstrukts „ For “ (Iterator) >> „ “ zurück. Verwenden Sie diese Funktion ausschließlich innerhalb des Handler-Körpers eines beliebigen „ GroupItem “-Elements, das im „ Do “-Körper des Rezepts platziert ist; andernfalls ist mit einem Absturz zu rechnen. Stellen Sie sicher, dass „ Iterator “ an das „ For “-Element übergeben wird.

Anwendungsbeispiel:

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 << "Sekunden.";
};
const auto onDone = [iterator] {
    qDebug() << "Finished" << iterator.iteration() << "iteration with timeout"
            << *iterator <<  „Sekunden.“;
};

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

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

Die Ausgabe bei Ausführung von ` sequentialRecipe ` lautet:

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.

Im sequenziellen Modus wird garantiert, dass die Reihenfolge der Iterationsindizes in den `done`-Handlern beibehalten wird.

Die Ausgabe bei Ausführung von ` parallelRecipe ` lautet:

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.

Im parallelen Modus ist die Beibehaltung der Reihenfolge der Iterationsindizes in den „done“-Handlern nicht garantiert und hängt von der Reihenfolge der abgeschlossenen Aufgaben ab. Der im „done“-Handler des parallelen „ Do “-Körpers zurückgegebene Iterationsindex entspricht dem Index der ursprünglichen Iteration für den entsprechenden „setup“-Handler, sodass die Reihenfolge der Iterationsindizes in den nachfolgenden „done“-Handlern möglicherweise nicht aufsteigend ist.