1、面向过程的编程都包含大致的几个基本元素,编程规范约束着这些基本元素。
注释:文件注释,函数注释,行注释,块注释。
编译预处理等:文件包含,条件包含,宏定义,全局变量声明,函数声明及其他编译预处理语句。
函数:函数头,函数体(流程控制语句,数据结构和数据类型(变量或对象) 的定义,算符表达式,函数调用)。
错误处理:系统调用失败,if语句的判断,函数入口参数及出口参数合法性检测等;合理的错误处理结构(宏定义和错误信息数组的应用)。
2、规范
我认为所有的命名都该遵循数字、小写字母、下划线的规范,那些匈牙利命名法和骆驼命名法是属于C++和java的。c应该有自己的命名规范。
命名: 变量名和文件名一般用名词,函数用动词。宏定义用大写。(以上可以结合下划线)。避免出现魔数。
注释:文件说明什么人在什么时间完成的文件,版权版本等。函数注释要说明函数主要实现的功能以及参数欲返回值,重点要指出调用了哪些全局变量。行注释块注释主要用来解释难以理解的算法。
文件结构:全局变量的声明一般都放在一个头文件中。 and avoid including multi-file.so using condition-precompile