عرض مصدر Ruby/IO/readline

<noinclude>{{DISPLAYTITLE: التابع <code>IO.readline‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby IO]]
يقرأ التابع <code>readline</code> سطرًا واحدًا من المجرى الذي استدعي معه. هذا التابع يشبه التابع <code>[[Ruby/IO/gets|gets]]</code> باستثناء أنَّه يُطلق الاستثناء <code>[[Ruby/EOFError|EOFError]]</code> عند نهاية الملف.
==البنية العامة==
<syntaxhighlight lang="ruby">readline(sep=$/ [, getline_args])  → string
readline(limit [, getline_args])→ string
readline(sep, limit [, getline_args]) → string‎</syntaxhighlight>
==المعاملات==
===<code>sep‎</code>===
محرف يمثِّل الفاصل السطري. القيمة الافتراضية هي: <code>/$</code>.
===<code>limit‎</code>===
عدد صحيح يحدد حجم البيانات الأقصى (بالبايت) المراد قراءتها.

=== <code>getline_args</code> ===
راجع صفحة <code>[[Ruby/IO/readlines|readlines]]</code> لمزيد من التفاصيل حول هذا المعامل.

==القيمة المعادة==
تعاد [[Ruby/String|سلسلة نصية]] تحوي السطر الذي قُرِئ من المجرى المعطى، أو يطلق الاستثناء <code>[[Ruby/EOFError|EOFError]]</code> عند نهاية الملف.

==انظر أيضًا==
*التابع [[Ruby/IO/pwrite|<code>pwrite</code>]]: يكتب [[Ruby/String|السلسلة النصية]] المُمرَّرة إليه في موضع محدَّد من [[Ruby/IO|المجرى]] الذي استُدعي معه باستخدام استدعاء دالة النظام <code>pwrite()‎</code>.  

*التابع [[Ruby/IO/read-i|<code>read</code>]]: يقرأ عددًا محدَّدًا من البايتات من [[Ruby/IO|المجرى]] الذي استدعي معه.
*التابع <code>[[Ruby/IO/read nonblock|read_nonblock]]</code>: يقرأ عددًا محدَّدًا من البايتات من [[Ruby/IO|المجرى]] الذي استُدعي معه باستخدام استدعاء النظام <code>read(2)‎</code> بعد تعيين الراية <code>O_NONBLOCK</code> لواصف الملف (file descriptor) الأساسي.
*التابع [[Ruby/IO/readbyte|<code>readbyte</code>]]: يقرأ بايتًا واحدًا من المجرى الذي استدعي معه.
*التابع [[Ruby/IO/readchar|<code>readchar</code>]]: يقرأ محرفًا واحدًا من [[Ruby/IO|المجرى]] الذي استدعي معه.
*التابع [[Ruby/IO/readlines-i|<code>readlines</code>]]: يقرأ كل الأسطر الموجودة في [[Ruby/IO|المجرى]] الذي استدعي معه ثم يعيدها في [[Ruby/Array|مصفوفة]]. 
*التابع [[Ruby/IO/readpartial|<code>readpartial</code>]]: يقرأ عددًا محدَّدًا من البايتات من [[Ruby/IO|المجرى]] الذي استدعي معه.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-readline قسم التابع readline‎ في الصنف IO‎ في توثيق روبي الرسمي.]