الفرق بين المراجعتين لصفحة: «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>IO#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>getline_args‎</code>===
 ===<code>limit‎</code>===
-عدد صحيح يمثل الحد الأٌقصى
+عدد صحيح يحدد حجم البيانات الأقصى (بالبايت) المراد قراءتها.
-==القيمة المُعادة==
-==انظر أيضا==
+=== <code>getline_args</code> ===
-* التابع <code>[[Ruby/IO/readchar|readchar]]</code>: يقرأ  [[Ruby/String|سلسلة نصية]] مؤلفة من حرف واحد من [[Ruby/IO|مجرى د/خ]] <code>ios</code>. ويطلق الاستثناء <code>EOFError</code> عند نهاية الملف.
+راجع صفحة <code>[[Ruby/IO/readlines|readlines]]</code> لمزيد من التفاصيل حول هذا المعامل.
-* التابع <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>.
+==القيمة المعادة==
+تعاد [[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‎ في توثيق روبي الرسمي.]