QMutableMultiMapIterator Class

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

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

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

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

Documentation sur les fonctions membres

QMutableMultiMapIterator::QMutableMultiMapIterator(QMultiMap<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 QMutableMultiMapIterator::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 QMutableMultiMapIterator::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 un couple (clé, valeur) dont la valeur est « value » est trouvé ; 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 QMutableMultiMapIterator::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 QMutableMultiMapIterator::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 &QMutableMultiMapIterator::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().

QMutableMultiMapIterator<Key, T>::Item QMutableMultiMapIterator::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(), peekNext() et previous().

QMutableMultiMapIterator<Key, T>::Item QMutableMultiMapIterator::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 ` 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(), next() et peekPrevious().

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

QMutableMultiMapIterator<Key, T>::Item QMutableMultiMapIterator::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 donne lieu à des résultats indéfinis.

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

void QMutableMultiMapIterator::remove()

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

Voir également setValue().

void QMutableMultiMapIterator::setValue(const T &value)

Remplace la valeur du dernier élément qui a été ignoré lors de l'utilisation d'une des fonctions de parcours par value.

Les fonctions de parcours sont next(), previous(), findNext() et findPrevious().

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

void QMutableMultiMapIterator::toBack()

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

Voir également toFront() et previous().

void QMutableMultiMapIterator::toFront()

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

Voir également toBack() et next().

const T &QMutableMultiMapIterator::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() et setValue().

T &QMutableMultiMapIterator::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.

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