软件编码和命名规范

《软件编码和命名规范》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、XXXXXXXX有限公司XXXX项目编码和命名规范XXXXXX项目编码和命名规范项目号版本号作成者确认者承认者制定日CONFIDENTIAL24/24XXXXXXXX有限公司XXXX项目编码和命名规范变更记录版本发布日担当者内容CONFIDENTIAL24/24XXXXXXXX有限公司XXXX项目编码和命名规范目录变更记录2目录31.概述51.1.目的51.2.构成52.详述62.1.版权声明62.2.文件结构72.2.1.头文件结构72.2.2.定义文件的结构73.命名规则93.1共性规则93.2标准字典114.注释135.程序版式155.1 缩进155.2 空行155.3 代码行155.

2、4 对齐165.5 修饰符的位置186.语法规范196.1 运算符的优先级19CONFIDENTIAL24/24XXXXXXXX有限公司XXXX项目编码和命名规范6.2 switch 语句196.3 函数参数196.4 goto语句207.关于可自动添加注释的宏217.1 概述217.2 功能217.2.1.XXXX_InsertFileHeader217.2.2XXXX_InsertFuncNote217.2.3XXXX_CreateFuncNote227.2.4XXXX_DeleteNote227.2.5XXXX_ModifyNote227.2.6XXXX_Note237.3 配置23C

3、ONFIDENTIAL24/24XXXXXXXX有限公司XXXX项目编码和命名规范1.概述1.1.目的在XXXX项目架构设计开始之时，有必要建立起适合本项目的编码规范以及命名规约，为顺利开展软件架构设计及随后的各阶段设计工作提供必要的基准和规范。本编码规范是在《XX软件课编码规范》的基础上，根据本案的特点进行必要的补充和修正而制定完成的。此编码规范是以C语言作为开发语言的前提下编写的，在项目的整个生命周期中，以此作为开发工作开展的基准。1.2.构成XXXX项目编码规范主要由以下几个部分构成：(1)版权声明。(2)文件结构。(3)命名规则。(4)程序版式。(5)语法规范。(6)自动注释添加。C

4、ONFIDENTIAL24/24XXXXXXXX有限公司XXXX项目编码和命名规范2.详述122.1.版权声明版权声明位于头文件和定义文件的开头（参见示例1-1），主要内容有：(1)版权信息(2)文件名称，摘要(3)日期，作者和修改内容示例2-1版权声明【规则2-1-1】修改内容要注明修改原因，比如Bug修正、式样变更和增加新功能等。CONFIDENTIAL24/24XXXXXXXX有限公司XXXX项目编码和命名规范2.2.文件结构2.2.1.头文件结构头文件由四部分内容组成：(1)头文件开始处的版权声明（参见示例2-1）。(2)预处理块。(3)宏定义。(4)函数和结构体的声明。假设头文件名

5、称为Head.h，头文件的结构参见示例2-2。【规则2-2-1】为了防止头文件被重复引用，应当用预编译伪指令ifndef/define/endif结构产生预处理块。假设头文件名称为Head.h，Head.h变为HEAD_H在头文件中的预编译伪指令中使用，参见示例2-1。【规则2-2-2】用#include格式来引用标准库的头文件。【规则2-2-3】用#include“filename.h”格式来引用非标准库的头文件。示例2-2头文件的结构2.2.2.定义文件的结构定义文件有四部分内容：(1)定义文件开头处的版权声明（参见示例2-1）。(2)对头文件的引用。(3)宏定义

6、、函数的引用声明及变量定义。(4)程序的实现体。CONFIDENTIAL24/24XXXXXXXX有限公司XXXX项目编码和命名规范定义文件的结构参见示例2-3。示例2-3定义文件的结构CONFIDENTIAL24/24XXXXXXXX有限公司XXXX项目编码和命名规范3.命名规则3.1共性规则命名的两个基本原则：(1)含义清晰，不易混淆。(2)不和其它模块、系统API的命名相冲突。【规则3-1-1】标识符应当直观且可以拼读，可望文知意。标识符应采用英文单词或其组合，便于记忆和阅读。切忌使用汉语拼音来命名。程序中的英文单词不应太复杂，用词应当准确。【规则3-1-2】标识符的长度应当符合“mi

7、n-length&&max-information”原则。例如：变量名MaxVal就比MaxValueUntilOverflow，简洁易懂。【规则3-1-3】程序中不要出现仅靠大小写区分的相似的标识符。例如：intx,X;/*变量x与X容易混淆*/voidfoo(intx);/*函数foo与FOO容易混淆*/voidFOO(floatx);【规则3-1-4】程序中不要出现标识符完全相同的局部变量和全局变量，尽