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

من موسوعة حسوب
< Ruby‏ | IO
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>IO.readline‎</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby...'
 
لا ملخص تعديل
سطر 3: سطر 3:
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby IO]]
[[تصنيف: Ruby IO]]
يقرأ التابع <code>readline</code> سطرًا كما يفعل التابع <code>IO#gets</code>، إلا أنه يُطلق الاستثناء <code>EOFError</code> عند نهاية الملف.
يقرأ التابع <code>readline</code> سطرًا كما يفعل التابع <code>[[Ruby/IO/gets|gets]]</code>، إلا أنه يُطلق الاستثناء <code>EOFError</code> عند نهاية الملف.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="ruby">readline(sep=$/ [, getline_args])  → string
<syntaxhighlight lang="ruby">readline(sep=$/ [, getline_args])  → string
سطر 11: سطر 11:
===<code>sep‎</code>===
===<code>sep‎</code>===
فاصل
فاصل
===<code>getline_args‎</code>===
===<code>limit‎</code>===
===<code>limit‎</code>===
عدد صحيح يمثل الحد الأٌقصى
عدد صحيح
==القيمة المُعادة==
==القيمة المُعادة==
يعيد التابع <code>readline</code> سلسلة نصية.
==انظر أيضا==
==انظر أيضا==
* التابع <code>[[Ruby/IO/readchar|readchar]]</code>: يقرأ  [[Ruby/String|سلسلة نصية]] مؤلفة من حرف واحد من [[Ruby/IO|مجرى د/خ]] <code>ios</code>. ويطلق الاستثناء <code>EOFError</code> عند نهاية الملف.
* التابع <code>[[Ruby/IO/readchar|readchar]]</code>: يقرأ  [[Ruby/String|سلسلة نصية]] مؤلفة من حرف واحد من [[Ruby/IO|مجرى د/خ]]  
* التابع <code>[[Ruby/IO/readlines-i|readlines]]</code>: يقرأ  كل الأسطر الموجودة في [[Ruby/IO|مجرى د/خ]] <code>ios</code>، ثم يعيدها في [[Ruby/Array|مصفوفة]]. يتم فصل الأسطر بالوسيط الاختياري <code>sep</code> (انظر فقرة البنية العامة). إن كان الوسيط <code>sep</code> يساوي <code>nil</code>، فسسيُعاد بقية المجرى كتسجيلة (record) واحدة. إن كان الوسيط الأول عددًا صحيحًا، أو إن أعطي الوسيط الاختياري الثاني، فلن تكون [[Ruby/String|السلسلة النصية]] المعادة أطول من حيث عدد البايتات من القيمة المحددة. يجب أن يكون المجرى مفتوحًا في وضعية القراءة أو سيُطلق استثناء <code>IOError</code>.
* التابع <code>[[Ruby/IO/readlines-i|readlines]]</code>: يقرأ  كل الأسطر الموجودة في [[Ruby/IO|مجرى د/خ]]، ثم يعيدها في [[Ruby/Array|مصفوفة]].  
==مصادر==
==مصادر==
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-readline قسم  التابع readline‎ في الصنف IO‎ في توثيق روبي الرسمي.]
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-readline قسم  التابع readline‎ في الصنف IO‎ في توثيق روبي الرسمي.]

مراجعة 19:04، 13 نوفمبر 2018

يقرأ التابع readline سطرًا كما يفعل التابع gets، إلا أنه يُطلق الاستثناء EOFError عند نهاية الملف.

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

readline(sep=$/ [, getline_args])   string
readline(limit [, getline_args]) string
readline(sep, limit [, getline_args])  string

المعاملات

sep‎

فاصل

limit‎

عدد صحيح

القيمة المُعادة

يعيد التابع readline سلسلة نصية.

انظر أيضا

مصادر