winrt::map_base templat struct (C++/WinRT)
Kelas dasar tempat Anda dapat memperoleh untuk mengimplementasikan koleksi asosiatif kustom Anda sendiri yang tidak dapat diamati. Untuk informasi selengkapnya, dan contoh kode, lihat Koleksi dengan C++/WinRT.
template <typename D, typename K, typename V>
struct map_base : map_view_base<D, K, V, winrt::impl::collection_version>
typename D
Nama jenis turunan Anda.
typename K
Jenis kunci dalam koleksi.
typename V
Jenis nilai dalam koleksi.
SDK minimum yang didukung: Windows SDK versi 10.0.17763.0 (Windows 10, versi 1809)
Namespace: winrt
Header: %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h (disertakan secara default)
Fungsi | Deskripsi |
---|---|
map_base::Clear function | Menghapus semua elemen dari objek map_base . |
map_base::Fungsi pertama | Mengambil IIterator yang mewakili elemen pertama dalam objek map_base . |
map_base::Fungsi GetView | Mengambil tampilan objek map_base yang tidak dapat diubah. |
fungsi map_base::HasKey | Menentukan apakah kunci yang ditentukan milik elemen dalam objek map_base . |
map_base::Sisipkan fungsi | Menyisipkan atau memperbarui elemen dalam objek map_base . |
map_base::Fungsi pencarian | Mencari elemen yang diidentifikasi oleh kunci yang ditentukan, dan mengambil nilai yang sesuai. |
map_base::Hapus fungsi | Menghapus elemen dari objek map_base . |
map_base::Fungsi ukuran | Mengambil jumlah elemen dalam objek map_base . |
map_base adalah rentang, dan rentang tersebut didefinisikan oleh fungsi bebas internal (yang masing-masing mengambil iterator) yang kompatibel dengan fitur bahasa standar. Karena itu, Anda dapat menghitung elemen dalam objek map_base dengan pernyataan berbasis for
rentang.
Anda juga dapat mengambil IIterator dari fungsi map_base::First , dan menggunakannya untuk melakukan iterasi melalui elemen dalam objek map_base .
...
#include <iostream>
using namespace winrt;
using namespace Windows::Foundation::Collections;
...
struct MyMap :
implements<MyMap, IMap<winrt::hstring, int>, IMapView<winrt::hstring, int>, IIterable<IKeyValuePair<winrt::hstring, int>>>,
winrt::map_base<MyMap, winrt::hstring, int>
{
auto& get_container() const noexcept
{
return m_values;
}
auto& get_container() noexcept
{
return m_values;
}
private:
std::map<winrt::hstring, int> m_values{
{ L"AliceBlue", 0xfff0f8ff }, { L"AntiqueWhite", 0xfffaebd7 }
};
};
...
IMap<winrt::hstring, int> map{ winrt::make<MyMap>() };
for (auto const& el : map)
{
std::wcout << el.Key().c_str() << L", " << std::hex << el.Value() << std::endl;
}
IIterator<IKeyValuePair<winrt::hstring, int>> it{ map.First() };
while (it.HasCurrent())
{
std::wcout << it.Current().Key().c_str() << L", " << std::hex << it.Current().Value() << std::endl;
it.MoveNext();
}
Menghapus semua elemen dari objek map_base .
void Clear() noexcept;
Mengambil IIterator yang mewakili elemen pertama dalam objek map_base .
auto First();
IIterator yang mewakili elemen pertama dalam objek map_base.
Mengambil tampilan objek map_base yang tidak dapat diubah.
winrt::Windows::Foundation::Collections::IMapView<K, V> GetView() const;
IMapView yang berisi tampilan map_base yang tidak dapat diubah.
Menentukan apakah kunci yang ditentukan milik elemen dalam objek map_base .
bool HasKey(K const& key) const noexcept;
key
Kunci yang harus dicari.
true
jika elemen yang berisi kunci ditemukan, jika tidak false
.
Menyisipkan atau memperbarui elemen dalam objek map_base .
bool Insert(K const& key, V const& value);
key
Kunci yang terkait dengan elemen untuk disisipkan atau diperbarui.
value
Nilai yang akan disisipkan atau diganti.
true
jika elemen dengan kunci yang ditentukan ditemukan dan diperbarui; jika tidak false
.
Mencari elemen yang diidentifikasi oleh kunci yang ditentukan, dan mengambil nilai yang sesuai.
V Lookup(K const& key) const;
key
Kunci untuk mencari.
Nilai yang sesuai dengan kunci yang sedang dicari jika ditemukan, jika tidak, pengecualian winrt::hresult_out_of_bounds dilemparkan.
Menghapus elemen dari objek map_base .
void Remove(K const& key);
key
Kunci yang terkait dengan elemen yang akan dihapus.
Mengambil jumlah elemen dalam objek map_base .
uint32_t Size() const noexcept;
Nilai yang menunjukkan jumlah elemen dalam objek map_base .