C语言编写规范讲义.docVIP

C语言编写规范讲义 排版： 程序块要采用缩进风格编写，缩进的空格数为2个。程序块的分界符（‘{’和‘}’）应各独占一行并且位于同一列，同时与引用它们的语句左对齐。 示例： uint temp_segment; static bit Tightwire_first_flag = 1; int i; if(Tightwire_first_flag==1) //第一次调用函数,读入初值 { if(Work_Condition.Menu_Item==1||Work_Condition.Menu_Item==4) //主臂工况 { if(W0_Data==W0_type[0]) temp_segment = (uint)(Falls-1)*Tightwire_Segment; else if(W0_Data==W0_type[1]) temp_segment = (uint)(Falls-1+Times_Num)*Tightwire_Segment; else temp_segment = (uint)(Falls-1+Times_Num*2)*Tightwire_Segment; } } 相对独立的程序块之间、变量说明之后必须加空行。 循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，操作符放在新行之首。 示例： if( UART0_Receive_Buffer[0]==SUART0_Receive_Buffer[1]==a UART0_Receive_Buffer[2]==vUART0_Receive_Buffer[3]==e UART0_Receive_Buffer[4]==AUART0_Receive_Buffer[5]==D UART0_Receive_Buffer[6]==*UART0_Receive_Buffer[7]==#) Save_AD=1; 不允许把多个短语句写在一行中，即一行只写一条语句。 示例： temp = 1.3; temp1 = 0.7; //错误 temp = 1.3; temp1 = 0.7; //正确 if、for、do、while、case、switch、default等语句自占一行。 示例： switch(num) { case 0: temp = 1.3; //错误 break; case 1: temp = 0.7; break; //错误 case 2: temp = 1.3; break; //正确 } 注释： 注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁 头文件.h文件、源文件.c文件头部都应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能等。 //===========================================================================// //文件名: Arithmetic_Core.h //描述: 核心算法参数表，头文件 //编写: 刘锦华 //版本信息: V1.0 2007年07月24日 //修改信息: //===========================================================================// 函数头部应进行注释，列出：函数的目的/功能、输入参数、输出参数、返回值、调用关系（函数、表）等。 //==========================================================================// //函数名: void Deta_Save(unsigned char num,float temp) //参数: num: 0-上升修正值 1-〉下降修正值 2-〉R0修正值 //返回值: 无 //描述: 往铁电中存储修正数据 //编写: 刘锦华 //版本信息: V1.0 2007年07月29日 //修改信息: //===========================================================================// 边写代码边注释，修改代码同时修改相应的注释，以保证注释与代码的一致性。不再有用的注释要删除。 避免在注释中使用缩写，特别是非常用缩写。 注