C++/C高质量编程指南

201 浏览量更新于2024-06-28 收藏 88KB DOCX 举报

"C高质量编程.docx 是一本由林锐博士编写的，旨在提升C++/C编程质量的指南。该文件已经过朱洪海审查并修正，是正式的出版文件，版本完成于2001年7月24日。书中详细探讨了多个关键编程实践，包括文件结构、程序版式、命名规则、表达式和基本语句、常量的使用、函数设计、内存管理和C++的高级函数特性等。在文件结构部分，作者强调了版权声明和版本信息的重要性，以及头文件的结构和作用，特别是头文件在定义文件结构和目录组织中的角色。程序的版式章节涉及空行的使用、代码行和空格的布局、对齐规则、长行的拆分、修饰符的位置，以及注释的编写方式，这些都是为了提高代码可读性和维护性。同时，还详细讲解了类的版式设计，以符合良好的面向对象编程习惯。命名规则章节中，不仅有通用的规则，还有针对Windows和UNIX应用程序的特定命名规范，以确保代码的一致性和跨平台兼容性。在表达式和基本语句的讨论中，涵盖了运算符优先级、复合表达式、IF语句、循环语句的效率优化，FOR语句的循环控制变量处理，SWITCH语句和GOTO语句的使用，强调了控制流程的清晰性和效率。关于常量，书中讨论了为何需要常量，比较了CONST和#DEFINE的差异，并详细阐述了常量定义的规则，以及类中常量的使用方法。函数设计部分，作者提出了参数和返回值的规则，以及函数内部实现的最佳实践，推荐使用断言来增强程序的健壮性，并对比了引用和指针的用法。内存管理是C++编程中至关重要的一部分，书中详细解释了指针参数如何传递内存，FREE和DELETE操作可能导致的问题，动态内存是否自动释放，如何避免“野指针”，NEW/DELETE与MALLOC/FREE的区别，以及当内存耗尽时的处理策略。此外，还分享了一些实用的内存管理经验和注意事项。最后，C++函数的高级特性章节介绍了函数重载的概念，成员函数的重载、覆盖和隐藏，这些都是C++多态性的基础，对于理解和编写复杂的C++程序至关重要。这本书是C++/C程序员提高编程质量和遵循最佳实践的宝贵资源，通过学习，开发者可以提升自己的编程技巧，编写出更高效、更易于维护的代码。"

for (very_longer_initialization;

very_longer_condition;

very_longer_update)

{

dosomething();

}

例如 2-5 长行的拆分

2.6 修饰符的位置

修饰符 * 和＆应该靠近数据类型还是该靠近变量名，是个有争议的活题。

假设将修饰符 * 靠近数据类型，例如：int* x; 从语义上讲此写法比拟直观，即 x 是 int

类型的指针。

上述写法的弊端是容易引起误解，例如：int* x, y; 此处 y 容易被误解为指针变量。虽然将

x 和 y 分行定义可以防止误解，但并不是人人都愿意这样做。

� 【规那么 2-6-1】应当将修饰符 * 和＆紧靠变量名

例如：

char *name;

int *x, y; // 此处 y 不会被误解为指针

2.7 注释

C 语言的注释符为“/*…*/〞。C++语言中，程序块的注释常采用“/*…*/〞，行注释一般采

用“//…〞。注释通常用于：

〔2〕函数接口说明；

〔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】当代码比拟长，特别是有多重嵌套时，应当在一些段落的结束处加注

释，便于阅读。

void Func1(void);

void Func2(void);

…

} class A

{

public:

void Func1(void);

void Func2(void);

…

private:

int i, j;

float x, y;

…

}

例如 8.3(a) 以数据为中心版式例如 8.3(b) 以行为为中心的版式

第 3 章命名规那么

比拟著名的命名规那么当推 Microsoft 公司的“匈牙利〞法，该命名规那么的主要思想是“在

变量和函数名中参加前缀以增进人们对程序的理解〞。例如所有的字符变量均以 ch 为前缀，

假设是指针变量那么追加前缀 p。如果一个变量由 ppch 开头，那么说明它是指向字符指针

的指针。

“匈牙利〞法最大的缺点是烦琐，例如

int i, j, k;

float x, y, z;

倘假设采用“匈牙利〞命名规那么，那么应当写成

int iI, iJ, ik; // 前缀 i 表示 int 类型

float fX, fY, fZ; // 前缀 f 表示 float 类型

如此烦琐的程序会让绝大多数程序员无法忍受。

据考察，没有一种命名规那么可以让所有的程序员赞同，程序设计教科书一般都不指定命名

规那么。命名规那么对软件产品而言并不是“成败悠关〞的事，我们不要化太多精力试图创

造世界上最好的命名规那么，而应当制定一种令大多数工程成员满意的命名规那么，并在工

程中贯彻实施。

3.1 共性规那么

本节论述的共性规那么是被大多数程序员采纳的，我们应当在遵循这些共性规那么的前

提下，再扩充特定的规那么，如 3.2 节。

� 【规那么 3-1-1】标识符应当直观且可以拼读，可望文知意，不必进行“解码〞。

标识符最好采用英文单词或其组合，便于记忆和阅读。切忌使用汉语拼音来命名。程序中的

英文单词一般不会太复杂，用词应当准确。例如不要把 CurrentValue 写成 NowValue。

� 【规那么 3-1-2】标识符的长度应当符合“min-length && max-information〞原那么。

几十年前老 ANSI C 规定名字不准超过 6 个字符，现今的 C++/C 不再有此限制。一般来说，

长名字能更好地表达含义，所以函数名、变量名、类名长达十几个字符缺乏为怪。那么名字

是否越长约好？不见得! 例如变量名 maxval 就比 maxValueUntilOverflow 好用。单字符的名

字也是有用的，常见的如 i,j,k,m,n,x,y,z 等，它们通常可用作函数内的局部变量。

� 【规那么 3-1-3】命名规那么尽量与所采用的操作系统或开发工具的风格保持一致。

例如 Windows 应用程序的标识符通常采用“大小写〞混排的方式，如 AddChild。而 Unix 应

用程序的标识符通常采用“小写加下划线〞的方式，如 add_child。别把这两类风格混在一

起用。

� 【规那么 3-1-4】程序中不要出现仅靠大小写区分的相似的标识符。

例如：

int x, X; // 变量 x 与 X 容易混淆

void foo(int x); // 函数 foo 与 FOO 容易混淆

void FOO(float x);

� 【规那么 3-1-5】程序中不要出现标识符完全相同的局部变量和全局变量，尽管两者的

作用域不同而不会发生语法错误，但会使人误解。

� 【规那么 3-1-6】变量的名字应当使用“名词〞或者“形容词＋名词〞。

例如：

float value;

float oldValue;

float newValue;

� 【规那么 3-1-7】全局函数的名字应当使用“动词〞或者“动词＋名词〞〔动宾词组〕。

类的成员函数应当只使用“动词〞，被省略掉的名词就是对象本身。

例如：

DrawBox(); // 全局函数

box->Draw(); // 类的成员函数

� 【规那么 3-1-8】用正确的反义词组命名具有互斥意义的变量或相反动作的函数等。

例如：

int minValue;

int maxValue;

int SetValue(…);

int GetValue(…);

� 【建议 3-1-1】尽量防止名字中出现数字编号，如 Value1,Value2 等，除非逻辑上确实需

要编号。这是为了防止程序员偷懒，不肯为命名动脑筋而导致产生无意义的名字〔因为用数

字编号最省事〕。

3.2 简单的 Windows 应用程序命名规那么

作者对“匈牙利〞命名规那么做了合理的简化，下述的命名规那么简单易用，比拟适合

于 Windows 应用软件的开发。

剩余80页未读，继续阅读

智慧安全方案

粉丝: 3817
资源: 59万+

C++/C高质量编程指南

C高质量编程.doc编程资料

高质量C编程指南.doc

高质量C C编程指南.doc

C语言编程规范标准.docx

C语言编程宝典网址.docx

C语言编程规范.docx

高质量c++c编程指南.docx

C语言的内存管理.docx

C语言经典课程2.docx

学习C语言中的结构体.docx

最新资源