التابع ARGF.readline في روبي

يقرأ التابع readline السطر التالي من الملف الحالي في المجرى ARGF. يُفترَض أنَّ الفاصل المستعمل لفصل الأسطر هو المحرف /$؛ لاستخدام فاصل سطري مغاير، يمكن تمرير المحرف المراد استعماله كفاصل إلى التابع readline. يُطلَق الخطأ EOFError عند الوصول إلى نهاية الملف.

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

 readline(sep=$/) → string
readline(limit) → string
readline(sep, limit) → string


الوسائط
sep
المحرف المستعمل كفاصل سطري. القيمة الافتراضية هي: /$.
limit
عددٌ يحدد الأحرف المراد قراءتها من كل سطر. افتراضيًا، ستُقرَأ كل المحارف الموجودة في السطر.

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

تعاد سلسلة نصية تحوي البيانات التي قُرِأت من الملف الحالي في المجرى ARGF.

انظر أيضًا

• التابع read: يقرأ عددًا محددًا من البايتات من المجرى ARGF.
• التابع readbyte: يقرأ البايت التالي من المجرى ARGF ثمَّ يعيده على شكل عدد صحيح (Integer).
• التابع read_nonblock: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديَّةً عليا من المجرى ARGF في وضع عدم الحجز (non-blocking mode).
• التابع readchar: يقرأ المحرف التالي من المجرى ARGF ثم يعيده على شكل سلسلة نصية.
• التابع readlines: يقرأ الملف الحالي في المجرى ARGF بشكل كامل.
• التابع readpartial: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديةً عليا من المجرى ARGF.
• التابع puts: يكتب الكائن أو الكائنات المُمرَّرة إليه على المجرى ios ثمَّ يضيف سطرًا جديدًا في النهاية إن لم تحتوِ تلك الكائنات المعطاة على محرف سطرٍ جديدٍ.
• التابع gets: يجلب السطر التالي من الملف الحالي في المجرى ARGF.

مصادر

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