C语言编程规范V132.doc

软件开发中心C/ESQL、CICS语言编程规范
文档编号:
项目编号:
项目名称:
类别 规范制度/
密级 内部
路径
开发部门 ： 质量管理部基础管理组
编写整理者： 高斌
修订记录
日期
版本
修订目的描述
作者
2003-2-3
V 10
创建《软件开发中心C、SQL、CICS编程规范》
高斌
2004-4-20
V 11
修改《软件开发中心C、SQL、CICS编程规范》
高斌
2006-9-14
V 12
修订第6页第6行、增加161函数声明、第20页第27行。
高斌
2007-8-9
V13
删除24游标的使用、删除第四章、与AS400相关的部分
高斌
2010-7-1
V131
修订农行图标。增加第9页第29行关于表达式优先级要求；增加第14页第16行，对资源使用要求；增加第16页26行，对CICS中SQL提交语句的使用说明
高斌
2010-12-25
V132
修订“V14”为“V131”；
修订《中国农业银行软件开发中心C语言编程规范V131》的“112函数命名”，补充“主机函数名按照子系统增加子系统前缀，子系统名不允许重名”内容；删除“如果确实需要使用重名函数，属于本文件内部使用的函数建议加上static，防止在链接时发生重名错误。
王海龄
”；补充114 源文件命名 同一项目中的源文件不允许重名。
目录
1 C语言编程规范 4
11 命名规范 4
111 变量命名 4
112 函数命名 5
113 宏命名 5
12 注释 6
121 文件头 6
122 函数头 6
123 内部注释 7
124 标注型注释 7
13 头文件 7
14 变量定义及初始化 7
15 表达式和语句 8
151 表达式 8
152 运算符优先级 8
153 语句 9
154 缩进格式 12
155 空行 12
156 空格 12
157 续行 12
16 函数 13
161 参数的规则 13
162 返回值的说明 13
17 编译和链接 14
18 调试 14
2 普通环境下的C/ESQL编程规范 14
21 头文件 14
22 数组变量的定义 14
23 SQL语句的编写规范 15
24 游标的使用 15
3 CICS环境下的C/ESQL编程规范 15
4 与数据库的相关问题 16
41 索引的使用问题 16
42 查询变元的使用问题 17
421 操作符的使用 17
422 查询变元的使用 17
423 通配符的使用 18
43 更改时应注意的事项 18
44 数据库的高级应用问题 18
5 多平台的移植问题（ES/9000,AS400） 19
51 数据库 19
52 字符编码问题 19
53 编程问题 20
6 其它 20
7 参考资料 20

软件开发中心C/ESQL、CICS语言编程规范
C语言编程规范
命名规范
原则：
命名清晰，尽量体现出变量或函数的意义，作用范围和类型。
保持一致，即前后的缩写保持一致，上下文关键字保持一致，整个程序使用的命名风格一致。
原则上，一般情况下变量应使用匈牙利命名法。
变量命名
变量命名使用匈牙利命名法：前缀+大写名词（首字母大写，其它小写）
c char, CHAR
b BOOL
by BYTE
n int, INT
d double, DOUBLE
f float, FLOAT
li long int, LONG
w WORD
si short int, SHORT
r RESULT
v void
sz char[]（以0终止的字符串）
结构类型前缀 全部字母小写的结构类型名
指针类型 p
注：
因不同系统对int的理解不同，C语言程序整型变量定义时，不允许使用int型，而要用short int 或long int。
对与变量的名称可以采用全称或意义明确的缩写，原则上变量名称不应该超过20个，当变量名称超长是可进行适当的缩减。
若要强调某变量的做用域或类型时，可在变量前加注做用域标示。“g_”代表全局变量；“p_”代表函数内局部变量；“x_”代表该变量为外部变量；“e_”代表该变量须做为数组变量使用。
局部变量可以使用简短的表示形式。对于十分明显的函数内的临时循环变量或作用域不超过15行的临时变量使用i,j,k,n等短变量名。
对于已有代码，遵循该代码的变量命名风格。
例如：
cAmtInd 表示字符型的金额标志
siPa