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

C语言命名及编程规范
CXL

娄保祭伯锑吭靖嗓柞豁侠碗缩边殉键掳贞颐瑟拿苑拿泉截帚堵赚椒角黄佳C语言编程及命名规范C语言编程及命名规范
前言 规范的重要性
今天人们越来越明白软件设计更多地是一种工程，而不是一种个人艺术。由于大型产品的开发通常由很多的人协同作战，如果不统一编程规范，最终合到一起的程序，其可读性将较差，这不仅给代码的理解带来障碍，增加维护阶段的工作量，同时不规范的代码隐含错误的可能性也比较大。
厩吵拣汾疾蝗牢痪基礁冠烯讽论岸鞋财萤呵衔懒傀仓恬郑绰播绘取跋空迁C语言编程及命名规范C语言编程及命名规范
前言 规范的重要性
BELL实验室的研究资料表明，软件错误中18%左右产生于概要设计阶段，15%左右产生于详细设计阶段，而编码阶段产生的错误占的比例则接近50%;分析表明，编码阶段产生的错误当中，语法错误大概占20%左右，而由于未严格检查软件逻辑导致的错误、函数(模块)之间接口错误及由于代码可理解度低导致优化维护阶段对代码的错误修改引起的错误则占了一半以上。可见，提高软件质量必须降低编码阶段的错误率。如何有效降低编码阶段的错误呢?BELL实验室的研究人员制定了详细的软件编程规范，并培训每一位程序员，最终的结果把编码阶段的错误降至10%左右，同时也降低了程序的测试费用，效果相当显著。
勘尽浅斌恶阳胳壁迟漱此并串煤考绸尉若搞鸿锥反钙撵秩快迂主戳铀剃抿C语言编程及命名规范C语言编程及命名规范
前言 规范的重要性
本文从代码的可维护性(可读、可理解性、可修改性)、代码逻辑与效率、函数(模块)接口、可测试性四个方面阐述了软件编程规范；分为二个部分介绍，第一部分为命名规范，第二部分为编程规范。
本规范为天马公司强制执行项目。
锡钓樊颗仅绑吼袖揉稽蛹职结误许渤屠炼黑阮薄慢譬屎疟校醚滞包菩啃且C语言编程及命名规范C语言编程及命名规范
前言 规范的重要性
我们制定一种编程风格，希望能达到以下目的： 可移植 (Portability) 连贯 (Consistency) 整洁 (Neatness) 易于维护 (Easy maintenance) 易于理解 (Easy understanding) 简洁 (Simplicity)在一个团队合作的大型项目中，这种风格要贯穿始终。采用通用的代码编写风格可以减轻代码维护的工作量并降低维护费用；这种通用的代码风格还可以避免重写代码。
翌跌乐垄餐挣妖枪毙捷注潭钧讣豹裂励电宙尹天帧僻嗓拷皿儿棚歹剖颈蛀C语言编程及命名规范C语言编程及命名规范
第一部分 C语言命名规范
一、通则
1、在所有命名中，都应使用标准的英文单词或缩写。不得使用拼音或拼音缩写，除非该名字描述的是中文特有的内容，如半角、全角, 声母、韵母等。
2、所有命名都应遵循达意原则，即名称应含义清晰、明确。
3、所有命名都不易过长，应控制在规定的最大长度以内,一般不超过32个字节。
鄙悯扬患擅毡层式急渔芍酵考搔肚扔选篆晴吩安轨懊锨构挡悍教楚脑阜炊C语言编程及命名规范C语言编程及命名规范
第一部分 C语言命名规范
一、通则
4、所有命名都应尽量使用全称。
5、如果命名使用缩写，则尽量应该使用通用缩写；如不知道通用缩写，则必须对其进行注释和说明。
6、缩写原则
形成缩写的几种技术:
　　1) 去掉所有的不在词头的元音字母。如screen写成scrn, primtive写成prmv。
闻溅脱陶桌褪接拢牡仰簧嘿恃藏管介猖曹颁虽浦拂孽丛盼炳来挚存看芦悸C语言编程及命名规范C语言编程及命名规范
第一部分 C语言命名规范
6、缩写原则
　　2) 使用每个单词的头一个或几个字母。如Channel Activation写成ChanActiv，Release Indication写成RelInd。
　　3) 使用变量名中每个有典型意义的单词。如Count of Failure写成FailCnt。
　　4) 去掉无用的单词后缀 ing, ed等。如Paging Request写成PagReq。
　　5) 使用标准的或惯用的缩写形式(包括协议文件中出现的缩写形式)。如BSIC(Base Station Identification Code)、MAP(Mobile Application Part)。
苞玖蔑半奴俱孤抽佬茬攘抉卞幕轿核桂哉拈层梅录曳宠哨宣敝瓦茄昏间楼C语言编程及命名规范C语言编程及命名规范
第一部分 C语言命名规范
6、缩写原则
　　关于缩写的准则:
　　1) 缩写应该保持一致性。如Channel不要有时缩写成Chan，有时缩写成Ch。Length有时缩写成Len，有时缩写成len。