دالة ()new

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

توفر لغة Go دالة مدمجة تسمى new() تقوم بتخصيص ذاكرة لنوع معين وتعيد مؤشراً إليه. يتم تهيئة الذاكرة المخصصة إلى القيمة الصفرية (zero value) الخاصة بهذا النوع.

p := new(int)      // يخصص مساحة في الذاكرة لمتغير من نوع int
fmt.Println(*p)    // 0 (القيمة الصفرية)
fmt.Println(p)     // 0xc000018030 (عنوان الذاكرة)

تأخذ الدالة new() نوعاً كمعامل لها وتعيد مؤشراً إلى قيمة صفرية مخصصة حديثاً من ذلك النوع. هذا مفيد بشكل خاص عندما تحتاج إلى مؤشر ولكن ليس لديك متغير موجود للإشارة إليه.

مع الـ structs، يقوم new() بإنشاء مؤشر (pointer) إلى struct مع تعيين كافة الحقول إلى قيمها الصفرية.

type Person struct {
    Name string
    Age  int
}

p := new(Person)
fmt.Println(p.Name)  // "" (سلسلة نصية فارغة)
fmt.Println(p.Age)   // 0

قد تتساءل متى تستخدم new() مقابل عامل العنوان &. كلا النهجين أدناه متكافئان:

// استخدام ()new
p1 := new(Person)

// استخدام عامل العنوان مع القيمة الحرفية
p2 := &Person{}

تُعد صيغة &Person{} أكثر شيوعاً في الممارسة العملية لأنها تتيح لك تهيئة الحقول في الوقت نفسه. استخدم new() عندما تريد تحديداً نسخة ذات قيمة صفرية (zero-valued instance) وتفضل دلالات تخصيص الذاكرة الصريحة.

التحدي

سهل

لنقم ببناء مدير تكوين (configuration manager) يوضح كيف تقوم new() بتخصيص الذاكرة وتهيئة الهياكل (structs) إلى قيمها الصفرية (zero values). سترى كيف يختلف هذا النهج عن استخدام عامل العنوان (address operator) مع قيمة هيكلية حرفية (struct literal).

ستقوم بتنظيم الكود الخاص بك عبر ملفين:

config.go: قم بتعريف هيكل ServerConfig مع الحقول Host (string)، و Port (int)، و MaxConnections (int)، و DebugMode (bool). قم بإنشاء دالتين:
- NewServerConfig التي تستخدم new() لتخصيص ServerConfig وتعيد المؤشر (pointer) مباشرة (مع جميع القيم الصفرية).
- ConfigureServer التي تأخذ مؤشر *ServerConfig بالإضافة إلى سلسلة نصية للمضيف (host string) وعدد صحيح للمنفذ (port integer)، ثم تقوم بتعيين تلك الحقول في التكوين من خلال المؤشر.
أضف أيضاً تابعاً (method) باسم Display على *ServerConfig يعيد سلسلة نصية منسقة تعرض جميع قيم التكوين.
main.go: اقرأ المضيف والمنفذ من المدخلات. أولاً، قم بإنشاء تكوين باستخدام NewServerConfig() واعرضه لإظهار القيم الصفرية. ثم استخدم ConfigureServer لتعيين المضيف والمنفذ، واعرض التكوين مرة أخرى لإظهار القيم المحدثة.

سيتم توفير المدخلات التالية:

السطر 1: اسم المضيف (string)
السطر 2: رقم المنفذ (integer)

يجب أن يعيد التابع Display سلسلة نصية بهذا التنسيق تماماً:

Host: [Host]
Port: [Port]
MaxConnections: [MaxConnections]
DebugMode: [DebugMode]

اطبع مخرجات العرض مرتين—مرة قبل التكوين (تظهر القيم الصفرية) ومرة بعد التكوين (تظهر المضيف والمنفذ المحدثين).

على سبيل المثال، إذا كانت المدخلات localhost و 8080، يجب أن تكون مخرجاتك:

Host: 
Port: 0
MaxConnections: 0
DebugMode: false
Host: localhost
Port: 8080
MaxConnections: 0
DebugMode: false

لاحظ كيف يظهر العرض الأول جميع القيم الصفرية (سلسلة فارغة، 0، 0، false) لأن new() تهيئ كل شيء إلى القيم الصفرية. بعد استدعاء ConfigureServer، يتغير المضيف والمنفذ فقط بينما تظل الحقول الأخرى عند قيمها الصفرية.

ورقة مرجعية

تقوم الدالة new() بتخصيص ذاكرة لنوع معين وإرجاع مؤشر (pointer) إليه، مهيأً بالقيمة الصفرية (zero value) لهذا النوع:

p := new(int)      // يخصص ذاكرة لـ int
fmt.Println(*p)    // 0 (القيمة الصفرية)
fmt.Println(p)     // 0xc000018030 (عنوان الذاكرة)

مع الـ structs، تقوم new() بإنشاء مؤشر لـ struct مع تعيين جميع الحقول إلى قيمها الصفرية:

type Person struct {
    Name string
    Age  int
}

p := new(Person)
fmt.Println(p.Name)  // "" (سلسلة نصية فارغة)
fmt.Println(p.Age)   // 0

استخدام new() مقابل عامل العنوان (address operator) & - كلاهما متكافئان:

// استخدام new()
p1 := new(Person)

// استخدام عامل العنوان مع literal
p2 := &Person{}

بناء الجملة &Person{} أكثر شيوعاً لأنه يسمح بتهيئة الحقول في وقت الإنشاء. استخدم new() عندما تريد نسخة ذات قيمة صفرية مع دلالات صريحة لتخصيص الذاكرة.

جرّب بنفسك

package main

import (
	"fmt"
)

func main() {
	// قراءة المدخلات
	var host string
	var port int
	fmt.Scanln(&host)
	fmt.Scanln(&port)

	// TODO: قم بإنشاء إعدادات باستخدام NewServerConfig() وعرضها
	// سيؤدي هذا إلى إظهار القيم الصفرية (zero values)

	// TODO: استخدم ConfigureServer لتعيين host و port

	// TODO: قم بعرض الإعدادات مرة أخرى لإظهار القيم المحدثة
}