QHash::const_iterator Class

Description détaillée

QHash<Key, T>::const_iterator vous permet de parcourir une QHash. Si vous souhaitez modifier l'QHash au fur et à mesure que vous la parcourez, vous devez utiliser QHash::iterator à la place. Il est généralement recommandé d’utiliser QHash::const_iterator sur une QHash non const également, sauf si vous devez modifier l’ QHash via l’itérateur. Les itérateurs const sont légèrement plus rapides et peuvent améliorer la lisibilité du code.

Le constructeur par défaut de ` QHash::const_iterator ` crée un itérateur non initialisé. Vous devez l’initialiser à l’aide d’une fonction ` QHash ` telle que ` QHash::cbegin()`, ` QHash::cend()` ou ` QHash::constFind()` avant de pouvoir commencer l’itération. Voici une boucle typique qui affiche toutes les paires (clé, valeur) stockées dans un hachage :

    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;

Contrairement à ` QMap`, qui trie ses éléments par clé, ` QHash ` stocke ses éléments dans un ordre arbitraire. La seule garantie est que les éléments partageant la même clé (parce qu’ils ont été insérés à l’aide d’un ` QMultiHash`) apparaîtront consécutivement, de la valeur la plus récemment insérée à la moins récemment insérée.

Il est possible d’utiliser plusieurs itérateurs sur le même hachage. Cependant, sachez que toute modification effectuée directement sur l’ QHash (insertion ou suppression d’éléments) peut rendre les itérateurs invalides.

L’insertion d’éléments dans le hachage ou l’appel de méthodes telles que ` QHash::reserve()` ou ` QHash::squeeze()` peut invalider tous les itérateurs pointant vers le hachage. La validité des itérateurs n’est garantie que tant que l’ QHash n’a pas besoin d’agrandir ou de réduire sa table de hachage interne. L’utilisation d’un itérateur après une opération de réorganisation de la table de hachage entraînera un comportement indéfini.

Vous pouvez toutefois utiliser les itérateurs en toute sécurité pour supprimer des entrées du hachage à l'aide de la méthode QHash::erase(). Cette fonction peut être appelée sans risque pendant l'itération et n'affectera pas l'ordre des éléments dans le hachage.