QMutableHashIterator Class

template <typename Key, typename T> class QMutableHashIterator

Die Klasse QMutableHashIterator bietet einen nicht-konstanten Iterator im Java-Stil für QHash und QMultiHash. Mehr...

Kopfzeile:	`#include <QMutableHashIterator>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Core)` `target_link_libraries(mytarget PRIVATE Qt6::Core)`
qmake:	`QT += core`

Liste aller Mitglieder, einschließlich vererbter Mitglieder

Öffentliche Funktionen

	QMutableHashIterator(QHash<Key, T> &hash)
bool	findNext(const T &value)
bool	hasNext() const
const Key &	key() const
QMutableHashIterator<Key, T>::Item	next()
QMutableHashIterator<Key, T>::Item	peekNext() const
void	remove()
void	setValue(const T &value)
void	toBack()
void	toFront()
const T &	value() const
T &	value()
QMutableHashIterator<Key, T> &	operator=(QHash<Key, T> &hash)

Detaillierte Beschreibung

QHash hat sowohl Iteratoren im Java-Stil als auch Iteratoren im STL-Stil. Iteratoren im STL-Stil sind effizienter und sollten bevorzugt werden.

QMutableHashIterator<Key, T> ermöglicht die Iteration über einen QHash und die Änderung des Hashes. Wenn Sie den Hash nicht verändern wollen (oder eine const QHash haben), verwenden Sie stattdessen die etwas schnellere QHashIterator.

Der QMutableHashIterator-Konstruktor nimmt ein QHash als Argument an. Nach der Konstruktion befindet sich der Iterator ganz am Anfang des Hashes (vor dem ersten Element). So können Sie alle Elemente der Reihe nach durchlaufen:

QHash<int, QWidget*> hash;...QMutableHashIterator<QString, QWidget*> i(hash);while (i.hasNext()) { i.next();    qDebug() << i.key() << ": " << i.value();
}

Die Funktion next() gibt das nächste Element im Hash zurück und schaltet den Iterator weiter. Die Funktionen key() und value() geben den Schlüssel und den Wert des zuletzt übersprungenen Elements zurück.

Im Gegensatz zu Iteratoren im STL-Stil zeigen Iteratoren im Java-Stil zwischen Elementen und nicht direkt auf Elemente. Der erste Aufruf von next() setzt den Iterator an die Position zwischen dem ersten und dem zweiten Element und gibt das erste Element zurück; der zweite Aufruf von next() setzt den Iterator an die Position zwischen dem zweiten und dem dritten Element und so weiter.

Wenn Sie alle Vorkommen eines bestimmten Wertes finden wollen, verwenden Sie findNext() in einer Schleife. Ein Beispiel:

QMutableHashIterator<int, QWidget*> i(hash);while (i.findNext(widget)) {    qDebug() << "Found widget " << widget << " under key "
            << i.key(); }

Wenn Sie bei der Iteration über den Hash Elemente entfernen möchten, verwenden Sie remove(). Wenn Sie den Wert eines Eintrags ändern wollen, verwenden Sie setValue().

Beispiel:

QMutableHashIterator<QString, QString> i(hash);
while (i.hasNext()) {
    i.next();
    if (i.key() == i.value())
        i.remove();
}

Das Beispiel entfernt alle (Schlüssel, Wert)-Paare, bei denen der Schlüssel und der Wert identisch sind.

Auf einem gegebenen Hash kann immer nur ein veränderbarer Iterator aktiv sein. Außerdem sollten keine Änderungen direkt am Hash vorgenommen werden, während der Iterator aktiv ist (im Gegensatz zum Iterator), da dies den Iterator ungültig machen und zu undefiniertem Verhalten führen könnte.

Siehe auch QHashIterator und QHash::iterator.

Dokumentation der Mitgliedsfunktionen

QMutableHashIterator::QMutableHashIterator(QHash<Key, T> &hash)

Konstruiert einen Iterator zum Durchlaufen von hash. Der Iterator wird so gesetzt, dass er am Anfang des Hash steht (vor dem ersten Element).

Siehe auch operator=().

QMutableHashIterator<Key, T> &QMutableHashIterator::operator=(QHash<Key, T> &hash)

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

Siehe auch toFront() und toBack().

void QMutableHashIterator::toFront()

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

Siehe auch toBack() und next().

void QMutableHashIterator::toBack()

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

Siehe auch toFront().

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

T &QMutableHashIterator::value()

Dies ist eine überladene Funktion.

Gibt eine Nicht-Konst-Referenz auf den Wert des letzten Elements zurück, das mit einer der Traversalfunktionen übersprungen wurde.

const Key &QMutableHashIterator::key() const

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

Siehe auch value().

bool QMutableHashIterator::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, wenn value gefunden wurde, direkt hinter dem passenden Element positioniert; andernfalls wird der Iterator am Ende des Containers positioniert.

QMutableHashIterator<Key, T>::Item QMutableHashIterator::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() und peekNext().

QMutableHashIterator<Key, T>::Item QMutableHashIterator::peekNext() const

Gibt einen Verweis auf 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() und next().

void QMutableHashIterator::remove()

Entfernt das letzte Element, das mit einer der Traversalfunktionen (next(), findNext()) übersprungen wurde.

Siehe auch setValue().

void QMutableHashIterator::setValue(const T &value)

Ersetzt den Wert des letzten Elements, das mit einer der Traversalfunktionen übersprungen wurde, durch value.

Die Traversalfunktionen sind next() und findNext().

Siehe auch key(), value(), und remove().

const T &QMutableHashIterator::value() const

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

Siehe auch key() und setValue().

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