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

من موسوعة حسوب

يُعيد التّابع 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: يُعيد اسم صنف الاستثناء ورسالته.

مصادر