QLinkedListIterator Class
template <typename T> class QLinkedListIteratorLa classe `QLinkedListIterator` fournit un itérateur `const` de type Java pour ` QLinkedList`. En savoir plus...
| En-tête : | #include <QLinkedListIterator> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core5Compat) target_link_libraries(mytarget PRIVATE Qt6::Core5Compat) |
| qmake : | QT += core5compat |
Fonctions publiques
| QLinkedListIterator(const QLinkedList<T> &list) | |
| bool | findNext(const T &value) |
| bool | findPrevious(const T &value) |
| bool | hasNext() const |
| bool | hasPrevious() const |
| const T & | next() |
| const T & | peekNext() const |
| const T & | peekPrevious() const |
| const T & | previous() |
| void | toBack() |
| void | toFront() |
| QLinkedListIterator<T> & | operator=(const QLinkedList<T> &list) |
Description détaillée
QLinkedList dispose à la fois d'itérateurs de type Java et d'itérateurs de type STL. Les itérateurs de type Java sont plus abstraits et plus faciles à utiliser que ceux de type STL ; en revanche, ils sont légèrement moins performants.
QLinkedListIterator<T> vous permet de parcourir une liste QLinkedList<T>, où T est le type des éléments. Si vous souhaitez modifier la liste au fur et à mesure de son parcours, utilisez plutôt QMutableLinkedListIterator<T>.
Le constructeur de QLinkedListIterator prend une ` QLinkedList ` en argument. Une fois instancié, l’itérateur se trouve tout au début de la liste (avant le premier élément). Voici comment parcourir tous les éléments de manière séquentielle :
QLinkedList<float> list;
...
QLinkedListIterator<float> i(list);
while (i.hasNext())
qDebug() << i.next();La fonction next() renvoie l'élément suivant de la liste et fait avancer l'itérateur. Contrairement aux itérateurs de type STL, les itérateurs de type Java pointent entre les éléments plutôt que directement vers ceux-ci. Le premier appel à ` next()` fait avancer l'itérateur jusqu'à 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 jusqu'à 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.

Voici comment parcourir les éléments dans l’ordre inverse :
QLinkedListIterator<float> i(list);
i.toBack();
while (i.hasPrevious())
qDebug() << i.previous();Si vous souhaitez rechercher toutes les occurrences d'une valeur donnée, utilisez les fonctions ` findNext()` ou ` findPrevious()` dans une boucle.
Il est possible d’utiliser plusieurs itérateurs sur la même liste. Si la liste est modifiée alors qu’un QLinkedListIterator est actif, celui-ci continuera à parcourir la liste d’origine, en ignorant la copie modifiée.
Voir également QMutableLinkedListIterator et QLinkedList::const_iterator.
Documentation des fonctions membres
QLinkedListIterator::QLinkedListIterator(const QLinkedList<T> &list)
Crée un itérateur permettant de parcourir list. L'itérateur est positionné en tête de la liste (avant le premier élément).
Voir aussi operator=().
bool QLinkedListIterator::findNext(const T &value)
Recherche « value » à partir de la position actuelle de l'itérateur vers l'avant. Renvoie « true » si « value » est trouvé ; sinon, renvoie « 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é à la fin du conteneur.
Voir également findPrevious().
bool QLinkedListIterator::findPrevious(const T &value)
Recherche « value » en remontant depuis la position actuelle de l’itérateur. Renvoie « true » si « value » est trouvé ; sinon, renvoie « false ».
Après l'appel, si value a été trouvé, l'itérateur est positionné juste avant l'élément correspondant ; sinon, l'itérateur est positionné au début du conteneur.
Voir également findNext().
bool QLinkedListIterator::hasNext() const
Renvoie ` true ` s'il reste au moins un élément avant l'itérateur, c'est-à-dire si l'itérateur ne se trouve pas à la fin du conteneur ; sinon, renvoie ` false`.
Voir également hasPrevious() et next().
bool QLinkedListIterator::hasPrevious() const
Renvoie ` true ` s'il reste au moins un élément derrière l'itérateur, c'est-à-dire si l'itérateur ne se trouve pas en tête du conteneur ; sinon, renvoie ` false`.
Voir également hasNext() et previous().
const T &QLinkedListIterator::next()
Renvoie l'élément suivant et fait avancer l'itérateur d'une position.
L'appel de cette fonction sur un itérateur situé à la fin du conteneur donne lieu à des résultats indéfinis.
Voir également hasNext(), peekNext() et previous().
const T &QLinkedListIterator::peekNext() const
Renvoie l'élément suivant sans déplacer l'itérateur.
L'appel de cette fonction sur un itérateur situé à la fin du conteneur donne lieu à des résultats indéfinis.
Voir également hasNext(), next() et peekPrevious().
const T &QLinkedListIterator::peekPrevious() const
Renvoie l'élément précédent sans déplacer l'itérateur.
L'appel de cette fonction sur un itérateur situé au début du conteneur donne lieu à des résultats indéfinis.
Voir également hasPrevious(), previous() et peekNext().
const T &QLinkedListIterator::previous()
Renvoie l'élément précédent et fait reculer l'itérateur d'une position.
L'appel de cette fonction sur un itérateur situé au début du conteneur entraîne des résultats indéfinis.
Voir également hasPrevious(), peekPrevious() et next().
void QLinkedListIterator::toBack()
Déplace l'itérateur à la fin du conteneur (après le dernier élément).
Voir également toFront() et previous().
void QLinkedListIterator::toFront()
Déplace l'itérateur au début du conteneur (avant le premier élément).
Voir également toBack() et next().
QLinkedListIterator<T> &QLinkedListIterator::operator=(const QLinkedList<T> &list)
Fait en sorte que l'itérateur opère sur list. L'itérateur est placé en tête de la liste (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.