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