التابع readlines‎ الخاص بالصنف IO في روبي

يقرأ التابع readlines كامل الملف المحدد بواسطة name (انظر فقرة البنية العامة) سطرًا سطرًا، ويعيد تلك السطور في مصفوفة. تُفصل السطو بواسطة sep.

إن كان الوسيط الأخير عبارة عن قاموس، فسيتم فتح الوسيط المسمى (keyword argument).

خيارات getline ¶ ↑

يقبل قاموس الخيارات المفاتيح التالية:

‎:chomp

عندما يُعطى للوسيط المسمى الاختياري chomp قيمة صحيحة، ستتم إزالة \n و \r و \r\n من نهاية كل سطر.

وانظر أيضا صفحة ::read لمزيد من التفاصيل حول open_args.

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

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‎

فاصل

open_args‎

مصفوفة توفر خيارات الفتح

أمثلة

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

a = IO.readlines("testfile")
a[0]   #=> "This is line one\n"
b = IO.readlines("testfile", chomp: true)
b[0]   #=> "This is line one"‎

انظر أيضا

• التابع read: يفتح التابع read الملف، ثم يتموضع اختياريا في الموضع المعطى offset (انظر فقرة البنية العامة)، ثم يُعيد length بايت (تساوي قيمته الافتراضية طول بقية الملف). يضمن التابع read أن يُغلق الملف قبل العودة.
• التابع select: يستدعي التابع select select(2)‎. ويقوم بمراقبة المصفوفة المعطاة المكونة من مجرى د/خ (كائنات IO)، وينتظر حتى يكون أحد كائنات IO جاهزًا للقراءة، وجاهزا للكتابة، ويكون لها استثناءات معلقة (pending exceptions) على التوالي، ثم يعيد مصفوفة تحتوي على مصفوفات مكونة من مجرى د/خ تلك كائنات IO السابقة. ستعاد القيمة nil إذا تم إعطاء قيمة للوسيط الاختياري timeout (انظر فقرة البنية العامة)، ولم يكن أي من مجريات د/خ كائن IO جاهزاً خلال timeout ثانية.

مصادر

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