5- كورس لغة بايثون Python – Python Comments

ما هي تعليقات بايثون

تعليقات بايثون هي أدوات مهمة للمبرمجين تساعدهم في توضيح الشيفرة البرمجية، حيث توفر وسيلة لكتابة ملاحظات داخل الشيفرة دون أن تؤثر على تنفيذ البرنامج. تُستخدم التعليقات لتوضيح الأجزاء المعقدة من الشيفرة، أو لتذكير المبرمج بما يقوم به جزء معين من الشيفرة، أو حتى لتعطيل جزء من الشيفرة مؤقتًا لأغراض اختبارية.

في بايثون، يمكن كتابة التعليقات باستخدام رمز الهاش (#). عندما يواجه المفسر هذا الرمز، يتجاهل كل النص الموجود بعده في نفس السطر. يمكن استخدام التعليقات لكتابة ملاحظات قصيرة أو لوضع وصف طويل يمتد عبر عدة أسطر باستخدام تعليقات متعددة الأسطر.

كيفية استخدام التعليقات في بايثون

تُستخدم التعليقات في بايثون بإضافة رمز الهاش (#) في بداية النص الذي ترغب في تعليقه. يمكن أن تكون التعليقات في نفس السطر مع الشيفرة أو في سطر منفصل. إليك بعض الأمثلة التي توضح كيفية استخدام التعليقات في بايثون:

مثال على تعليق سطري:

# هذا متغير لتخزين العدد

x = 5

في المثال أعلاه، التعليق يشرح أن المتغير x يُستخدم لتخزين عدد.

مثال على تعليق متعدد الأسطر:

# البرنامج التالي يقوم بحساب مجموع الأعداد
# من 1 إلى 10 ويطبع النتيجة

total = 0
for i in range(1, 11):
    total += i
print(total)

في هذا المثال، التعليقات في الأعلى توضح وظيفة البرنامج بشكل عام.

استخدام التعليقات لتعطيل الشيفرة

يمكن أحيانًا استخدام التعليقات لتعطيل جزء من الشيفرة البرمجية بشكل مؤقت. هذا يكون مفيدًا عند الحاجة لاختبار جزء معين من الشيفرة دون تنفيذه بالكامل. لتعطيل سطر من الشيفرة، يمكنك وضع رمز الهاش (#) في بداية السطر. إليك مثال:

print("Hello, World!")
# print("This line is commented out and won't run")

في المثال أعلاه، تم تعطيل السطر الثاني باستخدام التعليق، لذا لن يُنفذ.

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