const_iterator Class
class QHash::const_iteratorDie Klasse QHash::const_iterator bietet einen STL-ähnlichen Konst-Iterator für QHash. Mehr...
Öffentliche Funktionen
| const_iterator() | |
| const_iterator(const QHash<Key, T>::iterator &other) | |
| const Key & | key() const |
| const T & | value() const |
| bool | operator!=(const QHash<Key, T>::const_iterator &other) const |
| const T & | operator*() const |
| QHash<Key, T>::const_iterator & | operator++() |
| QHash<Key, T>::const_iterator | operator++(int) |
| const T * | operator->() const |
| bool | operator==(const QHash<Key, T>::const_iterator &other) const |
Detaillierte Beschreibung
QHash<Schlüssel, T>::const_iterator ermöglicht die Iteration über eine QHash. Wenn Sie die QHash während der Iteration ändern möchten, müssen Sie stattdessen QHash::iterator verwenden. Es ist im Allgemeinen eine gute Praxis, QHash::const_iterator auch für eine nicht-konstante QHash zu verwenden, es sei denn, Sie müssen die QHash durch den Iterator ändern. Konstante Iteratoren sind etwas schneller und können die Lesbarkeit des Codes verbessern.
Der Standard-Konstruktor QHash::const_iterator erzeugt einen nicht initialisierten Iterator. Sie müssen ihn mit einer QHash Funktion wie QHash::cbegin(), QHash::cend() oder QHash::constFind() 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(i.key()) << ": " << i.value() << endl;
Im Gegensatz zu QMap, das seine Elemente nach Schlüssel ordnet, speichert QHash seine Elemente in beliebiger Reihenfolge. Die einzige Garantie besteht darin, dass Elemente, die denselben Schlüssel haben (weil sie mit QMultiHash eingefügt wurden), nacheinander erscheinen, und zwar vom zuletzt eingefügten bis zum zuletzt eingefügten Wert.
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() kann 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.
Sie können jedoch sicher Iteratoren verwenden, um Einträge aus dem Hash zu entfernen, indem Sie die Methode QHash::erase() verwenden. Diese Funktion kann gefahrlos während der Iteration aufgerufen werden und hat keinen Einfluss auf die Reihenfolge der Einträge im Hash.
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 QHash::iterator, QHash::key_iterator, und QHash::const_key_value_iterator.
Dokumentation der Mitgliedsfunktionen
[constexpr noexcept] 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 QHash::constBegin() und QHash::constEnd().
[noexcept] const_iterator::const_iterator(const QHash<Key, T>::iterator &other)
Konstruiert eine Kopie von other.
[noexcept] const Key &const_iterator::key() const
Gibt den Schlüssel des aktuellen Elements zurück.
Siehe auch value().
[noexcept] const T &const_iterator::value() const
Gibt den Wert des aktuellen Elements zurück.
Siehe auch key() und operator*().
[noexcept] bool const_iterator::operator!=(const QHash<Key, T>::const_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==().
[noexcept] const T &const_iterator::operator*() const
Gibt den Wert des aktuellen Elements zurück.
Dasselbe wie value().
Siehe auch key().
[noexcept] QHash<Key, T>::const_iterator &const_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 QHash::end() führt zu undefinierten Ergebnissen.
[noexcept] QHash<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 im Hash und gibt einen Iterator auf das zuvor aktuelle Element zurück.
[noexcept] const T *const_iterator::operator->() const
Gibt einen Zeiger auf den Wert des aktuellen Elements zurück.
Siehe auch value().
[noexcept] bool const_iterator::operator==(const QHash<Key, T>::const_iterator &other) const
Gibt true zurück, wenn other auf dasselbe Element wie dieser Iterator 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.
