QMutableMapIterator Class

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

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

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

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

Documentation des fonctions membres

QMutableMapIterator::QMutableMapIterator(QMap<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 QMutableMapIterator::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 QMutableMapIterator::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 QMutableMapIterator::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 QMutableMapIterator::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 &QMutableMapIterator::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().

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

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

Renvoie l'élément suivant 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'arrière du conteneur conduit à des résultats indéfinis.

Voir aussi hasNext(), next() et peekPrevious().

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

QMutableMapIterator<Key, T>::Item QMutableMapIterator::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 QMutableMapIterator::remove()

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

Voir aussi setValue().

void QMutableMapIterator::setValue(const T &value)

Remplace la valeur du dernier élément qui a été sauté à l'aide de l'une des fonctions de déplacement par value.

Les fonctions de traversée sont next(), previous(), findNext() et findPrevious().

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

void QMutableMapIterator::toBack()

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

Voir aussi toFront() et previous().

void QMutableMapIterator::toFront()

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

Voir aussi toBack() et next().

const T &QMutableMapIterator::value() const

Renvoie la valeur du dernier élément qui a été sauté en utilisant 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() et setValue().

T &QMutableMapIterator::value()

Renvoie une référence non-const à la valeur du dernier élément ayant fait l'objet d'un saut à l'aide de l'une des fonctions de traversée.

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