QHash::const_iterator Class
class QHash::const_iteratorLa clase ` QHash::const_iterator ` proporciona un iterador `const` al estilo STL para ` QHash`. Más...
Funciones públicas
| const_iterator() | |
| const_iterator(const QHash<Key, T>::iterator &other) | |
| const Key & | key() const |
| const T & | value() const |
| bool | operator!=(const QHash<Key, T>::const_iterator &other) const |
| const T & | operator*() const |
| QHash<Key, T>::const_iterator & | operator++() |
| QHash<Key, T>::const_iterator | operator++(int) |
| const T * | operator->() const |
| bool | operator==(const QHash<Key, T>::const_iterator &other) const |
Descripción detallada
QHash<Key, T>::const_iterator permite iterar sobre un ` QHash`. Si deseas modificar el ` QHash ` mientras iteras sobre él, debes utilizar en su lugar ` QHash::iterator `. Por lo general, se recomienda utilizar ` QHash::const_iterator ` también con un ` QHash ` no constante, a menos que sea necesario modificar el ` QHash ` 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 ` QHash::const_iterator ` crea un iterador sin inicializar. Debes inicializarlo utilizando una función ` QHash ` como ` QHash::cbegin()`, ` QHash::cend()` o ` QHash::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, QHash 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 consecutivamente, 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 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 después de que se haya producido una operación de reordenación dará lugar a un comportamiento indefinido.
No obstante, puedes utilizar iteradores de forma segura para eliminar entradas del hash mediante el método QHash::erase(). Esta función se puede llamar de forma segura mientras se itera y no afectará al orden de los elementos del hash.
Advertencia: Los iteradores en 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 « QHash::iterator », « QHash::key_iterator » y « QHash::const_key_value_iterator ».
Documentación de funciones miembro
[constexpr noexcept default] const_iterator::const_iterator()
Crea un iterador no inicializado.
No se deben llamar funciones como key(), value() ni el operador++() sobre un iterador no inicializado. Utiliza el operador=() para asignarle un valor antes de utilizarlo.
Véase también QHash::constBegin() y QHash::constEnd().
[noexcept] const_iterator::const_iterator(const QHash<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] const T &const_iterator::value() const
Devuelve el valor del elemento actual.
Véase también key() y operator*().
[noexcept] bool const_iterator::operator!=(const QHash<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] const T &const_iterator::operator*() const
Devuelve el valor del elemento actual.
Es lo mismo que value().
Véase también key().
[noexcept] QHash<Key, T>::const_iterator &const_iterator::operator++()
El operador prefijo ++ (++i) hace avanzar el iterador al siguiente elemento del hash y devuelve un iterador al nuevo elemento actual.
Llamar a esta función sobre QHash::end() da lugar a resultados indefinidos.
[noexcept] QHash<Key, T>::const_iterator const_iterator::operator++(int)
El operador postfijo ++ (i++) avanza el iterador al siguiente elemento del hash y devuelve un iterador al elemento que era el actual anteriormente.
Se trata de una función sobrecargada.
[noexcept] const T *const_iterator::operator->() const
Devuelve un puntero al valor del elemento actual.
Véase también value().
[noexcept] bool const_iterator::operator==(const QHash<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.