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

يُعيد التابع eof?‎ القيمة true إن كان مجرى د/خ ios في نهاية الملف، ما يعني أنه لا لم تعد هناك بيانات أخرى للقراءة. يجب أن يكون المجرى مفتوحًا في وضعية القراءة أو سيُرفع استثناء IOError.

إن كان مجرى د/خ ios عبارة عن مجرى كأنبوب (pipe) أو منفذ (socket)، فسيتعطل IO#eof? إلى أن يرسل الطرف الآخر بعض البيانات أو يغلقه.

لاحظ أن التابع IO#eof? يقرأ البيانات إلى المخزن المؤقت للإدخال (input byte buffer). قد لا يتصرف التابع IO#sysread كما كنت تنوي مع IO#eof?، إلا إن استدعيت IO#rewind أولاً (لكنه غير متوفر في بعض المجاري).

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

eof? → true or false‎

أمثلة

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

f = File.new("testfile")
dummy = f.readlines
f.eof   #=> true‎

انظر أيضا

• التابع eof: يُعيد القيمة true إن كان مجرى د/خ ios في نهاية الملف، ما يعني أنه لا توجد بيانات أخرى للقراءة. يجب أن يكون المجرى مفتوحًا في وضعية القراءة أو سيُرفع استثناء IOError.
• التابع external_encoding: يُعيد الترميز Encoding الذي يمثل ترميز الملف. إن كان مجرى د/خ io في وضع الكتابة ولم يُحدّد أي ترميز، فستعاد nil.

مصادر

• قسم التابع eof?‎ في الصنف IO‎ في توثيق روبي الرسمي.