التابع pipe الخاص بالصنف IO في روبي
ينشئ التابع pipe زوجًا من أطراف الأنابيب (pipe endpoints) (متصلة ببعضها البعض) ثم يعيدها على هيئة مصفوفة ثنائية من مجريات د/خ: [ read_io, write_io ].
في حال إعطاء كتلة، ستُسدعى تلك الكتلة، وتعاد قيمتها، مع تمرير read_io و write_io كوسائط إليها. وسيتم إغلاق read_io و write_io إن لم يغلقا عند خروج الكتلة. أي أن إغلاق read_io و/أو write_io لا يتسبب في حدوث خطأ.
التابع pipe غير متوفر في جميع أنظمة التشغيل.
إذا تم تحديد ترميز معين (اسم ترميز أو كائن ترميز) كوسيط اختياري، فسيتم وسم السلسلة النصية المقروءة من الأنبوب (pipe) بذلك الترميز. وإن كان الوسيط على هيئة علامتي ترميز مفصولتين بنقطتين رأسيتين ("A:B")، فستُحوّل السلسلة النصية المقروءة من الترميز A (الترميز الخارجي) إلى الترميز B (الترميز الداخلي)، ثم ستوسم بعلامة B. إذا تم تحديد وسيطين اختياريين، فيجب أن يكونا كائني ترميز، أو أسماء ترميز، بحيث يمثل أولهما الترميز الخارجي، ويمثل ثانيهما الترميز الداخلي. إذا تم تحديد الترميز الخارجي والترميز الداخلي، فسيحدد الوسيط الاختياري opt (انظر فقرة البنية العامة) خيارات التحويل.
البنية العامة
pipe → [read_io, write_io]
pipe(ext_enc) → [read_io, write_io]
pipe("ext_enc:int_enc" [, opt]) → [read_io, write_io]
pipe(ext_enc, int_enc [, opt])→ [read_io, write_io]
pipe(...) {|read_io, write_io| ... }
المعاملات
ext_enc
الترميز الخارجي
opt
خيارات
int_enc
الترميز الداخلي
القيمة المُعادة
تعاد مصفوفة ثنائية من مجريات د/خ:
أمثلة
في المثال التالي، تغلق العمليتان طرفي الأنبوب (ends of the pipe) الذي لا تستخدمانه. هذه ليست مجرد عملية تكميلية. لأن طرف القراءة الخاص بالأنبوب لن يُولد شرط نهاية الملف إن كان هناك مجرى كتابة (writer) مفتوح مرتبط بالأنبوب. في حالة العملية الأم (parent process)، لن تعود rd.read أبداً إلا بعد إصدار wr.close.
rd, wr = IO.pipe
if fork
wr.close
puts "Parent got: <#{rd.read}>"
rd.close
Process.wait
else
rd.close
puts "Sending message to parent"
wr.write "Hi Dad"
wr.close
end
الناتج:
Sending message to parent
Parent got: <Hi Dad>
انظر أيضا
- التابع
popen: ينفذ التابعpopenالتعليمة المعطاة في عملية فرعية (subprocess)؛