QMutableHashIterator Class
template <typename Key, typename T> class QMutableHashIteratorLa clase `QMutableHashIterator` proporciona un iterador no constante, al estilo de Java, para ` QHash ` y ` QMultiHash`. Más información...
| Encabezado: | #include <QMutableHashIterator> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los heredados
- QMutableHashIterator forma parte de los iteradores de estilo Java en Qt.
Funciones públicas
| QMutableHashIterator(QHash<Key, T> &hash) | |
| bool | findNext(const T &value) |
| bool | hasNext() const |
| const Key & | key() const |
| QMutableHashIterator<Key, T>::Item | next() |
| QMutableHashIterator<Key, T>::Item | peekNext() const |
| void | remove() |
| void | setValue(const T &value) |
| void | toBack() |
| void | toFront() |
| const T & | value() const |
| T & | value() |
| QMutableHashIterator<Key, T> & | operator=(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 más recomendables. El parámetro de plantilla Key especifica el tipo de clave del hash, y T especifica el tipo de valor.
QMutableHashIterator<Key, T> permite iterar sobre un QHash y modificar el hash. Si no se desea modificar el hash (o se tiene un QHash de tipo const), utilícese en su lugar el QHashIterator, que es ligeramente más rápido.
El constructor de QMutableHashIterator 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;
//...
QMutableHashIterator<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() avanza el iterador hasta la posición entre el primer y el segundo elemento, y devuelve el primer elemento; la segunda llamada a next() avanza el iterador hasta la posición entre el segundo y el tercer elemento; y así sucesivamente.
Si quieres encontrar todas las apariciones de un valor concreto, utiliza findNext() en un bucle. Por ejemplo:
QMutableHashIterator<int, QWidget*> i(hash);
while (i.findNext(widget)) {
qDebug() << "Found widget " << widget << " under key "
<< i.key();
}Si quieres eliminar elementos mientras recorres el hash, utiliza remove(). Si quieres modificar el valor de un elemento, utiliza setValue().
Ejemplo:
QMutableHashIterator<QString, QString> i(hash);
while (i.hasNext()) {
i.next();
if (i.key() == i.value())
i.remove();
}El ejemplo elimina todos los pares (clave, valor) en los que la clave y el valor son iguales.
Solo puede haber un iterador mutable activo en un hash determinado en un momento dado. Además, no se deben realizar cambios directamente en el hash mientras el iterador esté activo (a diferencia de lo que ocurre al hacerlo a través del iterador), ya que esto podría invalidar el iterador y dar lugar a un comportamiento indefinido.
Véase también QHashIterator y QHash::iterator.
Documentación de las funciones miembro
QMutableHashIterator::QMutableHashIterator(QHash<Key, T> &hash)
Crea un iterador para recorrer hash. El iterador se coloca al principio del hash (antes del primer elemento).
Véase también operator=().
bool QMutableHashIterator::findNext(const T &value)
Busca « value » a partir de la posición actual del iterador en sentido ascendente. 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; en caso contrario, el iterador se sitúa al final del contenedor.
bool QMutableHashIterator::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 &QMutableHashIterator::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().
QMutableHashIterator<Key, T>::Item QMutableHashIterator::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().
QMutableHashIterator<Key, T>::Item QMutableHashIterator::peekNext() const
Devuelve una referencia al 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 en un iterador situado al final del contenedor da lugar a resultados indefinidos.
Véanse también hasNext() y next().
void QMutableHashIterator::remove()
Elimina el último elemento que se ha saltado utilizando una de las funciones de recorrido (next(), findNext()).
Véase también setValue().
void QMutableHashIterator::setValue(const T &value)
Sustituye el valor del último elemento que se ha saltado al utilizar una de las funciones de recorrido por « value ».
Las funciones de recorrido son ` next()` y ` findNext()`.
Véanse también key(), value() y remove().
void QMutableHashIterator::toBack()
Desplaza el iterador al final del contenedor (después del último elemento).
Véase también ` toFront()`.
void QMutableHashIterator::toFront()
Desplaza el iterador al principio del contenedor (antes del primer elemento).
Véase también toBack() y next().
const T &QMutableHashIterator::value() const
Devuelve el valor del último elemento que se ha saltado utilizando una de las funciones de recorrido (next(), findNext()).
Véase también key() y setValue().
T &QMutableHashIterator::value()
Devuelve una referencia no constante al valor del último elemento que se ha saltado utilizando una de las funciones de recorrido.
QMutableHashIterator<Key, T> &QMutableHashIterator::operator=(QHash<Key, T> &hash)
Hace que el iterador opere sobre hash. El iterador se sitúa al principio del hash (antes del primer elemento).
© 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.