欢迎来到天天文库
浏览记录
ID:37900287
大小:152.00 KB
页数:12页
时间:2019-06-02
《VC代码书写规范》由会员上传分享,免费在线阅读,更多相关内容在教育资源-天天文库。
1、Central-ChinaCyberDataSystemCo.,Ltd.VC编程规范版本1.0,2002-1-30华工赛百VC开发小组1排版格式约定1.1程序块采用缩进风格编写,缩进量以一个TAB为单位,每层嵌套缩进一个TAB。1.2相对独立的程序块之间、变量说明之后必须加空行。空行一般为1-3行,不允许存在不规则的空行。示例:如下例子不符合规范。if(VK_ESCAPE==nChar){...//programcode}pLeft.x=m_ptCenter.x-m_nRadius;pLeft.y=m_ptCenter.y-m_nRadi
2、us;应如下书写:if(VK_ESCAPE==nChar){...//programcode}pLeft.x=m_ptCenter.x-m_nRadius;pLeft.y=m_ptCenter.y-m_nRadius;1.3较长的语句(>80字符)要分成多行书写,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读。m_nRadius=(int)sqrt(sqr(m_ptBegin.x-m_ptPrev.x)+sqr(m_ptBegin.y-m_ptPrev.y));1.4循环、判断
3、等语句中若有较长的表达式或语句,则要进行适应的划分,长表达式要在低优先级操作符处划分新行,操作符放在新行之首。if((ptInter.y>=min(ptStart.y,ptEnd.y))&&(ptInter.y<=max(ptStart.y,ptEnd.y))){第12页Central-ChinaCyberDataSystemCo.,Ltd....//programcode}1.1若函数或过程中的参数较长,则要进行适当的划分。1.2不允许把多个短语句写在一行中,即一行只写一条语句。示例:如下例子不符合规范。rect.length=0;re
4、ct.width=0;应如下书写:rect.length=0;rect.width=0;1.3if、for、do、while、case、switch、default等语句自占一行,且if、for、do、while等语句的执行语句部分无论多少都要加括号{}。示例:如下例子不符合规范。if(NULL==pUserCR)return;应如下书写:if(NULL==pUserCR){return;}1.4程序块的分界符(如C/C++语言的大括号‘{’和‘}’)应各独占一行并且位于同一列,同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的
5、定义、枚举的定义以及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。示例:如下例子不符合规范。for(...){...//programcode}if(...){...//programcode}应如下书写:for(...){...//programcode第12页Central-ChinaCyberDataSystemCo.,Ltd.}1.1在两个以上的关键字、变量、常量进行对等操作时,它们之间的操作符之前、之后或者前后要加空格;进行非对等操作时,如果是关系密切的立即操作符(如->),后不应加空
6、格。说明:采用这种松散方式编写代码的目的是使代码更加清晰。示例如下:1.1.1逗号、分号只在后面加空格。inta,b,c;1.1.2比较操作符,赋值操作符"="、"+=",算术操作符"+"、"%",逻辑操作符"&&"、"&",位域操作符"<<"、"^"等双目操作符的前后加空格。if(current_time>=MAX_TIME_VALUE){a=b+c;}a*=2;a=b^2;1.1.3"!"、"~"、"++"、"--"、"&"(地址运算符)等单目操作符前后不加空格。*p='a';//内容操作"*"与内容之间flag=!isEmpty;/
7、/非操作"!"与内容之间p=&mem;//地址操作"&"与内容之间i++;//"++","--"与内容之间1.1.4"->"、"."前后不加空格。p->id=pid;//"->"指针前后不加空格1.1.5if、for、while、switch等与后面的括号间应加空格,使if等关键字更为突出、明显。if((a>=b)&&(c>d))2注释格式约定2.1一般情况下,源程序有效注释量必须在20%以上。说明:注释的原则是有助于对程序的阅读理解,注释不宜太多也不能太少,注释语言必须准确、易懂、简洁。2.2建议单行注释使用“//……”,多行注释使用“
8、/*……*/”。说明:为了注释格式的统一,一般情况下均采用“//……”的注释格式。第12页Central-ChinaCyberDataSystemCo.,Ltd.1.1说明性文件(如头文件.h
此文档下载收益归作者所有