项目开发规范说明书

1.数据库开发规范

1.1.数据库表命名

数据库的表名采用以下规则进行编排：

（一）表的命名规则

前缀[2位]_类别[3位]_自定义部分。

前缀第一位说明（h 大额，b 小额，e 网银，m 信息管理，f 备付金）

前缀第二位说明（x 外联，w web，c 核心）

（二）为了移植方便，适应其他多种数据库的环境，要求表名长度<=16个英文字符。

（三）自定义部分不允许用拼音进行编排。

类别划分

类别说明类别码

控制类ctl

流水类jnl

明细类dtl

登录簿rgt

标准数据std

统计类cnt

日终day

举例说明：

操作员表：hc_ctl_teller

1.2.日期类型的问题

Oracle数据库和informix数据库不同，不支持自1899-12-31以来的long型日期处理。

但oracle和informix均支持字符串型的日期处理。

因此要求，对应于数据库表中日期型字段的定义,全部定义为STRING类型。

即：

char 变量名[9] ;

处理日期的函数（包括年月日转换、计算前后N天的日期、日期之间的天数等通过包装函数进行统一处理）。

格式为：YYYYMMDD

1.3.数据库错误宏定义

对于数据库操作出现的错误号，除了系统统一定义的宏以外，其他错误号禁止直接用数字描述。

以下均是错误的写法：

if ( SQLCODE == -1 )

if ( SQLCODE == 1403 )

……

正确的写法应该为：

if ( SQLCODE == SQLDUPDATA )

if ( SQLCODE == SQLNOTFOUND )

……

应用中常用的数据库错误编号的规范：

#define SQLNOTFOUND 1403 /* 记录未找到 */

#define SQLDUPDATA -1 /* 记录重复 */

#define SQLNOTABLE -942 /* 表不存在 */

#define SQLNOINDEX -1418 /* 索引不存在 */

#define SQLNULLDATA -1405 /* 数据有空值 */

这些宏定义将定义在系统公用的头文件（db_oracle.h）中。

1.4.字符串的使用问题

SQL语句中的字符串全部采用‘‘作为标识符，禁止使用“”等作为标识符。

取字符串的第M位到第N位，禁止使用 field_name[M,N]，请使用SUBSTR（）函数。

SUBSTR（字段名，起始位，长度）

多个字符串链接请用“ || ”。

例如：取帐号的第1位到第3位，第5位到第6位拼成串

SUBSTR(ACCT_NO,1,3) || SUBSTR(ACCT_NO,5,2)

禁止使用VARCHAR类型的字段作为数据库表结构的索引字段。规定只能如果是字符串类型的字段要求作为索引的话，只能使用 CHAR 类型。

数据库表中为CHAR和VARCHAR的字段，在用SELECT或FETCH取出值后，一定要去掉尾部的空格。原则上谁取出谁去掉空格。

1.5.SQL开发规范

1.5.1.索引和分区

表的记录数少于10000条，执行全表扫描。

在写查询条件时注意引用索引。

批量提取数据，使用按分区扫描。

比较值与索引列数据类型要保持一致性。

查询列与索引列次序保持一致。

排序列与索引列次序保持一致。

对于复合索引，SQL语句必须使用主索引列，按照复合索引组成列的顺序书写。 尽量不要对索引列进行计算，如有特例对索引列计算较多，则需建立函数索引。 in、or子句常会使索引失效，在表数据记录数大于10000条的情况下，考虑把子句拆开。

对于索引的比较，不使用NOT 。

删除一个表中的所有数据时，使用truncate，而不是delete。不能在事务中使用该语句，并且务必确认表中数据可以全部被删除。

1.5.

2.Select 列和where条件要求

在查询语句中查询表达式左边不允许出现函数及其它运算表达式，所有左边的表达式都可以用其它的方法在右边实现。

where条件中不要使用常量比较，将常量绑定到变量中使用。

查找数据时只取出确实需要的那些列，不要使用*来代替所有列名。要清楚明白地使用列名，而不能使用列的序号。

不要order by和group by排序操作。必须使用排序操作，请遵循如下规则：

?排序尽量建立在有索引的列上。

?查询结果集不要求唯一时，使用union all代替union。

1.5.3.多表连接

在表中的记录数低于10万条的情况下，可以使用多表连接。

多表连接时，必须使用表的别名来引用列。

使用EXISTS代替DISTINCT表达方式。

低效:

SELECT DISTINCT DEPT_NO,DEPT_NAME

FROM DEPT D,EMP E

WHERE D.DEPT_NO = E.DEPT_NO

高效:

SELECT DEPT_NO,DEPT_NAME

FROM DEPT D

WHERE EXISTS ( SELECT ‘X’

FROM EMP E

WHERE E.DEPT_NO = D.DEPT_NO);

多张大表进行Join时一条SQL语句中关联查询的大表不能超过3个。

1.5.4.嵌套查询

使用not exist代替not in子句进行嵌套查询。

例如:

SELECT …

FROM EMP

WHERE DEPT_NO NOT IN (SELECT DEPT_NO

FROM DEPT

WHERE DEPT_CAT=’A’);

为了提高效率.改写为:

SELECT ….

FROM EMP E

WHERE NOT EXISTS (SELECT ‘X’

FROM DEPT D

WHERE D.DEPT_NO = E.DEPT_NO

AND DEPT_CAT = ‘A’);

避免嵌套连接、子查询（多级）如：A = B and B = C and C = D 。

1.6.Proc语句规范

1.6.1.SELECT语句

EXEC SQL SELECT

field_name1,

field_name2 ,

field_nameN

FROM table_name_list , …

WHERE cond1

AND cond2

GROUP BY field_nameX, field_nameY

ORDER BY grouplist ;

建议一行不超过5个字段

1.6.

2.DECLARE语句

EXEC SQL DECLARE cursor_name FOR

SELECT field_name1,

field_name2 , …

field_nameN

FROM table_name_list , …

WHERE cond1

AND cond2

GROUP BY field_nameX, field_nameY

ORDER BY grouplist ;

1.6.3.UPDATE语句

EXEC SQL UPDATE table_name

SET field_name1 = :val1 ,

field_name2 = :val2 ,

……

field_nameN = :valN

WHERE cond1

AND cond2 ;

1.6.4.INSERT语句

简单的INSERT语句：

EXEC SQL INSERT INTO table_name VALUES (:stru_var) ;

复杂的INSERT语句：

EXEC SQL INSERT INTO table_name VALUES

(

:val1, :val2, … valN,

……

:valX, …. :valY

) ;

1.6.5.FETCH语句

简单的FETCH语句：

EXEC SQL FETCH curs_name INTO :stru_var ;

复杂的FETCH语句：

EXEC SQL FETCH curs_name INTO

:val1 , …., :valN ,

:valX, …, :valY ;

EXEC SQL fetch …

必须遵循 EXEC SQL fetch curs_name into ….的格式规范。游标使用完毕后要用

EXEC SQL close …关闭。

informix释放游标EXEC SQL free …在Oracle中不需要。

1.6.6.Update语句

标准的update语句格式：

EXEC SQL update table_name set

field_name1 = :val1 ,

field_name2 = :val2 ,

……

field_nameN = :valN

where

……

以下格式严禁使用：

EXEC SQL update table_name set * = :struct_val

where

……

即使Oracle支持该种语法，也会存在效率的问题！

Oracle不支持以下语法:

EXEC SQL update table_name set

( field_name1, field_name2, …… field_nameN ) =

( :val1 , :val2 , …… :valN )

where

….

请使用以下语法进行update操作：

EXEC SQL UPDA TE table_name SET

field_name1 = :val1 ,

field_name2 = :val2 ,

… …

field_nameN = :valN

WHERE cond1

AND cond2 ;

1.6.7.prepare 语句

prepare 动态语句在应用中会大量使用到，因为有些语句不能事先嵌入到PRO*C程序中，要根据程序运行情况或用户从输入设备上的输入,来确定执行的SQL语句。

动态SQL1: 不能是查询(SELECT)语句,并且没有宿主变量.

用法:拼一句动态SQL语句,并用EXECUTE IMMEDIATE执行,如:

strcpy(str_sql,“DELETE FROM test001 WHERE name=’username’”)；

EXEC SQL EXECUTE IMMEDIATE :str_sql;

动态SQL2: 不能是查询(SELECT)语句,并且输入的宿主变量数目是知道的,

用法:拼一句动态SQL语句,用PREPARE,EXECUTE语句执行.

strcpy(sqlstring, "DELETE FROM test WHERE test_col = :K1 ");

EXEC SQL PREPARE sqlproc FROM :sqlstring;

EXEC SQL EXECUTE sqlproc USING :emp_number ;

动态SQL3: 用于创建动态查询, 并且要查询的字段以及输入的宿主变量数目是知道的

用法: 拼一句动态SQL语句,用PREPARE分析该语句,定义一个CURSOR进行取值 strcpy(sql,"select user_name from test WHERE test_col <> :K1 ");

EXEC SQL PREPARE sqlproc FROM :sql;

EXEC SQL DECLARE cur_user_name CURSOR FOR sqlproc;

EXEC SQL OPEN cur_user_name USING : AA;

while(1)

{

EXEC SQL FETCH cur_user_name into :ora_id;

if (sqlca.sqlcode < 0)

{

/*FETCH CURSOR失败*/

EXEC SQL CLOSE cur_user_name;

}

if( sqlca.sqlcode == SQLNOTFOUND)

{

break;

}

}

EXEC SQL CLOSE cur_user_name;

1.7.Oracle的事务

1.7.1.ORACLE XA事务

（一）int tpopen(void)

描述：建立与一个资源管理器得连接,该资源管理器是该SERVER所在得组中定义的.

并且在buildserver时要用-r 参数指定该资源管理器.如果采用默认的TPSVRINIT()该函数会自动被调用。

参数：无

返回值：失败返回-1,错误号保存在全局变量tperrno中。

（二）int tpclose(void)

描述：关闭与一个资源管理器得连接,如果采用默认的TPDONE()该函数会自动被调用,

参数：无

返回值：失败返回-1，错误号保存在全局变量tperrno中。

（三）int tpbegin(unsigned long timeout, long flags)

描述：开始一个全局事务

参数：

timeout：全局事务的超时时间，从tpbegin()开始,过了TIMEOUT秒该全局事务还没有完成,

该全局事务将因超时而回滚，范围为0 to 2 31 -1秒，0表示可以为无穷长。注

意:TIMEOUT应该大于SCANUNIT

FLAGS：保留值，现在没有用到，要设为0

返回值：失败返回-1，错误号保存在全局变量tperrno中。

（四）int tpcommit(long flags)

描述：对一个全局事务进行提交操作

参数：FLAG应该设为0

返回值：失败返回-1，错误号保存在全局变量tperrno中。

（五）int tpabort(long flags)

描述：对当前的全局事务进行回滚

参数：FLAG应该设为0

返回值：失败返回-1，错误号保存在全局变量tperrno中。

Oracle对于以下类型的语句

EXEC SQL create table …

EXEC SQL drop table …

EXEC SQL truncate table …

EXEC SQL drop index …

……

会提交前面数据库处理的事务，请编程时注意。

1.8.Oracle的for update等待

在应用中为防止无限期地等待被锁定的行，请使用SELECT...FOR UPDATE(WAIT/NOW AIT) 语句控制等待时间

（1）设置等待时间，超时将返回错误

select * from aa for update wait 10;

发现有锁等待，10秒后报资源忙的异常

（2）不设置等待时间,直接报资源忙的异常

select * from aa for update nowait ;

发现有锁等待，直接报资源忙的异常

2.C程序开发规范

2.1.命名规范

2.1.1.源程序命名

（1）源文件名全部以英语进行命名。

（2）用不超过20个字母的英文或英文缩写表示文件含义。如果是多个英文的缩写，每个缩写开头字母大写，缩写之间无任何分隔符号。按照模块+功能名的方式来进行命名。

举例说明：

服务总控程序：HcServConsole.c

2.1.2.头文件命名

（一）头文件名称规则

前缀（2位）+ 连接符（‖_‖）+ 自定义部分

（二）头文件名全部以英语进行命名。名称不能超过12个英文字母，文件名称中不许出现汉字和不可见字符等内容，不允许以拼音的方式组成头文件名称。

（三）除了公共宏定义外，每个组可以自定义头文件，用于定义所有本组涉及到的宏。

系统设置一个统一的宏定义文件、存放整个系统使用的宏定义（如数据库出错号

定义）。需要强调的是，如果是系统头文件中已经定义的宏，每个组不允许再自

行定义。

（四）为了防止程序调用过程中由于函数参数变动而引起的测试和运行异常情况，每个数据库表结构的定义，每个数据库只允许建立一个数据库表结构定义的头文件。

（五）VIEW32文件编译后产生的头文件，每个组规定只允许采用一个统一的文件

2.1.

3.库文件命名

（一）库文件名全部以英语进行命名。

（二）文件编排规则：lib模块名.a

模块模块名

举例说明：

原则上各个功能模块只提供一个库文件，尽量避免应用程序链接一堆库文件的情况。

2.1.4.VIEW32文件名和VIEW32结构命名

VIEW32文件命名遵循以下原则：

（1）VIEW32文件名全部以英语进行命名。

（2）文件编排规则：

组名(有无小组划分)_view32.v

例如：结算组的VIEW32文件为：

SET_view32.v

（3）VIEW32结构命名规范：

STRU_组名＋自定义部分。

例如：存款组联机帐务交易的VIEW32名为：

STRU_SA VONLINE

2.1.5.全局变量和静态变量

项目组在系统范围内限制全局变量的使用，项目中所有的全局变量定义代码将汇集在一个.c文件中，由项目负责人负责进行维护。项目组成员需要增加、修改、删除全局变量时，必须向项目负责人提出申请，经过相应讨论之后如果获得同意，由项目负责人进行操作。在单个模块范围内使用的非局部变量应定义为静态变量（static）。全局变量和静态变量的名字应当具有说明性，遵循本规范中定义的命名约定。全局变量和静态变量定义和声明处均应加上注释，标明其用途和取值范围、意义等。

例如：

static int OnlineFlag; /* Flag of System status, 1-->Online 0--->Offline */

long AccountID; /* Identifier of account */

1.1.1.变量命名

（一）变量名要求用英文或英文缩写进行命名。

（二）变量不允许以“_”开头。避免与操作系统冲突。

（三）变量名称不能超过20位。

（四）局部变量的值应尽可能地显式初始化

（五）以变量类型（小写）为前缀，后面的单词的第一个字母大写（不采用“_”分隔）变量类型前缀

int I

Long L

Double D

Float F

Short sh

Char c

String s

Pointer p

数组z

结构st

举例说明：

int iCountNo;

char sAcctountNo[33] ;

1.1.

2.函数命名

（一）函数名称采用英文短语命名，不能使用拼音方式。

（二）要求函数名能表示基本功能。

（三）函数名称长度不超过20位。

（四）要求各组对外提供的函数开头以分组为单位加上前缀用来区分。

1.1.3.Makefile命名

原则上按照开发目录划分，每个组的库文件目录（libsrc）全集中在一个目录下。（一）全系统采用统一的名称：“makefile”。

不允许再出现make_lib、make_test、make_server 等各种各样的makefile文件名。

1.2.程序书写规范

1.2.1.程序头

程序头是对程序的详细描述信息，需要包含以下要素：

（一）程序名称

（二）程序的功能简述

（三）程序的环境说明

（四）程序建立日期、作者等

（五）程序的维护记录

SVN源代码管理需要增加的特定内容

模板如下：

/*** 文件名：TestServer.pc

* 功能概述: Tuxedo案例程序

* 作者：XXXX

* 创建时间: 2010/12/24

* 环境说明: Aix 6.0 XLC v9

* 说明: ORACLE PROC常用语句案例

*

***/

1.2.2.函数标签

每个函数均需要完整的函数标签，要素包括：

（一）函数名称

（二）重点输入输出参数描述、返回说明

（三）函数特殊说明

模板如下：

/* * 函数名：tpsvrinit() *

功能：tuxedo服务初始化函数*

参数：

返回：0:成功-1:失败

特殊说明：无*/

1.2.3.程序注释

（一）为了统一风格，移植方便，程序注释一律采用以下格式：

以“ /* ”开始，以“*/”结束。

不允许用“ // ”等注释格式。

（二）对于一段代码来说，经过精心安排的注释增强了它的可读性与可维护性。注释的使用范围包括：提示性地说明某个变量的用途；描述某个算法的实现等等。每个

注释都力求切题、简明、精确、不拖泥带水；避免照搬程序代码、冗长、易使人

曲解。

（三）注释应随着相应程序代码的修改而及时更新。由于历史原因而遗留在程序代码中的错误注释只能使读该程序代码的人产生困惑，并对其它正确的注释产生不应有的怀疑。

（四）注释的格式必须有程序的修订人员，修订日期，修订原因，修订模式（增加，删除，修改）

（五）【尾随注释】：

如果一行内可以写得下得注释，可以直接使用“ /* */ ”格式。

例如：

/* 查找费率代码表，准备进行手续费的处理 */

【块注释】：如果注释太长，一行内写不下，采用以下格式：

模板：

/*

* 定期一本通贷方打印

* 要素：账号＋客户名＋支取方式＋开户行＋电话＋开户日期

* 起始行＋重复记录数

*/

1.2.4.头文件书写

头文件书写除了和其他源代码一样的程序标签外，以下的原则需要遵循：

（一）为了防止重复包含和引用，每个头文件均采用以下的格式进行定义：#ifndef 宏名

#define 宏名

…

书写头文件的内容

…

#endif

（二）宏名的编排规则：

_DEF_头文件前缀（头文件名、全部大写）_H_

例如：

对于头文件CADdefine.h，格式书写如下：

#ifndef _DEF_CADDEFINE_H_

#define _DEF_CADDEFINE_H_

头文件内容

#endif

（三）数据库表结构定义头文件格式规范：

#ifndef _DEF_CADDEFINE_H_

#define _DEF_CADDEFINE_H_

EXEC SQL BEGIN DECLARE SECTION ;

头文件内容

EXEC SQL END DECLARE SECTION ;

#endif

（四）用宏定义表达式时，要使用完备的括号。

如下定义的宏都存在一定的风险：

#define MULT( a, b ) a * b

#define MULT( a, b ) (a * b)

#define MULT( a, b ) (a) * (b)

正确的定义应为：

#define MULT( a, b ) ((a) * (b))

1.2.5.日志问题

日志信息参考基础函数库中日志处理。

区分错误日志与调试日志，在错误日志中，区分数据库处理错误，与逻辑处理错误。

日志中必须包含，源程序名，错误行数, 错误说明，对于数据库处理错误，必须加上sqlcode值。

（一）开发中详细添加日志级别

区分DEBUG-调试,INFOR –一般信息, W ARNING -警告, ERROR-错误, （二）错误定位

日志信息精确定位错误原因，及发生错误数据值。

（三）错误码

对账错误码表，匹配对应错误码

1.2.6.C语句格式规范

1.2.6.1.变量使用

开发过程使用变量应该遵循以下原则：

（四）不使用全局变量，不使用extern 变量，降低程序数据藕荷程度。公共报文头变量除外。

（五）变量初始化的问题。定义指针时初始化为NULL，对指针型（包括数组）变量的内容使用memset初始化，其他自动变量、自定义全局变量申明时也要注意

初始化。

（六）不要同时使用char *和void *;尽量避免类型强制转换，因为结果在运行时不可预测。但对于空的操作例外。

（七）指针变量问题。首先要明确指针越少用程序越可靠；指针在定义后应马上初始化为NULL，这是一个开发的好习惯；指针要初始化，它包含空间分配和内

存初始化，使用memset对所有指针类型进行内存初始化；对于动态申请的内

存（malloc）,在使用完后要求进行空间释放，原则上谁分配谁释放，若分配

者在填写内容后退出，则由最后使用者释放。

（八）为了避免维护人员维护时产生理解上的二义性，任何情况下，条件语句中禁止出现赋值操作。

1.2.6.2.一般语句

以下情况在开发过程中需要注意：

（一）程序的缩进：4个字符。

（二）空行

空行用于将程序的各个主要部分自然地分隔开。同时，程序的各个函数之前也应有一块空行和注释，用于描述该函数。

（三）可执行语句应当单独成一行，并从它所在的开始花括号层缩进一个制表符宽度。本规则同样适用于空语句。

如下所示：

if (name_p == (char *) NULL) return ; （错误）

if (name_p == (char *) NULL)

{

return ; （正确）

}

（四）二元操作符

二元操作符的前后都必须放一空格('->'与'.'除外，其前后不用放置任何空格)。一元操作符与操作数之间不用放置任何空格。

如下所示：

A=B + C ; （错误！）

A =

B +

C ; （正确）

A++ ;

1.2.6.3.i f语句

一个简单的if语句：

if ()

{

...

}

另外，条件很长的情况下，需要分行进行处理，并通过适当的（）来避免条件的二义性。例如：

if ( sPack->flag == 2 &&

( acct_attr == 40 || acct_attr == 44 || acct_attr == 46 ) )

{

…

}

在一个简单的if-else组合中，关键字else应当新起一行，并与if保持同一缩进层次。

if ()

{

...

}

else

{

...

}

else-if链接形式：

if ()

{

...

}

else if ()

{

...

}

else if ()

{

...

}

1.2.6.5.f or语句

for语句书写按照以下格式：

for ( I=0 ; I

{

…… ;

…… ;

}

如果for语句内容太多，要分为多行进行处理：

for ( i=0 ; strcmp(funcname,MID_FUNC_TAB[i].funcname)

&& strcmp("XXXXXXXXXX",MID_FUNC_TAB[i].funcname) ; i++ );

禁止写成一行。

一个while语句块必须用花括号括起来（即使该块仅含单独一个语句）：

例如：

while ( )

{

…… ;

}

1.2.6.7.do-while语句（本项目不使用此模式）

一个do/while语句块必须用花括号括起来（即使该块仅含单独一个语句）：

格式：

do

{

…… ;

} while ( ) ;

1.2.6.8.s witch语句

switch语句书写遵循以下原则：

（一）保留字case与default应当与保留字switch保持一个缩进层次，并且后跟一空格（并非一制表符），然后才是常量表达式。与某种情况(case)相对应的代码块应当再缩进一个层次。

（二）每种情况(case)单独成一行。

（三）对应于一个代码块的多种情况(case)不要用空行分隔开。

（四）如果在某个代码块中省略了break语句，使得程序的执行继续到下一个代码块，则必须在该代码块之后放置一块注释以指明这一点，参见下例。（五）必须用break语句明确表示某个代码块结束后，程序的执行转移到整个switch语句之后。即便是一个switch语句的最后一种情况(case或default)，也应如此。

（六）如果一个case语句的最后一条语句是return，为了增加程序的可阅读性，后面也必须写上break语句。

以下是switch语句的模板程序：

switch ( iHitKey )

{

case UP :

case LEFT :

... ...

break ;

case DOWN :

... ...

/* 此处没有break,参照ENTER选项继续执行 */

case ENTER :

... ...

break ;

default :

... ...

break ;

}

1.2.6.9.常见的内存错误及其对策

（一） 内存分配未成功，却使用了它。

建议：在使用内存之前检查指针是否为NULL。如果指针p是函数的参数，那么在函数的入口处用assert(p!=NULL)进行检查。如果是用malloc来申请内存，应该用

if(p==NULL) 或if(p!=NULL)进行防错处理。

（二） 内存分配虽然成功，但是尚未初始化就引用它。

建议：不要忘记为数组和动态内存赋初值。防止将未被初始化的内存作为右值使用。

（三） 内存分配成功并且已经初始化，但操作越过了内存的边界。

建议：在使用数组时经常发生下标?多1?或者?少1?的操作，特别是在for循环语句中，循环次数很容易出错，导致数组操作越界，这种情况需要特别当心。

（四） 忘记了释放内存，造成内存泄露。

建议：动态内存的申请与释放必须配对，程序中malloc与free的使用次数一定要相同。

（五） 释放了内存却继续使用它。

有三种情况：

1）程序中的对象调用关系过于复杂，实在难以搞清楚某个对象究竟是否已经释放了内存，此时应该重新设计数据结构，从根本上解决对象管理的混乱局面。

2）函数的return语句写错了，注意不要返回指向?栈内存?的?指针?或者?引用?，因为该内存在函数体结束时被自动销毁。

3）使用free或delete释放了内存后，没有将指针设置为NULL。导致产生?野指针?。

建议：用free或delete释放了内存之后，立即将指针设置为NULL。

1.2.7.函数与过程相关建议

规则2-1：对所调函数的错误返回码要仔细、全面地处理。

规则2-2：明确函数的功能，精确（而不是近似）地实现函数设计。

规则2-3：编写可重入函数时，应注意局部变量的使用（如编写C/C++语言的可重入函数时，应使用auto即缺省态局部变量或寄存器变量）。

说明：编写C/C++语言的可重入函数时，不应使用static局部变量，否则必须经过特殊处理，才能使函数具有可重入性。

规则2-4：编写可重入函数时，若使用全局变量，则应通过关闭中断、信号量（即P、V 操作）等手段对其加以保护。

说明：若对所有使用的全局变量加以保护，则此函数就不具有可重用性，即当多个进程调用次函数时，很可能使有关全局变量变为不可知状态。示例：假设Exam是int型全局变量，函数Squre_Exam返回Exam平方值。那么如下函数不具有可重入性。 Unsigned int example(int para) { unsigned int temp; Examp = para; //(**)

Temp=Square_Exam(); Return temp; }

此函数若被多个进程调用的话，其结果可能是未知的，因为当（**）语句刚执行完后，另外一个使用本函数的进程可能正好被激活，那么当新激活的进程执行到此函数时，将使Exam赋予另一个不同para值，所以当控制重新回到?temp=Square_Examp()?后，计算出的temp很可能不是预想中的结果。此函数应如下改进。

Unsigned int example(int para) { unsigned int temp; [申请信号量操作] //若申请不到―信号量‖，说明另外的进程正 //处于给Exam赋值并计算其平方过程中（即正 Exam = para; //在使用此信号），本进程必须等待其释放信号 Temp = Square_Exam();//后，才可继续执行。 [释放信号操作] //若申请到信号，则可继续执行，但其他进程必 //须等待本进程释放信号量后，才能再使用本信 //号。 return temp; }

? 建议2-1：防止将函数的参数作为工作变量。

说明：将函数的参数作为工作变量，有可能错误的改变参数内容，所以很危险。对必须改变的参数，最好先用局部变量代之，最后再讲该局部变量的内容赋给该参数。示例：如下函数的实现不太好： Void sum_data(unsigned int num, int *data, int *sum)

{ unsigned int count; *sum = 0; for (count = 0; count < num; count++) { *sum

+= data[count]; //sum成了工作变量，不太好。

} } 若改为如下格式，则更好些： Void sum_data( unsigned int num, int *data, int *sum) { unsigned int count; int sum_temp; sum_temp = 0; for ( count = 0; count < num; count ++) { sum_temp += data[count]; } }

? 建议2-2：函数的规则尽量限制在200行以内。

说明：不包括注释和空格行。

? 建议2-3：一个函数仅完成一件功能。

? 建议2-4：为简单功能编写函数。

说明：虽然为仅用一两行就可完成的功能去编写函数没有必要，但用函数可使功能明确化，增加程序的可读性，亦可方便维护、测试。示例：如下语句功能不很直观。 Value = ( a > b ) ? a : b; 改为如下格式就很清晰： int max ( int a, int b) { return ((a > b ) ? a:b);

} value = max ( a, b); 或改为如下。 #define MAX (a, b) (((a) > (b)) ? (a) : (b)) value = MAX (a, b);

? 建议2-5：不要设计多用途面面俱到的函数。

说明：多功能集于一身的函数，很可能使函数的理解、测试、维护变得困难。

? 建议2-6：函数的功能应该是可以预测的，也就是只要输入数据相同就应产生同样的输出。

说明：带有内部―存储器‖的函数的功能是不可预测的，因为它的输出可能取决于内部存储器（如某标记）的状态。这样的函数既不容易理解又不利于测试和维护。在C/C++语言中，函数的Static局部变量是函数的内部存储器，有可能使函数功能不可预测，然而，当某函数的返回值为指针类型时，则必须是Static的局部变量的地址作为返回值，若为Auto类，则返回为错针。示例：如下函数，其返回值（即功能）是不可预测的。unsigned int integer_sum( unsigned int base ) { unsigned int index; static unsigned int sum = 0; //注意，是static类型的。 //若改为auto类型，则函数即变为可预测。 For ( index = 1; index <= base; index ++) { sum += index.; }

return sum; }

? 建议2-7：尽量不要编写依赖于其他函数内部实现的函数。

说明：此条为函数独立性的基本要求。由于目前大部分高级语言都是结构化的，所以通过具体语言的语法要求与编译器功能，基本就可以防止这种情况的发生。但在汇编语言中，由于其灵活性，很可能使函数出现这种情况。示例：如下是在DOS下TASM的汇编程序例子。过程Print_Msg的实现依赖于Input_Msg的具体实现，这种程序是非结构化的，