マップ

マップは、キーと値のペアを保持するデータ構造です。キーを指定するだけで対応する値を素早く取り出せるため、スライスをループで探すよりも効率的に検索できます。他言語では「辞書型」や「連想配列」と呼ばれるものに相当します。

1. マップの初期化

マップは、キーと値のペアを並べて初期化できます。書き方は以下のとおりです。

変数名 := map[キー型]値型{
    キー1: 値1,
    キー2: 値2,
    ...
}

次のコードは、名前と得点のペアを持つマップを初期化して、特定の名前で値を取り出す例です。

package main

import "fmt"

func main() {
    scores := map[string]int{
        "Taro":   85,
        "Jiro":   72,
        "Hanako": 90,
    }

    fmt.Println(scores["Taro"])
    fmt.Println(scores["Hanako"])
}

以下のような実行結果が表示されます。

85
90

"Taro" と "Hanako" のキーに対応する得点がそれぞれ出力されました。

コードを解説します。

scores := map[string]int{
    "Taro":   85,
    "Jiro":   72,
    "Hanako": 90,
}

map[string]int は「string 型のキーと int 型の値を持つマップ」を意味します。{"Taro": 85, ...} の形でキーと値のペアを初期化子に書きます。

fmt.Println(scores["Taro"])

マップ名[キー] の形で、キーに対応する値を取得できます。scores["Taro"] は 85、scores["Hanako"] は 90 を返します。

2. makeによる空マップの作成

空のマップを作りたい場合は make を使います。書き方は以下のとおりです。

変数名 := make(map[キー型]値型)

作った後は 変数名[キー] = 値 の形でキーと値のペアを追加できます。次のコードは、空のマップを作ってから2件追加して表示するコードです。

package main

import "fmt"

func main() {
    scores := make(map[string]int)
    scores["Taro"] = 85
    scores["Jiro"] = 72

    fmt.Println(scores)
}

以下のような実行結果が表示されます。

map[Jiro:72 Taro:85]

作った空のマップに2件追加した結果が表示されました。

コードを解説します。

scores := make(map[string]int)

make(map[string]int) で、空のマップを作ります。初期化子で値を渡さずに、あとから追加したい場合に使います。

scores["Taro"] = 85
scores["Jiro"] = 72

マップ名[キー] = 値 の形で、キーと値のペアを追加します。

3. 存在チェック

存在しないキーで取得すると、値の型のゼロ値が返ります。単なる取得と、キーが存在するかの確認を区別するには、2つ目の戻り値(ok)を受け取ります。書き方は以下のとおりです。

値, ok := 変数名[キー]

ok は真偽値で、キーが存在すれば true、しなければ false になります。次のコードは、存在しないキーと存在するキーの両方を2値受け取りで扱う例です。

package main

import "fmt"

func main() {
    scores := map[string]int{"Taro": 85}

    v, ok := scores["Jiro"]
    fmt.Println(v, ok)

    v2, ok2 := scores["Taro"]
    fmt.Println(v2, ok2)
}

以下のような実行結果が表示されます。

0 false
85 true

"Jiro" は登録されていないので 0(ゼロ値)と false が返り、"Taro" は登録されているので 85 と true が返りました。

コードを解説します。

v, ok := scores["Jiro"]

マップから値を取り出すとき、v, ok := マップ名[キー] の形で2つの戻り値を受け取れます。v に値、ok に「キーが存在したかどうか」の真偽値が入ります。

ok が true のときのみ「キーが存在する」ことを示します。ゼロ値と「存在しない」を区別する慣用パターンとして頻出です。

4. 削除

delete 関数でキーを削除します。書き方は以下のとおりです。

delete(変数名, キー)

次のコードは、"Taro" と "Jiro" の2件を持つマップから "Taro" を削除して結果を表示する例です。

package main

import "fmt"

func main() {
    scores := map[string]int{
        "Taro": 85,
        "Jiro": 72,
    }

    delete(scores, "Taro")
    fmt.Println(scores)
}

以下のような実行結果が表示されます。

map[Jiro:72]

"Taro" の要素が消え、"Jiro" のみが残ったマップが出力されました。

コードを解説します。

delete(scores, "Taro")

delete(マップ, キー) の形で、指定したキーとその値をマップから削除します。

5. for-rangeでの反復

前のセクションで扱った for-range は、マップにも同じ形で使えます。書き方は以下のとおりです。

for キー, 値 := range 変数名 {
    // 各要素に対する処理
}

次のコードは、3人分の得点マップを range で走査し、名前と点数のペアを表示するコードです。

package main

import "fmt"

func main() {
    scores := map[string]int{
        "Taro":   85,
        "Jiro":   72,
        "Hanako": 90,
    }

    for name, score := range scores {
        fmt.Printf("%s: %d\n", name, score)
    }
}

以下のような実行結果が表示されます(順序は実行ごとに変わります)。

Hanako: 90
Taro: 85
Jiro: 72

3人分のペアが取り出されて表示されました。マップの反復順序は保証されないため、表示順は実行のたびに変わります。

コードを解説します。

for name, score := range scores {
    fmt.Printf("%s: %d\n", name, score)
}

マップに range を使うと、左辺の name にキー、score に値が入り、要素の数だけループします。

📝 マップの反復順序について
Goのマップは、range で反復するたびに順序が変わることがあります。特定の順序で処理したい場合は、キーをスライスに集めて sort パッケージでソートしてから使います。