QIterator Struct
template <typename Container> struct QIteratorQIterator est une classe de modèle qui permet d'itérer sur un conteneur dans une ` QVariant`. En savoir plus...
| En-tête : | #include <QIterator> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
| Depuis : | Qt 6.0 |
| Hérite de : | QBaseIterator |
| Hérité par : | QMetaAssociation::Iterable::Iterator et QMetaSequence::Iterable::Iterator |
Fonctions publiques
| QIterator(QIterable<Container> *iterable, void *iterator) | |
| bool | operator!=(const QIterator<Container> &other) const |
| QIterator<Container> | operator+(qsizetype j) const |
| QIterator<Container> & | operator++() |
| QIterator<Container> | operator++(int) |
| QIterator<Container> & | operator+=(qsizetype j) |
| QIterator<Container> | operator-(qsizetype j) const |
| qsizetype | operator-(const QIterator<Container> &j) const |
| QIterator<Container> & | operator--() |
| QIterator<Container> | operator--(int) |
| QIterator<Container> & | operator-=(qsizetype j) |
| bool | operator==(const QIterator<Container> &other) const |
Éléments non membres associés
| QIterator<Container> | operator+(qsizetype j, const QIterator<Container> &k) |
Description détaillée
QIterator<Container> permet une itération modifiable sur un conteneur, où Container est le descripteur de métatype (soit QMetaSequence soit QMetaAssociation) qui définit les capacités d’itération du conteneur.
Un QIterator ne peut être créé qu’à partir d’une instance de QIterable, et peut être utilisé de manière similaire aux autres itérateurs de type STL. En règle générale, QIterator ne doit pas être utilisé directement, mais par l’intermédiaire de ses classes dérivées fournies par QMetaSequence::Iterable et QMetaAssociation::Iterable.
Voir également QIterable.
Documentation des fonctions membres
[explicit] QIterator::QIterator(QIterable<Container> *iterable, void *iterator)
Crée un itérateur à partir d'une instance de ` iterable ` et d'un pointeur vers un objet natif de type ` iterator`.
bool QIterator::operator!=(const QIterator<Container> &other) const
Renvoie true si other pointe vers un élément différent de cet itérateur ; sinon, renvoie false.
Voir également operator==().
QIterator<Container> QIterator::operator+(qsizetype j) const
Renvoie un itérateur pointant vers l'élément situé à j positions en avant par rapport à cet itérateur.
Voir également ` operator-()` et ` operator+=()`.
QIterator<Container> &QIterator::operator++()
L'opérateur préfixe « ++ » (++it) fait avancer l'itérateur vers l'élément suivant du conteneur et renvoie un itérateur pointant vers le nouvel élément courant.
L'appel de cette fonction sur QMetaSequence::Iterable::constEnd() conduit à des résultats indéfinis.
Voir également operator--().
QIterator<Container> QIterator::operator++(int)
L'opérateur postfixe « ++ » (it++) fait avancer l'itérateur vers l'élément suivant du conteneur et renvoie un itérateur pointant vers l'élément qui était précédemment sélectionné.
Il s'agit d'une fonction surchargée.
QIterator<Container> &QIterator::operator+=(qsizetype j)
Fait avancer l'itérateur de j éléments.
Voir également operator-=() et operator+().
QIterator<Container> QIterator::operator-(qsizetype j) const
Renvoie un itérateur vers l'élément situé à j positions en arrière par rapport à cet itérateur.
Si le conteneur spécifié dans ` QVariant ` ne prend pas en charge l’itération bidirectionnelle, l’appel de cette fonction entraîne des résultats indéfinis.
Voir également operator+(), operator-=() et QIterable::canReverseIterate().
qsizetype QIterator::operator-(const QIterator<Container> &j) const
Renvoie la distance entre les deux itérateurs.
Il s'agit d'une fonction surchargée.
Voir également operator+(), operator-=() et QIterable::canReverseIterate().
QIterator<Container> &QIterator::operator--()
L'opérateur préfixe ` -- ` (--it) désigne l'élément précédent comme élément courant et renvoie un itérateur vers ce nouvel élément courant.
L'appel de cette fonction sur QMetaSequence::Iterable::constBegin() conduit à des résultats indéfinis.
Si le conteneur dans le QVariant ne prend pas en charge l’itération bidirectionnelle, l’appel de cette fonction conduit à des résultats indéfinis.
Voir également operator++() et QIterable::canReverseIterate().
QIterator<Container> QIterator::operator--(int)
L'opérateur d'-- postfixe (it--) désigne l'élément précédent comme élément courant et renvoie un itérateur vers l'élément qui était auparavant l'élément courant.
Si le conteneur utilisé dans l'QVariant ne prend pas en charge l'itération bidirectionnelle, l'appel de cette fonction entraîne des résultats indéfinis.
Il s'agit d'une fonction surchargée.
Voir également ` QIterable::canReverseIterate()`.
QIterator<Container> &QIterator::operator-=(qsizetype j)
Fait reculer l'itérateur de j éléments.
Si le conteneur spécifié dans ` QVariant ` ne prend pas en charge l'itération bidirectionnelle, l'appel de cette fonction entraîne des résultats indéfinis.
Voir également operator+=(), operator-() et QIterable::canReverseIterate().
bool QIterator::operator==(const QIterator<Container> &other) const
Renvoie ` true ` si ` other ` pointe vers le même élément que cet itérateur ; sinon, renvoie ` false`.
Voir aussi 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.
