عرض مصدر Python/scopes-and-namespaces

<noinclude>{{DISPLAYTITLE:مجالات الأسماء والنطاقات في بايثون}}</noinclude>
مجال الأسماء هو رابط بين الأسماء والكائنات، وتستخدم معظم مجالات الأسماء في الوقت الحاضر [[Python/dict|كقواميس]]. ومن الأمثلة على مجالات الأسماء: مجموعة الأسماء الداخلية (وتتضمن الدوال مثل <code>[[Python/abs|abs()]]</code>‎، وأسماء [[Python/built-in exceptions|الاستثناءات الداخلية]])، والأسماء العامة (global) في وحدة معينة، والأسماء المحلية (local) في بنية دالّة ما. إضافة إلى ما سبق، يمكننا أن نعدّ مجموعة خاصيات (attributes) كائن معيّن مجالًا للأسماء أيضًا.

والمقصود بالخاصيات هنا كل ما يأتي بعد النقطة، فعلى سبيل المثال في التعبير <code>z.real</code> تعدّ <code>real</code> خاصية للكائن <code>z</code>. كذلك تعدّ الإشارات إلى الأسماء في [[Python/modules|الوحدات]] إشارات للخاصيات، ففي التعبير <code>modname.funcname</code>، تكون <code>modname</code> كائن وحدة و<code>funcname</code> خاصّية له. 

إنّ أهمّ ما يجب معرفته عن مجالات الأسماء هو عدم وجود أي علاقة تربط بين الأسماء في مجالات الأسماء المختلفة، فعلى سبيل المثال، يمكن [[Python/modules|لوحدتين]] مختلفتين أن تعرّفا دالة باسم <code>maximize</code> دون حدوث أيّ تضارب، ولكن يجب إضافة اسم الوحدة قبل اسم الدالة عند استخدامها في الشيفرة البرمجية.

في هذه الحالة هناك رابط مباشر بين خاصيات الوحدة والأسماء العامة والمعرّفة في [[Python/modules|الوحدة]]، وهو أنّها تشترك مع بعضها البعض بمجال أسماء واحد.

تنشأ مجالات الأسماء في أوقات مختلفة وتمتلك أعمارًا مختلفة أيضًا. فمجال الأسماء الذي يضمّ الأسماء الداخلية ينشأ عند بدء تشغيل [[Python/interpreter|مفسّر بايثون]] ولا يُحذف على الإطلاق. أما مجال الأسماء العام الخاص [[Python/modules|بوحدة]] معينة فينشأ عند تعريف تلك [[Python/modules|الوحدة]] ضمن الشيفرة، وعادة ما يبقى مجال الأسماء هذا إلى حين إغلاق مفسّر بايثون. 

تكون الشيفرات البرمجية المنفّذة بواسطة الاستدعاء ذي المستوى العالي (top-level invocation) في مفسّر بايثون، سواء أكان مصدر هذه الشيفرات ملف مستقلًّا أو ضمن المفسّر نفسه، جزءًا من وحدة تدعى <code>__main__</code>؛ لذا تمتلك هذه الشيفرات مجال أسماء عام، وكذلك الأمر بالنسبة للأسماء الداخلية، إذ أنّها جزء من وحدة خاصة تحمل الاسم <code>builtins</code>.

ينشأ مجال الأسماء المحلي الخاص بدالة معيّنة عند استدعاء تلك الدالة، ويحذف عندما تعيد [[Python/defining-functions|الدالة]] قيمة معيّنة أو تطلق [[Python/exceptions|استثناء]] لا تجري معالجته داخل [[Python/defining-functions|الدالة]].

تمتلك الاستدعاءات التعاودية (recursive invocations) مجال أسماء خاص بكل واحد منها.

== النطاق scope ==
النطاق هو جزء من شيفرة بايثون يمكن فيه الوصول إلى مجال الأسماء بصورة مباشرة، والمقصود بذلك هو أنّ الإشارة غير المؤهّلة لاسم معيّن تدفع اللغة إلى البحث عن ذلك الاسم في مجال الأسماء.

وبالرغم من أن النطاقات تحدّد بطريقة سكونية، إلا إنّها تستخدم بطريقة ديناميكية. ففي أي لحظة من لحظات تنفيذ الشيفرة، هناك ما لا يقل عن ثلاثة مجالات متداخلة يمكن الوصول إلى مجالات الأسماء فيها بصورة مباشرة:
* النطاق الداخلي، والذي يجري فيه البحث أوّلًا، ويضمّ الأسماء المحلية.
* النطاقات الخاصّة بأي دالة محيطة، والتي يجري البحث فيها بدءًا من أقرب نطاق محيط، تضمّ أسماء غير محلّية ولكن غير عامّة أيضًا.
* يضمّ النطاق ما قبل الأخير الأسماء العامّة للوحدة الحالية.
* النطاق الخارجي (يجري البحث فيه آخرًا) وهو مجال الأسماء الذي يضمّ الأسماء الداخلية
إن كان الاسم المصرّح عنه عامًّا، فإنّ جميع الإشارات وعمليات الإسناد تذهب مباشرة إلى النطاق الأوسط الذي يضمّ الأسماء العامّة في [[Python/modules|الوحدة]].

يمكن استخدام العبارة <code>nonlocal</code> لإعادة ربط المتغيّرات الموجودة خارج النطاق الداخلي، وفي حال عدم استخدام هذه العبارة فإنّ المتغيرات ستكون للقراءة فقط (read-only). وتؤدّي أي محاولة للكتابة على هذه المتغيرات إلى إنشاء متغيّر محلي جديد في النطاق الداخلي دون المساس بالمتغيّر الخارجي الذي يحمل الاسم نفسه.

في العادة يشير النطاق المحلي إلى الأسماء المحلية للدالة الحالية، أما خارج الدوال فيشير النطاق المحلي إلى نفس مجال الأسماء الذي يشير إليه النطاق العام، وهو مجال الأسماء الخاص [[Python/modules|بالوحدة]]، ويؤدي تعريف أصناف جديدة إلى إضافة مجال أسماء جديد إلى النطاق المحلي.

إنّه لمن الضروري إدراك أنّ تحديد النطاقات يكون نصّيًا، بمعنى أنّ النطاق العام الخاصّ بدالة معيّنة ومعرّفة في [[Python/modules|وحدة]] معينة هو مجال الأسماء الخاص بتلك الوحدة بغض النظر عن مكان استدعاء [[Python/defining-functions|الدالة]] أو الاختصار المستخدم لذلك. 

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

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

في الواقع تستخدم جميع العمليات التي تقدّم أسماء جديدة النطاقَ المحلي، وعلى وجه الخصوص تعمل عبارات <code>import</code> [[Python/defining-functions|وتعاريف الدوال]] على ربط [[Python/modules|الوحدات]] أو اسم الدالة في النطاق المحلي.

يمكن استخدام عبارة <code>global</code> للإشارة إلى أن المتغيّر موجود في النطاق العام وأن إعادة الربط يجب أن تتم في ذاك النطاق. كذلك يمكن استخدام العبارة <code>nonlocal</code> للإشارة إلى أن المتغير موجود في نطاق محيط وأنّ إعادة تعريفه يجب أن تكون في ذاك النطاق.

== أمثلة على النطاقات ومجالات الأسماء ==
يوضح المثال التالي كيفية الإشارة إلى نطاقات ومجالات أسماء مختلفة، وكيف تؤثر عبارتا <code>global</code> و <code>nonlocal</code> على عملية ربط المتغيرات:<syntaxhighlight lang="python3">
def scope_test():
    def do_local():
        spam = "local spam"
    def do_nonlocal():
        nonlocal spam
        spam = "nonlocal spam"
    def do_global():
        global spam
        spam = "global spam"
    spam = "test spam"
    do_local()
    print("After local assignment:", spam)
    do_nonlocal()
    print("After nonlocal assignment:", spam)
    do_global()
    print("After global assignment:", spam)
scope_test()
print("In global scope:", spam)

</syntaxhighlight>تعطي الشيفرة السابقة المخرجات التالية:<syntaxhighlight lang="text">
After local assignment: test spam
After nonlocal assignment: nonlocal spam
After global assignment: nonlocal spam
In global scope: global spam

</syntaxhighlight>لاحظ كيف أنّ الإسناد المحلي (وهو الافتراضي) لم يغيّر ربط [[Python/defining-functions|الدالة]] <code>scope_test()</code>‎ بالمتغيّر <code>spam</code>. أما عملية الإسناد المسبوقة بعبارة <code>nonlocal</code> فقد غيّرت ربط [[Python/defining-functions|الدالة]] بالمتغير <code>spam</code>، أما عبارة <code>global</code> فقد غيّرت الربط على مستوى [[Python/modules|الوحدة]] ككل.

لاحظ كذلك أنّه لم يكن هناك أي ربط مسبق مع المتغير <code>spam</code> قبل عملية الإسناد العامّة.

== مصادر ==
* صفحة [https://docs.python.org/3/tutorial/classes.html#python-scopes-and-namespaces Classes] في توثيق بايثون الرسمي.
[[تصنيف:Python]]
[[تصنيف:Python Classes]]