QMutableHashIterator Class

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

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

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

Documentation sur les fonctions membres

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

Crée un itérateur permettant de parcourir hash. L'itérateur est positionné en tête du hachage (avant le premier élément).

Voir également operator=().

bool QMutableHashIterator::findNext(const T &value)

Recherche « value » à partir de la position actuelle de l’itérateur et vers l’avant. Renvoie « true » si une paire (clé, valeur) dont la valeur est « value » est trouvée ; sinon, renvoie « 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é à la fin du conteneur.

bool QMutableHashIterator::hasNext() const

Renvoie « true » s'il reste au moins un élément avant l'itérateur, c'est-à-dire si l'itérateur ne se trouve pas à la fin du conteneur ; sinon, renvoie « false ».

Voir également next().

const Key &QMutableHashIterator::key() const

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

Voir également value().

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

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

Appelez la fonction ` key()` sur la valeur renvoyée pour obtenir la clé de l'élément, et la fonction ` value()` pour obtenir sa valeur.

L'appel de cette fonction sur un itérateur situé à la fin du conteneur donne lieu à 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 la fonction key() sur la valeur renvoyée pour obtenir la clé de l'élément, et la fonction value() pour obtenir sa valeur.

L'appel de cette fonction sur un itérateur situé à la fin du conteneur donne lieu à des résultats indéfinis.

Voir également ` hasNext()` et ` next()`.

void QMutableHashIterator::remove()

Supprime le dernier élément qui a été ignoré à l'aide de l'une des fonctions de parcours (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 parcours par value.

Les fonctions de parcours sont ` next()` et ` findNext()`.

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

void QMutableHashIterator::toBack()

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

Voir aussi toFront().

void QMutableHashIterator::toFront()

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

Voir également toBack() et next().

const T &QMutableHashIterator::value() const

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

Voir également key() et setValue().

T &QMutableHashIterator::value()

Renvoie une référence non constante à la valeur du dernier élément qui a été sauté à l'aide de l'une des fonctions de parcours.

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

Fait en sorte que l'itérateur opère sur hash. L'itérateur est placé en tête du hachage (avant le premier élément).

Voir également ` toFront()` et ` toBack()`.