ความคิดเห็น (Comments) ในภาษา C/C++

ความคิดเห็น (Comments) เป็นส่วนของโค้ดที่คอมไพเลอร์จะข้ามไป ไม่มีผลต่อการทำงานของโปรแกรม ช่วยให้โค้ดอ่านง่าย เข้าใจง่าย และสะดวกในการบำรุงรักษา

ประเภทของ Comments ใน C/C++

// Single Line Comment (บรรทัดเดียว)
/* Multi Line Comments (หลายบรรทัด) */

ตัวอย่างโค้ดครบถ้วน

#include <stdio.h>
#include <string.h>

int main() {
    /* declarations
       of
       data members */
    char s[10] = "HelloWorld";
    char d[10];
    int n;
    n = strxfrm(d, s, 5);
    printf("Length of string : %d", n); // length of string
    return 0;
}

ผลลัพธ์

Length of string : 10

คำอธิบาย

Single-line (//): ใช้สำหรับอธิบายสั้นๆ ท้ายบรรทัด หรือบรรทัดเต็ม
Multi-line (/* ... */): ใช้สำหรับอธิบายยาว หลายบรรทัด หรือปิดบล็อกโค้ดชั่วคราว
Nested comments: C มาตรฐานไม่รองรับการซ้อน Multi-line comments (/* /* */ */ จะ Error) แต่บางคอมไพเลอร์รองรับ
Best Practice: เขียน Comment อธิบาย "ทำไม" (Why) มากกว่า "ทำอะไร" (What) เพราะโค้ดเองบอก What แล้ว

การใช้งานใน C++ เพิ่มเติม

C++ รองรับทั้งสองรูปแบบเหมือน C และเพิ่ม /// สำหรับ Documentation comments (Doxygen style) เช่น /// @param /// @return