الهياكل

الهياكل — Structs

الهيكل (Struct) هو نوع بيانات مركّب يجمع عدة حقول (fields) في وحدة واحدة. فكّر فيه كـ “class” مبسّطة — Go لا تحتوي على classes بالمعنى التقليدي.

تعريف هيكل

main.go

package main

import "fmt"

// تعريف هيكل — Define a struct
type Person struct {
    Name    string
    Age     int
    City    string
    IsAdmin bool
}

func main() {
    // إنشاء — Create
    p1 := Person{
        Name:    "عزيز",
        Age:     25,
        City:    "المدينة المنورة",
        IsAdmin: true,
    }
    fmt.Println("الشخص:", p1)
    
    // الوصول للحقول — Access fields
    fmt.Println("الاسم:", p1.Name)
    fmt.Println("العمر:", p1.Age)
    
    // تعديل — Modify
    p1.Age = 26
    fmt.Println("العمر الجديد:", p1.Age)
    
    // إنشاء بالترتيب — Positional (غير مُستحسن)
    p2 := Person{"سارة", 30, "الرياض", false}
    fmt.Println("شخص ٢:", p2)
    
    // إنشاء جزئي — Partial (باقي الحقول = قيم صفرية)
    p3 := Person{Name: "أحمد"}
    fmt.Printf("شخص ٣: %+v\n", p3) // %+v يعرض أسماء الحقول
}

Output:

الطرق (Methods)

الطرق هي دوال مرتبطة بنوع معين. تُعرّف بإضافة مستقبِل (receiver) قبل اسم الدالة:

main.go

package main

import "fmt"

type Rectangle struct {
    Width  float64
    Height float64
}

// طريقة — Method (value receiver)
func (r Rectangle) Area() float64 {
    return r.Width * r.Height
}

func (r Rectangle) Perimeter() float64 {
    return 2 * (r.Width + r.Height)
}

// طريقة تعرض المعلومات — Display method
func (r Rectangle) String() string {
    return fmt.Sprintf("مستطيل %.1f×%.1f (مساحة: %.1f)", r.Width, r.Height, r.Area())
}

// طريقة بمؤشر — Pointer receiver (تُعدّل الهيكل)
func (r *Rectangle) Scale(factor float64) {
    r.Width *= factor
    r.Height *= factor
}

func main() {
    rect := Rectangle{Width: 10, Height: 5}
    
    fmt.Println("المساحة:", rect.Area())
    fmt.Println("المحيط:", rect.Perimeter())
    fmt.Println(rect.String())
    
    // التكبير — Scale
    rect.Scale(2)
    fmt.Println("\nبعد التكبير ×2:")
    fmt.Println(rect.String())
}

Output:

متى نستخدم pointer receiver (*)؟

عندما تريد تعديل الهيكل
عندما يكون الهيكل كبيراً (لتجنب النسخ)
القاعدة: إذا طريقة واحدة تحتاج pointer، اجعل كل الطرق pointer

المُنشئات (Constructors)

Go ليس فيها constructors رسمية، لكن الاصطلاح هو كتابة دالة New...:

main.go

package main

import "fmt"

type User struct {
    ID       int
    Username string
    Email    string
    Active   bool
}

// مُنشئ — Constructor function
func NewUser(id int, username, email string) *User {
    return &User{
        ID:       id,
        Username: username,
        Email:    email,
        Active:   true, // قيمة افتراضية
    }
}

func (u User) Display() {
    status := "❌"
    if u.Active {
        status = "✅"
    }
    fmt.Printf("[%d] %s <%s> %s\n", u.ID, u.Username, u.Email, status)
}

func main() {
    u1 := NewUser(1, "aziz", "aziz@example.com")
    u2 := NewUser(2, "sara", "sara@example.com")
    
    u1.Display()
    u2.Display()
    
    // تعطيل حساب — Deactivate
    u2.Active = false
    u2.Display()
}

Output:

التضمين (Embedding)

بدلاً من الوراثة (inheritance)، Go تستخدم التضمين (embedding) — تضع هيكلاً داخل هيكل آخر:

main.go

package main

import "fmt"

// هيكل أساسي — Base struct
type Address struct {
    City    string
    Country string
}

func (a Address) Full() string {
    return a.City + ", " + a.Country
}

// تضمين — Embedding
type Employee struct {
    Name    string
    Role    string
    Salary  float64
    Address // تضمين — مثل وراثة
}

func (e Employee) Info() string {
    return fmt.Sprintf("%s (%s) — %s — %.0f ر.س", e.Name, e.Role, e.Full(), e.Salary)
}

func main() {
    emp := Employee{
        Name:   "عزيز",
        Role:   "مطور",
        Salary: 15000,
        Address: Address{
            City:    "المدينة المنورة",
            Country: "السعودية",
        },
    }
    
    fmt.Println(emp.Info())
    
    // الوصول المباشر لحقول Address — Direct access
    fmt.Println("المدينة:", emp.City)      // بدون emp.Address.City
    fmt.Println("العنوان:", emp.Full())     // بدون emp.Address.Full()
}

Output:

Tags والتحويل لـ JSON

Tags معلومات إضافية على الحقول — الاستخدام الأشهر هو JSON:

main.go

package main

import (
    "encoding/json"
    "fmt"
)

type Product struct {
    ID    int     `json:"id"`
    Name  string  `json:"name"`
    Price float64 `json:"price"`
    Stock int     `json:"stock,omitempty"` // يُحذف إذا صفر
}

func main() {
    // تحويل لـ JSON — Marshal
    p := Product{
        ID:    1,
        Name:  "كتاب Go",
        Price: 49.99,
        Stock: 100,
    }
    
    jsonData, _ := json.MarshalIndent(p, "", "  ")
    fmt.Println("JSON:")
    fmt.Println(string(jsonData))
    
    // تحويل من JSON — Unmarshal
    jsonStr := `{"id": 2, "name": "كتاب Rust", "price": 59.99}`
    var p2 Product
    json.Unmarshal([]byte(jsonStr), &p2)
    fmt.Printf("\nمن JSON: %+v\n", p2)
}

Output:

تحدي — Challenge

package main

import "fmt"

// عرّف هيكل Student بحقلي Name و Score
type Student struct {
    Name  string
    Score int
}

// أرجع النص بتنسيق "الاسم: العلامة" — اكتب الكود هنا
func (s Student) Display() string {
    return ""
}

func main() {
    s1 := Student{Name: "أحمد", Score: 95}
    s2 := Student{Name: "سارة", Score: 88}
    fmt.Printf("%s | %s\n", s1.Display(), s2.Display())
}