函数设计规则

函数接口的两个要素是参数和返回值。

C 语言中，函数的参数和返回值的传递方式有两种：值传递和指针传递。C++ 语言中多了引用传递。

1.参数的规则

（1）如果函数没有参数，则用void 填充；

（2）如果参数是指针，且仅作输入用，则应在类型前加const，以防止该指针在函数体内被意外修改；

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

（4）避免函数有太多的参数，参数个数尽量控制在5 个以内。

 

2.返回值的规则

（1）不要省略返回值的类型；

（2）函数名字与返回值类型在语义上不可冲突；

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

（4）如果函数的返回值是一个对象，有些场合用“引用传递”替换“值传递”可以提高效率。而有些场合只能用“值传递”而不能用“引用传递”，否则会出错。(不能将局部变量的引用作为返回值)。

 

3.函数内部实现的规则

（1）在函数体的“入口处”，对参数的有效性进行检查。
         很多程序错误是由非法参数引起的，我们应该正确使用“断言”（assert）来防止此类错误

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

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

         如果函数返回值是一个对象，要考虑return 语句的效率。例如
         return String(s1 + s2);//这是临时对象的语法，表示“创建一个临时对象并返回它”

（3）函数的功能要单一，函数体的规模要小，尽量控制在50 行代码之内

 

4. assert(断言)

（1）程序一般分为Debug 版本和Release 版本，Debug 版本用于内部调试，Release 版本发行给用户使用。
（2）断言 assert 是仅在Debug 版本起作用的宏，不是函数，它用于检查“不应该”发生的情况。

（3）使用断言捕捉不应该发生的非法情况。

        注意：不要混淆非法情况与错误情况之间的区别，后者是必然存在的并且是一定要作出处理的。

（摘自林锐高质量C++编程指南）