您好,欢迎访问三七文档
TRZNTRZN嵌入式软件编程规范TRZN项目:Embeddedsoftwaredevelopment领域:SWEngineering文件名称:嵌入式软件编程规范文件号:SW-00-00-0001版本号:0.1日期:2016-10-28所属部门:电控质量管理部仅限项目组内部传阅Page2of47文档修改历史:版本号日期修改者及常用邮箱修改日志0.12016-10-28杨科ykee126@126.com根据查阅的相关资料整理,此版本为第一次提交。TRZN项目:Embeddedsoftwaredevelopment领域:SWEngineering文件名称:嵌入式软件编程规范文件号:SW-00-00-0001版本号:0.1日期:2016-10-28所属部门:电控质量管理部仅限项目组内部传阅Page3of471文档概述......................................................................................................................................................................41.1关于本文档..............................................................................................................................................................41.2参考文献..................................................................................................................................................................42排版..............................................................................................................................................................................53注释............................................................................................................................................................................104标识符命名................................................................................................................................................................195可读性........................................................................................................................................................................256变量、结构................................................................................................................................................................267宏................................................................................................................................................................................318函数、过程................................................................................................................................................................339可测性........................................................................................................................................................................4110代码版本管理............................................................................................................................................................4410.1代码质量定义........................................................................................................................................................4410.2GIT分支定义.........................................................................................................................................................4410.3GIT代码引入规定.................................................................................................................................................4410.4GIT代码COMMIT顺序..........................................................................................................................................4510.5COMMIT文件过程中的其他注意事项..................................................................................................................4511附录A–推荐编辑器的默认配置修改....................................................................................................................4611.1KEILUVISION5默认配置修改...............................................................................................................................46TRZN项目:Embeddedsoftwaredevelopment领域:SWEngineering文件名称:嵌入式软件编程规范文件号:SW-00-00-0001版本号:0.1日期:2016-10-28所属部门:电控质量管理部仅限项目组内部传阅Page4of471文档概述1.1关于本文档本文档规范了芜湖天人智能有限公司嵌入式软件部软件代码的书写规范和原则。本文档仅供公司内部员工使用。公司机密,严禁外传。本文档中各规则的格式如下:【规则编号】[规则内容][[标记]]其中[标记]的含义如下:(必须):表示该条规则是必须遵守的。(建议):表示该条规则是建议遵守的。(可选)或没有标记:表示该条规则是可选择遵守的。本文档的示例中,如有使用“//”,并非代码注释,而是文档的注释(有可能是文档中对代码注释的解释)。1.2参考文献[1]高质量C++编程[2]EffectiveC++[3]MoreEffectiveC++[4]C++Primer[5]ThinkinginC++TRZN项目:Embeddedsoftwaredevelopment领域:SWEngineering文件名称:嵌入式软件编程规范文件号:SW-00-00-0001版本号:0.1日期:2016-10-28所属部门:电控质量管理部仅限项目组内部传阅Page5of472排版【规则2-1】程序块要采用缩进风格编写,缩进的空格数为4个,对齐使用空格键,不得使用TAB键。[必须]嵌入式软件开发的代码编辑器,推荐使用KeiluVision5,编辑器参数设置见附录A。【规则2-2】相对独立的程序块之间、变量说明之后必须加空行。[必须]示例:不正确的书写方式:if(!rpr_valid_ni(ni)){...//programcode}gRprRepssnInd=gRprSsnData[idx].repssn_index;gRprRepssnNi=gRprSsnData[idx].ni;正确的书写方式:if(!rpr_valid_ni(ni)){...//programcode}//空行gRprRepssnInd=gRprSsnData[idx].repssn_index;gRprRepssnNi=gRprSsnData[idx].ni;【规则2-3】较长的语句(80字符)要分成多行书写,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读。[必须]示例:gRprPermCountMsg.head.len=RPR_NO7_TO_STAT_PERM_COUNT_LEN+RPR_STAT_SIZE_PER_FRAM*sizeof(UINT32);gSysAcbTaskTable[frame_id*RPR_STAT_TASK_CHECK_NUMBER+index].nOccupied=rprStatPoi[index].nOccupied;gSysAcbTaskTable[taskno].nDurationTrueOrFalse=SYS_getSccpStatisticState(statItem);gRprReportOrNotFlag=((SYS_MAX_ACT_TASK_NUMBERtaskno)&&(SYS_n7statStatItemValid(statItem))&&(0!=gSYSActTaskTable[taskno].resultData));【规则2-4】循环、判断等语句中若有较长的表达式或语句,则要进行适当的分行,长表达式要在低优先级操作符处划分新行
本文标题:嵌入式软件编程规范
链接地址:https://www.777doc.com/doc-4331264 .html