Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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ę wystąpień 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++