QMutableHashIterator Class
template <typename Key, typename T> class QMutableHashIteratorLa clase QMutableHashIterator proporciona un iterador no-const de estilo Java para QHash y QMultiHash. Más...
| Cabecera: | #include <QMutableHashIterator> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
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 tiene iteradores de estilo Java e iteradores de estilo STL. Los iteradores de estilo STL son más eficientes y deberían preferirse.
QMutableHashIterator<Key, T> te permite iterar sobre un QHash y modificar el hash. Si no quieres modificar el hash (o tienes una const QHash), usa el ligeramente más rápido QHashIterator en su lugar.
El constructor QMutableHashIterator toma un QHash como argumento. Después de la construcción, el iterador se encuentra al principio del hash (antes del primer elemento). He aquí cómo iterar sobre todos los elementos secuencialmente:
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 hace avanzar el iterador. Las funciones key() y value() devuelven la clave y el valor del último elemento sobre el que se ha saltado.
A diferencia de los iteradores de estilo STL, los iteradores de estilo Java apuntan entre elementos en lugar de directamente a los elementos. La primera llamada a next() avanza el iterador a la posición entre el primer y el segundo elemento, y devuelve el primer elemento; la segunda llamada a next() avanza el iterador a la posición entre el segundo y el tercer elemento; y así sucesivamente.
Si desea encontrar todas las apariciones de un valor determinado, utilice 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 a medida que iteras sobre el hash, utiliza remove(). Si desea modificar el valor de un elemento, utilice 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.
Sólo un iterador mutable puede estar activo en un hash dado en cualquier momento. Además, no se deben realizar cambios directamente en el hash mientras el iterador esté activo (en lugar de a través del iterador), ya que esto podría invalidar el iterador y provocar un comportamiento indefinido.
Véase también QHashIterator y QHash::iterator.
Documentación de las funciones miembro
QMutableHashIterator::QMutableHashIterator(QHash<Key, T> &hash)
Construye 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 comenzando desde la posición actual del iterador hacia adelante. Devuelve true si se encuentra un par (clave, valor) con valor value; en caso contrario devuelve false.
Después de la llamada, si se encontró value, el iterador se posiciona justo después del elemento coincidente; en caso contrario, el iterador se posiciona al final del contenedor.
bool QMutableHashIterator::hasNext() const
Devuelve true si hay al menos un elemento por delante del iterador, es decir, el iterador no está 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 sobre el que se ha saltado utilizando una de las funciones transversales (next(), findNext()).
Véase también value().
QMutableHashIterator<Key, T>::Item QMutableHashIterator::next()
Devuelve el siguiente elemento y avanza el iterador una posición.
Llame a key() sobre el valor devuelto para obtener la clave del elemento, y a value() para obtener el valor.
Llamar a esta función sobre un iterador situado en la parte posterior del contenedor conduce a resultados indefinidos.
Véase también hasNext() y peekNext().
QMutableHashIterator<Key, T>::Item QMutableHashIterator::peekNext() const
Devuelve una referencia al siguiente elemento sin mover el iterador.
Llame a key() sobre el valor devuelto para obtener la clave del elemento, y a value() para obtener el valor.
Llamar a esta función sobre un iterador situado en la parte posterior del contenedor conduce a resultados indefinidos.
Véase también hasNext() y next().
void QMutableHashIterator::remove()
Elimina el último elemento sobre el que se ha saltado mediante una de las funciones de desplazamiento (next(), findNext()).
Véase también setValue().
void QMutableHashIterator::setValue(const T &value)
Sustituye el valor del último elemento que se ha saltado utilizando una de las funciones traversal por value.
Las funciones de salto son next() y findNext().
Véase también key(), value() y remove().
void QMutableHashIterator::toBack()
Mueve el iterador a la parte posterior del contenedor (después del último elemento).
Véase también toFront().
void QMutableHashIterator::toFront()
Mueve 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 saltó utilizando una de las funciones de travesía (next(), findNext()).
Véase también key() y setValue().
T &QMutableHashIterator::value()
Devuelve una referencia no-const al valor del último elemento que se ha saltado utilizando una de las funciones traversal.
QMutableHashIterator<Key, T> &QMutableHashIterator::operator=(QHash<Key, T> &hash)
Hace que el iterador opere en hash. El iterador se coloca 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.