ما فائدة الهاش تاق (#) في بايثون

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

بجانب هذا النوع، يوجد التعليقات متعددة الأسطر التي يمكن توصيفها بإستعمال ثلاث علامات '''، أمثلة: 

# هذا تعليق مفرد يوضح الهدف من السطر التالي
print("Hello hsoub")  # سيتم طباعة "Hello hsoub"

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

'''
هذا تعليق متعدد الأسطر
يوضح استخدام التعليقات المتعددة في بايثون.
يمكن أن يحتوي على أكثر من سطر.
'''
print("Hello hsoub!")

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

إليك بعض الأمثلة لكيفية استخدام (#) :
 

• أضافة تعليق على سطر واحد:

# هذا تعليق على سطر واحد
print("Hello, World!")

• أضافة تعليق على عدة اسطر:

# هذا تعليق
# على عدة أسطر
print("Hello, World!")

لكن من المستحسن عندما تريد اضافة تعليق متعدد الاسطر ان تضيفه بداخل هذه العلامه ''' تعليقك '''

'''
هذا تعليق
على عدة أسطر
'''
print("Hello, World!")

• أضافة تعليق على جزء من سطر:

print("Hello, World!") # هذا تعليق بجانب الكود

بعد معرفة كيفية استخدام # اليك الان كيفية الاستفاده منه واستخدامه في تحسين الكود.
يمكنك استخدامه في المواضع التاليه:

1. شرح الكود: يمكنك استخدام التعليقات لشرح الجزء العامل في الكود، وهذا يجعل الكود أكثر قراءةً وفهمًا لك وللآخرين.
2. تجاهل سطر برمجي: يمكن استخدام التعليق لجعل سطر برمجي لا يتم تنفيذه مؤقتًا عند اختبار الكود أو عند تحديد الأخطاء.
3. إلغاء تنفيذ سطر برمجي: يمكن استخدام التعليق لتعطيل سطر برمجي بشكل مؤقت دون الحاجة إلى حذفه.

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

إليك بعض الأمثلة لاستخدام الهاش تاج في بايثون:

تعليقات على سطر واحد:- 

# هذا تعليق على سطر واحد
نتيجة = اضافة(5, 10)  # هذا تعليق على سطر واحد آخر

تعليقات على عدة أسطر:-

"""
هذا تعليق متعدد الأسطر يمكن
استخدامه للتعليق على كتلة من الشيفرة أو
لكتابة شروحات مطولة.
"""
نتيجة = ضرب(3, 7)  # تعليق قصير بعد كود

يجب ملاحظة أن الهاش تاج يجعل النص غير قابل للتنفيذ من قِبَل المترجم (البايثون). إذا كنت ترغب في تجاهل سطر من الشيفرة بشكل مؤقت دون حذفه، يمكنك استخدام التعليقات باستخدام الهاش تاج.

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

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

هناك طريقتين لاستخدام التعليقات في Python:

تعليقات مفردة (Single Line Comments): يتم استخدام الهاش تاج (#) في بداية السطر لكتابة تعليق واحد على نفس السطر. المحتوى الذي يلي الهاش تاج لن يتم تنفيذه.

# هذا تعليق واحد
print("سيتم طباعة هذا الجزء")

# يمكن وضع التعليق بجوار الكود في نفس السطر
x = 5  # تعليق عن قيمة x

تعليقات متعددة (Multi-line Comments): تُستخدم ثلاثة أزواج من علامات الهاش تاج لكتابة تعليق يمتد عبر عدة أسطر.

"""
هذا تعليق متعدد الأسطر.
يمكننا كتابة النص هنا دون أن يتأثر التنفيذ.
"""

'''
هذا طريقة أخرى لكتابة تعليق متعدد الأسطر.
'''

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

استخدام التعليقات يعتبر ممارسة جيدة في البرمجة لأنه يجعل الكود أكثر وضوحًا ويساعد المطورين الآخرين على فهم النوايا والوظائف المراد تنفيذها في البرنامج.

بالإَضافة إلى ما تم ذكره، تستطيع كتابة التعليقات بكل سهولة في برنامج vscode من خلال الضغط على CTRL + /  وعلامة السلاس تلك هي حرف ظ في لوحة المفاتيح وبالطبع يجب أن تقوم بتحويل اللغة إلى الإنجليزية قبل الضغط.

وستجد أن تم تعليق السطر الذي قمت بالوقوف عنده بشكل تلقائي كالتالي:

ولعمل تعليق لأكثر من سطر عليك بتحديد السطور التي تريد تعليقها ثم الضغط على CTRL + /  كالتالي:

ولاحظ أنه تم تعليق كل سطر على حدى أي بإضافة الهاش تاج في بداية كل سطر.

وإذا تعليق تلك السطور ضمن تعليق متعدد السطور أي Block Comment فعليك بالضغط على Shift + Alt + A وسيصبح الكود كالتالي: