تعليقات

مقدمة

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

Comments

يبدأ التعليق ذو السطر الواحد بالرقم # ويستمر حتى نهاية السطر. يمكن أن تظهر التعليقات على سطر منفرد، أو على نفس سطر الكود الفعلي. وتُسمى هذه التعليقات “التعليقات المضمنة”.

def main():
    # This is a single-line comment
    brain.print("Hello!")  # Print a greeting message

# VR threads — Do not delete
vr_thread(main)

def main():
    # Print a greeting and then a farewell
    # in the Console
    brain.print("Hello!")
    brain.print("Goodbye!")

# VR threads — Do not delete
vr_thread(main)

Multiline String Comments

يمكن استخدام التعليقات النصية المحاطة بثلاث علامات اقتباس (“”” “”” أو ‘’’ ‘’’) لشرح النصوص متعددة الأسطر. على الرغم من أنها تُصنف تقنيًا ككائنات نصية، إلا أنها تعمل كتعليقات إذا لم يتم إسنادها إلى متغير.

def main():
    """
    This project prints a greeting message,
    followed by a farewell message in the
    Console
    """
    brain.print("Hello!")
    brain.print("Goodbye!")

# VR threads — Do not delete
vr_thread(main)