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

يقرأ التابع readlines كل الأسطر الموجودة في مجرى د/خ ios، ثم يعيدها في مصفوفة. يتم فصل الأسطر بالوسيط الاختياري 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‎:

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 (انظر فقرة البنية العامة) بايتًا على الأكثر من مجرى د/خ. لا يقوم بالتعطيل إلا في حال لم يكن في مجرى د/خ ios أي بيانات متوفرة آنيًا. لن يقوم بالتعطيل في حالة توفر بعض البيانات.

مصادر

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