الفرق بين المراجعتين ل"Python/constants"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'== ثوابت في مجال الأسماء الداخلي == تقدم بايثون بعض الثوابت الموجودة في مجال الأسماء الداخلي ه...')
 
 
(13 مراجعة متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
 +
تقدم بايثون مجموعة من الثوابت، بعضها في [[Python/scopes-and-namespaces|مجال الأسماء]] الداخلي، أما البعض الآخر فيضاف من قبل [[Python/modules|الوحدة]] <code>site</code> إلى [[Python/interpreter|مفسّر بايثون]] التفاعلي.<noinclude>{{DISPLAYTITLE:الثوابت في بايثون}}</noinclude>
 
== ثوابت في مجال الأسماء الداخلي ==
 
== ثوابت في مجال الأسماء الداخلي ==
تقدم بايثون بعض الثوابت الموجودة في مجال الأسماء الداخلي هي:
 
 
 
=== <code>False</code> ===
 
=== <code>False</code> ===
يمثّل هذا الثابت القيمة الخاطئة للنوع <code>[[Python/boolean|bool]]</code>. لا تسمح اللغة بإسناد أي قيمة إلى هذا الثابت وستطلق الخطأ <code>[[Python/syntax-errors|SyntaxError]]</code> عند محاولة القيام بذلك.
+
يمثّل هذا الثابت القيمة الخاطئة للنوع <code>[[Python/boolean|bool]]</code>. لا تسمح اللغة بإسناد أي قيمة إلى هذا الثابت وستطلق الخطأ <code>[[Python/built-in exceptions#SyntaxError|SyntaxError]]</code> عند محاولة القيام بذلك.
  
 
=== <code>True</code> ===
 
=== <code>True</code> ===
يمثّل هذا الثابت القيمة الصحيحة للنوع <code>[[Python/boolean|bool]]</code>. لا تسمح اللغة بإسناد أي قيمة إلى هذا الثابت وستطلق الخطأ <code>[[Python/syntax-errors|SyntaxError]]</code> عند محاولة القيام بذلك.
+
يمثّل هذا الثابت القيمة الصحيحة للنوع <code>[[Python/boolean|bool]]</code>. لا تسمح اللغة بإسناد أي قيمة إلى هذا الثابت وستطلق الخطأ <code>[[Python/built-in exceptions#SyntaxError|SyntaxError]]</code> عند محاولة القيام بذلك.
  
 
=== <code>None</code> ===
 
=== <code>None</code> ===
هذا الثابت هو القيمة الوحيدة للنوع <code>NoneType</code>، ويستخدم <code>None</code> للتعبير عن غياب القيمة، كما في حالة عدم تمرير [[Python/arguments|الوسائط]] الافتراضية إلى الدالة. لا تسمح اللغة بإسناد أي قيمة إلى هذا الثابت وستطلق الاستثناء <code>SyntaxError</code> عند محاولة القيام بذلك.
+
هذا الثابت هو القيمة الوحيدة للنوع <code>NoneType</code>، ويستخدم <code>None</code> للتعبير عن غياب القيمة، كما في حالة عدم تمرير [[Python/arguments|الوسائط]] الافتراضية إلى الدالة. لا تسمح اللغة بإسناد أي قيمة إلى هذا الثابت وستطلق الاستثناء <code>[[Python/built-in exceptions#SyntaxError|SyntaxError]]</code> عند محاولة القيام بذلك.
  
 
=== <code>NotImplemented</code> ===
 
=== <code>NotImplemented</code> ===
سطر 16: سطر 15:
 
'''ملاحظة:'''
 
'''ملاحظة:'''
  
عندما يعيد تابع ثنائي (أو موضعي) القيمة <code>NotImplemented</code> فإنّ مفسّر بايثون سيحاول إجراء العملية المعكوسة على النوع الآخر (أو أي طريقة دعم تراجعي أخرى وذلك حسب نوع العامل المستخدم). إن أعادت جميع المحاولات القيمة <code>NotImplemented</code>، يطلق المفسّر الاستثناء المناسب. 
+
عندما يعيد تابع ثنائي (أو موضعي) القيمة <code>NotImplemented</code> فإنّ مفسّر بايثون سيحاول إجراء العملية المنعكسة (reflected) على النوع الآخر (أو أي طريقة دعم تراجعي (fallback) أخرى وذلك حسب نوع العامل المستخدم). إن أعادت جميع المحاولات القيمة <code>NotImplemented</code>، فسيطلق المفسّر الاستثناء المناسب. 
  
 
تؤدي إعادة القيمة <code>NotImplemented</code> بطريقة خاطئة إلى ظهور رسالة خطأ قد تكون مضلّلة أو يمكن أن تعاد قيمة <code>NotImplemented</code> إلى شيفرة بايثون.
 
تؤدي إعادة القيمة <code>NotImplemented</code> بطريقة خاطئة إلى ظهور رسالة خطأ قد تكون مضلّلة أو يمكن أن تعاد قيمة <code>NotImplemented</code> إلى شيفرة بايثون.
سطر 22: سطر 21:
 
'''ملاحظة:'''
 
'''ملاحظة:'''
  
يجب التمييز بين <code>NotImplementedError</code> و <code>NotImplemented</code> بالرغم من أنّ لهما اسمين متشابهين ويستخدمان للغرض ذاته. راجع <code>[[Python/NotImplementedError|NotImplementedError]]</code> للمزيد من التفاصيل حول كيفية استخدامه.
+
يجب التمييز بين <code>NotImplementedError</code> و <code>NotImplemented</code> بالرغم من أنّ لهما اسمين متشابهين ويستخدمان للغرض ذاته. راجع <code>[[Python/built-in exceptions#NotImplementedError|NotImplementedError]]</code> للمزيد من التفاصيل حول كيفية استخدامه.
  
 
=== <code>Ellipsis</code> ===
 
=== <code>Ellipsis</code> ===
هذا الثابت مشابه لـ <code>...</code>، وهو قيمة خاصة يستخدم غالبًا مع عبارات الاقتطاع الموسّعة الخاصة بأنواع حاويات البيانات المعرّفة من قبل المستخدم.
+
هذا الثابت مشابه لـ <code>...</code>، وهو قيمة خاصة يستخدم غالبًا مع عبارات الاقتطاع (slicing) الموسّعة الخاصة بأنواع حاويات البيانات المعرّفة من قبل المستخدم.
  
 
=== <code>__debug__</code> ===
 
=== <code>__debug__</code> ===
 
يحمل هذا الثابت القيمة <code>True</code> إن جرى تشغيل بايثون دون استخدام الخيار ‎<code>-O</code> في سطر الأوامر. راجع أيضًا عبارة <code>[[Python/assert|assert]]</code>.
 
يحمل هذا الثابت القيمة <code>True</code> إن جرى تشغيل بايثون دون استخدام الخيار ‎<code>-O</code> في سطر الأوامر. راجع أيضًا عبارة <code>[[Python/assert|assert]]</code>.
  
ملاحظة:
+
'''ملاحظة:'''
  
لا يمكن إعادة إسناد قيم إلى الثوابت <code>None</code>، <code>False</code>، <code>True</code> و <code>__debug__</code>، وتؤدي محاولة إسناد أي قيمة لها حتى في أسماء الخاصيات إلى إطلاق الخطأ <code>[[Python/syntax-errors|SyntaxError]]</code>، لذا يمكن أن نعتبر أنّ هذه الثوابت هي ثوابت صحيحة.
+
لا يمكن إعادة إسناد قيم إلى الثوابت <code>None</code>، <code>False</code>، <code>True</code> و <code>__debug__</code>، وتؤدي محاولة إسناد أي قيمة لها حتى في أسماء الخاصيات إلى إطلاق الخطأ <code>[[Python/syntax_errors|SyntaxError]]</code>، لذا يمكن أن نعتبر أنّ هذه الثوابت هي ثوابت صحيحة (true constants).
  
 
== ثوابت تضيفها الوحدة <code>site</code> ==
 
== ثوابت تضيفها الوحدة <code>site</code> ==
يجري استيراد [[Python/modules|الوحدة]] <code>site</code> عند بدء تشغيل مفسّر بايثون بصورة تلقائية، إلا إذا استُخدم الخيار ‎-S في سطر الأوامر، وتضيف هذه الوحدة عددًا من الثوابت إلى مجال الأسماء الداخلي. هذه الثوابت مفيدة في [[Python/interpreter|مفسر بايثون]] التفاعلي ولا يجوز استخدامها في البرامج الاعتيادية.
+
يجري استيراد [[Python/modules|الوحدة]] <code>site</code> عند بدء تشغيل [[Python/interpreter|مفسّر بايثون]] بصورة تلقائية، إلا إذا استُخدم الخيار <code>‎-S</code> في سطر الأوامر، وتضيف هذه الوحدة عددًا من الثوابت إلى [[Python/scopes-and-namespaces|مجال الأسماء]] الداخلي (built-in). هذه الثوابت مفيدة في [[Python/interpreter|مفسر بايثون]] التفاعلي ولا تستخدم في البرامج الاعتيادية.
 +
 
 +
=== <code>quit(code=None)‎</code> أو <code>exit(code=None)‎</code> ===
 +
هما كائنان يؤدي استخدامها إلى عرض رسالة مثل <code>"Use quit() or Ctrl-D (i.e. EOF) to exit"</code> وعند استدعائها تطلق [[Python/exceptions|الاستثناء]] <code>[[Python/built-in exceptions#SystemExit|SystemExit]]</code> مع شيفرة الخروج المحدّدة <code>code</code>.
  
=== <code>quit(code=None)‎</code> ===
+
=== <code>copyright</code> أو <code>credits</code> ===
 +
هما كائنان يؤدي طباعتهما أو استدعاؤهما إلى عرض نص حقوق النشر أو جملة الشكر والتقدير.<syntaxhighlight lang="text">
 +
>>> copyright
 +
Copyright (c) 2001-2017 Python Software Foundation.
 +
All Rights Reserved.
  
=== <code>exit(code=None)‎</code> ===
+
Copyright (c) 2000 BeOpen.com.
هي كائنات تطبع عند استخدامها رسالة مثل <code>"Use quit() or Ctrl-D (i.e. EOF) to exit"</code> وعند استدعائها تطلق [[Python/exceptions|الاستثناء]] <code>SystemExit</code> مع شيفرة الخروج المحدّدة <code>code</code>.
+
All Rights Reserved.
  
=== <code>copyright</code> ===
+
Copyright (c) 1995-2001 Corporation for National Research Initiatives.
 +
All Rights Reserved.
  
=== <code>credits</code> ===
+
Copyright (c) 1991-1995 Stichting Mathematisch Centrum, Amsterdam.
هي كائنات تؤدي طباعتها أو استدعاءها إلى طباعة نص حقوق النشر أو جملة الشكر والتقدير.
+
All Rights Reserved.
 +
</syntaxhighlight>
  
 
=== <code>license</code> ===
 
=== <code>license</code> ===
كائن عند طباعته يطبع الرسالة <code>"Type license() to see the full license text"</code> وعند استدعائه يعرض الترخيص الكامل على شكل صفحات.
+
تؤدّي طباعة هذا الكائن إلى عرض الرسالة <code>"Type license() to see the full license text"</code> وعند استدعائه يعرض الترخيص الكامل على شكل صفحات.
 +
 
 +
== مصادر ==
 +
* صفحة [https://docs.python.org/3/library/constants.html Built-in Constants] في توثيق بايثون الرسمي.
 
[[تصنيف:Python]]
 
[[تصنيف:Python]]
 
[[تصنيف:Python Constants]]
 
[[تصنيف:Python Constants]]

المراجعة الحالية بتاريخ 07:38، 12 أغسطس 2018

تقدم بايثون مجموعة من الثوابت، بعضها في مجال الأسماء الداخلي، أما البعض الآخر فيضاف من قبل الوحدة site إلى مفسّر بايثون التفاعلي.

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

False

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

True

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

None

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

NotImplemented

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

ملاحظة:

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

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

ملاحظة:

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

Ellipsis

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

__debug__

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

ملاحظة:

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

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

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

quit(code=None)‎ أو exit(code=None)‎

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

copyright أو credits

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

>>> copyright
Copyright (c) 2001-2017 Python Software Foundation.
All Rights Reserved.

Copyright (c) 2000 BeOpen.com.
All Rights Reserved.

Copyright (c) 1995-2001 Corporation for National Research Initiatives.
All Rights Reserved.

Copyright (c) 1991-1995 Stichting Mathematisch Centrum, Amsterdam.
All Rights Reserved.

license

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

مصادر