MENU
  1. ホーム
  2. Kotlin
  3. KotlinのMapを使ったキーと値のペア操作完全ガイド

KotlinのMapを使ったキーと値のペア操作完全ガイド

Kotlin

KotlinにおけるMapは、キーと値のペアでデータを管理する便利なデータ構造です。特定のキーを使って対応する値を効率的に検索、追加、更新、削除できるため、プログラム内でのデータ管理に頻繁に利用されます。Kotlinでは、イミュータブルなMapと、変更可能なMutableMapという2つの種類があり、用途に応じて使い分けることができます。本記事では、KotlinのMapを活用し、キーと値のペアを効率的に操作する方法や、具体的な応用例について詳しく解説します。

目次

KotlinのMapとは何か


KotlinにおけるMapは、キーと値のペアを格納するデータ構造です。特定のキーを使って値に素早くアクセスできるため、データの関連付けや検索に便利です。

Mapの特徴

  • キーは一意である必要があります。
  • 値は重複可能です。
  • 要素の順序は、HashMapやLinkedHashMapなど、使用するMapの種類によって異なります。

Mapの種類


Kotlinには主に以下の2つのMapがあります。

  1. Immutable Map（読み取り専用）
  • 変更不可能なMapです。宣言後に要素を追加、削除、更新できません。
  • 例: mapOf("key1" to "value1", "key2" to "value2")
  1. Mutable Map（変更可能）
  • 要素の追加、削除、更新が可能なMapです。
  • 例: mutableMapOf("key1" to "value1", "key2" to "value2")

代表的なMapの実装

  • HashMap：要素の順序を保証しないが、検索が高速。
  • LinkedHashMap：要素が挿入された順序を保持する。
  • TreeMap：キーを自然順序またはカスタム順序でソートする。

KotlinのMapを適切に使うことで、効率的にデータを管理・操作することが可能です。

Mapの基本的な作成方法


KotlinでMapを作成するには、mapOfやmutableMapOf関数を使用します。それぞれ、イミュータブル（変更不可）とミュータブル（変更可能）なMapを作成できます。

イミュータブルなMapの作成


要素を変更できないMapを作成するには、mapOf関数を使います。

val immutableMap = mapOf("apple" to 1, "banana" to 2, "cherry" to 3)
println(immutableMap) // {apple=1, banana=2, cherry=3}
  • mapOfは、キーと値のペアを"キー" to 値という形式で指定します。
  • 生成したimmutableMapは読み取り専用で、後から要素を変更できません。

ミュータブルなMapの作成


要素を追加・更新・削除できるMapを作成するには、mutableMapOf関数を使用します。

val mutableMap = mutableMapOf("dog" to 4, "cat" to 3)
mutableMap["bird"] = 2  // 新しいキーと値を追加
println(mutableMap) // {dog=4, cat=3, bird=2}
  • mutableMapOfを使うと、作成後に要素の追加や変更が可能です。

空のMapの作成


空のMapを作成する場合は、型を明示する必要があります。

val emptyMap = emptyMap<String, Int>()
val emptyMutableMap = mutableMapOf<String, Int>()

Mapの型推論


Kotlinは型推論ができるため、通常は型を明示しなくても問題ありません。

val fruits = mapOf("orange" to 5, "grape" to 8)

これらの基本的な作成方法を理解すれば、KotlinのMapを効果的に使い始めることができます。

キーと値の追加・更新方法


KotlinのMapに要素を追加・更新する方法は、MutableMapを使うことで実現できます。イミュータブルなMapでは追加・更新はできません。

要素の追加方法


MutableMapに新しいキーと値のペアを追加するには、次の方法があります。

val mutableMap = mutableMapOf("apple" to 1, "banana" to 2)
mutableMap["cherry"] = 3  // 新しい要素を追加
println(mutableMap) // {apple=1, banana=2, cherry=3}

put関数を使って追加することも可能です。

mutableMap.put("orange", 4)
println(mutableMap) // {apple=1, banana=2, cherry=3, orange=4}

要素の更新方法


既存のキーに新しい値を割り当てることで、要素を更新できます。

mutableMap["apple"] = 10  // キー"apple"の値を更新
println(mutableMap) // {apple=10, banana=2, cherry=3, orange=4}

put関数でも更新できます。

mutableMap.put("banana", 20)
println(mutableMap) // {apple=10, banana=20, cherry=3, orange=4}

複数の要素を一度に追加・更新


putAll関数を使うと、複数の要素を一度に追加・更新できます。

mutableMap.putAll(mapOf("grape" to 5, "kiwi" to 6))
println(mutableMap) // {apple=10, banana=20, cherry=3, orange=4, grape=5, kiwi=6}

注意点

  • キーが存在しない場合：新しい要素が追加されます。
  • キーが既に存在する場合：対応する値が上書きされます。

これらの方法を使うことで、効率的にMapに要素を追加・更新できます。

キーと値の削除方法


KotlinのMutableMapでは、特定のキーやキーと値のペアを削除することが可能です。ここでは、削除方法とその活用法について解説します。

キーを指定して削除する方法


remove関数を使って、指定したキーに関連付けられた要素を削除できます。

val mutableMap = mutableMapOf("apple" to 1, "banana" to 2, "cherry" to 3)
mutableMap.remove("banana")
println(mutableMap) // {apple=1, cherry=3}
  • キーが存在しない場合、何も起こりません。

キーと値のペアを指定して削除する方法


特定のキーと値が一致する場合のみ削除することも可能です。

mutableMap.remove("apple", 1)  // キー"apple"に対応する値が1なら削除
println(mutableMap) // {cherry=3}
  • キーと値の両方が一致しない場合、削除されません。

複数の要素を削除する方法


keysプロパティやremoveIfを使用して、複数の要素を一度に削除できます。

val mutableMap = mutableMapOf("dog" to 4, "cat" to 3, "bird" to 2, "fish" to 5)
mutableMap.keys.removeAll(listOf("cat", "fish"))
println(mutableMap) // {dog=4, bird=2}

条件に基づいて削除する方法


条件に合致する要素を削除するには、entries.removeIf関数を使用します。

mutableMap.entries.removeIf { it.value < 4 }
println(mutableMap) // {dog=4, fish=5}

削除時の注意点

  • イミュータブルなMapでは削除操作はできません。
  • 存在しないキーを削除してもエラーにはならないため、事前にキーの存在を確認する必要はありません。

これらの削除方法を活用することで、Mapのデータを効率的に管理・整理することができます。

Map内の要素を検索する方法


KotlinのMapでは、特定のキーや値を効率的に検索するためのさまざまな方法が提供されています。ここでは、代表的な検索方法を解説します。

キーを使って検索する方法


containsKey関数を使うと、指定したキーがMapに存在するか確認できます。

val map = mapOf("apple" to 1, "banana" to 2, "cherry" to 3)

if (map.containsKey("banana")) {
    println("キー 'banana' が存在します")
} else {
    println("キー 'banana' は存在しません")
}
// 出力: キー 'banana' が存在します

代替方法として、in演算子を使うこともできます。

if ("apple" in map) {
    println("キー 'apple' が存在します")
}

値を使って検索する方法


containsValue関数を使うと、指定した値がMapに存在するか確認できます。

if (map.containsValue(3)) {
    println("値 3 が存在します")
} else {
    println("値 3 は存在しません")
}
// 出力: 値 3 が存在します

キーに対応する値を取得する方法


get関数や[]演算子でキーに対応する値を取得できます。

val value = map["cherry"]
println(value) // 3

キーが存在しない場合、nullが返されます。

val value = map["grape"]
println(value) // null

デフォルト値を設定して取得する方法


getOrDefault関数を使うと、キーが存在しない場合にデフォルト値を返せます。

val value = map.getOrDefault("grape", 0)
println(value) // 0

条件に合う要素を検索する方法


filter関数を使うと、条件に合う要素を検索して抽出できます。

val filteredMap = map.filter { it.value > 1 }
println(filteredMap) // {banana=2, cherry=3}

注意点

  • キー検索は高速です（O(1)）。
  • 値検索は全要素を調べるため、O(n)の計算量がかかります。

これらの検索方法を活用することで、KotlinのMap内のデータを効率的に操作・確認できます。

Mapのループ処理


KotlinのMapをループ処理することで、キーや値を一つずつ取り出して操作できます。ここでは、さまざまなループ処理の方法を紹介します。

エントリをループ処理する方法


forループを使用して、Mapのキーと値を順番に取得できます。

val map = mapOf("apple" to 1, "banana" to 2, "cherry" to 3)

for ((key, value) in map) {
    println("キー: $key, 値: $value")
}
// 出力:
// キー: apple, 値: 1
// キー: banana, 値: 2
// キー: cherry, 値: 3

キーのみをループ処理する方法


keysプロパティを使って、Mapのキーだけをループ処理できます。

for (key in map.keys) {
    println("キー: $key")
}
// 出力:
// キー: apple
// キー: banana
// キー: cherry

値のみをループ処理する方法


valuesプロパティを使って、Mapの値だけをループ処理できます。

for (value in map.values) {
    println("値: $value")
}
// 出力:
// 値: 1
// 値: 2
// 値: 3

forEach関数を使ったループ処理


forEach関数を使うと、ラムダ式を用いて簡潔にループ処理できます。

map.forEach { (key, value) ->
    println("キー: $key, 値: $value")
}
// 出力:
// キー: apple, 値: 1
// キー: banana, 値: 2
// キー: cherry, 値: 3

インデックス付きでループ処理する方法


インデックスを付けてループ処理するには、withIndexを使います。

for ((index, entry) in map.entries.withIndex()) {
    println("インデックス: $index, キー: ${entry.key}, 値: ${entry.value}")
}
// 出力:
// インデックス: 0, キー: apple, 値: 1
// インデックス: 1, キー: banana, 値: 2
// インデックス: 2, キー: cherry, 値: 3

条件付きでループ処理する方法


filterを使って条件に合う要素のみを処理できます。

map.filter { it.value > 1 }.forEach { (key, value) ->
    println("条件に合うキー: $key, 値: $value")
}
// 出力:
// 条件に合うキー: banana, 値: 2
// 条件に合うキー: cherry, 値: 3

注意点

  • イミュータブルなMapでは要素の変更はできません。
  • ミュータブルなMapの場合、ループ中に要素を削除する際は注意が必要です。

これらのループ処理を活用することで、KotlinのMapを柔軟に操作できます。

Mapのフィルタリング・変換


Kotlinでは、Mapのデータをフィルタリングしたり、変換したりする便利な関数が多数用意されています。ここでは、よく使うフィルタリングと変換方法を紹介します。

Mapのフィルタリング方法


filterやfilterKeys、filterValues関数を使って、条件に合った要素のみを抽出できます。

全体の要素をフィルタリング


filter関数を使って、キーと値のペアを条件に基づいてフィルタリングします。

val map = mapOf("apple" to 1, "banana" to 2, "cherry" to 3)

val filteredMap = map.filter { (key, value) -> value > 1 }
println(filteredMap) // {banana=2, cherry=3}

キーに基づいてフィルタリング


filterKeys関数を使うと、キーに基づいて要素を抽出できます。

val filteredByKey = map.filterKeys { key -> key.startsWith("a") }
println(filteredByKey) // {apple=1}

値に基づいてフィルタリング


filterValues関数を使うと、値に基づいて要素を抽出できます。

val filteredByValue = map.filterValues { value -> value == 2 }
println(filteredByValue) // {banana=2}

Mapの変換方法


Mapの要素を変換するには、mapやmapKeys、mapValues関数を使います。

全体を変換する


map関数を使うと、キーと値のペアを別の形式に変換できます。

val transformedList = map.map { (key, value) -> "$key has $value" }
println(transformedList) // [apple has 1, banana has 2, cherry has 3]

キーを変換する


mapKeys関数を使うと、キーを変換できます。

val mappedKeys = map.mapKeys { (key, _) -> key.uppercase() }
println(mappedKeys) // {APPLE=1, BANANA=2, CHERRY=3}

値を変換する


mapValues関数を使うと、値を変換できます。

val mappedValues = map.mapValues { (_, value) -> value * 10 }
println(mappedValues) // {apple=10, banana=20, cherry=30}

Mapの要素をリストに変換する


Mapの要素をリストに変換するには、toList関数を使います。

val list = map.toList()
println(list) // [(apple, 1), (banana, 2), (cherry, 3)]

注意点

  • フィルタリングや変換の結果は新しいMapとして返され、元のMapは変更されません。
  • MutableMapでも、フィルタリングや変換後はイミュータブルMapとして返されるので、再度ミュータブルにするにはtoMutableMapを使います。

これらのフィルタリング・変換操作を活用することで、Mapのデータを柔軟に処理できます。

応用例: 実践的なMapの活用法


KotlinのMapを活用すれば、さまざまな実践的なデータ処理が可能です。ここでは、いくつかの具体的な応用例を紹介します。

例1: 商品と価格のリストから特定の条件に合う商品を抽出


商品のリストから、特定の価格以上の商品を抽出する例です。

val products = mapOf("Apple" to 150, "Banana" to 80, "Cherry" to 200, "Grape" to 180)

// 100円以上の商品を抽出
val filteredProducts = products.filter { (_, price) -> price >= 100 }
println(filteredProducts) // {Apple=150, Cherry=200, Grape=180}

例2: 学生の成績リストを集計して平均点を計算


学生の名前とテストの点数を格納したMapから、平均点を計算する例です。

val scores = mapOf("Alice" to 85, "Bob" to 78, "Charlie" to 92, "David" to 65)

val averageScore = scores.values.average()
println("平均点: $averageScore") // 平均点: 80.0

例3: 出現回数のカウント


文字列内の各単語の出現回数をカウントする例です。

val text = "apple banana apple cherry banana apple"
val words = text.split(" ")

val wordCount = mutableMapOf<String, Int>()
for (word in words) {
    wordCount[word] = wordCount.getOrDefault(word, 0) + 1
}

println(wordCount) // {apple=3, banana=2, cherry=1}

例4: 連絡先リストでの検索


電話帳から特定の名前の連絡先を検索する例です。

val contacts = mapOf("Alice" to "123-4567", "Bob" to "987-6543", "Charlie" to "555-1234")

val searchName = "Bob"
val phoneNumber = contacts[searchName] ?: "連絡先が見つかりません"

println("Bobの電話番号: $phoneNumber") // Bobの電話番号: 987-6543

例5: 重複しないデータの統合


複数のMapを統合し、重複するキーがある場合は後のMapの値で上書きする例です。

val map1 = mapOf("A" to 1, "B" to 2)
val map2 = mapOf("B" to 3, "C" to 4)

val mergedMap = map1 + map2
println(mergedMap) // {A=1, B=3, C=4}

応用例のポイント

  • データの絞り込みや集計にMapを活用すると効率的です。
  • getOrDefaultやfilter、mapなどの関数を適切に使うことで、柔軟なデータ処理が可能です。

これらの応用例を参考に、実際の開発でKotlinのMapを活用しましょう。

まとめ


本記事では、KotlinにおけるMapの操作方法について解説しました。Mapはキーと値のペアでデータを管理する強力なデータ構造であり、要素の追加・更新・削除、フィルタリング、変換、ループ処理といった基本的な操作方法を学びました。

また、商品リストの検索、成績の平均計算、出現回数のカウントなど、実践的な応用例も紹介しました。これらを活用することで、データ処理を効率的かつ柔軟に行うことができます。

KotlinのMapを使いこなすことで、アプリケーションのデータ管理がよりシンプルかつ効果的になります。日々の開発で積極的に活用していきましょう。

Kotlin
データ構造 map Kotlin キーと値

コメント

コメントする

目次