高质量C++/C编程指南 页码，16/101 出关键字。 ● 【规则2-3-2】函数名之后不要留空格，紧跟左括号‘(’，以与关键字区别。 ● 【规则233】‘(’向后紧跟，‘)’、‘，’、‘；’向前紧跟，紧跟处不留空格。 ●【规则2-3-4】‘，’之后要留空格，如Function((x,y,z)。如果‘；’不是一行的结束符号，其后要 留空格，如for(initialization;condition;update)。 ● 【规则235】赋值操作符、比较操作符、算术操作符、逻辑操作符、位域操作符，如“=”、 “+=”“=”、“<=”、“+”、“*”、“%”、“&”、“”、“<”,“”等二元操作符 的前后应当加空格。 ● 【规则2-3-6】一元操作符如“！”、“~”、“+”、“-”、“&”（地址运算符）等前后不加 空格。 ● 【规则23-7】象“[]”、“.”、“->”这类操作符前后不加空格。 【建议2-3-1】对于表达式比较长的for语句和f语句，为了紧凑起见可以适当地去掉一些空格，如 for(i=0:i<10;:i+)和if(a<=b)&&(c<=d) void Funcl(int x,int y,int z); /1 良好的风格 void Funcl (int x,int y,int z); 11 不良的风格 if (year >=2000) M 良好的风格 if(year>=2000) 1/ 不良的风格 if(a>=b)&(c<=d) W 良好的风格 if (a>=b&&c<=d) 1/ 不良的风格 for(i=0:i<10;i+) M 良好的风格 for(i=0:i<10:i++) 不良的风格 for(i=0:I<10:i+) 过多的空格 x=a<b？a:b: /1 良好的风格 x=a<b?a:b; 11 不好的风格 int *x =&y; / 良好的风格 int *x=&y; / 不良的风格 array[5]=0; 11 不要写成array[5]=0: a.Function(); M 不要写成a.Function0: b->Function(); 11 不要写成b->Function0): 示例2-3代码行内的空格 2.4对齐 ● 【规则2-41】程序的分界符‘{’和‘}’应独占一行并且位于同一列，同时与引用它们的语句左 对齐。 ● 【规则2-4-2】{}之内的代码块在‘{’右边数格处左对齐。 http://man.chinaunix.net/develop/c&c++/c/c.htm 2006-3-30
出关键字。 l 【规则 2-3-2 】函数名 之后不要留空格， 紧跟左 括号‘（’，以与关键字区别。 l 【规则 2-3-3 】‘（’向后紧跟，‘）’、‘，’、‘;’向前紧跟，紧跟处不留空格。 l 【规则 2-3-4 】‘，’之后要留空格， 如Function(x, y, z) 。如果‘;’不是一行的结 束符号，其后要 留空格， 如for (initialization; condition; update) 。 l 【规则 2-3-5 】赋值操作符 、比较 操作符 、算 术操作符 、逻辑操 作符 、位域操作符， 如“=”、 “+=” “>=”、“<=”、“+”、“*”、“%”、“&&”、“||”、“<<”,“^”等二元操 作符 的前后应当加空格。 l 【规则 2-3-6 】一元操 作符 如“!”、“~”、“++”、“--”、“&”（地 址运算 符）等 前后不加 空格。 l 【规则 2-3-7 】象“［］”、“.”、“->”这类操作符前 后不加空格。 ² 【建议 2-3-1 】对于表达 式比较 长的 for语句 和if语句 ，为了 紧凑 起见可以适当地去掉一些 空格， 如 for (i=0; i<10; i++) 和if ((a<=b) && (c<=d)) 示例 2-3 代码行内的空格 2.4 对齐 l 【规则 2-4-1 】程序的分 界符‘{’和‘}’应独占一行并且 位于同一列，同时与引用它们的语句 左 对齐。 l 【规则 2-4-2 】{ }之内的代码 块在‘{’右边 数格处左对齐。 void Func1(int x, int y, int z); // 良好的风格 void Func1 (int x,int y,int z); // 不良的风格 if (year >= 2000) // 良好的风格 if(year>=2000) // 不良的风格 if ((a>=b) && (c<=d)) // 良好的风格 if(a>=b&&c<=d) // 不良的风格 for (i=0; i<10; i++) // 良好的风格 for(i=0;i<10;i++) // 不良的风格 for (i = 0; I < 10; i ++) // 过多的空格 x = a < b ? a : b; // 良好的风格 x=a<b?a:b; // 不好的风格 int *x = &y; // 良好的风格 int * x = & y; // 不良的风格 array[5] = 0; // 不要写成 array [ 5 ] = 0; a.Function(); // 不要写成 a . Function(); b->Function(); // 不要写成 b -> Function(); 高质量C++/C编程指南 页码，16/101 http://man.chinaunix.net/develop/c&c++/c/c.htm 2006-3-30
高质量C++/C编程指南 页码，17/101 示例2-4(a)为风格良好的对齐，示例2-4(b)为风格不良的对齐。 void Function(int x) void Function(int x){ .../program code .../program code } if (condition) if (condition){ { .../program code ..../program code } } else else …/program code { .../program code } for (initialization;condition:update) for (initialization:condition;update){ .../program code .../program code While (condition) while (condition){ .../program code ...//program code 如果出现嵌套的()，则使用缩进对齐，如： 示例2-4(a)风格良好的对齐 示例2-4(6)风格不良的对齐 2.5长行拆分 ●【规则2-5-1】代码行最大长度宜控制在70至80个字符以内。代码行不要过长，否则眼晴看不过 来，也不便于打印。 http://man.chinaunix.net/develop/c&c++/c/c.htm 2006-3-30
示例2-4（a）为风格良好的对齐， 示例2-4（b）为风格不良的对齐 。 示例2-4(a) 风格良好 的对齐 示例2-4(b) 风格不良 的对齐 2.5 长行拆分 l 【规则 2-5-1 】代码行 最大 长度宜控制 在70至80个字符以内。代码行 不要过长，否则眼睛 看不过 来，也不便于打印。 void Function(int x) { … // program code } void Function(int x){ … // program code } if (condition) { … // program code } else { … // program code } if (condition){ … // program code } else { … // program code } for (initialization; condition; update) { … // program code } for (initialization; condition; update){ … // program code } While (condition) { … // program code } while (condition){ … // program code } 如果出现嵌套的｛｝，则 使用缩进对齐， 如： { … { … } … } 高质量C++/C编程指南 页码，17/101 http://man.chinaunix.net/develop/c&c++/c/c.htm 2006-3-30
高质量C++/C编程指南 页码，18/101 【规则2-5-2】长表达式要在低优先级操作符处拆分成新行，操作符放在新行之首（以便突出操作 符)。拆分出的新行要进行适当的缩进，使排版整齐，语句可读。 if ((very_longer_variablel >very_longer_variablel2) &&(very_longer_variable3 <very_longer_variablel4) &&(very_longer_variable5 <very_longer_variablel6)) { dosomething(; } virtual CMatrix CMultiplyMatrix (CMatrix leftMatrix, CMatrix rightMatrix); for (very_longer_initialization; very_longer_condition: very_longer_update) dosomething(); 示例2-5长行的拆分 2.6修饰符的位置 修饰符*和&应该靠近数据类型还是该靠近变量名，是个有争议的活题。 若将修饰符*靠近数据类型，例如：int*x;从语义上讲此写法比较直观，即x是it类型的指 针。 上述写法的弊端是容易引起误解，例如：it*x,y;此处y容易被误解为指针变量。虽然将x和y 分行定义可以避免误解，但并不是人人都愿意这样做。 ● 【规则2-6-1】应当将修饰符*和&紧靠变量名 例如： char *name; intx,y;//此处y不会被误解为指针 2.7注释 C语言的注释符为“/体*/”。C+语言中，程序块的注释常采用“体*1”，行注释一般采用 “∥.”。注释通常用于： (1)版本、版权声明： (2)函数接口说明： http://man.chinaunix.net/develop/c&c++/c/c.htm 2006-3-30
l 【规则 2-5-2 】长表达式要在低优先级 操作符 处拆分成 新行，操作符放在新行之首（以便突出操作 符）。拆分出的新行要进行适当的缩进，使排版整齐，语句可读。 示例2-5 长行的拆分 2.6 修饰符的位置 修饰符 * 和 ＆ 应该靠近数据类型还是该靠近变量名，是个有争议的活题。 若将修饰符 * 靠近数据类型，例如：int* x; 从语义上讲此写法比较 直观，即x是int 类型的指 针。 上述写 法的弊端 是容易 引起误 解，例如：int* x, y; 此处y容易 被误解为指针变 量。虽然将x和y 分行定义 可以避免误解，但并不是人人都愿意这样做。 l 【规则 2-6-1 】应当将修饰符 * 和 ＆ 紧靠变量名 例如： char *name; int *x, y; // 此处y不会被误解为指针 2.7 注释 C语言 的注释符 为 “/*…*/”。C++ 语言 中，程序 块 的注释 常 采 用 “/*…*/”，行注释 一 般 采 用 “//…”。注释通常用于： （1）版本、版权声明 ； （2）函数接口说明； if ((very_longer_variable1 >= very_longer_variable12) && (very_longer_variable3 <= very_longer_variable14) && (very_longer_variable5 <= very_longer_variable16)) { dosomething(); } virtual CMatrix CMultiplyMatrix (CMatrix leftMatrix, CMatrix rightMatrix); for (very_longer_initialization; very_longer_condition; very_longer_update) { dosomething(); } 高质量C++/C编程指南 页码，18/101 http://man.chinaunix.net/develop/c&c++/c/c.htm 2006-3-30
高质量C++/C编程指南 页码，19/101 (3)重要的代码行或段落提示。 虽然注释有助于理解代码，但注意不可过多地使用注释。参见示例2-6。 ● 【规则2-7-1】注释是对代码的“提示”，而不是文档。程序中的注释不可喧宾夺主，注释太多了 会让人眼花缭乱。注释的花样要少。 ● 【规则2-7-2】如果代码本来就是清楚的，则不必加注释。否则多此一举，令人厌烦。例如 i+://i加1，多余的注释 ● 【规则2-7-3】边写代码边注释，修改代码同时修改相应的注释，以保证注释与代码的一致性。不 再有用的注释要删除。 ● 【规则2-7-4】注释应当准确、易懂，防止注释有二义性。错误的注释不但无益反而有害。 ● 【规则2-7-5】尽量避免在注释中使用缩写，特别是不常用缩写。 ● 【规则2-7-6】注释的位置应与被描述的代码相邻，可以放在代码的上方或右方，不可放在下方。 【规则2-7-8】当代码比较长，特别是有多重嵌套时，应当在一些段落的结束处加注释，便于阅 读。 示例2-6程 序的注释 if(..) *函数介绍： *输入参数： 2.8类 *输出参数： while(...) 的版式 *返回值： \ 类可 void Function(float x,float y,float z) }l∥end of while 以将数据 和函数封 }l∥end of if 装在一 起，其中 函数表示 了类的行为（或称服务）。类提供关键字public、protected和private,分别用于声明哪些数据和函数是 公有的、受保护的或者是私有的。这样可以达到信息隐藏的目的，即让类仅仅公开必须要让外界知道 的内容，而隐藏其它一切内容。我们不可以滥用类的封装功能，不要把它当成火锅，什么东西都往里 扔。 类的版式主要有两种方式： (1)将private类型的数据写在前面，而将public类型的函数写在后面，如示例8-3(a)。采用这种版式 的程序员主张类的设计“以数据为中心”，重点关注类的内部结构。 (2)将public类型的函数写在前面，而将private类型的数据写在后面，如示例8.3(b)采用这种版式的 程序员主张类的设计“以行为为中心”，重点关注的是类应该提供什么样的接口（或服务）。 很多C+教课书受到Biarne Stroustrup第一本著作的影响，不知不觉地采用了“以数据为中心”的 书写方式，并不见得有多少道理。 我建议读者采用“以行为为中心”的书写方式，即首先考虑类应该提供什么样的函数。这是很多 http://man.chinaunix.net/develop/c&c++/c/c.htm 2006-3-30
（3）重要的代码行 或段落提示。 虽然注释有助于理解代码， 但注意不可过多地使用注释 。参见示例2-6。 l 【规则 2-7-1 】注释 是对代码的 “提示”，而不是文档。程序中的注释 不可喧宾夺 主，注释 太多了 会让人眼花缭乱。注释的 花样要少。 l 【规则 2-7-2 】如果代码本 来就是清楚的，则 不必加注释。否则多此一举，令人厌烦。例如 i++; // i 加 1，多余的注释 l 【规则 2-7-3 】边写代码边注释，修改代码 同时修改相应的注释， 以保证注释与代码的 一致性。不 再有用的注释 要删除。 l 【规则 2-7-4 】注释应当 准确、易懂，防止注释 有二义性。错误的注释 不但无益反而有害。 l 【规则 2-7-5 】尽量避免在注释中 使用缩写，特别是不常用缩写。 l 【规则 2-7-6 】注释的位置应与 被描述的代码 相邻，可以放在代码的 上方或右方，不可放在下方。 l 【规则 2-7-8 】当代码 比较 长，特别是有 多重嵌套时，应当 在一些 段落的结 束处加注释， 便于阅 读。 示例2-6 程 序的注释 2.8 类 的版式 类 可 以将 数 据 和 函数 封 装 在 一 起，其 中 函数表 示 了类的行 为（或称服务）。类提供关键字public 、protected 和private ，分 别用于声明 哪些数 据和函数是 公有的、受保护的或者是私有的。这 样可以达到信息隐藏 的目的， 即让类仅仅 公开必须要让外界知道 的内 容，而隐藏其它一 切内容。我 们不可以滥用类的 封装 功能 ，不要把它 当成 火锅 ，什么 东西 都往 里 扔。 类的版式 主要有两种方式： （1）将private 类型的数据写 在前面，而将 public 类型的函数写在后面，如示例8-3（a）。采用这种版式 的程序 员主张类的设计“以数据为中心”，重点关注类的内 部结构。 （2）将public 类型的函数 写在前面，而将 private 类型的数据写 在后面，如示例 8.3（b）采用这种版式的 程序员主张类的设计“以行为为中心”，重点关注的是类应该提供什么样的接口（或服务）。 很多C++教课书受 到Biarne Stroustrup 第一本著作的 影响 ，不知不觉地 采用了“以数据为中心”的 书写方式，并不见得有 多少道理。 我建议 读者采用“以行为为 中心”的书写方式，即首先考虑类应 该提供什么 样的函数 。这 是很多 /* * 函数介绍： * 输入参数： * 输出参数： * 返回值 ： */ void Function(float x, float y, float z) { … } if (…) { … while ( …) { … } // end of while … } // end of if 高质量C++/C编程指南 页码，19/101 http://man.chinaunix.net/develop/c&c++/c/c.htm 2006-3-30
高质量C++/C编程指南 页码，20/101 人的经验一“这样做不仅让自己在设计类时思路清晰，而且方便别人阅读。因为用户最关心的 是接口，谁愿意先看到一堆私有数据成员！” class A class A { { private: public: int i,j: void Funcl(void); float x,y; void Func2(void); … public: private: void Funcl(void); int i,j: void Func2(void); float x,y; 示例8.3(a)以数据为中心版式 示例8.3b)以行为为中心的版式 http://man.chinaunix.net/develop/c&c++/c/c.htm 2006-3-30
人的经验——“这样做不仅让自己在设计 类时思路清晰 ，而且方便别人阅读。 因为用户最关心的 是接口，谁愿意先看到一堆私有数据成员！” 示例8.3(a) 以数据为中心版式 示例8.3(b) 以行为为中心的版式 class A { private: int i, j; float x, y; … public: void Func1(void); void Func2(void); … } class A { public: void Func1(void); void Func2(void); … private: int i, j; float x, y; … } 高质量C++/C编程指南 页码，20/101 http://man.chinaunix.net/develop/c&c++/c/c.htm 2006-3-30