كيف تعمل الدوال والقيم المتعددة في Go؟

Question

Accepted Answer

دوال Go يتم التصريح عنها باستخدام `func`، والميزة المميزة هي **القيم المتعددة المرجعة** — يمكن للدالة أن ترجع عدة قيم في نفس الوقت. يتم استخدام هذا على نطاق واسع، خاصة في idiom `(result, error)` الذي يحدد نهج معالجة الأخطاء في Go.

## الدوال الأساسية

```go
func add(a int, b int) int {     // params with types, then the return type
    return a + b
}

func greet(name string) string {
    return "Hello, " + name
}
// shorthand for same-typed params: func add(a, b int) int
```

## القيم المتعددة المرجعة — الميزة المميزة

```go
func divide(a, b int) (int, error) {     // returns BOTH a result AND an error
    if b == 0 {
        return 0, errors.New("division by zero")
    }
    return a / b, nil    // nil error = success
}

// callers handle both — the ubiquitous Go error pattern
result, err := divide(10, 2)
if err != nil {
    log.Fatal(err)       // handle the error
}
fmt.Println(result)
```

إرجاع `(value, error)` هو idiom في معالجة الأخطاء في Go — بدلاً من الاستثناءات، تقوم الدوال بإرجاع الأخطاء كقيم يتحقق منها المستدعون بشكل صريح. هذا يجعل معالجة الأخطاء مرئية ومستحيل تجاهلها بصمت.

## نمط comma-ok

```go
// many built-ins return (value, ok) — a boolean for "did it work?"
value, ok := myMap["key"]   // ok = false if the key is missing
if ok { ... }

v, ok := someInterface.(string)   // type assertion with ok
```

## القيم المرجعة المسماة

```go
func split(sum int) (x, y int) {   // named returns
    x = sum * 4 / 9
    y = sum - x
    return   // "naked return" — returns the named values
}
```

## الدوال متغيرة المعاملات

```go
func sum(nums ...int) int {     // accepts any number of ints
    total := 0
    for _, n := range nums {
        total += n
    }
    return total
}
sum(1, 2, 3)          // 6
sum(nums...)          // spread a slice into args
```

## الدوال كائنات من الدرجة الأولى

```go
var op func(int, int) int = add   // assign functions to variables
func apply(fn func(int) int, x int) int { return fn(x) }  // pass as arguments
```

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

دوال Go مركزية، و**القيم المتعددة المرجعة** هي إحدى الميزات المميزة للغة — فهي تتيح idiom `(result, error)` الذي *هو* نهج Go في معالجة الأخطاء (الفحص الصريح للخطأ كقيمة بدلاً من الاستثناءات).

هذا النمط، المستخدم في كل برنامج Go تقريباً، يجعل معالجة الأخطاء مرئية ومقصودة.

idiom comma-ok ذات الصلة (`value, ok :=`) تظهر في جميع الأماكن (الوصول إلى الخرائط، تأكيدات النوع، استقبالات القنوات).

فهم القيم المتعددة المرجعة، ونمط الخطأ، والقيم المرجعة المسماة، والدوال متغيرة المعاملات، والدوال من الدرجة الأولى ضروري لقراءة وكتابة Go الاصطلاحي — وفلسفة الخطأ كقيمة هي أحد أهم الفروقات المفاهيمية بين Go واللغات القائمة على الاستثناءات.