En esta página

QFutureIterator Class

template <typename T> class QFutureIterator

La clase `QFutureIterator` proporciona un iterador `const` al estilo de Java para ` QFuture`. Más información...

Encabezado: #include <QFutureIterator>
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 reentrantes.

Funciones públicas

QFutureIterator(const QFuture<T> &future)
bool findNext(const T &value)
bool findPrevious(const T &value)
bool hasNext() const
bool hasPrevious() const
const T &next()
const T &peekNext() const
const T &peekPrevious() const
const T &previous()
void toBack()
void toFront()
QFutureIterator<T> &operator=(const QFuture<T> &future)

Descripción detallada

QFutureIterator<T> es una clase de plantilla en la que T especifica el tipo de resultado de la QFuture sobre la que se está iterando.

QFuture Cuenta tanto con iteradores al estilo Java como con iteradores al estilo STL. Los iteradores al estilo Java son de mayor nivel y más fáciles de usar que los iteradores al estilo STL; por otro lado, son ligeramente menos eficientes.

Una alternativa al uso de iteradores es utilizar posiciones de índice. Algunas funciones miembro de QFuture toman un índice como primer parámetro, lo que permite acceder a los resultados sin necesidad de utilizar iteradores.

QFutureIterator<T> te permite iterar sobre un ` QFuture` <T>. Ten en cuenta que no existe un iterador mutable para ` QFuture ` (a diferencia de los demás iteradores al estilo Java).

El constructor de QFutureIterator toma un QFuture como argumento. Tras su construcción, el iterador se sitúa al principio de la lista de resultados (es decir, antes del primer resultado). A continuación se muestra cómo recorrer todos los resultados de forma secuencial:

QFuture<QString> future;
//...
QFutureIterator<QString> i(future);
while (i.hasNext())
    QString s = i.next();

La función next() devuelve el siguiente resultado (esperando a que esté disponible, si es necesario) del futuro y hace avanzar el iterador. A diferencia de los iteradores de estilo STL, los iteradores de estilo Java apuntan entre los resultados en lugar de directamente a ellos. La primera llamada a next() hace avanzar el iterador hasta la posición entre el primer y el segundo resultado, y devuelve el primer resultado; la segunda llamada a next() hace avanzar el iterador hasta la posición entre el segundo y el tercer resultado, y devuelve el segundo resultado; y así sucesivamente.

Posiciones del iterador entre cuatro elementos A, B, C y D, con flechas que señalan las posiciones válidas

A continuación se explica cómo recorrer los elementos en orden inverso:

QFutureIterator<QString> i(future);
i.toBack();
while (i.hasPrevious())
    QString s = i.previous();

Si quieres encontrar todas las apariciones de un valor concreto, utiliza findNext() o findPrevious() en un bucle.

Se pueden utilizar varios iteradores en el mismo futuro. Si el futuro se modifica mientras un QFutureIterator está activo, el QFutureIterator seguirá iterando sobre el futuro original, ignorando la copia modificada.

Véase también QFuture::const_iterator y QFuture.

Documentación de las funciones miembro

QFutureIterator::QFutureIterator(const QFuture<T> &future)

Crea un iterador para recorrer future. El iterador se sitúa al principio de la lista de resultados (antes del primer resultado).

Véase también operator=().

bool QFutureIterator::findNext(const T &value)

Busca « value » a partir de la posición actual del iterador y en adelante. Devuelve « true » si se encuentra « value »; en caso contrario, devuelve « false ».

Tras la llamada, si se ha encontrado value, el iterador se coloca justo después del resultado coincidente; en caso contrario, el iterador se coloca al final de la lista de resultados.

Véase también findPrevious().

bool QFutureIterator::findPrevious(const T &value)

Busca « value » empezando desde la posición actual del iterador y retrocediendo. Devuelve « true » si se encuentra « value »; en caso contrario, devuelve « false ».

Tras la llamada, si se ha encontrado value, el iterador se sitúa justo antes del resultado coincidente; en caso contrario, el iterador se sitúa al principio de la lista de resultados.

Véase también findNext().

bool QFutureIterator::hasNext() const

Devuelve ` true ` si hay al menos un resultado por delante del iterador (es decir, si el iterador no se encuentra al final de la lista de resultados); en caso contrario, devuelve `false`.

Véase también hasPrevious() y next().

bool QFutureIterator::hasPrevious() const

Devuelve ` true ` si hay al menos un resultado por delante del iterador (es decir, si el iterador no se encuentra al principio de la lista de resultados); en caso contrario, devuelve `false`.

Véase también hasNext() y previous().

const T &QFutureIterator::next()

Devuelve el siguiente resultado y hace avanzar el iterador una posición.

La llamada a esta función sobre un iterador situado al final de la lista de resultados da lugar a resultados indefinidos.

Véase también hasNext(), peekNext() y previous().

const T &QFutureIterator::peekNext() const

Devuelve el siguiente resultado sin desplazar el iterador.

Si se llama a esta función en un iterador situado al final de la lista de resultados, se obtienen resultados indefinidos.

Véase también hasNext(), next() y peekPrevious().

const T &QFutureIterator::peekPrevious() const

Devuelve el resultado anterior sin desplazar el iterador.

Si se llama a esta función en un iterador situado al principio de la lista de resultados, se obtienen resultados indefinidos.

Véase también hasPrevious(), previous() y peekNext().

const T &QFutureIterator::previous()

Devuelve el resultado anterior y desplaza el iterador una posición hacia atrás.

Si se llama a esta función en un iterador situado al principio de la lista de resultados, se obtienen resultados indefinidos.

Véase también hasPrevious(), peekPrevious() y next().

void QFutureIterator::toBack()

Desplaza el iterador al final de la lista de resultados (después del último resultado).

Véase también toFront() y previous().

void QFutureIterator::toFront()

Desplaza el iterador al principio de la lista de resultados (antes del primer resultado).

Véase también toBack() y next().

QFutureIterator<T> &QFutureIterator::operator=(const QFuture<T> &future)

Hace que el iterador opere sobre future. El iterador se coloca al principio de la lista de resultados (antes del primer resultado).

Véase también toFront() y toBack().

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