QLinkedListIterator Class

template <typename T> class QLinkedListIterator

Die Klasse QLinkedListIterator bietet einen Iterator im Java-Stil für QLinkedList. Mehr...

Kopfzeile:	`#include <QLinkedListIterator>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Core5Compat)` `target_link_libraries(mytarget PRIVATE Qt6::Core5Compat)`
qmake:	`QT += core5compat`

Liste aller Mitglieder, einschließlich vererbter Mitglieder

Ö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)

Detaillierte Beschreibung

QLinkedList hat sowohl Iteratoren im Java-Stil als auch Iteratoren im STL-Stil. Die Iteratoren im Java-Stil sind anspruchsvoller und einfacher zu verwenden als die Iteratoren im STL-Stil; auf der anderen Seite sind sie etwas weniger effizient.

QLinkedListIterator<T> erlaubt es, über eine QLinkedList<T> zu iterieren. Wenn Sie die Liste während der Iteration verändern wollen, verwenden Sie stattdessen QMutableLinkedListIterator<T>.

Der QLinkedListIterator Konstruktor nimmt ein QLinkedList als Argument. Nach der Konstruktion befindet sich der Iterator ganz am Anfang der Liste (vor dem ersten Element). So können Sie alle Elemente der Reihe nach durchlaufen:

QLinkedList<float> list;...QLinkedListIterator<Fließkomma> i(Liste);while (i.hasNext())    qDebug() << i.next();

Die Funktion next() gibt das nächste Element in der Liste zurück und setzt den Iterator fort. Im Gegensatz zu Iteratoren im STL-Stil zeigen Iteratoren im Java-Stil zwischen Elementen und nicht direkt auf Elemente. 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, usw.

So kann man die Elemente in umgekehrter Reihenfolge durchlaufen:

QLinkedListIterator<float> i(list); i.toBack();while (i.hasPrevious())    qDebug() << i.previous();

Wenn Sie alle Vorkommen eines bestimmten Wertes finden wollen, verwenden Sie findNext() oder findPrevious() in einer Schleife.

Mehrere Iteratoren können auf dieselbe Liste angewendet werden. Wenn die Liste verändert wird, während ein QLinkedListIterator aktiv ist, iteriert der QLinkedListIterator weiter über die ursprüngliche Liste und ignoriert die veränderte Kopie.

Siehe auch QMutableLinkedListIterator und QLinkedList::const_iterator.

Dokumentation der Mitgliedsfunktionen

QLinkedListIterator::QLinkedListIterator(const QLinkedList<T> &list)

Konstruiert einen Iterator zum Durchlaufen von list. Der Iterator wird so gesetzt, dass er am Anfang der Liste steht (vor dem ersten Element).

Siehe auch operator=().

QLinkedListIterator<T> &QLinkedListIterator::operator=(const QLinkedList<T> &list)

Lässt den Iterator auf list arbeiten. Der Iterator wird so eingestellt, dass er am Anfang der Liste steht (vor dem ersten Element).

Siehe auch toFront() und toBack().

void QLinkedListIterator::toFront()

Verschiebt den Iterator an den Anfang des Containers (vor das erste Element).

Siehe auch toBack() und next().

void QLinkedListIterator::toBack()

Verschiebt den Iterator an das Ende des Containers (nach dem letzten Element).

Siehe auch toFront() und previous().

bool QLinkedListIterator::hasNext() const

Gibt true zurück, wenn sich mindestens ein Element vor dem Iterator befindet, d. h. der Iterator steht 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 steht nicht am Anfang des Containers; andernfalls wird false zurückgegeben.

Siehe auch hasNext() und previous().

bool QLinkedListIterator::findNext(const T &value)

Sucht ab der aktuellen Iteratorposition vorwärts nach value. Gibt true zurück, wenn value gefunden wird; andernfalls false.

Nach dem Aufruf wird der Iterator, falls value gefunden wurde, direkt nach dem passenden Element positioniert; andernfalls wird der Iterator am Ende des Containers positioniert.

Siehe auch findPrevious().

bool QLinkedListIterator::findPrevious(const T &value)

Sucht ab der aktuellen Iteratorposition rückwärts nach value. Gibt true zurück, wenn value gefunden wird; andernfalls wird false zurückgegeben.

Nach dem Aufruf wird der Iterator, falls value gefunden wurde, unmittelbar vor dem passenden Element positioniert; andernfalls wird der Iterator an den Anfang des Containers gesetzt.

Siehe auch findNext().

const T &QLinkedListIterator::next()

Gibt das nächste Element zurück und rückt den Iterator um eine Position vor.

Der Aufruf dieser Funktion bei einem 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 bei einem 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 bei einem 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 bei einem Iterator, der sich am Anfang des Containers befindet, führt zu undefinierten Ergebnissen.

Siehe auch hasPrevious(), peekPrevious(), und next().

© 2025 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.