ما الفرق بين value receiver و pointer receiver؟

Question

Accepted Answer

**receiver** هو القيمة التي تعمل عليها method، وتُعلن قبل اسم الmethod. يمكن أن تكون **value receiver** (تعمل على نسخة) أو **pointer receiver** (تعمل على الأصلية، وتستطيع تعديلها). اختيار الطريقة الصحيحة يهم سواء من حيث الصحة (التعديل) أو الأداء.

## Value receiver — تعمل على نسخة

```go
type Counter struct { count int }

func (c Counter) Increment() {     // VALUE receiver — c is a COPY
    c.count++                       // modifies the copy, NOT the original
}

c := Counter{}
c.Increment()
fmt.Println(c.count)   // 0 — the original is UNCHANGED (the copy was modified)
```

value receiver تحصل على نسخة من struct، لذا التعديلات لا تؤثر على النسخة الأصلية — مفيد للـ read-only methods، لكنها خطأ إذا كنت تقصد تعديل البيانات.

## Pointer receiver — تعمل على الأصلية

```go
func (c *Counter) Increment() {    // POINTER receiver — c points to the original
    c.count++                       // modifies the ACTUAL struct
}

c := Counter{}
c.Increment()          // Go automatically takes &c
fmt.Println(c.count)   // 1 — the original WAS modified
```

pointer receiver تعمل على struct الفعلي، لذا يمكنها **تعديله**. Go يأخذ العنوان تلقائياً (`c.Increment()` يعمل حتى على قيمة).

## متى تستخدم أي منهما

```text
Use a POINTER receiver when:
  ✓ The method needs to MODIFY the receiver (mutation)
  ✓ The struct is LARGE (avoid copying it on every call — performance)
  ✓ For CONSISTENCY (see below)

Use a VALUE receiver when:
  ✓ The method only READS, the type is small, and you want copy semantics
  ✓ The type is naturally a value (small structs, basic types)
```

## قاعدة الاتساق

```go
// ✅ be consistent — if ANY method needs a pointer receiver, use pointer for ALL
func (c *Counter) Increment() { c.count++ }
func (c *Counter) Value() int { return c.count }   // pointer too, for consistency
```

مزج value و pointer receivers على نفس النوع يسبب مشاكل دقيقة — العرف هو اختيار واحد (عادة pointer إذا كانت أي method تعدّل) واستخدامه لجميع methods.

## دقة تحقق Interface

```go
type Incrementer interface { Increment() }

// if Increment has a POINTER receiver, only *Counter satisfies the interface, not Counter
var i Incrementer = &Counter{}   // ✅ works
var j Incrementer = Counter{}    // ❌ Counter (value) does NOT satisfy it
```

هذا gotcha شهير: مع pointer-receiver methods، فقط نوع المؤشر يحقق الـ interface.

## لماذا يهم

قرار اختيار value-vs-pointer receiver هو قرار أساسي وغالباً ما يساء فهمه في Go يؤثر على الصحة والأداء وتحقق interface.

أكثر الأخطاء شيوعاً هو استخدام **value receiver عندما كنت تقصد تعديل البيانات** — التعديل يؤثر بصمت على نسخة فقط، لذا التغيير "لا يبقى". pointer receivers مطلوبة للتعديل وموصى بها للـ large structs (لتجنب نسخ مكلفة في كل استدعاء).

**قاعدة الاتساق** (استخدم نفس نوع receiver عبر جميع methods النوع) تتجنب الارتباك، و**دقة تحقق interface** (pointer-receiver methods تعني أن فقط نوع المؤشر يحقق الـ interface) هي gotcha كلاسيكية تسبب أخطاء "does not implement interface".

فهم هذه النقاط أساسي لكتابة Go صحيح وفعال وهو من بين أكثر المواضيع شيوعاً وعملية في المقابلات، لأن الاختيار له عواقب غير واضحة.