QHashIterator Class

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

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

Documentation des fonctions membres

QHashIterator::QHashIterator(const QHash<Key, T> &hash)

Crée un itérateur permettant de parcourir hash. L'itérateur est positionné au début du hachage (avant le premier élément).

Voir également operator=().

bool QHashIterator::findNext(const T &value)

Recherche « value » à partir de la position actuelle de l'itérateur 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 QHashIterator::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 &QHashIterator::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().

QHashIterator<Key, T>::Item QHashIterator::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()`.

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

Renvoie 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 QHashIterator::toBack()

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

Voir aussi toFront().

void QHashIterator::toFront()

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

Voir également toBack() et next().

const T &QHashIterator::value() const

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

Voir également key().

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

Fait en sorte que l'itérateur opère sur hash. L'itérateur est positionné au début du hachage (avant le premier élément).

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