التابع IO.gets
في روبي
< Ruby | IO
اذهب إلى التنقل
اذهب إلى البحث
مراجعة 14:10، 13 نوفمبر 2018 بواسطة محمد-بغات (نقاش | مساهمات) (أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>IO.gets</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method [[تصنيف: Ruby IO]...')
يقرأ التابع 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
فاصل
getline_args
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
.