الفرق بين المراجعتين لصفحة: «Ruby/ARGF/readline»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>ARGF.readline</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby ARG...' |
لا ملخص تعديل |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby ARGF]] | [[تصنيف: Ruby ARGF]] | ||
يقرأ التابع <code>readline</code> السطر التالي من الملف الحالي في المجرى | يقرأ التابع <code>readline</code> السطر التالي من الملف الحالي في المجرى <code>ARGF</code>. | ||
يُفترَض أنَّ الفاصل المستعمل لفصل الأسطر هو المحرف /$؛ لاستخدام فاصل سطري مغاير، يمكن تمرير المحرف المراد استعماله كفاصل إلى التابع <code>readline</code>. | |||
يُفترَض أنَّ الفاصل المستعمل لفصل الأسطر هو المحرف <code>/$</code>؛ لاستخدام فاصل سطري مغاير، يمكن تمرير المحرف المراد استعماله كفاصل إلى التابع <code>readline</code>. | |||
يُطلَق الخطأ <code>EOFError</code> عند الوصول إلى نهاية الملف. | يُطلَق الخطأ <code>EOFError</code> عند الوصول إلى نهاية الملف. | ||
==البنية العامة== | ==البنية العامة== | ||
| سطر 12: | سطر 14: | ||
الوسائط | </syntaxhighlight> | ||
sep | |||
المحرف المستعمل كفاصل سطري. القيمة الافتراضية هي: /$. | == الوسائط == | ||
limit | |||
=== <code>sep</code> === | |||
المحرف المستعمل كفاصل سطري. القيمة الافتراضية هي: <code>/$</code>. | |||
=== <code>limit</code> === | |||
عددٌ يحدد الأحرف المراد قراءتها من كل سطر. افتراضيًا، ستُقرَأ كل المحارف الموجودة في السطر. | عددٌ يحدد الأحرف المراد قراءتها من كل سطر. افتراضيًا، ستُقرَأ كل المحارف الموجودة في السطر. | ||
==القيم المعادة== | ==القيم المعادة== | ||
تعاد سلسلة نصية تحوي البيانات التي قُرِأت من الملف الحالي في المجرى | تعاد سلسلة نصية تحوي البيانات التي قُرِأت من الملف الحالي في المجرى <code>ARGF</code>. | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/ARGF/read | <code>read</code>]]: يقرأ عددًا محددًا من البايتات من المجرى | * التابع [[Ruby/ARGF/read | <code>read</code>]]: يقرأ عددًا محددًا من البايتات من المجرى <code>ARGF</code>. | ||
* التابع [[Ruby/ARGF/readbyte | <code>readbyte</code>]]: يقرأ البايت التالي من المجرى | * التابع [[Ruby/ARGF/readbyte | <code>readbyte</code>]]: يقرأ البايت التالي من المجرى <code>ARGF</code> ثمَّ يعيده على شكل عدد صحيح (<code>Integer</code>). | ||
* التابع [[Ruby/ARGF/read_nonblock | <code>read_nonblock</code>]]: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديَّةً عليا من المجرى | * التابع [[Ruby/ARGF/read_nonblock | <code>read_nonblock</code>]]: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديَّةً عليا من المجرى <code>ARGF</code> في وضع عدم الحجز (non-blocking mode). | ||
* التابع [[Ruby/ARGF/readchar | <code>readchar</code>]]: يقرأ المحرف التالي من المجرى | * التابع [[Ruby/ARGF/readchar | <code>readchar</code>]]: يقرأ المحرف التالي من المجرى <code>ARGF</code> ثم يعيده على شكل سلسلة نصية. | ||
* التابع [[Ruby/ARGF/readlines | <code>readlines</code>]]: يقرأ الملف الحالي في المجرى | * التابع [[Ruby/ARGF/readlines | <code>readlines</code>]]: يقرأ الملف الحالي في المجرى <code>ARGF</code> بشكل كامل. | ||
* التابع [[Ruby/ARGF/readpartial | <code>readpartial</code>]]: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديةً عليا من المجرى | * التابع [[Ruby/ARGF/readpartial | <code>readpartial</code>]]: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديةً عليا من المجرى <code>ARGF</code>. | ||
* التابع [[Ruby/ARGF/puts | <code>puts</code>]]: يكتب الكائن أو الكائنات المُمرَّرة إليه على المجرى <code>ios</code> ثمَّ يضيف سطرًا جديدًا في النهاية إن لم تحتوِ تلك الكائنات المعطاة على محرف سطرٍ جديدٍ. | * التابع [[Ruby/ARGF/puts | <code>puts</code>]]: يكتب الكائن أو الكائنات المُمرَّرة إليه على المجرى <code>ios</code> ثمَّ يضيف سطرًا جديدًا في النهاية إن لم تحتوِ تلك الكائنات المعطاة على محرف سطرٍ جديدٍ. | ||
* التابع [[Ruby/ARGF/gets | <code>gets</code>]]: يجلب السطر التالي من الملف الحالي في المجرى | * التابع [[Ruby/ARGF/gets | <code>gets</code>]]: يجلب السطر التالي من الملف الحالي في المجرى <code>ARGF</code>. | ||
==مصادر== | ==مصادر== | ||
* قسم التابع readline في الصنف ARGF في توثيق روبي الرسمي. | * [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-readline قسم التابع readline في الصنف ARGF في توثيق روبي الرسمي.] | ||
مراجعة 18:13، 10 سبتمبر 2018
يقرأ التابع readline السطر التالي من الملف الحالي في المجرى ARGF.
يُفترَض أنَّ الفاصل المستعمل لفصل الأسطر هو المحرف /$؛ لاستخدام فاصل سطري مغاير، يمكن تمرير المحرف المراد استعماله كفاصل إلى التابع readline.
يُطلَق الخطأ EOFError عند الوصول إلى نهاية الملف.
البنية العامة
readline(sep=$/) → string
readline(limit) → string
readline(sep, limit) → string
الوسائط
sep
المحرف المستعمل كفاصل سطري. القيمة الافتراضية هي: /$.
limit
عددٌ يحدد الأحرف المراد قراءتها من كل سطر. افتراضيًا، ستُقرَأ كل المحارف الموجودة في السطر.
القيم المعادة
تعاد سلسلة نصية تحوي البيانات التي قُرِأت من الملف الحالي في المجرى ARGF.
انظر أيضًا
- التابع
read: يقرأ عددًا محددًا من البايتات من المجرىARGF. - التابع
readbyte: يقرأ البايت التالي من المجرىARGFثمَّ يعيده على شكل عدد صحيح (Integer). - التابع
read_nonblock: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديَّةً عليا من المجرىARGFفي وضع عدم الحجز (non-blocking mode). - التابع
readchar: يقرأ المحرف التالي من المجرىARGFثم يعيده على شكل سلسلة نصية. - التابع
readlines: يقرأ الملف الحالي في المجرىARGFبشكل كامل. - التابع
readpartial: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديةً عليا من المجرىARGF. - التابع
puts: يكتب الكائن أو الكائنات المُمرَّرة إليه على المجرىiosثمَّ يضيف سطرًا جديدًا في النهاية إن لم تحتوِ تلك الكائنات المعطاة على محرف سطرٍ جديدٍ. - التابع
gets: يجلب السطر التالي من الملف الحالي في المجرىARGF.