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 を確認します。