您的位置:首页 > 编程语言 > C语言/C++

高质量C++编程指南笔记2:程序的版式

2007-04-15 18:56 441 查看
一.空行规则
(1)类的声明之后,函数的定义之后加入空行。
(2)逻辑相关的一组语句之间不要加入空行。

二.代码行
(1)每行只写一条语句,或只做一件事。
(2)if、while等控制语句的关键字独占一行,不论体内有多少代码都要用{}。
(3)建议声明的同时进行初始化。

三.代码行内的空格
(1)关键字后要跟空格,if、while等空格后加括号。
(2)函数名后不要加空格直接加括号。
(3)“,”后加空格。
(4)二元运算符前后个加一个空格,一元运算符紧跟,不加。
(5)“[ ]”、“.”、“->”这类操作符不加空格。

四.对齐
“{” 、“}”各占一行并对齐

五.长行拆分
(1)每行控制在70~80个字符以内。
(2)长表达式要在低优先级操作符处拆分成新行,操作符放在新行之首(以便突出操作符)。拆分出的新行要进行适当的缩进,使排版整齐,语句可读。

六.修饰符
*,&紧靠变量名。(但是C#及Java都建议把*靠近类型名以体现面向对象思想)

七.注释
(1)版本、版权信息
(2)函数接口信息
/*
* 函数介绍:
* 输入参数:
* 输出参数:
* 返回值 :
*/
(3)重要的行或段落
(4) 注释要适当,不宜过多。
(5)边写代码边写注释;改变代码的同时改变注释;删除无用注释。
(6)注释加在上方或右方,而不应在下方。
(7)较长代码,或多重嵌套应在段落结束加注释以说明。

八.类的版式
先添加成员函数,在最后添加成员变量(以行为为中心)。成员变量建议都为private型。

/*
* 函数介绍:
* 输入参数:
* 输出参数:
* 返回值 :
*/
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: