C语言中注释与注意事项的深入讲解
更新时间：2021年09月01日 11:35:35 作者：精致的灰(>_<)
在编写C语言源代码时,应该多使用注释,这样有助于对代码的理解,这篇文章主要给大家介绍了关于C语言中注释与注意事项的相关资料,需要的朋友可以参考下
C语言注释简介：
注释应该出现在三种位置
- 文件头部
- 函数头部
- 函数体内的和代码混在一起的注释
对于文件头部的注释至少列出：
- 版权声明、版本号、文件创建日期、作者、内容/功能、与其他文件的关系、修改日志等。
函数头部注释要求至少列出：
- 函数功能、输入/输出参数、返回值、调用/被调用关系等。
C语言注释实例
注释在预编译阶段就会被删除掉，但是这里的删除并不是字面意义的删除，而是被替换，注释被替换，本质是替换成空格。
以下面的代码为例：
#include <stdio.h>
int main()
{
int /* */ i; //正确
char *s = "abcdefgh //hijklmn"; //正确
//Is it a\
valid comment? //正确
in/* */t j; //报错
return 0;
}
由于被替换成了空格，所以in t j这句话是无法编译的。
如果是C语言风格的注释出现了嵌套，则/*总是与离它最近的*/匹配，第二个/*并不会被认为是注释符号，因此第一个/*与第一个*/匹配，代码会剩下一个*/:
注释的一些注意事项
- 注释应当准确、易懂，反之有二义性。错误的注释容易产生误导，不利于代码维护。
- 边写代码边修改注释，修改代码的同时要修改对应的注释，保证注释和代码的一致性。不再有用的注释要及时删除。
- 注释是对代码的“提示”，所以注释应当简单明了，因为注释太多会让人眼花缭乱。
- 对于全局数据（全局变量、常量定义等）必须要加注释。注释清楚定义全局数据的目的。
- 注释的位置应该与被描述的代码相邻，可以与语句在同一行，也可以在语句的上一行，但不能在语句的下一行，因为这样不符合人的阅读习惯。
- 当代码比较长，特别是有多重嵌套时，应当在一些段落结束时加注释，便于阅读。
- 注释的缩进要与代码的缩进一致，这样代码会更美观，可读性强。
- 注释代码段时应当注重“为何做”而不是“怎么做”，要说明这段代码的操作意图。
- 数值的单位一定要注释。
- 对变量的范围给出注释，特别是参数。
- 对一系列的数字编号给出注释，尤其是在编写底层驱动的程序。
- 避免在一行代码或表达式的中间插入注释。
- 复杂的函数中，在分支语句、循环语句结束之后需要加注释，方便区分各分支或循环体。
总结
到此这篇关于C语言中注释与注意事项的文章就介绍到这了,更多相关C语言注释与注意事项内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
C语言中有很多内置的字符串处理函数,这些函数都在<string.h>头文件中声明,本文给大家介绍C语言字符串常用处理函数小结,感兴趣的朋友一起看看吧2023-11-11
这篇文章主要介绍了C++ Opengl图形颜色功能附源码下载,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2020-11-11
一个好的页面置换算法,应具有较低的页面更换频率,从理论上讲,应该保留最近重复访问的页面,将以后都不再访问或者很长时间内不再访问的页面调出,下面这篇文章主要给大家介绍了关于利用C语言实现页面置换算法的相关资料,需要的朋友可以参考下2022-11-11
这篇文章主要为大家详细介绍了C语言实现简单的扫雷游戏操作，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2021-03-03
使用C++和Direct3D (d3d)获取屏幕截图并根据传入分辨率进行缩放图片大小(最新推荐)
这篇文章主要介绍了使用C++和Direct3D (d3d)获取屏幕截图并根据传入分辨率进行缩放图片大小,本文给大家讲解的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2023-04-04
这篇文章主要介绍了C/C++并查集的查询与合并，并查集是一种用来管理元素分组情况的数据结构。并查集可以高效地进行如下操作2023-02-02
这篇文章主要介绍了C++11/14 线程的创建与分离的实现,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2019-01-01
这篇文章主要为大家详细介绍了C语言实现旅游景点咨询系统，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2019-12-12
本期又是一个花里胡哨的数据可视化，前两天刷到了耐克的视觉设计师Gladys Orteza绘制的k线图作品，把沉闷的股票图变成了精彩的风景，但是那些大部分是真的完全看不清，我这里挑选了几个能看清的k线图风格将其用MATLAB进行了实现2022-10-10
C++相较于Java，Python 并没有提供的字符串分割的函数split，因此需要自己进行编写，本文主要介绍了C++如何切割String对象的方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2022-05-05
最新评论