Go リファレンス

実行できる例で、JSON のオプションフィールド、厳格なデコード、順序が安定したマップ比較を学びます。

サンプルの実行方法

Go 1.21 以降を用意します。各プログラムを main.go として保存し、go run main.go を実行します。外部モジュールは不要です。

フィールドの欠落とゼロを区別する

新しく作った構造体では、JSON にフィールドがないとポインターは nil のままです。0 が指定されると、0 を指すポインターになります。

go
package main

import (
    "encoding/json"
    "fmt"
)

type Config struct {
    Port *int `json:"port"`
}

func main() {
    for _, input := range []string{"{}", `{"port":0}`} {
        var config Config
        if err := json.Unmarshal([]byte(input), &config); err != nil {
            panic(err)
        }
        if config.Port == nil {
            fmt.Println("port missing or null")
        } else {
            fmt.Println("port:", *config.Port)
        }
    }
}

出力例

port missing or null
port: 0

よくある間違い

新しい構造体ではフィールドの欠落と明示的な null はどちらも nil になります。ポインターだけでは両者を区別できません。

公式ドキュメント

未知のフィールドと余分な JSON を拒否する

構造体に読み込むときは DisallowUnknownFields で未知のフィールドを拒否します。JSON 値が一つだけ必要な場合、二度目のデコードは io.EOF になる必要があります。

go
package main

import (
    "encoding/json"
    "fmt"
    "io"
    "strings"
)

func accepted(input string) bool {
    decoder := json.NewDecoder(strings.NewReader(input))
    decoder.DisallowUnknownFields()

    var config struct { Port int `json:"port"` }
    if err := decoder.Decode(&config); err != nil {
        return false
    }

    var extra any
    return decoder.Decode(&extra) == io.EOF
}

func main() {
    fmt.Println(accepted(`{"port":80}`))
    fmt.Println(accepted(`{"port":80,"unknown":true}`))
    fmt.Println(accepted(`{"port":80} {"port":81}`))
}

出力例

true
false
false

よくある間違い

DisallowUnknownFields は重複キーを拒否しません。JSON 値を一つに限定するときは、後続データも確認します。

公式ドキュメント

マップの変更を一定の順序で出力する

値と ok を返す形式でキーを検索し、両方にあるキーだけ比較します。マップの反復順序は一定ではないので、結果を並べ替えます。

go
package main

import (
    "fmt"
    "slices"
)

func main() {
    before := map[string]int{"port": 80, "retries": 3, "timeout": 10}
    after := map[string]int{"port": 8080, "timeout": 0}
    var changed []string
    for key, old := range before {
        if current, ok := after[key]; ok && current != old {
            changed = append(changed, key)
        }
    }
    slices.Sort(changed)
    fmt.Println(changed)
}

出力例

[port timeout]

よくある間違い

整数値を持つマップで存在しないキーを検索すると 0 が返ります。明示された 0 として扱う前に ok を確認します。

公式ドキュメント

関連ツール