Plattform::Samlingar::Vektorklass

Representerar en sekventiell samling objekt som kan nås individuellt av index. Implementerar Windows::Foundation::Collections::IObservableVector för att hjälpa till med XAML-databindning.

Syntax

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

Parameterar

T
Typen av element som finns i Vector-objektet.

E
Anger ett binärt predikat för att testa likhet med värden av typen T. Standardvärdet är std::equal_to<T>.

Anmärkningar

Tillåtna typer är:

1. Heltal

2. gränssnittsklass^

3. public ref class^

4. värde struct

5. offentlig uppräkningsklass

Klassen Vector är C++-betongimplementeringen av gränssnittet Windows::Foundation::Collections::IVector.

Om du försöker använda en vektortyp i ett offentligt returvärde eller en parameter genereras kompilatorfelet C3986. Du kan åtgärda felet genom att ändra parametern eller returnera värdetypen till Windows::Foundation::Collections::IVector. Mer information finns i Samlingar (C++/CX).

Members

Offentliga konstruktorer

Offentliga metoder

Evenemang

Arvshierarki

Vector

Kravspecifikation

Rubrik: collection.h

Namespace: Plattform::Samlingar

Vektor::Tilläggsmetod

Infogar det angivna objektet efter det sista objektet i den aktuella vektorn.

Syntax

virtual void Append(T item);

Parameterar

index
Objektet som ska infogas i vektorn. Typen av objekt definieras av T-typnamnet .

Vektor::Rensa metod

Tar bort alla element i den aktuella vektorn.

Syntax

virtual void Clear();

Vektor::Första metoden

Returnerar en iterator som pekar på det första elementet i vektorn.

Syntax

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

Returvärde

En iterator som pekar på det första elementet i vektorn.

Anmärkningar

Ett praktiskt sätt att lagra iteratorn som returneras av First() är att tilldela returvärdet till en variabel som deklareras med nyckelordet auto typavdrag. Till exempel auto x = myVector->First();. Den här iteratorn känner till samlingens längd.

När du behöver ett par iteratorer för att skicka till en STL-funktion använder du de kostnadsfria funktionerna Windows::Foundation::Collections::begin och Windows::Foundation::Collections::end

Vektor::GetAt-metod

Hämtar elementet i den aktuella vektorn som är identifierad av det angivna indexet.

Syntax

virtual T GetAt(unsigned int index);

Parameterar

index
Ett nollbaserat, osignerat heltal som anger ett visst element i Vector-objektet.

Returvärde

Elementet som anges av indexparametern . Elementtypen definieras av T-typnamnet .

Vektor::GetMany-metod

Hämtar en sekvens med objekt från den aktuella vektorn med början vid det angivna indexet och kopierar dem till den anroparallokerade matrisen.

Syntax

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

Parameterar

startIndex
Det nollbaserade indexet för början av de objekt som ska hämtas.

dest
En uppringarallokerad matris med objekt som börjar vid elementet som anges av startIndex och slutar på det sista elementet i vektorn.

Returvärde

Antalet objekt som hämtats.

Anmärkningar

Den här funktionen är inte avsedd att användas direkt av klientkoden. Den används internt i to_vector-funktionen för att möjliggöra effektiv konvertering av Platform::Vector-instanser till std::vector-instanser.

Vektor::GetView-metod

Returnerar en skrivskyddad vy av en vektor. det vill: en IVectorView.

Syntax

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

Returvärde

Ett IVectorView-objekt.

Vektor::IndexOf-metod

Söker efter det angivna objektet i den aktuella vektorn och returnerar om det hittas objektets index.

Syntax

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

Parameterar

value
Objektet som ska hittas.

index
Det nollbaserade indexet för objektet om parametervärdet hittas. annars 0.

Indexparametern är 0 om antingen objektet är det första elementet i vektorn eller om objektet inte hittades. Om returvärdet är truehittades objektet och det är det första elementet. Annars hittades inte objektet.

Returvärde

trueom det angivna objektet hittas; annars . false

Anmärkningar

IndexOf använder std::find_if för att hitta objektet. Anpassade elementtyper bör därför överbelasta operatorn == och != för att möjliggöra likhetsjämförelser som find_if kräver.

Vektor::InsertAt-metod

Infogar det angivna objektet i den aktuella vektorn vid det element som identifieras av det angivna indexet.

Syntax

virtual void InsertAt(unsigned int index, T item)

Parameterar

index
Ett nollbaserat, osignerat heltal som anger ett visst element i Vector-objektet.

item
Ett objekt som ska infogas i vektorn vid det element som anges av indexet. Typen av objekt definieras av T-typnamnet .

Vektor::RemoveAt-metod

Tar bort elementet som identifieras av det angivna indexet från den aktuella vektorn.

Syntax

virtual void RemoveAt(unsigned int index);

Parameterar

index
Ett nollbaserat, osignerat heltal som anger ett visst element i Vector-objektet.

Vector::RemoveAtEnd-metod

Tar bort elementet i slutet av den aktuella vektorn.

Syntax

virtual void RemoveAtEnd();

Vektor::ReplaceAll-metod

Tar bort elementen i den aktuella vektorn och infogar sedan elementen från den angivna matrisen.

Syntax

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

Parameterar

Arr
En matris med objekt vars typ definieras av T-typnamnet .

Vektor::SetAt-metod

Tilldelar det angivna värdet till elementet i den aktuella vektorn som identifieras av det angivna indexet.

Syntax

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

Parameterar

index
Ett nollbaserat, osignerat heltal som anger ett visst element i Vector-objektet.

item
Värdet som ska tilldelas till det angivna elementet. Typen av objekt definieras av T-typnamnet .

Vektor::Storleksmetod

Returnerar antalet element i det aktuella Vector-objektet.

Syntax

virtual property unsigned int Size;

Returvärde

Antalet element i den aktuella vektorn.

Vektor::Vektorkonstruktor

Initierar en ny instans av klassen Vector.

Syntax

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

Parameterar

a
En std::array som ska användas för att initiera vektorn.

Arr
En plattform::Matris som ska användas för att initiera vektorn.

Init
Typen av en samling objekt som används för att initiera den aktuella vektorn.

Il
En std::initializer_list av objekt av typen T som ska användas för att initiera vektorn.

N
Antalet element i en samling objekt som används för att initiera den aktuella vektorn.

storlek
Antalet element i vektorn.

value
Ett värde som används för att initiera varje element i den aktuella vektorn.

v
En Lvalues och Rvalues till en std::vector som används för att initiera den aktuella vektorn.

ptr
Pekare till en std::vector som används för att initiera den aktuella vektorn.

first
Det första elementet i en sekvens med objekt som används för att initiera den aktuella vektorn. Typen av första skickas med hjälp av perfekt vidarebefordran. Mer information finns i Referensdeklarator för Rvalue: &&.

last
Det sista elementet i en sekvens med objekt som används för att initiera den aktuella vektorn. Typen av sista skickas med hjälp av perfekt vidarebefordran. Mer information finns i Referensdeklarator för Rvalue: &&.

Se även

Samlingar (C++/CX)
Plattformsnamnområde
Skapa Windows Runtime-komponenter i C++