IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)
Viadeo Twitter Facebook Share on Google+   
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Toutes les fonctions  ·  Vues d'ensemble  · 

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.

image

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 !

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 4.7
Copyright © 2021 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur, une redirection cassée ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !