عرض مصدر Python/built-in exceptions

<noinclude>{{DISPLAYTITLE:الاستثناءات المضمنة داخليًا في بايثون}}</noinclude>
يجب أن تكون جميع الاستثناءات في لغة بايثون مُنشأة من صنف مُشتق من الصنف <code>[[#BaseException|BaseException]]</code>. عند ذكر صنف مُحدد في جملة <code>except</code> خلال تعبير <code>[[Python/exceptions|try]]</code>، فإن جملة <code>except</code> تُعالج أي استثناء مُشتق من ذلك الصنف المُحدَّد (وليس الاستثناءات المُشتقة من الصنف الذي اُشتقت منه). إذا كان لدينا صنفا استثناءات غير مرتبطين بعلاقة وراثة فهما غير متماثلان حتى لو كانا بنفس الاسم.

من الممكن توليد الاستثناءات الداخلية المذكورة بالأسفل بواسطة مُفسر بايثون أو الدوال الداخلية.  تملك الاستثناءات "قيمة مرتبطة" تُشير بالتفصيل للسبب الرئيسي للخطأ إلا إذ ذُكِرَ خلاف ذلك. من الممكن أن تكون هذه القيمة عبارة عن [[Python/str|نص]] أو [[Python/tuples|صف]] (tuple) معلومات يتألف من عدة عناصر (مثال، رمز الخطأ ونص يصف الرمز). عادةً ما تُمرر القيمة المرتبطة كوسائط للدالة البانية لصنف الاستثناء.

من الممكن إطلاق الاستثناءات الداخلية خلال الشيفرة البرمجية بشكل مباشر. يُمكن استخدام ذلك لاختبار مُعالج استثناء أو لإبراز خطأ في شرط ما تمامًا كما في حالة قيام المُفسر بإطلاق  نفس الخطأ، ولكن يجب الانتباه الى أنه لا يوجد ما يمنع الشيفرة من إطلاق خطأ غير مناسب.

قد تُستخدم الاستثناءات الداخلية في تعريف استثناءات جديدة بواسطة وراثة الأصناف. يُنصح المبرمجون بأن يشتقوا استثناءاتٍ جديدةً من الصنف <code>[[#Exception|Exception]]</code> أو أحد الأصناف الفرعية منه وليس من الصنف <code>[[#BaseException|BaseException]]</code>. مزيدٌ من المعلومات حول تعريف الاستثناءات متاحٌ في صفحة [[Python/user-defined_exceptions|الاستثناءات المعرفة من طرف المستخدم.]]

عند إطلاق (أو إعادة إطلاق) استثناء ما في جملة <code>except</code> او <code>finally</code> فإن الخاصية <code>__context__</code> ستُضبَط تلقائيًا إلى قيمة آخر استثناء مُلتقط، وإذا لم يُعالج ظهور استثناء جديد فإن نص سلسلة تتبع الاستثناءات (traceback) سيتضمن الاستثناءات المُسَببة بالإضافة للاستثناء الأخير.

عند إطلاق استثناء جديد (بدلًا من استخدام <code>raise</code> لإعادة إطلاق الاستثناء المُعالج حاليًا)، فإنه من الممكن إضافة السبب الصريح لسياق الاستثناء المُضمن من خلال استخدام جملة <code>raise</code> مع <code>from</code> بالشكل التالي:<syntaxhighlight lang="python">
raise new_exc from original_exc

</syntaxhighlight>في المثال التالي يتم إطلاق الاستثناء <code>[[#ArithmeticError|ArithmeticError]]</code> في البداية، ولمّا كان الاستثناء ليس له استثناء مُسبب فسيكون السياق الخاص به المتمثل بالخاصية <code>__context__</code> ذات قيمة <code>None</code>، بينما الاستثناء <code>[[#AsserionError|AsserionError]]</code> تم إطلاقه باستخدام الجملة <code>raise...from</code> وتم تحديد الاستثناء الأول كمسبب له، لذلك فإن الخاصية <code>__context__</code> للاستثناء <code>[[#AsserionError|AsserionError]]</code> سيكون هو <code>[[#ArithmeticError|ArithmeticError]]</code>، وعند طباعته ستظهر جملة الاستثناء <code>y should not be equal to 2</code>.<syntaxhighlight lang="python">
y = 2
try:
  if y==2:
    raise ArithmeticError("y should not be equal to 2")
except Exception as e1:
  print(e1.__context__)
  try:
    raise AssertionError("Assertion message") from e1
  except AssertionError as e2:
    print(e2.__context__)

</syntaxhighlight>التعبير الذي يلي كلمة <code>from</code> يجب أن يكون استثناءً أو القيمة <code>None</code>، إذ سيُضبَط قيمةً للخاصية <code>__cause__</code> في الاستثناء الذي سيُطلَق. ستُضبَط قيمة الخاصية <code>__suppress_context__</code> ضمنيًا لتأخذ القيمة <code>True</code> عند ضبط قيمة الخاصية <code>__cause__</code> ، وبذلك فإن استخدام <code>raise new_exc from None</code> سيُبدِّل الاستثناء القديم إلى الجديد لأغراض العرض (مثال، تحويل الاستثناء <code>[[#KeyError|KeyError]]</code> إلى <code>[[#AttributeError|AttributeError]]</code> بينما يُترك الاستثناء القديم متاحًا في الخاصية <code>__context__</code> لأغراض الفحص في التنقيح).

تقوم سلسلة تتبع الاستثناءات (traceback) بعرض سلسلة الأخطاء التي تظهر بالإضافة للاستثناء نفسه. سَتُعرض سلسلة الاستثناء (traceback) الصريحة في الخاصية <code>__cause__</code> دائمًا إذا كانت موجودة. لكن سَتُعرض سلسلة الاستثناء الضمنية في الخاصية <code>__context__</code> إذا كانت قيمة الخاصية <code>__cause__</code> هي <code>None</code> وقيمة الخاصية <code>__suppress_context__</code> هي <code>false</code>.

بغض النظر عن أي حالة، سيُعرَض الاستثناء بعد أي سلسلة استثناءات بحيث يكون آخر سطر من سلسلة تتبع الاستثناء (traceback) هو سطر الاستثناء الذي تم إطلاقه.
==الأصناف الأساسية==
تُستخدم الاستثناءات التالية في الغالب كأصناف أساسية لاستثناءات أخرى في بايثون.
===<code>BaseException</code>===
الصنف الأساسي لكافة الاستثناءات الداخلية. ليس الهدف أن نرث منه مباشرةً بواسطة الأصناف المُعرفة من طرف المستخدم (عليك أن تستخدم لذلك الأمر الصنفَ <code>[[#Exception|Exception]]</code>). إذا اُستدعيت الدالة <code>[[Python/str|str()‎]]</code> من قبل نُسخة من هذا الصنف، فسيتم إعادة معطيات النُسخة أو نص فارغ في حالة عدم وجود وسائط.

<code>args</code>

[[Python/tuples|صف]] (tuple) من الوسائط المُمرَّرة للدالة البانية للاستثناء. بعض الاستثناءات المُضمَّنة مسبقًا في اللغة (مثل <code>[[#OSError|OSError]]</code>) تتوقع عددًا مُحددًا من الوسائط، بينما الاستثناءات الأخرى تُستدعى في العادة باستخدام سلسلة نصية تُمثل رسالة الخطأ.

<code>with_traceback(tb)‎</code>

يعمل هذا التابع على جعل <code>tb</code> كسلسلة تتبع الاستثناء الجديدة (traceback) للاستثناء وتُعيد الكائن الذي يُمثل الاستثناء. ويُستخدم هذا التابع غالبًا في معالجة الاستثناء بالشكل التالي:<syntaxhighlight lang="python">
try:
    ...
except SomeException:
    tb = sys.exc_info()[2]
    raise OtherException(...).with_traceback(tb)

</syntaxhighlight>
===<code>Exception</code>===
جميع الاستثناءات الداخلية واستثناءات non-system-exiting مُشتقة من هذا الصنف. جميع الاستثناءات المبنية من طرف المستخدم يجب أن تُشتق من هذا الصنف.
===<code>ArithmeticError</code>===
هذا الصنف هو أساس الاستثناءات الداخلية التي تُطلق عند حدوث الأخطاء الحسابية: <code>[[#OverflowError|OverflowError]]</code> و <code>[[#ZeroDivisionError|ZeroDivisionError]]</code> و <code>[[#FloatingPointError|FloatingPointError]]</code>.
===<code>BufferError</code>===
يُطلق هذا الاستثناء اذا كانت هناك عملية لها علاقة بالذاكرة لا يُمكن تنفيذها.
===<code>LookupError</code>===
هذا الصنف هو الصنف الأساسي للاستثناءات التي تُطلق عندما يفشل استخدام مفتاح أو فهرس غير صالح في عملية ربط (mapping) أو في تسلسل (sequence):‏ <code>[[#IndexError|IndexError]]</code> و <code>[[#KeyError|KeyError]]</code>. يمكن أن يُطلق هذا الاستثناء مباشرةً باستخدام codecs.lookup()‎.
=الاستثناءات العملية=
تُطلق الاستثناءات التالية غالبًا في بايثون:
===<code>AssertionError</code>===
يُطلق هذا الاستثناء عندما يفشل تنفيذ جملة <code>assert</code>.
===<code>AttributeError</code>===
يُطلق هذا الاستثناء عند فشل ربط خاصية أو فشل الإشارة إليها (انظر الاشارة إلى الخاصيات).  سيُطلق الاستثناء <code>TypeError</code> عندما لا يدعم كائن ما الاشارة لخاصية أو ربط قيمة لها.
===<code>EOFError</code>===
يُطلق هذا الاستثناء عندما يتحقق شرط نهاية الملف EOF في الدالة <code>[[Python/input|input()‎]]</code>. تُعيد التوابع <code>io.IOBase.read()‎</code> و <code>io.IOBase.readline()‎</code> نصًا فارغًا عند تحقق شرط نهاية الملف.
===<code>FloatingPointError</code>===
يُطلق عند فشل عملية حسابية [[Python/float|لأرقام تحتوي على نقطة عائمة]] floating point. هذا الاستثناء مُعرف دائمًا، ولكنه يُطلق فقط عند ضبط بايثون مع الخيار <code>‎--with-fpectl</code>، او عندما يُعرَّف الرمز <code>WANT_SIGFPE_HANDLER</code> في الملف <code>pyconfig.h</code>.
===<code>GeneratorExit</code>===
يطلق عند إغلاق مولد أو coroutine. انظر إلى <code>generator.close()</code>‎ و <code>coroutine.close()‎</code>. يرث هذا الاستثناء من الصنف <code>[[#BaseException|BaseException]]</code> بدلًا من <code>Exception</code> لأنه تقنيًا ليس بخطأ.
===<code>ImportError</code>===
يُطلق هذا الاستثناء عندما تواجه جملة الاستيراد <code>[[Python/packages|import]]</code> مشاكل في محاولة تحميل وحدة. بالإضافة لذلك، يُطلق الاستثناء عندما تحتوي جملة <code>from ... import</code> على اسم لا يمكن إيجاده.

يُمكن ضبط الخاصيات <code>name</code> و <code>path</code> كوسائط على شكل كلمات مفتاحية فقط (keyword-only arguments) إلى الدالة البانية للاستثناء. عند ضبطهما، فإن الاسم <code>name</code> يُمثل الوحدة التي فشل محاولة استيرادها، ويُمثل المسار <code>path</code> مسار الملف الذي أطلق الاستثناء.
===<code>ModuleNotFoundError</code>===
هذا الاستثناء هو صنف فرعي من <code>[[#ImportError|ImportError]]</code> ويُطلق بواسطة <code>import</code> عندما لا يُمكن تحديد مكان وحدة ما. يُطلق هذا الاستثناء أيضًا عندما تُوجد القيمة <code>None</code> في <code>sys.modules</code>.

هذا الاستثناء جديدٌ في نسخة بايثون 3.6.
===<code>IndexError</code>===
يُطلق هذا الاستثناء عند استخدام فهارس خارج النطاق. (تُعدل فهارس الاقتطاع تلقائيًا لتقع ضمن النطاق المسموح به؛ إذا كان الفهرس ليس رقمًا، فسيُطلق الاستثناء <code>[[#TypeError|TypeError]]</code>).
===<code>KeyError</code>===
يُطلق هذا الاستثناء عند استخدام مفتاح غير موجود ضمن مفاتيح [[Python/dict|قاموس]] ما.
===<code>KeyboardInterrupt</code>===
يُطلق هذا الاستثناء عند استعمال مُفتاح المقاطعة (interrupt key) (عادة <code>Control-C</code> أو <code>Delete</code>). تُنفذ فحوصات المقاطعة بشكل منتظم خلال عملية التنفيذ. يرث هذا الاستثناء من الصنف <code>BaseException</code> حتى لا يُلتقط من الشيفرة التي تلتقط الاستثناء <code>Exception</code> وبذلك يُمنع المفسر من الخروج.
===<code>MemoryError</code>===
يُطلق هذا الاستثناء عندما تَستهلك عمليةٌ ما الذاكرةَ مع إمكانية معالجة المشكلة بحذف بعض الكائنات. القيمة المرتبطة بهذا الاستثناء هي نص يشير الى نوعية العملية التي استهلكت الذاكرة. لاحظ أنه بسبب هيكلية إدارة الذاكرة الكامنة (الدالة <code>malloc()‎</code> في لغة C)، فإن المُفسر قد لا يستطيع معالجة هذا الموقف بشكل كامل؛ ومع ذلك، سيُطلق المفسر استثناءً بحيث تُطبع سلسلة تتبع الاستثناءات (stack traceback) في حالة أن السبب هو برنامج طويل التنفيذ.
===<code>NameError</code>===
يُطلق هذا الاستثناء عندما لا يمكن إيجاد اسم عام أو محلي، وهذا ينطبق فقط على الأسماء غير المعرفة بشكل كامل (unqualified). القيمة المرتبطة بهذا الاستثناء هي رسالة خطأ تحتوي على الاسم الذي لا يمكن إيجاده.
===<code>NotImplementedError</code>===
يُشتق هذا الاستثناء من الصنف <code>RuntimeError</code>. يجب على التوابع المجردة (abstract) في الأصناف المُعرفة من قبل المستخدم إطلاق هذا الاستثناء عندما تتطلب الأصناف المُشتقة إعادة تعريف التابع، أو عندما يكون الصنف طُوِّرَ للإشارة الى أن تُضاف شيفرة الإعتماد (implementation).

ملاحظة: لا ينبغي استخدام الاستثناء للاشارة إلى أن عاملًا أو تابعًا ما ليسا للاستخدام؛ في هذه الحالة اترك العامل أو التابع دون تعريف، أو اضبطه إلى القيمة <code>None</code> (إذا كان صنفًا فرعيًا).

ملاحظة: لا يُستخدم الصنفان <code>NotImplementedError</code> و <code>NotImplemented</code> تبادليًا، حتى وإن كانا بأسماء وأغراض متشابهة، لمعرفة المزيد انظر الى توثيق الصنف <code>[[#NotImplemented|NotImplemented]]</code>.
===<code>OSError([arg])‎</code>===
===<code>OSError(errno, strerror[, filename[, winerror[, filename2]]])‎</code>===
يُطلق هذا الاستثناء عندما تُعيد دالة نظام خطأ له علاقة بالنظام، ويشمل ذلك فشل عمليات الإدخال/الإخراج مثل "الملف غير موجود" او "القرص ممتلئ" (غير مناسب لأنواع الوسائط غير الصحيحة أو الأخطاء العرضية).

الشكل الثاني من الدالة البانية تَضبط الخواص المتعلقة المشروحة بالأسفل. تُضبط الخاصيات بقيمة <code>None</code> عند عدم ذكرها.

للتوافقية الرجوعية (backwards compatibility)، إذا مُرِّرَت ثلاثة وسائط، فستحتوي الخاصية <code>args</code> على [[Python/tuples|صفين]] (tuple) من أول وسيطين من الدالة البانية.

تُعيد الدالة البانية في العادة صنفًا فرعيًا من <code>OSError</code>، كما هو موضح في <code>OSexception</code> بالأسفل. يعتمد الصنف الفرعي المحدد على القيمة النهائية للقيمة <code>errno</code>. يحدث ذلك فقط عند بناء <code>OSError</code> مباشرةً أو باستخدام اسم بديل (alias)، ولم يُرث خلال تصنيف فرعي.
====<code>errno</code>====
رمز خطأ رقمي من متغير C باسم <code>errno</code>.
====<code>winerror</code>====
في نظام ويندوز، يعطيك هذا رقم الخطأ المحلي (native error code) على مستوى النظام. أما في معايير POSIX، الخاصية <code>errno</code> هي ترجمة تقريبية للخطأ المحلي.

في نظام ويندوز، إذا كان الوسيط <code>winerror</code> رقمًا، فإن الخاصية <code>errno</code> تُحدد من رقم الخطأ الخاص بنظام ويندوز، ويُتجاهل الوسيط <code>errno</code>. أما في البيئات الأخرى، فسيُتجاهل الوسيط <code>winerror</code>، والخاصية <code>winerror</code> لن تكون موجودةً.
====<code>Strerror</code>====
رسالة الخطأ التي زودها نظام التشغيل. تُنسق رسالة الخطأ بواسطة الدالة perror()‎ في لغة السي في أنظمة POSIX، وبواسطة الدالة FormatMessage()‎ في نظام الويندوز.
====<code>filename</code>====
====<code>filename2</code>====
في الاستثناءات التي تنطوي على مسار ملف في النظام، الخاصية <code>filename</code> هي اسم الملف المُمَر لدوال مثل <code>open()‎</code> و <code>os.unlike()‎</code>.

للدوال التي تحتوي على مسارَي ملف مثل <code>os.rename()‎</code>، ستُمثِّل الخاصية <code>filename2</code> اسم الملف الثاني المُمَر للدالة.

التغييرات التي حدثت في إصدار بايثون 3.3: الاستثناءات <code>EnvironmentError</code> و <code>IOError</code> و <code>WindowsError</code> و <code>socket.error</code> و <code>select.error</code> و <code>mmap.error</code> دُمجت في <code>OSError</code>، والدالة البانية قد تُعيد صنف فرعي.

التغييرات التي حدثت في إصدار بايثون 3.4: الخاصية <code>filename</code> أصبحت الاسم الأصلي للملف المُمَرر للدالة، بدلًا من الاسم المُرَمز/مفكوك-ترميزه من ترميز ملف النظام. بالإضافة لذلك، أُضيف الوسيط والخاصية <code>filename2</code>.
===<code>OverflowError</code>===
يُطلق هذا الاستثناء عندما تكون نتيجة عملية حسابية كبيرة جدًا بحيث لا يمكن تمثيلها. لا يمكن أن يحدث ذلك للأرقام الصحيحة <code>integers</code> (يُطلق الاستثناء <code>MemoryError</code> لذلك). على الرغم من ذلك ولأسباب تاريخية، يُطلق الخطأ <code>OverflowError</code> في بعض الأحيان للأرقام الصحيحة التي هي خارج نطاق المطلوب. أغلب العمليات الحسابية التي تحتوي على النقطة العائمة لا تُفحص بسبب عدم وجود معيار حاكم لاستثناءات الأعداد ذات النقطة العائمة في معالجة الاستثناء في لغة C.
===<code>RecursionError</code>===
هذا الاستثناء مُشتق من الصنف <code>RuntimeError</code>، ويطلق عندما يكتشف المفسر أن العمق الأعلى للاستدعاء التعاودي (recursion depth) تم تجاوزه (انظر الى <code>sys.getrecursionlimit()‎</code>).

هذا الاستثناء جديدٌ في بايثون 3.5: في السابق كان يُطلَق الاستثناء <code>[[#RuntimeError|RuntimeError]]</code>.
===<code>ReferenceError</code>===
يُطلق هذا الاستثناء عندما يُستخدم وكيل إشارة ضعيف (weak reference proxy) مُنشأ باستخدام الدالة <code>weakref.proxy()‎</code> في الوصول لخاصية في الكائن المشار إليه في الخطأ بعد أن يكون جُمع في القمامة. لمعلومات أكثر عن التأشير الضعيف انظر الى الوحدة <code>weakref</code>.
===<code>RuntimeError</code>===
يُطلق هذا الاستثناء عندما يُكتشف خطأٌ ما لا يقع ضمن أي تصنيفات أخرى. القيمة المرتبطة هي نص يشير لماذا حدث الخطأ على وجه التحديد.
===<code>StopIteration</code>===
يُطلق بواسطة الدالة الداخلية <code>[[Python/next|next()‎]]</code> وتابع المُكَرِر ‎<code>__next__()‎</code> للإشارة أنه لا يوجد عناصر أخرى يمكن إنتاجها باستخدام المُكَرِر. كائن الاستثناء يملك خاصية وحيدة <code>value</code>،  وتُمرر كوسيط عند بناء الاستثناء وتأخذ قيمة <code>None</code>. عندما تعود دالة المولد أو coroutine، تُطلق نسخة من الاستثناء <code>StopIteration</code>، والقيمة المُعادة من الدالة تُستخدم كمعامل <code>value</code> للدالة البانية للاستثناء.

اذا عُرفت دالة المولد في حضور الموجه <code>from __future__ import generator_stop</code> فهذا سيطلق <code>StopIteration</code>، وسيحول الى <code>RuntimeError</code> (مُحتفظًا بالاستثناء <code>StopIteration</code> كمسبب للاستثناء الجديد).

التغييرات في إصدار بايثون 3.3: أُضيفت الخاصية value مع جعل دوال المولد تستخدمها لتعيد قيمة.

التغييرات في إصدار بايثون 3.5: قُدم التحويل للخطأ <code>RuntimeError</code>.
===<code>StopAsyncIteration</code>===
يجب أن يُطلق بواسطة التابع ‎<code>__anext__()</code>‎ الخاص بكائن المكرر غير المتزامن (asynchronous iterator) لإيقاف التكرار.

هذا الاستثناء جديدٌ في بايثون 3.5
===<code>SyntaxError</code>===
يُطلق عندما يكتشف المُفسِّر (parser) خطأً في الصيغة. قد يحدث ذلك في جملة الاستيراد، أو في استدعاء الدوال الداخلية <code>[[Python/exec|exec()‎]]</code> أو <code>[[Python/eval|eval()‎]]</code>، أو عند قراءة ملف السكربت أو مجرى الدخل القياسي.

نُسخ هذا الصنف تمتلك الخواص <code>filename</code> و <code>lineno</code> و <code>offset</code> و <code>text</code> لوصول أسهل للتفاصيل. يعيد التابع <code>str()‎</code> في الاستثناء الرسالة فقط.
===<code>IndentationError</code>===
الصنف الأساسي لأخطاء الصيغة المتعلقة بالإزاحة غير الصحيحة. هذا الاستثناء هو صنف فرعي من الصنف <code>[[#SyntaxError|SyntaxError]]</code>.
===<code>TabError</code>===
يُطلق عندما تحتوي الإزاحة على فراغات وعلامات جدولة متعارضة. هذا الاستثناء هو صنف فرعي من <code>[[#IndentationError|IndentationError]]</code>.
===<code>SystemError</code>===
يُطلق عندما يجد المُفسر خطأً داخليًا، ولكن الموقف لا يبدو عليه خطيرًا لدرجة فقدان الأمل. القيمة المرتبطة هي نص يشير إلى ما حدث من خطأ. يجب عليك تبليغ المسؤول عن صيانة ومتابعة مُفسر لغة بايثون المُثبّت لديك. تأكد من ذكر رقم نسخة مُفسر بايثون (يمكنك الحصول عليه من الخاصية <code>sys.version</code> ؛ تُطبع رقم النسخة أيضًا عن تشغيل جلسة بايثون تفاعلية) ورسالة الخطأ وإن أمكن مصدر البرنامج الذي أطلق الخطأ.
===<code>SystemExit</code>===
يُطلق هذا الاستثناء بواسطة الدالة <code>sys.exit()‎</code>. يرث هذا الصنف من <code>[[#BaseException|BaseException]]</code> بدلًا من <code>[[#Exception|Exception]]</code> حتى لا يُلتقط من الشيفرة التي تُعالج الاستثناء <code>[[#Exception|Exception]]</code>. هذا يسمح للاستثناء بالانتشار (propagate) بطريقة مناسبة وينهي تنفيذ المُفسر.

عندما لا يُعالج الاستثناء، فسينتهي تنفيذ مُفسر بايثون، ولا تُطبع سلسلة تتبع الاستثناءات (stack traceback). تقبل الدالة البانية نفس الوسيط المُمَرر للدالة <code>sys.exit()‎</code>. إذا كانت القيمة رقم صحيح، تُحدد حالة خروج النظام (المُمَررة للدالة <code>exit()‎</code> في لغة C)؛ إذا كانت <code>None</code>، فستأخذ حالة خروج النظام القيمة 0 وإذا كانت نوع آخر مثل سلسلة نصية، فستُطبع قيمة الكائن وتصبح حالة خروج النظام 1.

يُحَوَّل استدعاء الدالة <code>sys.exit()‎</code> إلى استثناءٍ حتى تُنفذ معالجات الخطأ (جملتي <code>finally</code> و <code>try</code> )، وحتى يُمكن للمنقح (debugger) تنفيذ سكربت ما دون فقدان التحكم في تنفيذه. من الممكن استخدام الدالة <code>os._exit()‎</code> إذا كان من الضرورة القصوى الخروج حالًا (مثل الخروج من عملية ابن للعملية الحالية بعد استدعاء <code>os.fork()‎</code>).
===<code>code</code>===
حالة الخروج أو رسالة الخطأ المُمَررة للدالة البانية (القيمة التلقائية هي <code>None</code>).
===<code>TypeError</code>===
يُطلق عندما تُطبق دالة أو عملية على كائن من نوع غير مناسب. القيمة المرتبطة هي سلسلةٌ نصيةٌ تُعطي تفاصيل عدم تطابق النوع.

قد يُطلق هذا الاستثناء بواسطة شيفرة المستخدم مباشرةً للإشارة لعدم قابلية إجراء عملية على كائن. إذا كان الكائن يدعم إجراء عملية معينة لكنها غير مبرمجة بعد، فإن الاستثناء الأفضل لذلك هو <code>NotImplementedError</code>.

تمرير وسائط ذات أنواع غير صحيحة (مثل تمرير [[Python/list|قائمة]] [list] والمتوقع هو رقم صحيح) يجب أن يطلق الاستثناء <code>TypeError</code>، ولكن تمرير وسائط بقيم غير صحيحة (مثل تمرير رقم خارج الحدود المتوقعة) يجب أن يُطلق الاستثناء <code>ValueError</code>.
===<code>UnboundLocalError</code>===
يُطلق عندما يُشار إلى متغير محلي في دالة أو تابع ولكن لم تعطَ قيمةٌ لهذا المتغير بعد. هذا الاستثناء هو صنف فرعي من <code>[[#NameError|NameError]]</code>.
===<code>UnicodeError</code>===
يُطلق هذا الاستثناء عند حدوث خطأ ترميز أو فك ترميز يتعلق بيونيكود؛ وهو صنف فرعي من الصنف <code>[[#ValueError|ValueError]]</code>.

يمتلك هذا الاستثناء خاصيات تشرح خطأ الترميز أو فك الترميز. فمثلًا، <code>err.object[err.start:err.end]‎</code> يعطي المُدخل غير الصالح الذي فشل عنده الترميز.
====<code>encoding</code>====
اسم الترميز الذي أطلق الخطأ.
====<code>reason</code>====
نص يصف خطأ الترميز بالتفصيل.
====<code>object</code>====
الكائن الذي تم محاولة ترميزه أو فك ترميزه.
====<code>start</code>====
الفهرس الأول للبيانات غير الصالحة في الكائن.
====<code>end</code>====
الفهرس بعد آخر بيانات غير الصالحة.
===<code>UnicodeEncodeError</code>===
يُطلق عند حدوث خطأ ترميز. وهو صنف فرعي من <code>[[#UnicodeError|UnicodeError]]</code>.
===<code>UnicodeDecodeError</code>===
يُطلق عند حدوث خطأ فك ترميز. وهو صنف فرعي من <code>[[#UnicodeError|UnicodeError]]</code>.
===<code>UnicodeTranslateError</code>===
يُطلق عند حدوث خطأ ترميز خلال عملية التحويل. وهو صنف فرعي من <code>[[#UnicodeError|UnicodeError]]</code>.
===<code>ValueError</code>===
يُطلق عندما تتسلم عملية داخلية أو دالة وسيط بنوع صحيح ولكن بقيمة غير مناسبة، ولا يوجد معلومات أكثر عن الخطأ من قبيل ظهور الاستثناء <code>[[#IndexError|IndexError]]</code> مثلًا.
===<code>ZeroDivisionError</code>===
يُطلق عندما يكون الوسيط الثاني من عملية القسمة أو باقي القسمة هو صفر. القيمة المرتبطة هي نص يشير إلى نوع القيم التي تجرى عليها العملية والعملية.

الاستثناءات التالية بقيت من أجل التوافقية مع نُسخ بايثون السابقة، ابتداءً من بايثون 3.3، تُعتبر أسماءً بديلةً (aliases) للاستثناء <code>[[#OSError|OSError]]</code>.
===<code>EnvironmentError</code>===
===<code>IOError</code>===
===<code>WindowsError</code>===
متاحةٌ في نظام الويندوز فقط.
==استثناءات نظام التشغيل==
الاستثناءات التالية هي أصناف فرعية من الاستثناء <code>OSError</code> وتُطلق بناءً على رقم الخطأ الصادر من النظام.
===<code>BlockingIOError</code>===
يُطلق عندما يُحجز كائنٌ (مثل <code>socket</code>) من قبل عملية ما ويكون هذا الكائن مضبوطًا لعملية غير حاجزة (non-blocking). يرتبط هذا الاستثناء بأرقام الأخطاء التالية: <code>EAGAIN</code> و <code>EALREADY</code> و <code>EWOULDBLOCK</code> و <code>EINPROGRESS</code>.

بالاضافة لما تملكه الاستثناءات <code>[[#OSError|OSError]]</code> و <code>[[#BlockingIOError|BlockingIOError]]</code> من خاصيات، توجد خاصية واحدة إضافية وهي:
===<code>characters_written</code>===
هو رقم صحيح يحتوي على عدد المحارف التي كتُبت في <code>stream</code> من قَبل حجزها. هذه الخاصية متاحة عند استخدام أصناف عمليات الإدخال والإخراج المحفوظة في الذاكرة المؤقتة والموجودة في وحدة <code>io</code>.
===<code>ChildProcessError</code>===
يُطلق هذا الاستثناء عندما يفشل إجراء ما في عملية ابن (child process). يرتبط هذا الاستثناء برقم الخطأ <code>ECHILD</code>.

=== <code>ConnectionError</code> ===
الصنف الأساسي للقضايا المتعلقة بالاتصال. الأصناف الفرعية من هذا الاستثناء هي <code>[[#BrokenPipeError|BrokenPipeError]]</code> و <code>[[#ConnectionAbortedError|ConnectionAbortedError]]</code> و <code>[[#ConnectionRefusedError|ConnectionRefusedError]]</code>  و <code>[[#ConnectionResetError|ConnectionResetError]]</code>.
===BrokenPipeError===
هذا الاستثناء هو صنف فرعي من <code>[[#ConnectionError|ConnectionError]]</code>، ويُطلق عند محاولة الكتابة في أنبوب (pipe) بينما تكون نهايته قد أُغلقت، أو عند محاولة الكتابة في <code>socket</code> قد تم وقف الكتابة فيها. يرتبط هذا الاستثناء بأرقام الخطأ <code>EPIPE</code> و <code>ESHUTDOWN</code>.
===<code>ConnectionAbortedError</code>===
هذا الاستثناء هو صنف فرعي من <code>[[#ConnectionError|ConnectionError]]</code>، ويُطلق عندما تُحبَط محاولة الاتصال من قبل الطرف الأخر. يرتبط هذا الاستثناء برقم الخطأ <code>ECONNABORTED</code>.
===<code>ConnectionRefusedError</code>===
هذا الاستثناء هو صنف فرعي من <code>[[#ConnectionError|ConnectionError]]</code>، ويُطلق عندما تُرفض محاولة الاتصال من الطرف الأخر. يرتبط هذا الاستثناء برقم الخطأ <code>ECONNREFUSED</code>.
===<code>ConnectionResetError</code>===
هذا الاستثناء هو صنف فرعي من <code>[[#ConnectionError|ConnectionError]]</code>، ويُطلق عندما يُعاد ضبط الاتصال من الطرف الأخر. يرتبط هذا الاستثناء برقم الخطأ <code>ECONNRESET</code>.
===<code>FileExistsError</code>===
يُطلق عند محاولة إنشاء ملف أو مجلد موجود مُسبقًا. يرتبط هذا الاستثناء برقم الخطأ <code>EEXIST</code>.
===<code>FileNotFoundError</code>===
يطلق هذا الاستثناء عندما يُطلب ملف أو مجلد ولكنه غير موجود. يرتبط هذا الاستثناء برقم الخطأ <code>ENOENT</code>.
===<code>InterruptedError</code>===
يطلق هذا الاستثناء عند مقاطعة إستدعاء ما من قبل النظام بواسطة إشارة قادمة (incoming signal). يرتبط هذا الاستثناء برقم الخطأ EINTR.

التغييرات في إصدار بايثون 3.5: تُعيد بايثون استدعاءات النظام عندما تُقاطَع باستخدام إشارة قادمة، إلا إذا أَطلق مُعالج الإشارة استثناءً.
===<code>IsADirectoryError</code>===
يُطلق عندما تطلب دالةٌ تجري عمليةً على ملفٍ ما (مثل <code>os.remove()‎</code>) مجلدًا ما. يرتبط هذا الاستثناء برقم الخطأ <code>EISDIR</code>.
===<code>NotADirectoryError</code>===
يُطلق عندما تُستدعى دالةٌ تجري عمليةً على مجلدٍ ما (مثل <code>(os.listdir(‎</code>) على متغير أو مُعَرف ليس بمجلد. يرتبط هذا الاستثناء برقم الخطأ <code>ENOTDIR</code>.
===<code>PermissionError</code>===
يطلق عند محاولة تشغيل عملية دون وجود صلاحيات الوصول المناسبة لذلك، مثل أذونات ملفات النظام. يرتبط هذا الاستثناء برقم الخطأ <code>EACCES</code> و <code>EPERM</code>.
===<code>ProcessLookupError</code>===
يطلق عندما تكون العملية المُمَرَّرة غير موجودة. يرتبط برقم الخطأ <code>ESRCH</code>.
===<code>TimeoutError</code>===
يُطلق عندما تنتهي مدة صلاحية دالة نظام على مستوى النظام. يرتبط هذا الاستثناء برقم الخطأ  <code>ETIMEDOUT</code>.

جميع الاستثناءات السابقة أُضيفت في بايثون 3.3 وهي أصناف فرعية من الصنف <code>[[#OSError|OSError]]</code>.
==التحذيرات==
تُستخدم الاستثناءات التالية كتحذيرات، انظر للوحدة <code>warnings</code> لمزيد من المعلومات.
===<code>Warning</code>===
الصنف الأساسي لاستثناءات التحذيرات.
===<code>UserWarning</code>===
الصنف الأساسي للتحذيرات التي تُوَلدها شيفرة المستخدم.
===<code>DeprecationWarning</code>===
الصنف الأساسي لتحذيرات الميزات المُهملة (deprecated features).
===<code>PendingDeprecationWarning</code>===
الصنف الأساسي لتحذيرات الميزات التي ستُهمل في المستقبل.
===<code>SyntaxWarning</code>===
الصنف الأساسي للتحذيرات الخاصة بالصيغ المشكوك في صحتها.
===<code>RuntimeWarning</code>===
الصنف الأساسي للتحذيرات التي تظهر أثناء تنفيذ الشيفرة البرمجية.
===<code>FutureWarning</code>===
الصنف الأساسي للتحذيرات الخاصة بالدوال البانية التي ستتغير لُغويًا في المستقبل.
===<code>ImportWarning</code>===
الصنف الأساسي للتحذيرات الخاصة بالأخطاء المُحتملة أثناء استيراد الوحدات.
===<code>UnicodeWarning</code>===
الصنف الأساسي للتحذيرات الخاصة بالترميز.
===<code>BytesWarning</code>===
الصنف الأساسي للتحذيرات الخاصة بالنوعين <code>[[Python/bytes|bytes]]</code> و <code>[[Python/bytearray|bytearray]]</code>.
===<code>ResourceWarning</code>===
الصنف الأساسي للتحذيرات الخاصة بحجم استخدام مصدر ما.

هذا الاستثناء جديدٌ في بايثون 3.2.

== مصادر ==
* [https://docs.python.org/3/library/exceptions.html صفحة Built-in Exceptions في توثيق بايثون الرسمي].
[[تصنيف:Python]]
[[تصنيف:Python Exceptions]]