目录
13. 注释是什么?为什么写注释?
注释是对代码的说明,编译器会忽略注释,也就是说,注释对实际代码没有影响。
注释是给程序员⾃⼰,或者其他程序员看的。
好的注释可以帮我们更好的理解代码,但是也不要过度注释,不要写没必要的注释。
当然不写注释可能会让后期阅读代码的⼈抓狂。
写注释⼀定程度上反应了程序作者的素质,建议⼤家写必要的注释,在未来找⼯作的时候,写代码时留下必要的注释也会给⾯试官留下更好的印象。
13.1 注释的2种形式
C 语⾔的注释有两种表⽰⽅法。
13.1.1 /**/ 的形式
第⼀种⽅法是将注释放在 /*...*/ 之间,内部可以分⾏。
/* 注释 */
/*
这是⼀⾏注释
*/
/* 注释 */
/*
这是⼀⾏注释
*/
这种注释可以插在⾏内。
int fopen(char* s /* file name */, int mode);
上⾯⽰例中, /* file name */ ⽤来对函数参数进⾏说明,跟在它后⾯的代码依然会有效执⾏。这种注释⼀定不能忘记写结束符号 */ ,否则很容易导致错误。
printf("a "); /* 注释⼀
printf("b ");
printf("c "); /* 注释⼆ */
printf("d ");
上⾯⽰例的原意是,第⼀⾏和第三⾏代码的尾部,有两个注释。
但是,第⼀⾏注释忘记写结束符号,导致注释⼀延续到第三⾏结束。
/**/ 的这个注释也不⽀持嵌套注释, /* 开始注释后,遇到第⼀个 */ 就认为注释结束了。
/* printf("a ");
printf("b "); printf("c "); /* 注释⼆ */printf("d ");
*/
13.1.2 // 的形式
第⼆种写法是将注释放在双斜杠 // 后⾯,从双斜杠到⾏尾都属于注释。这种注释只能是单⾏,可以放在⾏⾸,也可以放在⼀⾏语句的结尾。这是 C99 标准新增的语法。
// 这是⼀⾏注释
int x = 1; // 这也是注释
不管是哪⼀种注释,都不能放在双引号⾥⾯。
双引号⾥⾯的注释符号,会成为字符串的⼀部分,解释为普通符号,失去注释作⽤。
printf("// hello /* world */ ");
上⾯⽰例中,双引号⾥⾯的注释符号,都会被视为普通字符,没有注释作⽤。
3.2 注释会被替换
编译时,注释会被替换成⼀个空格,所以 min/* 这⾥是注释*/Value 会变成 min Value ,⽽不是 minValue 。