عرض مصدر Ruby/Thread/join

<noinclude>{{DISPLAYTITLE: التابع <code>join‎</code> الخاص بالصنف <code>Thread</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Thread]]
عند استدعاء التابع <code>join</code>، فسيتوقف تنفيذ [[Ruby/Thread|المهمة الفرعية]] المُستدعية (calling thread)، وستٌنفذ [[Ruby/Thread|المهمة الفرعية]] التي استُدعي معها. ولن يعود حتى تخرج (exits) [[Ruby/Thread|المهمة الفرعية]]، أو حتى تمر <code>limit</code> ثانية (انظر فقرة البنية العامة).

في حالة انتهاء المهلة الزمنية، ستعاد <code>nil</code>، خلا ذلك، ستُعاد [[Ruby/Thread|المهمة الفرعية]].

سيتم إنهاء كل [[Ruby/Thread|المهام الفرعية]] غير المضمومة (joined) عندما يخرج البرنامج الرئيسي.

إن أطلقت [[Ruby/Thread|المهمة الفرعية]] سابقا استثناء، ولم يتم تعيين الرايتين <code>[[Ruby/Thread/abort_on_exception|abort_on_exception]]</code> أو ‎<code>$DEBUG</code> (أي أنه لم تتم معالجة الاستثناء بعد) ، فسيُعالج في هذا الوقت.
==البنية العامة==
<syntaxhighlight lang="ruby">join → thr
join(limit)→ thr‎</syntaxhighlight>
==المعاملات==
===<code>limit‎</code>===
يمثل عدد ثواني المهملة الزمنية.

==القيمة المُعادة==
في حالة انتهاء المهلة الزمنية، ستعاد <code>nil</code>، خلا ذلك، ستُعاد [[Ruby/Thread|المهمة الفرعية]].

==أمثلة==

=== المثال الأول ===
مثال على استخدام التابع <code>join‎</code>:
<syntaxhighlight lang="ruby">a = Thread.new { print "a"; sleep(10); print "b"; print "c" }
x = Thread.new { print "x"; Thread.pass; print "y"; print "z" }
x.join # Let thread x finish, thread a will be killed on exit.
#=> "axyz"‎</syntaxhighlight>

=== المثال الثاني ===
يوضح المثال التالي استخدام الوسيط <code>limit</code>.:<syntaxhighlight lang="ruby">y = Thread.new { 4.times { sleep 0.1; puts 'tick... ' }}
puts "Waiting" until y.join(0.15)</syntaxhighlight>هذا سوف ينتج:<syntaxhighlight lang="ruby">tick...
Waiting
tick...
Waiting
tick...
tick...‎</syntaxhighlight>
==انظر أيضا==
* التابع <nowiki/>[[Ruby/Thread/abort_on_exception|<code></code>]]<code>[[Ruby/Thread/key-3F|abort_on_exception]]</code>: يُعيد التابع <code>abort_on_exception</code> حالة الشرط "abort on exception". القيمة الافتراضية هي <code>false</code>.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Thread.html#method-i-join قسم  التابع join‎ في الصنف Thread‎ في توثيق روبي الرسمي.]