التابع IO.foreach‎ في روبي

من موسوعة حسوب
< Ruby‏ | IO
اذهب إلى: تصفح، ابحث

ينفذ التابع foreach الكتلة المعطاة على كل سطر في منفذ مجرى د/خ المسمى. إن كان آخر معامل مُمرَّر إلى التابع هو جدول Hash، فسيتم فتح الوسيط المسمى (keyword argument).

في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator بدلًا من ذلك.

البنية العامة

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

المعاملات

name‎

اسم الملف المراد تطبيق العملية عليه.

sep‎

الفاصل الذي يفصل بين الأسطر. القيمة الافتراضية هي: /$.

getline_args‎

مصفوفة تحوي أسطر الملف. راجع صفحة readlines لمزيد من التفاصيل حول المعامل getline_args.

open_args‎

مصفوفة أو جدول Hash يوفر خيارات الفتح. اطلع على صفحة التابع read لمزيد من التفاصيل حول المعامل open_args.

limit‎

الحد الأقصى للأسطر.

القيمة المعادة

تعاد القيمة nil بعد تنفيذ العملية.

أمثلة

مثال على استخدام التابع foreach‎:

IO.foreach("testfile") {|x| print "GOT ", x }
الناتج:
GOT This is line one
GOT This is line two
GOT This is line three
GOT And so on...‎

انظر أيضًا

  • التابع readlines: يقرأ أسطر الملف المعطى.

مصادر