Kotlinのマップ（Map）の基本！キーと値の管理をわかりやすく解説

1. KotlinのMap（マップ）とは？｜キーと値をペアで管理する仕組み

1. KotlinのMap（マップ）とは？｜キーと値をペアで管理する仕組み

KotlinのMap（マップ）とは、特定の「キー（Key）」とそれに関連付けられた「値（Value）」をペアにして保存するデータ構造です。プログラミングの世界では「連想配列」や「辞書」とも呼ばれます。

例えば、「ユーザー名（キー）」と「メールアドレス（値）」、「商品コード（キー）」と「価格（値）」のように、何かをフックにして特定の情報を引き出したいときに非常に役立ちます。List（リスト）が番号順にデータを並べるのに対し、Mapは「ラベルを貼って管理する」というイメージです。

基本的なイメージをコードで見てみよう

まずは、一番シンプルなMapの形をコードで確認してみましょう。

fun main() {
    // 「名前」をキーにして「年齢」を保存するMapの作成
    val userAgeMap = mapOf("田中さん" to 25, "佐藤さん" to 32)
    
    // 中身をまるごと表示
    println(userAgeMap)
}

{田中さん=25, 佐藤さん=32}

このように、toというキーワードを使って「左側のデータから右側のデータを呼び出せる状態」にするのが、KotlinにおけるMapの役割です。一見難しそうに見えますが、「特定のキーワードで情報を検索しやすくするための整理棚」だと覚えておけば間違いありません。

2. KotlinでのMapの作り方と基本構文

2. KotlinでのMapの作り方と基本構文

プログラミングにおいて、特定のデータ（値）に名前（キー）を付けて管理できると非常に便利です。Kotlinでこの「名簿」のような仕組みを作るには、mapOf()という関数を使います。

まずは、初心者の方でもイメージしやすい「電話帳」を例にした基本の書き方を見てみましょう。

fun main() {
    // mapOf(キー to 値) の形式でデータを並べます
    val phoneBook = mapOf("たろう" to "090-1234-5678", "はなこ" to "080-8765-4321")
    
    // 作成したMapの中身をすべて表示
    println(phoneBook)
}

{たろう=090-1234-5678, はなこ=080-8765-4321}

書き方のポイントは、"たろう" to "090-1234-5678" のように、「キー（Key） to 値（Value）」という形式でペアを作ることです。このtoという直感的なキーワードのおかげで、どの名前がどの番号に紐付いているのか一目で理解できます。

また、このmapOf()で作られたMapは「読み取り専用（不変 / Immutable）」という性質を持っています。一度作成すると、後から中身を追加したり削除したりすることができないため、プログラムの途中でデータが勝手に書き換わってしまうミスを防げる安全な設計になっています。

「まずは基本の形を作って、中身を安全に参照したい」という場合に最適な、最もスタンダードな作成方法です。

3. 値を取り出すには？

3. 値を取り出すには？

Mapに登録した情報から、特定のキーに対応する値を取り出すには、以下のようにします。

fun main() {
    val phoneBook = mapOf("たろう" to "090-1234-5678", "はなこ" to "080-8765-4321")
    val taroPhone = phoneBook["たろう"]
    println("たろうの電話番号：$taroPhone")
}

たろうの電話番号：090-1234-5678

[]（角かっこ）でキーを指定するだけで、対応する値が取り出せます。

4. Mapのループ処理で全体を表示

4. Mapのループ処理で全体を表示

Mapの中身をすべて表示したいときは、for文とentriesを使ってループ処理を行います。

fun main() {
    val capitals = mapOf("東京" to "東京都", "大阪" to "大阪府", "名古屋" to "愛知県")

    for ((city, prefecture) in capitals) {
        println("$city の県庁所在地は $prefecture です")
    }
}

東京 の県庁所在地は 東京都 です
大阪 の県庁所在地は 大阪府 です
名古屋 の県庁所在地は 愛知県 です

(キー, 値)の形で取り出せるので、とても読みやすく書けます。

5. MutableMapで追加・変更・削除する

5. MutableMapで追加・変更・削除する

Mapをあとから変更したい場合は、mutableMapOf()を使って可変のMap（MutableMap）を作ります。

追加・更新

fun main() {
    val ages = mutableMapOf("たろう" to 20)
    ages["はなこ"] = 22
    ages["たろう"] = 21 // 上書き
    println(ages)
}

{たろう=21, はなこ=22}

削除

ages.remove("たろう")
println(ages)

{はなこ=22}

キーを指定するだけで簡単に追加・変更・削除ができます。

6. Mapの活用例：教科と点数の管理

6. Mapの活用例：教科と点数の管理

たとえば、科目と点数のような関係もMapで表せます。以下は、生徒のテスト結果をMapで管理して表示する例です。

fun main() {
    val scores = mutableMapOf("国語" to 80, "数学" to 90, "英語" to 70)
    scores["理科"] = 85

    println("テスト結果一覧：")
    for ((subject, score) in scores) {
        println("$subject：$score 点")
    }
}

テスト結果一覧：
国語：80 点
数学：90 点
英語：70 点
理科：85 点

このように、1つのキーに1つの値をセットすることで、いろんな場面に活用できます。