اقتبس من ابراهيم حمادة في 10 ديسمبر، 2020, 11:34 م

Python Comments
تعليقات بايثون

يمكن استخدام التعليقات لشرح كود بايثون.
يمكن استخدام التعليقات لجعل الكود أكثر قابلية للقراءة.
يمكن استخدام التعليقات لمنع التنفيذ عند اختبار الكود.

إنشاء تعليق
تبدأ التعليقات بِرمز #، وسيتجاهلها بايثون:
مثال
#This is a comment
print("Hello, World!")

ستكون النتيجة:
Hello, World!
جربها بنفسك في ملف comment1.py

يمكن وضع التعليقات في وسط السطر ، وسيتجاهل بايثون باقي السطر:
مثال
print("Hello, World!") #This is a comment

ستكون النتيجة:
Hello, World!
جربها بنفسك في ملف comment2.py

لا يُشترط أن تكون التعليقات نصًا لشرح الكود ، بل يمكن أيضًا استخدامها لمنع بايثون من تنفيذ الكود:
مثال
#print("Hello, World!")
print("Cheers, Mate!")

ستكون النتيجة:
Cheers, Mate!
جربها بنفسك في ملف demo_comment3.py
لاحِظْ أنّ السطر الأول في الكود السابق, لم يتنفذْ بسبب علامةْ التعليق.

تعليقات متعددة الأسطر
لا يحتوي Python حقًا على صيغة للتعليقات متعددة الأسطر.
لإضافة تعليق متعدد الأسطر ، يمكنك إدراج رمز #لكل سطر:
مثال
#This is a comment
#written in
#more than just one line
print("Hello, World!")

ستكون النتيجة:
Hello, World!
جربها بنفسك في ملف comment4.py

أو ، ليس تمامًا كما هو مقصود ، يمكنك استخدام سلسلة متعددة الأسطر.
نظرًا لأن Python سيتجاهل النصوص الحرفية التي لم يتم إإسنادها إلى متغير ،
يمكنك إضافة سلسلة نصِّيَّة متعددةْ الأسطُر باستعمال (علامات التنصيص الثُلاثية) في الكود الخاص بك ، ووضع تعليقك بداخلها:
مثال
"""
This is a comment
written in
more than just one line
"""
print("Hello, World!")

ستكون النتيجة:
Hello, World!
جربها بنفسك في ملف comment5.py
طالما لم يتم إسناد السلسلة إلى متغير ،
فإنَّ Python سيقرأ الكود ، ولكن بعد ذلك يتجاهلَه ، و بهاذا تكون قد قمتَ بعمل تعليق متعدد الأسطر.

اختبر نفسك مع التمارين
تمرين:
التعليقات في بايثون تُكتب بِرَمز خاص ، ما هو؟
هذا تعليق

الجواب:
الرمز هو #
#هذا تعليق

لِتنزيل الدرس مع الملفات المُرفقة:
https://www.dropbox.com/s/nt2x0uy0wxwrrfs/7Python%20Comments.zip?dl=1