التابع open‎ الخاص بالصنف Kernel في روبي

ينشئ التابع open كائنًا من النوع IO متصلًا بالمجرى أو الملف أو العملية الفرعية (subprocess) المحددة.

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

open(path [, mode [, perm]] [, opt]) → io or nil
open(path [, mode [, perm]] [, opt]) {|io| block }  → obj‎

في حال إعطاء كتلة، فستُسدعَى بتمرير كائن من النوع IO كوسيط إليها، والذي سيُغلق تلقائيًا عند الانتهاء من تنفيذ الكتلة ثم سيعاد الناتج.

إذا بُدئ الوسيط path بشرطة عمودية ("|") ، فسيتم إنشاء عملية فرعية (subprocess)، متصلة بالمُستدعي (caller) بواسطة زوج من الأنابيب (pipes). يمكن استخدام كائن من النوع IO المُعاد لأجل الكتابة في مجرى الدخل القياسي، أو القراءة من مجرى الخرج القياسي لهذه العملية الفرعية.

إذا أُعقبت الشرطة العمودية بعلامة ناقص واحدة ("-|")، فستنشئ روبي عملية فرعية جديدة متصلة بالعملية الأم. أما إذا لم يكن الأمر (command) يساوي "-"، فستنفذ العملية الفرعية الأمر.

إذا كانت العملية الفرعية هي روبي نفسها (مفتوحة عبر "-|")، فسيعيد استدعاء التابع open القيمة nil. وفي حال تمرير كتلة عند استدعاء open، فستنفذ الكتلة مرتين: مرة في العملية الأم ومرة في العملية الفرعية.

الوسيط block سيكون كائنًا من النوع IO في العملية الأم والقيمة nil في العملية الفرعية. سيتم ريط الكائن IO الأب بالمجرى ‎$stdin والمجرى ‎$stdout. سيتم إنهاء العملية الفرعية في نهاية الكتلة.

المعاملات

path‎

مسار الملف المراد فتحه. إذا لم يبدأ بخط عمودي (|) ، فسيُعدُّ اسمَ الملف المراد فتحه باستخدام الوضع mode المحدد.

mode‎

الوضع الذي سيُفتَح الملف فيه. القيمة الافتراضية هي: "r". يكون إمَّا سلسلة نصية أو عدد صحيح. إن كان عددًا صحيحًا، فيجب أن تطبق العملية OR الثنائية على رايات الدالة open(2)‎، مثل File:: RDWR أو File::EXCL. أما إذا كان سلسلة نصية، فسيكون إما "fmode" أو "fmode: ext_enc" أو "fmode: ext_enc: int_enc".

راجع توثيق التابع IO.new لمزيد من المعلومات حول المعامل mode.

perm‎

في حالة إنشاء ملف، قد يعين المعامل perm‎ أذوناته الأولية. انظر التابع File.new والدالة open(2)‎ والدالة chmod(2)‎ لمزيد من المعلومات حول الأذونات.

opt‎

يحدد الخيارات لفتح الملف.

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

يعاد كائنٌ من النوع IO متصلًا بالمجرى أو الملف أو العملية الفرعية المحددة. وإذا كانت العملية الفرعية هي روبي، فستُعاد القيمة nil.

أمثلة

القراءة من الملف "testfile" عبر استخدام التابع open‎:

open("testfile") do |f|
  print f.gets
end

سينتج عن تنفيذ المثال ناتج شبيه بالناتج التالي:

This is line one

مثالٌ آخر حول فتح عملية فرعية وقراءة ناتجها عبر استخدام التابع open‎:

cmd = open("|date")
print cmd.gets
cmd.close

سينتج عن تنفيذ المثال ناتج شبيه بالناتج التالي:

Wed Apr  9 08:56:31 CDT 2003‎

مثالٌ آخر حول فتح عملية فرعية تُشغّل نفس برنامج روبي عبر استخدام التابع open‎:

f = open("|-", "w+")
if f.nil?
  puts "in Child"
  exit
else
  puts "Got: #{f.gets}"
end

سينتج عن تنفيذ المثال ناتج شبيه بالناتج التالي:

Got: in Child‎

يشرح المثال الأخير كيفية فتح عملية فرعية باستخدام كتلة لاستلام كائن من النوع IO:

open "|-" do |f|
  if f then
    # parent process
    puts "Got: #{f.gets}"
  else
    # child process
    puts "in Child"
  end
end

سينتج عن تنفيذ المثال ناتج شبيه بالناتج التالي:

Got: in Child‎

انظر أيضا

• التابع fork: ينشئ عملية فرعية (subprocess).

مصادر

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