عرض مصدر Python/user-defined exceptions

<noinclude>{{DISPLAYTITLE:الاستثناءات المعرفة من طرف المستخدم}}</noinclude>
يمكن للمستخدم إنشاء صنف استثناء جديد (راجع قسم [[Python/class|الأصناف في بايثون]] للمزيد من المعلومات)، ويجب أن تكون [[Python/exceptions|الاستثناءات]] [[Python/inhertance|مشتقّة من الصنف]] <code>Exception</code> سواء أكان ذلك بصورة مباشرة أو غير مباشرة.

يمكن تعريف أصناف الاستثناءات لتؤدي نفس العمل الذي يؤدّيه أيّ [[Python/class|صنف]] آخر، ولكنّها تكون في العادة بسيطة، وتقدّم في أغلب الأحيان عددًا من الخاصيات التي تسمح لمعالجات [[Python/exceptions|الاستثناءات]] باستخراج المعلومات الخاصة بالخطأ.

عند إنشاء وحدة لها القدرة على إطلاق [[Python/exceptions|استثناءات]] مختلفة، فمن الشائع إنشاء صنف أساس [[Python/exceptions|للاستثناءات]] يُعرّف بواسطة تلك الوحدة، وأصناف فرعية تعمل على إنشاء أصناف [[Python/exceptions|استثناءات]] للأنواع المختلفة من الأخطاء:<syntaxhighlight lang="python3">
class Error(Exception):
    """الصنف الأساسي للاستثناءات في هذه الوحدة"""
    pass

class InputError(Error):
    """يطلق الاستثناء عند وجود أخطاء في المدخلات.

    الخاصيات:
        expression -- التعبير الذي حصل فيه الاستثناء
        message -- تفسير الخطأ
    """

    def __init__(self, expression, message):
        self.expression = expression
        self.message = message

class TransitionError(Error):
    """يطلق هذا الخطأ عندما تحاول عملية إجراء تحويلات غير مسموح بها

    Attributes:
        previous -- الحالة قبل عملية التحويل
        next -- الحالة الجديدة
        message -- شرح سبب عدم إمكانية إجراء التحويل
    """

    def __init__(self, previous, next, message):
        self.previous = previous
        self.next = next
        self.message = message

</syntaxhighlight>تعرّف معظم [[Python/exceptions|الاستثناءات]] بأسماء تنتهي بكلمة "Error" وتشبه فيه ذلك طريقة تسمية [[Python/built-in exceptions|الاستثناءات المضمنة داخليًا في بايثون]].

تعرف معظم الوحدات القياسية استثناءاتها الخاصّة بها للتبليغ عن الأخطاء التي قد تنشأ من الدوال الخاصّة بتلك الوحدة. ويمكن الحصول على المزيد من المعلومات حول الأصناف في قسم [[Python/class|الأصناف في بايثون]].

== انظر أيضًا ==
* [[Python/syntax errors|أخطاء الصيغة في بايثون]].
* [[Python/exceptions|الاستثناءات في بايثون]].
* [[Python/built-in exceptions|الاستثناءات المضمنة داخليًا في بايثون]].
* [[Python/defining_clean-up_actions|تعريف أحداث التنظيف clean-up actions]].

== مصادر ==
* صفحة [https://docs.python.org/3/tutorial/errors.html#user-defined-exceptions Errors and Exceptions] في توثيق بايثون الرسمي.
[[تصنيف:Python]]
[[تصنيف:Python Exceptions]]