عرض مصدر Ruby/IO/ungetbyte

<noinclude>{{DISPLAYTITLE: التابع <code>IO.ungetbyte‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby IO]]
يعيد التابع <code>ungetbyte</code> دفع (pushes) البايتات (الممررة كمعامل إليه) إلى [[Ruby/IO|المجرى]] الذي استُدعي معه، بحيث تعيدها القراءة التالية من المخزن المؤقت (buffer) لهذا المجرى. 

لا يمكنك أن تدفع إلا بايتًا واحدًا فقط قبل عملية القراءة اللاحقة (أي لن تتمكن من قراءة إلا آخر بايت من البايتات التي دفتعها). 

التابع <code>ungetbyte</code> ليس له أي تأثير مع القراءات غير التخزينية (unbuffered reads) مثل <code>[[Ruby/IO/sysread|sysread]]</code>.
==البنية العامة==
<syntaxhighlight lang="ruby">ungetbyte(string)→ nil
ungetbyte(integer)  → nil‎</syntaxhighlight>
==المعاملات==
===<code>string‎</code>===
[[Ruby/String|السلسلة النصية]] المراد إرجاعها إلى المجرى.
===<code>integer‎</code>===
عدد صحيح يمثِّل قيمة البايت المراد إرجاعه إلى المجرى.

==القيمة المعادة==
تعاد القيمة <code>nil</code> بعد تنفيذ العملية.

==أمثلة==
مثال على استخدام التابع <code>ungetbyte‎</code>:
<syntaxhighlight lang="ruby">f = File.new("testfile")   #=> #<File:testfile>
b = f.getbyte              #=> 0x38
f.ungetbyte(b)             #=> nil
f.getbyte                  #=> 0x38‎</syntaxhighlight>
==انظر أيضًا==
* التابع [[Ruby/IO/getbyte|<code>getbyte</code>]]: يجلب البايت التالي من المجرى الذي استدعي معه.

* التابع [[Ruby/IO/puts|<code>puts</code>]]: يكتب الكائن(ات) المُمرَّرة إليه في المجرى الذي استُدعي معه، ويضيف سطرًا جديدًا بعد الأسطر التي لا تنتهي بمحرف السطر الجديد ثم يعيد القيمة <code>nil</code>. 

* التابع <code>[[Ruby/IO/ungetc|ungetc]]</code>: يعيد دفع محرف واحد (الذي مُرِّر إليه) إلى [[Ruby/IO|المجرى]] الذي استُدعي معه، بحيث تعيده القراءة التالية من المخزن المؤقت (buffer). 
==مصادر==
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-ungetbyte قسم التابع ungetbyte‎ في الصنف IO‎ في توثيق روبي الرسمي.]