QMutableLinkedListIterator Class

Documentation sur les fonctions membres

QMutableLinkedListIterator::QMutableLinkedListIterator(QLinkedList<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 QMutableLinkedListIterator::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 QMutableLinkedListIterator::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 aussi findNext().

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

void QMutableLinkedListIterator::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 &QMutableLinkedListIterator::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 &QMutableLinkedListIterator::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 conduit à des résultats indéfinis.

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

T &QMutableLinkedListIterator::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é au début du conteneur entraîne des résultats indéfinis.

Voir également hasPrevious(), previous() et peekNext().

T &QMutableLinkedListIterator::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 du conteneur donne lieu à des résultats indéfinis.

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

void QMutableLinkedListIterator::remove()

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

Exemple :

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

Voir également insert() et setValue().

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

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

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

Exemple :

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

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

void QMutableLinkedListIterator::toBack()

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

Voir également toFront() et previous().

void QMutableLinkedListIterator::toFront()

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

Voir également toBack() et next().

const T &QMutableLinkedListIterator::value() const

Renvoie la valeur du dernier élément qui a été sauti lors de l'utilisation 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 &QMutableLinkedListIterator::value()

Renvoie une référence non constante à la valeur du dernier élément qui a été sauti à l'aide de l'une des fonctions de parcours.

QMutableLinkedListIterator<T> &QMutableLinkedListIterator::operator=(QLinkedList<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()`.