عرض مصدر Ruby/IO/foreach

<noinclude>{{DISPLAYTITLE: التابع <code>IO.foreach‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby IO]]
ينفذ التابع <code>foreach</code> الكتلة المعطاة على كل سطر في منفذ [[Ruby/IO|مجرى د/خ]] المسمى. إن كان آخر معامل مُمرَّر إلى التابع هو [[Ruby/Hash|جدول Hash]]، فسيتم فتح الوسيط المسمى (keyword argument). 

في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف <code>[[Ruby/Enumerator|Enumerator]]</code> بدلًا من ذلك.
==البنية العامة==
<syntaxhighlight lang="ruby">foreach(name, sep=$/ [, getline_args, open_args]) {|line| block }  → nil
foreach(name, limit [, getline_args, open_args]) {|line| block }→ nil
foreach(name, sep, limit [, getline_args, open_args]) {|line| block } → nil
foreach(...)  → an_enumerator‎</syntaxhighlight>
==المعاملات==
===<code>name‎</code>===
اسم الملف المراد تطبيق العملية عليه.
===<code>sep‎</code>===
الفاصل الذي يفصل بين الأسطر. القيمة الافتراضية هي: <code>/$</code>.

===<code>getline_args‎</code>===
مصفوفة تحوي أسطر الملف. راجع صفحة <code>[[Ruby/IO/readlines|readlines]]</code> لمزيد من التفاصيل حول المعامل <code>getline_args</code>.

===<code>open_args‎</code>===
[[Ruby/Array|مصفوفة]] أو [[Ruby/Hash|جدول Hash]] يوفر خيارات الفتح. اطلع على صفحة التابع <code>[[Ruby/IO/read|read]]</code> لمزيد من التفاصيل حول المعامل <code>open_args</code>.
===<code>limit‎</code>===
الحد الأقصى للأسطر.

==القيمة المعادة==
تعاد القيمة <code>nil</code> بعد تنفيذ العملية.

==أمثلة==
مثال على استخدام التابع <code>foreach‎</code>:
<syntaxhighlight lang="ruby">IO.foreach("testfile") {|x| print "GOT ", x }‎</syntaxhighlight>الناتج:<syntaxhighlight lang="text">GOT This is line one
GOT This is line two
GOT This is line three
GOT And so on...‎</syntaxhighlight>
==انظر أيضًا==
* التابع <nowiki/>[[Ruby/IO/readlines|<code></code>]]<code>[[Ruby/IO/for_fd|readlines]]</code>: يقرأ أسطر الملف المعطى.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/IO.html#method-c-foreach قسم التابع foreach‎ في الصنف IO‎ في توثيق روبي الرسمي.]