QSetIterator Class
template <typename T> class QSetIteratorLa classe QSetIterator fournit un itérateur constant de style Java pour QSet. Plus...
| En-tête : | #include <QSetIterator> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
Fonctions publiques
| QSetIterator(const QSet<T> &set) | |
| bool | findNext(const T &value) |
| bool | hasNext() const |
| const T & | next() |
| const T & | peekNext() const |
| void | toBack() |
| void | toFront() |
| QSetIterator<T> & | operator=(const QSet<T> &set) |
Description détaillée
QSet possède à la fois des itérateurs de style Java et des itérateurs de style STL. Les itérateurs de style STL sont plus efficaces et devraient être préférés.
QSetIterator<T> vous permet d'itérer sur un QSet<T>. Si vous souhaitez modifier l'ensemble au fur et à mesure de l'itération, utilisez plutôt QMutableSetIterator<T>.
Le constructeur prend un QSet comme argument. Après la construction, l'itérateur est situé au tout début de l'ensemble (avant le premier élément). Voici comment itérer sur tous les éléments de manière séquentielle :
QSet<QString> set; //... QSetIterator<QString> i(set); while (i.hasNext()) QString f = i.next();
La fonction next() renvoie l'élément suivant de l'ensemble et fait avancer l'itérateur. Contrairement aux itérateurs de style STL, les itérateurs de style Java pointent entre les éléments plutôt que directement sur les éléments. Le premier appel à next() fait avancer l'itérateur à la position située entre le premier et le deuxième élément, et renvoie le premier élément ; le deuxième appel à next() fait avancer l'itérateur à la position située entre le deuxième et le troisième élément, et renvoie le deuxième élément ; et ainsi de suite.
Si vous souhaitez trouver toutes les occurrences d'une valeur particulière, utilisez findNext() dans une boucle.
Plusieurs itérateurs peuvent être utilisés sur le même ensemble. Si l'ensemble est modifié alors qu'un QSetIterator est actif, le QSetIterator continuera à itérer sur l'ensemble original, en ignorant la copie modifiée.
Voir également QMutableSetIterator et QSet::const_iterator.
Documentation des fonctions membres
QSetIterator::QSetIterator(const QSet<T> &set)
Construit un itérateur pour parcourir set. L'itérateur est placé au début de l'ensemble (avant le premier élément).
Voir aussi operator=().
bool QSetIterator::findNext(const T &value)
Recherche value à partir de la position actuelle de l'itérateur. Renvoie true si value est trouvé, sinon false.
Après l'appel, si value a été trouvé, l'itérateur est positionné juste après l'élément correspondant ; sinon, l'itérateur est positionné à l'arrière du conteneur.
bool QSetIterator::hasNext() const
Renvoie true s'il y a au moins un élément avant l'itérateur, c'est-à-dire que l'itérateur n' est pas à l'arrière du conteneur ; sinon, renvoie false.
Voir aussi next().
const T &QSetIterator::next()
Renvoie l'élément suivant et fait avancer l'itérateur d'une position.
L'appel de cette fonction à un itérateur situé à l'arrière du conteneur conduit à des résultats indéfinis.
Voir aussi hasNext() et peekNext().
const T &QSetIterator::peekNext() const
Renvoie l'élément suivant sans déplacer l'itérateur.
L'appel de cette fonction à un itérateur situé à l'arrière du conteneur conduit à des résultats indéfinis.
Voir aussi hasNext() et next().
void QSetIterator::toBack()
Déplace l'itérateur à l'arrière du conteneur (après le dernier élément).
Voir également toFront().
void QSetIterator::toFront()
Déplace l'itérateur à l'avant du conteneur (avant le premier élément).
Voir aussi toBack() et next().
QSetIterator<T> &QSetIterator::operator=(const QSet<T> &set)
Fait fonctionner l'itérateur sur set. L'itérateur est placé au début de l'ensemble (avant le premier élément).
© 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.
