الأسماء المصدرة مقابل غير المصدرة

جزء من قسم Object Oriented Programming في رحلة GO على Coddy — الدرس 4 من 107.

في لغة Go، يحدد الحرف الأول من الاسم مدى ظهوره. الأسماء التي تبدأ بـ حرف كبير تكون مُصدّرة (يمكن الوصول إليها من حزم أخرى). أما الأسماء التي تبدأ بـ حرف صغير فتكون غير مُصدّرة (خاصة بالحزمة).

الأسماء المصدرة — مرئية خارج الحزمة

type User struct {
    Name  string  // حقل مصدر
    Email string  // حقل مصدر
}

func CreateUser(name string) User { // دالة مصدرة
    return User{Name: name}
}

الأسماء غير المصدرة — مرئية فقط داخل الحزمة

type secret struct {     // هيكل غير مصدر
    password string      // حقل غير مصدر
}

func validate() bool {   // دالة غير مصدرة
    return true
}

مزيج — struct مُصدّر مع بعض الحقول غير المُصدّرة

type Account struct {
    Username string    // مُصدّر - يمكن الوصول إليه من أي مكان
    Email    string    // مُصدّر - يمكن الوصول إليه من أي مكان
    password string    // غير مُصدّر - داخل الحزمة فقط
}

تحل اتفاقية التسمية هذه محل معدلات الوصول مثل public و private الموجودة في لغات أخرى.

// حرف كبير = مُصدّر (عام)
// حرف صغير = غير مُصدّر (خاص)

func SaveData() {}  // مُصدّر
func loadData() {}  // غير مُصدّر

يعد اتباع هذا العرف أمراً ضرورياً في لغة Go. فعندما تقوم حزم أخرى باستيراد الكود الخاص بك، لن تتمكن من الوصول إلا إلى الأسماء التي تبدأ بحرف كبير.

التحدي

متوسط

قم بتصحيح جميع الأسماء في product.go لتتبع اصطلاح التسمية المُصدَّرة (exported) في Go. اجعل الحرف الأول حرفاً كبيراً لكل من:

اسم الـ struct: product ← Product
جميع أسماء الحقول: name، price، stock
جميع أسماء الدوال: totalValue، displayInfo
جميع مراجع الحقول داخل الدوال

ورقة مرجعية

في لغة Go، يحدد الحرف الأول من الاسم مدى ظهوره (visibility):

حرف كبير = مُصدّر (يمكن الوصول إليه من حزم أخرى)
حرف صغير = غير مُصدّر (خاص بالحزمة)

الأسماء المُصدّرة (Exported names):

type User struct {
    Name  string  // حقل مُصدّر
    Email string  // حقل مُصدّر
}

func CreateUser(name string) User { // دالة مُصدّرة
    return User{Name: name}
}

الأسماء غير المُصدّرة (Unexported names):

type secret struct {     // هيكل غير مُصدّر
    password string      // حقل غير مُصدّر
}

func validate() bool {   // دالة غير مُصدّرة
    return true
}

رؤية مختلطة (Mixed visibility):

type Account struct {
    Username string    // مُصدّر - يمكن الوصول إليه من أي مكان
    Email    string    // مُصدّر - يمكن الوصول إليه من أي مكان
    password string    // غير مُصدّر - داخل الحزمة فقط
}

تحل اتفاقية التسمية هذه محل معدلات الوصول (access modifiers) مثل public و private الموجودة في لغات أخرى.

جرّب بنفسك

package main

import "fmt"

func main() {
    var name string
    var price float64
    var stock int
    fmt.Scan(&name, &price, &stock)

    p := Product{
        Name:  name,
        Price: price,
        Stock: stock,
    }

    fmt.Println(DisplayInfo(p))
    fmt.Printf("Total Value: %.2f\n", TotalValue(p))
}