الفرق بين المراجعتين لصفحة: «Ruby/IO/readchar»

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

يقرأ التابع readchar محرفًا واحدًا من المجرى الذي استدعي معه.

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

readchar→ string‎

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

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

أمثلة

مثال على استخدام التابع readchar‎:

f = File.new("testfile")
f.readchar   #=> "h"
f.readchar   #=> "e"‎

انظر أيضًا

التابع putc: يكتب المحرف المُمرَّر إليه في المجرى الذي استدعي معه.

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

مصادر

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

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