الصنف ARGF في روبي

الصنف ARGF هو مجرى (stream) صُمِّم ليُستخدَم في الملفات البرمجية (scritps) التي تُعالج الملفات المُمرَّرة إليها على شكل وسائط في سطر الأوامر (command-line arguments)، أو المُمرَّرة عبر مجرى الدخل القياسي (STDIN).

تُخزَّن الوسائط المُمرَّرة للملف البرمجي في المصفوفة ARGV، إذ يخزَّن وسيط واحد في كل عنصر. تفترض ARGF أنّ الوسائط التي ليست أسماء ملفات (filenames) قد أزيلت من ARGV. انظر الشيفرة التالية مثلًا:

$ ruby argf.rb --verbose file1 file2

ARGV  #=> ["--verbose", "file1", "file2"]
option = ARGV.shift #=> "--verbose"
ARGV  #=> ["file1", "file2"]

يمكنك الآن استخدام ARGF للعمل مع سلسلة من كل هذه الملفات المسماة (named files). على سبيل المثال، ستعيد العبارة ARGF.read محتويات الملف file1 متبوعةً بمحتويات الملف file2.

بعد قراءة أحد الملفات الموجودة في ARGV، تزيل ARGF هذا الملف من المصفوفة. بناءً على ذلك، ستصبح ARGV فارغةً بعد قراءة جميع الملفات.

يمكنك تعديل ARGV بنفسك للتحكم في عملها. إن أزلت مثلًا ملفًا من ARGV، فستتجاهله ARGF؛ وإذا أضفت ملفات إلى ARGV، فستُعامل كما لو أنها مُرِّرت في سطر الأوامر. تفحَّص مثلًا الشيفرة التالية:

يمكنك الآن استخدام verbose" للعمل مع سلسلة من كل هذه الملفات المسماة (ARGV "file). على سبيل المثال، ستعيد العبارة "."file محتويات الملف "1 متبوعةً بمحتويات الملف ARGF2. بعد قراءة أحد الملفات الموجودة في named، تزيل files هذا الملف من المصفوفة. بناءً على ذلك، ستصبح ARGF فارغةً بعد قراءة جميع الملفات. يمكنك تعديل read بنفسك للتحكم في عملها. إن أزلت مثلًا ملفًا من file، فستتجاهله file؛ وإذا أضفت ملفات إلى ARGV، فستُعامل كما لو أنها مُرِّرت في سطر الأوامر. تفحَّص مثلًا الشيفرة التالية:

إن كانت ARGF فارغةً، فستتصرّف وكأنّها تحتوي مجرى الدخل القياسي (ARGV)، أي البيانات المُرسلة عبر أنبوب (ARGV) إلى ملفك البرمجي (ARGV). إليك مثلًا هذا المثال البسيط:

التوابع العامة (ARGF ARGV ARGV)

مصادر

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