iterator Class

class QMap::iterator

Die Klasse QMap::iterator bietet einen STL-ähnlichen nicht-konstanten Iterator für QMap. Mehr...

Öffentliche Typen

iterator_category

Öffentliche Funktionen

	iterator()
const Key &	key() const
T &	value() const
T &	operator*() const
QMap<Key, T>::iterator &	operator++()
QMap<Key, T>::iterator	operator++(int)
QMap<Key, T>::iterator &	operator--()
QMap<Key, T>::iterator	operator--(int)
T *	operator->() const

bool	operator!=(const QMap<Key, T>::iterator &lhs, const QMap<Key, T>::iterator &rhs)
bool	operator==(const QMap<Key, T>::iterator &lhs, const QMap<Key, T>::iterator &rhs)

Detaillierte Beschreibung

QMap<Schlüssel, T>::Iterator ermöglicht es, über eine QMap zu iterieren und den Wert (aber nicht den Schlüssel) zu ändern, der unter einem bestimmten Schlüssel gespeichert ist. Wenn Sie über eine const QMap iterieren wollen, sollten Sie QMap::const_iterator verwenden. Es ist im Allgemeinen eine gute Praxis, QMap::const_iterator auch für eine Nicht-Konstante QMap zu verwenden, es sei denn, Sie müssen die QMap durch den Iterator ändern. Konst-Iteratoren sind etwas schneller und können die Lesbarkeit des Codes verbessern.

Der Standard-Konstruktor QMap::iterator erzeugt einen nicht initialisierten Iterator. Sie müssen ihn mit einer QMap Funktion wie QMap::begin(), QMap::end() oder QMap::find() initialisieren, bevor Sie mit der Iteration beginnen können. Hier ist eine typische Schleife, die alle in einer Map gespeicherten Paare (Schlüssel, Wert) ausgibt:

QMap<QString, int> map;
map.insert("January", 1);
map.insert("February", 2);
...
map.insert("December", 12);

for (auto i = map.cbegin(), end = map.cend(); i != end; ++i)
    cout << qPrintable(i.key()) << ": " << i.value() << endl;

Im Gegensatz zu QHash, das seine Elemente in beliebiger Reihenfolge speichert, speichert QMap seine Elemente nach Schlüssel geordnet.

Hier ist ein Beispiel, das jeden in QMap gespeicherten Wert um 2 erhöht:

for (auto i = map.begin(), end = map.end(); i != end; ++i)
    i.value() += 2;

Um Elemente aus einer QMap zu entfernen, können Sie erase_if(QMap<Schlüssel, T> &map, Prädikat pred) verwenden:

erase_if(map, [](const QMap<QString, int>::iterator it) { return it.value() > 10; });

Mehrere Iteratoren können auf dieselbe Map angewendet werden. Wenn Sie Elemente zur Map hinzufügen, bleiben die vorhandenen Iteratoren gültig. Wenn Sie Elemente aus der Map entfernen, werden Iteratoren, die auf die entfernten Elemente zeigen, zu Dangling-Iteratoren.

Warnung: Iteratoren auf implizit gemeinsam genutzten Containern funktionieren nicht genau wie STL-Iteratoren. Sie sollten es vermeiden, einen Container zu kopieren, während Iteratoren auf diesem Container aktiv sind. Für weitere Informationen lesen Sie Implizite gemeinsame Nutzung Iterator Problem.

Siehe auch QMap::const_iterator, QMap::key_iterator, und QMap::key_value_iterator.

Dokumentation der Mitgliedstypen

`[alias]` iterator::iterator_category

Ein Synonym für std::bidirectional_iterator_tag, das anzeigt, dass dieser Iterator ein bidirektionaler Iterator ist.

Dokumentation der Mitgliedsfunktionen

iterator::iterator()

Konstruiert einen uninitialisierten Iterator.

Funktionen wie key(), value() und operator++() dürfen nicht mit einem nicht initialisierten Iterator aufgerufen werden. Verwenden Sie operator=(), um ihm einen Wert zuzuweisen, bevor Sie ihn verwenden.

Siehe auch QMap::begin() und QMap::end().

const Key &iterator::key() const

Gibt den Schlüssel des aktuellen Elements als konstante Referenz zurück.

Es gibt keine direkte Möglichkeit, den Schlüssel eines Elements durch einen Iterator zu ändern, obwohl dies durch den Aufruf von QMap::erase() gefolgt von QMap::insert() möglich ist.

Siehe auch value().

T &iterator::value() const

Gibt einen veränderbaren Verweis auf den Wert des aktuellen Elements zurück.

Sie können den Wert eines Elements ändern, indem Sie z. B. value() auf der linken Seite einer Zuweisung verwenden:

if (i.key() == "Hello")
    i.value() = "Bonjour";

Siehe auch key() und operator*().

T &iterator::operator*() const

Gibt einen veränderbaren Verweis auf den Wert des aktuellen Elements zurück.

Dasselbe wie value().

Siehe auch key().

QMap<Key, T>::iterator &iterator::operator++()

Der Präfix-Operator ++ (++i) verschiebt den Iterator zum nächsten Element in der Map und gibt einen Iterator zum neuen aktuellen Element zurück.

Der Aufruf dieser Funktion auf QMap::end() führt zu undefinierten Ergebnissen.

Siehe auch operator--().

QMap<Key, T>::iterator iterator::operator++(int)

Dies ist eine überladene Funktion.

Der Postfix-Operator ++ (i++) setzt den Iterator auf das nächste Element in der Map und gibt einen Iterator auf das zuvor aktuelle Element zurück.

QMap<Key, T>::iterator &iterator::operator--()

Der Präfix-Operator -- (--i) macht das vorhergehende Element aktuell und gibt einen Iterator zurück, der auf das neue aktuelle Element zeigt.

Der Aufruf dieser Funktion auf QMap::begin() führt zu undefinierten Ergebnissen.

Siehe auch operator++().

QMap<Key, T>::iterator iterator::operator--(int)

Dies ist eine überladene Funktion.

Der Postfix-Operator -- (i--) macht das vorangehende Element aktuell und gibt einen Iterator zurück, der auf das zuvor aktuelle Element zeigt.

T *iterator::operator->() const

Gibt einen Zeiger auf den Wert des aktuellen Elements zurück.

Siehe auch value().

iterator Class

Öffentliche Typen

Öffentliche Funktionen

Detaillierte Beschreibung

Dokumentation der Mitgliedstypen

`[alias]` iterator::iterator_category

Dokumentation der Mitgliedsfunktionen

iterator::iterator()

const Key &iterator::key() const

T &iterator::value() const

T &iterator::operator*() const

QMap<Key, T>::iterator &iterator::operator++()

QMap<Key, T>::iterator iterator::operator++(int)

QMap<Key, T>::iterator &iterator::operator--()

QMap<Key, T>::iterator iterator::operator--(int)

T *iterator::operator->() const

Verwandte Nicht-Mitglieder

bool operator==(const QMap<Key, T>::iterator &lhs, const QMap<Key, T>::iterator &rhs)

bool operator!=(const QMap<Key, T>::iterator &lhs, const QMap<Key, T>::iterator &rhs)

iterator Class

Öffentliche Typen

Öffentliche Funktionen

Verwandte Nicht-Mitglieder

Detaillierte Beschreibung

Dokumentation der Mitgliedstypen

[alias] iterator::iterator_category

Dokumentation der Mitgliedsfunktionen

iterator::iterator()

const Key &iterator::key() const

T &iterator::value() const

T &iterator::operator*() const

QMap<Key, T>::iterator &iterator::operator++()

QMap<Key, T>::iterator iterator::operator++(int)

QMap<Key, T>::iterator &iterator::operator--()

QMap<Key, T>::iterator iterator::operator--(int)

T *iterator::operator->() const

Verwandte Nicht-Mitglieder

bool operator==(const QMap<Key, T>::iterator &lhs, const QMap<Key, T>::iterator &rhs)

bool operator!=(const QMap<Key, T>::iterator &lhs, const QMap<Key, T>::iterator &rhs)

`[alias]` iterator::iterator_category