Comments

注释

评论可以作为一种内部代码文档。当插入到程序中时，它们被编译器有效地忽略; 它们仅仅是用来作为阅读源代码的人的笔记。

句法

/* comment */	(1)
// comment\n	(2)	(since C99)

1）通常被称为“C型”或“多线”评论。

2）通常被称为“C ++风格”或“单行”的评论。

在翻译阶段3通过用一个空格字符替换每个评论来从程序中删除所有评论。

C-风格

C 风格的评论通常用于评论大块文本或小部分代码; 但是，它们可以用来评论单行。要将文本插入为C风格的评论，只需使用/*和环绕文本即可*/。C风格的注释告诉编译器忽略/*和之间的所有内容*/。虽然它不是 C 标准的一部分，/**并且*/通常用于指示文档块; 这是合法的，因为第二个星号被简单地视为评论的一部分。

除了字符常量，字符串文字或注释之外，这些字符会/*引入注释。这种评论的内容仅用于识别多字节字符并查找*/终止评论的字符。C风格的评论不能嵌套。

C ++风格的C ++风格的评论通常用于评论单行文本或代码; 但是，它们可以放在一起形成多行评论。要将文本作为C ++样式的注释插入，只需在文本前面加上//，然后按照新的行字符跟随文本。C ++风格的注释告诉编译器忽略//和新行之间的所有内容。除了字符常量，字符串文字或注释之外，字符//会引入一个注释，其中包含所有多字节字符，但不包括下一个换行符。这种注释的内容仅用于识别多字节字符并查找终止注释的换行符。C ++风格的注释可以嵌套：// y = f（x）; //调用算法C风格的注释可能出现在C ++风格的注释中：// y = f（x）; / *调用算法* / C风格的注释可能出现在C风格的注释中; 这是排除一小块源代码的机制：/ * y = f（x）; //调用算法z = g（x）; * /

（自C99以来）

注意

因为在预处理器阶段之前删除了注释，所以不能使用宏来形成注释，并且未终结的 C 样式注释不会从#include 的文件溢出。

/* An attempt to use a macro to form a comment. */
/* But, a space replaces characters "//".       */
#ifndef DEBUG
    #define PRINTF //
#else
    #define PRINTF printf
#endif
...  
PRINTF("Error in file %s at line %i\n", __FILE__, __LINE__

除了注释外，用于源代码排除的其他机制还有：

#if 0
    puts("this will not be compiled"
    /* no conflict with C-style comments */
    // no conflict with C++-style comments
#endif

if(0) {
    puts("this will be compiled but not be executed"
    /* no conflict with C-style comments */
    // no conflict with C++-style comments
}

在 C99中引入//注释在一些罕见的情况下是一个突破性的改变：

a = b //*divisor:*/ c
+ d; /* C89 compiles a = b / c + d;
        C99 compiles a = b + d; */

例

/*
C-style comments can contain
multiple lines.
*/
 
/* Or, just one line. */
 
// C++-style comments can comment one line.
 
// Or, they can
// be strung together.
 
int main(void)
{
  // The below code won't be run
  // return 1;
 
  // The below code will be run
  return 0;
}

参考

C11 standard (ISO/IEC 9899:2011):