En esta página

QMultiHash::const_iterator Class

class QMultiHash::const_iterator

La clase ` QMultiHash::const_iterator ` proporciona un iterador `const` al estilo de la STL para ` QMultiHash`. Más información...

Funciones públicas

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

Descripción detallada

QMultiHash<Key, T>::const_iterator permite iterar sobre un ` QMultiHash`. Si deseas modificar el ` QMultiHash ` mientras iteras sobre él, debes utilizar ` QMultiHash::iterator ` en su lugar. Por lo general, es una buena práctica utilizar también QMultiHash::const_iterator en un QMultiHash no const, a menos que sea necesario modificar el QMultiHash a través del iterador. Los iteradores const son ligeramente más rápidos y pueden mejorar la legibilidad del código.

El constructor predeterminado de ` QMultiHash::const_iterator ` crea un iterador no inicializado. Debes inicializarlo utilizando una función ` QMultiHash ` como ` QMultiHash::cbegin()`, ` QMultiHash::cend()` o ` QMultiHash::constFind()` 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 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. Lo único que se garantiza es que los elementos que comparten la misma clave (porque se insertaron utilizando un QMultiHash) aparecerán de forma consecutiva, desde el valor insertado más recientemente hasta el menos reciente.

Se pueden utilizar varios iteradores en el mismo hash. Sin embargo, hay que tener en cuenta que cualquier modificación realizada directamente en el QMultiHash (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 QMultiHash::reserve() o QMultiHash::squeeze() puede invalidar todos los iteradores que apunten al hash. Se garantiza que los iteradores seguirán siendo válidos solo mientras el ` QMultiHash ` no tenga que ampliar o reducir su tabla hash interna. El uso de cualquier iterador después de que se haya producido 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 ` QMultiHash`.

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

Véase también « QMultiHash::iterator », « QMultiHash::key_iterator » y « QMultiHash::const_key_value_iterator ».

Documentación de funciones miembro

[constexpr noexcept default] const_iterator::const_iterator()

Crea un iterador no inicializado.

No se deben invocar 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 QMultiHash::constBegin() y QMultiHash::constEnd().

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

Crea una copia de other.

[noexcept] const Key &const_iterator::key() const

Devuelve la clave del elemento actual.

Véase también value().

[noexcept] T &const_iterator::value() const

Devuelve el valor del elemento actual.

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

[noexcept] bool const_iterator::operator!=(const QMultiHash<Key, T>::const_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 &const_iterator::operator*() const

Devuelve el valor del elemento actual.

Es lo mismo que « value()».

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

[noexcept] QMultiHash<Key, T>::const_iterator &const_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 sobre ` QMultiHash::end()` da lugar a resultados indefinidos.

[noexcept] QMultiHash<Key, T>::const_iterator const_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 *const_iterator::operator->() const

Devuelve un puntero al valor del elemento actual.

Véase también value().

[noexcept] bool const_iterator::operator==(const QMultiHash<Key, T>::const_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.