QMultiMapIterator Class
template <typename Key, typename T> class QMultiMapIteratorLa clase `QMultiMapIterator` proporciona un iterador `const` al estilo de Java para ` QMultiMap`. ` QMultiMap ` dispone tanto de iteradores al estilo de Java como de iteradores al estilo de la STL. Los iteradores al estilo de la STL son más eficientes y son los recomendados. El parámetro de plantilla ` Key ` especifica el tipo de clave del mapa, y ` T ` especifica el tipo de valor. Más información...
| Encabezado: | #include <QMultiMapIterator> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los heredados
- QMultiMapIterator forma parte de los iteradores de estilo Java en Qt.
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> permite recorrer un mapa « QMultiMap ». Si deseas modificar el mapa mientras lo recorres, utiliza en su lugar QMutableMultiMapIterator.
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). A continuación se explica cómo recorrer todos los elementos de forma secuencial:
QMultiMap<int, QWidget*> multimap;
//...
QMultiMapIterator<int, QWidget*> i(multimap);
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 que se ha saltado.
A diferencia de los iteradores de estilo STL, los iteradores de estilo Java apuntan a la posición entre elementos en lugar de apuntar directamente a los elementos. 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; y así sucesivamente.
A continuación se explica cómo recorrer los elementos en orden inverso:
QMultiMapIterator<int, QWidget*> i(multimap);
i.toBack();
while (i.hasPrevious()) {
i.previous();
qDebug() << i.key() << ": " << i.value();
}Si quieres encontrar todas las apariciones de un valor concreto, utiliza findNext() o findPrevious() en un bucle. Por ejemplo:
QMultiMapIterator<int, QWidget*> i(multimap);
while (i.findNext(widget)) {
qDebug() << "Found widget " << widget << " under key "
<< i.key();
}Se pueden utilizar varios iteradores en el mismo mapa. Si se modifica el mapa mientras hay un QMultiMapIterator activo, este seguirá iterando sobre el mapa original, ignorando la copia modificada.
Véase también QMutableMultiMapIterator.
Documentación de las funciones miembro
QMultiMapIterator::QMultiMapIterator(const QMultiMap<Key, T> &map)
Crea un iterador para recorrer map. El iterador se sitúa al principio del mapa (antes del primer elemento).
Véase también operator=().
bool QMultiMapIterator::findNext(const T &value)
Busca « value » a partir de la posición actual del iterador y hacia adelante. Devuelve « true » si se encuentra un par (clave, valor) cuyo valor sea « 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 QMultiMapIterator::findPrevious(const T &value)
Busca « value » empezando desde la posición actual del iterador y retrocediendo. Devuelve « true » si se encuentra un par (clave, valor) cuyo valor sea « value »; en caso contrario, devuelve « false ».
Tras la llamada, si se ha encontrado value, el iterador se coloca justo antes del elemento coincidente; de lo contrario, el iterador se coloca 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, si el iterador no se encuentra al final del contenedor; en caso contrario, devuelve ` false`.
Véanse también hasPrevious() y next().
bool QMultiMapIterator::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().
const Key &QMultiMapIterator::key() const
Devuelve la clave del último elemento que se ha saltado utilizando una de las funciones de recorrido (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() es equivalente a peekNext().key().
Véase también value().
QMultiMapIterator<Key, T>::Item QMultiMapIterator::next()
Devuelve el siguiente elemento y hace avanzar el iterador una posición.
Llama a ` key()` sobre el valor devuelto para obtener la clave del elemento, y a ` value()` para obtener el valor.
La llamada a esta función sobre un iterador situado al final del contenedor da lugar a resultados indefinidos.
Véanse también hasNext(), peekNext() y previous().
QMultiMapIterator<Key, T>::Item QMultiMapIterator::peekPrevious() const
Devuelve el elemento anterior sin desplazar el iterador.
Llama a ` key()` sobre el valor devuelto para obtener la clave del elemento, y a ` value()` para obtener el valor.
La llamada a esta función sobre un iterador situado al principio del contenedor da lugar a resultados indefinidos.
Véanse 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.
Llama a ` key()` sobre el valor devuelto para obtener la clave del elemento, y a ` value()` para obtener el valor.
La llamada a esta función en un iterador situado al principio del contenedor da lugar a resultados indefinidos.
Véanse también hasPrevious(), peekPrevious() y next().
void QMultiMapIterator::toBack()
Desplaza el iterador al final del contenedor (después del último elemento).
Véase también toFront() y previous().
void QMultiMapIterator::toFront()
Desplaza 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 ha saltado 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() es equivalente a peekNext().value().
Véase también key().
QMultiMapIterator<Key, T> &QMultiMapIterator::operator=(const QMultiMap<Key, T> &map)
Hace que el iterador opere sobre map. El iterador se sitúa al principio del mapa (antes del primer elemento).
© 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.