Auf dieser Seite

QMultiMapIterator Class

template <typename Key, typename T> class QMultiMapIterator

Die Klasse `QMultiMapIterator` stellt einen Iterator im Java-Stil für ` QMultiMap` bereit. ` QMultiMap ` verfügt sowohl über Iteratoren im Java-Stil als auch über Iteratoren im STL-Stil. Iteratoren im STL-Stil sind effizienter und sollten bevorzugt werden. Der Template-Parameter ` Key ` gibt den Schlüsseltyp der Map an, und ` T ` gibt den Werttyp an. Mehr...

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

Öffentliche Funktionen

QMultiMapIterator(const QMultiMap<Key, T> &map)
bool findNext(const T &value)
bool findPrevious(const T &value)
bool hasNext() const
bool hasPrevious() const
const Key &key() const
QMultiMapIterator<Key, T>::Item next()
QMultiMapIterator<Key, T>::Item peekPrevious() const
QMultiMapIterator<Key, T>::Item previous()
void toBack()
void toFront()
const T &value() const
QMultiMapIterator<Key, T> &operator=(const QMultiMap<Key, T> &map)

Ausführliche Beschreibung

Mit `QMultiMapIterator<Key, T>` können Sie eine ` QMultiMap` durchlaufen. Wenn Sie die Map während des Durchlaufs ändern möchten, verwenden Sie stattdessen ` QMutableMultiMapIterator `.

Der Konstruktor von `QMultiMapIterator` nimmt eine ` QMultiMap ` als Argument entgegen. Nach der Initialisierung befindet sich der Iterator ganz am Anfang der Map (vor dem ersten Element). So durchlaufen Sie alle Elemente nacheinander:

QMultiMap<int, QWidget*> multimap;
//...
QMultiMapIterator<int, QWidget*> i(multimap);
while (i.hasNext()) {
    i.next();
    qDebug() << i.key() << ": " << i.value();
}

Die Funktion ` next()` gibt das nächste Element in der Map zurück und schiebt den Iterator weiter. Die Funktionen ` key()` und ` value()` geben den Schlüssel und den Wert des zuletzt übersprungenen Elements zurück.

Im Gegensatz zu Iteratoren im STL-Stil verweisen Iteratoren im Java-Stil nicht direkt auf Elemente, sondern auf die Position zwischen ihnen. 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 so weiter.

Positionen des Iterators zwischen den Elementen A, B, C, D

So durchlaufen Sie die Elemente in umgekehrter Reihenfolge:

QMultiMapIterator<int, QWidget*> i(multimap);
i.toBack();
while (i.hasPrevious()) {
    i.previous();
    qDebug() << i.key() << ": " << i.value();
}

Wenn Sie alle Vorkommen eines bestimmten Werts finden möchten, verwenden Sie „ findNext()“ oder „ findPrevious()“ in einer Schleife. Zum Beispiel:

QMultiMapIterator<int, QWidget*> i(multimap);
while (i.findNext(widget)) {
    qDebug() << "Found widget " << widget << " under key "
           << i.key();
}

Für dieselbe Map können mehrere Iteratoren verwendet werden. Wird die Map geändert, während ein QMultiMapIterator aktiv ist, setzt der QMultiMapIterator die Iteration über die ursprüngliche Map fort und ignoriert die geänderte Kopie.

Siehe auch QMutableMultiMapIterator.

Dokumentation zu den Mitgliedsfunktionen

QMultiMapIterator::QMultiMapIterator(const QMultiMap<Key, T> &map)

Erstellt einen Iterator zum Durchlaufen von map. Der Iterator wird so gesetzt, dass er sich am Anfang der Map befindet (vor dem ersten Element).

Siehe auch operator=().

bool QMultiMapIterator::findNext(const T &value)

Sucht nach „ value “ ausgehend von der aktuellen Iteratorposition in Vorwärtsrichtung. Gibt „ true “ zurück, wenn ein (Schlüssel, Wert)-Paar mit dem Wert „ value “ gefunden wird; andernfalls wird „ false “ zurückgegeben.

Wurde „ value “ gefunden, wird der Iterator nach dem Aufruf direkt hinter dem entsprechenden Element positioniert; andernfalls wird der Iterator am Ende des Containers positioniert.

Siehe auch findPrevious().

bool QMultiMapIterator::findPrevious(const T &value)

Sucht nach „ value “ ausgehend von der aktuellen Iteratorposition rückwärts. Gibt „ true “ zurück, wenn ein (Schlüssel, Wert)-Paar mit dem Wert „ 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 QMultiMapIterator::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 QMultiMapIterator::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 Key &QMultiMapIterator::key() const

Gibt den Schlüssel des letzten Elements zurück, das mithilfe einer der Durchlauf-Funktionen (next(), previous(), findNext(), findPrevious()) übersprungen wurde.

Nach einem Aufruf von ` next()` oder ` findNext()` ist ` key()` gleichbedeutend mit ` peekPrevious()`. `key()`. Nach einem Aufruf von ` previous()` oder ` findPrevious()` ist ` key()` gleichbedeutend mit `peekNext()`. `key()`.

Siehe auch value().

QMultiMapIterator<Key, T>::Item QMultiMapIterator::next()

Gibt das nächste Element zurück und verschiebt den Iterator um eine Position weiter.

Rufen Sie „ key()“ für den Rückgabewert auf, um den Schlüssel des Elements zu erhalten, und „ value()“, um den Wert zu erhalten.

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()`.

QMultiMapIterator<Key, T>::Item QMultiMapIterator::peekPrevious() const

Gibt das vorherige Element zurück, ohne den Iterator zu verschieben.

Rufen Sie „ key()“ für den Rückgabewert auf, um den Schlüssel des Elements abzurufen, und „ value()“, um den Wert abzurufen.

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()`.

QMultiMapIterator<Key, T>::Item QMultiMapIterator::previous()

Gibt das vorherige Element zurück und verschiebt den Iterator um eine Position zurück.

Rufen Sie „ key()“ für den Rückgabewert auf, um den Schlüssel des Elements zu erhalten, und „ value()“, um den Wert zu erhalten.

Der Aufruf dieser Funktion auf einen Iterator, der sich am Anfang des Containers befindet, führt zu undefinierten Ergebnissen.

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

void QMultiMapIterator::toBack()

Verschiebt den Iterator an das Ende des Containers (hinter das letzte Element).

Siehe auch „ toFront()“ und „ previous()“.

void QMultiMapIterator::toFront()

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

Siehe auch „ toBack()“ und „ next()“.

const T &QMultiMapIterator::value() const

Gibt den Wert des letzten Elements zurück, das mithilfe einer der Durchlauffunktionen (next(), previous(), findNext(), findPrevious()) übersprungen wurde.

Nach einem Aufruf von ` next()` oder ` findNext()` ist ` value()` gleichbedeutend mit ` peekPrevious()`. `value()`. Nach einem Aufruf von ` previous()` oder ` findPrevious()` ist ` value()` gleichbedeutend mit `peekNext()`. `value()`.

Siehe auch key().

QMultiMapIterator<Key, T> &QMultiMapIterator::operator=(const QMultiMap<Key, T> &map)

Stellt sicher, dass der Iterator auf map arbeitet. Der Iterator wird so gesetzt, dass er sich am Anfang der Map befindet (vor dem ersten Element).

Siehe auch toFront() und toBack().

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