التابع 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.

مصادر

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