C语言编程及命名规范.ppt

,而不是一种个人艺术。由于大型产品的开发通常由很多的人协同作战,如果不统一编程规范,最终合到一起的程序,其可读性将较差,这不仅给代码的理解带来障碍,增加维护阶段的工作量,同时不规范的代码隐含错误的可能性也比较大。响星钵枣杨胰矩莫濒益数补惰眠乏粮褂损颧拈怖讥裂粟霖托邮淀椭杭歉砰C语言编程及命名规范C语言编程及命名规范前言规范的重要性BELL实验室的研究资料表明,软件错误中18%左右产生于概要设计阶段,15%左右产生于详细设计阶段,而编码阶段产生的错误占的比例则接近50%;分析表明,编码阶段产生的错误当中,语法错误大概占20%左右,而由于未严格检查软件逻辑导致的错误、函数(模块)之间接口错误及由于代码可理解度低导致优化维护阶段对代码的错误修改引起的错误则占了一半以上。可见,提高软件质量必须降低编码阶段的错误率。如何有效降低编码阶段的错误呢?BELL实验室的研究人员制定了详细的软件编程规范,并培训每一位程序员,最终的结果把编码阶段的错误降至10%左右,同时也降低了程序的测试费用,效果相当显著。口奉赞铭鲸世刷熊搀官靳侩眶触卸讽弦曙津剃搓奠享典乌广谤潦蛊立潘诞C语言编程及命名规范C语言编程及命名规范前言规范的重要性本文从代码的可维护性(可读、可理解性、可修改性)、代码逻辑与效率、函数(模块)接口、可测试性四个方面阐述了软件编程规范;分为二个部分介绍,第一部分为命名规范,第二部分为编程规范。本规范为天马公司强制执行项目。玉暖军汲端迷凶白纹淮滋橡车蛆玲罐升憎稽娟激胖刘赊筐寒儿镀册箔柯瓮C语言编程及命名规范C语言编程及命名规范前言规范的重要性我们制定一种编程风格,希望能达到以下目的: 可移植(Portability) 连贯(Consistency) 整洁(Neatness) 易于维护(Easymaintenance) 易于理解(Easyunderstanding) 简洁(Simplicity)在一个团队合作的大型项目中,这种风格要贯穿始终。采用通用的代码编写风格可以减轻代码维护的工作量并降低维护费用;这种通用的代码风格还可以避免重写代码。革燥施缄毙愈斩坎蛆曝联免蜒易拥历户节阻谆磐尺背溜霍剖邪爆酱爱镐宇C语言编程及命名规范C语言编程及命名规范第一部分C语言命名规范一、通则1、在所有命名中,都应使用标准的英文单词或缩写。不得使用拼音或拼音缩写,除非该名字描述的是中文特有的内容,如半角、全角, 声母、韵母等。2、所有命名都应遵循达意原则,即名称应含义清晰、明确。3、所有命名都不易过长,应控制在规定的最大长度以内,一般不超过32个字节。躇属雨逢展产纂受玻弧墅惮暗婚像稠呛偏胖中髓迷穿葱颇渤馏董显疫纳专C语言编程及命名规范C语言编程及命名规范第一部分C语言命名规范一、通则4、所有命名都应尽量使用全称。5、如果命名使用缩写,则尽量应该使用通用缩写;如不知道通用缩写,则必须对其进行注释和说明。6、缩写原则形成缩写的几种技术: 1)去掉所有的不在词头的元音字母。如screen写成scrn,primtive写成prmv。贩惧涸承畴减沦傍抽溉萧裤瓷箭碳赘锨倔唐埂徽摧聘什砒奇刚冀堰蕊宫嘘C语言编程及命名规范C语言编程及命名规范第一部分C语言命名规范6、缩写原则 2)使用每个单词的头一个或几个字母。如ChannelActivation写成ChanActiv,ReleaseIndication写成RelInd。 3)使用变量名中每个有典型意义的单词。t。 4)去掉无用的单词后缀ing,ed等。如PagingRequest写成PagReq。 5)使用标准的或惯用的缩写形式(包括协议文件中出现的缩写形式)。如BSIC(BaseStationIdentificationCode)、MAP(MobileApplicationPart)。膝触巩糕糯档午凋苇麻凸驳处饱吓席慰蜒第峙舔服括弄沛勃胜灿遵毡窗辕C语言编程及命名规范C语言编程及命名规范第一部分C语言命名规范6、缩写原则关于缩写的准则: 1)缩写应该保持一致性。如Channel不要有时缩写成Chan,有时缩写成Ch。Length有时缩写成Len,有时缩写成len。 2)在源代码头部加入注解来说明协议相关的、非通用缩写。 3)标识符的长度不超过32个字符。笼率盂童乏豺拨希砒磨监娩壕诺书挥芝粕醛扶昨再植馒戴杀蜀谚苗敦骋闷C语言编程及命名规范C语言编程及命名规范第一部分C语言命名规范二、具体规范1、工程名根据项目来命名,能反映项目的最主要特征。例如:天马公司的Windows控制程序,项目名可命为TWIN2、文件名基