用于注解说明解释程序的文字就是注释,注释提高了代码的阅读性。同时,注释也是一个程序员必须要具有的良好编程习惯。我们应该首先将自己的思想通过注释先整理出来,再用代码去体现。
在 C 语言 中,一旦程序中某部分内容被注释掉,则该内容将会被 C 语言解释器忽略,换句话说,此部分内容将不会被执行。
注释不仅可以用来解释程序某些部分的作用和功能(用自然语言描述代码的功能),在必要时,还可以将代码临时移除,是调试程序的好帮手。
通常而言,合理的代码注释应该占源代码的 1/3 左右。
C 语言提供了两种注释的形式行注释和块注释。
// 注释内容
C 语言的行注释使用的是 //
,将需要被注释的内容放在 //
后面即可。
/*
* 注释内容
*/
C 语言的块注释使用的 /**/
,C 语言块注释就是可以一次注释多行代码,但块注释不可以嵌套使用。
C 语言行注释只能用来注释单行代码
#include <stdio.h>
int main(int argc, char **argv)
{
// printf("Hello 嗨客网(www.haicoder.net)\n");
printf("嗨客网(www.haicoder.net)\n");
printf("Hello HaiCoder");
//printf("嗨客网") 这是行注释,这里不会被执行
}
程序运行,控制台输出,如下图:
我们可以看到,我们的程序并没有输出第一句和最后一句,因为,这两句都被我们注释了,被注释的代码不会被执行。
C 语言块注释也可以用来注释单行代码
#include <stdio.h>
int main(int argc, char **argv)
{
/* printf("www.haicoder.net\n"); */
printf("嗨客网(www.haicoder.net)\n");
printf("Hello HaiCoder");
/*printf("嗨客网") 这是注释,这里不会被执行 */
}
程序运行,控制台输出,如下图:
我们可以看到,我们使用了 C 语言的多行注释也就是块注释,注释了单行代码。
C 语言块注释可以用来一次注释多行代码
#include <stdio.h>
int main(int argc, char **argv)
{
/* printf("www.haicoder.net\n");
printf("嗨客网");
*/
printf("嗨客网(www.haicoder.net)\n");
printf("Hello HaiCoder");
}
程序运行,控制台输出,如下图:
我们使用了块注释,一次性注释了两行代码。
C 语言块注释不可以嵌套
#include <stdio.h>
int main(int argc, char **argv)
{
/* printf("www.haicoder.net\n");
printf("嗨客网");
/*
这里是嵌套注释
*/
*/
printf("嗨客网(www.haicoder.net)\n");
printf("Hello HaiCoder");
}
程序运行,控制台输出,如下图:
我们可以看到,运行时直接报错,因为块注释是不支持嵌套的。
C 语言注释分为单行注释和块注释,其中单行注释可以嵌套,块注释不可以嵌套。