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 :
entiers
interface, classe^
Classe ref publique ^
value struct
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 contenir l’itérateur retourné par First() consiste à affecter la valeur de retour à une variable déclarée avec le mot clé de déduction de auto type. 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++