Platform::Collections::VectorView-Klasse

Stellt eine schreibgeschützte Ansicht einer sequenziellen Auflistung von Objekten dar, auf die einzeln nach Index zugegriffen werden kann. Der Typ der einzelnen Objekte in der Auflistung wird durch den Vorlagenparameter spezifiziert.

Syntax

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

Parameter

T
Der Typ der im VectorView -Objekt enthaltenen Elemente.

E
Gibt ein binäres Prädikat zum Testen der Übereinstimmung mit Werten des Typs Tan. Der Standardwert ist std::equal_to<T>.

Hinweise

Die VectorView Klasse implementiert die Windows::Foundation::Collections::IVectorView<T-Schnittstelle> und unterstützung für Standardvorlagenbibliothek-Iteratoren.

Mitglieder

Öffentliche Konstruktoren

Name	Beschreibung
VectorView::VectorView	Initialisiert eine neue Instanz der VectorView-Klasse.

Öffentliche Methoden

Name	Beschreibung
VectorView::First	Gibt einen Iterator zurück, der das erste Element in der VectorView angibt.
VectorView::GetAt	Ruft das Element der aktuellen VectorView ab, das durch den angegebenen Index bezeichnet wird.
VectorView::GetMany	Ruft eine Sequenz von Elementen von der aktuellen VectorView ab, die am angegebenen Index beginnt.
VectorView::IndexOf	Sucht das angegebene Element in der aktuellen VectorView und gibt, wenn es gefunden wurde, den Index des Elements zurück.
VectorView::Size	Gibt die Anzahl von Elementen im aktuellen VectorView-Objekt zurück.

Vererbungshierarchie

VectorView

Anforderungen

Header: collection.h

Namespace: Platform::Collections

VectorView::First-Methode

Gibt einen Iterator zurück, der das erste Element in der VectorView angibt.

Syntax

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

Rückgabewert

Ein Iterator, der das erste Element in der VectorView angibt.

Hinweise

Eine bequeme Möglichkeit zum Speichern des iterators, der von First() zurückgegeben wird, ist das Zuweisen des Rückgabewerts zu einer Variablen, die mit dem auto Typabzug Schlüsselwort (keyword) deklariert wird. Beispielsweise auto x = myVectorView->First();.

VectorView::GetAt-Methode

Ruft das Element der aktuellen VectorView ab, das durch den angegebenen Index bezeichnet wird.

Syntax

T GetAt(
   UInt32 index
);

Parameter

Index
Eine nullbasierte ganze Zahl, die ein bestimmtes Element im VectorView-Objekt angibt.

Rückgabewert

Das Element, das durch den index-Parameter spezifiziert wird. Der Elementtyp wird durch den VectorView-Vorlagenparameter T angegeben.

VectorView::GetMany-Methode

Ruft eine Sequenz von Elementen von der aktuellen VectorView ab, die am angegebenen Index beginnt.

Syntax

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

Parameter

startIndex
Der nullbasierte Index des Anfangs der Elemente, die abgerufen werden sollen.

dest
Wenn die Operation abgeschlossen wird, ein Array von Elementen, die bei dem Element beginnen, das durch startIndex angegeben ist, und beim letzten Element im Vektor enden.

Rückgabewert

Die Anzahl der abgerufenen Elemente.

VectorView::IndexOf-Methode

Sucht das angegebene Element in der aktuellen VectorView und gibt, wenn es gefunden wurde, den Index des Elements zurück.

Syntax

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

Parameter

value
Das Element, das gesucht werden soll.

Index
Der nullbasierte Index des Elements, wenn der Parameter value gefunden wurde, andernfalls 0.

Der Indexparameter ist 0, wenn es sich bei dem Element entweder um das erste Element des Elements VectorView handelt oder das Element nicht gefunden wurde. Wenn der Rückgabewert lautet true, wurde das Element gefunden, und es handelt sich um das erste Element. Andernfalls wurde das Element nicht gefunden.

Rückgabewert

truewenn das angegebene Element gefunden wird; andernfalls . false

VectorView::Size-Methode

Gibt die Anzahl von Elementen im aktuellen VectorView-Objekt zurück.

Syntax

virtual property unsigned int Size;

Rückgabewert

Die Anzahl der Elemente in der aktuellen VectorView.

VectorView::VectorView-Konstruktor

Initialisiert eine neue Instanz der VectorView-Klasse.

Syntax

VectorView();
explicit VectorView(
   UInt32 size
);
VectorView(
   UInt32 size,
   T value
);
explicit VectorView(
   const ::std::vector<T>& v
);
explicit VectorView(
   ::std::vector<T>&& v
);
VectorView(
   const T * ptr,
   UInt32 size
);

template <
   size_t N
>
explicit VectorView(
   const T (&arr)[N]
);

template <
   size_t N
>
explicit VectorView(
   const ::std::array<T,
   N>& a
);

explicit VectorView(
   const ::Platform::Array<T>^ arr
);

template <
   typename InIt
>
VectorView(
   InItfirst,
   InItlast
);

VectorView(
   std::initializer_list<T> il
);

Parameter

Init
Der Typ einer Auflistung von Objekten, die verwendet wird, um die aktuelle VectorView zu initialisieren.

Il
Ein std::initializer_list , dessen Elemente zum Initialisieren der VectorView verwendet werden.

N
Die Anzahl von Elementen in einer Auflistung von Objekten, die verwendet wird, um die aktuelle VectorView zu initialisieren.

size
Die Anzahl von Elementen in der VectorView.

value
Ein Wert, der verwendet wird, um die einzelnen Elemente in der aktuellen VectorView zu initialisieren.

v
Lvalues und Rvalues to a std::vector that is used to initialize the current VectorView.

ptr
Zeiger zu std::vector, der verwendet wird, um die aktuelle VectorView zu initialisieren.

Arr
Ein Platform::Array-Objekt , das zum Initialisieren der aktuellen VectorView verwendet wird.

a
Ein std::array-Objekt , das zum Initialisieren der aktuellen VectorView verwendet wird.

first
Das erste Element in einer Sequenz von Objekten, die verwendet werden, um die aktuelle VectorView zu initialisieren. Der Typ wird first durch perfekte Weiterleitung übergeben. Weitere Informationen finden Sie unter RValue-Verweisdeklarator: &&.

last
Das letzte Element in einer Sequenz von Objekten, die verwendet werden, um die aktuelle VectorView zu initialisieren. Der Typ wird last durch perfekte Weiterleitung übergeben. Weitere Informationen finden Sie unter RValue-Verweisdeklarator: &&.

Siehe auch

Plattformnamespace
Erstellen von Komponenten für Windows-Runtime in C++