الدوال وإطارات الاستدعاء والنتائج المُرجعة

امنح كل دالة مهمة واضحة واحدة

• الدالة تجمع مهمة مسماة. حدد مدخلاتها، وناتج الإرجاع وأي تأثير جانبي، مثل الطباعة، قبل كتابة الجسم.
• العقد يحدد ما قد يزود به المتصلون وما تعد به الدالة. هنا، المبالغ هي بنص كامل ويجب أن تكون أعدادًا صحيحة غير سالبة.

def add_fee(amount):
    """Return amount plus a fixed fee of 3 pence."""
    return amount + 3

فرّق بين اسم المدخل والكيان المدخل

• في التعريف، amount هو معامل. في add_fee(8)، التعبير 8 يزود حجة. يتم تقييم تعابير الحجة قبل تشغيل جسم الدالة.
• ربط الاستدعاء اسم المعامل بالكيان المزود. لا ينسخ هذا الكيان تلقائيًا ولا يخلق رابطًا بين اسم المتصل واسم المعامل.

amount = 4
result = add_fee(amount * 2)
print(amount, result)

احتفظ بإطار منفصل لكل استدعاء

• إطار الاستدعاء يسجل استدعاء دالة نشطًا واحدًا، بما في ذلك معلماته وأسماءه المحلية. عندما تستدعي دالة أخرى، ينتظر المتصل القيمة المرتجعة.
• اقرأ هذا البرنامج حسب ترتيب التنفيذ: المجلد → twice → add_fee → twice → المجلد. الأسهم أدناه تمثل تدفق التحكم المفاهيمي، وليست تخطيط ذاكرة فيزيائي.

def twice(amount):
    subtotal = amount * 2
    return add_fee(subtotal)

amount = 4
result = twice(amount)
print(amount, result)

أدرج نتيجة؛ اطبع رسالة

• return ينهي الاستدعاء الحالي ويعيد كائنًا للمتصل. الدالة التي تصل إلى نهايتها بدون return تُرجع None.
• print يكتب المخرجات. كما أنه يُعيد None، لذا فإن طباعة نتيجة حساب داخل دالة لا تجعل تلك النتيجة هي ما تُعاد.

def show_fee(amount):
    print(amount + 3)

value = show_fee(8)
print(value)

حل الأسماء في النطاق الصحيح

• المتغير المحلي ينتمي إلى استدعاء الدالة. يحدد النطاق أين يمكن حل الاسم؛ لا تحصل دالة أخرى تلقائيًا على الوصول إلى المتغيرات المحلية للدالة المُدعية.
• تعيين قيمة جديدة للعدد صحيح في المعامل يغير ارتباطه المحلي. ولا يعيد تعيين متغير بنفس الاسم في الدالة المُدعية.

def increase(amount):
    amount = amount + 1
    return amount

amount = 4
new_amount = increase(amount)
print(amount, new_amount)

تفكيك الحساب إلى أجزاء قابلة للاختبار

• التفكيك يفصل مهمة أكبر إلى مهام أصغر بعقود واضحة. بالنسبة لطلب، احسب المجموع الفرعي للبند، أضف رسومًا، ثم اعرض المبلغ النهائي.
• اختبر الحسابات مباشرة، بما في ذلك الكمية صفر وأكثر من بند واحد. نصّ على أن المدخلات أعداد صحيحة غير سالبة؛ يمكن أن تكون التحقق من صحة المدخلات دالة منفصلة.

def item_subtotal(unit_pence, quantity):
    return unit_pence * quantity

def order_total(unit_pence, quantity):
    return add_fee(item_subtotal(unit_pence, quantity))

شرح الاستدعاء الكامل قبل الوثوق بالإجابة

• تتبع تعابير الحجج، وروابط المعاملات، والحسابات المحلية، والقيم المُعادة. تحقق من حالة المُدعِي بعد الاستدعاء والمخرجات بشكل منفصل.
• لا تصف تمرير المعاملات بنسخ كل كائن. المجموعة القابلة للتعديل يمكن تغييرها عبر المعامل؛ تتبع مخططات الكائنات للطعن والتشابه في الوحدة 1.5.

مراجع اللغة: دوال بايثون وربط الأسماء والنطاق.