QMutableListIterator Class

Documentation sur les fonctions membres

QMutableListIterator::QMutableListIterator(QList<T> &list)

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

Voir aussi operator=().

bool QMutableListIterator::findNext(const T &value)

Recherche value à partir de la position actuelle de l'itérateur. Renvoie true si value est trouvé, sinon 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 QMutableListIterator::findPrevious(const T &value)

Recherche value à partir de la position actuelle de l'itérateur vers l'arrière. Renvoie true si 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é à l'avant du conteneur.

Voir également findNext().

bool QMutableListIterator::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 QMutableListIterator::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().

void QMutableListIterator::insert(const T &value)

Insère value à la position actuelle de l'itérateur. Après l'appel, l'itérateur se trouve juste après l'élément inséré.

Voir également remove() et setValue().

T &QMutableListIterator::next()

Renvoie une référence à l'élément suivant et fait avancer l'itérateur d'une position.

L'appel de cette fonction à un itérateur situé à l'arrière du conteneur entraîne des résultats indéfinis.

Voir aussi hasNext(), peekNext() et previous().

T &QMutableListIterator::peekNext() const

Renvoie une référence à l'élément suivant, sans déplacer l'itérateur.

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

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

T &QMutableListIterator::peekPrevious() const

Renvoie une référence à l'élément précédent, sans déplacer l'itérateur.

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

Voir aussi hasPrevious(), previous() et peekNext().

T &QMutableListIterator::previous()

Renvoie une référence à l'élément précédent et fait reculer l'itérateur d'une position.

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

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

void QMutableListIterator::remove()

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

Exemple :

QMutableListIterator<int> i(list);
while (i.hasNext()) {
    int val = i.next();
    if (val < -32768 || val > 32767)
        i.remove();
}

Voir aussi insert() et setValue().

void QMutableListIterator::setValue(const T &value) const

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().

Exemple :

QMutableListIterator<double> i(list);
while (i.hasNext()) {
    double val = i.next();
    i.setValue(std::sqrt(val));
}

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

void QMutableListIterator::toBack()

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

Voir aussi toFront() et previous().

void QMutableListIterator::toFront()

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

Voir aussi toBack() et next().

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

Voir aussi setValue().

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

QMutableListIterator<T> &QMutableListIterator::operator=(QList<T> &list)

Permet à l'itérateur d'opérer sur list. L'itérateur est placé en tête de liste (avant le premier élément).

Voir aussi toFront() et toBack().