<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.15"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>libstdc++: std::auto_ptr< _Tp > Class Template Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
$(document).ready(initResizable);
/* @license-end */</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">libstdc++
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.15 -->
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
$(document).ready(function(){initNavTree('a08452.html','');});
/* @license-end */
</script>
<div id="doc-content">
<div class="header">
<div class="summary">
<a href="#pub-types">Public Types</a> |
<a href="#pub-methods">Public Member Functions</a> |
<a href="a08449.html">List of all members</a> </div>
<div class="headertitle">
<div class="title">std::auto_ptr< _Tp > Class Template Reference</div> </div>
</div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-types"></a>
Public Types</h2></td></tr>
<tr class="memitem:a7c925143715c359436b453e524dd9fc1"><td class="memItemLeft" align="right" valign="top">typedef _Tp </td><td class="memItemRight" valign="bottom"><a class="el" href="a08452.html#a7c925143715c359436b453e524dd9fc1">element_type</a></td></tr>
<tr class="separator:a7c925143715c359436b453e524dd9fc1"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr class="memitem:a4029546a38036de379586d8514a02ebb"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a08452.html#a4029546a38036de379586d8514a02ebb">auto_ptr</a> (<a class="el" href="a08452.html#a7c925143715c359436b453e524dd9fc1">element_type</a> *__p=0) throw ()</td></tr>
<tr class="separator:a4029546a38036de379586d8514a02ebb"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aa88c998565d04c8e882a3b579e46c055"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a08452.html#aa88c998565d04c8e882a3b579e46c055">auto_ptr</a> (<a class="el" href="a08452.html">auto_ptr</a> &__a) throw ()</td></tr>
<tr class="separator:aa88c998565d04c8e882a3b579e46c055"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a10d7a4a15c88b4953d090c08dfc87e14"><td class="memTemplParams" colspan="2">template<typename _Tp1 > </td></tr>
<tr class="memitem:a10d7a4a15c88b4953d090c08dfc87e14"><td class="memTemplItemLeft" align="right" valign="top"> </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="a08452.html#a10d7a4a15c88b4953d090c08dfc87e14">auto_ptr</a> (<a class="el" href="a08452.html">auto_ptr</a>< _Tp1 > &__a) throw ()</td></tr>
<tr class="separator:a10d7a4a15c88b4953d090c08dfc87e14"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a829d06b1a12a622608a3cce322238fc6"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a08452.html#a829d06b1a12a622608a3cce322238fc6">auto_ptr</a> (<a class="el" href="a08448.html">auto_ptr_ref</a>< <a class="el" href="a08452.html#a7c925143715c359436b453e524dd9fc1">element_type</a> > __ref) throw ()</td></tr>
<tr class="separator:a829d06b1a12a622608a3cce322238fc6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a7306f9cb13ae8e32b4a4bc9d8bee2fd1"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="a08452.html#a7306f9cb13ae8e32b4a4bc9d8bee2fd1">~auto_ptr</a> ()</td></tr>
<tr class="separator:a7306f9cb13ae8e32b4a4bc9d8bee2fd1"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a84b05c8cd5548725ab4e0180aa3b2352"><td class="memItemLeft" align="right" valign="top"><a class="el" href="a08452.html#a7c925143715c359436b453e524dd9fc1">element_type</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="a08452.html#a84b05c8cd5548725ab4e0180aa3b2352">get</a> () const throw ()</td></tr>
<tr class="separator:a84b05c8cd5548725ab4e0180aa3b2352"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a3da3775aba2d35047d59630d882fa9a6"><td class="memTemplParams" colspan="2"><a id="a3da3775aba2d35047d59630d882fa9a6"></a>
template<typename _Tp1 > </td></tr>
<tr class="memitem:a3da3775aba2d35047d59630d882fa9a6"><td class="memTemplItemLeft" align="right" valign="top"> </td><td class="memTemplItemRight" valign="bottom"><b>operator auto_ptr< _Tp1 ></b> () throw ()</td></tr>
<tr class="separator:a3da3775aba2d35047d59630d882fa9a6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ae349cab64637962e883d25e098991a3e"><td class="memTemplParams" colspan="2"><a id="ae349cab64637962e883d25e098991a3e"></a>
template<typename _Tp1 > </td></tr>
<tr class="memitem:ae349cab64637962e883d25e098991a3e"><td class="memTemplItemLeft" align="right" valign="top"> </td><td class="memTemplItemRight" valign="bottom"><b>operator auto_ptr_ref< _Tp1 ></b> () throw ()</td></tr>
<tr class="separator:ae349cab64637962e883d25e098991a3e"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a2e044fd0c71fba38157d3aa588be4518"><td class="memItemLeft" align="right" valign="top"><a class="el" href="a08452.html#a7c925143715c359436b453e524dd9fc1">element_type</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="a08452.html#a2e044fd0c71fba38157d3aa588be4518">operator*</a> () const throw ()</td></tr>
<tr class="separator:a2e044fd0c71fba38157d3aa588be4518"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a26129c2150ef03c1d8d33a3bbe65ef23"><td class="memItemLeft" align="right" valign="top"><a class="el" href="a08452.html#a7c925143715c359436b453e524dd9fc1">element_type</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="a08452.html#a26129c2150ef03c1d8d33a3bbe65ef23">operator-></a> () const throw ()</td></tr>
<tr class="separator:a26129c2150ef03c1d8d33a3bbe65ef23"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:af798a3136d8030f2158837fde7373f5b"><td class="memItemLeft" align="right" valign="top"><a class="el" href="a08452.html">auto_ptr</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="a08452.html#af798a3136d8030f2158837fde7373f5b">operator=</a> (<a class="el" href="a08452.html">auto_ptr</a> &__a) throw ()</td></tr>
<tr class="separator:af798a3136d8030f2158837fde7373f5b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:adf78f102f371538dbe78a57976053736"><td class="memTemplParams" colspan="2">template<typename _Tp1 > </td></tr>
<tr class="memitem:adf78f102f371538dbe78a57976053736"><td class="memTemplItemLeft" align="right" valign="top"><a class="el" href="a08452.html">auto_ptr</a> & </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="a08452.html#adf78f102f371538dbe78a57976053736">operator=</a> (<a class="el" href="a08452.html">auto_ptr</a>< _Tp1 > &__a) throw ()</td></tr>
<tr class="separator:adf78f102f371538dbe78a57976053736"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a66db670614e0593af6a9b36018796f45"><td class="memItemLeft" align="right" valign="top"><a id="a66db670614e0593af6a9b36018796f45"></a>
<a class="el" href="a08452.html">auto_ptr</a> & </td><td class="memItemRight" valign="bottom"><b>operator=</b> (<a class="el" href="a08448.html">auto_ptr_ref</a>< <a class="el" href="a08452.html#a7c925143715c359436b453e524dd9fc1">element_type</a> > __ref) throw ()</td></tr>
<tr class="separator:a66db670614e0593af6a9b36018796f45"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a3cdeabd85acfcac56136924e939c29ef"><td class="memItemLeft" align="right" valign="top"><a class="el" href="a08452.html#a7c925143715c359436b453e524dd9fc1">element_type</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="a08452.html#a3cdeabd85acfcac56136924e939c29ef">release</a> () throw ()</td></tr>
<tr class="separator:a3cdeabd85acfcac56136924e939c29ef"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a7d9519c9b72d8add8292661b822ab7fe"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="a08452.html#a7d9519c9b72d8add8292661b822ab7fe">reset</a> (<a class="el" href="a08452.html#a7c925143715c359436b453e524dd9fc1">element_type</a> *__p=0) throw ()</td></tr>
<tr class="separator:a7d9519c9b72d8add8292661b822ab7fe"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><h3>template<typename _Tp><br />
class std::auto_ptr< _Tp ></h3>
<p>A simple smart pointer providing strict ownership semantics. </p>
<p>The Standard says: </p><pre>
An <code>auto_ptr</code> owns the object it holds a pointer to. Copying
an <code>auto_ptr</code> copies the pointer and transfers ownership to the
destination. If more than one <code>auto_ptr</code> owns the same object
at the same time the behavior of the program is undefined.</pre><pre>The uses of <code>auto_ptr</code> include providing temporary
exception-safety for dynamically allocated memory, passing
ownership of dynamically allocated memory to a function, and
returning dynamically allocated memory from a function. <code>auto_ptr</code> does not meet the CopyConstructible and Assignable
requirements for Standard Library <a href="tables.html#65">container</a> elements and thus
instantiating a Standard Library container with an <code>auto_ptr</code> results in undefined behavior.
</pre><p> Quoted from [20.4.5]/3.</p>
<p>Good examples of what can and cannot be done with auto_ptr can be found in the libstdc++ testsuite.</p>
<p>_GLIBCXX_RESOLVE_LIB_DEFECTS 127. auto_ptr<> conversion issues These resolutions have all been incorporated. </p>
<p class="definition">Definition at line <a class="el" href="a00719_source.html#l00089">89</a> of file <a class="el" href="a00719_source.html">auto_ptr.h</a>.</p>
</div><h2 class="groupheader">Member Typedef Documentation</h2>
<a id="a7c925143715c359436b453e524dd9fc1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a7c925143715c359436b453e524dd9fc1">◆ </a></span>element_type</h2>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename _Tp> </div>
<table class="memname">
<tr>
<td class="memname">typedef _Tp <a class="el" href="a08452.html">std::auto_ptr</a>< _Tp >::<a class="el" href="a08452.html#a7c925143715c359436b453e524dd9fc1">element_type</a></td>
</tr>
</table>
</div><div class="memdoc">
<p>The pointed-to type. </p>
<p class="definition">Definition at line <a class="el" href="a00719_source.html#l00096">96</a> of file <a class="el" href="a00719_source.html">auto_ptr.h</a>.</p>
</div>
</div>
<h2 class="groupheader">Constructor & Destructor Documentation</h2>
<a id="a4029546a38036de379586d8514a02ebb"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a4029546a38036de379586d8514a02ebb">◆ </a></span>auto_ptr() <span class="overload">[1/4]</span></h2>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename _Tp> </div>
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="a08452.html">std::auto_ptr</a>< _Tp >::<a class="el" href="a08452.html">auto_ptr</a> </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a08452.html#a7c925143715c359436b453e524dd9fc1">element_type</a> * </td>
<td class="paramname"><em>__p</em> = <code>0</code></td><td>)</td>
<td></td>
</tr>
<tr>
<td align="right">throw </td><td>(</td><td colspan="2"></td>
</tr>
<tr>
<td align="right"></td><td>)</td><td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">explicit</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>An auto_ptr is usually constructed from a raw pointer. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">__p</td><td>A pointer (defaults to NULL).</td></tr>
</table>
</dd>
</dl>
<p>This object now <em>owns</em> the object pointed to by <em>__p</em>. </p>
<p class="definition">Definition at line <a class="el" href="a00719_source.html#l00105">105</a> of file <a class="el" href="a00719_source.html">auto_ptr.h</a>.</p>
</div>
</div>
<a id="aa88c998565d04c8e882a3b579e46c055"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aa88c998565d04c8e882a3b579e46c055">◆ </a></span>auto_ptr() <span class="overload">[2/4]</span></h2>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename _Tp> </div>
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="a08452.html">std::auto_ptr</a>< _Tp >::<a class="el" href="a08452.html">auto_ptr</a> </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a08452.html">auto_ptr</a>< _Tp > & </td>
<td class="paramname"><em>__a</em></td><td>)</td>
<td></td>
</tr>
<tr>
<td align="right">throw </td><td>(</td><td colspan="2"></td>
</tr>
<tr>
<td align="right"></td><td>)</td><td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>An auto_ptr can be constructed from another auto_ptr. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">__a</td><td>Another auto_ptr of the same type.</td></tr>
</table>
</dd>
</dl>
<p>This object now <em>owns</em> the object previously owned by <em>__a</em>, which has given up ownership. </p>
<p class="definition">Definition at line <a class="el" href="a00719_source.html#l00114">114</a> of file <a class="el" href="a00719_source.html">auto_ptr.h</a>.</p>
</div>
</div>
<a id="a10d7a4a15c88b4953d090c08dfc87e14"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a10d7a4a15c88b4953d090c08dfc87e14">◆ </a></span>auto_ptr() <span class="overload">[3/4]</span></h2>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename _Tp> </div>
<div class="memtemplate">
template<typename _Tp1 > </div>
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="a08452.html">std::auto_ptr</a>< _Tp >::<a class="el" href="a08452.html">auto_ptr</a> </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a08452.html">auto_ptr</a>< _Tp1 > & </td>
<td class="paramname"><em>__a</em></td><td>)</td>
<td></td>
</tr>
<tr>
<td align="right">throw </td><td>(</td><td colspan="2"></td>
</tr>
<tr>
<td align="right"></td><td>)</td><td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>An auto_ptr can be constructed from another auto_ptr. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">__a</td><td>Another auto_ptr of a different but related type.</td></tr>
</table>
</dd>
</dl>
<p>A pointer-to-Tp1 must be convertible to a pointer-to-Tp/element_type.</p>
<p>This object now <em>owns</em> the object previously owned by <em>__a</em>, which has given up ownership. </p>
<p class="definition">Definition at line <a class="el" href="a00719_source.html#l00127">127</a> of file <a class="el" href="a00719_source.html">auto_ptr.h</a>.</p>
</div>
</div>
<a id="a7306f9cb13ae8e32b4a4bc9d8bee2fd1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a7306f9cb13ae8e32b4a4bc9d8bee2fd1">◆ </a></span>~auto_ptr()</h2>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename _Tp> </div>
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="a08452.html">std::auto_ptr</a>< _Tp >::~<a class="el" href="a08452.html">auto_ptr</a> </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>When the auto_ptr goes out of scope, the object it owns is deleted. If it no longer owns anything (i.e., <code>get()</code> is <code>NULL</code>), then this has no effect.</p>
<p>The C++ standard says there is supposed to be an empty throw specification here, but omitting it is standard conforming. Its presence can be detected only if _Tp::~_Tp() throws, but this is prohibited. [17.4.3.6]/2 </p>
<p class="definition">Definition at line <a class="el" href="a00719_source.html#l00172">172</a> of file <a class="el" href="a00719_source.html">auto_ptr.h</a>.</p>
</div>
</div>
<a id="a829d06b1a12a622608a3cce322238fc6"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a829d06b1a12a622608a3cce322238fc6">◆ </a></span>auto_ptr() <span class="overload">[4/4]</span></h2>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename _Tp> </div>
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="a08452.html">std::auto_ptr</a>< _Tp >::<a class="el" href="a08452.html">auto_ptr</a> </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a08448.html">auto_ptr_ref</a>< <a class="el" href="a08452.html#a7c925143715c359436b453e524dd9fc1">element_type</a> > </td>
<td class="paramname"><em>__ref</em></td><td>)</td>
<td></td>
</tr>
<tr>
<td align="right">throw </td><td>(</td><td colspan="2"></td>
</tr>
<tr>
<td align="right"></td><td>)</td><td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Automatic conversions. </p>
<p>These operations are supposed to convert an auto_ptr into and from an auto_ptr_ref automatically as needed. This would allow constructs such as </p><div class="fragment"><div class="line">auto_ptr<Derived> func_returning_auto_ptr(.....);</div><div class="line">...</div><div class="line">auto_ptr<Base> ptr = func_returning_auto_ptr(.....);</div></div><!-- fragment --><p>But it doesn't work, and won't be fixed. For further details see <a href="http://cplusplus.github.io/LWG/lwg-closed.html#463">http://cplusplus.github.io/LWG/lwg-closed.html#463</a> </p>
<p class="definition">Definition at line <a class="el" href="a00719_source.html#l00266">266</a> of file <a class="el" href="a00719_source.html">auto_ptr.h</a>.</p>
</div>
</div>
<h2 class="groupheader">Member Function Documentation</h2>
<a id="a84b05c8cd5548725ab4e0180aa3b2352"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a84b05c8cd5548725ab4e0180aa3b2352">◆ </a></span>get()</h2>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename _Tp> </div>
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="a08452.html#a7c925143715c359436b453e524dd9fc1">element_type</a>* <a class="el" href="a08452.html">std::auto_ptr</a>< _Tp >::get </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
<tr>
<td align="right">throw </td><td>(</td><td colspan="2"></td>
</tr>
<tr>
<td align="right"></td><td>)</td><td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Bypassing the smart pointer. </p>
<dl class="section return"><dt>Returns</dt><dd>The raw pointer being managed.</dd></dl>
<p>You can get a copy of the pointer that this object owns, for situations such as passing to a function which only accepts a raw pointer.</p>
<dl class="section note"><dt>Note</dt><dd>This auto_ptr still owns the memory. </dd></dl>
<p class="definition">Definition at line <a class="el" href="a00719_source.html#l00213">213</a> of file <a class="el" href="a00719_source.html">auto_ptr.h</a>.</p>
</div>
</div>
<a id="a2e044fd0c71fba38157d3aa588be4518"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a2e044fd0c71fba38157d3aa588be4518">◆ </a></span>operator*()</h2>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename _Tp> </div>
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="a08452.html#a7c925143715c359436b453e524dd9fc1">element_type</a>& <a class="el" href="a08452.html">std::auto_ptr</a>< _Tp >::operator* </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
<tr>
<td align="right">throw </td><td>(</td><td colspan="2"></td>
</tr>
<tr>
<td align="right"></td><td>)</td><td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Smart pointer dereferencing. </p>
<p>If this auto_ptr no longer owns anything, then this operation will crash. (For a smart pointer, <em>no longer owns anything</em> is the same as being a null pointer, and you know what happens when you dereference one of those...) </p>
<p class="definition">Definition at line <a class="el" href="a00719_source.html#l00183">183</a> of file <a class="el" href="a00719_source.html">auto_ptr.h</a>.</p>
</div>
</div>
<a id="a26129c2150ef03c1d8d33a3bbe65ef23"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a26129c2150ef03c1d8d33a3bbe65ef23">◆ </a></span>operator->()</h2>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename _Tp> </div>
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="a08452.html#a7c925143715c359436b453e524dd9fc1">element_type</a>* <a class="el" href="a08452.html">std::auto_ptr</a>< _Tp >::operator-> </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
<tr>
<td align="right">throw </td><td>(</td><td colspan="2"></td>
</tr>
<tr>
<td align="right"></td><td>)</td><td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Smart pointer dereferencing. </p>
<p>This returns the pointer itself, which the language then will automatically cause to be dereferenced. </p>
<p class="definition">Definition at line <a class="el" href="a00719_source.html#l00196">196</a> of file <a class="el" href="a00719_source.html">auto_ptr.h</a>.</p>
</div>
</div>
<a id="af798a3136d8030f2158837fde7373f5b"></a>
<h2 class="memtitle"><span class="permalink"><a href="#af798a3136d8030f2158837fde7373f5b">◆ </a></span>operator=() <span class="overload">[1/2]</span></h2>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename _Tp> </div>
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="a08452.html">auto_ptr</a>& <a class="el" href="a08452.html">std::auto_ptr</a>< _Tp >::operator= </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a08452.html">auto_ptr</a>< _Tp > & </td>
<td class="paramname"><em>__a</em></td><td>)</td>
<td></td>
</tr>
<tr>
<td align="right">throw </td><td>(</td><td colspan="2"></td>
</tr>
<tr>
<td align="right"></td><td>)</td><td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>auto_ptr assignment operator. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">__a</td><td>Another auto_ptr of the same type.</td></tr>
</table>
</dd>
</dl>
<p>This object now <em>owns</em> the object previously owned by <em>__a</em>, which has given up ownership. The object that this one <em>used</em> to own and track has been deleted. </p>
<p class="definition">Definition at line <a class="el" href="a00719_source.html#l00138">138</a> of file <a class="el" href="a00719_source.html">auto_ptr.h</a>.</p>
<p class="reference">References <a class="el" href="a00719_source.html#l00242">std::auto_ptr< _Tp >::reset()</a>.</p>
</div>
</div>
<a id="adf78f102f371538dbe78a57976053736"></a>
<h2 class="memtitle"><span class="permalink"><a href="#adf78f102f371538dbe78a57976053736">◆ </a></span>operator=() <span class="overload">[2/2]</span></h2>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename _Tp> </div>
<div class="memtemplate">
template<typename _Tp1 > </div>
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="a08452.html">auto_ptr</a>& <a class="el" href="a08452.html">std::auto_ptr</a>< _Tp >::operator= </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a08452.html">auto_ptr</a>< _Tp1 > & </td>
<td class="paramname"><em>__a</em></td><td>)</td>
<td></td>
</tr>
<tr>
<td align="right">throw </td><td>(</td><td colspan="2"></td>
</tr>
<tr>
<td align="right"></td><td>)</td><td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>auto_ptr assignment operator. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">__a</td><td>Another auto_ptr of a different but related type.</td></tr>
</table>
</dd>
</dl>
<p>A pointer-to-Tp1 must be convertible to a pointer-to-Tp/element_type.</p>
<p>This object now <em>owns</em> the object previously owned by <em>__a</em>, which has given up ownership. The object that this one <em>used</em> to own and track has been deleted. </p>
<p class="definition">Definition at line <a class="el" href="a00719_source.html#l00156">156</a> of file <a class="el" href="a00719_source.html">auto_ptr.h</a>.</p>
<p class="reference">References <a class="el" href="a00719_source.html#l00242">std::auto_ptr< _Tp >::reset()</a>.</p>
</div>
</div>
<a id="a3cdeabd85acfcac56136924e939c29ef"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a3cdeabd85acfcac56136924e939c29ef">◆ </a></span>release()</h2>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename _Tp> </div>
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="a08452.html#a7c925143715c359436b453e524dd9fc1">element_type</a>* <a class="el" href="a08452.html">std::auto_ptr</a>< _Tp >::release </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
<tr>
<td align="right">throw </td><td>(</td><td colspan="2"></td>
</tr>
<tr>
<td align="right"></td><td>)</td><td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Bypassing the smart pointer. </p>
<dl class="section return"><dt>Returns</dt><dd>The raw pointer being managed.</dd></dl>
<p>You can get a copy of the pointer that this object owns, for situations such as passing to a function which only accepts a raw pointer.</p>
<dl class="section note"><dt>Note</dt><dd>This auto_ptr no longer owns the memory. When this object goes out of scope, nothing will happen. </dd></dl>
<p class="definition">Definition at line <a class="el" href="a00719_source.html#l00227">227</a> of file <a class="el" href="a00719_source.html">auto_ptr.h</a>.</p>
</div>
</div>
<a id="a7d9519c9b72d8add8292661b822ab7fe"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a7d9519c9b72d8add8292661b822ab7fe">◆ </a></span>reset()</h2>
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template<typename _Tp> </div>
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">void <a class="el" href="a08452.html">std::auto_ptr</a>< _Tp >::reset </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a08452.html#a7c925143715c359436b453e524dd9fc1">element_type</a> * </td>
<td class="paramname"><em>__p</em> = <code>0</code></td><td>)</td>
<td></td>
</tr>
<tr>
<td align="right">throw </td><td>(</td><td colspan="2"></td>
</tr>
<tr>
<td align="right"></td><td>)</td><td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Forcibly deletes the managed object. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">__p</td><td>A pointer (defaults to NULL).</td></tr>
</table>
</dd>
</dl>
<p>This object now <em>owns</em> the object pointed to by <em>__p</em>. The previous object has been deleted. </p>
<p class="definition">Definition at line <a class="el" href="a00719_source.html#l00242">242</a> of file <a class="el" href="a00719_source.html">auto_ptr.h</a>.</p>
<p class="reference">Referenced by <a class="el" href="a00719_source.html#l00138">std::auto_ptr< _Tp >::operator=()</a>.</p>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="a00719_source.html">auto_ptr.h</a></li>
</ul>
</div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="navelem"><a class="el" href="a01538.html">std</a></li><li class="navelem"><a class="el" href="a08452.html">auto_ptr</a></li>
<li class="footer">Generated by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.15 </li>
</ul>
</div>
</body>
</html>
distrib
>
Mageia
>
7
>
armv7hl
>
media
>
core-updates
>
by-pkgid
>
0448c66ab6afa2f787658c5e6488e2d9
>
files
>
4084
