QMapIterator Class

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

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

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

Documentación de Funciones Miembro

QMapIterator::QMapIterator(const 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 QMapIterator::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 QMapIterator::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 QMapIterator::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 QMapIterator::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 &QMapIterator::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().

QMapIterator<Key, T>::Item QMapIterator::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().

QMapIterator<Key, T>::Item QMapIterator::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().

QMapIterator<Key, T>::Item QMapIterator::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().

QMapIterator<Key, T>::Item QMapIterator::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 QMapIterator::toBack()

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

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

void QMapIterator::toFront()

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

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

const T &QMapIterator::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().

QMapIterator<Key, T> &QMapIterator::operator=(const 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().