C++ 在资源管理类中提供对原始资源的访问

20180309 C++ 在资源管理类中提供对原始资源的访问

使用智能指针如auto_ptr或tr1::shared_ptr<Investment>pInv(createInvestment());
假设需要以某种函数处理Investment对象，像这样：
int daysHeld(const Investment *pi);//返回投资天数


当想要这么调用它：int days = daysHeld(pInv);//  !!!错误!!!
却通不过编译，因为daysHeld需要的是Investment*指针， 你传给它的却是类型为tr1::shared_ptr<Investment>的对象。
这时候你需要一个函数可将RAII class对象（本例为tr1::shared_ptr）转换成其所内含的原始资源（本例为底部的Investment*），有两种方法可以达到这个目标：
显示转换和隐式转化。
tr1::shared_ptr和auto_ptr都提供一个get成员函数，用来执行显示转换，也就是它会返回智能指针内部的原始指针（的复件）：
int days = dayHeld(pInv.get());//OK，将pInv内的原始指针传给daysHeld


就像（几乎）所有智能指针一样，tr1::shared_ptr和auto_ptr也重载了指针取值（pointer dereferencing）操作符（operator->和operator*），它们允许隐式转换至底部原始指针：
class Investment{             //investment继承体系的根类
public:
  bool isTaxFree() const;
  ...
};


Investment* createInvestment();//factory函数
std::tr1::shared_ptr<Investment>       //令tr1::shared_ptr
           pi1(createInvestment());    //管理一笔资源
bool taxable1 = !(pi1->isTaxFree());  //经由operator->访问资源
...
std::auto_ptr<Investment> pi2(createInvestment());//令auto_ptr
                                                 //管理一笔资源
bool taxable2 = !((*pi2).isTaxFree());  //经由operator* 访问资源
...




有时候必须取得RAII对象内的原始资源，即提供一种隐式转换函数，即下面这个用于字体的RAII class(对C API而言字体是一种原生数据结构)：
FontHandle getFont();//这是个C API，为求简化暂略参数。


void releaseFont(FontHandle fh);//来自同一组C API
class Font{                     //RAII class
public:
  explicit Font(FontHandle fh)  //获得资源；
    :f(fh)                      //采用pass-by-value,
     {}                         //因为C API这样做
  ~Font(){releaseFont(f);}      //释放资源
private:
  FontHandle f;                 //原始（raw）字体资源
};


假设有大量与字体相关的C API ，它们处理的是FontHandle，那么“将Font对象转换成FontHandle”将会是一种频繁的需求。Font class可以为此提供一个隐式转换函数，像get那样：
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


另一种办法是令Font提供隐式转换函数，转型为FontHandle：
class Font{
public:
  ...
  operater FontHandle() const  //隐式转换函数
  {return f;}
  ...
};
这使得客户调用C API时比较轻松和自然:


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


提供显示转换函数（例如get成员函数）或提供隐式转换需遵循：让接口容易被正确使用，不易被误用。通常显示转换函数如get是比较受欢迎的，因为它将“非故意的类型转换”的可能性降到最低，但隐式类型转换的“自然用法”也有一定的用处。


注意：
APIs往往要求访问原始资源（raw resources），所以每一个RAII class应该提供一个“取得其所管理资源”的方法；
对原始资源的访问可能经由显示转换或隐式转换。一般而言显示转换比较安全，但隐式转换对客户比较方便。