عرض مصدر Ruby/Array/each

<noinclude>{{DISPLAYTITLE: التابع <code>Array.each</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Array]]
يستدعي التابع <code>each</code> كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة، إذ تمرَّر قيمة ذلك العنصر كوسيط إلى الكتلة ثمَّ يعيد المصفوفة نفسها المعطاة.

إن لم تمرَّر أيَّة كتلة إلى التابع <code>each</code>، فسيُعيد كائنا من النوع <code>[[Ruby/Array/Enumerator|Enumerator]]</code>.
==البنية العامة==
<syntaxhighlight lang="ruby"> each { |item| block } → ary
each → Enumerator
 </syntaxhighlight>
==القيم المعادة==
تعاد المصفوفة نفسها المعطاة بعد تطبيق الكتلة <code>block</code> على قيمة كل عنصر من عناصرها، أو يعاد كائنٌ من النوع [[Ruby/Array/Enumerator|Enumerator]]<nowiki/>إن لم تعطَ الكتلة <code>block</code>.
==أمثلة==
مثالٌ على استخدام التابع <code>each</code>:
<syntaxhighlight lang="ruby"> a = [ "a", "b", "c" ]
a.each {|x| print x, " -- " }
سيعطي هذا المثال عند تنفيذه الناتج التالي:
a -- b -- c --
 </syntaxhighlight>
==انظر أيضًا==
* التابع [[Ruby/Array/reverse_each | <code>reverse_each</code>]]: يشبه التابع <code>each</code> تمامًا باستثناء أنه يطبق الكتلة البرمجية على العناصر بدءًا من العنصر الأخير وحتى العنصر الأول.
* التابع [[Ruby/Array/each_index | <code>each_index</code>]]: يستدعي كتلة برمجية محددة مع فهرس كل عنصر من عناصر مصفوفة، إذ يُمرَّر ذلك الفهرس كوسيط إلى الكتلة ثم يعيد المصفوفة نفسها.
* التابع [[Ruby/Array/cycle | <code>cycle</code>]]: يستدعي كتلة برمجية محددة مع كل عنصر من عناصر المصفوفة عددًا محددًا من المرات أو عددًا لا نهائيًّا من المرات إن أعطيت القيمة <code>nil</code>.
* التابع [[Ruby/Array/collect! | <code>collect</code>]]!‎: يستدعي كتلة برمجية محددة مع كل عنصر من عناصر مصفوفة ثم يضع القيمة التي أعادتها تلك الكتلة مكان العنصر الذي استدعيت معه.
==مصادر==
* [https://ruby-doc.org/core-2.5.1/Array.html#method-i-each قسم التابع each في الصنف Array في توثيق روبي الرسمي.]