QHash::const_iterator Class

Descripción detallada

QHash<Key, T>::const_iterator le permite iterar sobre un QHash. Si desea modificar el QHash mientras itera sobre él, debe utilizar QHash::iterator en su lugar. Generalmente es una buena práctica usar QHash::const_iterator sobre un QHash no-const también, a menos que necesites cambiar el QHash a través del iterador. Los iteradores const son ligeramente más rápidos y pueden mejorar la legibilidad del código.

El constructor por defecto QHash::const_iterator crea un iterador no inicializado. Debes inicializarlo usando una función QHash como QHash::cbegin(), QHash::cend(), o QHash::constFind() antes de que puedas empezar a iterar. Este es 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. La única garantía 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, tenga en cuenta que cualquier modificación realizada directamente en QHash (inserción y eliminación de elementos) puede hacer que los iteradores pierdan su validez.

Insertar elementos en el hash o llamar a métodos como QHash::reserve() o QHash::squeeze() puede invalidar todos los iteradores que apunten al hash. Se garantiza que los iteradores seguirán siendo válidos mientras QHash no tenga que aumentar/reducir su tabla hash interna. El uso de cualquier iterador después de que se haya producido una operación de reflash dará lugar a un comportamiento indefinido.

Sin embargo, puedes utilizar iteradores de forma segura para eliminar entradas del hash utilizando el método QHash::erase(). Esta función puede ser llamada de forma segura mientras se itera, y no afectará al orden de los elementos en el hash.