QKeyValueIterator Class
template <typename Key, typename T, typename Iterator, typename Traits> class QKeyValueIteratorItérateur parcourant les paires clé/valeur d'un conteneur associatif. En savoir plus...
| En-tête : | #include <QKeyValueIterator> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
Fonctions publiques
| QKeyValueIterator() | |
| QKeyValueIterator(Iterator o) | |
| Iterator | base() const |
| std::pair<Key, T> | operator*() const |
| QKeyValueIterator<Key, T, Iterator, Traits> & | operator++() |
| QKeyValueIterator<Key, T, Iterator, Traits> | operator++(int) |
| QKeyValueIterator<Key, T, Iterator, Traits> & | operator--() |
| QKeyValueIterator<Key, T, Iterator, Traits> | operator--(int) |
| QKeyValueIterator<Key, T, Iterator, Traits>::pointer | operator->() const |
Éléments non membres associés
| bool | operator!=(QKeyValueIterator<Key, T, Iterator, Traits> lhs, QKeyValueIterator<Key, T, Iterator, Traits> rhs) |
| bool | operator==(QKeyValueIterator<Key, T, Iterator, Traits> lhs, QKeyValueIterator<Key, T, Iterator, Traits> rhs) |
Description détaillée
La classe QKeyValueIterator fournit un itérateur de type STL permettant de renvoyer des paires clé/valeur à partir de conteneurs associatifs tels que QHash et QMap. Le paramètre de modèle Key spécifie le type de clé, T spécifie le type de valeur, Iterator correspond au type d’itérateur sous-jacent et Traits spécifie les traits de l’itérateur. Il prend en charge la même API que les conteneurs associatifs de la STL, c’est-à-dire l’obtention d’une paire clé/valeur lors de l’itération sur le conteneur.
Cela permettra une meilleure interopérabilité entre QMap, QHash et leurs équivalents, ainsi que les algorithmes de type STL.
Avertissement : les itérateurs sur les conteneurs à partage implicite 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 ».
Documentation des fonctions membres
[default] QKeyValueIterator::QKeyValueIterator()
Crée un QKeyValueIterator par défaut.
[explicit constexpr noexcept(...)] QKeyValueIterator::QKeyValueIterator(Iterator o)
Crée un QKeyValueIterator à partir de o.
Remarque : cette fonction est de type « noexcept » lorsque ` std::is_nothrow_move_constructible<Iterator>::value ` est de type ` true`.
Iterator QKeyValueIterator::base() const
Renvoie l'itérateur sous-jacent sur lequel repose c QKeyValueIterator.
std::pair<Key, T> QKeyValueIterator::operator*() const
Renvoie l'entrée actuelle sous forme de paire.
QKeyValueIterator<Key, T, Iterator, Traits> &QKeyValueIterator::operator++()
L'opérateur « préfixe- ++ » (++i) fait avancer l'itérateur vers l'élément suivant du conteneur et renvoie l'itérateur.
Remarque : faire avancer l'itérateur au-delà de la méthode `end()` de son conteneur entraîne un comportement indéfini.
Voir également operator--().
QKeyValueIterator<Key, T, Iterator, Traits> QKeyValueIterator::operator++(int)
L'opérateur postfixe « ++ » (i++) fait avancer l'itérateur vers l'élément suivant du conteneur et renvoie la valeur précédente de l'itérateur.
Remarque : faire avancer l'itérateur au-delà de la méthode `end()` de son conteneur entraîne un comportement indéfini.
Il s'agit d'une fonction surchargée.
QKeyValueIterator<Key, T, Iterator, Traits> &QKeyValueIterator::operator--()
L'opérateur préfixe c{–} (--i) fait reculer l'itérateur jusqu'à l'élément précédent du conteneur et renvoie l'itérateur.
Remarque : le fait de faire reculer un itérateur jusqu'à un point situé avant l'appel à `begin()` de son conteneur entraîne un comportement indéfini.
Voir également operator++().
QKeyValueIterator<Key, T, Iterator, Traits> QKeyValueIterator::operator--(int)
L'opérateur postfixe c{–} (i--) fait reculer l'itérateur jusqu'à l'élément précédent du conteneur et renvoie la valeur précédente de l'itérateur.
Remarque : faire reculer un itérateur jusqu’à une position antérieure à la fonction `begin()` de son conteneur entraîne un comportement indéfini.
Il s'agit d'une fonction surchargée.
QKeyValueIterator<Key, T, Iterator, Traits>::pointer QKeyValueIterator::operator->() const
Renvoie l'entrée courante sous la forme d'un objet de type pointeur vers la paire.
Voir aussi operator*().
Éléments non membres associés
[noexcept] bool operator!=(QKeyValueIterator<Key, T, Iterator, Traits> lhs, QKeyValueIterator<Key, T, Iterator, Traits> rhs)
Renvoie ` true ` si ` rhs ` pointe vers un élément différent de ` lhs ` ; sinon, renvoie ` false`.
Voir également operator==().
[noexcept] bool operator==(QKeyValueIterator<Key, T, Iterator, Traits> lhs, QKeyValueIterator<Key, T, Iterator, Traits> rhs)
Renvoie ` true ` si ` rhs ` pointe vers le même élément que ` lhs ` ; 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.
