Bagaimanakah peta berfungsi dalam Go?

Question

Accepted Answer

Sebuah **map** adalah jadual hash bawaan Go — koleksi **pasangan kunci-nilai** yang tidak tersusun dengan pencarian O(1) rata-rata. Ini adalah cara standar untuk mengaitkan kunci dengan nilai.

## Membuat dan menggunakan peta

```go
// create with make
ages := make(map[string]int)    // map from string keys to int values
ages["Ann"] = 30                 // set
age := ages["Ann"]               // get → 30

// or with a literal
scores := map[string]int{
    "math":    90,
    "science": 85,
}

delete(scores, "math")           // remove a key
len(scores)                       // number of entries
```

## Idiom koma-ok — membezakan "hilang" daripada "sifar"

```go
// ⚠️ a missing key returns the ZERO VALUE, not an error
value := scores["missing"]       // 0 — but was it stored as 0, or absent? Ambiguous!

// ✅ the comma-ok form tells you if the key EXISTS
value, ok := scores["missing"]
if ok {
    fmt.Println("found:", value)
} else {
    fmt.Println("not present")    // key doesn't exist
}
```

Ini adalah penting: mengakses kunci yang hilang mengembalikan nilai sifar jenis nilai (0, "", nil), jadi anda **tidak boleh membezakan** "kunci tidak hadir" daripada "kunci hadir dengan nilai sifar" dengan nilai sahaja — boolean `, ok` menjelaskan kekaburan.

## Mengulangi (susunan adalah RAWAK)

```go
for key, value := range scores {
    fmt.Println(key, value)
}
// ⚠️ iteration order is RANDOMIZED — never rely on map order!
// To iterate in order: collect keys into a slice, sort it, then iterate.
```

Go dengan sengaja merawakkan urutan lelaran peta (untuk mencegah kod bergantung padanya) — jika anda memerlukan lelaran yang teratur, susunkan kunci anda sendiri.

## Perangkap peta nil

```go
var m map[string]int        // nil map (declared but not initialized)
v := m["x"]                 // ✅ reading is OK → 0
m["x"] = 1                  // 💥 PANIC: assignment to entry in nil map
// must initialize first: m = make(map[string]int)
```

Peta nil boleh dibaca tetapi **panik semasa menulis** — anda mesti `make()` (atau gunakan literal) sebelum menyimpan.

## Kunci mesti dapat dibandingkan

```text
Valid keys: comparable types (string, int, bool, structs of comparable fields, pointers)
Invalid keys: slices, maps, functions (not comparable) → compile error
```

## Mengapa ini penting

Peta adalah struktur data Go yang asas dan sering digunakan untuk persatuan kunci-nilai dan pencarian cepat (cache, indeks, pengiraan, pengelompokan).

Beberapa tingkah laku adalah penting untuk diketahui dan merupakan sumber kesilapan yang biasa: **idiom koma-ok** (satu-satunya cara yang boleh dipercayai untuk memeriksa kewujudan kunci, kerana kunci yang hilang mengembalikan nilai sifar), **susunan lelaran yang dirawakkan** (jangan pernah bergantung padanya — susunkan kunci untuk output yang teratur), dan **panik tulis peta nil** (selalu mulai sebelum menulis).

Memahami ini — ditambah bahawa kunci mesti jenis yang dapat dibandingkan — adalah perlu untuk Go yang betul sehari-hari dan mencerminkan jenis perincian praktikal yang membezakan pembangun Go yang kukuh dan sering muncul dalam temuduga.