Platform::Collections::MapView 類別

發行項
10/12/2023

表示 對應 (Map)(機碼值組的集合) 的唯讀檢視。

語法

template <
   typename K,
   typename V,
   typename C = ::std::less<K>>
ref class MapView sealed;

參數

K
機碼值組中，機碼的類型。

V
機碼值組中，值的型別。

C
一個類型，提供函式物件，可以根據排序鍵比較兩個項目值，以判斷它們在 MapView 中的相對順序。根據預設， std：：less < K > 。

備註

MapView 是 Windows：：Foundation：：Collections：：IMapView K，V > 介面的具體 C++ 實作，會傳遞至應用程式二進位介面 < （ABI）。如需詳細資訊，請參閱集合 (C++/CX)。

成員

公用建構函式

名稱	描述
MapView：：MapView	初始化 MapView 類別的新執行個體。

公用方法

名稱	描述
MapView：：First	傳回迭代器，初始化為對應檢視中的第一個元素。
MapView：：HasKey	判斷目前 MapView 是否包含指定的機碼。
MapView：：Lookup	在目前 MapView 物件中擷取位於指定機碼的元素。
MapView：：Size	傳回目前 MapView 物件中的項目數。
MapView：：Split	將原始 MapView 物件分割為兩個 MapView 物件。

繼承階層架構

MapView

需求

標頭： collection.h

命名空間： Platform::Collections

MapView::First 方法

傳回指定對應檢視中之第一個項目的迭代器。

語法

virtual Windows::Foundation::Collections::IIterator<
   Windows::Foundation::Collections::IKeyValuePair<K, V>^>^ First();

傳回值

迭代器，指定對應檢視中的第一個元素。

備註

保留 First（）所傳回反覆運算器的便利方式是將傳回值指派給以類型推算關鍵字宣告的 auto 變數。例如： auto x = myMapView->First(); 。

MapView::HasKey 方法

判斷目前 MapView 是否包含指定的機碼。

語法

bool HasKey(K key);

參數

key
用來尋找 MapView 項目的機碼。索引鍵 的類型 為 typename K 。

傳回值

true 如果找到索引鍵，則為 ;否則為 false 。

Mapview:: Lookup 方法

取得與類型為 K 之指定機碼相關聯且類型為 V 的值。

語法

V Lookup(K key);

參數

key
用來在 MapView 中尋找元素的機碼。的類型 key 為 typename K 。

傳回值

與 key 配對的值。傳回值的型別為 typename V 。

MapView::MapView 建構函式

初始化 MapView 類別的新執行個體。

語法

explicit MapView(const C& comp = C());

explicit MapView(const ::std::map<K, V, C>& m);

explicit MapView(std::map<K, V, C>&& m);

template <typename InIt> MapView(
    InIt first,
    InIt last,
    const C& comp = C());

MapView(
    ::std::initializer_list<std::pair<const K, V>> il,
    const C& comp = C());

參數

Init
目前 MapView 的 typename。

comp
函式物件。這個函式物件可以根據排序機碼比較兩個元素值，判斷它們在 MapView 中的相對順序。

m
用來初始化目前 MapView 之的參考或 Lvalues 和 Rvalue map Class 。

first
用來初始化目前 MapView 的項目範圍中，第一個項目的輸入迭代器。

last
用來初始化目前 MapView 的項目範圍以外第一個項目的輸入迭代器。

I l
std：：initializer_list < std：:p air < K，V >> ，其元素將插入 MapView。

MapView::Size 方法

傳回目前 MapView 物件中的項目數。

語法

virtual property unsigned int Size;

傳回值

目前 MapView 中的項目數。

MapView::Split 方法

將目前 MapView 物件分割為兩個 MapView 物件。這個方法無法操作。

語法

void Split(
   Windows::Foundation::Collections::IMapView<
                         K, V>^ * firstPartition,
   Windows::Foundation::Collections::IMapView<
                         K, V>^ * secondPartition);

參數

firstPartition
原始 MapView 物件的第一個部分。

secondPartition
原始 MapView 物件的第二個部分。

備註

這個方法無法操作，不會執行任何動作。

另請參閱

平臺命名空間

Share via