En esta página

QMultiMap::iterator Class

class QMultiMap::iterator

La clase ` QMultiMap::iterator ` proporciona un iterador no constante, al estilo de la STL, para ` QMultiMap`. Más información...

Tipos públicos

Funciones públicas

iterator()
const Key &key() const
T &value() const
T &operator*() const
QMultiMap<Key, T>::iterator &operator++()
QMultiMap<Key, T>::iterator operator++(int)
QMultiMap<Key, T>::iterator &operator--()
QMultiMap<Key, T>::iterator operator--(int)
T *operator->() const
bool operator!=(const QMultiMap<Key, T>::iterator &lhs, const QMultiMap<Key, T>::iterator &rhs)
bool operator==(const QMultiMap<Key, T>::iterator &lhs, const QMultiMap<Key, T>::iterator &rhs)

Descripción detallada

QMultiMap<Key, T>::iterator te permite recorrer un QMultiMap y modificar el valor (pero no la clave) almacenado bajo una clave concreta. Si deseas recorrer un `const QMultiMap`, debes utilizar ` QMultiMap::const_iterator`. Por lo general, es una buena práctica utilizar ` QMultiMap::const_iterator ` también con un ` QMultiMap ` no constante, a menos que necesites modificar el ` QMultiMap ` a través del iterador. Los iteradores constantes son ligeramente más rápidos y pueden mejorar la legibilidad del código.

El constructor predeterminado de QMultiMap::iterator crea un iterador sin inicializar. Debes inicializarlo utilizando una función de QMultiMap como QMultiMap::begin(), QMultiMap::end() o QMultiMap::find() antes de poder comenzar a iterar. A continuación se muestra un bucle típico que imprime todos los pares (clave, valor) almacenados en un mapa:

A diferencia de QMultiHash, que almacena sus elementos en un orden arbitrario, QMultiMap almacena sus elementos ordenados por clave. Los elementos que comparten la misma clave aparecerán consecutivamente, desde el valor insertado más recientemente hasta el menos reciente.

A continuación se muestra un ejemplo que incrementa en 2 cada valor almacenado en el ` QMultiMap `:

for (auto i = multimap.begin(), end = multimap.end(); i != end; ++i)
    i.value() += 2;

Para eliminar elementos de un « QMultiMap », puedes utilizar « erase_if » (QMultiMap<Key, T> &map, Predicate pred):

erase_if(multimap, [](const QMultiMap<QString, int>::iterator it) { return it.value() > 10; });

Se pueden utilizar varios iteradores en el mismo mapa. Si añades elementos al mapa, los iteradores existentes seguirán siendo válidos. Si eliminas elementos del mapa, los iteradores que apunten a los elementos eliminados se convertirán en iteradores «colgantes».

Advertencia: Los iteradores de contenedores compartidos implícitamente no funcionan exactamente igual que los iteradores de la STL. Debes evitar copiar un contenedor mientras haya iteradores activos en él. Para obtener más información, consulta «Problema con los iteradores de contenedores compartidos implícitamente».

Véase también QMultiMap::const_iterator, QMultiMap::key_iterator y QMultiMap::key_value_iterator.

Documentación sobre tipos de miembros

[alias] iterator::iterator_category

Sinónimo de `std::bidirectional_iterator_tag ` que indica que este iterador es bidireccional.

Documentación de las funciones miembro

[default] iterator::iterator()

Crea un iterador no inicializado.

No se deben llamar funciones como key(), value() y el operador++() sobre un iterador no inicializado. Utiliza el operador=() para asignarle un valor antes de utilizarlo.

Véase también QMultiMap::begin() y QMultiMap::end().

const Key &iterator::key() const

Devuelve la clave del elemento actual como una referencia constante.

No hay una forma directa de cambiar la clave de un elemento mediante un iterador, aunque se puede hacer llamando a ` QMultiMap::erase()` seguido de ` QMultiMap::insert()`.

Véase también ` value()`.

T &iterator::value() const

Devuelve una referencia modificable al valor del elemento actual.

Puedes cambiar el valor de un elemento utilizando value() a la izquierda de una asignación, por ejemplo:

if (i.key() == "Hello")
    i.value() = "Bonjour";

Véase también key() y operator*().

T &iterator::operator*() const

Devuelve una referencia modificable al valor del elemento actual.

Equivalente a value().

Véase también key().

QMultiMap<Key, T>::iterator &iterator::operator++()

El operador prefijo « ++ » (++i) hace avanzar el iterador al siguiente elemento del «multi map» y devuelve un iterador al nuevo elemento actual.

La llamada a esta función en QMultiMap::end() da lugar a resultados indefinidos.

Véase también operator--().

QMultiMap<Key, T>::iterator iterator::operator++(int)

El operador postfijo « ++ » (i++) avanza el iterador al siguiente elemento del «multi map» y devuelve un iterador al elemento que era el actual anteriormente.

Se trata de una función sobrecargada.

QMultiMap<Key, T>::iterator &iterator::operator--()

El operador prefijo « -- » (--i) convierte el elemento anterior en el elemento actual y devuelve un iterador que apunta al nuevo elemento actual.

La llamada a esta función sobre ` QMultiMap::begin()` da lugar a resultados indefinidos.

Véase también ` operator++()`.

QMultiMap<Key, T>::iterator iterator::operator--(int)

El operador postfijo « -- » (i--) convierte el elemento anterior en el elemento actual y devuelve un iterador que apunta al elemento que era el actual anteriormente.

Se trata de una función sobrecargada.

T *iterator::operator->() const

Devuelve un puntero al valor del elemento actual.

Véase también value().

Elementos no miembros relacionados

bool operator!=(const QMultiMap<Key, T>::iterator &lhs, const QMultiMap<Key, T>::iterator &rhs)

Devuelve ` true ` si ` lhs ` apunta a un elemento distinto del iterador ` rhs `; en caso contrario, devuelve ` false`.

Véase también operator==().

bool operator==(const QMultiMap<Key, T>::iterator &lhs, const QMultiMap<Key, T>::iterator &rhs)

Devuelve ` true ` si ` lhs ` apunta al mismo elemento que el iterador ` rhs `; en caso contrario, devuelve ` false`.

Véase también operator!=().

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