C语言中的3种注释方法
2021年8月28日星期六·席锦
在用C语言编程时,常用的注释方式有如下几种:
(1)单行注释 // …
(2)多行注释 /* … */
(3)条件编译注释 #if 0…#endif
(1)(2)在入门教程中比较常见。
对于(1) 【单行注释 // …】,注释只能显示在一行内,通常出现在一条语句的右边或者上方,对于注释符【//】,一个注释里只要有多于2个【/】都可以,例如:
#include <stdio.h>
int main(void)
{
此处四个/仍能成功编译通过,因为//后面和它在同一行的//的内容均为注释内容
printf("语句1\n"); 注释
printf("语句2\n");
// printf("语句3\n");
printf("语句4\n");
return 0 ;
}
运行截图如下:
但是(1) 【单行注释 // …】只能适用几行代码的注释,如果说面对100行、1000行等代码注释,那岂不是累死人。当你想注释一大串代码时,可能你会马上想到(2)【多行注释 /* … */】。
对于(2)【多行注释 /* … */】,不能嵌套使用,正如【if…else】中的【else】总是和离它最近的【if】配对一样,【/*】总是和离它最近的【*/】相配对。例如:
#include <stdio.h>
int main(void)
{
printf("语句1\n");
printf("语句2\n");
printf("语句3\n");
/*
printf("语句4\n");
printf("语句5\n");
printf("语句6\n");
printf("语句7\n");
*/
printf("语句8\n");
// /*printf("语句9\n");/*示范嵌套注释的错误,打开本行头部的//,将编译失败*/*/
return 0 ;
}
运行截图如下:
(2)【多行注释 /* … */】确实很方便,但是问题来了,这个注释方式是不能嵌套的,可能自己的小程序小工程没有感觉,但是面对大工程来说,在使用【/* … */】时候,中间也有存在【/* … */】这样的注释,结果会引发一系列的错误。这个注释方式不能查看代码格式和高亮显示关键字的,不利于阅读和调试代码。
针对(1)【单行注释 // …】和(2)【多行注释 /* … */】各自的缺陷,资深的程序员提出(3)【条件编译注释 #if 0…#endif】,该注释的好处是能注释大块的程序,并且没有嵌套的限制,也就是说在【#if 0…#endif】的【…】处可以有【//】或【/* … */】这样的注释,也能保持代码的格式和高亮显示。例如:
#include <stdio.h>
int main(void)
{
printf("语句1\n");
printf("语句2\n");
#if 0
printf("语句3\n");
printf("语句4\n");
// printf("语句5\n");
/*
printf("语句6\n");
printf("语句7\n");
*/
#endif
printf("语句8\n");
return 0 ;
}
【#if 0】与【#endif】之间的代码会被注释掉。对于使用【#if 0…#endif】的开发者,在他想恢复该代码段时,只需要将【#if 0】改成【#if 1】即可,这种注释非常适合于代码的调试和测试。【#if 0】改成【#if 1】后的运行结果如下图:
【#if 0】运行结果
【#if 1】运行结果
根据(3)【条件编译注释 #if 0…#endif】进行扩展学习。
【#if 0,#else,#endif 语句 】或【#if 1,#else,#endif语句】,例如:
#include <stdio.h>
int main(void)
{
#if 1
printf("语句1\n");
#else
printf("语句2\n");
#endif
return 0 ;
}
此时printf("语句2\n");的语句被注释掉了,永远没有办法执行,而printf("语句1\n");是被编译的;
如果将【#if 1】变为【#if 0】,printf("语句2\n");被编译,而printf("语句1\n");永远没有办法被执行。
运行截图如下:
【#if 1】运行结果 【#if 0】运行结果
预处理嵌套使用,例如:
#include <stdio.h>
int main(void)
{
#if 1
printf("语句1\n");
#if 0
printf("语句2\n");
#endif
#if 1
printf("语句3\n");
#endif
#if 0
printf("语句4\n");
#endif
#endif
return 0 ;
}
运行截图如下:
每一【#if 0】或者【#if 1】都是要有一个【#endif】去匹配,少一个也不行,而且也是按照就近原则的方式去匹配。
预处理也可以使用【#if…#elif…#else…#endif】(类似于if() {}else if() {}else {}),例如:
#include <stdio.h>
#define a 2
int main(void)
{
#if (0==a) // 条件值要在预编译阶段就能确定的值,不能时运行时才能确定的值
printf("语句1\n");
#elif (1==a)
printf("语句2\n");
#elif (2==a)
printf("语句3\n");
#else
printf("语句4\n");
#endif
return 0 ;
}
运行截图如下:
条件值要在预编译阶段就能确定的值,不能时运行时才能确定的值
另有如下几点值得C语言程序员注意:
(1)注释并不是可以出现在程序的任何地方文章来源:https://www.toymoban.com/news/detail-754199.html
(2)合理的注释通常出现在一条语句的上方或者右边,不应出现在一条语句或者一个程序段的后面。文章来源地址https://www.toymoban.com/news/detail-754199.html
到了这里,关于C语言中的3种注释方法的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!