QSetIterator Class

template <typename T> class QSetIterator

Die Klasse QSetIterator bietet einen Konst-Iterator im Java-Stil für QSet. Mehr...

Kopfzeile:	`#include <QSetIterator>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Core)` `target_link_libraries(mytarget PRIVATE Qt6::Core)`
qmake:	`QT += core`

Liste aller Mitglieder, einschließlich vererbter Mitglieder

Öffentliche Funktionen

	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)

Detaillierte Beschreibung

QSet hat sowohl Iteratoren im Java-Stil als auch Iteratoren im STL-Stil. STL-artige Iteratoren sind effizienter und sollten bevorzugt werden.

Mit QSetIterator<T> kann man über eine QSet<T> iterieren. Wenn Sie die Menge bei der Iteration verändern wollen, verwenden Sie stattdessen QMutableSetIterator<T>.

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

QSet<QString> set;
...
QSetIterator<QString> i(set);
while (i.hasNext())
    float f = i.next();

Die Funktion next() gibt das nächste Element in der Menge zurück und schaltet den Iterator weiter. 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.

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

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

Siehe auch QMutableSetIterator und QSet::const_iterator.

Dokumentation der Mitgliedsfunktionen

QSetIterator::QSetIterator(const QSet<T> &set)

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

Siehe auch operator=().

QSetIterator<T> &QSetIterator::operator=(const QSet<T> &set)

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

Siehe auch toFront() und toBack().

void QSetIterator::toFront()

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

Siehe auch toBack() und next().

bool QSetIterator::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.

bool QSetIterator::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 next().

const T &QSetIterator::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() und peekNext().

const T &QSetIterator::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() und next().

void QSetIterator::toBack()

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

Siehe auch toFront().

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