عرض مصدر Ruby/Kernel/catch

<noinclude>{{DISPLAYTITLE: التابع <code>catch‎</code> الخاص بالصنف <code>Kernel</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Kernel]]
ينفذ التابع <code>catch</code> كتلته البرمجية. في حال عدم استدعاء <code>throw</code>، فستنفّذ الكتلة بشكل طبيعي، وسيعيد <code>catch</code> قيمة آخر تعبير تم تقييمه.<syntaxhighlight lang="ruby">catch(1) { 123 }            # => 123</syntaxhighlight>إذا استُدعي <code>throw(tag2, val)‎</code>، فستبحث روبي في المكدس (stack) عن كتلة التابع <code>catch</code>، التي يكون العنوان <code>tag</code> الخاص بها نفس القيمة <code>object_id</code> الخاص بالعنوان <code>tag2</code>. وعند العثور عليه، يتوقف تنفيذ الكتلة وتُعاد <code>val</code> (أو القيمة <code>nil</code> إذا لم يتم تمرير وسيط ثاني إلى <code>throw</code>).<syntaxhighlight lang="ruby">catch(1) { throw(1, 456) }  # => 456
catch(1) { throw(1) }       # => nil</syntaxhighlight>عند تمرير <code>tag</code> كوسيط أول، ستعيده <code>catch</code> كوسيط للكتلة.<syntaxhighlight lang="ruby">catch(1) {|x| x + 2 }       # => 3</syntaxhighlight>في حال عدم إعطاء الوسيط <code>tag</code>، ستعيد <code>catch</code> كائنًا جديدًا (كما هو الحال في <code>Object.new</code>) كوسيط للكتلة. يمكن استخدام هذا الكائن حينها كوسيط للتابع <code>throw</code>، وسيتطابق مع كتلة <code>catch</code> الصحيحة.
==البنية العامة==
<syntaxhighlight lang="ruby">catch([tag]) {|tag| block }  → obj‎</syntaxhighlight>
==المعاملات==
===<code>tag‎</code>===
عند تمرير <code>tag</code> كوسيط أول، ستعيده <code>catch</code> كوسيط للكتلة.
==القيمة المعادة==
تعاد قيمة آخر تعبير تم تقييمه.

==أمثلة==
مثال على استخدام التابع <code>catch‎</code>:<syntaxhighlight lang="ruby">catch(1) { 123 }            # => 123
‎
catch(1) { throw(1, 456) }  # => 456
catch(1) { throw(1) }       # => nil

catch(1) {|x| x + 2 }       # => 3</syntaxhighlight>
==انظر أيضا==
*التابع <code>[[Ruby/Kernel/throw|throw]]</code>: ينقل الضبط (control) إلى نهاية كتلة <code>catch</code> المُترقبة للوسم المعطى.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Kernel.html#method-i-catch قسم التابع catch‎ في الصنف Kernel‎ في توثيق روبي الرسمي.]