高质量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型。
(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型。
/* * 函数介绍: * 输入参数: * 输出参数: * 返回值 : */ |
相关文章推荐
- 读林锐博士 高质量C++/C编程指南 笔记 2006-11-15第二章程序的版式
- 高质量C&C++编程指南阅读笔记,让程序更好看!
- 高质量的C++编程指南总结(一):文件结构、程序版式、命名规则、表达式和基本语句
- 【C】【笔记】高质量C++编程指南
- 高质量C++编程指南笔记3:命名规则
- 高质量C++编程指南学习笔记第11章---thanks to林锐
- C/C++高质量编程笔记-第二章 程序的版式
- 高质量C++编程指南学习笔记第7章---thanks to林锐
- 高质量C++编程指南学习笔记第8章---thanks to林锐
- 高质量C /C编程指南---第2章 程序的版式
- 高质量C++/C编程指南 - 第2章 程序的版式
- 高质量C++编程指南学习笔记1-2章---thanks to林锐
- 高质量C/C++编程指南--程序版式
- 高质量C++/C编程指南 -- 第2章 程序的版式
- 高质量c++编程指南(笔记4-11章)
- 高质量C++编程指南学习笔记5-6章---thanks to林锐
- 高质量C++/C编程指南 -- 第2章 程序的版式
- 高质量C++/C编程指南(第2章 程序的版式)
- 高质量C++编程指南学习笔记第10章---thanks to林锐
- 高质量C++/C编程指南 -- 第2章 程序的版式