C语言程序设计规范(自学,请尽量遵守).ppt

编程规范介绍（一）,优秀程序员的必备素质,第一部分 排版,严格采用阶梯层次组织程序代码及时折行一行只写一条一句if、for、do、while等语句格式规定空行空格对变量的定义，尽量位于函数的开始位置程序各部分的放置顺序,采用阶梯层次组织程序代码,各占一行，与引用对齐函数体开始、结构（枚举）声明、if、for、do、while、switch、casedo-while是个特例（后可以跟while）使用Tab缩进,及时折行选低优先级操作符前换行使换行适当缩进（至少一个Tab）一行只写一条语句（只出现一次分号）if、for、do、while、case、switch、default各占一行，且if、for、do、while后无论语句多少都要加花括号,空行定义变量与程序块之间相对独立的程序块之间,空格,逗号后，分号后（for循环）比较、赋值、算术、逻辑等双目运算符前后加空格!、+、-等单目运算符与运行表达式之间不加空格-、.前后不加空格if、for、while、switch等后面加空格，突出关键字,变量定义,同一行内不要定义过多变量同一类的变量在同一行内定义，或相邻行定义数组、指针复杂类型定义放在定义区的最后变量定义区不做较复杂的变量赋初值,程序放置顺序,1、#include 2、#include 用户自定义文件3、#define 宏定义4、全局变量定义5、函数原型声明6、main函数定义7、用户自定义函数,第二部分 注释,注释的原则和目的函数头部应进行注释进行注释时的注意事项,注释的原则和目的,原则是有助于对程序的阅读理解，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁目的是解释代码的目的、功能和采用的方法，提供代码以外的信息，帮助读者理解代码，防止没有必要的重复注释信息,函数头部应进行注释,列出：函数的目的/功能、输入参数、输出参数、返回值、调用关系/*function:函数名称description:函数功能描述calls:被本函数调用的函数清单called by:调用本函数的函数清单input:输入参数，每个参数的作用、取值及关系output:输出参数说明return:函数返回值的说明others:其它说明*/,注释时注意事项,注释应与其描述的代码相近，在代码上方或右方（单条语句注释）全局变量要有较详细的注释，包括功能、取值范围、哪些函数存取等注释与描述内容进行同样的缩排注释与其上面的代码用空行隔开对变量定义和分支语句（条件、循环等）必须编写注释,注释时注意事项,对于switch结构中无break的case，在下一个case之前注明在程序块结束行右方加注释标记，表明某程序块的结束注释格式尽量统一，使用/*.*/,第三部分 命名规则,三种流行的命名法则命名的基本原则变量名的命名规则函数命名规范函数参数命名规范,三种流行的命名法则,驼峰命名法（首字母小写）printEmployeePaychecksprint_employee_paychecks匈牙利命名法m_lpszStr帕斯卡命名法（与驼峰类似，首字母大写）,命名的基本原则,标识符的命名要清晰、明了对于变量命名，禁止取单个字符i、j等不要使用数字或较奇怪的字符,变量名的命名规则,使用“匈牙利法则”变量名=变量类型+变量的英文意思,函数的命名规范,尽量使用英文表达出函数完成的功能必须使用函数原型声明,函数参数命名规范,参数名称的命名参照变量命名规范传递大结构的参数，采用指针或引用方式传递,第四部分 可读性,避免使用默认的运算优先级使用有意义的标识，避免直接使用数字源程序中关系较为紧密的代码应尽可能相邻不要使用难懂的技巧性很高的语句、复杂的表达式,练习,请同学们课后继续学习有关“编码规范”的相关内容并将其应用在日后的课程练习当中。在“考试平台”下练习，进一步熟悉规范要求。,