条款15：在资源管理类张提供对原始资源的访问

请牢记：

一、APIs每每要求访问原始资源，因此每个RAII class应该提供一个“取得其所管理之资源”的办法。

二、对原始资源的访问可能经由显式转换或隐式转换。通常而言显式转换比较安全，但隐式转换对客户比较方便。

 

前面条款13的例子中使用了智能指针如auto_ptr或tr1::shared_ptr保存createInvestment的调用结果：

std::tr1::shared_ptr<Investment> pInv(createInvestment());　

假如某个API但愿以某个函数处理Investment对象，返回投资天数，以下：

int dayHeld（const Investment* pi);　　//返回投资天数

调用时：

int days = dayHeld（pInv）;　　//error!

由于dayHeld须要的是Investment*指针，而非std::shared_ptr<Investment>的对象！！

这时就须要一个函数可将RAII类对象转换为所含原始资源（本例为Investment*），有两个方法：显示转换和隐式转换。

显示转换：

tr1::shared_ptr和auto_ptr都提供get成员函数，用来执行显示转换，返回智能指针内部的原始指针。

int days = dayHeld（pInv.get());   //将pInv的原始指针传递给dayHeld

隐式转换：

tr1::shared_ptr和auto_ptr也重载了指针取值操做符（operator->和operator*），容许隐式转换至底部原始指针。

class Investment{   　　　　　　　　　　　　　　　　　　　　　　　　//investment继承体系的根类
public:
    bool isTaxFree() const;
    ...
};
Investment* createInvestment();  　　　　　　　　　　　　　　　　//factory函数
std::tr1::shared_ptr<Investment> pi1(createInvestment());　　//令tr1::shared_ptr管理一笔资源
bool taxable1 = !(pi1->isTaxFree()); 　　　　　　　　　　　　　　//经由operator->访问资源
...
std::auto_ptr<Investment> pi2(createInvestment());　　　　　　//令auto_ptr管理一笔资源
bool taxable2 = !((*pi2).isTaxFree()); 　　　　　　　　　　　　//经由operator*访问资源
...

因为有时候仍是必须取得RAII对象内的原始资源，作法是提供一个隐式转换函数，考虑下面的用于字体的RAII类（对CAPI而言字体是一种原生数据结构）：

FontHandle getFont(); 　　//这是一个C API

　　

void releaseFont(FontHandle fh);　　 //一样是C API

　　

class Font
{
public:
	explicit Font(FontHandle fh)　　//得到资源。 explicit只对构造函数起做用,用来抑制隐式转换。
		:f(fh)	　　　　　　　　//采用值传递 
	{
	}
	~Font()
	{
		releaseFont(f);  //释放资源
        } 
private:
	FontHandle f;
};

若是有大量的FontHandles 那么将Font转换成FontHandle比较频繁。Font 类可为此提供一个显示转换函数：

class Font{
public:
    ...
    FontHandle get() const {return f;} //显示转换函数
    ...
};

不幸的是客户每次使用API都必须调用get：

void changeFontSize(FontHandle f,int newSize); //C API
Font f(getFont());
int newFontSize;
...
changeFontSize(f.get(),newFontSize);　　//明白地将Font转换为FontHandle

另外一个方法是提供隐式转换函数：

class Font{
public:
    ...
    operator FontHandle() const //隐式转换函数  //转换操做符 定义成 operator T()
    {return f;}
    ...
}；

调用：

Font f(getFont());
int newFontSize;
...
changeFontSize(f,newFontSize); 　　//将Font隐式转换为FontHandle

可是这个隐式转换会增长错误发生机会。例如客户可能会在须要Font时意外建立一个FontHandle：

Font f1(getFont());
...
FontHandle f2 = f1; 　　//原意是想copy一个Font对象，结果确将f1隐式转换为FontHandle而后copy它。

使用显式仍是隐式，取决于具体的使用状况。通常而言显式转换比较安全，但隐式转换对客户比较方便。