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

من موسوعة حسوب
< Ruby‏ | IO
اذهب إلى التنقل اذهب إلى البحث
ط (تدقيق)
 
سطر 3: سطر 3:
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby IO]]
 
[[تصنيف: Ruby IO]]
يقرأ التابع <code>readbyte</code> بايتًا (byte) كما يفعل التابع <code>[[Ruby/IO/getbyte|getbyte]]</code>، إلا أنه يُطلق الاستثناء <code>EOFError</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>
==القيمة المُعادة==
+
==القيمة المعادة==
يعيد التابع <code>readbyte</code> عددا.
+
يعاد [[Ruby/Integer|عدد صحيح]] يمثِّل قيمة البايت المقروء من المجرى المعطى، أو يطلق الاستثناء <code>[[Ruby/EOFError|EOFError]]</code> عند الوصول إلى نهاية الملف.
  
==انظر أيضا==
+
==انظر أيضًا==
*التابع <code>[[Ruby/IO/readchar|readchar]]</code>: يقرأ [[Ruby/String|سلسلة نصية]] مؤلفة من حرف واحد من [[Ruby/IO|مجرى د/خ]]
+
*التابع [[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 قسم التابع readbyte‎ في الصنف IO‎ في توثيق روبي الرسمي.]
+
*[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: يقرأ عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه.

مصادر