集团c语言规范_已修订

《集团c语言规范_已修订》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、飞瑞集团PHOENIXTECGROUPSUBJECT主题集团C语言规范EFFECTIVEDATE生效日期NO.编号REVISION修订版次00PAGE第28页共28页1.目的：软件编程规范的目的和意义在于：1.1.统一集团嵌入式C语言软件编程风格1.2.提高软件源程序的可读性、可靠性和可重用性1.3.提高软件源程序的质量和可维护性1.4.减少软件维护成本，最终提高软件产品生产力2.范围：本文是针对整个飞瑞集团嵌入式C语言编程而制定的编码规范。3.参考资料：3.1.设计管理准则(TC-RDP-01)；3.2.山特开发部C语言规范；3.3.上海电力电子研究所C语言规范；3.4

2、.台北ODMC语言规范；3.5.成达一部C语言规范；3.6.太阳能C语言规范；4.定义：4.1.本文中，对于每一项规则和建议，将采用如下的概念表达方法：4.1.1.首先给出规则或者建议简要的文字描述。4.1.2.然后给出在要点基础上延伸的说明文字。4.1.3.最后给出示例。给出正面例子，作为模版或文字描述的具体展示；或者给出反面例子，指出其问题所在，按照规则或建议对反例进行改进。4.2.本文中使用的术语解释如下：4.2.1.规则：编程时必须遵守的约定，规则项将会作为SQA的稽核内容。4.2.2.建议：编程时必须加以考虑的约定。4.2.3.说明：对此规则或建议的必要的解释。

3、4.2.4.正例：对此规则或建议给出的正确例子。4.2.5.反例：对此规则或建议给出的反面例子。4.3.本规范分为规则性和建议性两种：对于规则性规范，要求所有软件开发人员严格执行；对于建议性规范，各项目编程人员可以根据实际情况选择执行。4.4.由于规则是用来说明一般情况的，所以每条规则都是在一般情况下才有意义。如有特例需要违反规则，必须添加注释予以说明！5.权责：本文之核准、修改、发行、依文件管理准则TC-QAP-01处理。6.内容：6.1.程序结构布局6.1.1.目录结构【规则1-1】同类软件工程项目，遵循统一的工程结构。(内页)TC-RDW-55飞瑞集团PHOENIX

4、TECGROUPSUBJECT主题集团C语言规范EFFECTIVEDATE生效日期NO.编号REVISION修订版次00PAGE第28页共28页【说明】根据UPS工程需要和公司习惯，UPS软件工程结构如下所示，对于某些目录如：+support就可根据编译器环境确定是否存在，或者是否存在其他目录配置文件。Project+app应用层代码+kernelRTOS源代码+include所需要包含的头文件+module软件模组+driver设备驱动程序+cpu存放CPU相关的宏+output存放最终的目标文件+debug存放.obj文件等编译器产生的文件+cmd存放编译器配置文件+

5、support存放编译器支持的相关文件其他工程配置文件【规则1-2】在整个工程范围内调用的变量和函数（公用部分）声明放在头文件中，文件范围内调用的变量和函数（私有部分）声明放在本文件的前面，函数范围内调用的变量声明在函数体的开头。【说明】为更好的进行信息隐藏，将模块进行封装，降低不同模块之间的耦合度，方便程序的维护和重用，公用部分的声明放在头文件当中，私有部分的声明放在源文件当中。1.1.1.文件布局【规则1-3】遵循统一的布局顺序来书写头文件(*.h)。【说明】头文件由三部分组成：版权和版本声明；预处理块；常数、变量以及函数等声明。版权和版本的声明位于头文件和定义文件的

6、开头，主要内容包括：(1)版权信息；(2)文件名称、标识符、摘要；(3)当前版本号、作者/修改者、完成日期；(4)版本历史信息。预处理块的作用是为了防止头文件被反复引用，因此，必须使用ifndef/define/endif结构产生预处理块。头文件的所有声明须遵循下面的顺序：(内页)TC-RDW-55飞瑞集团PHOENIXTECGROUPSUBJECT主题集团C语言规范EFFECTIVEDATE生效日期NO.编号REVISION修订版次00PAGE第28页共28页常量－>全局宏—>全局数据类型－>外部引用－>全局函数原型。【正例】下面的代码是一个完整的头文件模版，请依照下面

7、的顺序进行书写：/*********************************************************************Copyright2008,SANTKCorporation.FileName:Example.hDescription:ThisfileshowsastandardheadfileformatVersion:V1.0Author:EPGDate:2008-1-31*******************************************************