c语言命名规范条.docVIP

PAGE / NUMPAGES C语言命名规范10条 从事C语言的教案也有两年了，在教案中发现学生们在编程方面有一个极不好的习惯，就是随意命名，这不仅给自己日后阅读自己程序时带来不便，也给其他的程序阅读者带来麻烦，更重要的是没有统一的规范总显得像是个游击队，没有正规军的感觉，企业也不愿意要业余选手，所以C语言的初学者最好一开始就培养一种良好的编程习惯，也许日后进入公司有些改动，需要适应，但基本的规范和规则是不需要改的，这样可以帮助你少走很多弯路，经过这些年的学习和工作，总结了一些规范的内容，为了好记，便于传播，特总结为十条，建议读者采纳。 1)标识符的命名要清晰、明了，有明确含义，同时使用完整的单词或大家基本可以理解的缩写，避免使人产生误解。程序中的英文单词一般不会太复杂，用词应当准确。例如不要把CurrentValue写成NowValue。 2)不允许使用汉语拼音命名，更不要使用汉语，必须使用英文来命名标识符。尽量避免名字中出现数字编号，如Value1,Value2等，除非逻辑上的确需要编号。 3)函数名、变量名从第二个单词起首字母大写。如：printName(), oldName等 4)在C 程序中只使用const常量而不使用宏常量，即const常量完全取代宏常量。常量定义以大写字母K开头，字母全部使用大写，如：const int KSIZE = 100。 5)代码缩进使用4个空格，不推荐使用TAB键 6)版权和版本的声明位于文件的开头；函数头部应进行注释，列出：函数的功能、输入参数、输出参数、返回值等。关键代码注释位于被注释代码上方，且用空行与其他代码分割开，如： 文件头注释： 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)。 7)静态变量加前缀s_，如：static int s_count = 0。 8)尽量避免应用全局变量，如果有特殊情况必须定义的话，全局变量以小写g_开头，如：int g_count = 0。 9)结构体的名字开头字母要大写。如： struct Student { }； 10)枚举和它的成员的定义，应该采用有意义的命名方式，避免出现歧义；枚举变量的命名以T开头，枚举成员以E开头。