Back to Qt.io
Contact Us Blog Download Qt

iterator Class

class QMultiHash::iterator

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

Öffentliche Funktionen

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

Detaillierte Beschreibung

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

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

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

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

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

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

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

Um Elemente aus einem QMultiHash zu entfernen, können Sie erase_if(QMultiHash<Key, T> &map, Predicate pred) verwenden:

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

Mehrere Iteratoren können auf denselben Hash angewendet werden. Beachten Sie jedoch, dass jede Änderung, die direkt an QHash vorgenommen wird (Einfügen und Entfernen von Elementen), dazu führen kann, dass die Iteratoren ungültig werden.

Das Einfügen von Elementen in den Hash oder der Aufruf von Methoden wie QHash::reserve() oder QHash::squeeze() können alle Iteratoren ungültig machen, die auf den Hash zeigen. Die Iteratoren bleiben garantiert nur so lange gültig, wie QHash seine interne Hash-Tabelle nicht vergrößern/verkleinern muss. Die Verwendung eines Iterators nach einer Rehashing-Operation führt zu undefiniertem Verhalten.

Wenn Sie Iteratoren über einen langen Zeitraum aufbewahren müssen, empfehlen wir Ihnen, eher QMultiMap als QHash zu verwenden.

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 QMultiHash::const_iterator, QMultiHash::key_iterator, und QMultiHash::key_value_iterator.

Dokumentation der Mitgliedsfunktionen

[noexcept] bool iterator::operator==(const QMultiHash<Key, T>::const_iterator &other) const

[noexcept] bool iterator::operator==(const QMultiHash<Key, T>::iterator &other) const

Gibt true zurück, wenn other auf dasselbe Element wie dieser Iterator zeigt; andernfalls wird false zurückgegeben.

Siehe auch operator!=().

[noexcept] bool iterator::operator!=(const QMultiHash<Key, T>::const_iterator &other) const

[noexcept] bool iterator::operator!=(const QMultiHash<Key, T>::iterator &other) const

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

Siehe auch operator==().

[constexpr noexcept] 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 QMultiHash::begin() und QMultiHash::end().

[noexcept] 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 über einen Iterator zu ändern, obwohl dies durch den Aufruf von QMultiHash::erase() gefolgt von QMultiHash::insert() möglich ist.

Siehe auch value().

[noexcept] 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*().

[noexcept] T &iterator::operator*() const

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

Dasselbe wie value().

Siehe auch key().

[noexcept] QMultiHash<Key, T>::iterator &iterator::operator++()

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

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

[noexcept] QMultiHash<Key, T>::iterator iterator::operator++(int)

Dies ist eine überladene Funktion.

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

[noexcept] T *iterator::operator->() const

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

Siehe auch value().

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