标准C语言规范

C语言编码规范

1．文件、函数规范

根据功能划分文件。文件名与主控函数名相同；主控函数必须放在最前面；函数的长度一般不宜超过150行；文件长度不宜超过500行。标准的文件头格式如下：

函数名：

功能：

调用函数：所涉及的主要功能函数

调用参数：必须详细说明

返回值：

编写时间：

修改时间：修改时包含此项

2．命名规范

①函数命名规范

以便于理解为原则，由一个或多个单词或单词缩写组合而成，单词首字母大写。

如AddItem()，GetInt()，FxaUp()

②变量命名规范

由变量类型为前缀，加上函数命名规范组合而成。具体前缀命名方法如下：sh------short, i------int, l------long, c------char, f------float, d------double,

p------pointer

字符串数组也使用p标志

静态变量名前用s标志

数组变量名前用stru标志

全局变量使用前缀g_标志

如：dBalance，fInterest，pName, sCustomer，struPersonWang, g_iOperNo 3．书写规范

⑴对齐原则

同一层次的语句必须左对齐。“{”和“}”必须独占一行。

⑵缩进原则

不同层次的语句必须遵从缩进原则，一般缩进四个字符为宜,TAB值设为4。

Case后的语句（简短注释语句除外）应另起一行，且须与“：”相接。

⑶分行书写原则

当行超过屏幕上的行时，应分行书写。

⑷注释符要求

单行注释符使用“//”，多行注释符使用“/*……*/”，注释符必须遵从前面3条原则，“/*”应与“*/”对齐。

4．语法规范

⑴尽量不使用goto语句，一个函数中不允许出现两个不同的标识符用于goto语句。

⑵当出现多个if……else语句时，尽可能改用case语句。

⑶尽量不使用do……while语句。

⑷当数字或字符用作非本身含义时，请使用有意义的宏定义，如“TRUE”、“FALSE”。

⑸当出现类型转换时，应明确转换，不宜隐含转换。

⑹不随意增加全局变量。

⑺尽量避免使用过分复杂的逻辑语句。

⑻链表必须详细加以说明。

⑼在逻辑判断、循环判断和函数调用处，请加以说明。

⑽调试使用统一的调试函数Debug，其参数与printf相同。

⑾尽可能做到函数出入口单一。

⑿尽量避免代码重复。

⒀配置文件应遵从配置文件规范。

⒁路径宜采用相对路径。

⒂逻辑要严密，所有的操作均应考虑失败的情况。

⒃注意数据合法性检查。

⒄注意释放资源，如：指针、游标等。

⒅非外部调用的函数请用static定义，明确影响面。

⒆函数的返回类型应明确定义。

⒇不直接对两浮点数比较。

附:示范程序check20.c

/*

* 函数名 : check20

* 功能 : 检查汇票号码

* 调用函数 :

* 输入 : str (大结构)

* 输出 : 成功 -- Ok; 失败 -- Err

* 编程人员 : 宋毅红

* 编程时间 : 94.9.29

* 修改时间 :

*/

#include

#include

#include

#include

#include "Tr_mac.h"

#include "Tr_str.h"

int iNfd; /* 汇票号码文件描述符, 全程变量 */

int Check20(str)

struct ca_struct *str;

{

short shClass;

long lNumber;

char sName[30];

struct flock lck;

nbgd bgdc;

ShClass = (short)atoi( str->hp_shClass);

lNumber = atol( str->hp_numb);

lck.l_type = F_RDLCK;

lck.l_whence = 0;

lck.l_start = 0;

lck.l_len = 0;

signal( SIGALRM, time_out);

sprintf(sName, "%s/data/nbgd%1d%03d", Sys_Dir, shClass,atoi( str->home_brch));

if(( iNfd = open( sName, O_RDWR)) < 0) /* 打开号码文件 */

return( Err);

alarm( 5); /* 加锁等待时间5秒 */

if( (fcntl( iNfd, F_SETLKW, &lck)) < 0)

{

close( iNfd);

return( Err);

}

lseek( iNfd, 0L, 0);

if( read( iNfd, &bgdc, sizeof( nbgd)) < 0)

{

lck.l_type = F_UNLCK;

fcntl( iNfd, F_SETLKW, &lck);

close( iNfd);

return( Err);

}

if((lNumber != atol( bgdc.cur)) || (lNumber > atol( bgdc.edn))) {

lck.l_type = F_UNLCK;

fcntl( iNfd, F_SETLKW, &lck);

close( iNfd);

/* 当前文件已用完号码,继续使用备用文件 */

i f(atol(bgdc.cur) > atol(bgdc.edn))

{

sprintf(sName, "%s/data/nbgd%1d%03d", Sys_Dir,

shClass+3, atoi(str->home_brch));

if(( iNfd = open( sName, O_RDWR)) < 0) /* 打开号码文件 */ return( Err);

alarm( 5); /* 加锁等待时间5秒 */

if( (fcntl( iNfd, F_SETLKW, &lck)) < 0)

{

close( iNfd);

return( Err);

}

lseek( iNfd, 0L, 0);

if( read( iNfd, &bgdc, sizeof( nbgd)) < 0)

{

lck.l_type = F_UNLCK;

fcntl( iNfd, F_SETLKW, &lck);

close( iNfd);

return( Err);

}

if((lNumber != atol( bgdc.cur)) || (lNumber > atol( bgdc.edn))) {

lck.l_type = F_UNLCK;

fcntl( iNfd, F_SETLKW, &lck);

close( iNfd);

_disp_nm(bgdc.cur); /* yyj 94.11.17.*/

return(Err);

}

}

/******* added by yang yijun 95.7.25 *****/

else

{

_disp_nm(bgdc.cur); /* yyj 94.11.17.*/

return(Err);

}

}

return(Ok);

}

void _disp_nm( _sName)

char *_sName;

{

WINDOW *hp;

int i=0;

hp=newwin(12,42,5,38);

box(hp, 0, 0);

wmove(hp, 3,3);

waddstr( hp, "当前汇票号码:");

wmove(hp, 5,3);

waddstr( hp, _sName);

wrefresh( hp);

do {

wmove(hp,hp->_maxy,hp->_maxx); i=wgetch(hp);

if(i==Ctrl_Q)

{

touchwin(curscr);

wrefresh(curscr);

continue;

}

} while(i!=ENTER);

wclear(hp);

wrefresh(hp);

delwin(hp);

touchwin(stdscr);

wrefresh(stdscr);

}