1005.html

著名的linux英雄站点的文档打包

更改为<br>
<br>
// 常量类的宏PIE<br>
<br>
#define PIE 3.1415926<br>
<br>
// 函数类的宏MAX<br>
<br>
#define MAX( a,b ) (/* … */)<br>
<br>
// 常量LENGTH<br>
<br>
const int LENGTH = 1024;<br>
<br>
// 枚举中的常量成员BLUE, RED, WHITE<br>
<br>
（还有几处类似的添加）<br>
<br>
正文P12原则1.7上面<br>
<br>
合理的命名方式肯定在这两个极端中间的某处，但具体在哪里有赖于大家自己的判断。<br>
<br>
更改为<br>
<br>
合理的命名方式肯定在这两个极端中间的某处，但具体在哪里有赖于大家自己的判断。不过，一个组织或部门内部最好统一意见，以方便大家互相理解交流。<br>
<br>
 <br>
<br>
正文P12原则1.7　关于匿名命名空间级标识符的前缀<br>
<br>
原则1.7  关于匿名命名空间级标识符的前缀<br>
<br>
1.7.1  说明<br>
<br>
给匿名命名空间级标识符一个公共前缀（如所属Package名或Library名，加下划线），用来区别其他提供类似功能的Packet或Library等。<br>
<br>
匿名命名空间中的标识符指的是全局或文件级变量名、常量名、宏、类型名、函数名等。<br>
<br>
更改为<br>
<br>
原则1.7  关于全局命名空间级标识符的前缀<br>
<br>
1.7.1  说明<br>
<br>
给全局命名空间（匿名，全局变量缺省所属的那个命名空间，以下同）级标识符一个公共前缀（如所属Package名或Library名，加下划线），用来区别其他提供类似功能的Packet或Library等。<br>
<br>
全局命名空间中的标识符指的是全局或文件级变量名、常量名、宏名、类型名、函数名等。<br>
<br>
正文P13原则1.7　关于匿名命名空间级标识符的前缀<br>
<br>
1.7.3  原因<br>
<br>
如果希望代码复用，则匿名命名空间级标识符就需要防止命名冲突。<br>
<br>
更改为<br>
<br>
如果希望代码复用，则全局命名空间级标识符就需要防止命名冲突。<br>
<br>
 <br>
<br>
正文P13原则1.8  减少匿名命名空间级标识符<br>
<br>
原则1.8  减少匿名命名空间级标识符<br>
<br>
1.8.1  说明<br>
<br>
尽量减少匿名命名空间级变量、常量、宏及函数等标识符。……<br>
<br>
更改为<br>
<br>
原则1.8  减少全局命名空间级标识符<br>
<br>
1.8.1  说明<br>
<br>
尽量减少全局命名空间级变量、常量、宏及函数等标识符。……<br>
<br>
正文P13原则1.8  减少匿名命名空间级标识符<br>
<br>
……<br>
<br>
1.8.2  例子<br>
<br>
class CommonDefinition_T …<br>
<br>
{<br>
<br>
  public :<br>
<br>
    const float PIE;<br>
<br>
// …<br>
<br>
};<br>
<br>
更改为<br>
<br>
1.8.2  例子<br>
<br>
class CommonDefinition_T …<br>
<br>
{<br>
<br>
  public :<br>
<br>
    const float PIE;        // 现在常量PIE不再是全局的<br>
<br>
    // …<br>
<br>
};<br>
<br>
正文P13原则1.8  减少匿名命名空间级标识符<br>
<br>
1.8.3  原因<br>
<br>
……<br>
<br>
缩短生命周期，使之只存在于它应该发挥作用的有限时间内，从而减少麻烦：更好记、更好维护、不会被误用或滥用等。<br>
<br>
更改为<br>
<br>
缩小其有效周期／范围，使之只存在于它应该发挥作用的有限时间／空间内，从而减少麻烦：更好记、更好维护、不会被误用或滥用等。<br>
<br>
正文P16原则1.12  尽量用英文命名<br>
<br>
英语是最通用的语言，特别是在程序语言中，其他语言（比如选择汉语拼音）可能造成阅读者理解上的困难。<br>
<br>
更改为<br>
<br>
英语是最通用的语言，特别是在程序语言中，其他语言（比如选择汉语拼音）可能造成阅读者理解上的困难，也不利于更大范围的代码复用。<br>
<br>
正文P18原则1.19  避免名字中出现形状混淆的字母或数字<br>
<br>
例子<br>
<br>
/*<br>
<br>
* 字母O和数字0形状类似，避免混用；实在无<br>
<br>
* 法避免，最好总是用小写，这样和数字0区别还<br>
<br>
* 大一点<br>
<br>
*/<br>
<br>
更改为<br>
<br>
例子<br>
<br>
/*-----------------------------------------------------------------<br>
<br>
* 字母O和数字0形状类似，避免混用；实在无<br>
<br>
* 法避免，字母O最好总是用小写，这样和数字0<br>
<br>
* 区别还大一点<br>
<br>
*-----------------------------------------------------------------*/<br>
<br>
（为了区分容易，本书所有的/*　　*/的注释均在上下加了短横线--------）<br>
<br>
正文P26原则2.3  少用浮点数除非必须<br>
<br>
原则2.3  少用浮点数除非必须<br>
<br>
更改为<br>
<br>
原则2.3  少用浮点类型除非必须<br>
<br>
C++编码规范》修订说明<br>
<br>
正文P26原则2.3  少用浮点数除非必须<br>
<br>
2.3.1  例子<br>
<br>
int baudRate = 9600;<br>
<br>
int symbolsIn15msec;<br>
<br>
// 使用了浮点数，能避免吗<br>
<br>
更改为<br>
<br>
2.3.1  例子<br>
<br>
int baudRate = 9600;<br>
<br>
int symbolsIn15msec;<br>
<br>
// 使用了浮点类型，能避免吗<br>
<br>
正文P26原则2.3  少用浮点数除非必须<br>
<br>
2.3.2  原因<br>
<br>
……<br>
<br>
浮点数的异常处理复杂（比如上溢、下溢等的处理）。<br>
<br>
……<br>
<br>
更改为<br>
<br>
2.3.2  原因<br>
<br>
……<br>
<br>
浮点类型的异常处理复杂（比如上溢、下溢等的处理）。<br>
<br>
……<br>
<br>
正文P26原则2.4  用typedef简化程序中的复杂语法<br>
<br>
2.4.1  例子<br>
<br>
// 用typedef简化函数指针<br>
<br>
typedef int (*CallbackFuncPtr_T)(int parameter);<br>
<br>
更改为<br>
<br>
2.4.1  例子<br>
<br>
// 用typedef简化函数指针<br>
<br>
typedef int (*CallbackFunctionPtr_T)(int parameter);<br>
<br>
 <br>
<br>
正文P26原则2.4  用typedef简化程序中的复杂语法<br>
<br>
2.4.3  定量分析的参考<br>
<br>
包含4个以上独立元素的语法应被视为复杂语法，如上例中的函数指针定义，不算typedef的独立元素数为5。<br>
<br>
更改为<br>
<br>
2.4.3  定量分析的参考<br>
<br>
包含4个以上独立元素的语法应被视为复杂语法，如上例中的函数指针定义，不算typedef的独立元素数为5（int，*，CallbackFunctionPtr_T，int，parameter）。<br>
<br>
正文P28<br>
<br>
2.7.2  原因<br>
<br>
……<br>
<br>
减少匿名命名空间级变量、常量、宏及函数。<br>
<br>
更改为<br>
<br>
符合“原则1.8  减少全局命名空间级标识符”。<br>
<br>
 <br>
<br>
正文P30<br>
<br>
原则3.1  一定要做到先定义后使用<br>
<br>
3.1.1  说明<br>
<br>
C++必须这样做（否则编译通不过）。C程序没有强制要求，但也应该先提供原型，再使用函数。<br>
<br>
3.1.2  原因<br>
<br>
先定义使得编译器能够在编译时就检查和找出错误（而不是等到连接或运行时）。<br>
<br>
更改为<br>
<br>
原则3.1  函数一定要做到先声明后使用<br>
<br>
3.1.1  说明<br>
<br>
C++必须这样做（否则编译通不过）。C程序没有强制要求，但也应该先提供原型，再使用函数。<br>