Comment là phần code bị compiler bỏ qua, giúp code dễ đọc, hiểu. Hai loại:
- Single-line:
// comment– từ//đến hết dòng. - Multi-line:
/* comment */– từ/*đến*/(có thể nhiều dòng).
Trong C++: cả hai đều dùng. Trong C89: chỉ /* */. C99+: cả hai.
Ví dụ
#include <stdio.h>
#include <string.h>
int main() {
/* Khai bao bien
nhieu dong */
char s[10] = "HelloWorld";
char d[10];
int n;
n = strxfrm(d, s, 5); // Bien doi va copy chuoi
printf("Do dai chuoi: %d", n); // In do dai
return 0;
}
Kết quả
Do dai chuoi: 10
Giải thích: /* ... */ comment block khai báo. // comment cuối dòng giải thích câu lệnh.
Best Practices
- Dùng
//cho comment ngắn, giải thích dòng code. - Dùng
/* */cho comment block mô tả hàm, file, logic phức tạp. - Đừng comment code tự giải thích (ví dụ:
i++; // tang i). - Comment tại sao (why), không phải cái gì (what).
- Doxygen/Javadoc style cho API:
/** @param ... */. - Không lồng comment
/* /* */ */(lỗi).