Sur cette page

QMutableHashIterator Class

template <typename Key, typename T> class QMutableHashIterator

La classe QMutableHashIterator fournit un itérateur non-const de style Java pour QHash et QMultiHash. Plus...

En-tête : #include <QMutableHashIterator>
CMake : find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake : QT += core

Fonctions publiques

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)

Description détaillée

QHash possède à la fois des itérateurs de style Java et des itérateurs de style STL. Les itérateurs de style STL sont plus efficaces et doivent être privilégiés.

QMutableHashIterator<Key, T> vous permet d'itérer sur un QHash et de modifier le hachage. Si vous ne souhaitez pas modifier le hachage (ou si vous disposez d'un const QHash), utilisez plutôt QHashIterator, qui est légèrement plus rapide.

Le constructeur de QMutableHashIterator prend un QHash comme argument. Après la construction, l'itérateur est situé au tout début du hachage (avant le premier élément). Voici comment itérer sur tous les éléments de manière séquentielle :

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

La fonction next() renvoie l'élément suivant dans le hachage et fait avancer l'itérateur. Les fonctions key() et value() renvoient la clé et la valeur du dernier élément qui a été sauté.

Contrairement aux itérateurs de style STL, les itérateurs de style Java pointent entre les éléments plutôt que directement sur les éléments. Le premier appel à next() fait avancer l'itérateur à la position située entre le premier et le deuxième élément, et renvoie le premier élément ; le deuxième appel à next() fait avancer l'itérateur à la position située entre le deuxième et le troisième élément, et ainsi de suite.

Les itérateurs de style Java pointent entre les éléments

Si vous souhaitez trouver toutes les occurrences d'une valeur particulière, utilisez findNext() dans une boucle. Par exemple :

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

Si vous souhaitez supprimer des éléments au fur et à mesure que vous parcourez le hachage, utilisez remove(). Si vous souhaitez modifier la valeur d'un élément, utilisez setValue().

Exemple :

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

Cet exemple supprime toutes les paires (clé, valeur) dont la clé et la valeur sont identiques.

Un seul itérateur mutable peut être actif sur un hachage donné à tout moment. En outre, aucune modification ne doit être apportée directement au hachage lorsque l'itérateur est actif (et non par l'intermédiaire de l'itérateur), car cela pourrait invalider l'itérateur et entraîner un comportement indéfini.

Voir également QHashIterator et QHash::iterator.

Documentation des fonctions membres

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

Construit un itérateur pour parcourir hash. L'itérateur est placé au début du hachage (avant le premier élément).

Voir aussi operator=().

bool QMutableHashIterator::findNext(const T &value)

Recherche value à partir de la position actuelle de l'itérateur. Retourne true si une paire (clé, valeur) avec la valeur value est trouvée ; sinon, retourne false.

Après l'appel, si value a été trouvé, l'itérateur est positionné juste après l'élément correspondant ; sinon, l'itérateur est positionné à l'arrière du conteneur.

bool QMutableHashIterator::hasNext() const

Renvoie true s'il y a au moins un élément avant l'itérateur, c'est-à-dire que l'itérateur n' est pas à l'arrière du conteneur ; sinon, renvoie false.

Voir aussi next().

const Key &QMutableHashIterator::key() const

Renvoie la clé du dernier élément qui a été sauté à l'aide d'une des fonctions de traversée (next(), findNext()).

Voir aussi value().

QMutableHashIterator<Key, T>::Item QMutableHashIterator::next()

Renvoie l'élément suivant et fait avancer l'itérateur d'une position.

Appelez key() sur la valeur de retour pour obtenir la clé de l'élément, et value() pour obtenir la valeur.

L'appel de cette fonction sur un itérateur situé à l'arrière du conteneur conduit à des résultats indéfinis.

Voir également hasNext() et peekNext().

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

Renvoie une référence à l'élément suivant sans déplacer l'itérateur.

Appelez key() sur la valeur de retour pour obtenir la clé de l'élément, et value() pour obtenir la valeur.

L'appel de cette fonction sur un itérateur situé à l'arrière du conteneur conduit à des résultats indéfinis.

Voir aussi hasNext() et next().

void QMutableHashIterator::remove()

Supprime le dernier élément qui a été sauté à l'aide de l'une des fonctions de traversée (next(), findNext()).

Voir également setValue().

void QMutableHashIterator::setValue(const T &value)

Remplace la valeur du dernier élément qui a été sauté à l'aide de l'une des fonctions de déplacement par value.

Les fonctions de traversée sont next() et findNext().

Voir également key(), value() et remove().

void QMutableHashIterator::toBack()

Déplace l'itérateur à l'arrière du conteneur (après le dernier élément).

Voir également toFront().

void QMutableHashIterator::toFront()

Déplace l'itérateur à l'avant du conteneur (avant le premier élément).

Voir aussi toBack() et next().

const T &QMutableHashIterator::value() const

Renvoie la valeur du dernier élément qui a été sauté à l'aide d'une des fonctions de traversée (next(), findNext()).

Voir aussi key() et setValue().

T &QMutableHashIterator::value()

Renvoie une référence non-const à la valeur du dernier élément ayant fait l'objet d'un saut à l'aide de l'une des fonctions de traversée.

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

Permet à l'itérateur d'opérer sur hash. L'itérateur est placé à l'avant du hachage (avant le premier élément).

Voir aussi toFront() et toBack().

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