QHash::const_iterator Class

Description détaillée

QHash<Key, T>::const_iterator vous permet d'itérer sur un QHash. Si vous souhaitez modifier le QHash pendant que vous l'itérez, vous devez utiliser QHash::iterator à la place. Il est généralement conseillé d'utiliser QHash::const_iterator sur un QHash non-const également, à moins que vous n'ayez besoin de modifier le QHash par l'intermédiaire de 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 QHash::const_iterator crée un itérateur non initialisé. Vous devez l'initialiser à l'aide d'une fonction QHash comme QHash::cbegin(), QHash::cend() ou QHash::constFind() avant de pouvoir commencer l'itération. Voici une boucle typique qui imprime 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 classe ses éléments par clé, QHash stocke ses éléments dans un ordre arbitraire. La seule garantie est que les éléments qui partagent 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écente à la valeur la moins récente.

Plusieurs itérateurs peuvent être utilisés sur le même hachage. Toutefois, il faut savoir que toute modification effectuée directement sur le site QHash (insertion et suppression d'éléments) peut rendre les itérateurs invalides.

L'insertion d'éléments dans le hachage ou l'appel à des 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 le site QHash n'a pas à augmenter/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 cependant utiliser en toute sécurité des itérateurs pour supprimer des entrées de la table de hachage à l'aide de la méthode QHash::erase(). Cette fonction peut être appelée en toute sécurité pendant l'itération et n'affectera pas l'ordre des éléments dans la table de hachage.