بسم الله الرحمن الرحيم عنوان الدرس : التعليقات Comments
إن وظيفة التعليقات هي أن تجعل البرنامج أكثر سهولة و قدرة على القراءة بالنسبة للمبرمج, و التعليق لا يظهر على الخرج كما أن المترجم لا يترجمه, و فقط يبقى التعليق داخل البرنامج فهو موجه للمبرمج و ليس للمستخدم, فلنفرض أنك وضعت هذا البرنامج في قرص مرن و أرسلته إلى صديقك ثم قام هو بفتحه سيجد بعض الصعوبة في فهم المراد من هذا لبرنامج و خصوصاً عندما يكون البرنامج كبيراً و مؤلف من عدة ملفات, لذلك تعتبر إضافة التعليقات إلى البرنامج من العادات البرمجية الجيدة ليكون البرنامج أكثر سهولة و وضوحاً. تتم إضافة التعليقات إلى البرنامج بطريقتين :
التعليقات السطرية : و هي التعليقات التي لا يتجاوز طولها السطر الواحد, و تتم إضافة التعليق عن طريق وضع العلامة // ثم نكتب بعدها التعليق, يعتبر المترجم كل ما يرد خلف العلامة // و في نفس السطر حصراً تعليقاً لذلك لا يقترب منه فلا يترجمه و لا يظهره على الخرج.
التعليقات متعددة الأسطر : و هي التعليقات التي تتوضع على أكثر من سطر واحد و تتم إضافة هذا النوع من التعليقات عن طريق وضع العلامة التالية /* ... */ حيث أن النقاط الثلاث تمثل التعليق الذي ستكتبه.
و الآن سنكتب البرنامج في شكله النهائي :
/* This program is for addition
two numbers and put the result in the variable total,
it's the final form, at first read it carefully, then execute it
*/
#include<iostream.h>
void main()
{
//Declaration of the variables
int num1 , num2 ; //these variables for put the numbers in them
int total = 0 ; /* this variable is for put the result of addition in it,
note that we put the value zero in it. */
cout<<"Enter the numbers to addition\n";
cin>>num1>>num2 ;
total=num1+num2;
cout<<"The result of the addition is : "<<total<<endl;
