Classe Platform::Collections::VectorIterator

Fournit un itérateur Standard Template Library pour les objets dérivés de l'interface Windows Runtime IVector.

VectorIterator est un itérateur de proxy qui stocke des éléments de type VectorProxy<T>. Toutefois, l'objet proxy n'est presque jamais visible par le code utilisateur. Pour plus d'informations, consultez Collections (C++/CX).

Syntaxe

template <typename T>
class VectorIterator;

Paramètres

T
Nom de type de la classe de modèle VectorIterator.

Membres

Typedefs publics

Nom	Description
difference_type	Une différence de pointeur (ptrdiff_t).
iterator_category	La catégorie d'itérateur d'accès aléatoire (::std::random_access_iterator_tag).
pointer	Pointeur vers un type interne, Platform::Collections::Details::VectorProxy<T>, qui est requis pour l'implémentation de VectorIterator.
reference	Une référence à un type interne, Platform::Collections::Details::VectorProxy<T>, qui est requis pour l'implémentation de VectorIterator.
value_type	Nom de type T .

Constructeurs publics

Nom	Description
VectorIterator::VectorIterator	Initialise une nouvelle instance de la classe VectorIterator.

Opérateurs publics

Nom	Description
VectorIterator::operator- (opérateur)	Soustrait un nombre spécifié d'éléments de l'itérateur actuel en cédant un nouvel itérateur, ou un itérateur spécifié de l'itérateur actuel en cédant le nombre d'éléments entre les itérateurs.
VectorIterator::operator-- (opérateur)	Décrémente le VectorIterator actif.
VectorIterator::operator!= (opérateur)	Indique si le VectorIterator actif n'est pas égal à un VectorIterator spécifié.
VectorIterator::operator* (opérateur)	Récupère une référence à l'élément spécifié par le VectorIterator actif.
VectorIterator::operator[]	Récupère une référence à l'élément qui est un décalage spécifié à partir de l'objet VectorIterator actuel.
VectorIterator::operator+ (opérateur)	Retourne un VectorIterator qui référence l'élément spécifié au décalage spécifié à partir du VectorIterator spécifié.
VectorIterator::operator++ (opérateur)	Incrémente le VectorIterator actif.
VectorIterator::operator+= (opérateur)	Incrémente le VectorIterator actif du décalage spécifié.
VectorIterator::operator< (opérateur)	Indique si le VectorIterator actuel est inférieur au VectorIterator spécifié.
VectorIterator::operator<= (opérateur)	Indique si l'objet VectorIterator actuel est inférieur ou égal à un objet VectorIterator spécifié.
VectorIterator::operator-= (opérateur)	Décrémente l'objet VectorIterator actuel du décalage spécifié.
VectorIterator::operator== (opérateur)	Indique si l'objet VectorIterator actuel est égal à un objet VectorIterator spécifié.
VectorIterator::operator> (opérateur)	Indique si le VectorIterator actif est supérieur au VectorIterator spécifié.
VectorIterator::operator-> (opérateur)	Récupère l'adresse de l'élément référencé par le VectorIterator actif.
VectorIterator::operator>= (opérateur)	Indique si le VectorIterator actif est supérieur ou égal à un VectorIterator spécifié.

Hiérarchie d'héritage

VectorIterator

Spécifications

En-tête : collection.h

Espace de noms : Platform::Collections

Opérateur VectorIterator::operator->

Récupère l'adresse de l'élément référencé par le VectorIterator actif.

Syntaxe

Detail::ArrowProxy<T> operator->() const;

Valeur de retour

Valeur de l’élément référencé par le VectorIteratoractuel.

Le type de la valeur de retour est un type interne non spécifié nécessaire pour l’implémentation de cet opérateur.

VectorIterator::operator-- opérateur

Décrémente le VectorIterator actif.

Syntaxe

VectorIterator& operator--();
VectorIterator operator--(int);

Valeur de retour

La première syntaxe décrémente, puis retourne le VectorIterator actuel. La deuxième syntaxe retourne une copie du VectorIterator actuel, puis décrémente le VectorIterator actuel.

Notes

La première syntaxe VectorIterator décrémente le VectorIterator actuel.

La deuxième syntaxe post-décrémente le VectorIterator actif. Le type int dans la deuxième syntaxe n’indique pas un opérande entier réel mais une post-décrémentation.

VectorIterator::operator* opérateur

Récupère l'adresse de l'élément spécifié par le VectorIterator actuel.

Syntaxe

reference operator*() const;

Valeur de retour

L'élément spécifié par le VectorIterator actuel.

VectorIterator::operator== opérateur

Indique si le VectorIterator actuel est égal à un VectorIterator spécifié.

Syntaxe

bool operator==(const VectorIterator& other) const;

Paramètres

other
Autre VectorIterator.

Valeur de retour

true si le VectorIterator actuel est égal à d'autres ; sinon, false.

VectorIterator::operator> opérateur

Indique si le VectorIterator actuel est supérieur à un VectorIterator spécifié.

Syntaxe

bool operator>(const VectorIterator& other) const

Paramètres

other
Autre VectorIterator.

Valeur de retour

true si le VectorIterator actif est supérieur à other ; sinon false.

VectorIterator::operator>= opérateur

Indique si le VectorIterator actuel est supérieur ou égal au VectorIterator spécifié.

Syntaxe

bool operator>=(const VectorIterator& other) const

Paramètres

other
Autre VectorIterator.

Valeur de retour

true si le VectorIterator actuel est supérieur ou égal à other ; sinon, false.

VectorIterator::operator++ opérateur

Incrémente le VectorIterator actuel.

Syntaxe

VectorIterator& operator++();
VectorIterator operator++(int);

Valeur de retour

La première syntaxe incrémente, puis retourne le VectorIterator actuel. La deuxième syntaxe retourne une copie du VectorIterator actuel, puis incrémente le VectorIterator actuel.

Notes

La première syntaxe VectorIterator pré-incrémente le VectorIterator actuel.

La deuxième syntaxe post-incrémente le VectorIterator actuel. Le type int dans la deuxième syntaxe n'indique pas un opérande entier réel mais une post-incrémentation.

VectorIterator::operator!= opérateur

Indique si le VectorIterator actuel n'est pas égal au VectorIterator spécifié.

Syntaxe

bool operator!=(const VectorIterator& other) const;

Paramètres

other
Autre VectorIterator.

Valeur de retour

true si le VectorIterator actuel n'est pas égal à d'autres ; sinon, false.

VectorIterator::operator< opérateur

Indique si le VectorIterator actuel est inférieur à un VectorIterator spécifié.

Syntaxe

bool operator<(const VectorIterator& other) const

Paramètres

other
Autre VectorIterator.

Valeur de retour

true si le VectorIterator actuel est inférieur à other ; sinon, false.

VectorIterator::operator<= opérateur

Indique si le VectorIterator actuel est inférieur ou égal à un VectorIterator spécifié.

Syntaxe

bool operator<=(const VectorIterator& other) const

Paramètres

other
Autre VectorIterator.

Valeur de retour

true si le VectorIterator actuel est inférieur ou égal à other ; sinon, false.

VectorIterator::operator- opérateur

Soustrait un nombre spécifié d'éléments de l'itérateur actuel en cédant un nouvel itérateur, ou un itérateur spécifié de l'itérateur actuel en cédant le nombre d'éléments entre les itérateurs.

Syntaxe

VectorIterator operator-(difference_type n) const;

difference_type operator-(const VectorIterator& other) const;

Paramètres

n
Nombre d'éléments.

other
Autre VectorIterator.

Valeur de retour

La première syntaxe d’opérateur retourne un objet VectorIterator qui compte n éléments de moins que le VectorIterator actuel. La deuxième syntaxe d’opérateur retourne le nombre d’éléments entre le courant et le other VectorIterator.

VectorIterator::operator+= opérateur

Incrémente le VectorIterator actuel par le déplacement spécifié.

Syntaxe

VectorIterator& operator+=(difference_type n);

Paramètres

n
Déplacement d'un entier.

Valeur de retour

VectorIterator mise à jour.

VectorIterator::operator+ opérateur

Retourne un VectorIterator qui fait référence à l'élément au déplacement spécifié de VectorIterator spécifié.

Syntaxe

VectorIterator operator+(difference_type n);

template <typename T>
inline VectorIterator<T> operator+(
  ptrdiff_t n,
  const VectorIterator<T>& i);

Paramètres

T
Dans la deuxième syntaxe, le nom de type de VectorIterator.

n
Déplacement d'un entier.

i
Dans la deuxième syntaxe, un VectorIterator.

Valeur de retour

Dans la première syntaxe, un VectorIterator qui fait référence à l'élément au déplacement spécifié à partir du VectorIterator actuel.

Dans la deuxième syntaxe, un VectorIterator qui fait référence à l’élément au déplacement spécifié à partir du début du paramètre i.

Notes

Exemple pour la première syntaxe

VectorIterator::operator-= opérateur

Décrémente le VectorIterator actuel par le déplacement spécifié.

Syntaxe

VectorIterator& operator-=(difference_type n);

Paramètres

n
Déplacement d'un entier.

Valeur de retour

VectorIterator mise à jour.

VectorIterator::operator[] opérateur

Récupère une référence à l'élément qui est un décalage spécifié à partir de l'objet VectorIterator actuel.

Syntaxe

reference operator[](difference_type n) const;

Paramètres

n
Déplacement d'un entier.

Valeur de retour

Élément qui est déplacé par les éléments n à partir du VectorIterator actuel.

Constructeur VectorIterator::VectorIterator

Initialise une nouvelle instance de la classe VectorIterator.

Syntaxe

VectorIterator();

explicit VectorIterator(
   Windows::Foundation::Collections::IVector<T>^ v);

Paramètres

v
Objet IVector<T>.

Notes

Le premier exemple de syntaxe est le constructeur par défaut. Le deuxième exemple de syntaxe est un constructeur explicite utilisé pour construire un VectorIterator à partir d’un objet IVector<T>.

Voir aussi

Espace de noms de plateforme