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

يقرأ التابع readline سطرًا واحدًا من المجرى الذي استدعي معه. هذا التابع يشبه التابع gets باستثناء أنَّه يُطلق الاستثناء EOFError عند نهاية الملف.

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

readline(sep=$/ [, getline_args])  → string
readline(limit [, getline_args])→ string
readline(sep, limit [, getline_args]) → string‎

المعاملات

sep‎

محرف يمثِّل الفاصل السطري. القيمة الافتراضية هي: /$.

limit‎

عدد صحيح يحدد حجم البيانات الأقصى (بالبايت) المراد قراءتها.

getline_args

راجع صفحة readlines لمزيد من التفاصيل حول هذا المعامل.

القيمة المعادة

تعاد سلسلة نصية تحوي السطر الذي قُرِئ من المجرى المعطى، أو يطلق الاستثناء EOFError عند نهاية الملف.

انظر أيضًا

• التابع pwrite: يكتب السلسلة النصية المُمرَّرة إليه في موضع محدَّد من المجرى الذي استُدعي معه باستخدام استدعاء دالة النظام pwrite()‎.  

• التابع read: يقرأ عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه.
• التابع read_nonblock: يقرأ عددًا محدَّدًا من البايتات من المجرى الذي استُدعي معه باستخدام استدعاء النظام read(2)‎ بعد تعيين الراية O_NONBLOCK لواصف الملف (file descriptor) الأساسي.
• التابع readbyte: يقرأ بايتًا واحدًا من المجرى الذي استدعي معه.
• التابع readchar: يقرأ محرفًا واحدًا من المجرى الذي استدعي معه.
• التابع readlines: يقرأ كل الأسطر الموجودة في المجرى الذي استدعي معه ثم يعيدها في مصفوفة. 
• التابع readpartial: يقرأ عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه.

مصادر

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