En esta página

QMultiMapIterator Class

template <typename Key, typename T> class QMultiMapIterator

La clase QMultiMapIterator proporciona un iterador const de estilo Java para QMultiMap. QMultiMap tiene tanto iteradores de estilo Java como iteradores de estilo STL. Los iteradores estilo STL son más eficientes y deberían preferirse. Más...

Cabecera: #include <QMultiMapIterator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Funciones públicas

QMultiMapIterator(const QMultiMap<Key, T> &map)
bool findNext(const T &value)
bool findPrevious(const T &value)
bool hasNext() const
bool hasPrevious() const
const Key &key() const
QMultiMapIterator<Key, T>::Item next()
QMultiMapIterator<Key, T>::Item peekPrevious() const
QMultiMapIterator<Key, T>::Item previous()
void toBack()
void toFront()
const T &value() const
QMultiMapIterator<Key, T> &operator=(const QMultiMap<Key, T> &map)

Descripción detallada

QMultiMapIterator<Key, T> le permite iterar sobre un QMultiMap. Si desea modificar el mapa a medida que itera sobre él, utilice QMutableMultiMapIterator en su lugar.

El constructor de QMultiMapIterator toma un QMultiMap como argumento. Tras la construcción, el iterador se sitúa al principio del mapa (antes del primer elemento). He aquí cómo iterar sobre todos los elementos secuencialmente:

QMultiMap<int, QWidget*> multimapa;//...QMultiMapIterator<int, QWidget*> i(multimapa);while (i.hasNext()) { i.next();    qDebug() << i.key() << ": " << i.value();
}

La función next() devuelve el siguiente elemento del mapa y hace avanzar el iterador. Las funciones key() y value() devuelven la clave y el valor del último elemento sobre el que se ha saltado.

A diferencia de los iteradores de estilo STL, los iteradores de estilo Java apuntan entre elementos en lugar de directamente a los elementos. La primera llamada a next() avanza el iterador a la posición entre el primer y el segundo elemento, y devuelve el primer elemento; la segunda llamada a next() avanza el iterador a la posición entre el segundo y el tercer elemento; y así sucesivamente.

Los iteradores estilo Java apuntan entre elementos

He aquí cómo iterar sobre los elementos en orden inverso:

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

Si desea encontrar todas las apariciones de un valor determinado, utilice findNext() o findPrevious() en un bucle. Por ejemplo:

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

Se pueden utilizar múltiples iteradores sobre el mismo mapa. Si el mapa se modifica mientras un QMultiMapIterator está activo, el QMultiMapIterator continuará iterando sobre el mapa original, ignorando la copia modificada.

Véase también QMutableMultiMapIterator.

Documentación de Funciones Miembro

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

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

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

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

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

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

void QMultiMapIterator::toFront()

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

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

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

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

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