CMap クラス

一意なキーを値に割り当てる辞書コレクション クラスです。

template< class KEY, class ARG_KEY, class VALUE, class ARG_VALUE >class CMap : public CObject

パラメーター

• KEY
  キーとして使用するマップにオブジェクトのクラス。

• ARG*_*KEY
  KEY の引数に使用するデータ型; 通常 KEYへの参照。

• VALUE
  マップに格納されているオブジェクトのクラス。

• ARG*_*VALUE
  VALUE の引数に使用するデータ型; 通常 VALUEへの参照。

メンバー

パブリック構造体

名前	説明
CMap::CPair	関連するオブジェクトのキー値と値を含む入れ子構造体。

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

名前	説明
CMap::CMap	キーに値を割り当てるコレクションを構築します。

パブリック メソッド

名前	説明
CMap::GetCount	このマップ内の要素数を返します。
CMap::GetHashTableSize	ハッシュ テーブルの要素数を返します。
CMap::GetNextAssoc	次の要素を順番に取得します。
CMap::GetSize	このマップ内の要素数を返します。
CMap::GetStartPosition	最初の要素の位置を返します。
CMap::InitHashTable	ハッシュ テーブルを初期化し、サイズを指定します。
CMap::IsEmpty	マップ空の状態 (要素) なしのテスト。
CMap::Lookup	指定したキーに割り当てられている値を検索します。
CMap::PGetFirstAssoc	最初の要素へのポインターを返します。
CMap::PGetNextAssoc	反復の次の要素へのポインターを取得します。
CMap::PLookup	値が指定された値に一致するキーへのポインターを返します。
CMap::RemoveAll	このマップからすべての要素を削除します。
CMap::RemoveKey	キーによって指定された要素を削除します。
CMap::SetAt	マップに要素を挿入します; 一致するキーがある場合は、既存の要素を置き換えます。

パブリック演算子

名前	説明
CMap::operator [ ]	—マップに要素 SetAtの演算子の置換を挿入します。

解説

マップにキーと値のペア (要素) を挿入し、キーを使用して効率的にアクセスするためのペアを取得したり、削除したりできます。また、マップのすべての要素を反復処理できます。

型の変数は POSITION エントリへの代替アクセスに使用されます。「 POSITION を記憶します」エントリを使用し、マップを反復処理できます。このイテレーションのキー値に基づいて順番であると考えることもあります。; ではありません。取得する要素のシーケンスは不確定です。

このクラスの一部のメンバー関数は、グローバルなヘルパー関数を呼び出します。したがって、CMap クラスの主な用途に合わせて、これらのヘルパー関数をカスタマイズする必要があります。MFCReferenceのマクロとグローバル"の コレクション クラスのヘルパー を参照してください。

CMap は、要素のシリアル化とダンプをサポートするために CObject::Serialize をオーバーライドします。マップが Serializeを使用してアーカイブに格納され、各マップ要素が順番にシリアル化されます。SerializeElements のヘルパー関数の既定の実装では、の書き込みをビットごとにします。CObject などのユーザー定義型から派生したポインターのコレクション項目のシリアル化の詳細については、方法 : タイプ セーフなコレクションを作成するを参照してください。

マップ内の各要素の診断ダンプ (キーと値) 必要とする場合は、1 にダンプ コンテキストの深さを設定するより大きい。

CMap のオブジェクトを削除または要素が削除されると、キーと値の両方が削除されます。

マップのクラスの派生は、リストの派生に似ています。特殊な目的のクラスの派生リストの図に [コレクション] ついては、" "を参照してください。

継承階層

CObject

CMap

必要条件

Header: afxtempl.h

参照

関連項目

CObject クラス

階層図

概念

MFC のサンプルが収集されます