1
0
forked from boostorg/bind

Added documentation for unwrap_ref.

[SVN r47689]
This commit is contained in:
Ronald Garcia
2008-07-22 14:55:05 +00:00
parent 203ca82ef2
commit 0dd5dae4e8

View File

@@ -59,10 +59,13 @@
references to function templates (algorithms) that would usually references to function templates (algorithms) that would usually
take copies of their arguments. It defines the class template take copies of their arguments. It defines the class template
<code><classname>boost::reference_wrapper&lt;T&gt;</classname></code>, <code><classname>boost::reference_wrapper&lt;T&gt;</classname></code>,
the two functions two functions
<code><functionname>boost::ref</functionname></code> and <code><functionname>boost::ref</functionname></code> and
<code><functionname>boost::cref</functionname></code> that return <code><functionname>boost::cref</functionname></code> that return
instances of <code>boost::reference_wrapper&lt;T&gt;</code>, and the instances of <code>boost::reference_wrapper&lt;T&gt;</code>,
a function <code><functionname>boost::unwrap_ref</functionname></code>
that unwraps a <code>boost::reference_wrapper&lt;T&gt;</code> or
returns a reference to any other type of object, and the
two traits classes two traits classes
<code><classname>boost::is_reference_wrapper&lt;T&gt;</classname></code> <code><classname>boost::is_reference_wrapper&lt;T&gt;</classname></code>
and and
@@ -90,6 +93,11 @@
<code>boost::cref(x)</code> returns a <code>boost::cref(x)</code> returns a
<code>boost::reference_wrapper&lt;X const&gt;(x)</code>.</para> <code>boost::reference_wrapper&lt;X const&gt;(x)</code>.</para>
<para>The expression <code>boost::unwrap_ref(x)</code>
returns a
<code>boost::unwrap_reference&lt;X&gt;::type&amp;</code> where X
is the type of x.</para>
<para>The expression <para>The expression
<code>boost::is_reference_wrapper&lt;T&gt;::value</code> <code>boost::is_reference_wrapper&lt;T&gt;::value</code>
is true if T is a <code>reference_wrapper</code>, and is true if T is a <code>reference_wrapper</code>, and
@@ -180,6 +188,19 @@
<throws><simpara>Does not throw.</simpara></throws> <throws><simpara>Does not throw.</simpara></throws>
</function> </function>
</free-function-group> </free-function-group>
<free-function-group name="access">
<function name="unwrap_ref">
<type>unwrap_reference&lt;T&gt;::type&amp;</type>
<parameter name="t">
<paramtype>T&amp;</paramtype>
</parameter>
<returns><simpara><computeroutput><classname>unwrap_reference</classname>&lt;T&gt;::type&amp;(t)</computeroutput></simpara></returns>
<throws><simpara>Does not throw.</simpara></throws>
</function>
</free-function-group>
</class> </class>
<class name="is_reference_wrapper"> <class name="is_reference_wrapper">
@@ -234,7 +255,8 @@
Peter Dimov because they are generally useful. Douglas Gregor and Peter Dimov because they are generally useful. Douglas Gregor and
Dave Abrahams contributed Dave Abrahams contributed
<classname>is_reference_wrapper</classname> and <classname>is_reference_wrapper</classname> and
<classname>unwrap_reference</classname>.</para> <classname>unwrap_reference</classname>. Frank Mori Hess and Ronald
Garcia contributed <functionname>boost::unwrap_ref</functionname></para>
</section> </section>
</library> </library>