Platform::Collections::Vector – třída
Představuje sekvenční kolekci objektů, ke kterým lze přistupovat jednotlivě pomocí indexu. Implementuje Windows::Foundation::Collections::IObservableVector, který pomáhá s datovou vazbou XAML.
Syntaxe
template <typename T, typename E>
ref class Vector sealed;
Parametry
T
Typ elementů obsažených v Vector objektu.
E
Určuje binární predikát pro testování rovnosti s hodnotami typu T. Výchozí hodnota je std::equal_to<T>.
Poznámky
Povolené typy jsou:
integers
interface – třída^
public ref – třída^
value – struktura
public enum – třída
Třída Vector je konkrétní implementace C++ rozhraní Windows::Foundation::Collections::IVector rozhraní.
Pokud se pokusíte použít typ vektoru ve veřejné návratové hodnotě nebo parametru, je vyvolána chyba kompilátoru C3986. Chybu můžete opravit změnou parametru nebo návratového typu hodnoty na Windows::Foundation::Collections::IVector. Další informace najdete v tématu Kolekce (C++/CX).
Členové
Veřejné konstruktory
| Název | Popis |
|---|---|
| Vector::Vector | Inicializuje novou instanci Vector třídy. |
Veřejné metody
| Název | Popis |
|---|---|
| Vector::Append | Vloží za poslední položku v aktuálním vektoru za poslední položku. |
| Vector::Clear | Odstraní všechny prvky v aktuálním vektoru. |
| Vector::First | Vrátí iterátor, který určuje první prvek vektoru. |
| Vector::GetAt | Načte prvek aktuální Vector, který je identifikován zadaným indexem. |
| Vector::GetMany | Načte posloupnost položek z aktuálního vektoru počínaje zadaným indexem. |
| Vector::GetView | Vrátí zobrazení vektoru jen pro čtení; to znamená Platform::Collections::VectorView. |
| Vector::IndexOf | Vyhledá zadanou položku v aktuálním vektoru a pokud se najde, vrátí index položky. |
| Vector::InsertAt | Vloží zadanou položku do aktuálního vectoru na prvek identifikovaný zadaným indexem. |
| Vector::ReplaceAll | Odstraní prvky v aktuálním vektoru a potom vloží prvky ze zadaného pole. |
| Vector::RemoveAt | Odstraní prvek identifikovaný zadaným indexem z aktuální vector. |
| Vector::RemoveAtEnd | Odstraní prvek na konci aktuální vector. |
| Vector::SetAt | Přiřadí zadanou hodnotu prvku v aktuálním vektoru, který je identifikován zadaným indexem. |
| Vector::Size | Vrátí počet prvků v aktuálním Vector objektu. |
Událost
| Název | Popis |
|---|---|
| událost Windows::Foundation::Collection::VectorChangedEventHandler<T>^ VectorChanged | Nastane při změně vektoru. |
Hierarchie dědičnosti
Vector
Požadavky
Hlavička: collection.h
Obor názvů: Platform::Collections
Vector::Append – metoda
Vloží za poslední položku v aktuálním vektoru za poslední položku.
Syntaxe
virtual void Append(T item);
Parametry
Index
Položka, kterou chcete vložit do vektoru. Typ položky je definován názvem typu T .
Vector::Clear – metoda
Odstraní všechny prvky v aktuálním vektoru.
Syntaxe
virtual void Clear();
Vector::First – metoda
Vrátí iterátor, který odkazuje na první prvek vektoru.
Syntaxe
virtual Windows::Foundation::Collections::IIterator <T>^ First();
Vrácená hodnota
Iterátor, který odkazuje na první prvek vektoru.
Poznámky
Pohodlný způsob, jak uchovávat iterátor vrácený First() je přiřadit návratovou hodnotu proměnné, která je deklarována pomocí klíčového slova odpočtu auto typu. Například auto x = myVector->First();. Tento iterátor zná délku kolekce.
Pokud potřebujete pár iterátorů pro předání do funkce STL, použijte bezplatné funkce Windows::Foundation::Collections::begin a Windows::Foundation::Collections::end
Vector::GetAt – metoda
Načte prvek aktuální Vector, který je identifikován zadaným indexem.
Syntaxe
virtual T GetAt(unsigned int index);
Parametry
Index
Bez znaménka bez znaménka, která určuje konkrétní prvek v Vector objektu.
Vrácená hodnota
Element určený parametrem indexu. Typ elementu je definován názvem typu T .
Vector::GetMany – metoda
Načte posloupnost položek z aktuálního vektoru počínaje zadaným indexem a zkopíruje je do pole přidělené volajícího.
Syntaxe
virtual unsigned int GetMany(
unsigned int startIndex,
Platform::WriteOnlyArray<T>^ dest);
Parametry
Startindex
Index založený na nule začátku položek, které se mají načíst.
Dest
Pole položek přidělených volajícím, které začínají na prvku určeném parametrem startIndex a končí posledním prvkem v vector.
Vrácená hodnota
Počet načtených položek.
Poznámky
Tato funkce není určená přímo kódem klienta. Používá se interně ve funkci to_vector, která umožňuje efektivní převod platform::Vector intances na std::vector instance.
Vector::GetView – metoda
Vrátí zobrazení vektoru jen pro čtení; to znamená IVectorView.
Syntaxe
Windows::Foundation::Collections::IVectorView<T>^ GetView();
Vrácená hodnota
Objekt IVectorView.
Vector::IndexOf – metoda
Vyhledá zadanou položku v aktuálním vektoru a pokud se najde, vrátí index položky.
Syntaxe
virtual bool IndexOf(T value, unsigned int* index);
Parametry
value
Položka, kterou chcete najít.
Index
Index položky založený na nule, pokud je nalezena hodnota parametru, jinak 0.
Parametr indexu je 0, pokud je položka prvním prvkem Vector nebo položka nebyla nalezena. Pokud je truevrácená hodnota , položka byla nalezena a jedná se o první prvek, jinak položka nebyla nalezena.
Vrácená hodnota
trueje-li nalezena zadaná položka; v opačném případě . false
Poznámky
IndexOf k vyhledání položky používá std::find_if. Vlastní typy prvků by proto měly přetížit operátor == a !=, aby bylo možné porovnání rovnosti, které find_if vyžaduje.
Vector::InsertAt – metoda
Vloží zadanou položku do aktuálního vectoru na prvek identifikovaný zadaným indexem.
Syntaxe
virtual void InsertAt(unsigned int index, T item)
Parametry
Index
Bez znaménka bez znaménka, která určuje konkrétní prvek v Vector objektu.
Položky
Položka, která se má vložit do Vector v elementu určeném indexem. Typ položky je definován názvem typu T .
Vector::RemoveAt – metoda
Odstraní prvek identifikovaný zadaným indexem z aktuální vector.
Syntaxe
virtual void RemoveAt(unsigned int index);
Parametry
Index
Bez znaménka bez znaménka, která určuje konkrétní prvek v Vector objektu.
Vector::RemoveAtEnd – metoda
Odstraní prvek na konci aktuální vector.
Syntaxe
virtual void RemoveAtEnd();
Vector::ReplaceAll – metoda
Odstraní prvky v aktuálním vektoru a potom vloží prvky ze zadaného pole.
Syntaxe
virtual void ReplaceAll(const ::Platform::Array<T>^ arr);
Parametry
Arr
Pole objektů, jejichž typ je definován názvem typu T .
Vector::SetAt – metoda
Přiřadí zadanou hodnotu prvku v aktuálním vektoru, který je identifikován zadaným indexem.
Syntaxe
virtual void SetAt(unsigned int index, T item);
Parametry
Index
Bez znaménka bez znaménka, která určuje konkrétní prvek v Vector objektu.
Položky
Hodnota, která se má přiřadit k zadanému prvku. Typ položky je definován názvem typu T .
Vector::Size – metoda
Vrátí počet prvků v aktuálním Vector objektu.
Syntaxe
virtual property unsigned int Size;
Vrácená hodnota
Počet prvků v aktuálním vektoru.
Vector::Vector – konstruktor
Inicializuje novou instanci Vector třídy.
Syntaxe
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);
Parametry
A
Pole std::array , které se použije k inicializaci vektoru.
Arr
A Platform::Array , která se použije k inicializaci vektoru.
Init
Typ kolekce objektů, které se používají k inicializaci aktuální vector.
Il
Std ::initializer_list objektů typu T , které budou použity k inicializaci Vector.
N
Počet prvků v kolekci objektů, které se používají k inicializaci current Vector.
Velikost
Počet prvků v vektoru.
value
Hodnota, která se používá k inicializaci každého prvku v current Vector.
V
Hodnota Lvalues a Rvalues to a std::vector , která se používá k inicializaci aktuálního vektoru.
ptr
Ukazatel na inicializaci std::vector aktuálního vektoru.
První
První prvek v posloupnosti objektů, které se používají k inicializaci current Vector. Typ prvního se předává pomocí dokonalého přeposílání. Další informace naleznete v tématu Referenční deklarátor Rvalue: &>.
Poslední
Poslední prvek v posloupnosti objektů, které se používají k inicializaci current Vector. Typ poslední je předán pomocí dokonalého přeposílání. Další informace naleznete v tématu Referenční deklarátor Rvalue: &>.
Viz také
Kolekce (C++/CX)
Obor názvů platformy
Vytváření komponent prostředí Windows Runtime v jazyce C++
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro