Platform::Collections::MapView クラス

キーと値のペアのコレクションである、 マップへの読み取り専用ビューを表します。

構文

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

パラメーター

K
キー/値ペア内のキーの型。

V
キー/値ペア内の値の型。

C
並べ替えキーとして 2 つの要素値を比較して MapView 内の相対順序を決定できる関数オブジェクトを提供する型。 既定では、std::less<K> です。

解説

MapView は、アプリケーション バイナリ インターフェイス (ABI) を通じて渡される Windows::Foundation::Collections::IMapView <K,V> インターフェイスの C++ の具象実装です。 詳細については、「 Collections (C++/CX) (コレクション (C++/CX))」を参照してください。

メンバー

パブリック コンストラクター

名前	説明
MapView::MapView	MapView クラスの新しいインスタンスを初期化します。

パブリック メソッド

名前	説明
MapView::First	マップ ビュー内の最初の要素に初期化される反復子を返します。
MapView::HasKey	現在の MapView に、指定されたキーが含まれているかどうかを判定します。
MapView::Lookup	現在の MapView オブジェクト内の、指定されたキーの位置の要素を取得します。
MapView::Size	現在の MapView オブジェクトの要素数を返します。
MapView::Split	元の MapView オブジェクトを、2 つの 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 要素の検索に使用するキー。 key の型は型名 K です。

戻り値

キーが見つかった場合は true。それ以外の場合は false。

MapView::Lookup メソッド

型 K の指定されたキーに関連付けられている型 V の値を取得します。

構文

V Lookup(K key);

パラメーター

key
MapView の要素の検索に使用するキー。 key の型は型名 K です。

戻り値

key とペアになる値。 戻り値の型は、型名 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 の型名。

comp
並べ替えキーとして 2 つの要素値を比較して MapView 内の相対順序を決定できる関数オブジェクト。

m
現在の MapView を初期化するために使用される map Class への参照、または lvalue および rvalue。

first
現在の MapView を初期化するために使用される要素の範囲内の最初の要素の入力反復子。

last
現在の MapView を初期化するために使用される要素の範囲の後の最初の要素の入力反復子。

イリノイ
要素が MapView に挿入される std::initializer_list<std::pair<K,V>>。

MapView::Size メソッド

現在の MapView オブジェクトの要素数を返します。

構文

virtual property unsigned int Size;

戻り値

現在の MapView 内の要素数。

MapView::Split メソッド

現在の MapView を 2 つの MapView オブジェクトに分割します。 このメソッドは操作不可です。

構文

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

パラメーター

firstPartition
元の MapView オブジェクトの最初の部分。

secondPartition
元の MapView オブジェクトの 2 番目の部分。

解説

このメソッドは操作可能ではありません。これは何も実行しません。

関連項目

プラットフォーム名前空間