سلاسل النصوص التوضيحية وتلميحات النوع
لمستان صغيرتان تحولان دالة تعمل إلى دالة احترافية: 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.
سيفتح هذا التمرين قريبا
أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.
يقوم هذا المتصفح بحظر ملفات تعريف الارتباط لـ learn.floati.life، لذا لا يمكن فتح الدروس التي أنهيتها هنا بالترتيب. اسمح بملفات تعريف الارتباط لهذا الموقع وأعد التحميل.