C编码规范(109条规则+49条建议)要点.doc

C编码规范 109条规则＋49条建议 目 录 1.文件结构（4条规则＋6条建议）... 1 1.1 版权和版本的声明... 1 1.2 头文件的结构... 2 1.3 定义文件的结构... 3 1.4头文件和定义文件使用（4条规则＋6条建议）... 3 2.程序版式（34条规则＋2条建议）... 4 2.1 空行（4条规则）... 4 2.2 代码行（5条规则＋1条建议）... 4 2.3 代码行内的空格（6条规则＋1条建议）... 5 2.4 对齐（4条规则）... 6 2.5 长行拆分（2条规则）... 7 2.6 修饰符的位置（1条规则）... 8 2.7 注释（12条规则）... 8 3.标识符命名（15条规则＋1条建议）... 8 4.常量（7条规则）... 10 4.1 const 与#define 的比较（2条规则）... 10 4.2 常量定义（5条规则）... 10 5.变量（11条规则）... 11 6.表达式和基本语句（17条规则＋3条建议）... 11 6.1 运算符的优先级（1条规则）... 11 6.2 复合表达式（4条规则）... 12 6.3 if 语句布尔表达式（7条规则）... 12 6.4 循环语句（1条规则＋3条建议）... 15 6.5 switch 语句（2条规则）... 16 6.6 goto 语句（1条规则）... 16 7.函数设计（16条规则＋10条建议）... 16 7.1注释规则（1条规则）... 16 7.2 函数的使用（1条规则）... 16 7.3 参数的规则（4条规则＋2条建议）... 17 7.4 返回值的规则（6条规则）... 17 7.5 函数内部实现的规则（2条规则）... 17 7.6 其它建议（6条建议）... 18 7.7 使用断言（2条规则＋2条建议）... 18 8.内存管理（5条规则）... 18 8.1 内存使用注意的问题（5条规则）... 18 9.其他规范及建议（27条建议）... 19 9.1 提高程序的效率（6条建议）... 19 9.2 编译问题（2条建议）... 19 9.3 兼容性问题（8条建议）... 19 9.4性能问题（4条建议）... 19 9.5 其他一些有益的建议（7条建议）... 20 1.文件结构（4条规则＋6条建议） C程序文件通常分为两类文件： 一类文件用于保存程序的声明（declaration），称为头文件。头文件以“.h”为后缀。 另一类文件用于保存程序的实现（implementation），称为定义（definition）文件。定义文件以“.c”为后缀。对于简单的C语言程序，一般在把头文件和程序定义文件放在一起，只有一个.c定义文件即可。而对于复杂的程序，则多采用头文件包含的形式并通过多个定义文件实现。 1.1 版权和版本的声明 版权和版本的声明一般应该位于头文件和定义文件的开头（参见示例1-1），主要内容包括： (1) 版权信息； (2) 文件名称、文件标识、摘要； (3) 当前版本号、作者/修改者、修改日期、修改描述等； (4) 版本历史信息、原作者、完成日期等。 示例1-1 版权和版本的声明 版本标识：采用主版本号.次版本号.修订号 来命名自己产品的编号。一般这样约定，如果次版本号是偶数（如0、2、4等），代表正式版本，如果次版本号是奇数(如1、3、5等)，代表开发过程中的测试版本。修订号则相当于Build号，用来标识一些小的改动。 1.2 头文件的结构 头文件由三部分内容组成： (1) 文件开头处的版权和版本声明（参见示例1-1）； (2) 预处理块； (3) 声明函数原型和声明数据结构或变量等。 假设头文件名称为filename.h，头文件的结构参见示例1-2。 /* * Copyright (c) 2004,北大青鸟培训中心 * All rights reserved. * * 文件名称：filename.h * 文件标识：根据软件工程设置 * 摘要：简要描述本文件的作用和内容等 */ #include stdio.h #include stdlib.h #include graphics.h // 引用头文件 struct studentstruct { int no; char name[20]; char sex; float score; }; void GetValue() { } void SetValue(int no) { } //后面同示例 1-1。 示例1-2 C头文件结构 1.3 定义文件的结构 定义文件有三部分内容： （1）