# Item 18: 使接口易于正确使用，而难以错误使用
作者：Scott Meyers
译者：fatalerror99 (iTePub's Nirvana)
发布：http://blog.csdn.net/fatalerror99/
C++ 被淹没于接口中。函数接口、类接口、模板接口。每一个接口都意味着客户的代码和你的代码互相影响。假设你在和通情达理的人打交道，那些客户也想做好工作。他们想要正确使用你的接口。在这种情况下，如果他们犯了一个错误，就说明你的接口至少有部分是不完善的。在理想情况下，如果一个接口的一种尝试的用法不符合客户的预期，代码将无法编译，反过来，如果代码可以编译，那么它做的就是客户想要的。
开发易于正确使用，而难以错误使用的接口需要你考虑客户可能造成的各种错误。例如，假设你正在设计一个代表时间的类的构造函数：
```
class Date {
public:
Date(int month, int day, int year);
...
};
```
匆匆一看，这个接口似乎是合乎情理的（至少在美国），但是客户可能很容易地造成两种错误。首先，他们可能会以错误的顺序传递参数：
```
Date d(30, 3, 1995); // Oops! Should be "3, 30" , not "30, 3"
```
第二，他们可能传递一个非法的代表月或日的数字：
```
Date d(2, 20, 1995); // Oops! Should be "3, 30" , not "2, 20"
```
（后面这个例子看上去好像没什么，但是想想键盘上，2 就在 3 的旁边，这种 "off by one" 类型的错误并不罕见。）
很多客户错误都可以通过引入新的类型来预防。确实，类型系统是你阻止那些不合适的代码通过编译的主要支持者。在当前情况下，我们可以引入简单的包装类型来区别日，月和年，并将这些类型用于 Data 的构造函数。
```
struct Day { struct Month { struct Year {
explicit Day(int d) explicit Month(int m) explicit Year(int y)
:val(d) {} :val(m) {} :val(y){}
int val; int val; int val;
}; }; };
class Date {
public:
Date(const Month& m, const Day& d, const Year& y);
...
};
Date d(30, 3, 1995); // error! wrong types
Date d(Day(30), Month(3), Year(1995)); // error! wrong types
Date d(Month(3), Day(30), Year(1995)); // okay, types are correct
```
将日，月和年做成封装数据的羽翼丰满的类比上面的简单地使用 struct 更好（参见 Item 22），但是即使是 struct 也足够证明明智地引入新类型在阻止接口的错误使用方面能工作得非常出色。
只要放置了正确的类型，它往往能合理地限制那些类型的值。例如，月仅有 12 个合法值，所以 Month 类型应该反映这一点。做到这一点的一种方法是用一个枚举来表现月，但是枚举不像我们希望的那样是类型安全（type-safe）的。例如，枚举能被作为整数使用（参见 Item 2）。一个安全的解决方案是预先确定合法的 Month 的集合：
```
class Month {
public:
static Month Jan() { return Month(1); } // functions returning all valid
static Month Feb() { return Month(2); } // Month values; see below for
... // why these are functions, not
static Month Dec() { return Month(12); } // objects
... // other member functions
private:
explicit Month(int m); // prevent creation of new
// Month values
... // month-specific data
};
Date d(Month::Mar(), Day(30), Year(1995));
```
如果用函数代替对象来表现月的主意让你感到惊奇，那可能是因为你忘了非局部静态对象（non-local static objects）的初始化的可靠性是值得怀疑的。Item 4 能唤起你的记忆。
防止可能的客户错误的另一个方法是限制对一个类型能够做的事情。施加限制的一个普通方法就是加上 const。例如，Item 3 解释了使 operator\* 的返回类型具有 const 资格是如何能够防止客户对用户自定义类型犯下这样的错误：
```
if (a * b = c) ... // oops, meant to do a comparison!
```
实际上，这仅仅是另一条使类型易于正确使用而难以错误使用的普遍方针的一种表现：除非你有很棒的理由，否则就让你的类型的行为与内建类型保持一致。客户已经知道像 int 这样的类型如何表现，所以你应该努力使你的类型的表现无论何时都同样合理。例如，如果 a 和 b 是 int，给 a\*b 赋值是非法的。所以除非有一个非常棒理由脱离这种表现，否则，对你的类型来说这样做也应该是非法的。
避免和内建类型毫无理由的不相容的真正原因是为了提供行为一致的接口。很少有特性比一致性更易于引出易于使用的接口，也很少有特性比不一致性更易于引出令人郁闷的接口。STL 容器的接口在很大程度上（虽然并不完美）是一致的，而且这使得它们相当易于使用。例如，每一种 STL 容器都有一个名为 size 的成员函数可以知道容器中有多少对象。与此对比的是 Java，在那里你对数组使用 length 属性，对 String 使用 length 方法，而对 List 却要使用 size 方法，在 .NET 中，Array 有一个名为 Length 的属性，而 ArrayList 却有一个名为 Count 的属性。一些开发人员认为集成开发环境（IDEs）能补偿这些琐细的矛盾，但他们错了。矛盾在开发者工作中强加的精神折磨是任何 IDE 都无法完全消除的。
任何一个要求客户记住某些事情的接口都是有错误使用倾向的，因为客户可能忘记做那些事情。例如，Item 13 介绍了一个 factory 函数，它返回一个指向动态分配的 Investment 继承体系中的对象的指针。
```
Investment* createInvestment(); // from Item 13; parameters omitted
// for simplicity
```
为了避免资源泄漏，createInvestment 返回的指针最后必须被删除，但这就为至少两种类型的客户错误创造了机会：删除指针失败，或删除同一个指针一次以上。
Item 13 展示了客户可以怎样将 createInvestment 的返回值存入一个类似 auto_ptr 或 tr1::shared_ptr 智能指针，从而将使用 delete 的职责交给智能指针。但是如果客户忘记使用智能指针呢？在很多情况下，一个更好的接口会预先判定将要出现的问题，从而让 factory 函数在第一现场即返回一个智能指针：
```
std::tr1::shared_ptr<Investment> createInvestment();
```
这就从根本上强制客户将返回值存入一个 tr1::shared_ptr，几乎完全消除了当底层的 Investment 对象不再使用的时候忘记删除的可能性。
实际上，返回一个 tr1::shared_ptr 使得接口的设计者预防许多其它客户的与资源泄漏相关的错误成为可能，因为，就像 Item 14 解释的：当一个智能指针被创建的时候，tr1::shared_ptr 允许将一个资源释放（resource-release）函数——一个 "deleter" ——绑定到智能指针上。（auto_ptr 则没有这个能力。）
假设从 createInvestment 得到一个 Investment\* 指针的客户期望将这个指针传给一个名为 getRidOfInvestment 的函数，而不是对它使用 delete。这样一个接口又为一种新的客户错误打开了门，这就是客户可能使用了错误的资源析构机制（也就是说，用了 delete 而不是 getRidOfInvestment）。createInvestment 的实现可以通过返回一个在它的 deleter 上绑定了 getRidOfInvestment 的 tr1::shared_ptr 来预防这个问题。
tr1::shared_ptr 提供了一个需要两个参数（要被管理的指针和当引用计数变为零时要调用的 deleter）的构造函数。这里展示了创建一个以 getRidOfInvestment 为 deleter 的 null tr1::shared_ptr 的方法：
```
std::tr1::shared_ptr<Investment> // attempt to create a null
pInv(0, getRidOfInvestment); // shared_ptr with a custom deleter;
// this won't compile
```
唉，这不是合法的 C++。tr1::shared_ptr 的构造函数坚决要求它的第一个参数应该是一个指针，而 0 不是一个指针，它是一个 int。当然，它能转型为一个指针，但那在当前情况下并不够好用，tr1::shared_ptr 坚决要求一个真正的指针。用强制转型解决这个问题：
```
std::tr1::shared_ptr<Investment> // create a null shared_ptr with
pInv(static_cast<Investment*>(0), // getRidOfInvestment as its
getRidOfInvestment); // deleter; see Item 27 for info on
// static_cast
```
据此，实现返回一个以 getRidOfInvestment 作为 deleter 的 tr1::shared_ptr 的 createInvestment 的代码看起来就像这个样子：
```
std::tr1::shared_ptr<Investment> createInvestment()
{
std::tr1::shared_ptr<Investment> retVal(static_cast<Investment*>(0),
getRidOfInvestment);
retVal = ... ; // make retVal point to the
// correct object
return retVal;
}
```
当然，如果将被 pInv 管理的裸指针可以在创建 pInv 时被确定，最好是将这个裸指针传给 pInv 的构造函数，而不是将 pInv 初始化为 null 然后再赋值给它。至于方法上的细节，参考 Item 26。
tr1::shared_ptr 的一个特别好的特性是它自动逐指针地使用 deleter 以消除另一种潜在的客户错误——“cross-DLL 问题。”这个问题发生在这种情况下：一个对象在一个动态链接库（dynamically linked library (DLL)）中通过 new 被创建，在另一个不同的 DLL 中被删除。在许多平台上，这样的 cross-DLL new/delete 对会引起运行时错误。tr1::shared_ptr 可以避免这个问题，因为它的缺省的 deleter 只将 delete 用于这个 tr1::shared_ptr 被创建的 DLL 中。这就意味着，例如，如果 Stock 是一个继承自 Investment 的类，而且 createInvestment 被实现如下，
```
std::tr1::shared_ptr<Investment> createInvestment()
{
return std::tr1::shared_ptr<Investment>(new Stock);
}
```
返回的 tr1::shared_ptr 能在 DLL 之间进行传递，而不必关心 cross-DLL 问题。指向这个 Stock 的 tr1::shared_ptr 将保持对“当这个 Stock 的引用计数变为零的时候，哪一个 DLL 的 delete 应该被使用”的跟踪。
这个 Item 不是关于 tr1::shared_ptr 的——而是关于使接口易于正确使用，而难以错误使用的——但 tr1::shared_ptr 正是这样一个消除某些客户错误的简单方法，值得用一个概述来看看使用它的代价。最通用的 tr1::shared_ptr 实现来自于 Boost（参见 Item 55）。Boost 的 shared_ptr 的大小是裸指针的两倍，将动态分配内存用于簿记和 deleter 专用（deleter-specific）数据，当调用它的 deleter 时使用一个虚函数来调用，在一个它认为是多线程的应用程序中，当引用计数被改变，会导致线程同步开销。（你可以通过定义一个预处理符号来使多线程支持失效。）在缺点方面，它比一个裸指针大，比一个裸指针慢，而且要使用辅助的动态内存。在许多应用程序中，这些附加的运行时开销并不显著，而对客户错误的减少却是每一个人都看得见的。
Things to Remember
* 好的接口易于正确使用，而难以错误使用。你应该在你的所有接口中为这个特性努力。
* 使易于正确使用的方法包括在接口和行为兼容性上与内建类型保持一致。
* 预防错误的方法包括创建新的类型，限定类型的操作，约束对象的值，以及消除客户的资源管理职责。
* tr1::shared_ptr 支持自定义 deleter。这可以防止 cross-DLL 问题，能用于自动解锁互斥体（参见 Item 14）等。
- Preface（前言）
- Introduction（导言）
- Terminology（术语）
- Item 1: 将 C++ 视为 federation of languages（语言联合体）
- Item 2: 用 consts, enums 和 inlines 取代 #defines
- Item 3: 只要可能就用 const
- Item 4: 确保 objects（对象）在使用前被初始化
- Item 5: 了解 C++ 为你偷偷地加上和调用了什么函数
- Item 6: 如果你不想使用 compiler-generated functions（编译器生成函数），就明确拒绝
- Item 7: 在 polymorphic base classes（多态基类）中将 destructors（析构函数）声明为 virtual（虚拟）
- Item 8: 防止因为 exceptions（异常）而离开 destructors（析构函数）
- Item 9: 绝不要在 construction（构造）或 destruction（析构）期间调用 virtual functions（虚拟函数）
- Item 10: 让 assignment operators（赋值运算符）返回一个 reference to *this（引向 *this 的引用）
- Item 11: 在 operator= 中处理 assignment to self（自赋值）
- Item 12: 拷贝一个对象的所有组成部分
- Item 13: 使用对象管理资源
- Item 14: 谨慎考虑资源管理类的拷贝行为
- Item 15: 在资源管理类中准备访问裸资源（raw resources）
- Item 16: 使用相同形式的 new 和 delete
- Item 17: 在一个独立的语句中将 new 出来的对象存入智能指针
- Item 18: 使接口易于正确使用，而难以错误使用
- Item 19: 视类设计为类型设计
- Item 20: 用 pass-by-reference-to-const（传引用给 const）取代 pass-by-value（传值）
- Item 21: 当你必须返回一个对象时不要试图返回一个引用
- Item 22: 将数据成员声明为 private
- Item 23: 用非成员非友元函数取代成员函数
- Item 24: 当类型转换应该用于所有参数时，声明为非成员函数
- Item 25: 考虑支持不抛异常的 swap
- Item 26: 只要有可能就推迟变量定义
- Item 27: 将强制转型减到最少
- Item 28: 避免返回对象内部构件的“句柄”
- Item 29: 争取异常安全（exception-safe）的代码
- Item 30: 理解 inline 化的介入和排除
- Item 31: 最小化文件之间的编译依赖
- Item 32: 确保 public inheritance 模拟 "is-a"
- Item 33: 避免覆盖（hiding）“通过继承得到的名字”
- Item 34: 区分 inheritance of interface（接口继承）和 inheritance of implementation（实现继承）
- Item 35: 考虑可选的 virtual functions（虚拟函数）的替代方法
- Item 36: 绝不要重定义一个 inherited non-virtual function（通过继承得到的非虚拟函数）
- Item 37: 绝不要重定义一个函数的 inherited default parameter value（通过继承得到的缺省参数值）
- Item 38: 通过 composition（复合）模拟 "has-a"（有一个）或 "is-implemented-in-terms-of"（是根据……实现的）
- Item 39: 谨慎使用 private inheritance（私有继承）
- Item 40: 谨慎使用 multiple inheritance（多继承）
- Item 41: 理解 implicit interfaces（隐式接口）和 compile-time polymorphism（编译期多态）
- Item 42: 理解 typename 的两个含义
- Item 43: 了解如何访问 templatized base classes（模板化基类）中的名字
- Item 44: 从 templates（模板）中分离出 parameter-independent（参数无关）的代码
- Item 45: 用 member function templates（成员函数模板） 接受 "all compatible types"（“所有兼容类型”）
- Item 46: 需要 type conversions（类型转换）时在 templates（模板）内定义 non-member functions（非成员函数）
- Item 47: 为类型信息使用 traits classes（特征类）
- Item 48: 感受 template metaprogramming（模板元编程）
- Item 49: 了解 new-handler 的行为
- Item 50: 领会何时替换 new 和 delete 才有意义
- Item 51: 编写 new 和 delete 时要遵守惯例
- Item 52: 如果编写了 placement new，就要编写 placement delete
- 附录 A. 超越 Effective C++
- 附录 B. 第二和第三版之间的 Item 映射