注释是什么和注释该怎么写(C语言)

13. 注释是什么?为什么写注释?

注释是对代码的说明,编译器会自动忽略注释,也就是说,注释对实际代码没有影响。

注释是给程序员自己,或者其他程序员看的。

好的注释可以帮我们更好的理解代码,但是也不要过度注释,不要写没必要的注释

当然不写注释可能会让后期阅读代码的⼈抓狂。

写注释⼀定程度上反应了程序作者的素质,建议⼤家写必要的注释,在未来找工作的时候,写代码时

留下必要的注释也会给面试官留下更好的印象。

注释不是多余的,它是代码的说明书,也是未来你回看程序时最好的提示

13.1 注释的2种形式

13.1.1 /**/ 的形式

第⼀种⽅法是将注释放在/*...*/ 之间,内部可以分行

cpp 复制代码
/*   注释   */ 

/*

这是⼀⾏注释
 
*/

这种注释可以插在行内。

cpp 复制代码
int fopen(char* s /* file name */, int mode);

上⾯示例中,/* file name */ ⽤来对函数参数进行说明,跟在它后⾯的代码依然会有效执行。

这种注释⼀定不能忘记写结束符号*/,否则很容易导致错误.

cpp 复制代码
printf("a "); /* 注释⼀    就在这里本应该有一个结束的标志
printf("b ");
printf("c "); /* 注释⼆*/ 
printf("d ");

上面示例的原意是,第⼀行和第三行代码的尾部,有两个注释。

但是,第⼀行注释忘记写结束符号,导致注释⼀延续到第三行结束。/**/ 的这个注释也不⽀持嵌套注释,/* 开始注释后,遇到第⼀个*/就认为注释结束了。

13.1.2 // 的形式

第二种写法是将注释放在双斜杠// 后面,从双斜杠到行尾都属于注释

这种注释只能是单行,可以放在行首,也可以放在⼀行语句的结尾。这是C99标准新增的语法.

cpp 复制代码
// 这是⼀⾏注释
 
int x = 1; // 这也是注释
 

13.1.3 注意事项

不管是哪⼀种注释,都不能放在双引号里面

双引号里面的注释符号,会成为字符串的⼀部分,解释为普通符号,失去注释作⽤

cpp 复制代码
printf("// hello /* world */ ");

上⾯示例中,双引号内的///* */都会被当作普通字符,不会被解析为注释,因此整行都会被打印,不会被预处理删除.

13.2 注释会被替换

预处理阶段会删除注释,将注释内容替换为一个空格 ,因此 min/*这里是注释*/value 会被处理为min value,而非minvalue,避免了标识符拼接错误.

相关推荐
এ慕ོ冬℘゜18 分钟前
前端实战:jQuery 多条件联合搜索(标题模糊查询 + 日历时间段筛选)
前端·javascript·jquery
武子康27 分钟前
Search Console Platform Properties 扩大 SEO 资产边界:从 Page Ranking 到 Topic Coverage(5 类误读边界 + 3 表数据层设计)
前端·人工智能·后端
大模型码小白29 分钟前
【Python零基础教程】继承、多态与魔法函数:面向对象编程三大核心特性详解
java·大数据·开发语言·人工智能·python·ai编程
随心点儿1 小时前
js postMessage 实现跨域发送消息-应用示例
javascript·ecmascript·postmessage
腾渊信息科技公司1 小时前
Spring Boot对接MES实战:视觉检测数据自动同步方案
java·人工智能·spring boot·后端·计算机视觉·ai·软件需求
一点一木1 小时前
从60首歌到1个网站:输入你的故事,还你一首歌
前端·github
爱笑的源码基地2 小时前
高并发 Redis 缓存门诊HIS系统源码,含财务统计药房进销存
java·程序·门诊系统·诊所系统·云诊所源码
IT_陈寒2 小时前
Vue这个特性差点让我加班到凌晨,谁懂啊
前端·人工智能·后端
kyriewen2 小时前
我让AI改一个bug——它偷偷动了5个我没让它碰的地方
前端·javascript·ai编程
遇乐的果园3 小时前
前端学习笔记-vue加载渲染优化
前端·笔记·学习