التابع IO.ungetbyte‎ في روبي

يعيد التابع ungetbyte دفع (pushes) البايتات (الممررة كمعامل إليه) إلى المجرى الذي استُدعي معه، بحيث تعيدها القراءة التالية من المخزن المؤقت (buffer) لهذا المجرى.

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

التابع ungetbyte ليس له أي تأثير مع القراءات غير التخزينية (unbuffered reads) مثل sysread.

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

ungetbyte(string)→ nil
ungetbyte(integer)  → nil‎

المعاملات

string‎

السلسلة النصية المراد إرجاعها إلى المجرى.

integer‎

عدد صحيح يمثِّل قيمة البايت المراد إرجاعه إلى المجرى.

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

تعاد القيمة nil بعد تنفيذ العملية.

أمثلة

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

f = File.new("testfile")   #=> #<File:testfile>
b = f.getbyte              #=> 0x38
f.ungetbyte(b)             #=> nil
f.getbyte                  #=> 0x38‎

انظر أيضًا

• التابع getbyte: يجلب البايت التالي من المجرى الذي استدعي معه.

• التابع puts: يكتب الكائن(ات) المُمرَّرة إليه في المجرى الذي استُدعي معه، ويضيف سطرًا جديدًا بعد الأسطر التي لا تنتهي بمحرف السطر الجديد ثم يعيد القيمة nil. 

• التابع ungetc: يعيد دفع محرف واحد (الذي مُرِّر إليه) إلى المجرى الذي استُدعي معه، بحيث تعيده القراءة التالية من المخزن المؤقت (buffer). 

مصادر

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