الفرق بين المراجعتين لصفحة: «Ruby/IO/readbyte»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط تدقيق |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby IO]] | [[تصنيف: Ruby IO]] | ||
يقرأ التابع <code>readbyte</code> بايتًا | يقرأ التابع <code>readbyte</code> بايتًا واحدًا من المجرى الذي استدعي معه. يشبه هذا التابع التابع <code>[[Ruby/IO/getbyte|getbyte]]</code>، باستثناء أنَّه يُطلق الاستثناء <code>[[Ruby/EOFError|EOFError]]</code> إن استدعي عند نهاية الملف. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">readbyte→ integer</syntaxhighlight> | <syntaxhighlight lang="ruby">readbyte→ integer</syntaxhighlight> | ||
==القيمة | ==القيمة المعادة== | ||
يعاد [[Ruby/Integer|عدد صحيح]] يمثِّل قيمة البايت المقروء من المجرى المعطى، أو يطلق الاستثناء <code>[[Ruby/EOFError|EOFError]]</code> عند الوصول إلى نهاية الملف. | |||
==انظر | ==انظر أيضًا== | ||
*التابع <code>[[Ruby/IO/readchar|readchar]]</code>: يقرأ | *التابع [[Ruby/IO/putc|<code>putc</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/readchar|<code>readchar</code>]]: يقرأ محرفًا واحدًا من [[Ruby/IO|المجرى]] الذي استدعي معه. | |||
*التابع [[Ruby/IO/readline|<code>readline</code>]]: يقرأ سطرًا واحدًا من المجرى الذي استدعي معه. | |||
*التابع [[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-readbyte قسم | *[http://ruby-doc.org/core-2.5.1/IO.html#method-i-readbyte قسم التابع readbyte في الصنف IO في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 08:37، 23 ديسمبر 2018
يقرأ التابع readbyte بايتًا واحدًا من المجرى الذي استدعي معه. يشبه هذا التابع التابع getbyte، باستثناء أنَّه يُطلق الاستثناء EOFError إن استدعي عند نهاية الملف.
البنية العامة
readbyte→ integer
القيمة المعادة
يعاد عدد صحيح يمثِّل قيمة البايت المقروء من المجرى المعطى، أو يطلق الاستثناء EOFError عند الوصول إلى نهاية الملف.
انظر أيضًا
- التابع
putc: يكتب المحرف المُمرَّر إليه في المجرى الذي استدعي معه.
- التابع
read: يقرأ عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه. - التابع
read_nonblock: يقرأ عددًا محدَّدًا من البايتات من المجرى الذي استُدعي معه باستخدام استدعاء النظامread(2)بعد تعيين الرايةO_NONBLOCKلواصف الملف (file descriptor) الأساسي. - التابع
readchar: يقرأ محرفًا واحدًا من المجرى الذي استدعي معه. - التابع
readline: يقرأ سطرًا واحدًا من المجرى الذي استدعي معه. - التابع
readlines: يقرأ كل الأسطر الموجودة في المجرى الذي استدعي معه ثم يعيدها في مصفوفة. - التابع
readpartial: يقرأ عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه.