الفرق بين المراجعتين لصفحة: «Ruby/ARGF/gets»

مراجعة 16:22، 10 سبتمبر 2018

يجلب التابع 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 في توثيق روبي الرسمي.

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby ARGF]]
-يجلب التابع <code>gets</code> السطر التالي من الملف الحالي في المجرى [[Ruby/ARGF/ARGF | <code>ARGF</code>]].
+يجلب التابع <code>gets</code> السطر التالي من الملف الحالي في المجرى  <code>ARGF</code>.
 ==البنية العامة==
 <syntaxhighlight lang="ruby"> gets(sep=$/ [, getline_args]) → string or nil
 gets(limit [, getline_args]) → string or nil
 gets(sep, limit [, getline_args]) → string or nil
-يُفتَرض أنَّ الفاصل المستعمل لفصل الأسطر عن بعضها هو المحرف ‎$/‎. يمكن تغيير هذا الفاصل إلى محرف آخر عبر تمريره كسلسلة نصية إلى الوسيط sep.
+ </syntaxhighlight>يُفتَرض أنَّ الفاصل المستعمل لفصل الأسطر عن بعضها هو المحرف ‎<code>$/‎</code>. يمكن تغيير هذا الفاصل إلى محرف آخر عبر تمريره كسلسلة نصية إلى الوسيط <code>sep</code>.
-وظيفة الوسيط limit الاختياري هي تحديد عدد المحارف المراد جلبها من كل سطر. تعاد افتراضيًّا كل المحارف الموجودة في السطر.
-للمزيد من التفاصيل حول الوسيط getline_args، ارجع إلى الصفحة IO.readlines.
+وظيفة الوسيط <code>limit</code> الاختياري هي تحديد عدد المحارف المراد جلبها من كل سطر. تعاد افتراضيًّا كل المحارف الموجودة في السطر.
- </syntaxhighlight>
+للمزيد من التفاصيل حول الوسيط <code>getline_args</code>، ارجع إلى الصفحة <code>IO.[[Ruby/IO/readlines|readlines]]</code>.
 ==القيم المعادة==
-تعاد سلسلة نصية تحوي جميع محارف السطر التالي أو المحارف <code>limit</code> فقط من الملف الحالي في المجرى [[Ruby/ARGF/ARGF | <code>ARGF</code>]]، أو تعاد القيمة <code>nil</code> عند الوصول إلى نهاية المجرى.
+تعاد سلسلة نصية تحوي جميع محارف السطر التالي أو المحارف <code>limit</code> فقط من الملف الحالي في المجرى  <code>ARGF</code>، أو تعاد القيمة <code>nil</code> عند الوصول إلى نهاية المجرى.
 ==انظر أيضًا==
-* التابع [[Ruby/ARGF/getbyte | <code>getbyte</code>]]: يجلب بايتًا واحدًا (8 بتّات) من المجرى [[Ruby/ARGF/ARGF | <code>ARGF</code>]].
+* التابع [[Ruby/ARGF/getbyte | <code>getbyte</code>]]: يجلب بايتًا واحدًا (8 بتّات) من المجرى  <code>ARGF</code>.
-* التابع [[Ruby/ARGF/getc | <code>getc</code>]]: يجلب المحرف التالي من المجرى [[Ruby/ARGF/ARGF | <code>ARGF</code>]].
+* التابع [[Ruby/ARGF/getc | <code>getc</code>]]: يجلب المحرف التالي من المجرى  <code>ARGF</code>.
 * التابع [[Ruby/ARGF/puts | <code>puts</code>]]: يكتب الكائن أو الكائنات المُمرَّرة إليه على المجرى <code>ios</code> ثمَّ يضيف سطرًا جديدًا في النهاية إن لم تحتوِ تلك الكائنات المعطاة على محرف سطرٍ جديدٍ.
-* التابع [[Ruby/ARGF/readline | <code>readline</code>]]: يقرأ السطر التالي من الملف الحالي في المجرى [[Ruby/ARGF/ARGF | <code>ARGF</code>]].
+* التابع [[Ruby/ARGF/readline | <code>readline</code>]]: يقرأ السطر التالي من الملف الحالي في المجرى  <code>ARGF</code>.
 ==مصادر==
-* قسم التابع gets في الصنف ARGF في توثيق روبي الرسمي.
+* [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-gets قسم التابع gets في الصنف ARGF في توثيق روبي الرسمي.]