Back to Qt.io
Contact Us Blog Download Qt

const_iterator Class

class QMultiMap::const_iterator

Die Klasse QMultiMap::const_iterator bietet einen STL-ähnlichen Konst-Iterator für QMultiMap. Mehr...

Öffentliche Typen

iterator_category

Öffentliche Funktionen

const_iterator()
const_iterator(const QMultiMap<Key, T>::iterator &other)
const Key &key() const
const T &value() const
const T &operator*() const
QMultiMap<Key, T>::const_iterator &operator++()
QMultiMap<Key, T>::const_iterator operator++(int)
QMultiMap<Key, T>::const_iterator &operator--()
QMultiMap<Key, T>::const_iterator operator--(int)
const T *operator->() const
bool operator!=(const QMultiMap<Key, T>::const_iterator &lhs, const QMultiMap<Key, T>::const_iterator &rhs)
bool operator==(const QMultiMap<Key, T>::const_iterator &lhs, const QMultiMap<Key, T>::const_iterator &rhs)

Detaillierte Beschreibung

QMultiMap<Schlüssel, T>::const_iterator ermöglicht die Iteration über eine QMultiMap. Wenn Sie die QMultiMap während der Iteration ändern möchten, müssen Sie stattdessen QMultiMap::iterator verwenden. Es ist im Allgemeinen eine gute Praxis, QMultiMap::const_iterator auch für eine nicht-konstante QMultiMap zu verwenden, es sei denn, Sie müssen die QMultiMap durch den Iterator ändern. Konstante Iteratoren sind etwas schneller und können die Lesbarkeit des Codes verbessern.

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

QMultiMap<QString, int> multi;
multimap.insert("January", 1);
multimap.insert("February", 2);
...
multimap.insert("December", 12);

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

Hier ist ein Beispiel, das alle Elemente entfernt, deren Wert größer als 10 ist:

QMultiMap<QString, int>::const_iterator i = multimap.cbegin();
while (i != multimap.cend()) {
    if (i.value() > 10)
        i = multimap.erase(i);
    else
        ++i;
}

Im Gegensatz zu QMultiHash, das seine Elemente in beliebiger Reihenfolge speichert, speichert QMultiMap seine Elemente nach Schlüssel geordnet. Elemente, die denselben Schlüssel haben, werden nacheinander angezeigt, vom zuletzt eingefügten bis zum zuletzt eingefügten Wert.

Mehrere Iteratoren können für dieselbe Multimap verwendet werden. Wenn Sie der Map Elemente hinzufügen, bleiben die vorhandenen Iteratoren gültig. Wenn Sie Elemente aus der Map entfernen, werden Iteratoren, die auf die entfernten Elemente verweisen, zu hängenden 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 QMultiMap::iterator, QMultiMap::key_iterator, und QMultiMap::const_key_value_iterator.

Dokumentation der Mitgliedstypen

[alias] const_iterator::iterator_category

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

Dokumentation der Mitgliedsfunktionen

const_iterator::const_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 QMultiMap::constBegin() und QMultiMap::constEnd().

const_iterator::const_iterator(const QMultiMap<Key, T>::iterator &other)

Konstruiert eine Kopie von other.

const Key &const_iterator::key() const

Gibt den Schlüssel des aktuellen Elements zurück.

Siehe auch value().

const T &const_iterator::value() const

Gibt den Wert des aktuellen Elements zurück.

Siehe auch key() und operator*().

const T &const_iterator::operator*() const

Gibt den Wert des aktuellen Elements zurück.

Dasselbe wie value().

Siehe auch key().

QMultiMap<Key, T>::const_iterator &const_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 QMultiMap::end() führt zu undefinierten Ergebnissen.

Siehe auch operator--().

QMultiMap<Key, T>::const_iterator const_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.

QMultiMap<Key, T>::const_iterator &const_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 QMultiMap::begin() führt zu undefinierten Ergebnissen.

Siehe auch operator++().

QMultiMap<Key, T>::const_iterator const_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.

const T *const_iterator::operator->() const

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

Siehe auch value().

Verwandte Nicht-Mitglieder

bool operator==(const QMultiMap<Key, T>::const_iterator &lhs, const QMultiMap<Key, T>::const_iterator &rhs)

Gibt true zurück, wenn lhs auf dasselbe Element wie der Iterator rhs zeigt; andernfalls wird false zurückgegeben.

Siehe auch operator!=().

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

Gibt true zurück, wenn lhs auf ein anderes Element als den Iterator rhs zeigt; andernfalls wird false zurückgegeben.

Siehe auch operator==().

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