بسم الله الرحمن الرحيم


_التعليقات هي مجموعة من سلاسل نصية نستعملها لتوضيح أوامر في مصادر برامجنا، و يمكن أن تحتوي تلك النصوص على أرقام، أحرف، أو رموز يقوم المترجم بتجاهلها.

_ فائدة التعليقات:
فائدة التعليقات يمكنك أن تلاحظها في الكثير من الأمثل المفتوحة المصدر الموجودة على الإنترنت، مثلا تجد مثال لبرنامج ما كبير و غير واضح، و هنا يلجئ المبرمج إلى استعمال التعليقات لجعلها أكثر وضوح.

 _أنواع التعليقات:

يوجد نوعين من التعليقات هما:

_ التعليقات بالنصوص الطويلة:
التعليقات بالنصوص الطويلة هي نصوص بها أكثر من سطر، و طريقة استخدامها هي تحديد بداية التعليق و التي تبدأ بـ /* و نضع */ في نهاية التعليق، مثال:

الكود:

/*
My First Program:
Hello, World!
*/
#include<stdio.h> /* Standart Input Output Header File*/
main()
      /*main function*/
{/*Start of main function*/
  printf("Hello, World!");/*to print Hello, World!*/
}/*End of main function*/


_ التعليقات بالأسطر:
التعليقات بالأسطر هي تجاهل سطر تعليقي يبدأ بـ //، مثال:

الكود:

//My First Program:
//Hello, World!
#include<stdio.h> //Standart Input Output Header File
main()
  //main function
{//Start of main function
printf("Hello, World!");//to print Hello, World!
}//End of main function


و هذه الطريقة ليست من طرق لغة C القياسية في التعليقات، و لكن الكثير من المترجمات تدعمها.

_ملاحظات

1- في التعليقات بالنصوص الطويلة إن لم يتم تحديد نهاية التعليق فإن كل ما هو بعد بداية التعليق يعتبر تعليق، و هذا مثال توضيحي:

الكود:


/*comment
#include<stdio.h>
main()
{
 printf("Hello, World!");
}

هنا البرنامج كله عبارة عن تعليق، أي أن المشروع فارغ.

2- في التعليقات السطرية يجب الانتباه إلى ما نضعه تعليق فمثلا:

الكود:


//#include<stdio.h>
main()
{
  printf("Hello, World!");
}


هنا سيخبرك المترجم على أن الدالة printf غير معرفة سابقا، و هذا الخطأ سببه هو جعل الكلمة المحجوزة #include الخاصة بضم الملف الرأسي stdio.h عبارة عن تعليق، و هنا سيتم تجاهل ضم الملف الرأسي stdio.h.