【读书笔记】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，可被用来自动解除互斥锁等等。