QMutableListIterator Class

Documentation des fonctions membres

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

Crée un itérateur permettant de parcourir list. L'itérateur est placé en tête 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 vers l'avant. Renvoie true si value est trouvé ; 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 QMutableListIterator::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 « 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 QMutableListIterator::hasNext() const

Renvoie ` true ` s'il reste au moins un élément devant 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 QMutableListIterator::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 début du conteneur ; sinon, renvoie ` false`.

Voir également 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 sur un itérateur situé à la fin du conteneur entraîne des résultats indéfinis.

Voir également 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 sur un itérateur situé à la fin du conteneur entraîne des résultats indéfinis.

Voir également 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 sur un itérateur situé en début de conteneur entraîne des résultats indéfinis.

Voir également 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 sur un itérateur situé en début de conteneur entraîne des résultats indéfinis.

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

void QMutableListIterator::remove()

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

Exemple :

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

Voir également insert() et setValue().

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

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

Les fonctions de parcours 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 à la fin du conteneur (après le dernier élément).

Voir également toFront() et previous().

void QMutableListIterator::toFront()

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

Voir également toBack() et next().

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

Voir également setValue().

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

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

Fait en sorte que l'itérateur opère sur list. L'itérateur est placé en tête de la liste (avant le premier élément).

Voir également ` toFront()` et ` toBack()`.