QLinkedListIterator Class
template <typename T> class QLinkedListIteratorLa clase `QLinkedListIterator` proporciona un iterador `const` al estilo de Java para ` QLinkedList`. Más información...
| Encabezado: | #include <QLinkedListIterator> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core5Compat) target_link_libraries(mytarget PRIVATE Qt6::Core5Compat) |
| qmake: | QT += core5compat |
Funciones públicas
| QLinkedListIterator(const QLinkedList<T> &list) | |
| 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() |
| QLinkedListIterator<T> & | operator=(const QLinkedList<T> &list) |
Descripción detallada
QLinkedList 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.
QLinkedListIterator<T> permite recorrer una QLinkedList<T>, donde T es el tipo de elemento. Si deseas modificar la lista mientras la recorres, utiliza en su lugar QMutableLinkedListIterator<T>.
El constructor de `QLinkedListIterator` toma un ` QLinkedList ` como argumento. Tras la construcción, el iterador se sitúa al principio de la lista (antes del primer elemento). A continuación se muestra cómo recorrer todos los elementos de forma secuencial:
QLinkedList<float> list;
...
QLinkedListIterator<float> i(list);
while (i.hasNext())
qDebug() << i.next();La función next() devuelve el siguiente elemento de la lista y hace avanzar el iterador. A diferencia de los iteradores al estilo STL, los iteradores al estilo Java apuntan entre elementos en lugar de apuntar directamente a ellos. La primera llamada a next() hace avanzar el iterador hasta la posición entre el primer y el segundo elemento, y devuelve el primer elemento; la segunda llamada a next() hace avanzar el iterador hasta la posición entre el segundo y el tercer elemento, y devuelve el segundo elemento; y así sucesivamente.

A continuación se explica cómo recorrer los elementos en orden inverso:
QLinkedListIterator<float> i(list);
i.toBack();
while (i.hasPrevious())
qDebug() << i.previous();Si quieres encontrar todas las apariciones de un valor concreto, utiliza ` findNext()` o ` findPrevious()` dentro de un bucle.
Se pueden utilizar varios iteradores en la misma lista. Si la lista se modifica mientras un QLinkedListIterator está activo, este seguirá iterando sobre la lista original, ignorando la copia modificada.
Véase también QMutableLinkedListIterator y QLinkedList::const_iterator.
Documentación de las funciones miembro
QLinkedListIterator::QLinkedListIterator(const QLinkedList<T> &list)
Crea un iterador para recorrer list. El iterador se sitúa al principio de la lista (antes del primer elemento).
Véase también operator=().
bool QLinkedListIterator::findNext(const T &value)
Busca « value » a partir de la posición actual del iterador y hacia adelante. 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 después del elemento coincidente; en caso contrario, el iterador se sitúa al final del contenedor.
Véase también findPrevious().
bool QLinkedListIterator::findPrevious(const T &value)
Busca « value » partiendo de 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 elemento coincidente; en caso contrario, el iterador se sitúa al principio del contenedor.
Véase también findNext().
bool QLinkedListIterator::hasNext() const
Devuelve ` true ` si hay al menos un elemento por delante del iterador, es decir, si el iterador no se encuentra al final del contenedor; en caso contrario, devuelve ` false`.
Véanse también hasPrevious() y next().
bool QLinkedListIterator::hasPrevious() const
Devuelve ` true ` si hay al menos un elemento detrás del iterador, es decir, si el iterador no se encuentra al principio del contenedor; en caso contrario, devuelve ` false`.
Véanse también hasNext() y previous().
const T &QLinkedListIterator::next()
Devuelve el siguiente elemento y hace avanzar el iterador una posición.
La llamada a esta función en un iterador situado al final del contenedor da lugar a resultados indefinidos.
Véanse también hasNext(), peekNext() y previous().
const T &QLinkedListIterator::peekNext() const
Devuelve el siguiente elemento sin desplazar el iterador.
Si se llama a esta función en un iterador situado al final del contenedor, se obtienen resultados indefinidos.
Véase también hasNext(), next() y peekPrevious().
const T &QLinkedListIterator::peekPrevious() const
Devuelve el elemento anterior sin desplazar el iterador.
La llamada a esta función en un iterador situado al principio del contenedor da lugar a resultados indefinidos.
Véase también hasPrevious(), previous() y peekNext().
const T &QLinkedListIterator::previous()
Devuelve el elemento anterior y desplaza el iterador una posición hacia atrás.
La llamada a esta función en un iterador situado al principio del contenedor da lugar a resultados indefinidos.
Véanse también hasPrevious(), peekPrevious() y next().
void QLinkedListIterator::toBack()
Desplaza el iterador hasta el final del contenedor (después del último elemento).
Véase también toFront() y previous().
void QLinkedListIterator::toFront()
Desplaza el iterador al principio del contenedor (antes del primer elemento).
Véase también toBack() y next().
QLinkedListIterator<T> &QLinkedListIterator::operator=(const QLinkedList<T> &list)
Hace que el iterador opere sobre list. El iterador se sitúa al principio de la lista (antes del primer elemento).
© 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.