التابع IO.gets‎ في روبي

يقرأ التابع gets "السطر" الموالي من مجرى د/خ. السطور مفصولة بواسطة sep. إن كان الفاصل يساوي nil، فسيقرأ المحتويات بالكامل، أما إن كان الفاصل معدوم الطول، فستُقرؤ فقرة في كل مرة من مجرى الإدخال (تُفصل الفقرات بسطرين منفصلين). يجب أن يكون المجرى مفتوحًا في وضعية القراءة أو سيُرفع استثناء IOError. سيُعاد السطر المقروء، وستُعين قيمته إلى $_. ستعاد القيمة nil إن تم استُدعي التابع gets عند نهاية الملف. إن كان الوسيط الأول عددًا صحيحًا أو إن أعطي الوسيط الاختياري الثاني، فلن تكون السلسلة النصية المعادة أطول من القيمة المحددة من حيث عدد البايتات (bytes).

إن كان مجرى د/خ IO يحتوي على حروف متعددة البايتات، فستعيد gets(1) الحرف بالكامل:

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

gets(sep=$/ [, getline_args])  → string or nil
gets(limit [, getline_args])→ string or nil
gets(sep, limit [, getline_args]) → string or nil‎

المعاملات

sep‎

فاصل

limit‎

عدد صحيح يمثل الحد الأٌقصى

أمثلة

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

File.new("testfile").gets   #=> "This is line one\n"
$_                          #=> "This is line one\n"
File.new("testfile").gets(4)#=> "This"‎

انظر أيضا

• التابع getc: يقرأ سلسلة نصية مُؤلفة من حرف واحد من مجرى د/خ ios. ويُعيد nil إن استُدعي عند نهاية الملف.
• التابع inspect: يُعيد سلسلة نصية تصف مجرى د/خ الذي استُدعي معه IO.

مصادر

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