التعليقات في Python
التعليقات هي نصوص داخل الكود لا تُنفَّذ، وتُستخدم لشرح الكود وجعله أسهل فهماً.
أنواع التعليقات:
1. تعليق سطر واحد - يبدأ بـ `#` ```python # هذا تعليق x = 5 # يمكن وضع التعليق بعد الكود ```
2. تعليقات متعددة الأسطر - باستخدام `"""` أو `'''` ```python """ هذا تعليق متعدد الأسطر يُستخدم أيضاً كـ Docstring """ ```
متى تكتب تعليقاً؟ - لشرح كود معقد - لتوضيح الغرض من دالة أو قسم - لإيقاف تشغيل كود مؤقتاً (commenting out) - لكتابة Docstrings للدوال
| 1 | # تعليق سطر واحد |
| 2 | # هذه دالة تحسب المربع |
| 3 | |
| 4 | def square(n): |
| 5 | """ |
| 6 | هذا Docstring - يشرح وظيفة الدالة |
| 7 | المدخل: عدد n |
| 8 | المخرج: مربع n |
| 9 | """ |
| 10 | return n * n # نرجع قيمة n² |
مثال 1: أنواع التعليقات
| 1 | # 1. تعليق سطر واحد |
| 2 | name = "Python" # متغير الاسم |
| 3 | |
| 4 | # 2. تعليق متعدد الأسطر |
| 5 | """ |
| 6 | هذا الكود يوضح |
| 7 | أنواع التعليقات |
| 8 | في Python |
| 9 | """ |
| 10 | |
| 11 | # 3. إيقاف كود مؤقتاً |
| 12 | x = 10 |
| 13 | # y = 20 ← هذا السطر موقوف |
| 14 | z = x + 5 |
| 15 | print(z) |