C语言注释

C语言注释教程

用于注解说明解释程序的文字就是注释,注释提高了代码的阅读性。同时,注释也是一个程序员必须要具有的良好编程习惯。我们应该首先将自己的思想通过注释先整理出来,再用代码去体现。

C 语言 中,一旦程序中某部分内容被注释掉,则该内容将会被 C 语言解释器忽略,换句话说,此部分内容将不会被执行。

C语言注释作用

注释不仅可以用来解释程序某些部分的作用和功能(用自然语言描述代码的功能),在必要时,还可以将代码临时移除,是调试程序的好帮手。

通常而言,合理的代码注释应该占源代码的 1/3 左右。

C语言注释形式

C 语言提供了两种注释的形式行注释和块注释。

行注释

// 注释内容

说明

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("嗨客网") 这是行注释,这里不会被执行 }

程序运行,控制台输出,如下图:

15_C语言注释.png

我们可以看到,我们的程序并没有输出第一句和最后一句,因为,这两句都被我们注释了,被注释的代码不会被执行。

C 语言块注释

C 语言块注释也可以用来注释单行代码

#include <stdio.h> int main(int argc, char **argv) { /* printf("www.haicoder.net\n"); */ printf("嗨客网(www.haicoder.net)\n"); printf("Hello HaiCoder"); /*printf("嗨客网") 这是注释,这里不会被执行 */ }

程序运行,控制台输出,如下图:

16_C语言注释.png

我们可以看到,我们使用了 C 语言的多行注释也就是块注释,注释了单行代码。

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"); }

程序运行,控制台输出,如下图:

17_C语言注释.png

我们使用了块注释,一次性注释了两行代码。

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"); }

程序运行,控制台输出,如下图:

18_C语言注释.png

我们可以看到,运行时直接报错,因为块注释是不支持嵌套的。

C语言注释总结

C 语言注释分为单行注释和块注释,其中单行注释可以嵌套,块注释不可以嵌套。