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

يقرأ التابع readlines كل الأسطر الموجودة في المجرى الذي استدعي معه ثم يعيدها في مصفوفة.

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

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

readlines(sep=$/ [, getline_args])  → array
readlines(limit [, getline_args])→ array
readlines(sep, limit [, getline_args]) → array‎

المعاملات

sep‎

محرف يمثِّل الفاصل السطري. القيمة الافتراضية هي: /$. إن كان المعامل sep يساوي nil، فسسيُعاد محتوى المتبقي في المجرى كسجل (record) واحد. وإن إن أعطي المعامل limit أولًا أو إن أعطي مع هذا المعامل أيضًا، فلن تكون السلسلة النصية المعادة أطول من القيمة limit المحددة.

limit‎

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

getline_args

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

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

تعاد مصفوفة تحوي كل الأسطر الموجودة في المجرى المعطى بشكل لا يتجاوز الحد limit (إن أعطي).

أمثلة

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

f = File.new("testfile")
f.readlines[0]   #=> "This is line one\n"
f = File.new("testfile", chomp: true)
f.readlines[0]   #=> "This is line one"‎

انظر أيضًا

• التابع puts: يكتب الكائن(ات) المُمرَّرة إليه في المجرى الذي استُدعي معه، ويضيف سطرًا جديدًا بعد الأسطر التي لا تنتهي بمحرف السطر الجديد ثم يعيد القيمة nil. 

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

مصادر

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