QMultiMapIterator Class

QMultiMap<int, QWidget*> multimap;
//...
QMultiMapIterator<int, QWidget*> i(multimap);
while (i.hasNext()) {
    i.next();
    qDebug() << i.key() << ": " << i.value();
}

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

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

Documentation des fonctions membres

QMultiMapIterator::QMultiMapIterator(const QMultiMap<Key, T> &map)

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

Voir également operator=().

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

Voir aussi findPrevious().

bool QMultiMapIterator::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 QMultiMapIterator::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 QMultiMapIterator::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 &QMultiMapIterator::key() const

Renvoie la clé 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(), key() est équivalent à peekPrevious().key(). Après un appel à previous() ou findPrevious(), key() est équivalent à peekNext().key().

Voir également value().

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

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

Renvoie l'élément précédent 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é au début du conteneur donne lieu à des résultats indéfinis.

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

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

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

Voir également toFront() et previous().

void QMultiMapIterator::toFront()

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

Voir également toBack() et next().

const T &QMultiMapIterator::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() est équivalent à peekPrevious().value(). Après un appel à previous() ou findPrevious(), value() est équivalent à peekNext().value().

Voir également key().

QMultiMapIterator<Key, T> &QMultiMapIterator::operator=(const QMultiMap<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()`.