الفرق بين المراجعتين لصفحة: «Ruby/Exception/full message»

من موسوعة حسوب
أنشأ الصفحة ب'{{DISPLAYTITLE:التابع <code>Exception.full_message</code> في روبي}} يُعيد التّابع <code>full_message</code> سلسلةً نصيةً منسّقة...'
 
ط مراجعة وتدقيق.
 
سطر 10: سطر 10:


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


=== <code>order</code> ===
=== <code>order</code> ===
يحدد كيفية ترتيب الناتج المعاد ويكون إما top: أو bottom:، وتوضع رسالة الخطأ والمصفوفة <code>backtrace</code> إما في الأعلى أو في الأسفل. القيمة الافتراضية لهذا المعامل تعتمد على ‎<code>$stderr</code> وعلى القيمة التي يعيدها التابع <code>tty?</code>‎ في وقت الاستدعاء.
يحدد كيفية ترتيب الناتج المعاد ويكون إما <code>top:</code> أو <code>bottom:</code>، وتوضع رسالة الخطأ والمصفوفة <code>[[Ruby/Exception/backtrace|backtrace]]</code> إما في الأعلى أو في الأسفل. القيمة الافتراضية لهذا المعامل تعتمد على ‎<code>$stderr</code> وعلى القيمة التي يعيدها التابع <code>tty?</code>‎ في وقت الاستدعاء.


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

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

مصادر