الدوال

الدوال — Functions

الدوال هي اللبنة الأساسية لتنظيم الكود في Go. كل برنامج Go يبدأ بدالة main، لكنك ستكتب عشرات الدوال في أي مشروع حقيقي.

تعريف دالة بسيطة

func greet() {
    fmt.Println("مرحباً!")
}

دالة مع معاملات (Parameters)

func greet(name string) {
    fmt.Println("مرحباً يا", name)
}

إذا كانت المعاملات من نفس النوع، يمكنك اختصار الكتابة:

func add(a, b int) int {    // a و b كلاهما int
    return a + b
}

دالة مع قيمة مُرجعة (Return Value)

main.go

package main

import "fmt"

// دالة الجمع — Add function
func add(a, b int) int {
    return a + b
}

// دالة التحية — Greet function
func greet(name string) string {
    return "مرحباً يا " + name + "! 👋"
}

// دالة المساحة — Area of rectangle
func area(width, height float64) float64 {
    return width * height
}

func main() {
    result := add(15, 27)
    fmt.Println("15 + 27 =", result)
    
    msg := greet("عزيز")
    fmt.Println(msg)
    
    a := area(5.5, 3.2)
    fmt.Printf("المساحة: %.2f\n", a)
}

Output:

الإرجاع المتعدد (Multiple Returns)

هذه من أقوى ميزات Go — الدالة يمكنها إرجاع عدة قيم. يُستخدم كثيراً لإرجاع نتيجة + خطأ:

main.go

package main

import (
    "errors"
    "fmt"
)

// القسمة مع معالجة الخطأ — Division with error handling
func divide(a, b float64) (float64, error) {
    if b == 0 {
        return 0, errors.New("لا يمكن القسمة على صفر!")
    }
    return a / b, nil
}

// إرجاع الاسم الأول والأخير — Return first and last name
func splitName(full string) (string, string) {
    // تبسيط: نفترض كلمتين
    for i, ch := range full {
        if ch == ' ' {
            return full[:i], full[i+1:]
        }
    }
    return full, ""
}

func main() {
    // القسمة الناجحة — Successful division
    result, err := divide(10, 3)
    if err != nil {
        fmt.Println("خطأ:", err)
    } else {
        fmt.Printf("10 ÷ 3 = %.2f\n", result)
    }
    
    // القسمة على صفر — Division by zero
    _, err2 := divide(10, 0)
    if err2 != nil {
        fmt.Println("خطأ:", err2)
    }
    
    // تقسيم الاسم — Split name
    first, last := splitName("Ahmed Ali")
    fmt.Printf("الأول: %s, الأخير: %s\n", first, last)
}

Output:

ملاحظة: _ (underscore) تُستخدم لتجاهل قيمة مُرجعة لا تحتاجها. Go لا يسمح بمتغيرات غير مستخدمة!

الإرجاع المُسمّى (Named Returns)

يمكنك تسمية القيم المُرجعة — وعند ذلك return بدون قيم يُرجع القيم الحالية:

main.go

package main

import "fmt"

// إرجاع مُسمّى — Named return values
func rectangleInfo(w, h float64) (area, perimeter float64) {
    area = w * h
    perimeter = 2 * (w + h)
    return // يُرجع area و perimeter تلقائياً — naked return
}

func main() {
    a, p := rectangleInfo(5, 3)
    fmt.Printf("المساحة: %.1f, المحيط: %.1f\n", a, p)
}

Output:

الدوال كقيم (Functions as Values)

في Go، الدوال هي قيم من الدرجة الأولى — يمكنك تخزينها في متغيرات وتمريرها كمعاملات:

main.go

package main

import "fmt"

func main() {
    // دالة مجهولة — Anonymous function
    square := func(n int) int {
        return n * n
    }
    
    fmt.Println("مربع 5:", square(5))
    fmt.Println("مربع 9:", square(9))
    
    // تمرير دالة كمعامل — Function as parameter
    apply := func(nums []int, fn func(int) int) []int {
        result := make([]int, len(nums))
        for i, n := range nums {
            result[i] = fn(n)
        }
        return result
    }
    
    numbers := []int{1, 2, 3, 4, 5}
    squares := apply(numbers, square)
    fmt.Println("الأعداد:", numbers)
    fmt.Println("المربعات:", squares)
    
    // دالة مجهولة فورية — Immediately invoked
    result := func(a, b int) int {
        return a * b
    }(6, 7)
    fmt.Println("6 × 7 =", result)
}

Output:

الدوال المتغيرة (Variadic Functions)

دوال تقبل عدداً غير محدد من المعاملات باستخدام ...:

main.go

package main

import "fmt"

// مجموع أي عدد من الأرقام — Sum any number of ints
func sum(nums ...int) int {
    total := 0
    for _, n := range nums {
        total += n
    }
    return total
}

func main() {
    fmt.Println("مجموع 1,2,3:", sum(1, 2, 3))
    fmt.Println("مجموع 10,20:", sum(10, 20))
    fmt.Println("مجموع فارغ:", sum())
    
    // تمرير شريحة — Pass a slice
    nums := []int{5, 10, 15, 20}
    fmt.Println("مجموع الشريحة:", sum(nums...))
}

Output:

defer — التأجيل

defer يؤجل تنفيذ دالة حتى انتهاء الدالة الحالية. يُستخدم كثيراً لإغلاق الملفات واتصالات قواعد البيانات:

main.go

package main

import "fmt"

func main() {
    fmt.Println("بداية")
    
    defer fmt.Println("هذا يُنفذ أخيراً (3)")
    defer fmt.Println("هذا يُنفذ ثانياً (2)")
    defer fmt.Println("هذا يُنفذ أولاً (1)")
    
    fmt.Println("نهاية")
    
    // الترتيب: بداية → نهاية → (1) → (2) → (3)
    // defer يعمل بنظام LIFO (آخر من يدخل أول من يخرج)
}

Output:

تحدي — Challenge

package main

import "fmt"

// أنشئ دالة greet ترجع "مرحبا من Go!"
func greet() string {
    // اكتب الكود هنا
    return ""
}

// أنشئ دالة sum تقبل 3 أعداد وترجع مجموعهم
func sum(a, b, c int) int {
    // اكتب الكود هنا
    return 0
}

func main() {
    msg := greet()
    total := sum(50, 60, 40)
    fmt.Printf("%s المجموع: %d\n", msg, total)
}