المنهج الدراسي الدرس 25 من 250 · الدوال
الدوال

سلاسل النصوص التوضيحية وتلميحات النوع

لمستان صغيرتان تحولان دالة تعمل إلى دالة احترافية: docstring و type hints.

A docstring هو نص حرفي يوضع كأول سطر في جسم الدالة. هو يشرح ما تفعله الدالة. الأدوات و help() تقرأه، و Python تخزنه في function.__doc__:

def add(a, b):
    """Return the sum of a and b."""
    return a + b

print(add.__doc__)   # Return the sum of a and b.

تسمح علامات الاقتباس الثلاثة للـ docstring بالامتداد عبر أسطر متعددة، وهو أمر مفيد للشروحات الطويلة.

توضح

Type hints أنواع البيانات المتوقعة للمعاملات وقيمة الإرجاع. تكتب name: type لكل معامل و -> type لقيمة الإرجاع:

def add(a: int, b: int) -> int:
    """Return the sum of a and b."""
    return a + b

لا تفرض التلميحات أي شيء وقت التشغيل. لن تمنعك Python من تمرير سلسلة نصية. هي توثيق يستخدمه المحررون وأدوات الفحص لاكتشاف الأخطاء مبكرا، وهي تجعل التواقيع الخاصة بك واضحة بذاتها. تشمل أنواع التلميحات الشائعة int و float و str و bool.

من هنا فصاعدا، اكتب الدوال مع كل من: docstring واضح و type hints صادقة.

دورك

قم بتعريف دالة multiply مع تلميحات النوع def multiply(a: int, b: int) -> int: ووصف نصي (السطر الأول) يقرأ بالضبط Return the product of a and b.. يجب أن يقوم جسم الدالة بـ return a * b.

هل لاحظت مشكلة في هذا الدرس؟ أبلغ عنها · اسأل عن هذا الدرس

سيفتح هذا التمرين قريبا

أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.