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

يقرأ التابع readlines الملف الحالي في المجرى ARGF بشكل كامل.

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

 readlines(sep=$/) → array
readlines(limit) → array
readlines(sep, limit) → array


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

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

تعاد مصفوفة تحوي جميع محتويات الملف الحالي المقروء من المجرى ARGF، إذ يُخزَّن كل سطر في عنصر واحد من عناصرها.

أمثلة

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

 lines = ARGF.readlines
lines[0]                #=> "This is line one\n"

انظر أيضًا

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

مصادر

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