手机软件编程规范(V10)

《手机软件编程规范(V10)》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、手机软件编程规范-C/C++篇软件编程规范-C/C++篇（试用版）中兴通讯股份有限公司手机事业部软件部版权所有不得复制手机软件编程规范-C/C++篇修订记录日期修订版本描述修改人2004-12-30试用版初稿完成杨玥2005-1-6试用版收集开发人员的意见,并对初稿进行了修订杨玥2005-1-14试用版EPG小组第一次评审,对注释和函数命名规则进行了修改杨玥手机软件编程规范-C/C++篇目次1范围32术语和定义32.1规则32.2建议32.3说明32.4正例32.5反例33基本原则34布局44.1文件布局44

2、.2注释64.3基本格式114.4对齐124.5空行空格144.6断行155命名规则166变量、常量与类型206.1变量与常量、宏216.2类型247表达式与语句298函数与过程348.1参数358.2返回值368.3内部实现368.4函数调用399可靠性419.1内存使用419.2指针使用439.3类和函数4410可测试性4911断言与错误处理51手机软件编程规范-C/C++篇手机软件编程规范—C/C++1前言本规范规定了手机软件开发中C/C++语言的编程规范。本规范适用于手机软件部内使用C/C++语言编码

3、的所有手机软件。本规范自生效之日起，对以后新编写的和修改的代码有约束力。在本规范中没有说明的，请按照公司制订的《软件编程规范—C/C++》执行，对于本规范与《软件编程规范—C/C++》相冲突的内容，以本规范为准。对于特定平台或项目相关的规范，还应参考特定平台的编码规范。比如对于BREW平台，应遵循《基于BREW平台的软件编程规范》2术语和定义下列术语和定义适用于本标准。2.1规则编程时必须遵守的约定。2.2建议编程时必须加以考虑的约定。2.3说明对此规则或建议的必要的解释。2.4正例对此规则或建议给出的正确例

4、子。2.5反例对此规则或建议给出的反面例子。3基本原则【原则】首先是为人编写程序，其次才是计算机。说明：这是软件开发的基本要点，软件的生命周期贯穿产品的开发、测试、生产、用户使用、版本升级和后期维护等长期过程，只有易读、易维护的软件代码才具有生命力。【原则】保持代码的简明清晰，避免过分的编程技巧。说明：简单是最美。保持代码的简单化是软件工程化的基本要求。不要过分追求技巧，否则会降低程序的可读性。【原则】所有的代码尽量遵循ANSIC标准。手机软件编程规范-C/C++篇说明：所有的代码尽可能遵循ANSIC标准，尽

5、可能不使用ANSIC未定义的或编译器扩展的功能。【原则】编程时首先达到正确性，其次考虑效率。说明：编程首先考虑的是满足正确性、健壮性、可维护性、可移植性等质量因素，最后才考虑程序的效率和资源占用。【原则】避免或少用全局变量。说明：过多地使用全局变量，会导致模块间的紧耦合，违反模块化的要求。【原则】尽量避免使用GOTO语句。【原则】尽可能重用、修正老的代码。说明：尽量选择可借用的代码，对其修改优化以达到自身要求。【原则】尽量减少同样的错误出现的次数。说明：事实上，我们无法做到完全消除错误，但通过不懈的努力，可以

6、减少同样的错误出现的次数。1布局1.1文件布局【规则】遵循统一的布局顺序来书写头文件。说明：以下内容如果某些节不需要，可以忽略。但是其它节要保持该次序。头文件布局:文件头（参见第三章“注释”）#ifndef文件名_H（全大写）#define文件名_H手机软件编程规范-C/C++篇其它条件编译选项#include（依次为标准库头文件、非标准库头文件）常量定义全局宏全局数据类型类定义模板（template）（包括C++中的类模板和函数模板）全局函数原型#endif【规则】遵循统一的布局顺序来书写实现文件。说明：以

7、下内容如果某些节不需要，可以忽略。但是其它节要保持该次序。实现文件布局：文件头（参见第三章“注释”）#include（依次为标准库头文件、非标准库头文件）常量定义文件内部使用的宏文件内部使用的数据类型全局变量本地变量（即静态全局变量）局部函数原型类的实现全局函数局部函数【规则】头文件必须要避免重复包含。说明：可以通过宏定义来避免重复包含。正例：#ifndefMODULE_H#defineMODULE_H[文件体]#endif【规则】包含标准库头文件‘括号<>，包含非标准库头文件用双引号“”。正例：#inclu

8、de#include“heads.h”【规则】遵循统一的布局顺序来书写实现文件。说明：以下内容如果某些节不需要，可以忽略。但是其它节要保持该次序。手机软件编程规范-C/C++篇实现文件布局：文件头（参见“注释”一节）#include（依次为标准库头文件、非标准库头文件）常量定义文件内部使用的宏文件内部使用的数据类型全局变量本地变量（即静态全局变量）局部函数原型类的实现全局函数局部函