En esta página

QHashIterator Class

template <typename Key, typename T> class QHashIterator

La clase `QHashIterator` proporciona un iterador `const` al estilo de Java para ` QHash ` y ` QMultiHash`. Más información...

Encabezado: #include <QHashIterator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Funciones públicas

QHashIterator(const QHash<Key, T> &hash)
bool findNext(const T &value)
bool hasNext() const
const Key &key() const
QHashIterator<Key, T>::Item next()
QHashIterator<Key, T>::Item peekNext() const
void toBack()
void toFront()
const T &value() const
QHashIterator<Key, T> &operator=(const QHash<Key, T> &hash)

Descripción detallada

QHash cuenta tanto con iteradores al estilo Java como con iteradores al estilo STL. Los iteradores al estilo STL son más eficientes y son los recomendables. El parámetro de plantilla Key especifica el tipo de clave del hash, y T especifica el tipo de valor.

QHashIterator<Key, T> permite iterar sobre un QHash (o un QMultiHash). Si deseas modificar el hash mientras iteras sobre él, utiliza en su lugar QMutableHashIterator.

El constructor de QHashIterator toma un QHash como argumento. Tras la construcción, el iterador se sitúa justo al principio del hash (antes del primer elemento). A continuación se explica cómo recorrer todos los elementos de forma secuencial:

QHash<int, QWidget*> hash;
//...
QHashIterator<int, QWidget*> i(hash);
while (i.hasNext()) {
    i.next();
    qDebug() << i.key() << ": " << i.value();
}

La función next() devuelve el siguiente elemento del hash y avanza 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.

Posiciones del iterador entre los elementos A, B, C y D

Si quieres encontrar todas las apariciones de un valor concreto, utiliza findNext() en un bucle. Por ejemplo:

QHashIterator<int, QWidget*> i(hash);
while (i.findNext(widget)) {
    qDebug() << "Found widget " << widget << " under key "
           << i.key();
}

Se pueden utilizar varios iteradores en el mismo hash. Si el hash se modifica mientras un QHashIterator está activo, el QHashIterator seguirá iterando sobre el hash original, ignorando la copia modificada.

Véase también QMutableHashIterator y QHash::const_iterator.

Documentación de funciones miembro

QHashIterator::QHashIterator(const QHash<Key, T> &hash)

Crea un iterador para recorrer ` hash`. El iterador se sitúa al principio del hash (antes del primer elemento).

Véase también operator=().

bool QHashIterator::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; de lo contrario, el iterador se sitúa al final del contenedor.

bool QHashIterator::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éase también next().

const Key &QHashIterator::key() const

Devuelve la clave del último elemento que se ha omitido al utilizar una de las funciones de recorrido (next(), findNext()).

Véase también value().

QHashIterator<Key, T>::Item QHashIterator::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() y peekNext().

QHashIterator<Key, T>::Item QHashIterator::peekNext() const

Devuelve el siguiente elemento 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 final del contenedor da lugar a resultados indefinidos.

Véanse también hasNext() y next().

void QHashIterator::toBack()

Desplaza el iterador hasta el final del contenedor (después del último elemento).

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

void QHashIterator::toFront()

Desplaza el iterador al principio del contenedor (antes del primer elemento).

Véase también toBack() y next().

const T &QHashIterator::value() const

Devuelve el valor del último elemento que se ha omitido utilizando una de las funciones de recorrido (next(), findNext()).

Véase también key().

QHashIterator<Key, T> &QHashIterator::operator=(const QHash<Key, T> &hash)

Hace que el iterador opere sobre hash. El iterador se sitúa al principio del hash (antes del primer elemento).

Véase también toFront() y toBack().

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