C语言规范精选.pdf

C 语言编程规范 版本：V1.00 Alpha 浙江戴氏网络信息有限公司 - 1 - 目 录 1. 文件的组织结构1 1.1. 程序文件的目录结构 1 1.2. 文件的结构 1 1.2.1. 版权声明、版本说明和文件说明 1 1.2.2. 头文件的作用和结构 2 1.2.3. 源文件结构 3 2. 代码的版式（排版）4 2.1. 代码行规范 4 2.2. 缩进格式 4 2.3. 长语句处理 4 2.4. 空行的使用 4 2.5. 空格的使用 5 3. 标识符命名 6 3.1. 变量名 ... 6 3.1.1. 不同作用域变量的命名 6 3.1.2. 不同类型变量的命名（匈牙利命名法） 7 3.1.3. 指针变量的命名 7 3.1.4. 在某一模块中使用的变量，变量名的开始需有模块名 7 3.2. 函数名 7 4. 注释8 4.1. 注释的基本概念 8 4.2. 注释的准确性 8 4.3. 变量、常量的注释 8 4.4. 说明性文件的注释 9 4.5. 源文件头部注释 9 4.6. 函数的注释 10 5. 表达式和基本语句 11 5.1. 运算表达式11 - 2 - 5.2. if 语句11 5.2.1. 布尔变量与零值比较11 5.2.2. 整型变量与零值比较11 5.2.3. 浮点变量与零值比较11 5.2.4. 对if 语句的补充说明 12 5.3. switch 语句 12 6. 常量13 6.1. 为什么要用常量 13 6.2. 定义常量的方法 13 6.2.1. #define 宏定义 13 6.2.2. const 常量 13 6.2.3. 枚举 14 7. 变量、结构14 8. 函数、过程16 9. 可测性20 10. 程序效率23 11. 质量保证25 12. 宏26 - 3 - 1. 文件的组织结构1. 文件的组织结构 1. 1. 文件的组织结构文件的组织结构 文件的组织结构并不影响功能，也无多少技术含量，但是会影响程序的清晰性，同时能 够反映出开发者的职业化程度。文件结构追求清晰、美观，是程序风格的重要因素之一。 由于项目性质、规模上存在着差异，不同项目间的文件组织形式差别很大。但文件、目 录组织的基本原则应当是一致的： a.使外部接口与内部实现尽量分离； b.尽可能清晰地表达软件的层次结构。 1.1. 程序文件的目录结构1.1. 程序文件的目录结构 1.1. 1.1. 程序文件的目录结构程序文件的目录结构 一个正在开发中的程序工程不仅包含源代码文件，还包含许多资源文件、数据文件、库 文件及配置文件等。为了方便于开发与维护，最好有一目了然的组织方式(即目录结构)。通 常应将各种不同类型和不同用途的文件分别保存于不同的目录（可以是多级目录），以便于 管理和维护。例如创建一个C 程序工程TestProj，其目录下可包含以下子目录： TestProj / / // -include/ 存放应用程序的头文件(.h)。 -source/ 存放应用程序的源文件(.c)。 -test/ 存放测试用代码的目录。