QMultiHash::key_iterator Class
class QMultiHash::key_iteratorLa classe ` QMultiHash::key_iterator ` fournit un itérateur `const` de type STL pour les clés de ` QMultiHash `. En savoir plus...
Fonctions publiques
| key_iterator() | |
| QMultiHash<Key, T>::const_iterator | base() const |
| bool | operator!=(QMultiHash<Key, T>::key_iterator other) const |
| const Key & | operator*() const |
| QMultiHash<Key, T>::key_iterator & | operator++() |
| QMultiHash<Key, T>::key_iterator | operator++(int) |
| const Key * | operator->() const |
| bool | operator==(QMultiHash<Key, T>::key_iterator other) const |
Description détaillée
QMultiHash::key_iterator est essentiellement identique à QMultiHash::const_iterator, à la différence près 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 QMultiHash::iterator et QMultiHash::const_iterator; vous pouvez facilement accéder à la clé en appelant QMultiHash::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 QMultiHash 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 QMultiHash::key_iterator, nous pouvons appliquer un algorithme à une plage de clés sans avoir à appeler QMultiHash::keys(), ce qui est inefficace car cela nécessite une itération QMultiHash et une allocation de mémoire pour créer un objet temporaire QList.
// 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());QMultiHash::key_iterator est une constante, il n'est pas possible de modifier la clé.
Le constructeur par défaut de ` QMultiHash::key_iterator ` crée un itérateur non initialisé. Vous devez l'initialiser à l'aide d'une fonction d'QMultiHash, telle que ` QMultiHash::keyBegin()` ou ` QMultiHash::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 « QMultiHash::const_iterator » et « QMultiHash::iterator ».
Documentation sur les fonctions membres
[noexcept default] key_iterator::key_iterator()
Construit par défaut une instance de ` key_iterator`.
[noexcept] QMultiHash<Key, T>::const_iterator key_iterator::base() const
Renvoie l'const_iterator e sous-jacente sur laquelle repose cette key_iterator.
[noexcept] bool key_iterator::operator!=(QMultiHash<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] QMultiHash<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 QMultiHash::keyEnd() conduit à des résultats indéfinis.
[noexcept] QMultiHash<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==(QMultiHash<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.
