الفرق بين المراجعتين ل"Ruby/Kernel/raise"
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>raise</code> الخاص بالصنف <code>Kernel</code> في روبي}}</noinclude> تصنيف: Ruby تصني...') |
|||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Kernel]] | [[تصنيف: Ruby Kernel]] | ||
| − | في حال عدم تمريرأي وسائط، سيطلق التابع raise استثناء في <code>$!</code> أو يطلق <code>RuntimeError</code> إن كان <code>$!</code> يساوي <code>nil</code>. في حال تمرير وسيط واحد <code>String</code>، فسيطلق <code>RuntimeError</code> بحيث يكون الوسيط الممرر string | + | في حال عدم تمريرأي وسائط، سيطلق التابع <code>raise</code> استثناء في <code>$!</code> أو يطلق الخطأ <code>RuntimeError</code> إن كان <code>$!</code> يساوي <code>nil</code>. في حال تمرير وسيط واحد <code>String</code>، فسيطلق الخطأ <code>RuntimeError</code> بحيث يكون الوسيط الممرر <code>string</code> هو رسالة ذلك الخطأ. خلا ذلك، يجب أن يكون الوسيط الأول اسما للصنف <code>Exception</code> (أو كائنًا يعيد كائن <code>Exception</code> عند تلقيه رسالة <code>exception</code>). يحدد الوسيط الاختياري الثاني رسالة الاستثناء، أما الوسيط الثالث فهو مصفوفة تضم معلومات الاستدعاء. |
| + | |||
| + | تُمسك الاستثناءات بواسطة جملة <code>rescue</code> من كتل <code>begin...end</code>. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">raise | <syntaxhighlight lang="ruby">raise | ||
| سطر 10: | سطر 12: | ||
==المعاملات== | ==المعاملات== | ||
===<code>string</code>=== | ===<code>string</code>=== | ||
| + | رسالة الخطأ. | ||
===<code>exception</code>=== | ===<code>exception</code>=== | ||
| + | استثناء. | ||
===<code>array</code>=== | ===<code>array</code>=== | ||
| − | + | مصفوفة تضم معلومات الاستدعاء. | |
| − | |||
| − | |||
==أمثلة== | ==أمثلة== | ||
مثال على استخدام التابع <code>raise</code>: | مثال على استخدام التابع <code>raise</code>: | ||
| سطر 23: | سطر 25: | ||
raise ArgumentError, "No parameters", caller</syntaxhighlight> | raise ArgumentError, "No parameters", caller</syntaxhighlight> | ||
==انظر أيضا== | ==انظر أيضا== | ||
| − | * التابع <code>[[Ruby/Kernel/ | + | * التابع <code>[[Ruby/Kernel/fail|fail]]</code>: يطلق التابع <code>puts</code> استثناء أو خطأ. |
| − | |||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/Kernel.html#method-i-raise قسم التابع raise في الصنف Kernel في توثيق روبي الرسمي.] | *[http://ruby-doc.org/core-2.5.1/Kernel.html#method-i-raise قسم التابع raise في الصنف Kernel في توثيق روبي الرسمي.] | ||
مراجعة 12:53، 22 أكتوبر 2018
في حال عدم تمريرأي وسائط، سيطلق التابع raise استثناء في $! أو يطلق الخطأ RuntimeError إن كان $! يساوي nil. في حال تمرير وسيط واحد String، فسيطلق الخطأ RuntimeError بحيث يكون الوسيط الممرر string هو رسالة ذلك الخطأ. خلا ذلك، يجب أن يكون الوسيط الأول اسما للصنف Exception (أو كائنًا يعيد كائن Exception عند تلقيه رسالة exception). يحدد الوسيط الاختياري الثاني رسالة الاستثناء، أما الوسيط الثالث فهو مصفوفة تضم معلومات الاستدعاء.
تُمسك الاستثناءات بواسطة جملة rescue من كتل begin...end.
البنية العامة
raise
raise(string)
raise(exception [, string [, array]])
المعاملات
string
رسالة الخطأ.
exception
استثناء.
array
مصفوفة تضم معلومات الاستدعاء.
أمثلة
مثال على استخدام التابع raise:
raise "Failed to create socket"
raise ArgumentError, "No parameters", caller
انظر أيضا
- التابع
fail: يطلق التابعputsاستثناء أو خطأ.