Platform::Collections::Vector, klasa
Reprezentuje sekwencyjną kolekcję obiektów, do których można uzyskać dostęp indywidualnie według indeksu. Implementuje element Windows::Foundation::Collections::IObservableVector, aby ułatwić powiązanie danych XAML.
Składnia
template <typename T, typename E>
ref class Vector sealed;
Parametry
T
Typ elementów zawartych w obiekcie Vector.
E
Określa predykat binarny do testowania równości z wartościami typu T. Wartość domyślna to std::equal_to<T>.
Uwagi
Dozwolone typy to:
integers
interface, klasa^
public ref class^
value, struktura
public enum, klasa
Klasa Vector jest konkretną implementacją systemu Windows::Foundation::Collections::IVector .
Jeśli próbujesz użyć typu wektora w publicznej wartości zwracanej lub parametru, zostanie zgłoszony błąd kompilatora C3986. Błąd można naprawić, zmieniając parametr lub zwracany typ wartości na Windows::Foundation::Collections::IVector. Aby uzyskać więcej informacji, zobacz Kolekcje (C++/CX).
Elementy członkowskie
Konstruktory publiczne
| Nazwa/nazwisko | opis |
|---|---|
| Vector::Vector | Inicjuje nowe wystąpienie klasy Vector. |
Metody publiczne
| Nazwa/nazwisko | opis |
|---|---|
| Vector::Append | Wstawia określony element po ostatnim elemencie w bieżącym wektorze. |
| Vector::Clear | Usuwa wszystkie elementy w bieżącym wektorze. |
| Vector::First | Zwraca iterator, który określa pierwszy element w wektorze. |
| Vector::GetAt | Pobiera element bieżącego wektora, który jestdentifed przez określony indeks. |
| Vector::GetMany | Pobiera sekwencję elementów z bieżącego wektora, zaczynając od określonego indeksu. |
| Vector::GetView | Zwraca widok tylko do odczytu wektora; czyli Platform::Collections::VectorView. |
| Vector::IndexOf | Wyszukuje określony element w bieżącym wektorze, a jeśli zostanie znaleziony, zwraca indeks elementu. |
| Vector::InsertAt | Wstawia określony element do bieżącego wektora w elemencie zidentyfikowanym przez określony indeks. |
| Vector::ReplaceAll | Usuwa elementy w bieżącym wektorze, a następnie wstawia elementy z określonej tablicy. |
| Vector::RemoveAt | Usuwa element zidentyfikowany przez określony indeks z bieżącego wektora. |
| Vector::RemoveAtEnd | Usuwa element na końcu bieżącego wektora. |
| Vector::SetAt | Przypisuje określoną wartość do elementu w bieżącym wektorze, który jest identyfikowany przez określony indeks. |
| Vector::Size | Zwraca liczbę elementów w bieżącym obiekcie Vector. |
Zdarzenia
| Nazwa/nazwisko | opis |
|---|---|
| zdarzenie Windows::Foundation::Collection::VectorChangedEventHandler<T>^ VectorChanged | Występuje, gdy wektor zmienia się. |
Hierarchia dziedziczenia
Vector
Wymagania
Nagłówek: collection.h
Przestrzeń nazw: Platform::Collections
Vector::Append, metoda
Wstawia określony element po ostatnim elemencie w bieżącym wektorze.
Składnia
virtual void Append(T item);
Parametry
indeks
Element do wstawienia do wektora. Typ elementu jest definiowany przez nazwę typu T.
Vector::Clear, metoda
Usuwa wszystkie elementy w bieżącym wektorze.
Składnia
virtual void Clear();
Vector::First, metoda
Zwraca iterator wskazujący pierwszy element w wektorze.
Składnia
virtual Windows::Foundation::Collections::IIterator <T>^ First();
Wartość zwracana
Iterator wskazujący pierwszy element w wektorze.
Uwagi
Wygodnym sposobem przechowywania iteratora zwróconego przez first() jest przypisanie wartości zwracanej do zmiennej zadeklarowanej za pomocą słowa kluczowego auto odliczenia typu. Na przykład auto x = myVector->First();. Ten iterator zna długość kolekcji.
Jeśli potrzebujesz pary iteratorów do przekazania do funkcji STL, użyj bezpłatnych funkcji Windows::Foundation::Collections::begin i Windows::Foundation::Foundation::Collections::end
Vector::GetAt, metoda
Pobiera element bieżącego wektora, który jestdentifed przez określony indeks.
Składnia
virtual T GetAt(unsigned int index);
Parametry
indeks
Liczba całkowita bez znaku, która określa określony element w obiekcie Vector.
Wartość zwracana
Element określony przez parametr indeksu. Typ elementu jest definiowany przez nazwę typu T .
Vector::GetMany, metoda
Pobiera sekwencję elementów z bieżącego wektora, zaczynając od określonego indeksu, i kopiuje je do tablicy przydzielonej przez obiekt wywołujący.
Składnia
virtual unsigned int GetMany(
unsigned int startIndex,
Platform::WriteOnlyArray<T>^ dest);
Parametry
startIndex
Indeks zerowy początku elementów do pobrania.
dest
Przydzielona przez obiekt wywołujący tablica elementów rozpoczynających się od elementu określonego przez właściwość startIndex i kończąca się na ostatnim elemenie w wektorze.
Wartość zwracana
Liczba pobranych elementów.
Uwagi
Ta funkcja nie jest przeznaczona do użytku bezpośrednio przez kod klienta. Jest ona używana wewnętrznie w funkcji to_vector, aby umożliwić wydajną konwersję intance platform::Vector na wystąpienia std::vector.
Vector::GetView, metoda
Zwraca widok tylko do odczytu wektora; oznacza to, IVectorView.
Składnia
Windows::Foundation::Collections::IVectorView<T>^ GetView();
Wartość zwracana
Obiekt IVectorView.
Vector::IndexOf, metoda
Wyszukuje określony element w bieżącym wektorze, a jeśli zostanie znaleziony, zwraca indeks elementu.
Składnia
virtual bool IndexOf(T value, unsigned int* index);
Parametry
wartość
Element do znalezienia.
indeks
Indeks zerowy elementu, jeśli zostanie znaleziona wartość parametru; w przeciwnym razie 0.
Parametr indeksu to 0, jeśli element jest pierwszym elementem Vector lub nie znaleziono elementu. Jeśli zwracana wartość to true, element został znaleziony i jest to pierwszy element; w przeciwnym razie element nie został znaleziony.
Wartość zwracana
true jeśli określony element zostanie znaleziony; w przeciwnym razie, false.
Uwagi
Funkcja IndexOf używa elementu std::find_if w celu znalezienia elementu. W związku z tym niestandardowe typy elementów powinny przeciążać operator == i != w celu włączenia porównań równości, które find_if wymaga.
Vector::InsertAt, metoda
Wstawia określony element do bieżącego wektora w elemencie zidentyfikowanym przez określony indeks.
Składnia
virtual void InsertAt(unsigned int index, T item)
Parametry
indeks
Liczba całkowita bez znaku, która określa określony element w obiekcie Vector.
przedmiot
Element do wstawiania do elementu Vector w elemencie określonym przez indeks. Typ elementu jest definiowany przez nazwę typu T.
Vector::RemoveAt, metoda
Usuwa element zidentyfikowany przez określony indeks z bieżącego wektora.
Składnia
virtual void RemoveAt(unsigned int index);
Parametry
indeks
Liczba całkowita bez znaku, która określa określony element w obiekcie Vector.
Vector::RemoveAtEnd, metoda
Usuwa element na końcu bieżącego wektora.
Składnia
virtual void RemoveAtEnd();
Vector::ReplaceAll, metoda
Usuwa elementy w bieżącym wektorze, a następnie wstawia elementy z określonej tablicy.
Składnia
virtual void ReplaceAll(const ::Platform::Array<T>^ arr);
Parametry
Arr
Tablica obiektów, których typ jest definiowany przez typ T typename.
Vector::SetAt, metoda
Przypisuje określoną wartość do elementu w bieżącym wektorze, który jest identyfikowany przez określony indeks.
Składnia
virtual void SetAt(unsigned int index, T item);
Parametry
indeks
Liczba całkowita bez znaku, która określa określony element w obiekcie Vector.
przedmiot
Wartość do przypisania do określonego elementu. Typ elementu jest definiowany przez nazwę typu T.
Vector::Size, metoda
Zwraca liczbę elementów w bieżącym obiekcie Vector.
Składnia
virtual property unsigned int Size;
Wartość zwracana
Liczba elementów w bieżącym wektorze.
Vector::Vector, konstruktor
Inicjuje nowe wystąpienie klasy Vector.
Składnia
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
Tablica std:: , która będzie używana do inicjowania wektora.
Arr
Platforma::Tablica, która będzie używana do inicjowania wektora.
Init
Typ kolekcji obiektów używanych do inicjowania bieżącego wektora.
Il
Std ::initializer_list obiektów typu T , które będą używane do inicjowania wektora.
N
Liczba elementów w kolekcji obiektów używanych do inicjowania bieżącego wektora.
rozmiar
Liczba elementów w wektorze.
wartość
Wartość używana do inicjowania każdego elementu w bieżącym wektorze.
v
Wartości Lvalue i Rvalues do wektora std::, który jest używany do inicjowania bieżącego wektora .
ptr
Wskaźnik do std::vector , który jest używany do inicjowania bieżącego wektora.
pierwszy
Pierwszy element w sekwencji obiektów używanych do inicjowania bieżącego wektora. Typ pierwszego jest przekazywany za pomocą doskonałego przekazywania. Aby uzyskać więcej informacji, zobacz Rvalue Reference Deklarator: &&.
ostatni
Ostatni element w sekwencji obiektów używanych do inicjowania bieżącego wektora. Typ ostatniego jest przekazywany za pomocą doskonałego przekazywania. Aby uzyskać więcej informacji, zobacz Rvalue Reference Deklarator: &&.
Zobacz też
Kolekcje (C++/CX)
Przestrzeń nazw platformy
Tworzenie składników środowisko wykonawcze systemu Windows w języku C++