التابع gets‎ الخاص بالصنف Kernel في روبي

يعيد التابع (ويُحيل على $_) السطر الموالي من قائمة الملفات في ARGV (أو $*)، أو من مجرى الإدخال القياسي في حالة عدم تمرير أي ملفات في سطر الأوامر. ويعيد nil في نهاية الملف. يحدد الوسيط الاختياري فاصل السجل. يتم تضمين الفاصل مع محتويات كل سجل. قي حال كان الوسيط sep يساوي nil فسيقرأ التابع gets كامل المحتوى، أما إذا كان الفاصل معدوم الطول (zero-length) فسيقرأ فقرة واحدة في كل مرة من المدخلات، بحيث تكون الفقرات مقسمة بواسطة سطرين جديدين متتاليين . إذا كان الوسيط الأول عددًا صحيحًا أو في حالإعطاء الوسيط الثاني الاختياري، فإنّ السلسلة النصية المعادة لن تكون أطول من القيمة المحددة من حيث عدد البتات (bytes). في حال تمرير عدة أسماء ملفات إلى ARGV ، فسيقرأ gets(nil) محتويات الملفات، واحدًا في كل مرة.

الناتج:

This is line one
This is line two
This is line three
And so on...‎

أسلوب البرمجة الذي يستخدم $_ كوسيط ضمني صار أقل شيوعًا في مجتمع روبي.

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

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

أمثلة

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

ARGV << "testfile"
print while gets
‎

انظر أيضا

• التابع format: يعيد التابع السلسلة النصية الناتجة من تطبيق format_string على أي وسائط إضافية. داخل السلسلة النصية format_string، ستُنسخ كل الأحرف في النتيجة باستثناء تسلسلات التنسيق (format sequences).
• التابع global_variables: يعيد التابع global_variables مصفوفة تضم أسماء المتغيرات الكلية (global variables).

مصادر

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