En esta página

QMultiHash::iterator Class

class QMultiHash::iterator

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

Funciones públicas

iterator()
const Key &key() const
T &value() const
bool operator!=(const QMultiHash<Key, T>::const_iterator &other) const
bool operator!=(const QMultiHash<Key, T>::iterator &other) const
T &operator*() const
QMultiHash<Key, T>::iterator &operator++()
QMultiHash<Key, T>::iterator operator++(int)
T *operator->() const
bool operator==(const QMultiHash<Key, T>::const_iterator &other) const
bool operator==(const QMultiHash<Key, T>::iterator &other) const

Descripción detallada

QMultiHash<Key, T>::iterator permite recorrer una ` QMultiHash ` y modificar el valor (pero no la clave) asociado a una clave concreta. Si desea recorrer una lista ` QMultiHash` constante, debe utilizar ` QMultiHash::const_iterator`. Por lo general, es recomendable utilizar ` QMultiHash::const_iterator ` también en una lista ` QMultiHash ` no constante, a menos que necesite modificar el ` QMultiHash ` 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 QMultiHash::iterator crea un iterador sin inicializar. Debes inicializarlo utilizando una función QMultiHash como QMultiHash::begin(), QMultiHash::end() o QMultiHash::find() antes de poder empezar a iterar. A continuación se muestra un bucle típico que imprime todos los pares (clave, valor) almacenados en un hash:

QHash<QString, int> hash;
hash.insert("January", 1);
hash.insert("February", 2);
//...
hash.insert("December", 12);

for (auto i = hash.cbegin(), end = hash.cend(); i != end; ++i)
    cout << qPrintable(i.key()) << ": " << i.value() << endl;

A diferencia de QMap, que ordena sus elementos por clave, QMultiHash almacena sus elementos en un orden arbitrario.

A continuación se muestra un ejemplo que incrementa en 2 cada valor almacenado en el « QMultiHash »:

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

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

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

Se pueden utilizar varios iteradores en el mismo hash. Sin embargo, ten en cuenta que cualquier modificación realizada directamente en el QHash (insertar y eliminar elementos) puede hacer que los iteradores dejen de ser válidos.

La inserción de elementos en el hash o la llamada a métodos como QHash::reserve() o QHash::squeeze() puede invalidar todos los iteradores que apuntan al hash. Se garantiza que los iteradores seguirán siendo válidos solo mientras el QHash no tenga que ampliar o reducir su tabla hash interna. El uso de cualquier iterador tras una operación de reordenación dará lugar a un comportamiento indefinido.

Si necesitas conservar los iteradores durante un periodo prolongado, te recomendamos que utilices ` QMultiMap ` en lugar de ` QHash`.

Advertencia: Los iteradores sobre 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 el problema de los iteradores de uso compartido implícito.

Véase también « QMultiHash::const_iterator », « QMultiHash::key_iterator » y « QMultiHash::key_value_iterator ».

Documentación de funciones miembro

[constexpr noexcept default] iterator::iterator()

Crea un iterador no inicializado.

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

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

[noexcept] 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 QMultiHash::erase() seguido de QMultiHash::insert().

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

[noexcept] 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*().

[noexcept] bool iterator::operator!=(const QMultiHash<Key, T>::const_iterator &other) const

[noexcept] bool iterator::operator!=(const QMultiHash<Key, T>::iterator &other) const

Devuelve ` true ` si ` other ` apunta a un elemento distinto de este iterador; en caso contrario, devuelve ` false`.

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

[noexcept] T &iterator::operator*() const

Devuelve una referencia modificable al valor del elemento actual.

Es lo mismo que value().

Véase también key().

[noexcept] QMultiHash<Key, T>::iterator &iterator::operator++()

El operador prefijo ++ (++i) avanza el iterador hasta el siguiente elemento del hash y devuelve un iterador que apunta al nuevo elemento actual.

Llamar a esta función en QMultiHash::end() da lugar a resultados indefinidos.

[noexcept] QMultiHash<Key, T>::iterator iterator::operator++(int)

El operador postfijo ++ (i++) avanza el iterador hasta el siguiente elemento del hash y devuelve un iterador al elemento que era el actual anteriormente.

Se trata de una función sobrecargada.

[noexcept] T *iterator::operator->() const

Devuelve un puntero al valor del elemento actual.

Véase también value().

[noexcept] bool iterator::operator==(const QMultiHash<Key, T>::const_iterator &other) const

[noexcept] bool iterator::operator==(const QMultiHash<Key, T>::iterator &other) const

Devuelve ` true ` si ` other ` apunta al mismo elemento que este iterador; 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.