QLinkedListIterator Class
template <typename T> class QLinkedListIteratorDie Klasse „QLinkedListIterator“ stellt einen „const“-Iterator im Java-Stil für „ QLinkedList “ bereit. Mehr...
| Header: | #include <QLinkedListIterator> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core5Compat) target_link_libraries(mytarget PRIVATE Qt6::Core5Compat) |
| qmake: | QT += core5compat |
Öffentliche Funktionen
| 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) |
Ausführliche Beschreibung
QLinkedList verfügt sowohl über Iteratoren im Java-Stil als auch über Iteratoren im STL-Stil. Die Iteratoren im Java-Stil sind abstrakter und einfacher zu verwenden als die Iteratoren im STL-Stil; andererseits sind sie etwas weniger effizient.
Mit `QLinkedListIterator<T>` können Sie eine ` QLinkedList<T>` durchlaufen, wobei ` T ` der Elementtyp ist. Wenn Sie die Liste während des Durchlaufs ändern möchten, verwenden Sie stattdessen ` QMutableLinkedListIterator<T>`.
Der Konstruktor von `QLinkedListIterator` nimmt eine ` QLinkedList ` als Argument entgegen. Nach der Initialisierung befindet sich der Iterator ganz am Anfang der Liste (vor dem ersten Element). So durchlaufen Sie alle Elemente nacheinander:
QLinkedList<float> list;
...
QLinkedListIterator<float> i(list);
while (i.hasNext())
qDebug() << i.next();Die Funktion ` next()` gibt das nächste Element der Liste zurück und verschiebt den Iterator um ein Element weiter. Im Gegensatz zu Iteratoren im STL-Stil verweisen Iteratoren im Java-Stil nicht direkt auf Elemente, sondern auf die Position zwischen zwei Elementen. Der erste Aufruf von ` next()` verschiebt den Iterator an die Position zwischen dem ersten und dem zweiten Element und gibt das erste Element zurück; der zweite Aufruf von ` next()` verschiebt den Iterator an die Position zwischen dem zweiten und dem dritten Element und gibt das zweite Element zurück; und so weiter.
So durchlaufen Sie die Elemente in umgekehrter Reihenfolge:
QLinkedListIterator<float> i(list);
i.toBack();
while (i.hasPrevious())
qDebug() << i.previous();Wenn Sie alle Vorkommen eines bestimmten Werts finden möchten, verwenden Sie in einer Schleife ` findNext()` oder ` findPrevious()`.
Es können mehrere Iteratoren für dieselbe Liste verwendet werden. Wird die Liste geändert, während ein `QLinkedListIterator` aktiv ist, durchläuft der `QLinkedListIterator` weiterhin die ursprüngliche Liste und ignoriert die geänderte Kopie.
Siehe auch QMutableLinkedListIterator und QLinkedList::const_iterator.
Dokumentation zu den Mitgliedsfunktionen
QLinkedListIterator::QLinkedListIterator(const QLinkedList<T> &list)
Erstellt einen Iterator zum Durchlaufen von list. Der Iterator wird so gesetzt, dass er sich am Anfang der Liste befindet (vor dem ersten Element).
Siehe auch operator=().
bool QLinkedListIterator::findNext(const T &value)
Sucht nach „ value “ ausgehend von der aktuellen Iteratorposition in Vorwärtsrichtung. Gibt „ true “ zurück, wenn „ value “ gefunden wird; andernfalls wird „ false “ zurückgegeben.
Wurde nach dem Aufruf „ value “ gefunden, wird der Iterator direkt hinter dem übereinstimmenden Element positioniert; andernfalls wird der Iterator am Ende des Containers positioniert.
Siehe auch findPrevious().
bool QLinkedListIterator::findPrevious(const T &value)
Sucht nach „ value “ ausgehend von der aktuellen Iteratorposition rückwärts. Gibt „ true “ zurück, wenn „ value “ gefunden wird; andernfalls wird „false“ zurückgegeben.
Wurde nach dem Aufruf „ value “ gefunden, wird der Iterator direkt vor dem entsprechenden Element positioniert; andernfalls wird der Iterator an den Anfang des Containers gesetzt.
Siehe auch findNext().
bool QLinkedListIterator::hasNext() const
Gibt „ true “ zurück, wenn sich mindestens ein Element vor dem Iterator befindet, d. h., der Iterator befindet sich nicht am Ende des Containers; andernfalls wird „ false “ zurückgegeben.
Siehe auch ` hasPrevious()` und ` next()`.
bool QLinkedListIterator::hasPrevious() const
Gibt „ true “ zurück, wenn sich mindestens ein Element hinter dem Iterator befindet, d. h. der Iterator befindet sich nicht am Anfang des Containers; andernfalls wird „ false “ zurückgegeben.
Siehe auch ` hasNext()` und ` previous()`.
const T &QLinkedListIterator::next()
Gibt das nächste Element zurück und verschiebt den Iterator um eine Position weiter.
Der Aufruf dieser Funktion für einen Iterator, der sich am Ende des Containers befindet, führt zu undefinierten Ergebnissen.
Siehe auch hasNext(), peekNext() und previous().
const T &QLinkedListIterator::peekNext() const
Gibt das nächste Element zurück, ohne den Iterator zu verschieben.
Der Aufruf dieser Funktion für einen Iterator, der sich am Ende des Containers befindet, führt zu undefinierten Ergebnissen.
Siehe auch hasNext(), next() und peekPrevious().
const T &QLinkedListIterator::peekPrevious() const
Gibt das vorherige Element zurück, ohne den Iterator zu verschieben.
Der Aufruf dieser Funktion für einen Iterator, der sich am Anfang des Containers befindet, führt zu undefinierten Ergebnissen.
Siehe auch hasPrevious(), previous() und peekNext().
const T &QLinkedListIterator::previous()
Gibt das vorherige Element zurück und verschiebt den Iterator um eine Position zurück.
Der Aufruf dieser Funktion für einen Iterator, der sich am Anfang des Containers befindet, führt zu undefinierten Ergebnissen.
Siehe auch hasPrevious(), peekPrevious() und next().
void QLinkedListIterator::toBack()
Verschiebt den Iterator an das Ende des Containers (hinter das letzte Element).
Siehe auch „ toFront()“ und „ previous()“.
void QLinkedListIterator::toFront()
Verschiebt den Iterator an den Anfang des Containers (vor das erste Element).
Siehe auch „ toBack()“ und „ next()“.
QLinkedListIterator<T> &QLinkedListIterator::operator=(const QLinkedList<T> &list)
Stellt sicher, dass der Iterator auf list arbeitet. Der Iterator wird so gesetzt, dass er sich am Anfang der Liste befindet (vor dem ersten Element).
© 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.
