توفر كل لغة برمجة آلية لإضافة تعليقات على المشاريع. التعليقات هي الأسطر البسيطة في برامج الكمبيوتر التي يتجاهلها المترجم أو المترجم الفوري. غالبًا ما تُكتب التعليقات بلغة طبيعية لزيادة فهم المبرمجين. يستخدم المطورون التعليقات لتجاهل بعض أجزاء التعليمات البرمجية في مرحلة التصحيح أو الاختبار.
يمكن أن تكون كتابة التعليقات في Python بسيطة للغاية ، ويبدأ إنشاء تعليق في Python بالرمز '#'. تشرح هذه المقالة كيفية إنشاء تعليقات متعددة الأسطر في بايثون.
كتابة تعليقات متعددة الأسطر بلغة بايثون
على عكس العديد من لغات البرمجة الأخرى ، لا توفر Python أي طريقة محددة لكتابة تعليقات متعددة الأسطر. ومع ذلك ، هناك طرق أخرى للتعامل مع هذه المشكلة.
في جافا نكتب عدة تعليقات على النحو التالي:
/ *
أعلاه ، نكتب تعليقًا متعدد الأسطر.
لا يعمل تنسيق التعليق هذا في Python.
* /
الطريقة المذكورة أعلاه لكتابة التعليقات لا تعمل أيضًا في Python.
دعونا نرى بعض الطرق الأخرى لكتابة تعليقات متعددة الأسطر في بايثون.
استخدام تعليقات خط متعدد الرموز
يستخدم الرمز '#' لكتابة تعليق سطر مفرد في Python. من خلال التعليقات المتعددة أحادية السطر المتتالية ، يمكننا كتابة تعليقات متعددة الأسطر. دعونا نرى مثالا على ذلك.
#مرحبا بالجميع
# هذا تعليق في بايثون
# أنا أكتب تعليقات متعددة الأسطر
# استخدام التعليق أحادي السطر
هذه طريقة واحدة لكتابة التعليقات متعددة الأسطر. إنها عملية تستغرق وقتًا طويلاً ، حيث تتطلب منا كتابة عدة تعليقات من سطر واحد.
الآن ، دعونا نرى بعض الطرق الأخرى لكتابة تعليقات متعددة الأسطر في بايثون.
استخدام String Literals لكتابة تعليقات متعددة الأسطر
كما تمت مناقشته سابقًا ، لا توفر Python طريقة فعلية لكتابة تعليقات متعددة الأسطر ، ولكن أنت علبة استخدم السلاسل الحرفية لكتابة تعليقات متعددة الأسطر. يتغاضى مترجم بايثون عن السلاسل الحرفية غير المخصصة لأي متغير ولا ينفذها. لذلك ، يمكنك استخدام سلسلة حرفية غير مخصصة لكتابة تعليقات متعددة الأسطر في Python. دعونا نلقي نظرة على مثال على ذلك.
'نحن نستخدم السلسلة الحرفية كتعليق''هذا تعليق متعدد الأسطر'
'نحن نطبع برنامج Hello world'
طباعة ('Hello World')
انتاج |
في الإخراج ، يمكنك أن ترى أن مترجم Python لا يخرج أي خطأ ويطبع الرسالة 'Hello World'.
استخدام حرفية سلسلة مقتبسة ثلاثية لكتابة تعليقات متعددة الأسطر
على الرغم من أن القيم الحرفية الثلاثية للسلسلة المقتبسة تُستخدم أساسًا لكتابة سلاسل المستندات ، يمكنك أيضًا استخدام هذه الأداة لكتابة تعليقات متعددة الأسطر. تأكد من عدم الخلط بين docstring مع ثلاث سلاسل حرفية بين علامات الاقتباس المستخدمة لكتابة تعليقات متعددة الأسطر. ستؤدي المسافة البادئة غير الصحيحة للسلاسل الحرفية الثلاثية المقتبسة إلى حدوث خطأ. دعونا نلقي نظرة على مثال على ذلك.
''نحن نستخدم القيم الحرفية الثلاثية للسلسلة المقتبسة للتعليقات متعددة الأسطر
لغة البرمجة هي بايثون
دعنا نطبع عالم الترحيب
''
طباعة ('Hello World')
انتاج |
في الإخراج ، يمكنك أن ترى أن مترجم Python لا يخرج أي خطأ ويطبع الرسالة 'Hello World'.
الآن ، دعنا نستخدم القيم الحرفية للسلسلة المقتبسة الثلاثية داخل دالة لكتابة تعليقات متعددة الأسطر.
في المثال المعطى ، نقوم بطباعة مجموع رقمين.
def cal_sum ():''
نحن نحسب مجموع رقمين.
هذا برنامج سوم
''
العدد 1 = 10
عدد 2 = 20
print ('المجموع هو:'، num1 + num2)
''
وظيفة بايثون الرئيسية
''
def main ():
cal_sum ()
إذا __name__ == '__main__':
الأساسية()
انتاج |
الآن ، دعنا نغير المسافة البادئة وفي الإخراج ، سترى أن المترجم ينتج خطأ.
def cal_sum ():''
نحن نحسب مجموع العددين.
هذا برنامج سوم
''
العدد 1 = 10
عدد 2 = 20
print ('المجموع هو:'، num1 + num2)
''
وظيفة بايثون الرئيسية
''
def main ():
cal_sum ()
إذا __name__ == '__main__':
الأساسية()
انتاج |
يقوم المترجم بإخراج خطأ المسافة البادئة.
استنتاج
تشرح هذه المقالة كيفية إنشاء تعليقات متعددة الأسطر في لغة برمجة بايثون. على الرغم من أن Python لا توفر أي طريقة فعلية لكتابة تعليقات متعددة الأسطر ، إلا أنه يمكنك معالجة هذه المشكلة باستخدام الطرق المختلفة التي تمت مناقشتها في هذه المقالة.