الفرق بين المراجعتين ل"Ruby/IO/readline"

المراجعة الحالية بتاريخ 08:47، 23 ديسمبر 2018

يقرأ التابع readline سطرًا واحدًا من المجرى الذي استدعي معه. هذا التابع يشبه التابع gets باستثناء أنَّه يُطلق الاستثناء EOFError عند نهاية الملف.

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

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

المعاملات

`sep‎`

محرف يمثِّل الفاصل السطري. القيمة الافتراضية هي: /$.

`limit‎`

عدد صحيح يحدد حجم البيانات الأقصى (بالبايت) المراد قراءتها.

`getline_args`

راجع صفحة readlines لمزيد من التفاصيل حول هذا المعامل.

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

تعاد سلسلة نصية تحوي السطر الذي قُرِئ من المجرى المعطى، أو يطلق الاستثناء EOFError عند نهاية الملف.

انظر أيضًا

التابع pwrite: يكتب السلسلة النصية المُمرَّرة إليه في موضع محدَّد من المجرى الذي استُدعي معه باستخدام استدعاء دالة النظام pwrite()‎.

التابع read: يقرأ عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه.
التابع read_nonblock: يقرأ عددًا محدَّدًا من البايتات من المجرى الذي استُدعي معه باستخدام استدعاء النظام read(2)‎ بعد تعيين الراية O_NONBLOCK لواصف الملف (file descriptor) الأساسي.
التابع readbyte: يقرأ بايتًا واحدًا من المجرى الذي استدعي معه.
التابع readchar: يقرأ محرفًا واحدًا من المجرى الذي استدعي معه.
التابع readlines: يقرأ كل الأسطر الموجودة في المجرى الذي استدعي معه ثم يعيدها في مصفوفة.
التابع readpartial: يقرأ عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه.

مصادر

قسم التابع readline‎ في الصنف IO‎ في توثيق روبي الرسمي.

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby IO]]
-يقرأ التابع <code>readline</code> سطرًا كما يفعل التابع <code>[[Ruby/IO/gets|gets]]</code>، إلا أنه يُطلق الاستثناء <code>EOFError</code> عند نهاية الملف.
+يقرأ التابع <code>readline</code> سطرًا واحدًا من المجرى الذي استدعي معه. هذا التابع يشبه التابع <code>[[Ruby/IO/gets|gets]]</code> باستثناء أنَّه يُطلق الاستثناء <code>[[Ruby/EOFError|EOFError]]</code> عند نهاية الملف.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">readline(sep=$/ [, getline_args])  → string
@@ سطر 10: / سطر 10: @@
 ==المعاملات==
 ===<code>sep‎</code>===
-فاصل
+محرف يمثِّل الفاصل السطري. القيمة الافتراضية هي: <code>/$</code>.
 ===<code>limit‎</code>===
-عدد صحيح
+عدد صحيح يحدد حجم البيانات الأقصى (بالبايت) المراد قراءتها.
-==القيمة المُعادة==
-يعيد التابع <code>readline</code> سلسلة نصية.
-==انظر أيضا==
+=== <code>getline_args</code> ===
-* التابع <code>[[Ruby/IO/readchar|readchar]]</code>: يقرأ  [[Ruby/String|سلسلة نصية]] مؤلفة من حرف واحد من [[Ruby/IO|مجرى د/خ]]
+راجع صفحة <code>[[Ruby/IO/readlines|readlines]]</code> لمزيد من التفاصيل حول هذا المعامل.
-* التابع <code>[[Ruby/IO/readlines-i|readlines]]</code>: يقرأ  كل الأسطر الموجودة في [[Ruby/IO|مجرى د/خ]]، ثم يعيدها في [[Ruby/Array|مصفوفة]].
+==القيمة المعادة==
+تعاد [[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‎ في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-readline قسم التابع readline‎ في الصنف IO‎ في توثيق روبي الرسمي.]