عرض مصدر Ruby/Process/waitpid

<noinclude>{{DISPLAYTITLE: التابع <code>Process.waitpid</code> في روبي}}</noinclude>
ينتظر التابع <code>waitpid</code> خروج العملية الابن ثم يعيد مُعرِّفها ويضبط <code>?$</code> إلى قيمة الكائن <code>[[Ruby/Process::Status|Process::Status]]</code> الذي يحوي معلومات حول تلك العملية. العملية التي ينتظرها التابع <code>wait</code> يعتمد على مُعرِّف العملية <code>pid</code> المُمرَّر إليه.

يطلق استدعاء هذا التابع الاستثناء <code>[[Ruby/SystemCallError|SystemCallError]]</code> إن لم يكن هنالك أية عمليات أبناء.

هذا التابع غير متاح على جميع المنصات.

==البنية العامة==
<syntaxhighlight lang="ruby">waitpid(pid=-1, flags=0) → integer</syntaxhighlight>

== المعاملات ==

=== <code>pid</code> ===
مُعرِّف العملية المراد انتظارها. تتراوح القيم التي تأخذها ضمن المجالات التالية:
* أكبر من الصفر: ينتظر التابع العملية الابن التي مُعرَّفها هو القيمة <code>pid</code> المعطاة نفسه.
* القيمة 0: ينتظر التابع أية عملية ابن التي مُعرِّف المجموعة المالكة لها يساوي مُعرِّف المجموعة المالكة للعملية المستدعية.
* القيمة 1-: ينتظر التابع أية عملية ابن (القيمة الافتراضية إن لم يُعطَ المعامل <code>pid</code>).
* أصغر من 1-: ينتظر التابع أية عملية ابن مُعرِّف المجموعة المالكة لها يساوي القيمة المطلقة للمعامل <code>pid</code> المعطى.

=== <code>flags</code> ===
يمكن أن يكون قيمة منطقية أو قيمة الراية <code>Process::WNOHANG</code> (لا يُحجَز إن لم يكن هنالك عملية ابن متاحة) أو الراية <code>Process::WUNTRACED</code> (يعيد العمليات الأبناء المتوقفة التي لم يُبلَّغ عنها). ليست جميع الرايات مدعومة على كل المنصات باستثناء أنَّ القيمة 0 (القيمة الافتراضية) لهذا المعامل تعمل على جميع المنصات.

==القيم المعادة==
يعاد [[Ruby/Integer|عدد صحيح]] يمثِّل مُعرِّف العملية الابن بعد خروجها.
==أمثلة==
مثال على استعمال التابع <code>waitpid</code>:<syntaxhighlight lang="ruby">
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
</syntaxhighlight>
==انظر أيضًا==
*التابع <code>[[Ruby/Process/wait|wait]]</code>: ينتظر خروج العملية الابن ثم يعيد مُعرِّفها ويضبط <code>?$</code> إلى قيمة الكائن <code>Process::Status</code> الذي يحوي معلومات حول تلك العملية.
*التابع <code>[[Ruby/Process/wait2|wait2]]</code>: ينتظر خروج العملية الابن ثم يعيد مصفوفة تحوي مُعرِّف وحالة الخروج (كائنًا من النوع <code>[[Ruby/Process::Status|Process::Status]]</code>) تلك العملية.
*التابع <code>[[Ruby/Process/waitall|waitall]]</code>: ينتظر جميع العمليات الأبناء للعملية الحالية ثم يعيد مصفوفة تحوي الأزواج [[Ruby/Process::Status|مُعرِّف_العملية]]/الحالة (pid/status).
*التابع <code>[[Ruby/Process/waitpid2|waitpid2]]</code>: ينتظر خروج العملية الابن ثم يعيد مصفوفة تحوي مُعرِّف وحالة الخروج (كائنًا من النوع <code>[[Ruby/Process::Status|Process::Status]]</code>) تلك العملية.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Process.html#method-c-waitpid قسم التابع waitpid في الصنف Process في توثيق روبي الرسمي.]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Process]]