Delen via


Platform::Collections::Vector Class

Vertegenwoordigt een sequentiële verzameling objecten die afzonderlijk toegankelijk zijn voor index. Implementeert Windows::Foundation::Collections::IObservableVector om u te helpen met XAML-gegevensbinding.

Syntaxis

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

Parameterwaarden

T
Het type van de elementen in het Vector-object.

E
Hiermee geeft u een binair predicaat voor het testen van gelijkheid met waarden van het type T. De standaardwaarde is std::equal_to<T>.

Opmerkingen

Toegestane soorten zijn:

  1. Gehele getallen

  2. interfaceklasse^

  3. openbare verw-klasse^

  4. waarde-struct

  5. openbare opsommingsklasse

De Vector-klasse is de C++-concrete implementatie van de Interface Windows::Foundation::Collections::IVector .

Als u probeert een vectortype te gebruiken in een openbare retourwaarde of parameter, wordt de compilerfout C3986 gegenereerd. U kunt de fout oplossen door de parameter te wijzigen of het retourwaardetype te wijzigen in Windows::Foundation::Collections::IVector. Zie Verzamelingen (C++/CX) voor meer informatie.

Members

Openbare constructors

Naam Description
Vector::Vector Initialiseert een nieuw exemplaar van de vectorklasse.

Openbare methoden

Naam Description
Vector::Toevoegen Hiermee voegt u het opgegeven item in na het laatste item in de huidige vector.
Vector::Wissen Hiermee verwijdert u alle elementen in de huidige vector.
Vector::First Retourneert een iterator die het eerste element in de vector aangeeft.
Vector::GetAt Hiermee wordt het element opgehaald van de huidige vector die wordt geïdentificeerd door de opgegeven index.
Vector::GetMany Haalt een reeks items op uit de huidige vector, beginnend bij de opgegeven index.
Vector::GetView Retourneert een alleen-lezen weergave van een vector; Dat wil gezegd: een Platform::Collections::VectorView.
Vector::IndexOf Zoekt naar het opgegeven item in de huidige vector en retourneert, indien gevonden, de index van het item.
Vector::InsertAt Hiermee voegt u het opgegeven item in de huidige vector in op het element dat is geïdentificeerd door de opgegeven index.
Vector::ReplaceAll Hiermee verwijdert u de elementen in de huidige vector en voegt u vervolgens de elementen uit de opgegeven matrix in.
Vector::RemoveAt Hiermee verwijdert u het element dat is geïdentificeerd door de opgegeven index uit de huidige vector.
Vector::RemoveAtEnd Hiermee verwijdert u het element aan het einde van de huidige vector.
Vector::SetAt Wijst de opgegeven waarde toe aan het element in de huidige vector die wordt geïdentificeerd door de opgegeven index.
Vector::Grootte Retourneert het aantal elementen in het huidige Vector-object.

Evenementen

Naam Description
gebeurtenis Windows::Foundation::Collection::VectorChangedEventHandler<T>^ VectorChanged Treedt op wanneer de vector verandert.

Overnamehiërarchie

Vector

Requirements

Header: collection.h

Namespace: Platform::Verzamelingen

Methode Vector::Append

Hiermee voegt u het opgegeven item in na het laatste item in de huidige vector.

Syntaxis

virtual void Append(T item);

Parameterwaarden

index
Het item dat moet worden ingevoegd in de vector. Het type item wordt gedefinieerd door de T-typenaam .

Vector::Clear-methode

Hiermee verwijdert u alle elementen in de huidige vector.

Syntaxis

virtual void Clear();

Vector::First-methode

Retourneert een iterator die verwijst naar het eerste element in de vector.

Syntaxis

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

Retourwaarde

Een iterator die verwijst naar het eerste element in de vector.

Opmerkingen

Een handige manier om de iterator die wordt geretourneerd door First() te bewaren, is door de retourwaarde toe te wijzen aan een variabele die wordt gedeclareerd met het auto trefwoord type aftrek. Bijvoorbeeld: auto x = myVector->First();. Deze iterator kent de lengte van de verzameling.

Wanneer u een paar iterators nodig hebt om door te geven aan een STL-functie, gebruikt u de gratis functies Windows::Foundation::Collections::begin en Windows::Foundation::Collections::end

Methode Vector::GetAt

Hiermee wordt het element opgehaald van de huidige vector die wordt geïdentificeerd door de opgegeven index.

Syntaxis

virtual T GetAt(unsigned int index);

Parameterwaarden

index
Een op nul gebaseerd, niet-ondertekend geheel getal dat een bepaald element in het Vector-object aangeeft.

Retourwaarde

Het element dat is opgegeven door de indexparameter . Het elementtype wordt gedefinieerd door de T-typenaam .

Methode Vector::GetMany

Haalt een reeks items op uit de huidige vector, beginnend bij de opgegeven index en kopieert deze naar de door de aanroeper toegewezen matrix.

Syntaxis

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

Parameterwaarden

startIndex
De op nul gebaseerde index van het begin van de items die moeten worden opgehaald.

dest
Een aanroeper toegewezen matrix met items die beginnen bij het element dat is opgegeven door startIndex en eindigen bij het laatste element in de Vector.

Retourwaarde

Het aantal opgehaalde items.

Opmerkingen

Deze functie is niet bedoeld voor gebruik rechtstreeks door clientcode. Het wordt intern gebruikt in de to_vector-functie om efficiënte conversie van Platform::Vector-exemplaren naar std::vector-exemplaren mogelijk te maken.

Methode Vector::GetView

Retourneert een alleen-lezen weergave van een vector; Dat wil gezegd, een IVectorView.

Syntaxis

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

Retourwaarde

Een IVectorView-object.

Methode Vector::IndexOf

Zoekt naar het opgegeven item in de huidige vector en retourneert, indien gevonden, de index van het item.

Syntaxis

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

Parameterwaarden

value
Het te vinden item.

index
De op nul gebaseerde index van het item als de parameterwaarde wordt gevonden; anders, 0.

De indexparameter is 0 als het item het eerste element van de vector is of als het item niet is gevonden. Als de retourwaarde is true, is het item gevonden en het is het eerste element. Anders is het item niet gevonden.

Retourwaarde

true als het opgegeven item wordt gevonden; anders, false.

Opmerkingen

IndexOf gebruikt std::find_if om het item te vinden. Aangepaste elementtypen moeten daarom de operator == en != overbelasten om de gelijkheidsvergelijkingen mogelijk te maken die find_if vereist.

Methode Vector::InsertAt

Hiermee voegt u het opgegeven item in de huidige vector in op het element dat is geïdentificeerd door de opgegeven index.

Syntaxis

virtual void InsertAt(unsigned int index, T item)

Parameterwaarden

index
Een op nul gebaseerd, niet-ondertekend geheel getal dat een bepaald element in het Vector-object aangeeft.

item
Een item dat moet worden ingevoegd in de vector op het element dat is opgegeven door de index. Het type item wordt gedefinieerd door de T-typenaam .

Methode Vector::RemoveAt

Hiermee verwijdert u het element dat is geïdentificeerd door de opgegeven index uit de huidige vector.

Syntaxis

virtual void RemoveAt(unsigned int index);

Parameterwaarden

index
Een op nul gebaseerd, niet-ondertekend geheel getal dat een bepaald element in het Vector-object aangeeft.

Methode Vector::RemoveAtEnd

Hiermee verwijdert u het element aan het einde van de huidige vector.

Syntaxis

virtual void RemoveAtEnd();

Methode Vector::ReplaceAll

Hiermee verwijdert u de elementen in de huidige vector en voegt u vervolgens de elementen uit de opgegeven matrix in.

Syntaxis

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

Parameterwaarden

Arr
Een matrix van objecten waarvan het type is gedefinieerd door de T-typenaam.

Methode Vector::SetAt

Wijst de opgegeven waarde toe aan het element in de huidige vector die wordt geïdentificeerd door de opgegeven index.

Syntaxis

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

Parameterwaarden

index
Een op nul gebaseerd, niet-ondertekend geheel getal dat een bepaald element in het Vector-object aangeeft.

item
De waarde die moet worden toegewezen aan het opgegeven element. Het type item wordt gedefinieerd door de T-typenaam .

Methode Vector::Size

Retourneert het aantal elementen in het huidige Vector-object.

Syntaxis

virtual property unsigned int Size;

Retourwaarde

Het aantal elementen in de huidige vector.

Vector::Vector Constructor

Initialiseert een nieuw exemplaar van de vectorklasse.

Syntaxis

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);

Parameterwaarden

een
Een std::matrix die wordt gebruikt om de vector te initialiseren.

Arr
Een platform::matrix die wordt gebruikt om de vector te initialiseren.

Init
Het type van een verzameling objecten die wordt gebruikt om de huidige vector te initialiseren.

Il
Een std::initializer_list objecten van het type T die worden gebruikt om de vector te initialiseren.

N
Het aantal elementen in een verzameling objecten dat wordt gebruikt om de huidige vector te initialiseren.

grootte
Het aantal elementen in de vector.

value
Een waarde die wordt gebruikt om elk element in de huidige vector te initialiseren.

v
Een Lvalues en Rvalues naar een std::vector die wordt gebruikt om de huidige vector te initialiseren.

ptr
Aanwijzer naar een std::vector die wordt gebruikt om de huidige vector te initialiseren.

first
Het eerste element in een reeks objecten die worden gebruikt om de huidige vector te initialiseren. Het type eerste wordt doorgegeven door middel van perfect doorsturen. Zie Rvalue Reference Declarator: &&voor meer informatie.

last
Het laatste element in een reeks objecten die worden gebruikt om de huidige vector te initialiseren. Het type laatste wordt doorgegeven door middel van perfect doorsturen. Zie Rvalue Reference Declarator: &&voor meer informatie.

Zie ook

Verzamelingen (C++/CX)
Platformnaamruimte
Windows Runtime-onderdelen maken in C++