条款4:尽量使用C++风格的注释
旧的C注释语法在C++里还可以用,C++新发明的行尾注释语法也有其过人之处。例如下面这种情形:
if ( a > b ) {
// int temp = a; // swap a and b
// a = b;
// b = temp;
}
假设你出于某种原因要注释掉这个代码块。从软件工程的角度看,写这段代码的程序员也做得很好
,他最初的代码里也写了一个注释,以解释代码在做什么。用C++形式的句法来注释掉这个程序块时
,嵌在里面的最初的注释不受影响,但如果选择C风格的注释就会发生严重的错误:
if ( a > b ) {
/* int temp = a; /* swap a and b */
a = b;
b = temp;
*/
}
请注意嵌在代码块里的注释是怎么无意间使本来想注释掉整个代码块的注释提前结束的。
C风格的注释当然还有它存在的价值。例如,它们在C和C++编译器都要处理的头文件中是无法替代的
。尽管如此,只要有可能,你最好尽量用C++风格的注释。
值得指出的是,有些老的专门为C写的预处理程序不知道处理C++风格的注释,所以象下面这种情形
时,事情就不会象预想的那样:
#define LIGHT_SPEED 3e8 // m/sec (in a vacuum)
对于不熟悉C++的预处理程序来说,行尾的注释竟然成为了宏的一部分!当然,正象条款1所说的那
样,你无论如何也不会用预处理来定义常量的。