QMutableMapIterator Class

QMap<int, QWidget*> map;//...QMutableMapIterator<int, QWidget*> i(map);while (i.hasNext()) { i.next();    qDebug() << i.key() << ": " << i.value();
}

QMutableMapIterator<int, QWidget*> i(map); i.toBack();while (i.hasPrevious()) { i.previous();    qDebug() << i.key() << ": " << i.value();
}

QMutableMapIterator<int, QWidget*> i(map);while (i.findNext(widget)) {    qDebug() << "Found widget " << widget << " under key "
           << i.key(); }

QMutableMapIterator<QString, QString> i(map);
while (i.hasNext()) {
    i.next();
    if (i.key() == i.value())
        i.remove();
}

Documentación de funciones miembro

QMutableMapIterator::QMutableMapIterator(QMap<Key, T> &map)

Construye un iterador para recorrer map. El iterador se coloca al principio del mapa (antes del primer elemento).

Véase también operator=().

bool QMutableMapIterator::findNext(const T &value)

Busca value comenzando desde la posición actual del iterador hacia adelante. Devuelve true si se encuentra un par (clave, valor) con valor 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 QMutableMapIterator::findPrevious(const T &value)

Busca value empezando desde la posición actual del iterador hacia atrás. Devuelve true si se encuentra un par (clave, valor) con valor value; en caso contrario devuelve false.

Tras la llamada, si se ha encontrado 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 QMutableMapIterator::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 QMutableMapIterator::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().

const Key &QMutableMapIterator::key() const

Devuelve la clave del último elemento sobre el que se ha saltado utilizando una de las funciones transversales (next(), previous(), findNext(), findPrevious()).

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

Véase también value().

QMutableMapIterator<Key, T>::Item QMutableMapIterator::next()

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

Llame a key() sobre el valor devuelto para obtener la clave del elemento, y a value() para obtener el valor.

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

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

QMutableMapIterator<Key, T>::Item QMutableMapIterator::peekNext() const

Devuelve el siguiente elemento sin mover el iterador.

Llame a key() sobre el valor devuelto para obtener la clave del elemento, y a value() para obtener el valor.

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

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

QMutableMapIterator<Key, T>::Item QMutableMapIterator::peekPrevious() const

Devuelve el elemento anterior sin mover el iterador.

Llame a key() sobre el valor devuelto para obtener la clave del elemento, y a value() para obtener el valor.

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

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

QMutableMapIterator<Key, T>::Item QMutableMapIterator::previous()

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

Llame a key() sobre el valor devuelto para obtener la clave del elemento, y a value() para obtener el valor.

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

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

void QMutableMapIterator::remove()

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

Véase también setValue().

void QMutableMapIterator::setValue(const T &value)

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().

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

void QMutableMapIterator::toBack()

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

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

void QMutableMapIterator::toFront()

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

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

const T &QMutableMapIterator::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() es equivalente a peekPrevious().value(). Tras una llamada a previous() o findPrevious(), value() equivale a peekNext().value().

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

T &QMutableMapIterator::value()

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

QMutableMapIterator<Key, T> &QMutableMapIterator::operator=(QMap<Key, T> &map)

Hace que el iterador opere en map. El iterador se coloca al principio del mapa (antes del primer elemento).

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