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

من موسوعة حسوب
< Ruby‏ | Exception
مراجعة 13:37، 15 أكتوبر 2018 بواسطة جميل-بيلوني (نقاش | مساهمات) (مراجعة وتدقيق.)
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)
اذهب إلى التنقل اذهب إلى البحث

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

مصادر