كيف تعمل الخرائط في Go؟

Question

Accepted Answer

**الخريطة** هي جدول التجزئة المدمج في Go — مجموعة غير مرتبة من **أزواج المفتاح والقيمة** بمتوسط بحث O(1). إنها الطريقة القياسية لربط المفاتيح بالقيم.

## إنشاء واستخدام الخرائط

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

## اصطلاح الفاصلة-ok — التمييز بين "غير موجود" و"صفر"

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

هذا أمر أساسي: الوصول إلى مفتاح غير موجود يُرجع القيمة الافتراضية لنوع القيمة (0، ""، nil)، لذا لا **يمكنك التمييز** بين "المفتاح غير موجود" و"المفتاح موجود بقيمة صفر" من خلال القيمة وحدها — القيمة المنطقية `, ok` تحل الالتباس.

## التكرار (الترتيب عشوائي)

```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 بتعشية ترتيب تكرار الخريطة بشكل مقصود (لمنع الكود من الاعتماد عليه) — إذا كنت بحاجة إلى تكرار مرتب، قم بفرز المفاتيح بنفسك.

## فخ الخريطة الفارغة

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

خريطة فارغة يمكن قراءتها لكن **تسبب panic عند الكتابة** — يجب عليك `make()` ها (أو استخدام حرفي) قبل التخزين.

## يجب أن تكون المفاتيح قابلة للمقارنة

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

## لماذا يهم هذا

الخرائط هي بنية بيانات Go أساسية وتُستخدم بشكل مستمر لربط المفاتيح بالقيم والبحث السريع (الذاكرة المؤقتة، الفهارس، العد، التجميع).

هناك عدة سلوكيات ضرورية للمعرفة وهي مصادر أخطاء شائعة: **اصطلاح الفاصلة-ok** (الطريقة الوحيدة الموثوقة للتحقق من وجود المفتاح، حيث يُرجع المفتاح الغير موجود القيمة الافتراضية)، **ترتيب التكرار العشوائي** (لا تعتمد عليه أبداً — قم بفرز المفاتيح للحصول على مخرجات مرتبة)، و**panic الكتابة في خريطة فارغة** (قم بالتهيئة دائماً قبل الكتابة).

فهم هذه الأمور — بالإضافة إلى أن المفاتيح يجب أن تكون من أنواع قابلة للمقارنة — ضروري لـ Go الصحيح اليومي ويعكس نوع التفاصيل العملية التي تميز مطوري Go الموثوقين وتظهر بشكل متكرر في المقابلات.