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)

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

Voir aussi operator=().

bool QMultiMapIterator::findNext(const T &value)

Recherche value à partir de la position actuelle de l'itérateur. Retourne true si une paire (clé, valeur) avec la valeur value est trouvée ; sinon, retourne 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é à l'arrière du conteneur.

Voir également findPrevious().

bool QMultiMapIterator::findPrevious(const T &value)

Recherche value à partir de la position actuelle de l'itérateur vers l'arrière. Retourne true si une paire (clé, valeur) avec la valeur value est trouvée ; sinon, retourne 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é à l'avant du conteneur.

Voir également findNext().

bool QMultiMapIterator::hasNext() const

Renvoie true s'il y a au moins un élément avant l'itérateur, c'est-à-dire que l'itérateur n' est pas à l'arrière du conteneur ; sinon, renvoie false.

Voir aussi hasPrevious() et next().

bool QMultiMapIterator::hasPrevious() const

Renvoie true s'il y a au moins un élément derrière l'itérateur, c'est-à-dire que l'itérateur n' est pas à l'avant du conteneur ; sinon, renvoie false.

Voir aussi 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 traversée (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 key() sur la valeur de retour pour obtenir la clé de l'élément, et value() pour obtenir la valeur.

L'appel de cette fonction sur un itérateur situé à l'arrière du conteneur conduit à 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 key() sur la valeur de retour pour obtenir la clé de l'élément, et value() pour obtenir la valeur.

L'appel de cette fonction sur un itérateur situé à l'avant du conteneur conduit à des résultats indéfinis.

Voir aussi 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 key() sur la valeur de retour pour obtenir la clé de l'élément, et value() pour obtenir la valeur.

L'appel de cette fonction à un itérateur situé à l'avant du conteneur conduit à des résultats indéfinis.

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

void QMultiMapIterator::toBack()

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

Voir aussi toFront() et previous().

void QMultiMapIterator::toFront()

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

Voir aussi 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 traversée (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)

Fait fonctionner l'itérateur sur map. L'itérateur est placé au début de la carte (avant le premier élément).

Voir aussi toFront() et toBack().