2022年C、C++语言编程规范 .pdf

《2022年C、C++语言编程规范 .pdf》由会员分享，可在线阅读，更多相关《2022年C、C++语言编程规范 .pdf（17页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、文件编号：项目编号：信息级别：绝密机密内部文件部门：拟制：年月日校对：年月日审核：年月日批准：年月日XXXXXX C/C+编程规范武汉烽火众智数字技术有限责任公司名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 1 页，共 17 页 - - - - - - - - - 武汉烽火众智数字技术有限责任公司C/C+软件编程规范(Rev1.0-2011.02.18) 1 文档修订历史记录日期版本说明修改者2011.02.18 V1.0 编码规范初稿方宏伟2011.03.09 V1.1 在编码规

2、范初稿的基础上， 根据项目组的讨论，进行了修改。方宏伟2011.04.01 V1.2 根据 03.31 讨论结果修改刘尚军2011.04.02 V1.3 添加可测性要求、 程序效率要求和质量保证要求刘尚军2011.04.14 V1.4 增加变量必须初始化规则4-6，修改部分编号错误吴长树名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 2 页，共 17 页 - - - - - - - - - 武汉烽火众智数字技术有限责任公司C/C+软件编程规范(Rev1.0-2011.02.18) 2

3、 目录文档修订历史记录 . 1目录 . 21 总的原则 . 32 文件命名及书写规范 . 43 数据类型规范 . 44 变量规范 . 65 宏定义规范 . 76 表达式规范 . 87 函数规范 . 98 注释编写规范 . 99 可测性要求 . 1210 程序效率要求 . 1211 质量保证要求 . 14名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 3 页，共 17 页 - - - - - - - - - 武汉烽火众智数字技术有限责任公司C/C+软件编程规范(Rev.B-2009.1

4、2.07) 3 1 总的原则1.1 目的编写本规范的目的是统一虹信公司网络技术事业部嵌入式软件的编程风格，提高软件源程序的可读性、可移植性和可维护性，减少软件维护成本，并作为代码走读的考核标准。1.2 定义下列定义适用于本规范。【规则】：编程时必须遵守的约定。【建议】：编程时必须考虑的约定。【说明】：对此规则或建议的必要的解释。【正例】：符合规范或建议的例子。【反例】：不符合规范或建议的例子。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 4 页，共 17 页 - - - - - -

5、 - - - 武汉烽火众智数字技术有限责任公司C/C+软件编程规范(Rev.B-2009.12.07) 4 2 文件命名及书写规范【规则 2-1 】头文件统一使用.h 扩展名， C文件统一使用 .c 扩展名， C+ 统一使用 .cpp 扩展名。【规则 2-2 】文件名采用模块加说明的方式命名，不采用“_”、“- ”等分隔符，与C、C+ 文件对应的头文件的文件名保持一致。正例：nvrdiskwrite.c nvrdiskread.c 【规则 2-3 】.c 文件中，组织顺序按照文件注释、公用头文件、自用头文件、宏、结构联合（放在头文件中）、变量、函数原型、函数实现的顺序进行。.c 文件中，函数先

6、主函数，再子函数。【规则 2-4 】.h 文件的组织顺序：文件注释#ifndef 文件名 _H #define 文件名 _H include文件引用宏定义常量定义类型定义函数原型定义#endif 3 数据类型规范3.1 基本数据类型规范表 1 基本类型及前缀规范类型名定义该类型变量的前缀类型意义s8 s8 有符号的8bit整数u8 u8 无符号的8bit整数s16 s16 有符号的16bit整数u16 u16 无符号的16bit整数s32 s32 有符号的32bit整数u32 u32 无符号的32bit整数s64 s64 有符号的64bit整数u64 u64 无符号的64bit整数void v

7、 void 类型f32 f32 32 位浮点数f64 f64 64 位浮点数FILE* pf文件指针表 2 变量属性公共前缀规则前缀前缀意义a 数组类型变量名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 5 页，共 17 页 - - - - - - - - - 武汉烽火众智数字技术有限责任公司C/C+软件编程规范(Rev.B-2009.12.07) 5 p 指针类型变量t 自定义类型变量（自定义类型包括结构、联合、枚举型）ap 存放指针的数组at 存放自定义类型变量的数组pa 指向数

8、组的指针pp 指向指针的指针变量（两维指针）pt 指向自定义类型的指针变量3.2 结构、联合、枚举规范【规则 3-1】结构，联合，枚举类型定义统一使用typedef struct ,TStructTypeName的形式，即结构名采用大小写结合的方法，在开头加上T，表明是类型定义。正例：typedef struct TagLapdErrorMsg u8 u8ErrorNo; s8 s8ErrorMsg MAX_LAPD_ERROR_MSG_LEN ; TLapdErrorMsg; 反例： typedef stuct tag_lapd_error_msg BYTE ErrorNo; CHAR Er

9、rorMsg MAX_LAPD_ERROR_MSG_LEN LapdErrorMsg; typedef stuct tagLAPDERRORMSG BYTE ErrorNo; CHAR ErrorMsg MAX_LAPD_ERROR_MSG_LEN LAPDERRORMSG; 【规则 3-2】结构、联合、枚举类型变量在变量名之前加t ，结构、联合、枚举的指针类型变量在变量名之前加pt 。正例：TLapdErrorMsg *ptErrorMsg; TLapdErrorMsg tErrorMsg; 【规则 3-3 】结构体必须保证四字节对齐，且必须保证结构体的大小为4的倍数， 不够 4字节倍数的必

10、须补齐。正例：typedef struct TagLapdErrorMsg u8 u8ErrorNo; u8 u8ErrorCode; u16 u16Reseve; TLapdErrorMsg; 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 6 页，共 17 页 - - - - - - - - - 武汉烽火众智数字技术有限责任公司C/C+软件编程规范(Rev.B-2009.12.07) 6 typedef struct TagLapdErrorMsg u8 u8ErrorNo; u

11、8 u16Reseve3; u32 u32ErrorCode; TLapdErrorMsg; 反例：typedef struct TagLapdErrorMsg u8 u8ErrorNo; u8 u8ErrorCode; TLapdErrorMsg; typedef struct TagLapdErrorMsg u8 u8ErrorNo; u32 u32ErrorCode; TLapdErrorMsg; typedef struct TagLapdErrorMsg u8 u8ErrorNo; u32 u32ErrorCode; u8 u16Reseve3; TLapdErrorMsg; 【规则

12、 3-4 】结构中元素的个数应适中。若结构中元素个数过多可考虑依据某种原则把元素组成不同的子结构，以减少原结构中元素的个数。【规则 3-5 】 结构的设计要尽量考虑向前兼容和以后的版本升级，并为某些未来可能的应用保留余地（如预留一些空间等）。【规则 3-6 】对结构指针进行+、- 等操作时，一定要进行越界检查，赋值，内存越界。4 变量规范【规则 4-1 】变量名采用类似于匈牙利命名法的方法：作用域前缀、变量属性公共前缀（表2）、基本类型及前缀（表1）、变量的含义。变量含义采用大小写结合的办法。作用域前缀的结构为：变量属性公共前缀变量类型前缀。说明：作用域前缀规范如下：s_ ：静态变量前缀g_

13、：全局变量前缀m_ ：类的成员变量( 属性所对应的变量) 空：局部变量不加范围前缀正例：基本数据类型变量：u8 u8ErrorNo; /* 局部类型变量 */ u8 s_u8ErrorNo; /* 静态类型变量 */ u8 g_u8ErrorNo; /* 全局类型变量 */ 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 7 页，共 17 页 - - - - - - - - - 武汉烽火众智数字技术有限责任公司C/C+软件编程规范(Rev.B-2009.12.07) 7 指针类型变量

14、定义: u8 *pu8ErrorNo; /* 局部类型指针变量 */ u8 *s_pu8ErrorNo; /* 静态类型指针变量 */ u8 *g_pu8ErrorNo; /* 全局类型指针变量 */ 数组类型变量：u8 au8ErrorNo16; /* 局部数组类型变量 */ u8 s_au8ErrorNo16; /* 静态数组类型变量 */ u8 g_au8ErrorNo16; /* 全局数组类型变量 */ u8 *pau8ErrorNo16; /* 局部数组类型指针变量 */ u8 *s_pau8ErrorNo16; /* 静态数组类型指针变量 */ u8 *g_pau8ErrorNo1

15、6; /* 全局数组类型指针变量 */ 自定义类型变量：TLapdErrorMsg tErrorMsg; /* 自定义数据类型变量（结构、联合枚举） */ TLapdErrorMsg s_tErrorMsg; /* 静态自定义数据类型变量（结构、联合枚举） */ TLapdErrorMsg g_tErrorMsg; /* 全局自定义数据类型变量（结构、联合枚举） */ TLapdErrorMsg *ptErrorMsg; /* 自定义数据类型指针变量（结构、联合枚举） */ TLapdErrorMsg *s_ptErrorMsg; /* 静态自定义数据类型指针变量（结构、联合枚举） */ TL

16、apdErrorMsg *g_ptErrorMsg; /* 全局自定义数据类型指针变量（结构、联合枚举） */ 【规则 4-2 】定义指针类型的数据，*应放在变量前。正例： u8 *pu8OssReceiveData; 反例： u8* pu8OssReceiveData; 【规则 4-3 】去掉没必要的公共变量。公共变量是增大模块间耦合的原因之一，故应减少没必要的公共变量以降低模块间的耦合度。【规则 4-4 】仔细定义并明确公共变量的含义、作用、取值范围及公共变量间的关系。说明：在对变量声明的同时，应对其含义、作用及取值范围进行注释说明，同时若有必要还应说明与其它变量的关系。【规则 4-5 】

17、防止局部变量与公共变量同名。【规则 4-6 】变量定义之后，为防止遗忘必须进行初始化操作。5 宏定义规范【规则 5-1 】宏定义统一使用大写字母和数字，中间可以加下划线。【规则 5-2 】宏定义中如果包含表达式，表达式需用小括号括起来。【规则 5-3 】TRUE 和FALSE 的推荐定义如下：#ifndef FALSE #ifndef TRUE #define FALSE 0 #define TRUE (s32)(!0) 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 8 页，共 1

18、7 页 - - - - - - - - - 武汉烽火众智数字技术有限责任公司C/C+软件编程规范(Rev.B-2009.12.07) 8 #endif #endif 6 表达式规范【规则 6-1 】减少指针的强制类型转化。如果一定要使用的话，在转换前一定要仔细思考。【规则 6-2 】应当对指针进行合法性判断，指针变量用“=”或“！ =”与 NULL 比较。说明：指针变量的零值是“空”（记为 NULL ）。尽管 NULL 的值与 0相同，但是两者意义不同。假设指针变量的名字为p，它与零值比较的标准if 语句如下：正例：if (pu8Buff = NULL) /* pu8Buff与NULL 显式比

19、较，强调pu8Buff 是指针变量 */ if (pu8Buff != NULL) 反例：if (pu8Buff = 0) /* 容易让人误解pu8Buff 是整型变量 */ if (pu8Buff != 0) if (pu8Buff) /* 容易让人误解pu8Buff 是布尔变量 */ if (!pu8Buff) 【规则 6-2 】用 malloc 申请内存之后，应该立即检查指针值是否为空指针, 并强制转换后赋值给指针。用 free 释放了内存之后，立即将指针设置为NULL ，防止产生“野指针”。正例：u8 *pu8Buff = NULL; /* 申请内存示例 */ pu8Buff = (u

20、8 *)malloc(BUFF_SIZE); /* 释放内存示例 */ if(pu8Buff != NULL) free(pu8Buff) pu8Buff = NULL; 【规则 6-3 】 动态内存的申请与释放必须配对，防止内存泄漏。 在线程间通过消息传递的动态内存，必须遵守一个线程申请、另一个线程释放（或者说发消息之前申请，处理完消息之后释放）的原则。【规则 6-4 】不可将浮点变量用“=”或“！ =”与任何数字比较。【规则 6-5 】对于运算符比较多的表达式或语句，用括号确定表达式的操作顺序，不使用默认的优先级。正例：为了防止产生歧义并提高可读性，应当用括号确定表达式的操作顺序，如下所示

21、，word = (high 8) | low if (a | b) & (a & c) 【规则 6-6 】不要使用过多的嵌套，嵌套层次不能超过4层。如果超过 4层，应考虑重新设计程序。【规则 6-7 】低一级的程序块比上一级的代码块退后4个空格，同级程序段代码位置平齐。不要使用tab 键对齐代码，一定要使用空格键。编辑时可以把一个tab 键设成 4个空格 , 然后把 tab 键用空格键代替。采用能自动对齐格式的编辑器。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 9 页，共 17

22、页 - - - - - - - - - 武汉烽火众智数字技术有限责任公司C/C+软件编程规范(Rev.B-2009.12.07) 9 【规则 6-8 】无论 if else、for 、while 的程序块的长度为一行还是超过一行，都要用 把程序块分割。【规则 6-9 】初始化循环的代码紧放在循环前。【规则 6-10】条件判断语句内不能有赋值语句，如if(x=y)，这类语句不够明确，容易引起混淆。【规则 6-11】if 、while 等条件判断必须明确使用，=，=，!= 等判断符号。【规则 6-12】for 循环语句内的计数器不能在循环体内被修改，同时，它必须是局部变量，这样将减少出错的危险，并

23、提高程序的可读性。【规则 6-13】在代码中， 先按正常情况的路径往下写，然后再写异常情况。应该把正常情况放在if 后面而不是 else 后面。【规则 6-14】在 switch-case语句中， case 语句最后必须用break 显式地标明结束，若要继续执行下一条语句，一定要进行注释说明不用break 结束的理由，case 语句中禁止使用return直接返回 ，default不能忽略，其后要加入异常处理。【规则 6-15】switch 语句的每个分支里的语句数一般应少于30行，以提高程序的可读性。特殊情况例外。【规则 6-16】switch 中禁止直接使用数字作为case 选项 ，必须使用

24、宏定义。【规则 6-17】严禁使用未经初始化的变量作为右值。7 函数规范【规则 7-1 】函数名称采用名动结构或者动名结构，但是每个模块内部要统一采用一种风格，如SemCreate, SemDelete ，EncodeFrame等。【规则 7-2 】函数的传入参数处理不当，会产生较严重后果时，必须对参数的合法性进行必要的检查 。【规则 7-3 】函数名的长度必须控制在30字符之内。【规则 7-4 】函数定义应明确注明返回值，如果函数无返回值应明确标明void 。【规则 7-5 】函数的返回值禁止用0、1、 -1 等约定表明状态，要求用宏。【规则 7-6 】函数长度不应超过200行。如果超过 2

25、00行，就应该考虑将此子函数分为几个。【规则 7-7 】 函数的参数不要太多，不能多于六个。 如果实在比较多， 应通过传入结构的方法解决。如果函数没有参数，则用void 填充。【规则 7-8 】声明过的变量必须被使用，没有被使用的变量应从程序中取消，以提高代码的可读性和可靠性。【规则 7-9 】调用具有返回值的函数时，通常情况要判断返回的结果，并根据返回值作相应处理。【规则 7-10】函数的参数表中所有参数的总长度尽量小于40个字节，一些自定义的结构参量可以采用传递指针的方式进行参数传递，这样可以减少函数调用对系统堆栈的需求，同时防止因堆栈溢出引起的软件故障。【规则 7-11】设计高扇入、合理

26、扇出（小于7）的函数。【规则 7-12】在多任务操作系统的环境下编程，要注意函数可重入性的构造，尤其对于高扇入的函数，应尽量避免使用静态变量及局部变量。8 注释编写规范【规则 8-1 】每行注释不能超过80列。【规则 8-2 】注释统一采用中文。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 10 页，共 17 页 - - - - - - - - - 武汉烽火众智数字技术有限责任公司C/C+软件编程规范(Rev.B-2009.12.07) 10 【规则 8-3 】注释统一采用“ /*

27、,*/”，不采用“/ / ”形式。【规则 8-4 】一般情况下，源程序有效注释量必须在20以上。【规则 8-5 】注释语言必须准确、易懂、简洁，不能有二义性。【规则 8-6 】尽量避免在注释中使用缩写，特别是不常用缩写。如有必要使用缩写时，应在每一个注释段 第一次引用缩写的位置对缩写进行必要的说明。【规则 8-7 】禁止在一行代码或表达式的中间插入注释。【规则 8-8 】注释与注释作用的代码同级缩进。注释中的各个字段要用空格键对齐，不要用tab 键对齐 。在编辑代码时可以设置编辑器的tab 键用空格键代替。正例：如下注释结构比较清晰void EncodeFrame (void) /* 代码段

28、1注释 */ 代码段 1 /* 代码段 2注释 */ 代码段 2 反例：下列排版不整齐，不便于阅读；void EncodeFrame (void) /* 代码段 1注释 */ 代码段 1 /* 代码段 2注释 */ 代码段 2 【规则 8-9 】 注释应与其描述的代码相近，对代码的注释应放在其上方或右方（对单条语句的注释）相邻位置，不可放在下面，如放于上方则需与其上面的代码用空行隔开。正例：如下书写比较结构清晰/* 获取设备 ID号 */ u8DeviceId = aDevIdArrayindex; /* 代码段 1注释 */ 代码段 1 /* 代码段 2注释 */ 代码段 2 名师资料总结

29、- - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 11 页，共 17 页 - - - - - - - - - 武汉烽火众智数字技术有限责任公司C/C+软件编程规范(Rev.B-2009.12.07) 11 反例 1：如下例子注释与描述的代码相隔太远。/* 获取设备 ID好*/ u8DeviceId = aDevIdArrayindex; 反例 2：如下例子注释不应放在所描述的代码下面。u8DeviceId = aDevIdArrayindex; /* 获取设备 ID好*/ u8DeviceId =

30、aDevIdArrayindex; 反例 3：如下例子，显得代码与注释过于紧凑。/* 代码段 1注释 */ 代码段 1 /* 代码段 2注释 */ 代码段 2 【规则 8-10】在程序块的结束行右方加注释标记，以表明某程序块的结束。正例：if (.) /* program code */ while (index MAX_INDEX) /* program code */ /* end of while */ /* end of if (.)*/ 【规则 8-11】保证代码和注释的一致性，修改代码同时添加相应的注释。包括修改段起始位置注释及修改段结束位置注释。修改段起始位置注释按照下面的示例便

31、携，要标注清楚如下内容：修改时间、修改人（修改人为修改人的汉语拼音全称，方便搜索）、修改原因。正例：修改段起始位置注释: /* 修改时间 : 修改人 : 修改原因 : 修改开始*/ 修改段起始位置注释示例如下：/* 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 12 页，共 17 页 - - - - - - - - - 武汉烽火众智数字技术有限责任公司C/C+软件编程规范(Rev.B-2009.12.07) 12 修改结束*/ 【规则 8-12】 头文件、定义文件、 以及其他说明性

32、文件（如 .inc 文件、.def 文件、编译说明文件.cfg等）的头部要进行注释，注释采用统一格式如下。正例：/* 模块名：文件名：相关文件：文件实现功能：作者：版本：- 修改记录 : 日期版本修改人修改内容2011/5/8 1.0 某某 - */ 如果代码文件比较独立，注释中的“相关文件”可以空缺。当代码相对比较稳定后，任何代码修改都应该加在修改纪录中。【规则 8-13】函数注释统一采用如下格式。正例：/* 函数名：功能：输入参数说明：输出参数说明：返回值说明：*/ 9 可测性要求【规则 9-1】嵌入式设备程序中，采用统一的为集成测试与系统联调准备的调测开关及相应打印函数，并且要有详细的说

33、明。调测开关应分为不同级别和类型。打印信息采用文件保存方式，打印函数须具备对保存文件进行文件大小控制的功能，打印信息应包含模块名、函数名、行数、时间等信息，打印信息不能输出到串口控制台。【规则 9-2 】编程的同时要为单元测试选择恰当的测试点，并仔细构造测试代码、测试用例， 同时给出明确的注释说明。测试代码部分应作为（模块中的）一个子模块，以方便测试代码在模块中的安装与拆卸（通过调测开关）。【规则 9-3 】 用调测开关来切换软件的DEBUG 版和正式版， 而不要同时存在正式版本和DEBUG 版本的不同源文件， 以减少维护的难度。软件的 DEBUG版本和发行版本应该统一维护，不允许分家， 并且

34、要时刻注意保证两个版本在实现功能上的一致性。10 程序效率要求名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 13 页，共 17 页 - - - - - - - - - 武汉烽火众智数字技术有限责任公司C/C+软件编程规范(Rev.B-2009.12.07) 13 【规则 10-1】 编程时要经常注意代码的效率。说明：代码效率分为全局效率、局部效率、时间效率及空间效率。全局效率是站在整个系统的角度上的系统效率；局部效率是站在模块或函数角度上的效率；时间效率是程序处理输入任务所需的时间

35、长短；空间效率是程序所需内存空间，如机器代码空间大小、数据空间大小、栈空间大小等。【规则 10-2】在保证软件系统的正确性、稳定性、可读性及可测性的前提下，提高代码效率。循环体内工作量最小化。说明：应仔细考虑循环体内的语句是否可以放在循环体之外，使循环体内工作量最小，从而提高程序的时间效率。示例：如下代码效率不高。for (u8Ind = 0; u8Ind MAX_ADD_NUMBER; u8Ind +) u8Sum += u8Ind; u8BackSum = u8Sum; /* 备份 u8Sum */ 语句“ u8BackSum = u8Sum;”完全可以放在for 语句之后，如下。for

36、(u8Ind = 0; u8Ind MAX_ADD_NUMBER; u8Ind+) u8BackSum += u8Ind; u8BackSum = u8Sum; /*备份 u8Sum */ 【规则 10-3】不应花过多的时间拼命地提高调用不很频繁的函数代码效率。【规则 10-4】在保证程序质量的前提下，通过压缩代码量、去掉不必要代码以及减少不必要的局部和全局变量，来提高空间效率。【规则 10-5】在多重循环中，应将最忙的循环放在最内层。说明：减少 CPU 切入循环层的次数。示例：如下代码效率不高。for (u32Row = 0; u32Row 100; u32Row +) for (u32Co

37、l = 0; u32Col 5; u32Col +) sum += au32Row u32Col; 可以改为如下方式，以提高效率。for (u32Col = 0; u32Col 5; u32Col +) for (u32Col = 0; u32Col 100; u32Col +) u32Sum += au32Col u32Col; 【规则 10-6】尽量减少循环嵌套层次。【规则 10-7】避免循环体内含判断语句，应将循环语句置于判断语句的代码块之中。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - -

38、 - - 第 14 页，共 17 页 - - - - - - - - - 武汉烽火众智数字技术有限责任公司C/C+软件编程规范(Rev.B-2009.12.07) 14 说明：目的是减少判断次数。循环体中的判断语句是否可以移到循环体外，要视程序的具体情况而言，一般情况，与循环变量无关的判断语句可以移到循环体外，而有关的则不可以。示例：如下代码效率稍低。for (u32Ind = 0; u32Ind MAX_RECT_NUMBER; u32Ind +) if (u32DataType = RECT_AREA) u32AreaSum += au32RectAreau32Ind ; else u32

39、RectLengthSum += au32Rectu32Ind .length; u32RectWidthSum += au32Rectu32Ind .width; 因为判断语句与循环变量无关，故可如下改进，以减少判断次数。if (u32DataType = RECT_AREA) for (u32Ind = 0; u32Ind MAX_RECT_NUMBER; u32Ind +) u32AreaSum += au32RectAreau32Ind ; else for (u32Ind = 0; u32Ind MAX_RECT_NUMBER; u32Ind +) u32RectLengthSum

40、+= au32Rectu32Ind .length; u32RectWidthSum += au32Rectu32Ind .width; 【规则 10-8】尽量用乘法或其它方法代替除法，特别是浮点运算中的除法。说明：浮点运算除法要占用较多CPU 资源。示例：如下表达式运算可能要占较多CPU 资源。#define PAI 3.1416 f32radius = u32CircleLength / (2 * PAI); 应如下把浮点除法改为浮点乘法。#define PAI_RECIPROCAL (1 / 3.1416 ) /* 编译器编译时，将生成具体浮点数 */ f32radius = u32Ci

41、rcleLength * PAI_RECIPROCAL / 2; 11 质量保证要求【规则 11-1】代码质量保证优先原则。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 15 页，共 17 页 - - - - - - - - - 武汉烽火众智数字技术有限责任公司C/C+软件编程规范(Rev.B-2009.12.07) 15 （ 1）正确性，指程序要实现设计要求的功能。（ 2）稳定性、安全性，指程序稳定、可靠、安全。（ 3）可测试性，指程序要具有良好的可测试性。（ 4）规范 /可读性

42、，指程序书写风格、命名规则等要符合规范。（ 5）全局效率，指软件系统的整体效率。（ 6）局部效率，指某个模块/ 子模块 /函数的本身效率。（ 7）个人表达方式/ 个人方便性，指个人编程习惯。【规则 11-2】防止引用已经释放的内存空间。【规则 11-3】过程 /函数中分配的内存，在过程/ 函数退出之前要释放。【规则 11-4】过程 /函数中申请的（为打开文件而使用的）文件句柄，在过程/ 函数退出之前要关闭。【规则 11-5】防止内存操作越界。【规则 11-6】认真处理程序所能遇到的各种出错情况。【规则 11-7】系统运行之初，要初始化有关变量及运行环境，防止未经初始化的变量被引用。【规则 11

43、-8】严禁随意更改其它模块或系统的有关设置和配置。说明：编程时，不能随心所欲地更改不属于自己模块的有关设置如常量、数组的大小等。【规则 11-9】不能随意改变与其它模块的接口。【规则 11-10 】充分了解系统的接口之后，再使用系统提供的功能。【规则 11-11 】编程时，要防止差1错误。说明：此类错误一般是由于把“=”误写成“ =”误写成“ ”等造成的，由此引起的后果，很多情况下是很严重的，所以编程时，一定要在这些地方小心。当编完程序后，应对这些操作符进行彻底检查。【规则 11-12 】要时刻注意易混淆的操作符。当编完程序后， 应从头至尾检查一遍这些操作符，以防止拼写错误。说明：形式相近的操

44、作符最容易引起误用，如C/C+中的“ =”与“ =”、“ | ”与“ | ”、“ &”与“ & ”等，若拼写错了，编译器不一定能够检查出来。示例：如把“&”写成“ & ”，或反之。u32RetFlg = (ptMsg-ret_flg & RETURN_MASK); 被写为：u32RetFlg = (ptMsg -ret_flg & RETURN_MASK); u32RptFlg = (VALID_TASK_NO( taskno ) & DATA_NOT_ZERO( stat_data ); 被写为：u32RptFlg = (VALID_TASK_NO( taskno ) & DATA_NOT_

45、ZERO( stat_data ); 【规则 11-13 】 有可能的话， if 语句尽量加上 else 分支，对没有 else 分支的语句要小心对待；switch语句必须有 default分支。【规则 11-14 】不要滥用 goto 语句。说明： goto 语句会破坏程序的结构性，所以除非确实需要，最好不使用goto 语句。【规则 11-15 】不使用与硬件或操作系统关系很大的语句，而使用建议的标准语句，以提高软件的可移植性和可重用性。【规则 11-16 】除非为了满足特殊需求，避免使用嵌入式汇编。说明：程序中嵌入式汇编，一般都对可移植性有较大的影响。【规则 11-17 】时刻注意表达式是

46、否会上溢、下溢。示例：如下程序将造成变量下溢。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 16 页，共 17 页 - - - - - - - - - 武汉烽火众智数字技术有限责任公司C/C+软件编程规范(Rev.B-2009.12.07) 16 u8 u8Size ; while (u8Size - = 0) /* 将出现下溢 */ . /* program code */ 当 size 等于 0 时，再减 1 不会小于 0，而是 0 xFF，故程序是一个死循环。应如下修改。s8

47、 s8Size; /* 从unsigned char 改为 signed char */ while (s8Size - = 0) . /* program code */ 【规则 11-18 】使用变量时要注意其边界值的情况。示例：如 C 语言中字符型变量，有效值范围为-128 到127。故以下表达式的计算存在一定风险。char chr = 127; int sum = 200; chr += 1; /* 127 为chr 的边界值，再加1 将使 chr 上溢到 -128，而不是 128。 */ sum += chr; /* 故sum 的结果不是 328，而是 72。 */ 若 chr 与s

48、um 为同一种类型，或表达式按如下方式书写，可能会好些。sum = sum + chr + 1; 【规则 11-19 】留心程序机器码大小（如指令空间大小、数据空间大小、堆栈空间大小等）是否超出系统有关限制。【规则 11-20 】对一些具有危险性的操作代码（如写硬盘、删数据等）要仔细考虑，防止对数据、硬件等的安全构成危害，以提高系统的安全性。【规则 11-21 】使用第三方提供的软件开发工具包或控件时，要注意以下几点：（ 1）充分了解应用接口、使用环境及使用时注意事项。（ 2）不能过分相信其正确性。（ 3）除非必要，不要使用不熟悉的第三方工具包与控件。说明：使用工具包与控件，可加快程序开发速度

49、，节省时间，但使用之前一定对它有较充分的了解，同时第三方工具包与控件也有可能存在问题。【规则 11-22 】资源文件（多语言版本支持），如果资源是对语言敏感的，应让该资源与源代码文件脱离，具体方法有下面几种： 使用单独的资源文件、 DLL文件或其它单独的描述文件（如数据库格式） 。【规则 11-23 】程序编译时，除了关心Error 外，对于 warning 也要引起重视。说明：尽量消除所有的warning ，因为在消除warning 时，也可发现代码容易出错的位置。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 17 页，共 17 页 - - - - - - - - -