التابع Process.waitpid في روبي
ينتظر التابع waitpid خروج العملية الابن ثم يعيد مُعرِّفها ويضبط ?$ إلى قيمة الكائن Process::Status الذي يحوي معلومات حول تلك العملية. العملية التي ينتظرها التابع wait يعتمد على مُعرِّف العملية pid المُمرَّر إليه.
يطلق استدعاء هذا التابع الاستثناء SystemCallError إن لم يكن هنالك أية عمليات أبناء.
هذا التابع غير متاح على جميع المنصات.
البنية العامة
waitpid(pid=-1, flags=0) → integer
المعاملات
pid
مُعرِّف العملية المراد انتظارها. تتراوح القيم التي تأخذها ضمن المجالات التالية:
- أكبر من الصفر: ينتظر التابع العملية الابن التي مُعرَّفها هو القيمة
pidالمعطاة نفسه. - القيمة 0: ينتظر التابع أية عملية ابن التي مُعرِّف المجموعة المالكة لها يساوي مُعرِّف المجموعة المالكة للعملية المستدعية.
- القيمة 1-: ينتظر التابع أية عملية ابن (القيمة الافتراضية إن لم يُعطَ المعامل
pid). - أصغر من 1-: ينتظر التابع أية عملية ابن مُعرِّف المجموعة المالكة لها يساوي القيمة المطلقة للمعامل
pidالمعطى.
flags
يمكن أن يكون قيمة منطقية أو قيمة الراية Process::WNOHANG (لا يُحجَز إن لم يكن هنالك عملية ابن متاحة) أو الراية Process::WUNTRACED (يعيد العمليات الأبناء المتوقفة التي لم يُبلَّغ عنها). ليست جميع الرايات مدعومة على كل المنصات باستثناء أنَّ القيمة 0 (القيمة الافتراضية) لهذا المعامل تعمل على جميع المنصات.
القيم المعادة
يعاد عدد صحيح يمثِّل مُعرِّف العملية الابن بعد خروجها.
أمثلة
مثال على استعمال التابع waitpid:
include Process
fork { exit 99 } #=> 27429
wait #=> 27429
$?.exitstatus #=> 99
pid = fork { sleep 3 } #=> 27440
Time.now #=> 2008-03-08 19:56:16 +0900
waitpid(pid, Process::WNOHANG) #=> nil
Time.now #=> 2008-03-08 19:56:16 +0900
waitpid(pid, 0) #=> 27440
Time.now #=> 2008-03-08 19:56:19 +0900
انظر أيضًا
- التابع
wait: ينتظر خروج العملية الابن ثم يعيد مُعرِّفها ويضبط?$إلى قيمة الكائنProcess::Statusالذي يحوي معلومات حول تلك العملية. - التابع
wait2: ينتظر خروج العملية الابن ثم يعيد مصفوفة تحوي مُعرِّف وحالة الخروج (كائنًا من النوعProcess::Status) تلك العملية. - التابع
waitall: ينتظر جميع العمليات الأبناء للعملية الحالية ثم يعيد مصفوفة تحوي الأزواج مُعرِّف_العملية/الحالة (pid/status). - التابع
waitpid2: ينتظر خروج العملية الابن ثم يعيد مصفوفة تحوي مُعرِّف وحالة الخروج (كائنًا من النوعProcess::Status) تلك العملية.