対応付け

対応付けは、単一の値に一意のキーを対応付ける、キー - 値のペアのコレクションです。キーと値には、プリミティブ型、コレクション型、sObject 型、ユーザ定義型、組み込み Apex 型のいずれかのデータ型を使用できます。たとえば、次の表は国名と通貨の対応付けを示します。

対応付けのキーと値にはどのコレクションでも含めることができ、コレクションをネストすることが可能です。たとえば、各種の対応付けに Integer を対応付けることができ、その対応付けによって String がリストに対応付けられます。対応付けのキーでは、コレクションを最大 4 レベルまでネストできます。

対応付けを宣言するには、<> 文字で囲まれたキーおよび値のデータ型の前に Map キーワードを使用します。次に例を示します。

汎用または特定の sObject データ型を対応付けとともに使用できます (後の章で、sObject との対応付けに関してさらに詳細に説明します)。対応付けの汎用インスタンスを作成することもできます。

リスト同様、中括弧 ({}) 構文を使用して対応付けを宣言する場合、対応付けのキー - 値のペアを入力できます。中括弧の中で、キーを最初に指定し、=> を使用してそのキーの値を指定します。次に例を示します。

最初の例で、キー a の値は b、キー c の値は d です。

対応付けの要素にアクセスするには、Apex が提供する Map メソッドを使用します。この例では、整数のキーと文字列の値の対応付けを作成します。2 つのエントリを追加し、最初のキーが存在することを確認して、2 番目のエントリの値を取得し、最後にすべてのキーセットを取得します。

サポートされるすべての Map メソッドの全リストなどの詳細は、「Map クラス」を参照してください。