Platform::Collections::Vector Class
Mewakili kumpulan objek berurutan yang dapat diakses secara individual oleh indeks. Menerapkan 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 jenis T. Nilai defaultnya adalah std::equal_to<T>.
Keterangan
Jenis yang diperbolehkan:
bilangan bulat
kelas antarmuka^
kelas ref publik^
struktur nilai
kelas enum publik
Kelas Vektor adalah implementasi konkret C++ dari antarmuka Windows::Foundation::Collections::IVector .
Jika Anda mencoba menggunakan jenis Vektor dalam nilai atau parameter pengembalian publik, kesalahan pengkompilasi C3986 dimunculkan. Anda dapat memperbaiki kesalahan dengan mengubah parameter atau mengembalikan jenis nilai ke Windows::Foundation::Collections::IVector. Untuk informasi selengkapnya, lihat Koleksi (C++/CX).
Anggota
Konstruktor Publik
| Nama | Deskripsi |
|---|---|
| Vektor::Vector | Menginisialisasi instans baru kelas Vektor. |
Metode Publik
| Nama | Deskripsi |
|---|---|
| Vektor::Tambahkan | Sisipkan item yang ditentukan setelah item terakhir di Vektor saat ini. |
| Vektor::Clear | Menghapus semua elemen di Vektor saat ini. |
| Vektor::Pertama | Mengembalikan iterator yang menentukan elemen pertama di Vektor. |
| Vektor::GetAt | Mengambil elemen Vektor saat ini yang diidentifikasi oleh indeks yang ditentukan. |
| Vektor::GetMany | Mengambil urutan item dari Vektor saat ini, dimulai dari indeks yang ditentukan. |
| Vektor::GetView | Mengembalikan tampilan baca-saja dari Vektor; yaitu, Platform::Collections::VectorView. |
| Vektor::IndexOf | Mencari item yang ditentukan di 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::ReplaceAll | Menghapus elemen di Vektor saat ini lalu 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 di Vektor saat ini yang diidentifikasi oleh indeks yang ditentukan. |
| Vektor::Ukuran | Mengembalikan jumlah elemen dalam objek Vektor saat ini. |
Aktivitas
| Nama | Deskripsi |
|---|---|
| event Windows::Foundation::Collection::VectorChangedEventHandler<T>^ VectorChanged | Terjadi ketika Vektor berubah. |
Hierarki Warisan
Vector
Persyaratan
Header: collection.h
Namespace: Platform::Collections
Vektor::Tambahkan Metode
Sisipkan item yang ditentukan setelah item terakhir di Vektor saat ini.
Sintaks
virtual void Append(T item);
Parameter
index
Item yang akan disisipkan ke vektor. Jenis item didefinisikan oleh nama jenis T .
Vektor::Hapus Metode
Menghapus semua elemen di Vektor saat ini.
Sintaks
virtual void Clear();
Vektor::Metode Pertama
Mengembalikan iterator yang menunjuk ke elemen pertama di Vektor.
Sintaks
virtual Windows::Foundation::Collections::IIterator <T>^ First();
Tampilkan Nilai
Iterator yang menunjuk ke elemen pertama di Vektor.
Keterangan
Cara mudah untuk menahan iterator yang dikembalikan oleh First() adalah dengan menetapkan nilai pengembalian ke variabel yang dideklarasikan dengan auto kata kunci pengurangan jenis. Contohnya, auto x = myVector->First();. Iterator ini tahu panjang koleksi.
Ketika Anda memerlukan sepasang iterator untuk meneruskan ke fungsi STL, gunakan fungsi gratis Windows::Foundation::Collections::begin dan Windows::Foundation::Collections::end
Vektor::Metode GetAt
Mengambil elemen Vektor saat ini yang diidentifikasi oleh indeks yang ditentukan.
Sintaks
virtual T GetAt(unsigned int index);
Parameter
index
Bilangan bulat berbasis nol dan tidak ditandatangani yang menentukan elemen tertentu dalam objek Vektor.
Tampilkan Nilai
Elemen yang ditentukan oleh parameter indeks . Jenis elemen didefinisikan oleh nama jenis T .
Vektor::Metode GetMany
Mengambil urutan item dari Vektor saat ini, dimulai dari indeks yang ditentukan, dan menyalinnya ke array yang dialokasikan pemanggil.
Sintaks
virtual unsigned int GetMany(
unsigned int startIndex,
Platform::WriteOnlyArray<T>^ dest);
Parameter
startIndex
Indeks berbasis nol dari awal item yang akan diambil.
Dest
Array item yang dialokasikan pemanggil yang dimulai pada elemen yang ditentukan oleh startIndex dan berakhir pada elemen terakhir di 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 yang efisien dari Platform::Vector intances ke instans std::vector.
Vektor::Metode GetView
Mengembalikan tampilan baca-saja dari Vektor; yaitu, IVectorView.
Sintaks
Windows::Foundation::Collections::IVectorView<T>^ GetView();
Tampilkan Nilai
Objek IVectorView.
Vektor::IndexOf Method
Mencari item yang ditentukan di Vektor saat ini, dan jika ditemukan, mengembalikan indeks item.
Sintaks
virtual bool IndexOf(T value, unsigned int* index);
Parameter
value
Item yang akan ditemukan.
index
Indeks berbasis nol dari item jika nilai parameter ditemukan; jika tidak, 0.
Parameter indeks adalah 0 jika item adalah elemen pertama dari Vektor atau item tidak ditemukan. Jika nilai yang dikembalikan adalah true, item ditemukan dan merupakan 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
index
Bilangan bulat berbasis nol dan tidak ditandatangani yang menentukan elemen tertentu dalam objek Vektor.
item
Item yang akan disisipkan ke vektor pada elemen yang ditentukan oleh indeks. Jenis item didefinisikan oleh nama jenis T .
Vektor::RemoveAt Method
Menghapus elemen yang diidentifikasi oleh indeks yang ditentukan dari Vektor saat ini.
Sintaks
virtual void RemoveAt(unsigned int index);
Parameter
index
Bilangan bulat berbasis nol dan tidak ditandatangani yang menentukan elemen tertentu dalam objek Vektor.
Vektor::RemoveAtEnd Method
Menghapus elemen di akhir Vektor saat ini.
Sintaks
virtual void RemoveAtEnd();
Vektor::ReplaceAll Method
Menghapus elemen di Vektor saat ini lalu menyisipkan elemen dari array yang ditentukan.
Sintaks
virtual void ReplaceAll(const ::Platform::Array<T>^ arr);
Parameter
Arr
Array objek yang jenisnya ditentukan oleh T typename.
Vektor::Metode SetAt
Menetapkan nilai yang ditentukan ke elemen di Vektor saat ini yang diidentifikasi oleh indeks yang ditentukan.
Sintaks
virtual void SetAt(unsigned int index, T item);
Parameter
index
Bilangan bulat berbasis nol dan tidak ditandatangani yang menentukan elemen tertentu dalam objek Vektor.
item
Nilai yang akan ditetapkan ke elemen yang ditentukan. Jenis item didefinisikan oleh nama jenis 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 instans baru kelas Vektor.
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
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
Std::initializer_list objek jenis 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 di Vektor saat ini.
V
Lvalues dan Rvalues ke std::vector yang digunakan untuk menginisialisasi Vektor saat ini.
Ptr
Penunjuk std::vector ke yang digunakan untuk menginisialisasi Vektor saat ini.
first
Elemen pertama dalam urutan objek yang digunakan untuk menginisialisasi Vektor saat ini. Jenis pertama diteruskan 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 terakhir diteruskan dengan cara penerusan yang sempurna. Untuk informasi selengkapnya, lihat Deklarator Referensi Rvalue: &&&.
Baca juga
Koleksi (C++/CX)
Platform Namespace
Membuat Komponen Runtime Windows di C++
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk