التابع IO.readlines في روبي
يقرأ التابع readlines كل الأسطر الموجودة في مجرى د/خ، ثم يعيدها في مصفوفة. يتم فصل الأسطر بالوسيط الاختياري sep (انظر فقرة البنية العامة).
إن كان الوسيط sep يساوي nil، فسسيُعاد بقية المجرى كتسجيلة (record) واحدة. وإن كان الوسيط الأول عددًا صحيحًا، أو إن أُعطي الوسيط الاختياري الثاني، فلن تكون السلسلة النصية المعادة أطول من القيمة المحددة من حيث عدد البايتات.
يجب أن يكون المجرى مفتوحًا في وضعية القراءة أو سيُطلق استثناء IOError.
راجع صفحة readlines لمزيد من التفاصيل حول getline_args.
البنية العامة
readlines(sep=$/ [, getline_args]) → array
readlines(limit [, getline_args])→ array
readlines(sep, limit [, getline_args]) → array
المعاملات
sep
فاصل
limit
عدد صحيح
القيمة المُعادة
يعيد التابع readlines كل الأسطر الموجودة في مجرى د/خ على شكل مصفوفة.
أمثلة
مثال على استخدام التابع 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"
انظر أيضا
- التابع
readline: يقرأ سطرًا كما يفعل التابعIO#gets، إلا أنه يُطلق الاستثناءEOFErrorعند نهاية الملف. - التابع
readpartial: يقرأmaxlenبايتًا على الأكثر من مجرى د/خ.