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

مراجعة 18:55، 10 أكتوبر 2018

تُستخدَم الكائنات السليلة من الصنف Exception للتواصل بين التّابع Kernel.raise وتصريحات rescue في الكتل (blocks) من الشكل begin ... end. تَحمل كائنات الصنف Exception معلوماتٍ عن الاستثناء المَرمي – نوعه (اسم صنف الاستثناء)، وسلسلةً نصيّةً وصفيّةً اختياريّة، ومعلوماتِ تتبّعٍ اختيارية. قد تضيف الأصناف الفرعية من الصنف Exception معلوماتٍ إضافيّةٍ مثل NameError.name.

قد تُنشِئ البرامج أصنافًا فرعيّةً (subclasses) من الصنف Exception، تكون عادةً StandardError أو RuntimeError، لتوفير أصنافٍ مخصصّةٍ وإضافة معلوماتٍ إضافية. ألقِ نظرةً على قائمة الأصناف الفرعية في الأسفل من أجل قيم raise و rescue الافتراضية .

عندما يُرمى استثناءٌ ولكن لم يُتعامل معه بعد (في الكتل rescue، و ensure، و at_exit، و END)، يحتوي المتغيّر العام ‎ $!‎ على الاستثناء الحالي، بينما يحتوي ‎ $@‎على مصفوفة التتبع المعاكس (backtrace) للاستثناء الحالي.

يُستحسن أن تمتلك المكتبة صنفًا فرعيًّا واحدًا إما StandardError أو RuntimeError وأن تمتلك أنواع استثناءات محددة ترث منه . هذا يسمح للمستخدم بإنقاذ الاستثناء ذي النوع العام (generic exception) وبالتالي إمساك (catch) كل الاستثناءات التي قد ترميها المكتبة حتى إذا أضافت الإصدارات المستقبلية للمكتبة أصنافًا فرعيّةً جديدةً للصنف Exception.

ألقٍ نظرة على المثال التالي:

class MyLibrary

 class Error < RuntimeError

 end

 class WidgetError < Error

 end

 class FrobError < Error

 end

end

للتعامل مع الصنفين الفرعيِّين WidgetError وFrobError يمكن لمستخدم المكتبة تنفيذ rescue على MyLibrary::Error.

الأصناف الفرعيّة المضمّنة في الصنف Exception هي:

NoMemoryError
ScriptError
- LoadError
- NotImplementedError
- SyntaxError
SecurityError
SignalException
- Interrupt
StandardError – default for rescue
- ArgumentError
  - UncaughtThrowError
- EncodingError
- FiberError
- IOError
  - EOFError
- IndexError
  - KeyError
  - StopIteration
- LocalJumpError
- NameError
  - NoMethodError
- RangeError
  - FloatDomainError
- RegexpError
- RuntimeError – default for raise
  - FrozenError
- SystemCallError
  - Errno::*
- ThreadError
- TypeError
- ZeroDivisionError
SystemExit
SystemStackError
fatal – impossible to rescue

توابع الصنف العامة (Public Class Methods)

`exception`

يُعيد التّابع exception المُستقبل (receiver) إن لم يمرَّر إليه أي وسيط، أو إذا كان الوسيط الممرر إليه هو نفسه المُستقبل. خلاف ذلك، يُنشئ كائن استثناءٍ جديد (exception object) من الصنف نفسه على أنّه المستقبل، ولكن مع رسالةٍ مساوية إلى string.to_str.

`new`

يُنشئ التّابع new كائنًا جديدًا من النّوع Exception، ويمرِّر رسالةً اختياريًّا إليه.

`?to_tty`

يتحقّق التّابع ?to_tty فيما إذا كانت رسائل الاستثناء ستُرسل إلى الطرفية tty.

توابع الكائن العامة (Public Instance Methods)

`==`

يتحقق المعامل == من تساوي كائني استثناء مع بعضهما بعضًا.

`backtrace`

يُعيد التّابع backtrace أيَّ تتبّعٍ عكسيٍّ (backtrace) مرتبطٍ بالاستثناء.

`backtrace_locations`

يُعيد التّابع backtrace_locations أي تتبع عكسي (backtrace) مرتبط بالاستثناء. هذا التّابع شبيه للتّابع backtrace، ولكن backtrace هو مصفوفة من Thread::Backtrace::Location.

`cause`

يُعيد التّابع cause الاستثناء السابق (!$) عندما يُرمى هذا الاستثناء.

`exception`

يُعيد التّابع exception المُستقبل (receiver) إن لم يمرَّر إليه أي وسيط، أو إذا كان الوسيط الممرر إليه هو نفسه المُستقبل. خلا ذلك، يُنشئ كائن استثناءٍ جديد (exception object) من الصنف نفسه على أنّه المستقبل، ولكن مع رسالةٍ مساوية إلى string.to_str.

`full_message`

يُعيد التّابع full_message سلسلةً نصيةً منسّقةً من الاستثناء.

`inspect`

يُعيد التّابع inspect اسم صنف الاستثناء ورسالته.

`message`

يُعيد التّابع message ناتج استدعاء التّابع exception.to_s. ويُعيد هذا عادةً رسالة الاستثناء أو اسمه.

`set_backtrace`

يضبط التّابع set_backtrace معلومات المصفوفة backtrace الخاصة بكائن الاستثناء.

`to_s`

يُعيد التّابع to_s رسالة الاستثناء (أو اسم الاستثناء إذا لم يتم تعيين أي رسالة).

مصادر

صفحة الصنف Exception في توثيق روبي الرسمي.

@@ سطر 1: / سطر 1: @@
-{{DISPLAYTITLE:الصنف Exception في روبي}}
+{{DISPLAYTITLE:الصنف <code>Exception</code> في روبي}}
 تُستخدَم الكائنات السليلة من الصنف <code>Exception</code> للتواصل بين التّابع <code>Kernel.raise</code> وتصريحات <code>rescue</code> في الكتل (blocks) من الشكل begin ... end. تَحمل كائنات الصنف <code>Exception</code> معلوماتٍ عن الاستثناء المَرمي – نوعه (اسم صنف الاستثناء)، وسلسلةً نصيّةً وصفيّةً اختياريّة، ومعلوماتِ تتبّعٍ اختيارية. قد تضيف الأصناف الفرعية من الصنف <code>Exception</code> معلوماتٍ إضافيّةٍ مثل <code>[[Ruby/NameError/name|NameError.name]]</code>.
@@ سطر 67: / سطر 66: @@
 == توابع الصنف العامة (Public Class Methods) ==
-=== <code>exception</code> ===
+=== <code>[[Ruby/Exception/exception|exception]]</code> ===
 يُعيد التّابع <code>exception</code> المُستقبل (receiver) إن لم يمرَّر إليه أي وسيط، أو إذا كان الوسيط الممرر إليه هو نفسه المُستقبل. خلاف ذلك، يُنشئ كائن استثناءٍ جديد (exception object) من الصنف نفسه على أنّه المستقبل، ولكن مع رسالةٍ مساوية إلى <code>[[Ruby/String/to str|string.to_str]]</code>.
-=== <code>new</code> ===
+=== <code>[[Ruby/Exception/new|new]]</code> ===
 يُنشئ التّابع <code>new</code> كائنًا جديدًا من النّوع <code>Exception</code>، ويمرِّر رسالةً اختياريًّا إليه.
-=== <code>?to_tty</code> ===
+=== <code>[[Ruby/Exception/to tty-3F|?to_tty]]</code> ===
 يتحقّق التّابع <code>?to_tty</code> فيما إذا كانت رسائل الاستثناء ستُرسل إلى الطرفية <code>tty</code>.
 == توابع الكائن العامة (Public Instance Methods) ==
-=== <code>==</code> ===
+=== <code>[[Ruby/Exception/3D-3D|==]]</code> ===
 يتحقق المعامل <code>==</code> من تساوي كائني استثناء مع بعضهما بعضًا.
-=== <code>backtrace</code> ===
+=== <code>[[Ruby/Exception/backtrace|backtrace]]</code> ===
 يُعيد التّابع <code>backtrace</code> أيَّ تتبّعٍ عكسيٍّ (backtrace) مرتبطٍ بالاستثناء.
-=== <code>backtrace_locations</code> ===
+=== <code>[[Ruby/Exception/backtrace locations|backtrace_locations]]</code> ===
 يُعيد التّابع <code>backtrace_locations</code> أي تتبع عكسي (backtrace) مرتبط بالاستثناء. هذا التّابع شبيه للتّابع <code>backtrace</code>، ولكن <code>backtrace</code> هو مصفوفة من <code>Thread::Backtrace::Location</code>.
-=== <code>cause</code> ===
+=== <code>[[Ruby/Exception/cause|cause]]</code> ===
 يُعيد التّابع <code>cause</code> الاستثناء السابق (!$) عندما يُرمى هذا الاستثناء.
@@ سطر 93: / سطر 92: @@
 يُعيد التّابع <code>exception</code> المُستقبل (receiver) إن لم يمرَّر إليه أي وسيط، أو إذا كان الوسيط الممرر إليه هو نفسه المُستقبل. خلا ذلك، يُنشئ كائن استثناءٍ جديد (exception object) من الصنف نفسه على أنّه المستقبل، ولكن مع رسالةٍ مساوية إلى <code>[[Ruby/String/to str|string.to_str]]</code>.
-=== <code>full_message</code> ===
+=== <code>[[Ruby/Exception/full message|full_message]]</code> ===
 يُعيد التّابع <code>full_message</code> سلسلةً نصيةً منسّقةً من الاستثناء.
-=== <code>inspect</code> ===
+=== <code>[[Ruby/Exception/inspect|inspect]]</code> ===
 يُعيد التّابع <code>inspect</code> اسم صنف الاستثناء ورسالته.
-=== <code>message</code> ===
+=== <code>[[Ruby/Exception/message|message]]</code> ===
 يُعيد التّابع <code>message</code> ناتج استدعاء التّابع <code>[[Ruby/Exception/to s|exception.to_s]]</code>. ويُعيد هذا عادةً رسالة الاستثناء أو اسمه.
-=== <code>set_backtrace</code> ===
+=== <code>[[Ruby/Exception/set backtrace|set_backtrace]]</code> ===
 يضبط التّابع <code>set_backtrace</code> معلومات المصفوفة <code>backtrace</code> الخاصة بكائن الاستثناء.
-=== <code>to_s</code> ===
+=== <code>[[Ruby/Exception/to s|to_s]]</code> ===
 يُعيد التّابع <code>to_s</code> رسالة الاستثناء (أو اسم الاستثناء إذا لم يتم تعيين أي رسالة).