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 der Mitgliedsfunktionen

QMapIterator::QMapIterator(const QMap<Key, T> &map)

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

Siehe auch operator=().

QMapIterator<Key, T> &QMapIterator::operator=(const QMap<Key, T> &map)

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

Siehe auch toFront() und toBack().

void QMapIterator::toFront()

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

Siehe auch toBack() und next().

void QMapIterator::toBack()

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

Siehe auch toFront() und previous().

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

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

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

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 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 auf einen Iterator, der sich am Ende des Containers befindet, führt zu undefinierten Ergebnissen.

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

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

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 auf einen Iterator, der sich am Anfang des Containers befindet, führt zu undefinierten Ergebnissen.

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

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 auf einen Iterator, der sich am Anfang des Containers befindet, führt zu undefinierten Ergebnissen.

Siehe auch hasPrevious(), previous(), und peekNext().

const T &QMapIterator::value() const

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

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

Siehe auch key().

const Key &QMapIterator::key() const

Gibt den Schlüssel des letzten Elements zurück, das mit einer der Traversalfunktionen (next(), previous(), findNext(), findPrevious()) übersprungen wurde.

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

Siehe auch value().

bool QMapIterator::findNext(const T &value)

Sucht nach value ab der aktuellen Iteratorposition vorwärts. Gibt true zurück, wenn ein (Schlüssel, Wert)-Paar mit dem Wert value gefunden wird; andernfalls false.

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

Siehe auch findPrevious().

bool QMapIterator::findPrevious(const T &value)

Sucht ab der aktuellen Iteratorposition rückwärts nach value. Gibt true zurück, wenn ein (Schlüssel, Wert)-Paar mit dem Wert value gefunden wird; andernfalls false.

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

Siehe auch findNext().