c语言编程规范

C语言编程规范一、排版1.采用阶梯层次组织代码函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格，case语句下的情况处理语句也要遵从语句缩进要求。各层次缩紧的风格采用TAB缩进。注意：右括号所在的行不应当有其它东西，除非跟随着一个条件判断。也就是do-while语句中的“while”。2.及时折行较长的语句（80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进（至少1个TAB位置），使排版整齐，语句可读。循环、判断等语句中若有较长的表达式或语句，则要进行适当的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首。3.语句的书写格式1.一行只写一条语句2.switch、if、while、do、for规则如下：(1)switch语句的书写格式switch（ch）{case1://注释statements;break;case2://注释statements;break;default://注释statements;break;}(2)if语句的书写格式If(条件){//注释statements;}elseif(条件){//注释statements;}else{//注释statements;}(3)while语句的书写格式while(条件){statements;}(4)do语句的书写格式do{statements;}while(条件);//注释(5)for语句的书写格式for(...;...;...){//注释statements;}4.空行(1)变量说明之后必须加空行。(2)相对独立的程序块之间应加空行。5.空格(1)逗号、分号只在后面加空格。inta,b,c;(2)比较操作符，赋值操作符“=”、“+=”，算术操作符“+”、“%”，逻辑操作符“&&”、“&”，位域操作符“”等双目操作符的前后加空格。if(current_time=MAX_TIME_VALUE)a=b+c;a*=2;(3)“！”、“~”、“++”、“--”、“&”(地址运算符)等单目操作符前不加空格。*p=‘a’;//内容操作“*”与内容之间flag=!isEmpty;//非操作“!”与内容之间i++;//“++”、“--”与内容之间p=&mem;//地址操作“&”与内容之间(4)“-”、“.”前后不加空格p-id=num;//“-”指针前后不加空格(5)if、for、while、switch等与后面的括号间应加空格，使if等关键字更为突出、明显。if(a=b&&cd);6.对变量的定义，尽量位于函数的开始位置(1)应避免分散定义变量。(2)同一类的变量在同一行内定义，或者在相邻行定义。(3)数组、指针等复杂类型的定义放在定义区的最后。(4)变量定义区不做较复杂的变量赋值。7.程序各部分的放置顺序在较小的项目中，按如下顺序组织安排程序各部分：(1)#includeC的标准头文件。(2)#include“用户自定义的文件”。(3)#define宏定义。(4)全局变量声明。(5)函数原型声明。(6)用户自定义函数。(7)main函数定义二、注释1.注释的原则和目的注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。一般情况下，源程序有效注释量必须在20%以上。2.函数头部应进行注释(1)修改代码同时修改相应的注释，以保证注释与代码的一致。不再有用的注释要删除。(2)注释的内容要清楚、明了，含义准确，防止注释二义性。(3)避免在注释中使用缩写，在使用缩写时或之前，应对缩写进行必要的说明。(4)注释应与其描述的代码相近，对代码的注释应放在其上方或右方(对单条语句的注释)相邻位置，不可放在下面。除非必要，不应在代码或表达中间插入注释，否则容易使代码可理解性变差。(5)对于所有有物理含义的变量、常量，如果其命名不是充分自注释的，在声明时都必须加以注释，说明其物理含义。变量、常量、宏的注释应放在其上方相邻位置或右方。(6)注释与所描述内容进行同样的缩排，让程序排版整齐，并方便注释的阅读与理解。(7)将注释与其上面的代码用空行隔开。(8)注释格式尽量统一，建议多行注释使用“/*.....*/”，单行注释使用“//”。三、命名规则1.常量命名常量包括宏定义和自定义类型，常量名必须大写。#defineNUL0Typedefstruct{statements;}MYSTRU;2.变量命名变量应尽量按它所表示的内容来命名，使人易懂，且变量名的长度要合适，最好为3~15个字符，循环变量可以用ijk等单个字母表示。如果变量名由几个单词表示，则单词首字母大写。四、变量与结构(1)谨慎使用全局(公共)变量，去掉没必要的公共变量。(2)仔细定义并明确公共变量的含义、作用、取值范围及公共变量间的关系。在对变量声明的同时，应对其含义、作用及取值范围进行注释说明，同时若有必要还应说明与其他变量的关系。(3)防止局部变量与公共变量同名——通过使用较好的命名规则来消除此问题。参考来源：[1].C语言中文网[2].百度文库=view