QMapIterator Class

QMap<int, QWidget*> map;
//...
QMapIterator<int, QWidget*> i(map);
while (i.hasNext()) {
    i.next();
    qDebug() << i.key() << ": " << i.value();
}

QMapIterator<int, QWidget*> i(map);
i.toBack();
while (i.hasPrevious()) {
    i.previous();
    qDebug() << i.key() << ": " << i.value();
}

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

Documentation sur les fonctions membres

QMapIterator::QMapIterator(const QMap<Key, T> &map)

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

Voir également operator=().

bool QMapIterator::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.

Voir aussi findPrevious().

bool QMapIterator::findPrevious(const T &value)

Recherche « value » en partant de la position actuelle de l’itérateur et en remontant vers l’arrière. 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 avant l'élément correspondant ; sinon, l'itérateur est positionné au début du conteneur.

Voir également findNext().

bool QMapIterator::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 hasPrevious() et next().

bool QMapIterator::hasPrevious() const

Renvoie ` true ` s'il reste au moins un élément derrière l'itérateur, c'est-à-dire si l'itérateur ne se trouve pas en tête du conteneur ; sinon, renvoie ` false`.

Voir également hasNext() et previous().

const Key &QMapIterator::key() const

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

Après un appel à next() ou findNext(), key() est équivalent à peekPrevious().key(). Après un appel à previous() ou findPrevious(), key() est équivalent à peekNext().key().

Voir également value().

QMapIterator<Key, T>::Item QMapIterator::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 entraîne des résultats indéfinis.

Voir également hasNext(), peekNext() et previous().

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

Renvoie l'élément suivant sans déplacer l'itérateur.

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

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

Voir également hasNext(), next() et peekPrevious().

QMapIterator<Key, T>::Item QMapIterator::peekPrevious() const

Renvoie l'élément précédent sans déplacer l'itérateur.

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

L'appel de cette fonction sur un itérateur situé en début de conteneur donne lieu à des résultats indéfinis.

Voir également hasPrevious(), previous() et peekNext().

QMapIterator<Key, T>::Item QMapIterator::previous()

Renvoie l'élément précédent et fait reculer 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é au début du conteneur produit des résultats indéfinis.

Voir également hasPrevious(), peekPrevious() et next().

void QMapIterator::toBack()

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

Voir également toFront() et previous().

void QMapIterator::toFront()

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

Voir également toBack() et next().

const T &QMapIterator::value() const

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

Après un appel à next() ou findNext(), value() équivaut à peekPrevious().value(). Après un appel à previous() ou findPrevious(), value() équivaut à peekNext().value().

Voir également key().

QMapIterator<Key, T> &QMapIterator::operator=(const QMap<Key, T> &map)

Permet à l'itérateur d'opérer sur map. L'itérateur est placé au début de la carte (avant le premier élément).

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