عرض مصدر Ruby/IO/readlines-i

<noinclude>{{DISPLAYTITLE: التابع <code>IO.readlines‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby IO]]
يقرأ التابع <code>readlines</code> كل الأسطر الموجودة في [[Ruby/IO|المجرى]] الذي استدعي معه ثم يعيدها في [[Ruby/Array|مصفوفة]]. 

يجب أن يكون المجرى مفتوحًا في وضعية القراءة أو سيُطلق استثناء <code>[[Ruby/IOError|IOError]]</code>. 
==البنية العامة==
<syntaxhighlight lang="ruby">readlines(sep=$/ [, getline_args])  → array
readlines(limit [, getline_args])→ array
readlines(sep, limit [, getline_args]) → array‎</syntaxhighlight>
==المعاملات==
===<code>sep‎</code>===
محرف يمثِّل الفاصل السطري. القيمة الافتراضية هي: <code>/$</code>. إن كان المعامل <code>sep</code> يساوي <code>nil</code>، فسسيُعاد محتوى المتبقي في المجرى كسجل (record) واحد. وإن إن أعطي المعامل <code>limit</code> أولًا أو إن أعطي مع هذا المعامل أيضًا، فلن تكون [[Ruby/String|السلسلة النصية]] المعادة أطول من القيمة <code>limit</code> المحددة.
===<code>limit‎</code>===
[[Ruby/Integer|عدد صحيح]] يحدد حجم البيانات الأقصى (بالبايت) المراد قراءتها.

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

==القيمة المعادة==
تعاد [[Ruby/Array|مصفوفة]] تحوي كل الأسطر الموجودة في [[Ruby/IO|المجرى]] المعطى بشكل لا يتجاوز الحد <code>limit</code> (إن أعطي).

==أمثلة==
مثال على استخدام التابع <code>readlines‎</code>:
<syntaxhighlight lang="ruby">f = File.new("testfile")
f.readlines[0]   #=> "This is line one\n"
f = File.new("testfile", chomp: true)
f.readlines[0]   #=> "This is line one"‎</syntaxhighlight>
==انظر أيضًا==
*التابع [[Ruby/IO/puts|<code>puts</code>]]: يكتب الكائن(ات) المُمرَّرة إليه في المجرى الذي استُدعي معه، ويضيف سطرًا جديدًا بعد الأسطر التي لا تنتهي بمحرف السطر الجديد ثم يعيد القيمة <code>nil</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/readline|<code>readline</code>]]: يقرأ سطرًا واحدًا من المجرى الذي استدعي معه.
*التابع [[Ruby/IO/readpartial|<code>readpartial</code>]]: يقرأ عددًا محدَّدًا من البايتات من [[Ruby/IO|المجرى]] الذي استدعي معه.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-readlines قسم التابع readlines‎ في الصنف IO‎ في توثيق روبي الرسمي.]