En esta página

QMutableLinkedListIterator Class

template <typename T> class QMutableLinkedListIterator

La clase `QMutableLinkedListIterator` proporciona un iterador no constante, al estilo de Java, para ` QLinkedList`. Más información...

Encabezado: #include <QMutableLinkedListIterator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core5Compat)
target_link_libraries(mytarget PRIVATE Qt6::Core5Compat)
qmake: QT += core5compat

Funciones públicas

QMutableLinkedListIterator(QLinkedList<T> &list)
bool findNext(const T &value)
bool findPrevious(const T &value)
bool hasNext() const
bool hasPrevious() const
void insert(const T &value)
T &next()
T &peekNext() const
T &peekPrevious() const
T &previous()
void remove()
void setValue(const T &value) const
void toBack()
void toFront()
const T &value() const
T &value()
QMutableLinkedListIterator<T> &operator=(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.

`QMutableLinkedListIterator<T>` te permite recorrer una ` QLinkedList<T>` y modificar la lista, donde ` T ` es el tipo de elemento. Si no deseas modificar la lista (o tienes una ` QLinkedList` de tipo `const`), utiliza en su lugar el ` QLinkedListIterator<T>`, que es ligeramente más rápido.

El constructor de `QMutableLinkedListIterator` toma como argumento un ` QLinkedList `. Tras la construcción, el iterador se sitúa al principio de la lista (antes del primer elemento). A continuación se explica cómo recorrer todos los elementos de forma secuencial:

QLinkedList<float> list;
...
QMutableLinkedListIterator<float> i(list);
while (i.hasNext())
    qDebug() << i.next();

La función next() devuelve el siguiente elemento de la lista y avanza 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, devolviendo el segundo elemento; y así sucesivamente.

Ejemplo del uso de iteradores al estilo Java en Qt

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

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

Si quieres eliminar elementos a medida que recorres la lista, utiliza remove(). Si quieres modificar el valor de un elemento, utiliza setValue(). Si quieres insertar un nuevo elemento en la lista, utiliza insert().

Ejemplo:

QMutableLinkedListIterator<int> i(list);
while (i.hasNext()) {
    int val = i.next();
    if (val < 0) {
        i.setValue(-val);
    } else if (val == 0) {
        i.remove();
    }
}

El ejemplo recorre una lista, sustituyendo los números negativos por sus valores absolutos y eliminando los ceros.

Solo puede haber un iterador mutable activo en una lista determinada en un momento dado. Además, no se deben realizar cambios directamente en la lista mientras el iterador esté activo (a diferencia de lo que ocurre a través del iterador), ya que esto podría invalidar el iterador y provocar un comportamiento indefinido.

Véase también QLinkedListIterator y QLinkedList::iterator.

Documentación de las funciones miembro

QMutableLinkedListIterator::QMutableLinkedListIterator(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 QMutableLinkedListIterator::findNext(const T &value)

Busca « value » a partir de la posición actual del iterador 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 QMutableLinkedListIterator::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 elemento coincidente; en caso contrario, el iterador se sitúa al principio del contenedor.

Véase también findNext().

bool QMutableLinkedListIterator::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 QMutableLinkedListIterator::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éase también hasNext() y previous().

void QMutableLinkedListIterator::insert(const T &value)

Inserta value en la posición actual del iterador. Tras la llamada, el iterador se sitúa justo después del elemento insertado.

Véase también remove() y setValue().

T &QMutableLinkedListIterator::next()

Devuelve una referencia al 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éase también hasNext(), peekNext() y previous().

T &QMutableLinkedListIterator::peekNext() const

Devuelve una referencia al siguiente elemento, sin desplazar el iterador.

La llamada a esta función en un iterador situado al final del contenedor da lugar a resultados indefinidos.

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

T &QMutableLinkedListIterator::peekPrevious() const

Devuelve una referencia al elemento anterior, sin desplazar el iterador.

Si se llama a esta función en un iterador situado al principio del contenedor, se obtienen resultados indefinidos.

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

T &QMutableLinkedListIterator::previous()

Devuelve una referencia al 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éase también hasPrevious(), peekPrevious() y next().

void QMutableLinkedListIterator::remove()

Elimina el último elemento que se ha saltado utilizando una de las funciones de recorrido (next(), previous(), findNext(), findPrevious()).

Ejemplo:

QMutableLinkedListIterator<int> i(list);
while (i.hasNext()) {
    int val = i.next();
    if (val < -32768 || val > 32767)
        i.remove();
}

Véanse también insert() y setValue().

void QMutableLinkedListIterator::setValue(const T &value) const

Sustituye el valor del último elemento que se ha saltado al utilizar una de las funciones de recorrido por value.

Las funciones de recorrido son next(), previous(), findNext() y findPrevious().

Ejemplo:

QMutableLinkedListIterator<double> i(list);
while (i.hasNext()) {
    double val = i.next();
    i.setValue(std::sqrt(val));
}

Véanse también value(), remove() y insert().

void QMutableLinkedListIterator::toBack()

Desplaza el iterador hasta el final del contenedor (después del último elemento).

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

void QMutableLinkedListIterator::toFront()

Desplaza el iterador al principio del contenedor (antes del primer elemento).

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

const T &QMutableLinkedListIterator::value() const

Devuelve el valor del último elemento que se ha omitido al utilizar una de las funciones de recorrido (next(), previous(), findNext(), findPrevious()).

Tras una llamada a next() o findNext(), value() es equivalente a peekPrevious(). Tras una llamada a previous() o findPrevious(), value() es equivalente a peekNext().

Véase también setValue().

T &QMutableLinkedListIterator::value()

Devuelve una referencia no constante al valor del último elemento que se ha omitido al utilizar una de las funciones de recorrido.

Esta es una función sobrecargada.

QMutableLinkedListIterator<T> &QMutableLinkedListIterator::operator=(QLinkedList<T> &list)

Hace que el iterador opere sobre list. El iterador se sitúa al principio de la lista (antes del primer elemento).

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.