欢迎来到天天文库
浏览记录
ID:56471322
大小:1.07 MB
页数:40页
时间:2020-06-19
《嵌入式C语言编码规范.ppt》由会员上传分享,免费在线阅读,更多相关内容在教育资源-天天文库。
1、嵌入式C语言编码规范规范内容一、引言二、规范1、文件内部构成2、命名规范3、标识符和常量4、类型和类型转换5、初始化、声明和定义6、控制语句和表达式7、函数8、指针和数组9、结构与联合10、预处理指令一、引言嵌入式系统在各行各业都得到了广泛应用,C语言的使用也越来越体现出广泛性,因此嵌入式软件的安全可靠性变得尤为重要。制定本规范的目的与意义在于:1、树立良好的编程习惯和编程思路,摒弃那些可能存在风险的编程行为。保证编写出安全健壮的代码,进而保证嵌入式产品的安全性、可靠性。2、使编写的代码更加容易阅读、容易理解而且容易维护。3、良好的编程风格是提高程序可靠性非常重要的
2、手段,也是大型项目多人合作开发的技术基础。4、遵循良好的共通的编码规范,也是提高编码能力,保证软件工程这个阶段质量的一个重要手段。同时也是衡量一个组织软件开发能力的一个重要指标。二、规范1、文件内部构成用于存储源代码的C程序文件可以分为两类:源文件和头文件。源文件和头文件中包含的内容是不同的。源文件主要包括以下内容:只在本文件内部使用的(对外部隐藏的)类型;只在本文件内部使用的(对外部隐藏的)常量;只在本文件内部使用的(对外部隐藏的)宏定义;全局变量和文件级(static)变量的定义;函数原型声明和函数定义;包含文件部分,文件头的说明,函数头的说明。头文件
3、中包含如下内容:提供给外部参照的类型;提供给外部参照常量;提供给外部参照宏定义;提供给外部参照(全局)函数原型声明;提供给外部参照全局变量的外部声明;包含文件部分,文件头的说明。但头文件中不要定义变量。/FileName:DP_DrawE.cModelName:MF7878/R/JModuleName:DrawEngine/DisplayuCom:MitsubishiM16C/80seriesCreateDate:1999/10/01Author/Corporation:WhoAmI/NASAbstractDescription:Placesomedesc
4、riptionhere.------------------------------RevisionHistory---------------------------------NoVersionDateRevisedByItemDescription1V0.9500.05.18WhoAmI[NAS]abcdefghijklmWhatUDo/Source/HeaderFileHeaderSection各部分内容的含义说明,请参考下面内容。1)文件名信息;2)适用的产品型号(Model)名称:可以是多个型号;3)所属的模块(Module)名称:当模块很大时,可以考虑
5、在大模块内增加子模块的标示;4)适用的处理器(μCom)型号:可以是多个型号;5)预先包含头文件:只有在头文件的描述中使用,注明包含本文件之前应该首先包含的头文件;6)文件创建日期;7)文件创建者/公司名称;8)概要描述:概要的描述文件的功能、构成等信息,如果存在特殊的考虑,也请注明;9)修改履历,其中请标明:1)修改序号(No.);2)修改对应版本号(Version);3)修改日期(Date);4)修改人(RevisedBy);5)修改项(Item);6)修改描述(Description):请注明修改的原因和对策,如果存在特殊的考虑,也请注明;注意点:修改履历的纪
6、录一般在V0.80之后开始。但是,如果目前ver0.80的完成度和质量普遍很低,因此在具体的项目中可以考虑提高开始纪录修改履历的版本号。文件头说明实例2命名规范规范2.1关于文件标识符命名规则,请遵照以下规范:文件标识符分为两部分,即文件名前缀和后缀。格式如下:×××……××.×××1)文件名前缀表示该文件的内容或作用,可以由项目组成员统一约定。最好不要超过8个字符;文件名前缀的最前面要使用范围限定符——模块名(文件名)缩写;2)文件名后缀表示该文件的类型,该部分最多为3个字符:1)源文件:.c;2)头文件:.h;3)其它类型文件:如.tbl文件等,使用之前进行统一
7、规定。3)前缀和后缀这两部分字符应仅使用字母、数字和下划线。文件标识的长度不能超过32个字符,以便于识别;4)本规范建议文件名全部使用大写。规范2.2关于模块标识符命名规则:1、模块名就是范围限定符,各种全局标识符(文件名、全局函数名、全局变量名等)的命名,必须使用范围限定符作为前缀。2、模块名必须进行适当的缩写。例如StandBy模块,省略缩写为STBY;3、模块名要求全部为大写。规范2.3关于C标识符命名规则,请按照「标识符前缀」+「含义标识」规范进行命名。「标识符前缀」由以下元素构成,各部分内容需要遵守相应定义:范围限定符前缀+作用域前
此文档下载收益归作者所有