التابع ARGF.gets في روبي
يجلب التابع gets السطر التالي من الملف الحالي في المجرى ARGF.
البنية العامة
gets(sep=$/ [, getline_args]) → string or nil
gets(limit [, getline_args]) → string or nil
gets(sep, limit [, getline_args]) → string or nil
يُفتَرض أنَّ الفاصل المستعمل لفصل الأسطر عن بعضها هو المحرف $/. يمكن تغيير هذا الفاصل إلى محرف آخر عبر تمريره كسلسلة نصية إلى الوسيط sep.
وظيفة الوسيط limit الاختياري هي تحديد عدد المحارف المراد جلبها من كل سطر. تعاد افتراضيًّا كل المحارف الموجودة في السطر.
للمزيد من التفاصيل حول الوسيط getline_args، ارجع إلى الصفحة IO.readlines.
القيم المعادة
تعاد سلسلة نصية تحوي جميع محارف السطر التالي أو المحارف limit فقط من الملف الحالي في المجرى ARGF، أو تعاد القيمة nil عند الوصول إلى نهاية المجرى.
انظر أيضًا
- التابع
getbyte: يجلب بايتًا واحدًا (8 بتّات) من المجرىARGF. - التابع
getc: يجلب المحرف التالي من المجرىARGF. - التابع
puts: يكتب الكائن أو الكائنات المُمرَّرة إليه على المجرىiosثمَّ يضيف سطرًا جديدًا في النهاية إن لم تحتوِ تلك الكائنات المعطاة على محرف سطرٍ جديدٍ. - التابع
readline: يقرأ السطر التالي من الملف الحالي في المجرىARGF.