التابع IO.foreach في روبي
ينفذ التابع 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: يقرأ أسطر الملف المعطى.