QMapIterator Class

QMap<int, QWidget*> map;
//...
QMapIterator<int, QWidget*> i(map);
while (i.hasNext()) {
    i.next();
    qDebug() << i.key() << ": " << i.value();
}

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

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

Dokumentation zu den Mitgliedsfunktionen

QMapIterator::QMapIterator(const QMap<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 QMapIterator::findNext(const T &value)

Sucht nach „ value “ beginnend an 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 nach dem Aufruf value gefunden, wird der Iterator direkt hinter dem entsprechenden Element positioniert; andernfalls wird der Iterator am Ende des Containers positioniert.

Siehe auch findPrevious().

bool QMapIterator::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 QMapIterator::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 QMapIterator::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 &QMapIterator::key() const

Gibt den Schlüssel des letzten Elements zurück, das mithilfe einer der Durchlauffunktionen (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().

QMapIterator<Key, T>::Item QMapIterator::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()`.

QMapIterator<Key, T>::Item QMapIterator::peekNext() const

Gibt das nächste Element zurück, ohne den Iterator zu verschieben.

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()`, ` next()` und ` peekPrevious()`.

QMapIterator<Key, T>::Item QMapIterator::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 zu erhalten, und „ value()“, um den Wert zu erhalten.

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

QMapIterator<Key, T>::Item QMapIterator::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 für einen Iterator, der sich am Anfang des Containers befindet, führt zu undefinierten Ergebnissen.

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

void QMapIterator::toBack()

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

Siehe auch toFront() und previous().

void QMapIterator::toFront()

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

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

const T &QMapIterator::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().

QMapIterator<Key, T> &QMapIterator::operator=(const QMap<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().