C++ 参考手册

std::auto_ptr

定义于头文件 <memory>
template< class T > class auto_ptr;
 (1) (C++11 中弃用)
(C++17 中移除)
template<> class auto_ptr<void>;
 (2) (C++11 中弃用)
(C++17 中移除)

auto_ptr 是通过由 new 表达式获得的对象，并在 auto_ptr 自身被销毁时删除该对象的智能指针。它可用于为动态分配的对象提供异常安全、传递动态分配对象的所有权给函数和从函数返回动态分配的对象。

复制 auto_ptr ，会复制指针并转移所有权给目标： auto_ptr 的复制构造和复制赋值都会修改其右侧参数，而且“副本”不等于原值。因为这些不常见的复制语义，不可将 auto_ptr 置于标准容器中。此用途及其他使用更适合用 std::unique_ptr 。 (C++11 起)

2) 提供对类型 void 的特化，它声明 typedef element_type ，但无成员函数。

文档中到处使用附加的类模板 auto_ptr_ref 。它是保有到 auto_ptr 引用的实现定义类型。允许实现提供拥有不同名称的模板，或以其他方式实现返回它或接受它为参数的函数。

成员类型

 
成员类型 定义
element_type T

成员函数

 创建新的 auto_ptr
(公开成员函数)
销毁 auto_ptr 和被管理对象
(公开成员函数)
从另一 auto_ptr 转移所有权
(公开成员函数)
转换被管理指针到指向另一类型的指针
(公开成员函数)
观察器
返回指向被管理对象的指针
(公开成员函数)
访问被管理对象
(公开成员函数)
修改器
替换被管理对象
(公开成员函数)
释放被管理对象的所有权
(公开成员函数)