Koleksi (C++/CX)

Dalam program C++/CX, Anda dapat menggunakan kontainer Standard Template Library (STL) secara gratis, atau jenis koleksi lain yang ditentukan pengguna. Namun, ketika Anda meneruskan koleksi bolak-balik di seluruh antarmuka biner aplikasi Windows Runtime (ABI)—misalnya, ke kontrol XAML atau ke klien JavaScript—Anda harus menggunakan jenis koleksi Windows Runtime.

Windows Runtime mendefinisikan antarmuka untuk koleksi dan jenis terkait, dan C++/CX menyediakan implementasi C++ konkret dalam file header collection.h. Ilustrasi ini memperlihatkan hubungan antara jenis koleksi:

Diagram pohon warisan C plus plus C X untuk jenis koleksi.

Kelas Platform::Collections::Vector menyerupai kelas std::vector.
Kelas Platform::Collections::Map menyerupai kelas std::map.
Platform::Collections::VectorView kelas dan Platform::Collections::MapView kelas adalah versi hanya-baca dari Vector dan Map.
Iterator didefinisikan dalam Platform::Collections Namespace. Iterator ini memenuhi persyaratan untuk iterator STL dan memungkinkan penggunaan std::find, std::count_if, dan algoritma STL lainnya pada jenis antarmuka apa pun Windows::Foundation::Collections atau jenis konkret Platform::Collections. Misalnya, ini berarti Anda dapat melakukan iterasi koleksi dalam komponen Windows Runtime yang dibuat di C# dan menerapkan algoritma STL ke dalamnya.

Important

Iterator VectorIterator proksi dan VectorViewIterator gunakan objek VectorProxy<T> proksi dan ArrowProxy<T> untuk mengaktifkan penggunaan dengan kontainer STL. Untuk informasi selengkapnya, lihat elemen VectorProxy nanti di artikel ini.
Jenis koleksi C++/CX mendukung jaminan keamanan utas yang sama yang didukung kontainer STL.
Windows::Foundation::Collections::IObservableVector dan Windows::Foundation::Collections::IObservableMap mendefinisikan peristiwa yang diaktifkan ketika koleksi berubah dalam berbagai cara. Dengan menerapkan antarmuka ini, Platform::Collections::Map dan Platform::Collections::Vector mendukung pengikatan data dengan koleksi XAML. Misalnya, jika Anda memiliki Vector yang terikat data ke Grid, saat Anda menambahkan item ke koleksi, perubahan tercermin dalam UI Kisi.

Penggunaan vektor

Ketika kelas Anda harus meneruskan kontainer urutan ke komponen Windows Runtime lain, gunakan Windows::Foundation::Collections::IVector<T> sebagai parameter atau jenis pengembalian, dan Platform::Collections::Vector<T> sebagai implementasi konkret. Jika Anda mencoba menggunakan Vector jenis dalam nilai atau parameter pengembalian publik, kesalahan pengkompilasi C3986 akan dimunculkan. Anda dapat memperbaiki kesalahan dengan mengubah ke VectorIVector.

Important

Jika Anda melewati urutan dalam program Anda sendiri, maka gunakan salah satu Vector atau std::vector karena mereka lebih efisien daripada IVector. Gunakan IVector hanya saat Anda meneruskan kontainer di seluruh ABI.

Sistem jenis Windows Runtime tidak mendukung konsep array berjatuhan dan oleh karena itu Anda tidak dapat meneruskan IVector<Platform::Array<T>> sebagai nilai pengembalian atau parameter metode. Untuk meneruskan array berjatuhan atau urutan urutan di seluruh ABI, gunakan IVector<IVector<T>^>.

Vector<T> menyediakan metode yang diperlukan untuk menambahkan, menghapus, dan mengakses item dalam koleksi, dan secara implisit dapat dikonversi ke IVector<T>. Anda juga dapat menggunakan algoritma STL pada instans Vector<T>. Contoh berikut menunjukkan beberapa penggunaan dasar. Fungsibegin dan end fungsi di sini berasal dari Platform::Collections namespace, bukan std namespace.

#include <collection.h>
#include <algorithm>
using namespace Platform;
using namespace Platform::Collections;
using namespace Windows::Foundation::Collections;


void Class1::Test()
{
    Vector<int>^ vec = ref new Vector<int>();
    vec->Append(1);
    vec->Append(2);
    vec->Append(3);
    vec->Append(4);
    vec->Append(5);


    auto it = 
        std::find(begin(vec), end(vec), 3);

    int j = *it; //j = 3
    int k = *(it + 1); //or it[1]

    // Find a specified value.
    unsigned int n;         
    bool found = vec->IndexOf(4, &n); //n = 3

    // Get the value at the specified index.
    n = vec->GetAt(4); // n = 3

    // Insert an item.
    // vec = 0, 1, 2, 3, 4, 5
    vec->InsertAt(0, 0);

    // Modify an item.
    // vec = 0, 1, 2, 12, 4, 5,
    vec->SetAt(3, 12);

    // Remove an item.
    //vec = 1, 2, 12, 4, 5 
    vec->RemoveAt(0);

    // vec = 1, 2, 12, 4
    vec->RemoveAtEnd();

    // Get a read-only view into the vector.
    IVectorView<int>^ view = vec->GetView();
}

Jika Anda memiliki kode yang ada yang menggunakan std::vector dan Anda ingin menggunakannya kembali dalam komponen Windows Runtime, cukup gunakan salah Vector satu konstruktor yang mengambil std::vector atau sepasang iterator untuk membangun Vector pada titik di mana Anda meneruskan koleksi di seluruh ABI. Contoh berikut menunjukkan cara menggunakan konstruktor pemindahan Vector untuk inisialisasi yang std::vectorefisien dari . Setelah operasi pemindahan, variabel asli vec tidak lagi valid.

//#include <collection.h>
//#include <vector>
//#include <utility> //for std::move
//using namespace Platform::Collections;
//using namespace Windows::Foundation::Collections;
//using namespace std;
IVector<int>^ Class1::GetInts()
{
    vector<int> vec;
    for(int i = 0; i < 10; i++)
    {
        vec.push_back(i);
    }    
    // Implicit conversion to IVector
    return ref new Vector<int>(std::move(vec));
}

Jika Anda memiliki vektor string yang harus Anda lewati di ABI pada beberapa titik mendatang, Anda harus memutuskan apakah akan membuat string awalnya sebagai std::wstring jenis atau sebagai Platform::String^ jenis. Jika Anda harus melakukan banyak pemrosesan pada string, maka gunakan wstring. Jika tidak, buat string sebagai Platform::String^ jenis dan hindari biaya konversi nanti. Anda juga harus memutuskan apakah akan memasukkan string ini ke dalam std::vector atau Platform::Collections::Vector secara internal. Sebagai praktik umum, gunakan std::vector lalu buat Platform::Vector dari itu hanya ketika Anda meneruskan kontainer di seluruh ABI.

Jenis nilai di Vektor

Elemen apa pun yang akan disimpan dalam Platform::Collections::Vector harus mendukung perbandingan kesetaraan, baik secara implisit maupun dengan menggunakan komparator kustom std::equal_to yang Anda sediakan. Semua jenis referensi dan semua jenis skalar secara implisit mendukung perbandingan kesetaraan. Untuk jenis nilai non-skalar seperti Windows::Foundation::DateTime, atau untuk perbandingan kustom—misalnya, objA->UniqueID == objB->UniqueID—Anda harus menyediakan objek fungsi kustom.

Elemen VectorProxy

Platform::Collections::VectorIterator dan Platform::Collections::VectorViewIterator mengaktifkan penggunaan range for perulangan dan algoritma seperti std::sort dengan IVector<T> kontainer. Tetapi elemen IVector tidak dapat diakses melalui dereferensi pointer C++; mereka hanya dapat diakses melalui metode GetAt dan SetAt. Oleh karena itu, iterator ini menggunakan kelas proksi Platform::Details::VectorProxy<T> dan Platform::Details::ArrowProxy<T> untuk menyediakan akses ke elemen individu melalui operator *, ->, dan [], seperti yang diperlukan oleh Pustaka Standar. Secara ketat, diberikan IVector<Person^> vec, jenisnya *begin(vec) adalah VectorProxy<Person^>. Namun, objek proksi hampir selalu transparan dengan kode Anda. Objek proksi ini tidak didokumenkan karena hanya untuk penggunaan internal oleh iterator, tetapi berguna untuk mengetahui cara kerja mekanisme.

Saat Anda menggunakan perulangan berbasis for rentang melalui IVector kontainer, gunakan auto&& untuk mengaktifkan variabel iterator untuk mengikat dengan benar ke VectorProxy elemen. Jika Anda menggunakan auto&, peringatan kompilator C4239 dinaikkan dan VectorProxy disebutkan dalam teks peringatan.

Ilustrasi berikut menunjukkan perulangan range for di atas IVector<Person^>. Perhatikan bahwa eksekusi dihentikan pada titik henti pada baris 64. Jendela QuickWatch menunjukkan bahwa variabel p iterator sebenarnya adalah VectorProxy<Person^> variabel yang memiliki m_v dan m_i anggota. Namun, ketika Anda memanggil GetType variabel ini, variabel mengembalikan jenis yang identik ke Person instans p2. Intinya adalah bahwa meskipun VectorProxy dan ArrowProxy mungkin muncul di QuickWatch, kesalahan dari kompilator pada debugger tertentu, atau tempat lain, Anda biasanya tidak perlu secara eksplisit membuat kode untuk mereka.

Cuplikan layar debugging VectorProxy dalam perulangan berbasis rentang.

Salah satu skenario di mana Anda harus membuat kode di sekitar objek proksi adalah ketika Anda harus melakukan dynamic_cast pada elemen—misalnya, ketika Anda mencari objek XAML dari jenis tertentu dalam UIElement koleksi elemen. Dalam hal ini, Anda harus terlebih dahulu mengonversi elemen ke Platform::Object^ dan kemudian melakukan konversi tipe dinamis.

void FindButton(UIElementCollection^ col)
{
    // Use auto&& to avoid warning C4239
    for (auto&& elem : col)
    {
        Button^ temp = dynamic_cast<Button^>(static_cast<Object^>(elem));
        if (nullptr != temp)
        {
            // Use temp...
        }
    }
}

Penggunaan peta

Contoh ini memperlihatkan cara menyisipkan item dan mencarinya di Platform::Collections::Map, lalu mengembalikan Map sebagai jenis hanya-baca Windows::Foundation::Collections::IMapView.

//#include <collection.h>
//using namespace Platform::Collections;
//using namespace Windows::Foundation::Collections;
IMapView<String^, int>^ Class1::MapTest()
{
    Map<String^, int>^ m = ref new Map<String^, int >();
    m->Insert("Mike", 0);
    m->Insert("Dave", 1);
    m->Insert("Doug", 2);
    m->Insert("Nikki", 3);
    m->Insert("Kayley", 4);
    m->Insert("Alex", 5);
    m->Insert("Spencer", 6);

   // PC::Map does not support [] operator
   int i = m->Lookup("Doug");
   
   return m->GetView();
   
}

Secara umum, untuk fungsionalitas peta internal, lebih suka jenis karena std::map alasan performa. Jika Anda harus mengirim kontainer di seluruh ABI, buat Platform::Collections::Map dari std::map dan kembalikan Map sebagai Windows::Foundation::Collections::IMap. Jika Anda mencoba menggunakan Map jenis dalam nilai atau parameter pengembalian publik, kesalahan pengkompilasi C3986 akan dimunculkan. Anda dapat memperbaiki kesalahan dengan mengubah ke MapIMap. Dalam beberapa kasus—misalnya, jika Anda tidak membuat sejumlah besar pencarian atau penyisipan, dan Anda sering meneruskan koleksi di seluruh ABI—mungkin lebih murah untuk digunakan Platform::Collections::Map dari awal dan menghindari biaya konversi std::map. Bagaimanapun, hindari operasi pencarian dan sisipkan pada karena IMap ini adalah performa paling sedikit dari tiga jenis. Konversi ke IMap hanya pada titik anda meneruskan kontainer di seluruh ABI.

Jenis nilai di Peta

Elemen dalam Platform::Collections::Map diurutkan. Setiap elemen yang akan disimpan dalam Map harus mendukung perbandingan kurang-dari dengan aturan pengurutan lemah yang ketat, baik secara implisit maupun dengan menggunakan komparator kustom std::less yang Anda sediakan. Jenis skalar mendukung perbandingan secara implisit. Untuk jenis nilai non-skalar seperti Windows::Foundation::DateTime, atau untuk perbandingan kustom—misalnya, objA->UniqueID < objB->UniqueID—Anda harus menyediakan komparator kustom.

Jenis koleksi

Koleksi termasuk dalam empat kategori: versi yang dapat dimodifikasi dan versi koleksi urutan baca-saja dan koleksi asosiatif. Selain itu, C++/CX meningkatkan koleksi dengan menyediakan tiga kelas iterator yang menyederhanakan akses koleksi.

Elemen koleksi yang dapat dimodifikasi dapat diubah, tetapi elemen koleksi baca-saja, yang dikenal sebagai tampilan, hanya dapat dibaca. Elemen dalam koleksi Platform::Collections::Vector atau Platform::Collections::VectorView dapat diakses menggunakan sebuah iterator, atau melalui penggunaan indeks dalam koleksi Vector::GetAt. Elemen koleksi asosiatif dapat diakses dengan menggunakan koleksi Map::Lookup dan kunci.

Platform::Collections::Map kelas
Koleksi asosiatif yang dapat dimodifikasi. Elemen peta adalah pasangan kunci-nilai. Mencari kunci untuk mengambil nilai terkaitnya, dan melakukan iterasi melalui semua pasangan kunci-nilai, keduanya didukung.

Map dan MapView di-template pada <K, V, C = std::less<K>>; oleh karena itu, Anda dapat menyesuaikan komparator. Selain itu, Vector dan VectorView di-template <T, E = std::equal_to<T>> sehingga Anda dapat menyesuaikan perilaku IndexOf(). Ini sebagian besar penting untuk Vector dan VectorView struktur nilai. Misalnya, untuk membuat Vector<Windows::Foundation::DateTime>, Anda harus menyediakan komparator kustom karena DateTime tidak membebani == operator.

Platform::Collections::MapView kelas
Versi baca-saja dari Map.

Platform::Collections::Vector kelas
Koleksi urutan yang dapat dimodifikasi. Vector<T> mendukung akses acak waktu konstan dan operasi yang diamortisasi waktu konstan Append.

Platform::Collections::VectorView kelas
Versi baca-saja dari Vector.

Platform::Collections::InputIterator kelas
Iterator STL yang memenuhi persyaratan iterator input STL.

Platform::Collections::VectorIterator kelas
Iterator STL yang memenuhi persyaratan iterator akses acak yang dapat diubah STL.

Platform::Collections::VectorViewIterator kelas
Iterator STL yang memenuhi persyaratan iterator akses acak STL const .

fungsi begin() dan end()

Untuk menyederhanakan penggunaan STL untuk memproses objek , , , , dan yang arbitrer, C++/CX mendukung overload fungsi dan fungsi non-anggota .

Tabel berikut mencantumkan iterator dan fungsi yang tersedia.

Iterators	Functions
`Platform::Collections::VectorIterator<T>` (Menyimpan secara internal `Windows::Foundation::Collections::IVector<T>` dan `int`.)	`begin` / `end`Aku akan menemuinya.`Windows::Foundation::Collections::IVector<T>`
`Platform::Collections::VectorViewIterator<T>` (Di dalam sistem menyimpan `IVectorView<T>`^ dan `int`.)	`begin` / `end` (`IVectorView<T>`^)
`Platform::Collections::InputIterator<T>` (Di dalam sistem menyimpan `IIterator<T>`^ dan `T`.)	`begin` / `end`Aku akan menemuinya.`IIterable<T>`
`Platform::Collections::InputIterator<IKeyValuePair<K, V>^>` (Di dalam sistem menyimpan `IIterator<T>`^ dan `T`.)	`begin` / `end`Aku akan menemuinya.`IMap<K,V>`
`Platform::Collections::InputIterator<IKeyValuePair<K, V>^>` (Di dalam sistem menyimpan `IIterator<T>`^ dan `T`.)	`begin` / `end`Aku akan menemuinya.`Windows::Foundation::Collections::IMapView`

Peristiwa perubahan koleksi

Vector dan Map mendukung pengikatan data dalam koleksi XAML dengan menerapkan peristiwa yang terjadi ketika objek koleksi diubah atau direset, atau ketika elemen koleksi apa pun dimasukkan, dihapus, atau diubah. Anda dapat menulis jenis Anda sendiri yang mendukung pengikatan data, meskipun Anda tidak dapat mewarisi dari Map atau Vector karena jenis tersebut disegel.

Delegasi Windows::Foundation::Collections::VectorChangedEventHandler dan Windows::Foundation::Collections::MapChangedEventHandler menentukan tanda tangan untuk penanganan aktivitas untuk peristiwa perubahan koleksi. Kelas enum publik Windows::Foundation::Collections::CollectionChange, dan kelas ref Platform::Collections::Details::MapChangedEventArgs dan Platform::Collections::Details::VectorChangedEventArgs, menyimpan argumen peristiwa untuk menentukan apa yang menyebabkan peristiwa. Jenis *EventArgs didefinisikan dalam Details namespace layanan karena Anda tidak perlu membuat atau mengonsumsinya secara eksplisit saat Anda menggunakan Map atau Vector.

Lihat juga

Sistem Tipe
Referensi Bahasa C++/CX
Referensi dari Namespace

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-11-07