التعليقات في بايثون ( comments )

29-11-22 أحمدُ عُبَيْد 5237 0
كلمات: 448 | وقت القراءة: 4 دقيقة

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

ماهي فائدة التعليقات في بايثون


  • شرح كود بايثون.

  • جعل الكود أكثر قابلية للقراءة.

  • جعل الكود سهل الفهم من قبل المبرمجين الآخرين

  • يساعد في تذكر سبب استخدامنا لأمر أو طريقة أو وظيفة معينة في الكود

  • منع التنفيذ عند اختبار الكود.

طريقة كتابة التعليق في بايثون


  • يجب أن تبدأ التعليقات في Python بعلامة التجزئة ( # ) وحرف المسافة البيضاء وتستمر حتى نهاية السطر.

  • يجب أن تكون التعليقات على نفس مستوى المسافة البادئة للرمز الذي يعلق عليه.

مثال:


#This is a comment
#هذا مثال علي تعليق
print("Hello, Ahmed !")

أنواع التعليقات في بايثون

هناك ثلاث أنواع لكتابة تعليق :


  • تعليق في سطر منفصل

  • تعليق بجانب الكود ( في نفس السطر )

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

_ تعليق في سطر منفصل ( تعليق من سطر واحد )

مثال:


# create a variable
name = 'Ahmed Obaid'

_ تعليق بجانب الكود ( في نفس السطر )

يمكننا أيضًا استخدام التعليق أحادي السطر مع الكود علي نفس السطر 

مثال:


name = 'Ahmed Obaid' # name is a string

_ تعليق متعدد الأسطر في بايثون

يتم التعامل مع كل سطر كتعليق منفصل.

مثال:


# This is a long comment
# and it extends
# to multiple lines

هناك طريقة أخرى للقيام بذلك وهي استخدام علامات الاقتباس الثلاثية ، إما الفردية( ''' ) أوالزوجية (  """ ).

تُستخدم علامات الاقتباس الثلاثية هذه بشكل عام للسلاسل متعددة الأسطر. ولكن إذا لم نسندها إلى أي متغير أو وظيفة ، فيمكننا استخدامها كتعليق.

يتجاهل مترجم بايثون السلسلة التي لم يتم تعيينها لأي متغير أو وظيفة.

دعونا نرى مثالا ،


''' This is also a
perfect example of
multi-line comments '''

كيف تكتب تعليقات جيدة في بايثون؟

التعليقات هي جزء مهم من البرنامج. وبالتالي ، من الضروري نتعلم كيفية كتابة تعليقات جيدة. فيما يلي بعض الخصائص التي تحدد التعليقات الجيدة.


  • تأكد من أنها موجزة

  •  اكتب تعليق سهل الفهم

  • اكتب التعليقات التي تصف الوظيفة الاساسية للكود

  • لا تكتب تعليقات زائدة عن الحاجة

 استخدام التعليقات من أجل التصحيح

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


print('Python')
# print("Error Line )
print('Django')

هنا ، print("Error Line) كان يسبب خطأ لذلك قمنا بتغييره كتعليق. الآن ، يتم تشغيل البرنامج دون أي خطأ.

هذه هي الطريقة التي يمكن أن تكون بها التعليقات أداة قيمة لتصحيح الأخطاء.

الخلاصة:

ستسمح كتابة التعليقات الجيدة في Python، لك وللمبرمجين الآخرين ايضاً بقراءة وفهم التعليمات البرمجية الخاصة بك بسهولة. 

اذا كان لديك أي أسئلة؟ اتركها في التعليقات 

الكلمات الدلالية

بايثون التعليقات في بايثون

شارك المقال