软件开发与项目管理-_软件编码规范

《软件开发与项目管理-_软件编码规范》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、内部资料注意保密软件编程规范文档编号：HKVS_SW_RULE_SCR_V1.1密级：版本信息：V1.1建立日期：2007-09-17创建人：夏哲星审核者：批准人：批准日期：文档修订记录版本编号或者更改记录编号*变化状态简要说明（变更内容和变更范围）日期变更人批准日期批准人V0.50A2007-9-17夏哲星V1.00M2007-10-15夏哲星V1.10M再次讨论后修改2008-5-15陈华林*变化状态：A——增加，M——修改，D——删除目录前言1第1章排版2第2章注释5第3章命名规则8第4章表达式和基本语句10第5章变量、结构15第6章函数、过程21第7

2、章内存管理25第8章宏26第9章可测性27软件编程规范前言为了提高源程序的质量和可维护性，最终提高公司软件产品生产力，对公司软件产品的源程序的编写风格作出统一的规范约束。本规范是独立于具体语言的编程规则的总的原则，针对不同编程语言或应用环境的编程规范在遵守本规范总则的基础上，还必须遵守相应语言和就用环境的编程规范。本规范的内容包括：排版、注释、命名规则、变量使用、代码可测性等。本规范的示例都以C语言为背景，采用以下的术语描述：★规则：编程时强制必须遵守的原则。★建议：编程时必须加以考虑的原则。★说明：对此规则或建议进行必要的解释。★示例：对此规则或建议给出例子

3、。29杭州海康威视数字技术有限公司版权所有软件编程规范第1章排版1-1．[建议]：采用缩进风格编写，缩进的空格数为4个。[说明]：缩进使用空格键，不使用TAB键。避免使用不同编辑器阅读程序时，因TAB键所设置的空格数目不同而造成程序布局不整齐。在函数或过程的开始、结构的定义及循环、判断等语句中的代码要采用缩进风格。case语句也要遵从语句缩进要求。1-2．[建议]：相对独立的程序块间、变量说明之后必须加空行。1-3．[建议]：较长的语句要分成多行书写。[说明]：长语句要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进。使排版整齐，语

4、句可读。[示例]：act_task_table[frame_id*STAT_TASK_CHECK_NUMBER+index].occupied=stat_poi[index].occupied;report_or_not_flag=((taskno

5、tat_item))){...//programcode}for(i=0,j=0;(i

6、;rect.width=0;应如下书写rect.length=0;29杭州海康威视数字技术有限公司版权所有软件编程规范rect.width=0;1-1．[规则]：if、for、do、while、case、switch、default等语句独自占一行，且if、for、do、while等语句的执行语句部分无论多少都要加括号{}。[示例]：如下例子不符合规范。if(pUserCR==NULL)return;应如下书写：if(pUserCR==NULL){return;}1-2．[规则]：同一文件中{}的风格应该保持一致。1-3．[建议]：程序块的分界符（如C/C++

7、语言的大括号‘{’和‘}’）应各独占一行并且位于同一列，同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。[示例]：如下例子不符合规范。for(...){...//programcode}if(...){...//programcode}voidexample_fun(void){...//programcode}应如下书写。for(...){...//programcode}if(...){...//programcode}29杭州海康威视

8、数字技术有限公司版权所有软件编程规范v