QMutableListIterator Class

Documentación de funciones miembro

QMutableListIterator::QMutableListIterator(QList<T> &list)

Construye un iterador para recorrer list. El iterador se coloca al principio de la lista (antes del primer elemento).

Véase también operator=().

bool QMutableListIterator::findNext(const T &value)

Busca value comenzando desde la posición actual del iterador hacia adelante. Devuelve true si se encuentra value; en caso contrario devuelve false.

Después de la llamada, si se encontró value, el iterador se posiciona justo después del elemento coincidente; en caso contrario, el iterador se posiciona al final del contenedor.

Véase también findPrevious().

bool QMutableListIterator::findPrevious(const T &value)

Busca value comenzando desde la posición actual del iterador hacia atrás. Devuelve true si se encuentra value; en caso contrario devuelve false.

Después de la llamada, si se encontró value, el iterador se posiciona justo antes del elemento coincidente; en caso contrario, el iterador se posiciona al principio del contenedor.

Véase también findNext().

bool QMutableListIterator::hasNext() const

Devuelve true si hay al menos un elemento por delante del iterador, es decir, el iterador no está al final del contenedor; en caso contrario devuelve false.

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

bool QMutableListIterator::hasPrevious() const

Devuelve true si hay al menos un elemento detrás del iterador, es decir, el iterador no está en la parte delantera del contenedor; en caso contrario devuelve false.

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

void QMutableListIterator::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 &QMutableListIterator::next()

Devuelve una referencia al siguiente elemento y avanza el iterador una posición.

Llamar a esta función en un iterador situado en la parte posterior del contenedor conduce a resultados indefinidos.

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

T &QMutableListIterator::peekNext() const

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

Llamar a esta función en un iterador situado en la parte posterior del contenedor conduce a resultados indefinidos.

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

T &QMutableListIterator::peekPrevious() const

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

Llamar a esta función en un iterador situado en la parte delantera del contenedor conduce a resultados indefinidos.

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

T &QMutableListIterator::previous()

Devuelve una referencia al elemento anterior y desplaza el iterador una posición hacia atrás.

Llamar a esta función en un iterador situado en la parte delantera del contenedor conduce a resultados indefinidos.

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

void QMutableListIterator::remove()

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

Ejemplo:

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

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

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

Sustituye el valor del último elemento que se saltó utilizando una de las funciones de desplazamiento por value.

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

Ejemplo:

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

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

void QMutableListIterator::toBack()

Mueve el iterador a la parte posterior del contenedor (después del último elemento).

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

void QMutableListIterator::toFront()

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

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

const T &QMutableListIterator::value() const

Devuelve el valor del último elemento que se saltó utilizando una de las funciones de recorrido (next(), previous(), findNext(), findPrevious()).

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

Véase también setValue().

T &QMutableListIterator::value()

Devuelve una referencia no-const al valor del último elemento sobre el que se ha saltado utilizando una de las funciones transversales.

QMutableListIterator<T> &QMutableListIterator::operator=(QList<T> &list)

Hace que el iterador opere en list. El iterador se coloca al principio de la lista (antes del primer elemento).

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