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

يستدعي التابع each_char الكتلة المعطاة على كل محرف في المجرى الذي استدعي معه.

يجب أن يكون المجرى مفتوحًا في وضعية القراءة، وإلا سيُطلق الاستثناء IOError.

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

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

each_char {|c| block }  → ios
each_char→ an_enumerator‎

يعاد المجرى المعطى بعد تنفيذ الكتلة block على كل محرف من محارفه، أو يعاد كائن من الصنف Enumerator في حال لم تُعطَ أية كتلة.

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

f = File.new("testfile")
f.each_char {|c| print c, ' ' }   #=> #<File:testfile>‎

التابع each: ينفذ الكتلة المعطاة على كل سطر في المجرى الذي استُدعي معه.
التابع each_byte: يستدعي الكتلة المعطاة على كل بايت (0..255) في المجرى الذي استدعي معه.
التابع each_codepoint: يمرر كل عدد من الأعداد الترتيبية (Integer ordinal) لكل محرف من المحارف الموجودة في المجرى الذي استدعي معه إلى الكتلة المعطاة.
التابع each_line: ينفذ الكتلة المعطاة على كل سطر في المجرى الذي استدعي معه.