C语言程序开发规范

《C语言程序开发规范》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、C语言程序开发规范封页11・引言1.1.目的使用本规范是为了支持下述软件胡质：无错误、有失效保障、可靠一个软件产品，如果严格符合它的规范就是止确的，如果在异常环境下仍然能够工作就是健壮的（robust）o无错误、有失效保障、可靠就是指一个软件产品既正确又健壮。可维护一个软件产品，如果它可以随着规范的改变而方便地进行修正就是可扩展的；如果一个熟悉该软件规程的新程序员能够轻松地理解它的实现就是可读的；如果能够整个或部分地被一个新的应用所重用就是可重用的。可维护就是指一个软件产品可扩展、可读并几可重用。可移植一

2、个软件产品，如果可以方便地转移到一个不同的硬件或软件环境中应用，那么它是可移植的。可配置_•个软件产品，如果能够轻松地选择源代码的正确版本和其它联编一个软件产品所需的部件，那么它是可配置的。可验证—•个软件产品，如來能够在验证阶段轻松地准备测试数据和检测故障的程序，那么它就是可验证的。易调试一个软件产品，如果能够轻松地从故障上溯查找到错误所在，那么它是容易调试的。1.2.致性凡所有开发的C软件都必须遵循本文档的要求，第三方软件可以冇例外。其中，规则必须遵守，而建议则希望被遵守，如不能遵守，其原因必须作书面

3、记载。所冇对规则或建议的违背都必须有书面记载。1.3.术语标识符（ident辻ier）：指C中的一个变量、常量、函数或类型。在本文档中它与“名称”同义。定义（define）：变量或常量的定义是指编译器为其分配的内存。函数的定义是指函数体的实现（也是为代码分配内存）。声明（declare）：指一些实体对编译器的声明所在的位置，如函数原型、类型（由typedef定义）、变量利常量。声明不分配内存。宏（macro）：指由#define语句定义的代替一个文本串的名字。当该名字在源程序小出现时,预处理器用对应文木串

4、代替它C固有数据类型（或预定义或基本数据类型）：由语言本身定义的数据类型，如in—用户定义数据类型：编程人员用struct、union、enum或typedef定义的数据类型。范围：标识符的范围是指其可见的环境。环境在这里指口J以使川该标识符的函数或程序块。全局：使用范围没有限制。文件级局部：使用范I韦I局限在一个文件中。函数级局部：使用范围局限在一个函数屮。2.文件目录【建议2-1-1］每个模块的代码（包括头文件）放在以“系统+模块”方式命名的冃录下。【建议2-1-2］文件的命名使用“系统+模块（+功能

5、）”的方式命名。例：RNC系统RANAP模块的C语言代码应该为RNC_RANAP.C和RNC_RANAP.H,如果程序太大仍需分为不同的文件，则按功能区分，比如：RNC_RANAP_DTSPATCH.C。【规则2-1-2］实现同一功能的不同函数应在同一文件内。【规则2-1-3］在每个子目录内要编写README文件对文件及子目录的组织结构作细致的描述。README文件模板见附录H3.文件结构C++/C程序的头文件以“.h”为后缀，C程序的定义文件以“.C”为后缀。3.1•版权和版本的声明版权和版本的声明位于

6、头文件和定义文件的开头（参见示例3-1）,主要内容有：（1）版权信息。（2）文件名，作者/修改者，完成tl期。（3）最终版本号（必须跟最新修改记录的版本号相同），实现目的。（4）修改记录。/^y.^y.^y.^y.^y.^y.^y./*［■"［、"［、"［、"［、"▲、"［J“［*"1、•▲J"A、"［、"I、*［■"［、"I、*［、"I、•］*♦［■^4^"］、"［、■}・"［、"［、"］■"［、，▲、■」■"▲、"［、"右、"］■"［、"［、*］、^7%xi%"［■^*7^"］、•［、xl%"［■■［

7、、"［、・［、"［■*［*"［、•7%"［、

8、%"(・"］、/*XXXXXXXXXXXXXX有限公司版权所有S%f^>X^%F^kL^%F^^JxkL^%F^kL^>A^%fx>A^xfxxlxxfxkL^%1^>A^kl^>A^%V^^Jx%1^%1^%1^^Jx%!>%J^kIxvl^//*@<®BEGATN_INTERXAL_LEGAL@@*//**//*Copyright(C)Description*//*ZZZZZZZZZScience&TechnologyDcvelopmentCo.,Ltd.

9、Beijing,China*//*Unpublishedwork-rightsreservedundertheChinaCopyrightAct.*//*/*/*/*馳ENDINTERNALLEGAL®®Use,duplication,ordisclosurebythegovernmentissubjectto*/restrictionssetforthintheCDTTcommerciallicenseagreement.*