华为软件编程规范标准[详]

《华为软件编程规范标准[详]》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、........文档编号产品版本受控状态DC-SB-2003-1005V1.0内部Page:1密级可以选择以下几种：无，一般，内部，组内，秘密，绝密等。产品名称：软件编程规范共页软件编程规范(仅供内部使用)北京世纪百合科技有限公司BeijingCenturialLilyTechnologyCo.,Ltd.版权所有不得复制参考.资料........参考.资料........文档修改记录版本号日期所改页注记提交人批准人参考.资料........参考.资料........目录1.引言41.1目的41.2范

2、围42.规范42.1文件42.2版面风格42.3标识符命名82.4函数与宏102.5代码的可靠性143.附录：通用类型的公共定义19参考.资料........1.引言1.1目的本规范的目的在于增加源代码的可读性，减少程序员对代码理解上的偏差，使程序员能够编写出可靠的代码，降低代码维护成本。1.2范围本规范内容涉及范围包括：文件、版面、注释、标识符、变量和结构、函数、宏以及可理解性等。本规范适用于公司开发的所有软件产品。在新软件的编码过程中本规范必须执行。2.规范2.1文件2.1.1头文件的名称一律为

3、小写，格式为“子系统名_文件名.h”。例如：ipf_protocol.h等。2.1.2头文件的格式如下：Ø注释头，格式参见软件编程规范；Ø头文件预编译开关开始，格式为：#ifndef预编译开关#define预编译开关其中预编译开关格式为：“_文件名_H”，其中文件名一律大写Ø头文件内容；Ø头文件预编译开关结束，格式为：#endif用来和头文件预编译开关的开始对应。例如：以下为ipf_ip.h头文件的内容：/***********************************************

4、************* Copyright(c)LilyOfTheCenturyTechnologyCo.,LTD.ALLRIGHTSRESERVED Description://用于详细说明此程序文件完成的主要功能*************************************************************/#ifndef_IPF_IP_H#define_IPF_IP_H...参考.资料........<头文件正文>...参考.资料........#endif1.1

5、.1头文件的定义要有层次，禁止交叉引用。说明：头文件的层次设置为公共模块、私有模块。头文件的引用次序为下层头文件引用上层头文件、私有头文件引用公共头文件，声明结构时尤其要注意，不允许出现交叉引用的情况。示例：如下定义不符合规范头文件isdn_a.h/************************************************************ Copyright(c)LilyOfTheCenturyTechnologyCo.,LTD.ALLRIGHTSRESERVED De

6、scription:定义配置数据结构************************************************************/#ifndef_ISDN_A_H#define_ISDN_A_H#include“isdn_b.h”typedefstruct{...;ISDN_CONTROLstIsdnControl;...;}ISDN_CONFIG;#endif参考.资料........头文件isdn_b.h/*******************************

7、***************************** Copyright(c)LilyOfTheCenturyTechnologyCo.,LTD.ALLRIGHTSRESERVED Description:定义控制数据结构*************************************************************/#ifndef_ISDN_B_H#define_ISDN_B_H#include“isdn_a.h”typedefstruct{...;ISDN_CON

8、FIGstIsdnConfig;...;}ISDN_CONTROL;#endif为了解决上述矛盾，可以将两个结构合并到一个文件中声明。1.1.1文件中如果引用系统头文件，必须使用“<“和“>“；如果引用自定义的头文件，必须使用“”“和“”“。说明：系统头文件是指由编译系统提供的头文件。示例：如下书写不符合规范。#include“stdlib.h”#include应该改作：#include#include“isdn_co