QVectorIterator

La QVectorIterator fournit un itérateur constant dans le style Java pour QVector et QStack. Plus d'informations...

#include <QVectorIterator>

Voir la position dans l'arbre des classes.

Description détaillée

La QVectorIterator fournit un itérateur constant dans le style Java pour QVector et QStack.

QVector possède des itérateurs dans le style Java et des itérateurs dans le style STL. Les itérateurs dans le style Java sont de plus haut niveau et plus facile à utiliser que les itérateurs STL ; par contre, ils sont un peu moins efficaces.

Une autre possibilité que l'utilisation des itérateurs est d'utiliser les index. La plupart des fonctions de QVector prennent un index comme premier paramètre, rendant possibles l'accès, l'insertion et la suppression d'éléments sans utiliser d'itérateur.

QVectorIterator<T> permet de parcourir un QVector<T> (ou un QStack<T>). Si on souhaite modifier le vecteur lors du parcours, il faut à la place utiliser QMutableVectorIterator<T>.

Le constructeur de QVectorIterator prend un QVector comme paramètre. Après la construction, l'itérateur est situé au tout début du vecteur (avant le premier élément). Voici comment parcourir tous les éléments un par un:

 QVector<float> vector;
 ...
 QVectorIterator<float> i(vector);
 while (i.hasNext())
     qDebug() << i.next();

La fonction next() retourne le prochain élément du vecteur et avance l'itérateur. Contrairement aux itérateurs STL, les itérateurs Java pointent entre les éléments plutôt que sur les éléments. Le premier appel à next() avance l'itérateur à la position entre le premier et le second élément et retourne le premier élément ; le second appel à next() avance l'itérateur à la position entre le deuxième et le troisième élément, retournant le deuxième élément ; et ainsi de suite.

Voici comment parcourir dans l'ordre inversé :

 QVectorIterator<float> i(vector);
 i.toBack();
 while (i.hasPrevious())
     qDebug() << i.previous();

Si on veut trouver toutes les occurrences d'une valeur particulière, on utilise findNext() ou findPrevious() dans une boucle.

Plusieurs itérateurs peuvent être utilisés sur le même vecteur. Si le vecteur est modifié lorsqu'un QVectorIterator est actif, le QVectorIterator va continuer de parcourir le vecteur original, ignorant la copie modifiée.

Voir aussi QMutableVectorIterator et QVector::const_iterator.

Fonctions membres

QVectorIterator::QVectorIterator ( const QVector<T> & vector )

Construit un itérateur pour le parcours du vecteur vector. L'itérateur est positionné au début du vecteur (avant le premier élément).

Voir aussi operator=().

bool QVectorIterator::findNext ( const T & value )

Recherche en avant la valeur value en commençant par la position actuelle de l'itérateur. Retourne true si la valeur value est trouvée ; sinon retourne false.

Après l'appel, si la valeur value a été trouvée, 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 QVectorIterator::findPrevious ( const T & value )

Recherche en arrière la valeur value en commençant par la position actuelle de l'itérateur. Retourne true si la valeur value est trouvée ; sinon retourne false.

Après l'appel, si la valeur value a été trouvée, 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 QVectorIterator::hasNext () const

Retourne true s'il y a au moins un élément devant l'itérateur, c'est-à-dire, si l'itérateur n'est pas à la fin du conteneur ; sinon retourne false.

Voir aussi hasPrevious() et next().

bool QVectorIterator::hasPrevious () const

Retourne true s'il y a au moins un élément derrière l'itérateur, c'est-à-dire, si l'itérateur n'est pas au début du conteneur ; sinon retourne false.

Voir aussi hasNext() et previous().

const T & QVectorIterator::next ()

Retourne le prochain élément et avance l'itérateur d'une position en avant.

L'appel à cette fonction sur un itérateur situé à la fin d'un conteneur provoque des résultats non définis.

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

const T & QVectorIterator::peekNext () const

Retourne le prochain élément sans déplacer l'itérateur.

L'appel à cette fonction sur un itérateur situé à la fin d'un conteneur provoque des résultats non définis.

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

const T & QVectorIterator::peekPrevious () const

Retourne l'élément précédent sans déplacer l'itérateur.

L'appel à cette fonction sur un itérateur situé au début d'un conteneur provoque des résultats non définis.

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

const T & QVectorIterator::previous ()

Retourne l'élément précédent et déplace l'itérateur d'une position en arrière.

L'appel à cette fonction sur un itérateur situé au début d'un conteneur provoque des résultats non définis.

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

void QVectorIterator::toBack ()

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

Voir aussi toFront() et previous().

void QVectorIterator::toFront ()

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

Voir aussi toBack() et next().

QVectorIterator & QVectorIterator::operator= ( const QVector<T> & vector )

Associe l'itérateur au vecteur vector. L'itérateur est positionné au début du vecteur (avant le premier élément).

Voir aussi toFront() et toBack().

Remerciements

Merci à Alexandre Laurent pour la traduction ainsi qu'à Lo?c Leguay, Ilya Diallo, Jonathan Courtois, Thibaut Cuvelier et Claude Leloup pour leur relecture !