C语言初学者编程规范十条

从事C语言的教学也有不短期了，在教学中发现学生们在编程方面有一个极很差的习惯，就是随意命名，这不只给本身往后阅读本身程序时带来不便，也给其余的程序阅读者带来麻烦，更重要的是没有统一的规范总显得像是个游击队，没有正规军的感受，企业也不肯意要业余选手，因此C语言的初学者最好一开始就培养一种良好的编程习惯，也许往后进入公司有些改动，须要适应，但基本的规范和规则是不须要改的，这样能够帮助你少走不少弯路，通过这些年的学习和工做，总结了一些规范的内容，为了好记，便于传播，特总结为十条，建议读者采纳。

  第一：标识符的命名要清晰、明了，有明确含义，同时使用完整的单词或你们基本能够理解的缩写，避免令人产生误解。程序中的英文单词通常不会太复杂，用词应当准确。例如不要把CurrentValue写成NowValue。

 

  第二：不容许使用汉语拼音命名，更不要使用汉语，必须使用英文来命名标识符。尽可能避免名字中出现数字编号，如Value1,Value2等，除非逻辑上的确须要编号。

 

  第三：函数名、变量名从第二个单词起首字母大写。如：printName(), oldName等

 

  第四：在C 程序中只使用const常量而不使用宏常量，即const常量彻底取代宏常量。常量定义以大写字母K开头，字母所有使用大写，如：const int KSIZE = 100。

 

  第五：代码缩进使用4个空格，不推荐使用TAB键

 

  第六：版权和版本的声明位于文件的开头；函数头部应进行注释，列出：函数的功能、输入参数、输出参数、返回值等。关键代码注释位于被注释代码上方，且用空行与其余代码分割开，如：

文件头注释：

author: SDL team

function: testing hardware drivers and IDE

date: 2009.10

copy right: Software College Of HeBei Normal University

 

 

 

函数注释：

function:SDL initial

parameter: none

return: bool

       true:  initial SDL normally

       false:  initial SDL abnormally

 

 

 

关键代码注释：

pTemp = SDL_LoadBMP(aFileName);

 

//format BMP file

*aImg = SDL_DisplayFormat(pTemp);    

 

SDL_FreeSurface(pTemp);

 

 

 

 第七：静态变量加前缀s_，如：static  int  s_count = 0;

 

 第八：尽可能避免应用全局变量，若是有特殊状况必须定义的话，全局变量以小写g_开头，如：int  g_count = 0;

 

 第九：结构体的名字开头字母要大写。如：

struct Student

{

}；

 

 第十：枚举和它的成员的定义，应该采用有意义的命名方式，避免出现歧义；枚举变量的命名以T开头，枚举成员以E开头。