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

يقرأ التابع to_a الملف الحالي في المجرى ARGF بشكل كامل ثم يضع محتوياته في مصفوفة.

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

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

المعاملات

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

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

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

أمثلة

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

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

انظر أيضًا

• التابع read: يقرأ عددًا محددًا من البايتات من المجرى ARGF.
• التابع readlines: يقرأ الملف الحالي في المجرى ARGF بشكل كامل.
• التابع gets: يجلب السطر التالي من الملف الحالي في المجرى ARGF.
• التابع write: يكتب السلسلة النصية الممرَّرة إليها على المجرى ARGF في حال كان الوضع inplace مفعَّلًا.

مصادر

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