Platform::Collections::Vector, classePlatform::Collections::Vector Class

Représente une collection séquentielle d'objets accessibles séparément par index.Represents a sequential collection of objects that can be individually accessed by index.

SyntaxeSyntax

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

ParamètresParameters

T
Type des éléments contenus dans l'objet Vector.The type of the elements contained in the Vector object.

E
Spécifie un prédicat binaire pour tester l'égalité des valeurs de type T.Specifies a binary predicate for testing equality with values of type T. La valeur par défaut est std::equal_to<T>.The default value is std::equal_to<T>.

NotesRemarks

Les types autorisés sont les suivants :Allowed types are:

  1. Entiersintegers

  2. Classe interface ^interface class ^

  3. Classe ref publique ^public ref class^

  4. value structvalue struct

  5. classe d'énumération publiquepublic enum class

    La classe Vector est l'implémentation concrète C++ de l'interface Windows::Foundation::Collections::IVector .The Vector class is the C++ concrete implementation of the Windows::Foundation::Collections::IVector interface.

    Si vous tentez d'utiliser un type Vector dans une valeur ou un paramètre de retour public, l'erreur de compilateur C3986 est générée.If you attempt to use a Vector type in a public return value or parameter, compiler error C3986 will be raised. 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.You can fix the error by changing the parameter or return value type to Windows::Foundation::Collections::IVector. Pour plus d'informations, consultez Collections (C++/CX).For more information, see Collections (C++/CX).

MembresMembers

Constructeurs publicsPublic Constructors

NomName DescriptionDescription
Vector::VectorVector::Vector Initialise une nouvelle instance de la classe Vector.Initializes a new instance of the Vector class.

Méthodes publiquesPublic Methods

NomName DescriptionDescription
Vector::AppendVector::Append Insère l'élément spécifié après le dernier élément du Vector actif.Inserts the specified item after the last item in the current Vector.
Vector::ClearVector::Clear Supprime tous les éléments du vecteur actuel.Deletes all the elements in the current Vector.
Vector::FirstVector::First Retourne un itérateur qui spécifie le premier élément du Vector.Returns an iterator that specifies the first element in the Vector.
Vector::GetAtVector::GetAt Récupère l'élément de l'objet Vector actuel qui est identifié par l'index spécifié.Retrieves the element of the current Vector that is identifed by the specified index.
Vector::GetManyVector::GetMany Récupère une séquence d'éléments du Vector actif en commençant à l'index spécifié.Retrieves a sequence of items from the current Vector, starting at the specified index.
Vector::GetViewVector::GetView Retourne une vue en lecture seule d'un vecteur ; autrement dit, une Platform::Collections::VectorView.Returns a read-only view of a Vector; that is, a Platform::Collections::VectorView.
Vector::IndexOfVector::IndexOf Recherche l'élément spécifié dans l'objet Vector actuel, et s'il existe, retourne l'index de l'élément.Searches for the specified item in the current Vector, and if found, returns the index of the item.
Vector::InsertAtVector::InsertAt Insère l'élément spécifié dans le vecteur actuel après l'identification de l'élément par l'index spécifié.Inserts the specified item into the current Vector after the element identified by the specified index.
Vector::ReplaceAllVector::ReplaceAll Supprime les éléments du Vector actif et les insère depuis le tableau spécifié.Deletes the elements in the current Vector and then inserts the elements from the specified array.
Vector::RemoveAtVector::RemoveAt Supprime l'élément identifié par l'index spécifié à partir du Vector actif.Deletes the element identified by the specified index from the current Vector.
Vector::RemoveAtEndVector::RemoveAtEnd Supprime l'élément à la fin du Vector actif.Deletes the element at the end of the current Vector.
Vector::SetAtVector::SetAt Assigne la valeur spécifiée à l'élément du Vector actif identifié par l'index spécifié.Assigns the specified value to the element in the current Vector that is identified by the specified index.
Vector::SizeVector::Size Retourne le nombre d'éléments dans l'objet Vector actuel.Returns the number of elements in the current Vector object.

ÉvénementsEvents

NameName DescriptionDescription
événement Windows::Foundation::Collection::VectorChangedEventHandler<T > ^ VectorChangedevent Windows::Foundation::Collection::VectorChangedEventHandler<T>^ VectorChanged Se produit lorsque le Vector est modifié.Occurs when the Vector changes.

Hiérarchie d'héritageInheritance Hierarchy

Vector

Configuration requiseRequirements

En-tête : collection.hHeader: collection.h

Espace de noms : Platform::CollectionsNamespace: Platform::Collections

Vector::Append, méthodeVector::Append Method

Insère l'élément spécifié après le dernier élément du Vector actif.Inserts the specified item after the last item in the current Vector.

SyntaxeSyntax

virtual void Append(T item);  

ParamètresParameters

index
Élément à insérer dans le Vector.The item to insert into the Vector. Le type de item est défini par le T typename.The type of item is defined by the T typename.

Vector::Clear, méthodeVector::Clear Method

Supprime tous les éléments du vecteur actuel.Deletes all the elements in the current Vector.

SyntaxeSyntax

virtual void Clear();  

Vector::First (méthode)Vector::First Method

Retourne un itérateur qui pointe vers le premier élément du Vector.Returns an iterator that points to the first element in the Vector.

SyntaxeSyntax


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

Valeur de retourReturn Value

Itérateur qui pointe vers le premier élément du Vector.An iterator that points to the first element in the Vector.

NotesRemarks

Un moyen pratique de contenir l’itérateur retourné par First() est d’assigner la valeur de retournée à une variable déclarée avec le automatique mot clé de déduction de type.A convenient way to hold the iterator returned by First() is to assign the return value to a variable that is declared with the auto type deduction keyword. Par exemple, auto x = myVector->First();.For example, auto x = myVector->First();. Cet itérateur connaît la longueur de la collection.This iterator knows the length of the collection.

Lorsque vous avez besoin d’une paire d’itérateurs à passer à une fonction STL, utilisez les fonctions libres Windows::Foundation :: Collections :: begin et Windows::FoundationWhen you need a pair of iterators to pass to an STL function, use the free functions Windows::Foundation::Collections::begin and Windows::Foundation::Collections::end

Vector::GetAt (méthode)Vector::GetAt Method

Récupère l'élément de l'objet Vector actuel qui est identifié par l'index spécifié.Retrieves the element of the current Vector that is identifed by the specified index.

SyntaxeSyntax

virtual T GetAt(unsigned int index);  

ParamètresParameters

index
Entier non signé de base zéro qui spécifie un élément particulier dans l'objet Vector.A zero-based, unsigned integer that specifies a particular element in the Vector object.

Valeur de retourReturn Value

Élément spécifié par le paramètre index.The element specified by the index parameter. Le type d’élément est défini par le T typename.The element type is defined by the T typename.

Vector::GetMany (méthode)Vector::GetMany Method

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.Retrieves a sequence of items from the current Vector, starting at the specified index, and copies them into the caller-allocated array.

SyntaxeSyntax

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

ParamètresParameters

startIndex
L'index de base zéro du début des éléments à récupérer.The zero-based index of the start of the items to retrieve.

dest
Un tableau alloué par l'appelant des éléments qui commencent à l'élément spécifié par startIndex et se terminent au dernier élément du Vector.A caller-allocated array of items that begin at the element specified by startIndex and end at the last element in the Vector.

Valeur de retourReturn Value

Le nombre d'éléments à récupérer.The number of items retrieved.

NotesRemarks

Cette fonction n'est pas destinée à être utilisée directement par le code client.This function is not intended for use directly by client code. Elle est utilisée en interne dans le to_vector (fonction) pour permettre la conversion des instances Platform::Vector en instances std::vector.It is used internally in the to_vector Function to enable efficient conversion of Platform::Vector intances to std::vector instances.

Vector::GetView (méthode)Vector::GetView Method

Retourne une vue en lecture seule d'un Vector, c'est-à-dire un IVectorView.Returns a read-only view of a Vector; that is, an IVectorView.

SyntaxeSyntax

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

Valeur de retourReturn Value

Objet IVectorView.An IVectorView object.

Vector::IndexOf (méthode)Vector::IndexOf Method

Recherche l'élément spécifié dans l'objet Vector actuel, et s'il existe, retourne l'index de l'élément.Searches for the specified item in the current Vector, and if found, returns the index of the item.

SyntaxeSyntax


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

ParamètresParameters

value
Élément à rechercher.The item to find.

index
Index de base zéro de l'élément si le paramètre value est détecté ; sinon, 0.The zero-based index of the item if parameter value is found; otherwise, 0.

Le paramètre index est égal à 0 si l'élément est le premier élément du vecteur ou que l'élément est introuvable.The index parameter is 0 if either the item is the first element of the Vector or the item was not found. Si la valeur de retour est true, l'élément est trouvé et représente le premier élément ; sinon, l'élément est introuvable.If the return value is true, the item was found and it is the first element; otherwise, the item was not found.

Valeur de retourReturn Value

true si l'élément spécifié est trouvé ; sinon, false.true if the specified item is found; otherwise, false.

NotesRemarks

IndexOf uses std::find_if pour trouver l'élément.IndexOf uses std::find_if to find the item. Les types d'élément personnalisés doivent surcharger les opérateurs == et != afin d'autoriser les comparaisons d'égalité requises par find_if.Custom element types should therefore overload the == and != operator in order to enable the equality comparisons that find_if requires.

Vector::InsertAt, méthodeVector::InsertAt Method

Insère l'élément spécifié dans le vecteur actuel après l'identification de l'élément par l'index spécifié.Inserts the specified item into the current Vector after the element identified by the specified index.

SyntaxeSyntax

virtual void InsertAt(unsigned int index, T item)  

ParamètresParameters

index
Entier non signé de base zéro qui spécifie un élément particulier dans l'objet Vector.A zero-based, unsigned integer that specifies a particular element in the Vector object.

item
Élément à insérer dans l'objet Vector après l'élément spécifié par index.An item to insert into the Vector after the element specified by index. Le type de item est défini par le T typename.The type of item is defined by the T typename.

Vector::RemoveAt, méthodeVector::RemoveAt Method

Supprime l'élément identifié par l'index spécifié à partir du Vector actif.Deletes the element identified by the specified index from the current Vector.

SyntaxeSyntax

virtual void RemoveAt(unsigned int index);  

ParamètresParameters

index
Entier non signé de base zéro qui spécifie un élément particulier dans l'objet Vector.A zero-based, unsigned integer that specifies a particular element in the Vector object.

Vector::removeatend, méthodeVector::RemoveAtEnd Method

Supprime l'élément à la fin du Vector actif.Deletes the element at the end of the current Vector.

SyntaxeSyntax

virtual void RemoveAtEnd();  

Vector::ReplaceAll, méthodeVector::ReplaceAll Method

Supprime les éléments du Vector actif et les insère depuis le tableau spécifié.Deletes the elements in the current Vector and then inserts the elements from the specified array.

SyntaxeSyntax

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

ParamètresParameters

arr
Un tableau d’objets dont le type est défini par le T typename.An array of objects whose type is defined by the T typename.

Vector::SetAt, méthodeVector::SetAt Method

Assigne la valeur spécifiée à l'élément du Vector actif identifié par l'index spécifié.Assigns the specified value to the element in the current Vector that is identified by the specified index.

SyntaxeSyntax

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

ParamètresParameters

index
Entier non signé de base zéro qui spécifie un élément particulier dans l'objet Vector.A zero-based, unsigned integer that specifies a particular element in the Vector object.

item
Valeur à assigner à l’élément spécifié.The value to assign to the specified element. Le type de item est défini par le T typename.The type of item is defined by the T typename.

Vector::Size, méthodeVector::Size Method

Retourne le nombre d'éléments dans l'objet Vector actuel.Returns the number of elements in the current Vector object.

SyntaxeSyntax

virtual property unsigned int Size;  

Valeur de retourReturn Value

Nombre d’éléments dans l’objet Vector actuel.The number of elements in the current Vector.

Vector::Vector (constructeur)Vector::Vector Constructor

Initialise une nouvelle instance de la classe Vector.Initializes a new instance of the Vector class.

SyntaxeSyntax

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ètresParameters

aa
A std::array qui sera utilisé pour initialiser le Vector.A std::array that will be used to initialize the Vector.

aa
A Platform::Array qui sera utilisé pour initialiser le Vector.A Platform::Array that will be used to initialize the Vector.

InIt
Type d’une collection d’objets utilisée pour initialiser l’objet Vector actuel.The type of a collection of objects that is used to initialize the current Vector.

ilil
A std::initializer_list d’objets de type T qui sera utilisé pour initialiser le Vector.A std::initializer_list of objects of type T that will be used to initialize the Vector.

N
Nombre d’éléments d’une collection d’objets utilisée pour initialiser l’objet Vector actuel.The number of elements in a collection of objects that is used to initialize the current Vector.

size
Nombre d'éléments dans l'objet Vector.The number of elements in the Vector.

value
Valeur utilisée pour initialiser chaque élément de l'objet Vector actuel.A value that is used to initialize each element in the current Vector.

v
Un Lvalues et Rvalues à un std::vector qui est utilisé pour initialiser l’objet Vector actuel.An Lvalues and Rvalues to a std::vector that is used to initialize the current Vector.

ptr
Pointeur vers un std::vector utilisé pour initialiser l'objet Vector actuel.Pointer to a std::vector that is used to initialize the current Vector.

arr
A Platform::Array objet qui est utilisé pour initialiser l’objet Vector actuel.A Platform::Array object that is used to initialize the current Vector.

a
A std::array objet qui est utilisé pour initialiser l’objet Vector actuel.A std::array object that is used to initialize the current Vector.

first
Premier élément d'une séquence d'objets utilisée pour initialiser l'objet Vector actuel.The first element in a sequence of objects that are used to initialize the current Vector. Le type de first est passé à l’aide de un transfert parfait.The type of first is passed by means of perfect forwarding. Pour plus d'informations, consultez Déclarateur de référence rvalue : &&.For more information, see Rvalue Reference Declarator: &&.

last
Dernier élément d'une séquence d'objets utilisée pour initialiser l'objet Vector actuel.The last element in a sequence of objects that are used to initialize the current Vector. Le type de last est passé à l’aide de un transfert parfait.The type of last is passed by means of perfect forwarding. Pour plus d'informations, consultez Déclarateur de référence rvalue : &&.For more information, see Rvalue Reference Declarator: &&.

Voir aussiSee Also

Plateforme Namespace Platform Namespace
Création de composants Windows Runtime en C++Creating Windows Runtime Components in C++