C语言编写规范

《C语言编写规范》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、广州市轨道交通自动售检票系统综合中央计算机系统C语言编写规范合同号：J3SB055生效日期：2004年1月15日15版本号日期文件名称文件编号页码1.002005-1-15广州市轨道交通自动售检票系统综合中央计算机系统-C语言编写规范GZ(0)2202版本号日期编写者审核者描述1.02005-1-15容伟涛蔡历文建立文档15版本号日期文件名称文件编号页码1.002005-1-15广州市轨道交通自动售检票系统综合中央计算机系统-C语言编写规范GZ(0)2202目录1.说明52.程序约定52.2.1应用程序的命名52.2.2子模块的命名62.2.3变量的命名62.2.4常量的命名72.2.5函数

2、/过程的命名72.2.6接口命名72.2.7类的命名82.2.8方法的命名82.2.9数据库的命名82.3.1输入参数的约定92.3.2输出参数的约定92.3.3返回值的约定92.4.1源程序头的注释和规范92.4.5区的注释102.4.6代码中的注释113.接口/函数过程调用的约定123.1头文件(.H文件)123.2函数133.2.1变量定义133.2.2参数合法性检查1315版本号日期文件名称文件编号页码1.002005-1-15广州市轨道交通自动售检票系统综合中央计算机系统-C语言编写规范GZ(0)22023.2.3执行处理133.2.4返回值144.错误和异常处理规范144.1出错

3、类型定义约定144.2异常的捕获154.3异常和错误的处理1515版本号日期文件名称文件编号页码1.002005-1-15广州市轨道交通自动售检票系统综合中央计算机系统-C语言编写规范GZ(0)22021.说明为了保证在软件开发过程中，全体成员的代码风格一致，便于维护，提高软件产品的质量和保持开发产品的持续性，特制定本编码规范。本规范详细规定了源码书写、变量命名、函数/过程的书写、错误和异常处理等方面。2.程序约定2.1排版规则1)       程序应采用缩进风格编写，每层缩进使用一个制表位(TAB)，类定义、方法都应顶格书写；2)       左花括号要另起一行，不能跟在上一行的行末；3)

4、       一个变量定义占一行，一个语句占一行；4)       对独立的程序块之间，变量说明之后必须加空行；5)       对于较长的语句(>80字符)要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读；6)       循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分；7)       在结构成员赋值等情况，等号对齐，最少留一个空格；8)       若函数或过程中的参数较长，则要进行适当的划分；9)       形参的排序风格u       最常使用的参数放在第一位u       输入参数列表应放

5、在输出函数列表的左边u       将通用的参数放在特殊的参数的左边2.2命名约定2.2.1应用程序的命名“公司所写”+模块名称+[版本]15版本号日期文件名称文件编号页码1.002005-1-15广州市轨道交通自动售检票系统综合中央计算机系统-C语言编写规范GZ(0)22022.2.2子模块的命名每个子模块的名字应该由描述模块功能的1~3个单词组成。每个单词的首字母应大写。在这些单词中可以使用一些较通用的缩写。2.2.3变量的命名变量的命名的基本原则使使得变量的含义能够从名字中直接理解。可以用多个英文单词拼写而成，每个英文单词的首写字母要大写，其中英文单词有缩写的可用缩写，变量的前缀表示该

6、变量的类型；对于作用域跨于10行以上的变量名称不能少于4个字符，除循环变量，累加变量外不得使用i、j、k等名称的变量名。变量分为全局变量和局部变量，对于全局变量以加前缀“g_”来区分。变量类型前缀说明变量类型前缀说明intN整形值BYTEBy8位无符号整形值longL长整形值COLORREFCr32位的颜色值unsignedintUi无符号整形值DWORDDw32位无符号整形值unsignedlongUl无符号长整形值LONGL32位整形值charC字符LPARAMLparam32位值，作为参数给窗口过程或回调函数char*P字符数组LPCSTRPsc32位指针，常量字符串char*Sz以

7、0结尾的字符串LPSTRPs32位指针，字符串FloatF单精度浮点值LPCTSTRPsts32位指针，常量字符串，Unicode和DBCS15版本号日期文件名称文件编号页码1.002005-1-15广州市轨道交通自动售检票系统综合中央计算机系统-C语言编写规范GZ(0)2202DoubleD双精度浮点值LPTSTRPts32位指针，字符串，Unicode和DBCSBoolB布尔型LPVOIDP32位指针，没