世信汇诚C语言编程规范.pdf

信汇诚电子 C 语言编程规范 起草 : 信汇诚电子 时间 : 2003 年5 月 版本 : V0.1 版权声明 由于C 语言编程是众所周知的技术，没有秘密可言。编程的好经验应该大家共享，我 们自己也是这么学来的。作者愿意公开本资料文档。 版权声明如下： （1）读者可以任意拷贝、修改本书的内容，但不可以篡改作者及所属单位。 （2 ）未经作者许可，不得出版或大量印发本资料。 （3 ）如果竞争对手公司的员工得到本资料，请勿公开使用，以免发生纠纷。 2 目录 第1 章 基本原则4 第2 章 程序的版式5 2.1 空行 5 2.2 代码行 5 2.3 代码行内的空格 6 2.4 对齐7 2.5 长行拆分 8 2.6 修饰符的位置 9 2.7 注释 9 第3 章 数据类型约定 11 第4 章 表达式和基本语句12 4.1 运算符的优先级 12 4.2 复合表达式 12 4.3 if 语句 13 4.4 循环语句的效率 15 4.5 for 语句的循环控制变量 15 4.6 switch 语句 16 4.7 goto 语句 16 第5 章 命名规则18 5.1 共性规则 18 5.2 简单的C 应用程序命名规则2 1 5.3 常量22 第 章 函数设计 6 24 6.1 参数的规则24 6.2 返回值的规则25 6.3 函数内部实现的规则26 6.4 其它建议26 6.5 用断言27 第7 章 项目的组织及源文件的书写28 项目中文件的作用28 7 ．1 源文件的书写的基本原则28 7 ．2 程序文件的书写和构成29 7 ．3 头文件的书写和构成29 附录A 31 常用的文件头格式； 3 1 常用的函数注释格式： 3 1 常用的嵌入式实时操作系统的任务注释格式： 32 参考文献33 3 第1 章 基本原则 制定标准约定的基本的目的命提高代码的可维护性。通过约定达到代码必须容易阅读， 方 理解，可以追溯，而且可移植。 【基本原则1 】全部代码都应该采用在 AN SI C 标准来编写，功能原型必须符合 AN SI 标准。（特殊情况如C51 程序应在AN SI 的前提下符合C51 的标准。） 【基本原则2 】使用简单的编写代码风格，打算干什么，要简单，直接了当，代码精简， 避免垃圾程序。 【基本原则3 】使用明晰编码风格，避开编程语言的内在的隐式声明，必须使用明显声 明。使用括号以避免二义性。 【基本原则4 】保持一致性，尽可能地使用相同的规则。 【基本原则5 】尽量使用标准库函数和公共函数。 【基本原则6 】不要随意定义全局变量，尽量使用局部变量。 【基本原