كيف يعمل yield في الدوال؟

Question

Accepted Answer

**`yield`** يستدعي **البلوك (block)** الذي تم تمريره إلى دالة — فهو ينقل التحكم إلى البلوك، مع تمرير القيم إليه بشكل اختياري، ثم يستأنف الدالة. وهي الطريقة التي تستدعي بها الدوال البلوكات المعطاة لها، وآلية التكرار في Ruby والعديد من الأنماط الأنيقة.

## استدعاء yield الأساسي — استدعاء البلوك المعطى

```ruby
def greet
  puts "before"
  yield                    # calls the block passed to greet
  puts "after"
end

greet { puts "hello" }
# Output: before / hello / after
```

عندما تستدعي دالة `yield`، فإنها تشغل البلوك الذي تم تمريره إليها (في `{ }` أو `do...end`). الدالة تتحكم في *متى* (وكم مرة) يعمل البلوك.

## yield مع المعاملات — تمرير القيم إلى البلوك

```ruby
def each_pair
  yield("a", 1)          # pass values to the block's parameters
  yield("b", 2)
end

each_pair { |key, value| puts "#{key}: #{value}" }
# Output: a: 1 / b: 2
```

`yield(args)` يمرر القيم إلى معاملات البلوك (`|key, value|`) — وهي كيفية إعطاء طرق التكرار كل عنصر للبلوك.

## تطبيق التكرار باستخدام yield

```ruby
def my_each(array)
  i = 0
  while i < array.length
    yield(array[i])        # yield each element to the block
    i += 1
  end
end

my_each([1, 2, 3]) { |n| puts n * 2 }   # 2, 4, 6
# this is essentially how Array#each works internally!
```

هذا يوضح كيف تعمل طرق التكرار في Ruby (`each` و`map` وغيرها) بشكل داخلي — فهي `yield` كل عنصر للبلوك.

## block_given؟ والتقاط البلوك

```ruby
def maybe_yield
  if block_given?          # check whether a block was passed (avoid an error)
    yield
  else
    "no block"
  end
end

# explicitly capture the block as a parameter (with &)
def run(&block)            # &block captures the block as a Proc object
  block.call               # call it explicitly
end
```

`block_given?` يفحص ما إذا تم تمرير بلوك (تجنب `LocalJumpError`)، و`&block` يلتقط البلوك كـ Proc object يمكنك تخزينه أو تمريره.

## لماذا يهم

فهم `yield` معرفة Ruby مهمة — فهي الآلية وراء كيفية استدعاء الدوال للبلوكات، مما يدعم التكرار المميز لـ Ruby والعديد من الأنماط الأنيقة، لذا فإن فهمه يوضح كيفية عمل الكثير من Ruby. `yield` يستدعي البلوك الذي تم تمريره إلى دالة (نقل التحكم إليه، تمرير القيم بشكل اختياري)، وهو بالضبط كيفية عمل طرق التكرار في Ruby (`each` و`map` و`select`) بشكل داخلي — فهي `yield` كل عنصر للبلوك.

فهم هذا يوضح آلية التكرار القائم على البلوك في Ruby ويتيح لك **كتابة دوالك الخاصة التي تقبل البلوكات** — قدرة قوية لإنشاء واجهات برمجية معبرة، محررات مخصصة، طرق لإدارة الموارد (الإعداد والتنظيف حول بلوك)، و DSLs.

معرفة `yield` (استدعاء البلوك، تمرير المعاملات إليه)، `block_given?` (فحص آمن لما إذا تم تمرير بلوك، تجنب الأخطاء)، و`&block` (التقاط البلوك صراحة كـ Proc) مهمة لفهم كيفية عمل طرق التكرار وقبول البلوك في Ruby وكتابة دوالك الخاصة القائمة على البلوك.

بما أن البلوكات أساسية لـ Ruby و`yield` هي كيفية استخدام الدوال لها، فإن فهم `yield` يعمق فهمك للميزة الأكثر تمييزاً في Ruby (البلوكات) ويمكّنك من كتابة نوع الدوال الأنيقة التي تقبل البلوكات والتي تجعل Ruby معبرة — مهارة قيمة لبناء واجهات برمجية نظيفة وموضوع مقابلة شائع يعكس فهم كيفية عمل آلية البلوك في Ruby تحت الغطاء.