Megosztás a következőn keresztül:


Platform::Gyűjtemények::Vektorosztály

Az index által egyenként elérhető objektumok szekvenciális gyűjteményét jelöli. Implementálja a Windows::Foundation::Collections::IObservableVector szolgáltatást az XAML-adatkötéshez.

Szemantika

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

Paraméterek

T
A Vektor objektumban található elemek típusa.

E
Bináris predikátumot ad meg a T típusú értékek egyenlőségének teszteléséhez. Az alapértelmezett érték a következő std::equal_to<T>: .

Megjegyzések

Az engedélyezett típusok a következők:

  1. Egészek

  2. interface class^

  3. public ref class^

  4. értékstruktúra

  5. nyilvános enumerálási osztály

A Vektor osztály a Windows::Foundation:::Collections::IVector felület C++ konkrét implementációja.

Ha vektortípust próbál használni egy nyilvános visszatérési értékben vagy paraméterben, a rendszer c3986-os fordítóhibát okoz. A hiba kijavításához módosítsa a paramétert, vagy adja vissza az érték típusát a Windows::Foundation::Collections::IVector értékre. További információ: Gyűjtemények (C++/CX).

Members

Nyilvános konstruktorok

Név Description
Vektor::Vektor Inicializálja a Vektor osztály új példányát.

Nyilvános metódusok

Név Description
Vektor::Hozzáfűzés Beszúrja a megadott elemet az aktuális vektor utolsó eleme után.
Vektor::Törlés Törli az aktuális vektor összes elemét.
Vektor::Első Egy iterátort ad vissza, amely megadja a vektor első elemét.
Vektor::GetAt Lekéri az aktuális vektor azon elemét, amelyet a megadott index azonosít.
Vektor::GetMany Az aktuális vektor elemeinek sorozatát kéri le a megadott indextől kezdve.
Vektor::GetView Egy vektor írásvédett nézetét adja vissza; vagyis egy platform::Collections::VectorView.
Vektor::IndexOf Megkeresi a megadott elemet az aktuális vektorban, és ha megtalálta, az elem indexét adja vissza.
Vektor::InsertAt A megadott elemet beszúrja az aktuális vektorba a megadott index által azonosított elemnél.
Vektor::ReplaceAll Törli az aktuális vektor elemeit, majd beszúrja az elemeket a megadott tömbből.
Vektor::RemoveAt Törli a megadott index által azonosított elemet az aktuális vektorból.
Vektor::RemoveAtEnd Törli az aktuális vektor végén lévő elemet.
Vektor::SetAt Hozzárendeli a megadott értéket az aktuális vektor azon eleméhez, amelyet a megadott index azonosít.
Vektor::Méret Az aktuális Vektor objektum elemeinek számát adja vissza.

Events

Név Description
esemény Windows::Foundation::Collection::VectorChangedEventHandler<T>^ VectorChanged Akkor fordul elő, ha a vektor megváltozik.

Öröklési hierarchia

Vector

Requirements

Fejléc: collection.h

Namespace: Platform::Gyűjtemények

Vektor::Append metódus

Beszúrja a megadott elemet az aktuális vektor utolsó eleme után.

Szemantika

virtual void Append(T item);

Paraméterek

index
A vektorba beszúrni kívánt elem. Az elem típusát a T típusnév határozza meg.

Vektor::Metódus törlése

Törli az aktuális vektor összes elemét.

Szemantika

virtual void Clear();

Vektor::Első metódus

Egy iterátort ad vissza, amely a vektor első elemére mutat.

Szemantika

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

Visszaadott érték

Egy iterátor, amely a vektor első elemére mutat.

Megjegyzések

A First() által visszaadott iterátor tárolásának kényelmes módja, ha a visszatérési értéket egy olyan változóhoz rendeli, amely a auto típuslevonási kulcsszóval deklarálva van. Például: auto x = myVector->First();. Ez az iterátor ismeri a gyűjtemény hosszát.

Ha egy STL-függvénynek való továbbításhoz iterátorpárra van szüksége, használja az ingyenes Windows::Foundation::Collections::begin és Windows::Foundation::Collections::end függvényeket

Vektor::GetAt metódus

Lekéri az aktuális vektor azon elemét, amelyet a megadott index azonosít.

Szemantika

virtual T GetAt(unsigned int index);

Paraméterek

index
Nulla alapú, aláíratlan egész szám, amely a Vektor objektum egy adott elemét adja meg.

Visszaadott érték

Az indexparaméter által megadott elem. Az elemtípust a T típusnév határozza meg.

Vektor::GetMany metódus

Lekéri az elemek sorozatát az aktuális vektorból a megadott indextől kezdve, és átmásolja őket a hívó által lefoglalt tömbbe.

Szemantika

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

Paraméterek

startIndex
A lekérni kívánt elemek elejének nulla alapú indexe.

dest
Hívó által lefoglalt elemek tömbje, amelyek a startIndex által megadott elemnél kezdődnek, és a vektor utolsó eleménél végződnek.

Visszaadott érték

A lekért elemek száma.

Megjegyzések

Ez a függvény nem közvetlenül ügyfélkód alapján való használatra szolgál. A to_vector függvény belsőleg használja a platform::vektorpéldányok std::vektorpéldányokra való hatékony átalakításának engedélyezéséhez.

Vektor::GetView metódus

Egy vektor írásvédett nézetét adja vissza; vagyis egy IVectorView.

Szemantika

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

Visszaadott érték

Egy IVectorView-objektum.

Vektor::IndexOf metódus

Megkeresi a megadott elemet az aktuális vektorban, és ha megtalálta, az elem indexét adja vissza.

Szemantika

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

Paraméterek

value
A keresendő elem.

index
Az elem nulla alapú indexe, ha paraméterérték található; ellenkező esetben 0.

Az indexparaméter 0, ha vagy az elem a Vektor első eleme, vagy az elem nem található. Ha a visszatérési érték az true, akkor az elem megtalálható, és ez az első elem, ellenkező esetben az elem nem található.

Visszaadott érték

trueha a megadott elem megtalálható; egyéb esetben. false

Megjegyzések

Az IndexOf az std::find_if használatával keresi meg az elemet. Az egyéni elemtípusoknak ezért túl kell terhelni az == és a != operátort, hogy lehetővé tegyék a find_if által megkövetelt egyenlőségi összehasonlításokat.

Vektor::InsertAt metódus

A megadott elemet beszúrja az aktuális vektorba a megadott index által azonosított elemnél.

Szemantika

virtual void InsertAt(unsigned int index, T item)

Paraméterek

index
Nulla alapú, aláíratlan egész szám, amely a Vektor objektum egy adott elemét adja meg.

item
Egy elem, amelyet be szeretne szúrni a vektorba az index által megadott elemnél. Az elem típusát a T típusnév határozza meg.

Vektor::RemoveAt metódus

Törli a megadott index által azonosított elemet az aktuális vektorból.

Szemantika

virtual void RemoveAt(unsigned int index);

Paraméterek

index
Nulla alapú, aláíratlan egész szám, amely a Vektor objektum egy adott elemét adja meg.

Vektor::RemoveAtEnd metódus

Törli az aktuális vektor végén lévő elemet.

Szemantika

virtual void RemoveAtEnd();

Vektor::ReplaceAll metódus

Törli az aktuális vektor elemeit, majd beszúrja az elemeket a megadott tömbből.

Szemantika

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

Paraméterek

Arr
Olyan objektumok tömbje, amelyek típusát a T típusnév határozza meg.

Vektor::SetAt metódus

Hozzárendeli a megadott értéket az aktuális vektor azon eleméhez, amelyet a megadott index azonosít.

Szemantika

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

Paraméterek

index
Nulla alapú, aláíratlan egész szám, amely a Vektor objektum egy adott elemét adja meg.

item
A megadott elemhez hozzárendelendő érték. Az elem típusát a T típusnév határozza meg.

Vektor::Méretmetódus

Az aktuális Vektor objektum elemeinek számát adja vissza.

Szemantika

virtual property unsigned int Size;

Visszaadott érték

Az aktuális vektor elemeinek száma.

Vektor::Vektorkonstruktor

Inicializálja a Vektor osztály új példányát.

Szemantika

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éterek

egy
A vektor inicializálásához használt std::tömb .

Arr
Egy platform::A vektor inicializálásához használt tömb.

Init
Az aktuális vektor inicializálásához használt objektumgyűjtemény típusa.

Il
A vektor inicializálásához használt T típusú objektumok std::initializer_list.

N
Az aktuális vektor inicializálásához használt objektumgyűjtemény elemeinek száma.

méret
A vektor elemeinek száma.

value
Az aktuális vektor egyes elemeinek inicializálására használt érték.

v
Lvalues és Rvalues to a std::vector, amely az aktuális vektor inicializálására szolgál.

ptr
std::vector Az aktuális vektor inicializálásához használt mutató.

first
Az aktuális vektor inicializálásához használt objektumok sorozatának első eleme. Az első típust tökéletes továbbítással adja át. További információ: Rvalue Reference Deklarátor: >.

utolsó
Az aktuális vektor inicializálásához használt objektumok sorozatának utolsó eleme. Az utolsó típust tökéletes továbbítással továbbítják. További információ: Rvalue Reference Deklarátor: >.

Lásd még

Gyűjtemények (C++/CX)
Platformnévtér
Windows futtatókörnyezeti összetevők létrehozása a C++ rendszerben