_c_语言编程规范(v1.1)

《_c_语言编程规范(v1.1)》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、C语言编程规范修订履历版本修订者修正日期修正内容1.0江朝阳2009-9-22初稿1.1肖渺2009-9-22修改增删以下内容：1）对源程序、函数原型的注释2）数据结构声明、关键程序代码段注释声明3）函数的几点说明1.程序块要采用缩进风格编写，缩进的空格数为4个。说明：对于由开发工具自动生成的代码可以有不一致。2.较长的语句（>80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读。示例：perm_count_msg.head.len=NO7_TO_STAT_PERM_COUNT_LEN+STAT_SIZE_PER

2、_FRAM*sizeof(_UL);report_or_not_flag=((taskno），后不应加空格。说明：采用这种松散方式编写代码的目的是使代码更加清晰。由于留空格所产生的清晰性是相对的，所以，在已经非常清晰的语句中没有必要再留空格，如果语句已

3、足够清晰则括号内侧(即左括号后面和右括号前面)不需要加空格，多重括号间不必加空格，因为在C/C++语言中括号已经是最清晰的标志了。在长语句中，如果需要加的空格非常多，那么应该保持整体清晰，而在局部不加空格。给操作符留空格时不要连续留两个以上空格。示例：(1)逗号、分号只在后面加空格。inta,b,c;(2)比较操作符,赋值操作符"="、"+="、算术操作符"+"、"%"，逻辑操作符"&&"、"&"、位域操作符"<<"、"^"等双目操作符的前后加空格。if(current_time>=MAX_TIME_VALUE)a=b+c;a*=2;a=b^2;(3)"!"、"~"、"++"、"--"、"&"

4、（地址运算符）等单目操作符前后不加空格。*p='a';//内容操作"*"与内容之间flag=!isEmpty;//非操作"!"与内容之间p=&mem;//地址操作"&"与内容之间i++;//"++","--"与内容之间(4)"->"、"."前后不加空格。p->id=pid;//"->"指针前后不加空格(5)if、for、while、switch等与后面的括号间应加空格，使if等关键字更为突出、明显。if(a>=b&&c>d)1.一般情况下，源程序有效注释量在20％以上。2.源文件头部应进行注释，列出：版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。示例：下面这段

5、源文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。*.h、*.c源文件文件头： /****@file  Oracle.h**@briefOracle数据库接口**** 版本信息:%W% %E% %U%**开发记录:由×××编写初稿(200x年x月)**修改记录:****----------------------------------------------------------------------------**                        湖南创发科技有限公司 版权所有  **           Copyright (C)

6、 200xTransFar TechnologyLtd. All rights reserved.*******************************************************************************/1.函数头部应进行注释，列出：函数的目的/功能、输入参数、输出参数、返回值、调用关系（函数、表）等。示例：下面这段函数的注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。/****@brief创建数据库连接池**** @parampoolUserName连接池用户名**@parampoolPassword连接池用户口令**@p

7、aramdbServer数据库服务器**@paramconnMin最小连接数**@paramconnMax最大连接数**@paramconnIncr连接数增量****@return创建成功时，返回指向数据库连接池的指针；**否则抛出 database_error 异常。*/ 上述格式的优点是便于使用docxgen之类的文档工具导出联机帮助文件！2.边写代码边注释，修改代码同时修改相应的注释，以保证