初习C++点滴摘录之编程的一些规则与建议（4、5）

第四篇——常量的一些规则和建议

常量是一种标识符，它的值在运行期间恒定不变。C语言用#define来定义常量（称为宏常量）。C++语言除了#define外还可以用const来定义常量（称为const常量）。

规则：

【1】      尽量使用含义直观的常量来表示那些将在程序中多次出现的数字或字符串。

【2】      在C++程序中只使用const常量而不是用宏常量。

【3】      需要对外公开的常量放在头文件中，不需要对外公开的常量放在定义文件的头部。

【4】      如果某一常量与其它常量密切相关，应当在定义中包含这种关系，而不应给出一些孤立的值。

---------------------------------------------------------------------------------------------------------------------------------

第五篇——函数设计的一些规则和建议

函数式C++/C程序的基本功能单元.函数设计的细微缺点很容易导致该函数被错用,所以光使函数的功能正确是不行的。

规则：

【1】      参数的书写要完整，不要贪图省事只写参数的类型而省略参数名字。如果函数没有参数，则用void填充。

【2】      参数命名要恰当，顺序要合理。

【3】      如果参数是指针，且仅作输入用，则应在类型前加const，以防止该指针在函数内被意外修改。

【4】      如果输入参数以值传递的方式传递对象，则宜改用“const &”方式来传递，这样可以省去临时对象的构造和析构过程，从而提高效率。

【5】      不要省略返回值的类型。

【6】      函数名和返回值类型在语义上不可冲突。

【7】      不要将正常值和错误标志混在一起返回。正常值用输出参数获得，而错误标志用return语句返回。

【8】      在函数体的“入口处”，对参数的有效性进行检查。

【9】      在函数体的“出口处”，对return语句的正确性和效率进行检查。

注意：

（9-1）return语句不可返回指向“栈内存”的“指针”或者“引用”，因为该内存存在函数体结束时被自动销毁。

（9-2）要搞清楚返回的究竟是“值”、“指针”还是“引用”。

（9-3）如果函数返回值是一个对象，要考虑return的效率。

【10】  使用断言捕捉不应该发生的非法情况。

【11】  在函数入口处，使用断言检查参数的有效性（合法性）。

建议：

【1】      避免函数有太多的参数，参数个数尽量控制在5个以内。如果参数太多。在使用时容易将参数类型或顺序搞错。

【2】      尽量不要使用类型和数目不确定的参数。

【3】      有时候函数原本不需要返回值，但是为了增加灵活性可附加返回值。

【4】      如果函数的返回值是一个对象，有些场合用“引用传递”替换“值传递”可以提高效率。而有些场合只能用“值传递”而不能用“引用传递”，否则会出错。

【5】      函数的功能要单一，不要设计多用途的函数。

【6】      函数体的规模要小，尽量控制在50行代码之内。

【7】      尽量避免函数带有“记忆”功能。相同的输入应该产生相同的输出。带有“记忆”功能的函数，其行为可能是不可预测的，因为它的行为可能取决于某种“记忆状态”。这样的函数既不易于理解又不利于测试和维护。在C/C++语言中函数的static局部变量是函数的“记忆”存储器。建议尽量少用static局部变量，除非必需。

【8】      不仅要检查输入参数的有效性，还要检查通过其他途径进入函数体内的变量的有效性。

【9】      用于出错处理的返回值一定要清楚，让使用者不容易忽视或误解错误情况。

【10】  在编写函数时，要进行反复的考查，并且自问：“我打算做哪些假定？”一旦确定了的假定，就要使用断言对假定进行检查。

【11】  一般教科书都鼓励程序员们进行防错设计，但要记住这种编程风格可能会隐藏错误。当进行防错设计时，如果“不可能发生”的事情的确发生了，则要使用断言进行报警。