【读书笔记】Effective C++—4 设计与声明(之1)

Effective C++读书笔记

--By Nathan.Yu 2007-12-08--

4 设计与声明(之一)

条款18：让接口容易被正确使用，不易被误用（Make
interfaces easy to use correctly and hard to use incorrectly）

理想上，如果客户企图使用某个接口而却没有获得他所预期的行为，这个代码不该通过编译；如果代码通过了编译，它的作为就该是客户所想要的。

欲开发一个“容易被正确使用，不易被误用”的接口，首先必须考虑客户可能做出什么样的错误。
假设你为一个用来表现日期的class设计构造函数：
class Date{
public:

Date(int month, int day, int year);
};

它的客户至少可能犯下两个错误：
1、
以错误的次序传递参数：
Date d(30, 3, 1995); //
应该是Date d(3, 30, 1995);
2、
传递一个无效的参数：
Date d(2, 30, 1995); //
应该是Date d(3, 30, 1995);

预防客户端错误的方法：
1、引入新类型。这里可以引入简单的外覆类型（wrapper
types）来区别天数，月份和年份。如：
struct Day{
explicit Day(int d)
:val(d){}
int val;
};
struct Month{
explicit Month (int m)
:val(m){}
int val;
};
struct Year{
explicit Year (int y)
:val(y){}
int val;
};

class Date{
public:

Date(const Month&, const Day&, const Year&);

……….
};

Date d(30, 3, 1995); //
编译错误, explicit
构造函数，不允许隐式转化
Date d(Day(30), Month(3), Year(1995)); //
编译错误,
类型不正确
Date d(Month(30), Day(3), Year(1995)); //
编译通过，
但Month(30)不是有效的月份

令Day, Month, Year为classes并封装其内数据比简单的structs更好。

为防止无效月份可定义如下类来限定：
class Month{
public:

static Month Jan() { return Month(1); }
static Month Feb() { return Month(2); }
………
static Month Dec() { return Month(12); }

private:

explicit Month(int m);
};
Date d(Month::Mar(), Day(30), Year(1995));

2、
限制类型内什么事可做，什么事不能做。常见的限制是加上const。

一般性准则“让types容易被正确使用，不易被误用”：
“除非有好理由，否则应该尽量令你的types第行为与内置types一致”

任何接口如果要求客户必须记得做某些事情，就是有着“不正确使用”的倾向，因为客户可能会忘记做那件事。

使用智能指针来防止用户忘记delete。

请记住：
1、“促进正确使用”的办法包括接口的一致性，以及与内置类型行为兼容。
2、“阻止误用”的办法包括建立新类型、限制类型上的操作，束缚对象值，以及消除客户端资源管理责任。
3、tr1::shared_ptr支持定制删除器。这可防范cross-DLL
problem，可被用来自动解除互斥锁等等。