Platform::Koleksi::Kelas Vektor

Mewakili kumpulan objek berurutan yang dapat diakses secara individual oleh indeks. Mengimplementasikan Windows::Foundation::Collections::IObservableVector untuk membantu pengikatan data XAML.

Sintaks

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

Parameter

T
Jenis elemen yang terkandung dalam objek Vektor.

E
Menentukan predikat biner untuk menguji kesetaraan dengan nilai tipe T. Nilai defaultnya adalah std::equal_to<T>.

Keterangan

Jenis yang diperbolehkan:

  1. bilangan bulat

  2. kelas antarmuka^

  3. kelas ref publik^

  4. struct nilai

  5. kelas enum publik

Kelas Vektor adalah implementasi konkret C ++ dari antarmuka Windows::Foundation::Collections::IVector.

Jika Anda mencoba menggunakan tipe Vektor dalam nilai pengembalian atau parameter publik, kesalahan kompiler C3986 dinaikkan. Anda dapat memperbaiki kesalahan dengan mengubah parameter atau mengembalikan tipe nilai ke Windows::Foundation::Collections::IVector. Untuk informasi selengkapnya, lihat Koleksi (C++/CX).

Anggota

Konstruktor Publik

Nama Deskripsi
Vektor::Vektor Menginisialisasi contoh baru dari kelas Vector.

Metode Publik

Nama Deskripsi
Vektor::Tambahkan Menyisipkan item yang ditentukan setelah item terakhir di Vector saat ini.
Vektor::Jelas Menghapus semua elemen dalam Vektor saat ini.
Vektor::Pertama Mengembalikan iterator yang menentukan elemen pertama dalam Vektor.
Vektor::GetAt Mengambil elemen Vektor saat ini yang didendeni oleh indeks yang ditentukan.
Vektor::GetMany Mengambil urutan item dari Vektor saat ini, dimulai pada indeks yang ditentukan.
Vektor::GetView Mengembalikan tampilan baca-saja vektor; yaitu, Platform::Collections::VectorView.
Vektor::IndexOf Mencari item yang ditentukan dalam Vektor saat ini, dan jika ditemukan, mengembalikan indeks item.
Vektor::InsertAt Menyisipkan item yang ditentukan ke dalam Vektor saat ini pada elemen yang diidentifikasi oleh indeks yang ditentukan.
Vektor::GantiSemua Menghapus elemen dalam Vektor saat ini dan kemudian menyisipkan elemen dari array yang ditentukan.
Vektor::RemoveAt Menghapus elemen yang diidentifikasi oleh indeks yang ditentukan dari Vektor saat ini.
Vektor::RemoveAtEnd Menghapus elemen di akhir Vektor saat ini.
Vektor::SetAt Menetapkan nilai yang ditentukan ke elemen dalam Vektor saat ini yang diidentifikasi oleh indeks yang ditentukan.
Vektor::Ukuran Mengembalikan jumlah elemen dalam objek Vektor saat ini.

Acara

Nama Deskripsi
Windows acara::Foundation::Collection::VectorChangedEventHandlerT<>^ VectorChanged Terjadi ketika vektor berubah.

Hierarki Pewarisan

Vector

Persyaratan

Header: collection.h

Ruang nama: Platform::Koleksi

Vektor::Metode Append

Menyisipkan item yang ditentukan setelah item terakhir di Vector saat ini.

Sintaks

virtual void Append(T item);

Parameter

indeks
Item yang akan dimasukkan ke dalam Vektor. Jenis item ditentukan oleh nama tipe T .

Vektor::Metode Yang Jelas

Menghapus semua elemen dalam Vektor saat ini.

Sintaks

virtual void Clear();

Vektor::Metode Pertama

Mengembalikan iterator yang menunjuk ke elemen pertama dalam Vektor.

Sintaks

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

Tampilkan Nilai

Iterator yang menunjuk ke elemen pertama dalam Vektor.

Keterangan

Cara mudah untuk menahan iterator yang dikembalikan oleh First() adalah dengan menetapkan nilai pengembalian ke variabel yang dideklarasikan auto dengan kata kunci deduksi tipe. Contohnya:auto x = myVector->First(); Iterator ini tahu panjang koleksinya.

Ketika Anda membutuhkan sepasang iterator untuk diteruskan ke fungsi STL, gunakan fungsi gratis Windows::Foundation::Collections::begin dan Windows::Foundation::Collections::end

Vektor::Metode GetAt

Mengambil elemen Vektor saat ini yang didendeni oleh indeks yang ditentukan.

Sintaks

virtual T GetAt(unsigned int index);

Parameter

indeks
Bilangan bulat berbasis nol yang tidak ditandatangani yang menentukan elemen tertentu dalam objek Vektor.

Tampilkan Nilai

Elemen yang ditentukan oleh parameter indeks . Tipe elemen ditentukan oleh nama tipe T .

Vektor::Metode GetMany

Mengambil urutan item dari Vektor saat ini, dimulai pada indeks yang ditentukan, dan menyalinnya ke dalam array yang dialokasikan pemanggil.

Sintaks

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

Parameter

startIndex
Indeks berbasis nol dari awal item untuk diambil.

dest
Array item yang dialokasikan pemanggil yang dimulai pada elemen yang ditentukan oleh startIndex dan berakhir pada elemen terakhir dalam Vektor.

Tampilkan Nilai

Jumlah item yang diambil.

Keterangan

Fungsi ini tidak dimaksudkan untuk digunakan langsung oleh kode klien. Ini digunakan secara internal dalam Fungsi to_vector untuk memungkinkan konversi platform yang efisien::Vector intances ke instans std::vector.

Vektor::Metode GetView

Mengembalikan tampilan baca-saja vektor; yaitu, IVectorView.

Sintaks

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

Tampilkan Nilai

Objek IVectorView.

Vektor::Metode IndexOf

Mencari item yang ditentukan dalam Vektor saat ini, dan jika ditemukan, mengembalikan indeks item.

Sintaks

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

Parameter

value
Item yang harus ditemukan.

indeks
Indeks item berbasis nol jika nilai parameter ditemukan; jika tidak, 0.

Parameter indeks adalah 0 jika item adalah elemen pertama dari Vektor atau item tidak ditemukan. Jika nilai pengembalian adalah true, item ditemukan dan itu adalah elemen pertama; jika tidak, item tidak ditemukan.

Tampilkan Nilai

true jika item yang ditentukan ditemukan; jika tidak, false.

Keterangan

IndexOf menggunakan std::find_if untuk menemukan item. Oleh karena itu, jenis elemen kustom harus membebani operator == dan != untuk mengaktifkan perbandingan kesetaraan yang find_if butuhkan.

Vektor::Metode InsertAt

Menyisipkan item yang ditentukan ke dalam Vektor saat ini pada elemen yang diidentifikasi oleh indeks yang ditentukan.

Sintaks

virtual void InsertAt(unsigned int index, T item)

Parameter

indeks
Bilangan bulat berbasis nol yang tidak ditandatangani yang menentukan elemen tertentu dalam objek Vektor.

item
Item untuk dimasukkan ke dalam Vektor pada elemen yang ditentukan oleh indeks. Jenis item ditentukan oleh nama tipe T .

Vektor::Metode RemoveAt

Menghapus elemen yang diidentifikasi oleh indeks yang ditentukan dari Vektor saat ini.

Sintaks

virtual void RemoveAt(unsigned int index);

Parameter

indeks
Bilangan bulat berbasis nol yang tidak ditandatangani yang menentukan elemen tertentu dalam objek Vektor.

Vektor::Metode RemoveAtEnd

Menghapus elemen di akhir Vektor saat ini.

Sintaks

virtual void RemoveAtEnd();

Vektor::Ganti Semua Metode

Menghapus elemen dalam Vektor saat ini dan kemudian menyisipkan elemen dari array yang ditentukan.

Sintaks

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

Parameter

arr
Array objek yang jenisnya ditentukan oleh nama tipe T .

Vektor::Metode SetAt

Menetapkan nilai yang ditentukan ke elemen dalam Vektor saat ini yang diidentifikasi oleh indeks yang ditentukan.

Sintaks

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

Parameter

indeks
Bilangan bulat berbasis nol yang tidak ditandatangani yang menentukan elemen tertentu dalam objek Vektor.

item
Nilai untuk menetapkan ke elemen yang ditentukan. Jenis item ditentukan oleh nama tipe T .

Vektor::Metode Ukuran

Mengembalikan jumlah elemen dalam objek Vektor saat ini.

Sintaks

virtual property unsigned int Size;

Tampilkan Nilai

Jumlah elemen dalam Vektor saat ini.

Vektor::Konstruktor Vektor

Menginisialisasi contoh baru dari kelas Vector.

Sintaks

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);

Parameter

a
Sebuah std::array yang akan digunakan untuk menginisialisasi Vektor.

arr
Platform ::Array yang akan digunakan untuk menginisialisasi Vektor.

Init
Jenis kumpulan objek yang digunakan untuk menginisialisasi Vektor saat ini.

il
A std::initializer_list objek tipe T yang akan digunakan untuk menginisialisasi Vektor.

N
Jumlah elemen dalam kumpulan objek yang digunakan untuk menginisialisasi Vektor saat ini.

ukuran
Jumlah elemen dalam Vektor.

value
Nilai yang digunakan untuk menginisialisasi setiap elemen dalam Vektor saat ini.

v
Sebuah Lvalues dan Rvalues ke std::vector yang digunakan untuk menginisialisasi Vector saat ini.

ptr
Pointer ke a std::vector yang digunakan untuk menginisialisasi Vektor saat ini.

first
Elemen pertama dalam urutan objek yang digunakan untuk menginisialisasi Vektor saat ini. Jenis yang pertama dilewatkan dengan cara penerusan yang sempurna. Untuk informasi selengkapnya, lihat Deklarator Referensi Rvalue: &&.

last
Elemen terakhir dalam urutan objek yang digunakan untuk menginisialisasi Vektor saat ini. Jenis yang terakhir dilewatkan dengan cara penerusan yang sempurna. Untuk informasi selengkapnya, lihat Deklarator Referensi Rvalue: &&.

Lihat juga

Koleksi (C++/CX)
Ruang Nama Platform
Membuat Komponen Windows 运行时 dalam C ++