التعليقات

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

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

شيء آخر: عندما يتم كتابة تعليق في النص البرمجي، يتجاهله المترجم (Compiler) أو المفسر (Interpreter). هذا يعني أنه لا يؤثر على نتيجة تنفيذ التعليمات البرمجية على الإطلاق.

للتعليق، يمكنك استخدام رمز الشباك #. أي شيء يظهر بعد الرمز # في بقية هذا السطر يعتبر تعليقًا. فيما يلي مثال على تعليق:

# يقوم سطر التعليمات البرمجية التالي بطباعة جملة ترحيب بالمستخدم

print(" مرحبًا بك في قوت")

المخرجات:

مرحبًا بك في قوت 

جرب ذلك!