ref_reference.xml 5.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. <?xml version="1.0" standalone="yes"?>
  2. <library-reference><header name="boost/core/ref.hpp">
  3. <namespace name="boost">
  4. <struct name="is_reference_wrapper"><template>
  5. <template-type-parameter name="T"/>
  6. </template><purpose>Determine if a type <computeroutput>T</computeroutput> is an instantiation of <computeroutput><classname alt="boost::reference_wrapper">reference_wrapper</classname></computeroutput>. </purpose><description><para>The value static constant will be true if the type <computeroutput>T</computeroutput> is a specialization of <computeroutput><classname alt="boost::reference_wrapper">reference_wrapper</classname></computeroutput>. </para></description><method-group name="public member functions">
  7. <method name="BOOST_STATIC_CONSTANT"><type/><parameter name=""><paramtype>bool</paramtype></parameter><parameter name=""><paramtype>value</paramtype><default>false</default></parameter></method>
  8. </method-group>
  9. </struct><class name="reference_wrapper"><template>
  10. <template-type-parameter name="T"/>
  11. </template><purpose>Contains a reference to an object of type <computeroutput>T</computeroutput>. </purpose><description><para><computeroutput><classname alt="boost::reference_wrapper">reference_wrapper</classname></computeroutput> is primarily used to "feed" references to function templates (algorithms) that take their parameter by value. It provides an implicit conversion to <computeroutput>T&amp;</computeroutput>, which usually allows the function templates to work on references unmodified. </para></description><typedef name="type"><description><para>Type <computeroutput>T</computeroutput>. </para></description><type>T</type></typedef>
  12. <method-group name="public member functions">
  13. <method name="conversion-operator" cv="const"><type>T &amp;</type><description><para>
  14. <para>Does not throw. </para>
  15. </para></description><returns><para>The stored reference. </para>
  16. </returns></method>
  17. <method name="get" cv="const"><type>T &amp;</type><description><para>
  18. <para>Does not throw. </para>
  19. </para></description><returns><para>The stored reference. </para>
  20. </returns></method>
  21. <method name="get_pointer" cv="const"><type>T *</type><description><para>
  22. <para>Does not throw. </para>
  23. </para></description><returns><para>A pointer to the object referenced by the stored reference. </para>
  24. </returns></method>
  25. </method-group>
  26. <constructor specifiers="explicit"><parameter name="t"><paramtype>T &amp;</paramtype></parameter><description><para>Constructs a <computeroutput><classname alt="boost::reference_wrapper">reference_wrapper</classname></computeroutput> object that stores a reference to <computeroutput>t</computeroutput>.</para><para><para>Does not throw. </para>
  27. </para></description></constructor>
  28. <constructor cv="= delete"><parameter name="t"><paramtype>T &amp;&amp;</paramtype></parameter><description><para><para>Construction from a temporary object is disabled. </para>
  29. </para></description></constructor>
  30. </class><struct name="unwrap_reference"><template>
  31. <template-type-parameter name="T"/>
  32. </template><purpose>Find the type in a <computeroutput><classname alt="boost::reference_wrapper">reference_wrapper</classname></computeroutput>. </purpose><description><para>The <computeroutput>typedef</computeroutput> type is <computeroutput>T::type</computeroutput> if <computeroutput>T</computeroutput> is a <computeroutput><classname alt="boost::reference_wrapper">reference_wrapper</classname></computeroutput>, <computeroutput>T</computeroutput> otherwise. </para></description><typedef name="type"><type>T</type></typedef>
  33. </struct><function name="ref"><type><classname>reference_wrapper</classname>&lt; T &gt; const</type><template>
  34. <template-type-parameter name="T"/>
  35. </template><parameter name="t"><paramtype>T &amp;</paramtype></parameter><description><para>
  36. <para>Does not throw. </para>
  37. </para></description><returns><para><computeroutput><classname alt="boost::reference_wrapper">reference_wrapper</classname>&lt;T&gt;(t)</computeroutput> </para>
  38. </returns></function>
  39. <function name="cref"><type><classname>reference_wrapper</classname>&lt; T const &gt; const</type><template>
  40. <template-type-parameter name="T"/>
  41. </template><parameter name="t"><paramtype>T const &amp;</paramtype></parameter><description><para>
  42. <para>Does not throw. </para>
  43. </para></description><returns><para><computeroutput><classname alt="boost::reference_wrapper">reference_wrapper</classname>&lt;T const&gt;(t)</computeroutput> </para>
  44. </returns></function>
  45. <function name="ref"><type>void</type><template>
  46. <template-type-parameter name="T"/>
  47. </template><parameter name=""><paramtype>T const &amp;&amp;</paramtype></parameter><description><para><para>Construction from a temporary object is disabled. </para>
  48. </para></description></function>
  49. <function name="cref"><type>void</type><template>
  50. <template-type-parameter name="T"/>
  51. </template><parameter name=""><paramtype>T const &amp;&amp;</paramtype></parameter><description><para><para>Construction from a temporary object is disabled. </para>
  52. </para></description></function>
  53. <function name="unwrap_ref"><type><classname>unwrap_reference</classname>&lt; T &gt;::type &amp;</type><template>
  54. <template-type-parameter name="T"/>
  55. </template><parameter name="t"><paramtype>T &amp;</paramtype></parameter><description><para>
  56. <para>Does not throw. </para>
  57. </para></description><returns><para><computeroutput><classname alt="boost::unwrap_reference">unwrap_reference</classname>&lt;T&gt;::type&amp;(t)</computeroutput> </para>
  58. </returns></function>
  59. </namespace>
  60. </header>
  61. </library-reference>