عرض مصدر Ruby/ARGF

<noinclude>{{DISPLAYTITLE: الصنف ARGF في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby ARGF]]
الصنف <code>ARGF</code> هو مجرى (stream) صُمِّم ليُستخدَم في الملفات البرمجية (scritps) التي تُعالج الملفات المُمرَّرة إليها على شكل وسائط في سطر الأوامر (command-line arguments)، أو المُمرَّرة عبر مجرى الدخل القياسي (<code>STDIN</code>).

تُخزَّن الوسائط المُمرَّرة للملف البرمجي في المصفوفة ARGV، إذ يخزَّن وسيط واحد في كل عنصر. تفترض <code>ARGF</code> أنّ الوسائط التي ليست أسماء ملفات (filenames) قد أزيلت من <code>ARGV</code>. انظر الشيفرة التالية مثلًا:<syntaxhighlight lang="ruby">
$ ruby argf.rb --verbose file1 file2

ARGV  #=> ["--verbose", "file1", "file2"]
option = ARGV.shift #=> "--verbose"
ARGV  #=> ["file1", "file2"]
</syntaxhighlight>يمكنك الآن استخدام <code>ARGF</code> للعمل مع سلسلة من كل هذه الملفات المسماة (named files). على سبيل المثال، ستعيد العبارة <code>ARGF.[[Ruby/ARGF/read|read]]</code> محتويات الملف <code>file1</code> متبوعةً بمحتويات الملف <code>file2</code>.

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

يمكنك تعديل <code>ARGV</code> بنفسك للتحكم في عملها. إن أزلت مثلًا ملفًا من <code>ARGV</code>، فستتجاهله <code>ARGF</code>؛ وإذا أضفت ملفات إلى <code>ARGV</code>، فستُعامل كما لو أنها مُرِّرت في سطر الأوامر. تفحَّص مثلًا الشيفرة التالية:<syntaxhighlight lang="ruby">
ARGV.replace ["file1"]
ARGF.readlines # في مصفوفة file1 إعادة محتويات الملف
ARGV           #=> []
ARGV.replace ["file2", "file3"]
ARGF.read      # file3 والملف file2 إعادة محتويات الملف
</syntaxhighlight>إن كانت ARGV فارغةً، فستتصرّف وكأنّها تحتوي مجرى الدخل القياسي (STDIN)، أي البيانات المُرسلة عبر أنبوب (piped) إلى ملفك البرمجي (script). إليك مثلًا هذا المثال البسيط:<syntaxhighlight lang="ruby">
$ echo "glark" | ruby -e 'p ARGF.read'
"glark\n"
</syntaxhighlight>
==مصادر==
* صفحة الصنف ARGF في توثيق روبي الرسمي.