Python/constants

ثوابت في مجال الأسماء الداخلي

تقدم بايثون بعض الثوابت الموجودة في مجال الأسماء الداخلي هي:

False

يمثّل هذا الثابت القيمة الخاطئة للنوع bool. لا تسمح اللغة بإسناد أي قيمة إلى هذا الثابت وستطلق الخطأ SyntaxError عند محاولة القيام بذلك.

True

يمثّل هذا الثابت القيمة الصحيحة للنوع bool. لا تسمح اللغة بإسناد أي قيمة إلى هذا الثابت وستطلق الخطأ SyntaxError عند محاولة القيام بذلك.

None

هذا الثابت هو القيمة الوحيدة للنوع NoneType، ويستخدم None للتعبير عن غياب القيمة، كما في حالة عدم تمرير الوسائط الافتراضية إلى الدالة. لا تسمح اللغة بإسناد أي قيمة إلى هذا الثابت وستطلق الاستثناء SyntaxError عند محاولة القيام بذلك.

NotImplemented

هذا الثابت هو قيمة خاصة يجب أن تعيدها التوابع الخاصة بالنظام الثنائي (binary) مثل: ‎__eq__()‎، و ‎__lt__()‎، و ‎__add__()‎، و ‎__rsub__()‎، وغيرها، للإشارة إلى أن العملية لم تعتمد (not implemented) بالنسبة إلى النوع الآخر، ويمكن أن تعاد هذه القيمة بواسطة التوابع الموضعية (in-place) الخاصة بالنظام الثنائي مثل ‎__imul__()‎ و ‎__iand__()‎ وغيرها، للسبب عينه. القيمة الصحيحة لهذا الثابت هي True.

ملاحظة:

عندما يعيد تابع ثنائي (أو موضعي) القيمة NotImplemented فإنّ مفسّر بايثون سيحاول إجراء العملية المعكوسة على النوع الآخر (أو أي طريقة دعم تراجعي أخرى وذلك حسب نوع العامل المستخدم). إن أعادت جميع المحاولات القيمة NotImplemented، يطلق المفسّر الاستثناء المناسب. 

تؤدي إعادة القيمة NotImplemented بطريقة خاطئة إلى ظهور رسالة خطأ قد تكون مضلّلة أو يمكن أن تعاد قيمة NotImplemented إلى شيفرة بايثون.

ملاحظة:

يجب التمييز بين NotImplementedError و NotImplemented بالرغم من أنّ لهما اسمين متشابهين ويستخدمان للغرض ذاته. راجع NotImplementedError للمزيد من التفاصيل حول كيفية استخدامه.

Ellipsis

هذا الثابت مشابه لـ ...، وهو قيمة خاصة يستخدم غالبًا مع عبارات الاقتطاع الموسّعة الخاصة بأنواع حاويات البيانات المعرّفة من قبل المستخدم.

__debug__

يحمل هذا الثابت القيمة True إن جرى تشغيل بايثون دون استخدام الخيار ‎-O في سطر الأوامر. راجع أيضًا عبارة assert.

ملاحظة:

لا يمكن إعادة إسناد قيم إلى الثوابت None، False، True و __debug__، وتؤدي محاولة إسناد أي قيمة لها حتى في أسماء الخاصيات إلى إطلاق الخطأ SyntaxError، لذا يمكن أن نعتبر أنّ هذه الثوابت هي ثوابت صحيحة.

ثوابت تضيفها الوحدة site

يجري استيراد الوحدة site عند بدء تشغيل مفسّر بايثون بصورة تلقائية، إلا إذا استُخدم الخيار ‎-S في سطر الأوامر، وتضيف هذه الوحدة عددًا من الثوابت إلى مجال الأسماء الداخلي. هذه الثوابت مفيدة في مفسر بايثون التفاعلي ولا يجوز استخدامها في البرامج الاعتيادية.

exit(code=None)‎

هي كائنات تطبع عند استخدامها رسالة مثل "Use quit() or Ctrl-D (i.e. EOF) to exit" وعند استدعائها تطلق الاستثناء SystemExit مع شيفرة الخروج المحدّدة code.

credits

هي كائنات تؤدي طباعتها أو استدعاءها إلى طباعة نص حقوق النشر أو جملة الشكر والتقدير.

license

كائن عند طباعته يطبع الرسالة "Type license() to see the full license text" وعند استدعائه يعرض الترخيص الكامل على شكل صفحات.

مصادر

صفحة Built-in Constants في توثيق بايثون الرسمي.