التابع 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).