软件编程参考规范

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

1、专业的嵌入式技术研发、推广、培训、认证机构软件编码参考规范一、整体格式☞1-1程序块要采用缩进风格编写，使用TAB控制缩进。☞1-2函数的定义采用Linux内核编程风格,即函数类型与函数名称不分行。☞1-3左右花括号的位置采用GNU编程风格，即左括号与右括号都在同一列左对齐。✍示例：✍✓staticintsub(intmask,int*dest)✍{✍if(mask!=100)✍{✍return1;✍}✍return0;✍}✍>-----------------------------------------------------------------<✍✗

2、staticint✍sub(intmask,int*dest)✍{✍if(mask!=100){✍return1;✍}✍return0;✍}✍☞1-4相对独立的代码段之间，变量说明之后，插入一个空行分隔。☞1-5相邻的函数块之间，插入一个空行分隔。✍示例：✍✓staticintsub(intmask,int*dest)✍{✍inttest;✍chartmp;✍/*-->此处加入一空行分隔*/✍test=mask+100;✍tmp=test;✍if(tmp==101)✍return0;✍else✍return1;✍}第8页共8页――软件编码参考规范――软件文档专业

3、的嵌入式技术研发、推广、培训、认证机构✍/*-->此处加入一空行分隔*/✍staticvoidmul(void)✍{✍return0;✍}✍>-----------------------------------------------------------------<✍✗staticintsub(intmask,int*dest)✍{✍inttest;✍chartmp;✍test=100;✍tmp=test;✍return0;✍}✍staticvoidmul(void)✍{✍return0;✍}☞1-6关键字if,while,for与其后的条件判断的表达式

4、之间，插入一个空格分隔。☞1-7数学运算符+-*/=,数值判断符!===><<>其左右两侧的标识符之间,插入一个空格分隔。单目运算符!~++--&.->等前后不加空格。☞1-8函数调用和函数定义中的括号()与其中参数之间紧贴，不要使用空格分隔。☞1-9算术表达式（包含条件表达式）和它左右的括号()之间紧贴，不要使用空格分隔，防止结构松散。✍示例：✍✓intsample(intx,inty)✍{✍for0(count0=01;count0<0100;count++)✍mask0=0x0+0count0*0(y0+0100);✍if0(mask0!=0100)✍wh

5、ile0(!test(condition))✍return1;✍}✍>-----------------------------------------------------------------<✍✗intsample0(0intx,inty0)✍{✍for(count=1;count<100;count0++)✍mask=x+count*(y+100);✍if(0mask!=1000)✍while(0!0test(0condition0))✍return1;✍}第8页共8页――软件编码参考规范――软件文档专业的嵌入式技术研发、推广、培训、认证机构✍注：✓

6、内的空格0都是规则必须的；✗内的空格0都是规则禁止的；☞1-10较长的语句（>80字符）要分行书写，对齐格式如下所示。✍示例：✍✓report_or_not_flag=((taskno-----------------------------------------------------------------<✍✗report_or_not_flag=((taskno

7、AX_ACT_TASK_NUMBER)✍&&(n7stat_stat_item_valid(stat_item))✍&&(act_task_table.result_data!=0))二、注释风格☞2-1所有注释出现的位置可以是以下之一：a).整个源文件的最顶部，说明此模块的相关信息，一般为多行注释。b).源文件内部定义的函数实现上侧，紧贴其函数实现部分，不用空行分隔。c).相对独立的代码段上侧，紧贴其注释说明的实现代码，不用空行分隔。d).简短的代码行右侧，一般为单行注释，内容不超过10个单词。✍示例：✍✓/*✍*robot/sercos.c✍*copyrig

8、ht(C)2002-4-