الخرائط

Maps

مفهوم ~18 دقيقة

الخرائط — Maps

الخريطة (Map) هي بنية بيانات تخزن أزواج مفتاح-قيمة (key-value pairs). تُعرف في لغات أخرى بـ dictionary (Python) أو HashMap (Java) أو Object (JavaScript).

إنشاء خريطة

main.go

package main

import "fmt"

func main() {
    // الطريقة الأولى: make — Create with make
    ages := make(map[string]int)
    ages["أحمد"] = 25
    ages["سارة"] = 30
    ages["عمر"] = 22
    
    fmt.Println("الأعمار:", ages)
    fmt.Println("عمر أحمد:", ages["أحمد"])
    
    // الطريقة الثانية: القيمة المباشرة — Map literal
    capitals := map[string]string{
        "السعودية": "الرياض",
        "مصر":      "القاهرة",
        "الأردن":   "عمّان",
        "المغرب":   "الرباط",
    }
    
    fmt.Println("\nالعواصم:", capitals)
    fmt.Println("عاصمة السعودية:", capitals["السعودية"])
}

Output:

الوصول والتحقق

عند الوصول لمفتاح غير موجود، Go يُرجع القيمة الصفرية. لذلك نستخدم صيغة القيمتين:

main.go

package main

import "fmt"

func main() {
    scores := map[string]int{
        "رياضيات": 95,
        "فيزياء":  88,
        "كيمياء":  92,
    }
    
    // الوصول لمفتاح موجود — Access existing key
    math := scores["رياضيات"]
    fmt.Println("رياضيات:", math)
    
    // الوصول لمفتاح غير موجود — Non-existing key
    bio := scores["أحياء"]
    fmt.Println("أحياء:", bio) // 0 (القيمة الصفرية)
    
    // التحقق من الوجود — Check existence (comma ok idiom)
    val, exists := scores["فيزياء"]
    if exists {
        fmt.Println("فيزياء موجودة:", val)
    }
    
    val2, exists2 := scores["تاريخ"]
    if !exists2 {
        fmt.Println("تاريخ غير موجودة, القيمة:", val2)
    }
    
    // النمط الشائع — Common pattern
    if grade, ok := scores["كيمياء"]; ok {
        fmt.Println("كيمياء:", grade)
    }
}

Output:

التعديل والحذف

main.go

package main

import "fmt"

func main() {
    users := map[string]string{
        "admin":  "عزيز",
        "editor": "سارة",
    }
    fmt.Println("قبل:", users)
    
    // إضافة — Add
    users["viewer"] = "أحمد"
    fmt.Println("بعد الإضافة:", users)
    
    // تعديل — Update
    users["admin"] = "محمد"
    fmt.Println("بعد التعديل:", users)
    
    // حذف — Delete
    delete(users, "editor")
    fmt.Println("بعد الحذف:", users)
    
    // عدد العناصر — Length
    fmt.Println("العدد:", len(users))
}

Output:

المرور على الخريطة (Iteration)

main.go

package main

import "fmt"

func main() {
    population := map[string]int{
        "الرياض":        7_500_000,
        "جدة":          4_600_000,
        "المدينة المنورة": 1_500_000,
        "مكة المكرمة":    2_000_000,
    }
    
    // المرور على كل العناصر — Iterate all
    fmt.Println("=== سكان المدن ===")
    for city, pop := range population {
        fmt.Printf("  %s: %d نسمة\n", city, pop)
    }
    
    // المفاتيح فقط — Keys only
    fmt.Println("\nالمدن:")
    for city := range population {
        fmt.Println(" -", city)
    }
    
    // ⚠️ ترتيب المرور عشوائي! — Iteration order is random!
    // إذا أردت ترتيباً، اجمع المفاتيح في شريحة ورتبها
}

Output:

أنماط عملية

main.go

package main

import (
    "fmt"
    "strings"
)

func main() {
    // عدّ الكلمات — Word counter
    text := "go is simple go is fast go is fun"
    words := strings.Fields(text)
    counter := make(map[string]int)
    
    for _, word := range words {
        counter[word]++
    }
    
    fmt.Println("=== عدد الكلمات ===")
    for word, count := range counter {
        fmt.Printf("  %s: %d\n", word, count)
    }
    
    // تجميع — Grouping
    students := []struct {
        Name  string
        Grade string
    }{
        {"أحمد", "A"},
        {"سارة", "B"},
        {"عمر", "A"},
        {"فاطمة", "A"},
        {"خالد", "B"},
    }
    
    groups := make(map[string][]string)
    for _, s := range students {
        groups[s.Grade] = append(groups[s.Grade], s.Name)
    }
    
    fmt.Println("\n=== التجميع حسب الدرجة ===")
    for grade, names := range groups {
        fmt.Printf("  %s: %v\n", grade, names)
    }
}

Output:

خرائط متداخلة (Nested Maps)

main.go

package main

import "fmt"

func main() {
    // بيانات طلاب — Student data
    students := map[string]map[string]int{
        "أحمد": {
            "رياضيات": 95,
            "فيزياء":  88,
        },
        "سارة": {
            "رياضيات": 92,
            "فيزياء":  97,
        },
    }
    
    // الوصول — Access
    fmt.Println("درجة أحمد في الرياضيات:", students["أحمد"]["رياضيات"])
    
    // إضافة طالب جديد — Add new student
    students["عمر"] = map[string]int{
        "رياضيات": 78,
        "فيزياء":  82,
    }
    
    // طباعة الكل — Print all
    for name, grades := range students {
        fmt.Printf("%s: %v\n", name, grades)
    }
}

Output:

تحدي — Challenge

package main

import "fmt"

func main() {
    // عُد الأحرف المتحركة في "hello"
    // Count vowels in "hello"
    vowels := map[rune]bool{'a': true, 'e': true, 'i': true, 'o': true, 'u': true}
    count := 0
    // استخدم range على "hello" وتحقق من كل حرف في خريطة vowels
    // اكتب الكود هنا
    fmt.Println(count)
}