التابع ARGF.getc في روبي

يجلب التابع getc المحرف التالي من المجرى ARGF. يعامل المجرى ARGF الملفات المُمرَّرة في سطر الأوامر كما لو كانت ملفًا واحدًا يتألَّف من جميع تلك الملفات؛ أي يتعاقب بعضها خلف بعض. بناءً على ذلك، يؤدي استدعاء التابع getc مرة أخرى بعد جلب المحرف الأخير من الملف الأول مثلًا إلى جلب المحرف الأول من الملف الثاني، وهلم جرًّا.

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

 getc → String or nil

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

تعاد سلسلة نصية تحوي المحرف التالي الذي يُقرَأ من المجرى ARGF، أو تعاد القيمة nil عند الوصول إلى نهاية المجرى.

أمثلة

مثالٌ على استخدام التابع getc:

 $ echo "foo" > file
$ ruby argf.rb file

ARGF.getc  #=> "f"
ARGF.getc  #=> "o"
ARGF.getc  #=> "o"
ARGF.getc  #=> "\n"
ARGF.getc  #=> nil
ARGF.getc  #=> nil

انظر أيضًا

• التابع getbyte: يجلب بايتًا واحدًا (8 بتّات) من المجرى ARGF.
• التابع gets: يجلب السطر التالي من الملف الحالي في المجرى ARGF.
• التابع putc: يكتب محرفًا واحدًا على المجرى ios.
• التابع readbyte: يقرأ البايت التالي من المجرى ARGF ثمَّ يعيده على شكل عدد صحيح (Integer).
• التابع readchar: يقرأ المحرف التالي من المجرى ARGF ثم يعيده على شكل سلسلة نصية.

مصادر

• قسم التابع getc في الصنف ARGF في توثيق روبي الرسمي.