التابع IO.each في روبي
ينفذ التابع each الكتلة المعطاة على كل سطر في المجرى الذي استُدعي معه.
يجب أن يكون المجرى مفتوحًا في وضعية القراءة، وإلا سيُطلق الاستثناء IOError.
في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator بدلًا من ذلك.
البنية العامة
each(sep=$/ [, getline_args]) {|line| block } → ios
each(limit [, getline_args]) {|line| block } → ios
each(sep, limit [, getline_args]){|line| block } → ios
each(...) → an_enumerator
each_line(sep=$/ [, getline_args]) {|line| block } → ios
each_line(limit [, getline_args]){|line| block } → ios
each_line(sep, limit [, getline_args]) {|line| block } → ios
each_line(...)→ an_enumerator
المعاملات
sep
الفاصل الذي يفصل بين الأسطر. القيمة الافتراضية هي: /$.
limit
عدد صحيح يمثل الحد الأٌقصى للأسطر التي ستُطبَّق عليها العملية.
getline_args
راجع صفحة readlines لمزيد من التفاصيل حول هذا المعامل.
القيمة المعادة
يعاد المجرى المعطى، أو يعاد كائن من الصنف Enumerator في حال لم تُعطَ أية كتلة.
أمثلة
مثال على استخدام التابع each:
f = File.new("testfile")
f.each {|line| puts "#{f.lineno}: #{line}" }
يعيد الناتج التالي:
1: This is line one
2: This is line two
3: This is line three
4: And so on...
انظر أيضًا
- التابع
each_codepoint: يمرر كل عدد من الأعداد الترتيبية (Integer ordinal) لكل محرف من المحارف الموجودة في المجرى الذي استدعي معه إلى الكتلة المعطاة. - التابع
each_line: ينفذ الكتلة المعطاة على كل سطر في المجرى الذي استدعي معه.