マップ固有の操作

マップでは、キーと値の両方の型がユーザー定義です。 キーに基づいたマップエントリへのアクセスにより、キーによる値の取得から、キーと値を個別にフィルタリングする機能まで、マップ固有のさまざまな処理が可能になります。 このページでは、標準ライブラリのマップ処理関数について説明します。

キーと値の取得

マップから値を取得するには、get() 関数の引数としてそのキーを渡す必要があります。 短縮形の [key] 構文もサポートされています。指定されたキーが見つからない場合、null を返します。 また、getValue() 関数もあります。これは少し動作が異なり、キーがマップ内に見つからない場合に例外をスローします。 さらに、キーが存在しない場合を処理するためのオプションが他に2つあります。

• getOrElse() はリストの場合と同じように動作します。存在しないキーに対する値が、指定されたラムダ関数から返されます。
• getOrDefault() は、キーが見つからない場合に指定されたデフォルト値を返します。

fun main() {
    val numbersMap = mapOf("one" to 1, "two" to 2, "three" to 3)
    println(numbersMap.get("one"))
    println(numbersMap["one"])
    println(numbersMap.getOrDefault("four", 10))
    println(numbersMap["five"])               // null
    //numbersMap.getValue("six")      // 例外が発生！
}

マップのすべてのキーまたはすべての値に対して操作を実行するには、プロパティ keys および values からそれぞれ取得できます。 keys はマップのすべてのキーのセット（set）であり、values はマップのすべての値のコレクション（collection）です。

fun main() {
    val numbersMap = mapOf("one" to 1, "two" to 2, "three" to 3)
    println(numbersMap.keys)
    println(numbersMap.values)
}

フィルタリング

他のコレクションと同様に、filter() 関数を使用してマップをフィルタリングできます。 マップで filter() を呼び出すときは、Pair を引数とする述語（predicate）を渡します。 これにより、フィルタリングの述語内でキーと値の両方を使用できるようになります。

fun main() {
    val numbersMap = mapOf("key1" to 1, "key2" to 2, "key3" to 3, "key11" to 11)
    val filteredMap = numbersMap.filter { (key, value) -> key.endsWith("1") && value > 10}
    println(filteredMap)
}

マップをフィルタリングするための、キーによる方法と値による方法の2つの特定の方法もあります。 それぞれの方法に対して、filterKeys() と filterValues() 関数があります。 どちらも、指定された述語に一致するエントリの新しいマップを返します。 filterKeys() の述語は要素のキーのみをチェックし、filterValues() の述語は値のみをチェックします。

fun main() {
    val numbersMap = mapOf("key1" to 1, "key2" to 2, "key3" to 3, "key11" to 11)
    val filteredKeysMap = numbersMap.filterKeys { it.endsWith("1") }
    val filteredValuesMap = numbersMap.filterValues { it < 10 }

    println(filteredKeysMap)
    println(filteredValuesMap)
}

plus および minus 演算子

要素へのキーアクセスがあるため、plus (+) および minus (-) 演算子は、他のコレクションとは異なる動作をマップに対して行います。 plus は、両方のオペランド（左側の Map と、右側の Pair または別の Map）の要素を含む Map を返します。 右側のオペランドに、左側の Map に存在するキーを持つエントリが含まれている場合、結果のマップには右側のエントリが含まれます。

fun main() {
    val numbersMap = mapOf("one" to 1, "two" to 2, "three" to 3)
    println(numbersMap + Pair("four", 4))
    println(numbersMap + Pair("one", 10))
    println(numbersMap + mapOf("five" to 5, "one" to 11))
}

minus は、左側の Map のエントリから、右側のオペランドにあるキーを持つエントリを除外した Map を作成します。 したがって、右側のオペランドは単一のキー、またはリストやセットなどのキーのコレクションのいずれかにすることができます。

fun main() {
    val numbersMap = mapOf("one" to 1, "two" to 2, "three" to 3)
    println(numbersMap - "one")
    println(numbersMap - listOf("two", "four"))
}

可変マップでの plusAssign (+=) および minusAssign (-=) 演算子の使用方法の詳細については、以下のマップの書き込み操作を参照してください。

マップの書き込み操作

可変（Mutable）マップは、マップ固有の書き込み操作を提供します。 これらの操作により、キーに基づいた値へのアクセスを使用してマップの内容を変更できます。

マップの書き込み操作を定義する特定のルールがあります：

• 値は更新できます。一方で、キーは決して変わりません。一度エントリを追加すると、そのキーは固定されます。
• 各キーに対して、常に関連付けられている値は1つだけです。エントリ全体を追加したり削除したりできます。

以下は、可変マップで使用できる書き込み操作用の標準ライブラリ関数の説明です。

エントリの追加と更新

可変マップに新しいキーと値のペアを追加するには、put() を使用します。 新しいエントリが LinkedHashMap（デフォルトのマップ実装）に入れられると、マップを反復処理する際に最後に来るように追加されます。ソートされたマップでは、新しい要素の位置はキーの順序によって定義されます。

fun main() {
    val numbersMap = mutableMapOf("one" to 1, "two" to 2)
    numbersMap.put("three", 3)
    println(numbersMap)
}

一度に複数のエントリを追加するには、putAll() を使用します。 その引数は、Map または Pair のグループ（Iterable、Sequence、または Array）にすることができます。

fun main() {
    val numbersMap = mutableMapOf("one" to 1, "two" to 2, "three" to 3)
    numbersMap.putAll(setOf("four" to 4, "five" to 5))
    println(numbersMap)
}

put() と putAll() の両方は、指定されたキーが既にマップ内に存在する場合、値を上書きします。したがって、これらを使用してマップエントリの値を更新できます。

fun main() {
    val numbersMap = mutableMapOf("one" to 1, "two" to 2)
    val previousValue = numbersMap.put("one", 11)
    println("value associated with 'one', before: $previousValue, after: ${numbersMap["one"]}")
    println(numbersMap)
}

短縮演算子形式を使用して、マップに新しいエントリを追加することもできます。2つの方法があります。

• plusAssign (+=) 演算子。
• set() のエイリアスである [] 演算子。

fun main() {
    val numbersMap = mutableMapOf("one" to 1, "two" to 2)
    numbersMap["three"] = 3     // numbersMap.put("three", 3) を呼び出す
    numbersMap += mapOf("four" to 4, "five" to 5)
    println(numbersMap)
}

マップ内に存在するキーを指定して呼び出された場合、演算子は対応するエントリの値を上書きします。

エントリの削除

可変マップからエントリを削除するには、remove() 関数を使用します。 remove() を呼び出すときは、キーまたはキーと値のペア全体を渡すことができます。 キーと値の両方を指定した場合、そのキーを持つ要素は、その値が第2引数と一致する場合にのみ削除されます。

fun main() {
    val numbersMap = mutableMapOf("one" to 1, "two" to 2, "three" to 3)
    numbersMap.remove("one")
    println(numbersMap)
    numbersMap.remove("three", 4)            // 何も削除されない
    println(numbersMap)
}

キーまたは値によって可変マップからエントリを削除することもできます。 これを行うには、エントリのキーまたは値を指定して、マップの keys または values に対して remove() を呼び出します。 values に対して呼び出された場合、remove() は指定された値を持つ最初のエントリのみを削除します。

fun main() {
    val numbersMap = mutableMapOf("one" to 1, "two" to 2, "three" to 3, "threeAgain" to 3)
    numbersMap.keys.remove("one")
    println(numbersMap)
    numbersMap.values.remove(3)
    println(numbersMap)
}

minusAssign (-=) 演算子も可変マップで使用できます。

fun main() {
    val numbersMap = mutableMapOf("one" to 1, "two" to 2, "three" to 3)
    numbersMap -= "two"
    println(numbersMap)
    numbersMap -= "five"             // 何も削除されない
    println(numbersMap)
}