QHash::key_iterator Class
class QHash::key_iteratorLa classe ` QHash::key_iterator ` fournit un itérateur `const` de type STL pour les clés d'QHash. En savoir plus...
Fonctions publiques
| key_iterator() | |
| QHash<Key, T>::const_iterator | base() const |
| bool | operator!=(QHash<Key, T>::key_iterator other) const |
| const Key & | operator*() const |
| QHash<Key, T>::key_iterator & | operator++() |
| QHash<Key, T>::key_iterator | operator++(int) |
| const Key * | operator->() const |
| bool | operator==(QHash<Key, T>::key_iterator other) const |
Description détaillée
QHash::key_iterator est essentiellement identique à QHash::const_iterator, à la différence que les opérateurs *() et ->() renvoient une clé au lieu d'une valeur.
Dans la plupart des cas, il est préférable d'utiliser QHash::iterator et QHash::const_iterator; vous pouvez facilement accéder à la clé en appelant QHash::iterator::key():
for (auto it = hash.cbegin(), end = hash.cend(); it != end; ++it) {
cout << "The key: " << it.key() << endl;
cout << "The value: " << qPrintable(it.value()) << endl;
cout << "Also the value: " << qPrintable(*it) << endl;
}Cependant, pour assurer l’interopérabilité entre les clés de QHash et les algorithmes de type STL, nous avons besoin d’un itérateur qui déréférence vers une clé plutôt que vers une valeur. Avec QHash::key_iterator, nous pouvons appliquer un algorithme à une plage de clés sans avoir à appeler QHash::keys(), ce qui est inefficace car cela nécessite une itération QHash et une allocation de mémoire pour créer un QList temporaire.
// Inefficace, la fonction keys() est coûteuse
QList<int> keys = hash.keys();
int numPrimes = std::count_if(keys.cbegin(), keys.cend(), isPrimeNumber);
qDeleteAll(hash2.keys());
// Efficace, ne nécessite aucune allocation de mémoire
int primeNums = std::count_if(hash.keyBegin(), hash.keyEnd(), isPrimeNumber);
qDeleteAll(hash2.keyBegin(), hash2.keyEnd());QHash::key_iterator est une constante, il n'est pas possible de modifier la clé.
Le constructeur par défaut de ` QHash::key_iterator ` crée un itérateur non initialisé. Vous devez l'initialiser à l'aide d'une fonction d'QHash, telle que ` QHash::keyBegin()` ou ` QHash::keyEnd()`.
Avertissement : les itérateurs sur des conteneurs implicitement partagés ne fonctionnent pas exactement comme les itérateurs STL. Vous devez éviter de copier un conteneur tant que des itérateurs sont actifs sur ce conteneur. Pour plus d’informations, consultez la section « Problème d’itérateur avec partage implicite ».
Voir également QHash::const_iterator et QHash::iterator.
Documentation des fonctions membres
[noexcept default] key_iterator::key_iterator()
Construit par défaut une instance de ` key_iterator`.
[noexcept] QHash<Key, T>::const_iterator key_iterator::base() const
Renvoie l'const_iterator e sous-jacente sur laquelle repose ce key_iterator.
[noexcept] bool key_iterator::operator!=(QHash<Key, T>::key_iterator other) const
Renvoie ` true ` si ` other ` pointe vers un élément différent de cet itérateur ; sinon, renvoie ` false`.
Voir également operator==().
[noexcept] const Key &key_iterator::operator*() const
Renvoie la clé de l'élément actuel.
[noexcept] QHash<Key, T>::key_iterator &key_iterator::operator++()
L'opérateur préfixe ++ (++i) fait avancer l'itérateur vers l'élément suivant du hachage et renvoie un itérateur pointant vers le nouvel élément courant.
L'appel de cette fonction sur QHash::keyEnd() conduit à des résultats indéfinis.
[noexcept] QHash<Key, T>::key_iterator key_iterator::operator++(int)
L'opérateur postfixe ++ (i++) fait avancer l'itérateur vers l'élément suivant du hachage et renvoie un itérateur vers l'élément précédent.
Il s'agit d'une fonction surchargée.
[noexcept] const Key *key_iterator::operator->() const
Renvoie un pointeur vers la clé de l'élément actuel.
[noexcept] bool key_iterator::operator==(QHash<Key, T>::key_iterator other) const
Renvoie « true » si « other » pointe vers le même élément que cet itérateur ; sinon, renvoie « false ».
Voir également operator!=().
© 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.
