التابع IO.each_byte
في روبي
يستدعي التابع each_byte
الكتلة المعطاة على كل بايت (0..255) في المجرى الذي استدعي معه.
يجب أن يكون المجرى مفتوحًا في وضعية القراءة، وإلا سيُطلق الاستثناء IOError
.
في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator
بدلًا من ذلك.
البنية العامة
each_byte {|byte| block } → ios
each_byte→ an_enumerator
القيمة المعادة
يعاد المجرى المعطى بعد تنفيذ الكتلة block
على كل بايت من بايتاته، أو يعاد كائن من الصنف Enumerator
في حال لم تُعطَ أية كتلة.
أمثلة
مثال على استخدام التابع each_byte
:
f = File.new("testfile")
checksum = 0
f.each_byte {|x| checksum ^= x } #=> #<File:testfile>
checksum #=> 12
انظر أيضًا
- التابع
each
: ينفذ الكتلة المعطاة على كل سطر في المجرى الذي استُدعي معه. - التابع
each_char
: يستدعي الكتلة المعطاة على كل محرف في المجرى الذي استدعي معه. - التابع
each_codepoint
: يمرر كل عدد من الأعداد الترتيبية (Integer ordinal) لكل محرف من المحارف الموجودة في المجرى الذي استدعي معه إلى الكتلة المعطاة. - التابع
each_line
: ينفذ الكتلة المعطاة على كل سطر في المجرى الذي استدعي معه.