عرض مصدر Ruby/Proc/yield

{{DISPLAYTITLE:التابع <code>Proc.yield</code> في روبي}}
يستدعي التابع <code>yield</code> الكتلة المرتبطة بالمتغير الذي استعمل معه مُعيِّنًا معاملات الكتلة إلى القيم المعطاة ضمنه باستخدام شيءٍ مشابهٍ لدلالات استدعاء التابع. يُعيد المعامل قيمة آخر تعبيرٍ قُيِّم في الكتلة.<syntaxhighlight lang="ruby">
a_proc = Proc.new {|scalar, *values| values.map {|value| value*scalar } }
a_proc.call(9, 1, 2, 3)    #=> [9, 18, 27]
a_proc[9, 1, 2, 3]         #=> [9, 18, 27]
a_proc.(9, 1, 2, 3)        #=> [9, 18, 27]
a_proc.yield(9, 1, 2, 3)   #=> [9, 18, 27]

</syntaxhighlight>لاحظ أنَّ <code>().prc</code> يستدعي <code>()prc.call</code> مع المعاملات المُمرَّرة إليه نفسها. يُعدُّ هذا تجميلًا لغويًّا (syntactic sugar) لإخفاء <code>"call"</code> فقط.

من أجل الكتل <code>procs</code> المُنشأة باستخدام <code>lambda</code> أو <code>()<-</code>، يُرمى خطأٌ إذا مُرِّر عدد خطأ من المعاملات إلى الكتلة. وأمَّا من أجل الكتل <code>procs</code> المُنشأة باستخدام <code>[[Ruby/Proc/new|Proc.new]]</code> أو [[Ruby/Kernel/proc|<code>Kernel.proc</code>]]، يتم تجاهل المعاملات الزائدة الممرَّرة ضمنيًّا وتُعيَّن القيمة <code>nil</code> لكل معامل منها.<syntaxhighlight lang="ruby">
a_proc = proc {|a,b| [a,b] }
a_proc.call(1)   #=> [1, nil]

a_proc = lambda {|a,b| [a,b] }
a_proc.call(1)   # ArgumentError: wrong number of arguments (given 1, expected 2)

</syntaxhighlight>

== البنية العامة ==
<syntaxhighlight lang="ruby">
prc[params,...] → obj
</syntaxhighlight>

== المعاملات ==

=== <code>params</code> ===
القيم التي ستُعيَّن إلى المعاملات ضمن الكتلة.

== القيم المعادة ==
يُعاد الكائن الناتج عن استدعاء الكتلة وتنفيذها مع تمرير المعامل <code>params</code> إليها.

== انظر أيضًا ==
*التابع [[Ruby/Proc/hash|<code>hash</code>]]: يحسب قيمة التجزئة الموافقة لجسم الكتلة <code>proc</code> التي استدعيت معه ثمَّ يعيدها.
*التابع [[Ruby/Proc/lambda-3F|<code>?lambda</code>]]: يتحقَّق إذا كانت معالجة الوسائط صارمةً في الكائن <code>Proc</code>.

*التابع <code>[[Ruby/Proc/to proc|to_proc]]</code>: يُعدُّ جزءًا من البروتوكول المستخدم في تحويل الكائنات إلى كائناتٍ من الصنف <code>Proc</code>.

* المعامل <code>[[Ruby/Proc/3D-3D-3D|===]]</code>: يستدعي الكتلة بتمرير الكائن الواقع على يمينه كمعاملٍ للنسخة <code>proc</code>.

== مصادر ==
* [http://ruby-doc.org/core-2.5.1/Proc.html#method-i-yield صفحة التابع yield في الصنف Proc في توثيق روبي الرسمي.]
[[تصنيف:Ruby]]
[[تصنيف:Ruby Method]]
[[تصنيف:Ruby Proc]]