التابع IO.readlines في روبي
يقرأ التابع readlines ملفًا بأكمله سطرًا سطرًا ثم يعيد تلك الأسطر في مصفوفة.
إن كان الوسيط الأخير عبارة عن جدول Hash، فسيمثِّل الوسيط المسمى (keyword argument) المراد فتحه.
البنية العامة
readlines(name, sep=$/ [, getline_args, open_args]) → array
readlines(name, limit [, getline_args, open_args])→ array
readlines(name, sep, limit [, getline_args, open_args]) → array
المعاملات
name
اسم الملف المراد قراءة أسطره ووضعها في مصفوفة.
sep
الفاصل الذي يفصل بين الأسطر. القيمة الافتراضية هي: /$.
getline_args
كائن من النوع Hash يقبل المفتاح الوحيد التالي:
:chomp- عندما يُعطى للوسيط المسمى الاختياريchompقيمة صحيحة (true value)، فستتم إزالة المحارف \nو \rو \r\nمن نهاية كل سطر.
open_args
مصفوفة أو جدول Hash يوفر خيارات الفتح. اطلع على صفحة التابع read لمزيد من التفاصيل حول المعامل open_args.
limit
الحد الأقصى للأسطر المقروءة.
القيمة المعادة
تعاد مصفوفة يحوي كل عنصر من عناصرها سطرًا من أسطر الملف ذي الاسم name.
أمثلة
مثال على استخدام التابع readlines:
a = IO.readlines("testfile")
a[0] #=> "This is line one\n"
b = IO.readlines("testfile", chomp: true)
b[0] #=> "This is line one"
انظر أيضًا
- التابع
foreach: ينفذ الكتلة المعطاة على كل سطر في منفذ مجرى د/خ المسمى.
- التابع
read: يقرأ ملفًا محددًا بعد فتحه ثم يغلقه قبل إعادة الناتج.