Platform::Collections::Vector, classe

Représente une collection séquentielle d'objets accessibles séparément par index. Implémente Windows ::Foundation ::Collections ::IObservableVector pour faciliter la liaison de données XAML.

Syntaxe

template <typename T, typename E>
   ref class Vector sealed;

Paramètres

T
Type des éléments contenus dans l'objet Vector.

E
Spécifie un prédicat binaire pour tester l’égalité avec les valeurs de type T. La valeur par défaut est std::equal_to<T>.

Notes

Les types autorisés sont :

  1. entiers

  2. interface, classe^

  3. Classe ref publique ^

  4. value struct

  5. classe d'énumération publique

La classe Vector est l’implémentation concrète C++ de l’interface Windows ::Foundation ::Collections ::IVector .

Si vous tentez d’utiliser un type Vector dans une valeur ou un paramètre de retour public, l’erreur du compilateur C3986 est déclenchée. Vous pouvez corriger l'erreur en modifiant le type du paramètre ou le type de la valeur de retour par Windows::Foundation::Collections::IVector. Pour plus d'informations, consultez Collections (C++/CX).

Membres

Constructeurs publics

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

Méthodes publiques

Nom Description
Vector ::Append Insère l'élément spécifié après le dernier élément du Vector actif.
Vector ::Clear Supprime tous les éléments du vecteur actuel.
Vector ::First Retourne un itérateur qui spécifie le premier élément du Vector.
Vector ::GetAt Récupère l'élément de l'objet Vector actuel qui est identifié par l'index spécifié.
Vector ::GetMany Récupère une séquence d'éléments du Vector actif en commençant à l'index spécifié.
Vector ::GetView Retourne une vue en lecture seule d'un vecteur ; autrement dit, une Platform::Collections::VectorView.
Vector ::IndexOf Recherche l'élément spécifié dans l'objet Vector actuel, et s'il existe, retourne l'index de l'élément.
Vector ::InsertAt Insère l’élément spécifié dans le vecteur actuel à l’élément identifié par l’index spécifié.
Vector ::ReplaceAll Supprime les éléments du Vector actif et les insère depuis le tableau spécifié.
Vector ::RemoveAt Supprime l'élément identifié par l'index spécifié à partir du Vector actif.
Vector ::RemoveAtEnd Supprime l'élément à la fin du Vector actif.
Vector ::SetAt Assigne la valeur spécifiée à l'élément du Vector actif identifié par l'index spécifié.
Vector ::Size Retourne le nombre d'éléments dans l'objet Vector actuel.

Événements

Nom Description
event Windows ::Foundation ::Collection ::VectorChangedEventHandler<T>^ VectorChanged Se produit lorsque le Vector est modifié.

Hiérarchie d'héritage

Vector

Spécifications

En-tête : collection.h

Espace de noms : Platform::Collections

Vector::Append, méthode

Insère l'élément spécifié après le dernier élément du Vector actif.

Syntaxe

virtual void Append(T item);

Paramètres

index
Élément à insérer dans le Vector. Le type d’élément est défini par le nom de type T.

Vector::Clear, méthode

Supprime tous les éléments du vecteur actuel.

Syntaxe

virtual void Clear();

Vector::First, méthode

Retourne un itérateur qui pointe vers le premier élément du Vector.

Syntaxe

virtual Windows::Foundation::Collections::IIterator <T>^ First();

Valeur de retour

Itérateur qui pointe vers le premier élément du Vector.

Notes

Un moyen pratique de conserver l’itérateur retourné par First() consiste à affecter la valeur de retour à une variable déclarée avec la auto déduction de type mot clé. Par exemple : auto x = myVector->First();. Cet itérateur connaît la longueur de la collection.

Lorsque vous avez besoin d’une paire d’itérateurs pour passer à une fonction STL, utilisez les fonctions gratuites Windows ::Foundation ::Collections ::begin et Windows ::Foundation ::Collections ::end

Vector::GetAt, méthode

Récupère l'élément de l'objet Vector actuel qui est identifié par l'index spécifié.

Syntaxe

virtual T GetAt(unsigned int index);

Paramètres

index
Entier non signé de base zéro qui spécifie un élément particulier dans l'objet Vector.

Valeur de retour

Élément spécifié par le paramètre d’index. Le type d’élément est défini par le nom de type T .

Vector::GetMany, méthode

Récupère une séquence d'éléments du Vector actif en commençant à l'index spécifié et les copie dans le tableau alloué par l'appelant.

Syntaxe

virtual unsigned int GetMany(
    unsigned int startIndex,
    Platform::WriteOnlyArray<T>^ dest);

Paramètres

startIndex
L'index de base zéro du début des éléments à récupérer.

dest
Tableau d’éléments alloués par l’appelant qui commence à l’élément spécifié par startIndex et se termine au dernier élément du Vector.

Valeur de retour

Le nombre d'éléments à récupérer.

Notes

Cette fonction n'est pas destinée à être utilisée directement par le code client. Il est utilisé en interne dans la fonction to_vector pour permettre une conversion efficace des intances Platform ::Vector en instances std ::vector.

Vector::GetView, méthode

Retourne une vue en lecture seule d'un Vector, c'est-à-dire un IVectorView.

Syntaxe

Windows::Foundation::Collections::IVectorView<T>^ GetView();

Valeur de retour

Objet IVectorView.

Vector::IndexOf, méthode

Recherche l'élément spécifié dans l'objet Vector actuel, et s'il existe, retourne l'index de l'élément.

Syntaxe

virtual bool IndexOf(T value, unsigned int* index);

Paramètres

value
Élément à rechercher.

index
Index de base zéro de l’élément si la valeur du paramètre est trouvée ; sinon, 0.

Le paramètre d’index est 0 si l’élément est le premier élément du Vector ou si l’élément est introuvable. Si la valeur de retour est true, l’élément a été trouvé et il s’agit du premier élément ; sinon, l’élément n’a pas été trouvé.

Valeur de retour

true si l’élément spécifié est trouvé ; sinon, false.

Notes

IndexOf uses std::find_if pour trouver l'élément. Les types d'élément personnalisés doivent surcharger les opérateurs == et != afin d'autoriser les comparaisons d'égalité requises par find_if.

Vector::InsertAt, méthode

Insère l’élément spécifié dans le vecteur actuel à l’élément identifié par l’index spécifié.

Syntaxe

virtual void InsertAt(unsigned int index, T item)

Paramètres

index
Entier non signé de base zéro qui spécifie un élément particulier dans l'objet Vector.

item
Élément à insérer dans le vecteur à l’élément spécifié par l’index. Le type d’élément est défini par le nom de type T.

Vector::RemoveAt, méthode

Supprime l'élément identifié par l'index spécifié à partir du Vector actif.

Syntaxe

virtual void RemoveAt(unsigned int index);

Paramètres

index
Entier non signé de base zéro qui spécifie un élément particulier dans l'objet Vector.

Vector::RemoveAtEnd, méthode

Supprime l'élément à la fin du Vector actif.

Syntaxe

virtual void RemoveAtEnd();

Vector::ReplaceAll, méthode

Supprime les éléments du Vector actif et les insère depuis le tableau spécifié.

Syntaxe

virtual void ReplaceAll(const ::Platform::Array<T>^ arr);

Paramètres

Arr
Tableau d’objets dont le type est défini par le nom de type T .

Vector::SetAt, méthode

Assigne la valeur spécifiée à l'élément du Vector actif identifié par l'index spécifié.

Syntaxe

virtual void SetAt(unsigned int index, T item);

Paramètres

index
Entier non signé de base zéro qui spécifie un élément particulier dans l'objet Vector.

item
Valeur à assigner à l’élément spécifié. Le type d’élément est défini par le nom de type T.

Vector::Size, méthode

Retourne le nombre d'éléments dans l'objet Vector actuel.

Syntaxe

virtual property unsigned int Size;

Valeur de retour

Nombre d’éléments dans l’objet Vector actuel.

Vector::Vector, constructeur

Initialise une nouvelle instance de la classe Vector.

Syntaxe

Vector();

explicit Vector(unsigned int size);
Vector( unsigned int size, T value);
template <typename U> explicit Vector( const ::std::vector<U>& v);
template <typename U> explicit Vector( std::vector<U>&& v);

Vector( const T * ptr, unsigned int size);
template <size_t N> explicit Vector(const T(&arr)[N]);
template <size_t N> explicit Vector(const std::array<T, N>& a);
explicit Vector(const Array<T>^ arr);

template <typename InIt> Vector(InIt first, InIt last);
Vector(std::initializer_list<T> il);

Paramètres

a
Std  ::array qui sera utilisé pour initialiser le vecteur.

Arr
Platform  ::Array qui sera utilisé pour initialiser le vecteur.

Init
Type d’une collection d’objets utilisée pour initialiser l’objet Vector actuel.

il
Std  ::initializer_list d’objets de type T qui seront utilisés pour initialiser le vecteur.

N
Nombre d’éléments d’une collection d’objets utilisée pour initialiser l’objet Vector actuel.

size
Nombre d'éléments dans l'objet Vector.

value
Valeur utilisée pour initialiser chaque élément de l'objet Vector actuel.

v
Valeurs Lvalues et Rvalues à un vecteur std ::qui est utilisé pour initialiser le vecteur actuel.

ptr
Pointeur vers un std::vector utilisé pour initialiser l'objet Vector actuel.

first
Premier élément d'une séquence d'objets utilisée pour initialiser l'objet Vector actuel. Le type de premier est passé par le biais d’un transfert parfait. Pour plus d'informations, consultez Déclarateur de référence rvalue : &&.

last
Dernier élément d'une séquence d'objets utilisée pour initialiser l'objet Vector actuel. Le type de dernier est passé par le biais d’un transfert parfait. Pour plus d'informations, consultez Déclarateur de référence rvalue : &&.

Voir aussi

Collections (C++/CX)
Espace de noms de plateforme
Création de composants Windows Runtime en C++