C语言代码编程规范

好的程序员应有良好的编程风格

C语言代码编程规范

2010.7.23

好的程序员应有良好的编程风格

1 概述1.1、目的 1.2、说明与适用范围 1.3、术语解释 1.4、代码编码基本原则

好的程序员应有良好的编程风格

1.1 目的 提高代码质量 提高程序的可移植性和可维护性 提高程序的可靠性、可读性、可修改性和可 继承性 避免危险结构 减少对个体程序员的依赖 形成统一的开发风格，产生一致的代码，增 进团队协作

好的程序员应有良好的编程风格

1 概述1.1、目的 1.2、说明与适用范围 1.3、术语解释 1.4、代码编码基本原则

好的程序员应有良好的编程风格

1.2 说明与适用范围 说明： 本规范同时适用与C编码和汇编编码，其中 有一些是C特有的，汇编编码不需要遵循 适用范围 本规范适用于软件部门的所有用C语言开发 的项目

好的程序员应有良好的编程风格

1 概述1.1、目的 1.2、说明与适用范围 1.3、术语解释 1.4、代码编码基本原则

好的程序员应有良好的编程风格

1.3 术语解释术语解释 单边作用(side effect): 指在表达式执行后对程序运行环境可能会 造成影响。赋值语句、自增操作等都是典 型的具有单边作用的操作。

好的程序员应有良好的编程风格

1 概述1.1、目的 1.2、说明与适用范围 1.3、术语解释 1.4、代码编码基本原则

好的程序员应有良好的编程风格

1.4 代码编码基本原则 程序的编码一般应考虑下列原则：1. 编制易于修改和维护的代码。 2. 编制易于测试的代码：运用条件编译语句尽早设计 出测试用例，采用统一的命名规则管理这些测试用例 并适时地进行回归测试等一系列措施。 3. 必须将编程与编文档的工作统一起来：这样既有利 于整个项目按期完成，又能保证文档与程序协调一致。

好的程序员应有良好的编程风格

1.4 代码编码基本原则4. 编程中采用统一的标准和约定，降低程序复杂性，慎 用Goto语句、慎用嵌套等。

5. 限定每一层的副作用，减少耦合程度：主要技术是分 解。 6. 尽可能地重用。

好的程序员应有良好的编程风格

2 代码规范C语言代码规范架构 1 排版 9 数据冗余

2 注释 3 标识符4 变量和数据类型 5 声明和定义 6 函数

10 程序效率 11 指针12 Switch语句 13 预处理 14 结构体与联合

7 控制流和表达式

好的程序员应有良好的编程风格

2.1 排版 2.1.1空格的使用：在两个以上的关键字、变量、常量进行对等操作时，它 们之间的操作符之前、之后或者前后要加空格；进行非对等 操作时，如果是关系密切的立即操作符(如->),后不应 加空格. – 逗号、分号只在后面加空格 – 比较操作符, 赋值操作符，算术操作符，逻辑操作符，位 域操作符等双目操作符的前后加空格 – "!"、"~"、"++"、"--"、"&"(地址运算符)等单目操作符前 后不加空格 – “->”、“.”前后不加空格 – if、for、while、switch等与后面的括号间应加空格，使if 等关键字更为突出、明显。

好的程序员应有良好的编程风格

2.1 排版 2.1.2 文件之中不得存在无规则的空行，比如说连 续十个空行。 2.1.3相对独立的程序块之间、变量说明之后必须 加

空行。2.1.2if (!valid_ni(ni)) { ... // program code } repssn_ind = ssn_data[index].repssn_index; epssn_ni = ssn_data[index].ni;

2.1.2if (!valid_ni(ni)) { ... // program code } repssn_ind = ssn_data[index].repssn_index; epssn_ni = ssn_data[index].ni;

好的程序员应有良好的编程风格

2.1 排版 2.1.4 一行程序不能大于120字符。较长的语句(>120字符)要分成多行书写，长表达式要在 低优先级操作符处划分新行，操作符放在新行之首，划分 出的新行要缩进三个Tab(以4空格/Tab计算),使排版整 齐，语句可读。perm_count_msg.head.len = NO7_TO_STAT_PERM_COUNT_LEN + STAT_SIZE_PER_FRAM * sizeof( _UL ); act_task_table[frame_id * STAT_TASK_CHECK_NUMBER + index].occupied = stat_poi[index].occupied; report_or_not_flag = ((taskno < MAX_ACT_TASK_NUMBER) && (n7stat_stat_item_valid (stat_item)) && (act_task_table[taskno].result_data != 0));

好的程序员应有良好的编程风格

2.1 排版 2.1.5 循环、判断等语句中若有较长的表达式或语 句，则要进行适当的划分，长表达式要在低优先 级操作符处划分新行，操作符放在新行之首。if ((taskno < max_act_task_number) && (n7stat_stat_item_valid (stat_item))) { } for (i = 0, j = 0; (i < BufferKeyword[word_index].word_length) && (j < NewKeyword.word_length); i++, j++) { } for (i = 0, j = 0; (i < first_word_length) && (j < second_word_length); i++, j++) { }

好的程序员应有良好的编程风格

2.1 排版 2.1.6 若函数或过程中的参数较长，则要进行适当 的划分。

n7stat_str_compare((BYTE *) & stat_object, (BYTE *) & (act_task_table[taskno].stat_object), sizeof (_STAT_OBJECT)); n7stat_flash_act_duration( stat_item, frame_id *STAT_TASK_CHECK_NUMBER + index, stat_object );