التابع Exception.full_message في روبي

من موسوعة حسوب
مراجعة 18:39، 11 أكتوبر 2018 بواسطة محمد-خطيب (نقاش | مساهمات) (أنشأ الصفحة ب'{{DISPLAYTITLE:التابع <code>Exception.full_message</code> في روبي}} يُعيد التّابع <code>full_message</code> سلسلةً نصيةً منسّقة...')
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)

يُعيد التّابع full_message سلسلةً نصيةً منسّقةً من الاستثناء. تُنسّق السلسلة النصية المعادة بنفس التنسيق التي تستعمله روبي عند طبع الاستثناءات uncaught على مجرى الخطأ القياسي (stderr).

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

full_message(highlight: bool, order: [:top or :bottom])  string

المعاملات

highlight

قيمة منطقية؛ إن كانت true، فسيُرسل معالج الخطأ الافتراضي رسالةً إلى الطرفية tty. القيمة الافتراضية لهذا المعامل تعتمد على ‎$stderr وعلى القيمة التي يعيدها التابع tty?‎ في وقت الاستدعاء.

order

يحدد كيفية ترتيب الناتج المعاد ويكون إما top: أو bottom:، وتوضع رسالة الخطأ والمصفوفة backtrace إما في الأعلى أو في الأسفل. القيمة الافتراضية لهذا المعامل تعتمد على ‎$stderr وعلى القيمة التي يعيدها التابع tty?‎ في وقت الاستدعاء.

القيم المعادة

تُعاد سلسلةٌ نصيةٌ منسقةٌ من الاستثناء.

انظر أيضا

  • التابع message: يُعيد ناتج استدعاء التّابع Exception.to_s. ويُعيد هذا عادةً رسالة الاستثناء أو اسمه.
  • التابع to_s: يُعيد رسالة الاستثناء (أو اسم الاستثناء إذا لم يتم تعيين أي رسالة).
  • التابع inspect: يُعيد اسم صنف الاستثناء ورسالته.

مصادر