Si funksionojnë hartat në Go?

Question

Accepted Answer

Një **hartë** është tabela hash e ndërtuar në Go — një koleksion i pa-renditur i **çifteve kyç-vlerë** me kërkim O(1) në mesatare. Është mënyra standarde për të lidhur kyçet me vlerat.

## Krijimi dhe përdorimi i hartave

```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
```

## Idioma comma-ok — dallimi midis "mungon" dhe "zero"

```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
}
```

Kjo është thelbësore: qasja në një kyç që mungon kthen vlerën zero të tipit të vlerës (0, "", nil), kështu që **nuk mund të dalloni** "kyçi mungon" nga "kyçi i pranishëm me vlerë zero" vetëm me vlerën — boolean-i `, ok` e qartëson këtë.

## Iterimi (rendi është RASTËSOR)

```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 përqëllimisht rastësoi rendin e iterimit të hartës (për të parandaluar kodin nga varësia në të) — nëse keni nevojë për iterim të renditur, renditni vetë kyçet.

## Kurth-ja e hartës 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)
```

Una hartë nil mund të lexohet por **pritet në shkrim** — duhet ta bëni atë me `make()` (ose të përdorni një literal) përpara se të ruani.

## Kyçet duhet të jenë të krahasueshëm

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

## Pse ka rëndësi

Hartat janë një strukturë themelore, përdorur vazhdimisht në Go për shoqérimet kyç-vlerë dhe kërkimet e shpejta (cache, indekse, numërim, grupim).

Disa sjellje janë thelbësore për t'u njohur dhe janë burime të zakonshme gabimesh: **idioma comma-ok** (mënyra e vetme e besueshme për të kontrolluar ekzistencën e kyçit, pasi një kyç që mungon kthen vlerën zero), **rendi i rastësishëm i iterimit** (asnjëherë mos varësoni kodi në të — renditni kyçet për dalje të renditur), dhe **panika e hartës nil në shkrim** (gjithmonë inicializoni para se të shkruani).

Kuptimi i këtyre — plus se kyçet duhet të jenë tipet e krahasueshme — është i nevojshëm për Go të saktë përditë dhe pasqyron llojin e detajit praktik që dallon programuesit e fortë të Go dhe shfaqet shpesh në intervista.