التابع raise‎ الخاص بالصنف Kernel في روبي

من موسوعة حسوب
< Ruby‏ | Kernel
اذهب إلى: تصفح، ابحث

استدعاء التابع raise بدون تمرير أي معامل يُطلق الاستثناء في ‎$!‎‎‎‎ أو يطلق الخطأ RuntimeError إذا كان ‎$!‎ يساوي nil. في حال تمرير سلسلة نصية فقط، فسيُطلَق الخطأRuntimeError مع إظهار هذه السلسلة النصية كرسالة. خلا ذلك، يجب أن يكون الوسيط الأول اسم الصنف Exception (أو كائنًا يعيد كائنًا من النوع Exception عند إرسال رسالة استثناء). يحدِّد الوسيط الاختياري الثاني الرسالة المرتبطة بالاستثناء، أما الوسيط الثالث فهو مصفوفة تضم معلومات الاستدعاء.

تُلتقَط الاستثناءات بواسطة الجملة rescue من الكتل begin...end.

البنية العامة

raise
raise(string)
raise(exception [, string [, array]])

المعاملات

string‎

سلسلة نصية تمثل الرسالة المراد إظهارها عند إطلاق الاستثناء.

exception‎

اسم الصنف Exception أو كائن يعيد كائنًا من الصنف Exception.

array‎

مصفوفة تضم معلومات الاستدعاء.

أمثلة

مثال على استخدام التابع raise‎:

raise "Failed to create socket"
raise ArgumentError, "No parameters", caller

انظر أيضا

  • التابع fail: يطلق استثناءً أو خطأً.

مصادر