EQ2EMu/EQ2/source/depends/boost_1_72_0/libs/dll/doc/autodoc_shared_library_refcountable.xml

<?xml version="1.0" standalone="yes"?>
<library-reference id="shared_library_refcountable_reference"><title>Shared Library Refcountable Reference</title><header name="boost/dll/import.hpp">
<para>Contains all the boost::dll::import* reference counting functions that hold a shared pointer to the instance of boost::dll::shared_library. </para><namespace name="boost">
<namespace name="dll">
<overloaded-function name="import"><signature><type>result_type</type><template>
          <template-type-parameter name="T"/>
        </template><parameter name="lib"><paramtype>const boost::dll::fs::path &amp;</paramtype><description><para>Path to shared library or shared library to load function from. </para></description></parameter><parameter name="name"><paramtype>const char *</paramtype><description><para>Null-terminated C or C++ mangled name of the function to import. Can handle std::string, char*, const char*. </para></description></parameter><parameter name="mode"><paramtype>load_mode::type</paramtype><default>load_mode::default_mode</default><description><para>An mode that will be used on library load.</para></description></parameter></signature><signature><type>result_type</type><template>
          <template-type-parameter name="T"/>
        </template><parameter name="lib"><paramtype>const boost::dll::fs::path &amp;</paramtype></parameter><parameter name="name"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="mode"><paramtype>load_mode::type</paramtype><default>load_mode::default_mode</default></parameter></signature><signature><type>result_type</type><template>
          <template-type-parameter name="T"/>
        </template><parameter name="lib"><paramtype>const shared_library &amp;</paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter></signature><signature><type>result_type</type><template>
          <template-type-parameter name="T"/>
        </template><parameter name="lib"><paramtype>const shared_library &amp;</paramtype></parameter><parameter name="name"><paramtype>const std::string &amp;</paramtype></parameter></signature><signature><type>result_type</type><template>
          <template-type-parameter name="T"/>
        </template><parameter name="lib"><paramtype>shared_library &amp;&amp;</paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter></signature><signature><type>result_type</type><template>
          <template-type-parameter name="T"/>
        </template><parameter name="lib"><paramtype>shared_library &amp;&amp;</paramtype></parameter><parameter name="name"><paramtype>const std::string &amp;</paramtype></parameter></signature><description><para>Returns callable object or boost::shared_ptr&lt;T&gt; that holds the symbol imported from the loaded library. Returned value refcounts usage of the loaded shared library, so that it won't get unload until all copies of return value are not destroyed.</para><para>This call will succeed if call to <link linkend="boost.dll.shared_library">boost::dll::shared_library</link><computeroutput>::has(const char* )</computeroutput> function with the same symbol name returned <computeroutput>true</computeroutput>.</para><para>For importing symbols by <emphasis role="bold">alias</emphasis> names use <link linkend="boost.dll.import_alias">boost::dll::import_alias</link> method.</para><para><emphasis role="bold">Examples:</emphasis> </para><para><programlisting language="c++">boost::function&lt;int(int)&gt; f = import&lt;int(int)&gt;("test_lib.so", "integer_func_name");

auto f_cpp11 = import&lt;int(int)&gt;("test_lib.so", "integer_func_name");
</programlisting></para><para><programlisting language="c++">boost::shared_ptr&lt;int&gt; i = import&lt;int&gt;("test_lib.so", "integer_name");
</programlisting></para><para><emphasis role="bold">Template</emphasis> <emphasis role="bold">parameter</emphasis> <emphasis role="bold">T:</emphasis> Type of the symbol that we are going to import. Must be explicitly specified.</para><para>


</para></description><returns><para>callable object if T is a function type, or boost::shared_ptr&lt;T&gt; if T is an object type.</para>
</returns><throws><simpara><classname/> </simpara></throws></overloaded-function>





<overloaded-function name="import_alias"><signature><type>result_type</type><template>
          <template-type-parameter name="T"/>
        </template><parameter name="lib"><paramtype>const boost::dll::fs::path &amp;</paramtype><description><para>Path to shared library or shared library to load function from. </para></description></parameter><parameter name="name"><paramtype>const char *</paramtype><description><para>Null-terminated C or C++ mangled name of the function or variable to import. Can handle std::string, char*, const char*. </para></description></parameter><parameter name="mode"><paramtype>load_mode::type</paramtype><default>load_mode::default_mode</default><description><para>An mode that will be used on library load.</para></description></parameter></signature><signature><type>result_type</type><template>
          <template-type-parameter name="T"/>
        </template><parameter name="lib"><paramtype>const boost::dll::fs::path &amp;</paramtype></parameter><parameter name="name"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="mode"><paramtype>load_mode::type</paramtype><default>load_mode::default_mode</default></parameter></signature><signature><type>result_type</type><template>
          <template-type-parameter name="T"/>
        </template><parameter name="lib"><paramtype>const shared_library &amp;</paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter></signature><signature><type>result_type</type><template>
          <template-type-parameter name="T"/>
        </template><parameter name="lib"><paramtype>const shared_library &amp;</paramtype></parameter><parameter name="name"><paramtype>const std::string &amp;</paramtype></parameter></signature><signature><type>result_type</type><template>
          <template-type-parameter name="T"/>
        </template><parameter name="lib"><paramtype>shared_library &amp;&amp;</paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter></signature><signature><type>result_type</type><template>
          <template-type-parameter name="T"/>
        </template><parameter name="lib"><paramtype>shared_library &amp;&amp;</paramtype></parameter><parameter name="name"><paramtype>const std::string &amp;</paramtype></parameter></signature><description><para>Returns callable object or boost::shared_ptr&lt;T&gt; that holds the symbol imported from the loaded library. Returned value refcounts usage of the loaded shared library, so that it won't get unload until all copies of return value are not destroyed.</para><para>This call will succeed if call to <link linkend="boost.dll.shared_library">boost::dll::shared_library</link><computeroutput>::has(const char* )</computeroutput> function with the same symbol name returned <computeroutput>true</computeroutput>.</para><para>For importing symbols by <emphasis role="bold">non</emphasis> <emphasis role="bold">alias</emphasis> names use <link linkend="boost.dll.import">boost::dll::import</link> method.</para><para><emphasis role="bold">Examples:</emphasis> </para><para><programlisting language="c++">boost::function&lt;int(int)&gt; f = import_alias&lt;int(int)&gt;("test_lib.so", "integer_func_alias_name");

auto f_cpp11 = import_alias&lt;int(int)&gt;("test_lib.so", "integer_func_alias_name");
</programlisting></para><para><programlisting language="c++">boost::shared_ptr&lt;int&gt; i = import_alias&lt;int&gt;("test_lib.so", "integer_alias_name");
</programlisting></para><para><programlisting language="c++"/></para><para><emphasis role="bold">Template</emphasis> <emphasis role="bold">parameter</emphasis> <emphasis role="bold">T:</emphasis> Type of the symbol alias that we are going to import. Must be explicitly specified.</para><para>


</para></description><returns><para>callable object if T is a function type, or boost::shared_ptr&lt;T&gt; if T is an object type.</para>
</returns><throws><simpara><classname/> </simpara></throws></overloaded-function>





</namespace>
</namespace>
</header>
<header name="boost/dll/import_class.hpp">
<namespace name="boost">
<namespace name="dll">
<namespace name="experimental">
<class name="imported_class"><template>
      <template-type-parameter name="T"/>
    </template><description><para>This class represents an imported class.</para><para><note><para>It must be constructed via boost::dll::import_class(const smart_library&amp; lib, std::size_t, Args...)</para>
</note>

</para></description><typedef name="base_t"><type><classname>imported_class</classname>&lt; T &gt;</type></typedef>
<method-group name="private member functions">
<method name="make_data"><type><emphasis>unspecified</emphasis></type><template>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>const smart_library &amp;</paramtype></parameter><parameter name="args"><paramtype>Args ...</paramtype></parameter></method>
<method name="make_data"><type><emphasis>unspecified</emphasis></type><template>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>const smart_library &amp;</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></method>
</method-group>
<constructor><template>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype></parameter><parameter name="lib"><paramtype>const smart_library &amp;</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></constructor>
<constructor><template>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype></parameter><parameter name="lib"><paramtype>const smart_library &amp;</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></constructor>
<constructor><template>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype></parameter><parameter name="lib"><paramtype>smart_library &amp;&amp;</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></constructor>
<constructor><template>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype></parameter><parameter name="lib"><paramtype>smart_library &amp;&amp;</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></constructor>
<method-group name="public static functions">
<method name="make" specifiers="static"><type><classname>imported_class</classname>&lt; T &gt;</type><template>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>smart_library &amp;&amp;</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></method>
<method name="make" specifiers="static"><type><classname>imported_class</classname>&lt; T &gt;</type><template>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>smart_library &amp;&amp;</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></method>
<method name="make" specifiers="static"><type><classname>imported_class</classname>&lt; T &gt;</type><template>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>const smart_library &amp;</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></method>
<method name="make" specifiers="static"><type><classname>imported_class</classname>&lt; T &gt;</type><template>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>const smart_library &amp;</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></method>
</method-group>
<method-group name="public member functions">
<method name="get"><type>T *</type><purpose>Returns a pointer to the underlying class. </purpose></method>
<method name="is_move_constructible"><type>bool</type><purpose>Check if the imported class is move-constructible. </purpose></method>
<method name="is_move_assignable"><type>bool</type><purpose>Check if the imported class is move-assignable. </purpose></method>
<method name="is_copy_constructible"><type>bool</type><purpose>Check if the imported class is copy-constructible. </purpose></method>
<method name="is_copy_assignable"><type>bool</type><purpose>Check if the imported class is copy-assignable. </purpose></method>
<method name="copy" cv="const"><type><classname>imported_class</classname>&lt; T &gt;</type><purpose>Invoke the copy constructor. </purpose><description><para><note><para>Undefined behaviour if the imported object is not copy constructible. </para>
</note>
</para></description></method>
<method name="move"><type><classname>imported_class</classname>&lt; T &gt;</type><purpose>Invoke the move constructor. </purpose><description><para><note><para>Undefined behaviour if the imported object is not move constructible. </para>
</note>
</para></description></method>
<method name="copy_assign" cv="const"><type>void</type><parameter name="lhs"><paramtype>const <classname>imported_class</classname>&lt; T &gt; &amp;</paramtype></parameter><purpose>Invoke the copy assignment. </purpose><description><para><note><para>Undefined behaviour if the imported object is not copy assignable. </para>
</note>
</para></description></method>
<method name="move_assign"><type>void</type><parameter name="lhs"><paramtype><classname>imported_class</classname>&lt; T &gt; &amp;</paramtype></parameter><purpose>Invoke the move assignment. </purpose><description><para><note><para>Undefined behaviour if the imported object is not move assignable. </para>
</note>
</para></description></method>
<method name="conversion-operator" cv="const" specifiers="explicit"><type>bool</type><purpose>Check if the class is loaded. </purpose></method>
<method name="get_type_info"><type>const std::type_info &amp;</type><purpose>Get a const reference to the std::type_info. </purpose></method>
<method name="call"><type><emphasis>unspecified</emphasis></type><template>
          <template-type-parameter name="Signature"/>
        </template><parameter name="name"><paramtype>const std::string &amp;</paramtype></parameter><description><para>Call a member function. This returns a proxy to the function. The proxy mechanic mechanic is necessary, so the signaute can be passed.</para><para><emphasis role="bold">Example</emphasis> </para><para><programlisting language="c++">im_class.call&lt;void(const char*)&gt;("function_name")("MyString");
</programlisting> </para></description></method>
<method name="call"><type><emphasis>unspecified</emphasis></type><template>
          <template-type-parameter name="Tin"/>
          <template-type-parameter name="Signature"/>
          <template-type-parameter name=""><default>boost::enable_if&lt;detail::unqalified_is_same&lt;T, Tin&gt;&gt;</default></template-type-parameter>
        </template><parameter name="name"><paramtype>const std::string &amp;</paramtype></parameter><description><para>Call a qualified member function, i.e. const and or volatile.</para><para><emphasis role="bold">Example</emphasis> </para><para><programlisting language="c++">im_class.call&lt;const type_alias, void(const char*)&gt;("function_name")("MyString");
</programlisting> </para></description></method>
<method name="operator-&gt;*"><type><emphasis>unspecified</emphasis></type><template>
          <template-type-parameter name="Tin"/>
          <template-type-parameter name="T2"/>
        </template><parameter name="mn"><paramtype><emphasis>unspecified</emphasis></paramtype></parameter><purpose>Overload of -&gt;* for an imported method. </purpose></method>
<method name="import"><type><emphasis>unspecified</emphasis></type><template>
          <template-nontype-parameter name="Args"><type>class ...</type></template-nontype-parameter>
        </template><parameter name="name"><paramtype>const std::string &amp;</paramtype></parameter><purpose>Import a method of the class. </purpose></method>
</method-group>
<constructor cv="= delete"/>
<constructor cv="= delete"><parameter name=""><paramtype><classname>imported_class</classname> &amp;</paramtype></parameter></constructor>
<constructor cv="= default"><parameter name=""><paramtype><classname>imported_class</classname> &amp;&amp;</paramtype></parameter><purpose>Move constructor. </purpose></constructor>
<copy-assignment cv="= delete"><type><classname>imported_class</classname> &amp;</type><parameter name=""><paramtype><classname>imported_class</classname> &amp;</paramtype></parameter></copy-assignment>
<copy-assignment cv="= default"><type><classname>imported_class</classname> &amp;</type><parameter name=""><paramtype><classname>imported_class</classname> &amp;&amp;</paramtype></parameter><purpose>Move assignmend. </purpose></copy-assignment>
</class>

<overloaded-function name="import_class"><signature><type><classname>imported_class</classname>&lt; T &gt;</type><template>
          <template-type-parameter name="T"><purpose><para>Class type or alias </para></purpose></template-type-parameter>
          <template-nontype-parameter name="Args"><type>typename ...</type><purpose><para>Constructor argument list. </para></purpose></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>const smart_library &amp;</paramtype><description><para>Path to shared library or shared library to load function from. </para></description></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></signature><signature><type><classname>imported_class</classname>&lt; T &gt;</type><template>
          <template-type-parameter name="T"/>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>const smart_library &amp;</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="alias_name"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></signature><signature><type><classname>imported_class</classname>&lt; T &gt;</type><template>
          <template-type-parameter name="T"/>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib_"><paramtype>const smart_library &amp;</paramtype></parameter><parameter name="alias_name"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></signature><signature><type><classname>imported_class</classname>&lt; T &gt;</type><template>
          <template-type-parameter name="T"/>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>smart_library &amp;&amp;</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></signature><signature><type><classname>imported_class</classname>&lt; T &gt;</type><template>
          <template-type-parameter name="T"/>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>smart_library &amp;&amp;</paramtype></parameter><parameter name="alias_name"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></signature><signature><type><classname>imported_class</classname>&lt; T &gt;</type><template>
          <template-type-parameter name="T"/>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>smart_library &amp;&amp;</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></signature><signature><type><classname>imported_class</classname>&lt; T &gt;</type><template>
          <template-type-parameter name="T"/>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>smart_library &amp;&amp;</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="alias_name"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></signature><signature><type><classname>imported_class</classname>&lt; T &gt;</type><template>
          <template-type-parameter name="T"/>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>smart_library &amp;&amp;</paramtype></parameter><parameter name="alias_name"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></signature><description><para>Returns an instance of <classname alt="boost::dll::experimental::imported_class">imported_class</classname> which allows to call or import more functions. It takes a copy of the smart_libray, so no added type_aliases will be visible, for the object.</para><para>Few compilers do implement an allocating constructor, which allows the construction of the class without knowing the size. That is not portable, so the actual size of the class shall always be provided.</para><para><emphasis role="bold">Example:</emphasis> </para><para><programlisting language="c++">auto import_class&lt;class type_alias, const std::string&amp;, std::size_t&gt;(lib, "class_name", 20, "param1", 42);
</programlisting></para><para>In this example we construct an instance of the class "class_name" with the size 20, which has "type_alias" as an alias, through a constructor which takes a const-ref of std::string and an std::size_t parameter.</para><para>



</para></description><returns><para>class object.</para>
</returns><throws><simpara><classname/> </simpara></throws></overloaded-function>







<function name="import_class"><type><classname>imported_class</classname>&lt; T &gt;</type><template>
          <template-type-parameter name="T"/>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>smart_library &amp;</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></function>
<function name="import_class"><type><classname>imported_class</classname>&lt; T &gt;</type><template>
          <template-type-parameter name="T"/>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>smart_library &amp;</paramtype></parameter><parameter name="alias_name"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></function>
<function name="import_class"><type><classname>imported_class</classname>&lt; T &gt;</type><template>
          <template-type-parameter name="T"/>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>smart_library &amp;</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></function>
<function name="import_class"><type><classname>imported_class</classname>&lt; T &gt;</type><template>
          <template-type-parameter name="T"/>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>smart_library &amp;</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="alias_name"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></function>
<function name="import_class"><type><classname>imported_class</classname>&lt; T &gt;</type><template>
          <template-type-parameter name="T"/>
          <template-nontype-parameter name="Args"><type>typename ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>smart_library &amp;</paramtype></parameter><parameter name="alias_name"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="args"><paramtype>Args...</paramtype></parameter></function>










</namespace>












</namespace>
</namespace>
</header>
<header name="boost/dll/import_mangled.hpp">
<namespace name="boost">
<namespace name="dll">
<namespace name="experimental">















<overloaded-function name="import_mangled"><signature><type>result_type</type><template>
          <template-nontype-parameter name="Args"><type>class ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>const boost::dll::fs::path &amp;</paramtype><description><para>Path to shared library or shared library to load function from. </para></description></parameter><parameter name="name"><paramtype>const char *</paramtype><description><para>Null-terminated C or C++ mangled name of the function to import. Can handle std::string, char*, const char*. </para></description></parameter><parameter name="mode"><paramtype>load_mode::type</paramtype><default>load_mode::default_mode</default><description><para>An mode that will be used on library load.</para></description></parameter></signature><signature><type>result_type</type><template>
          <template-nontype-parameter name="Args"><type>class ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>const boost::dll::fs::path &amp;</paramtype></parameter><parameter name="name"><paramtype>const std::string &amp;</paramtype></parameter><parameter name="mode"><paramtype>load_mode::type</paramtype><default>load_mode::default_mode</default></parameter></signature><signature><type>result_type</type><template>
          <template-nontype-parameter name="Args"><type>class ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>const smart_library &amp;</paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter></signature><signature><type>result_type</type><template>
          <template-nontype-parameter name="Args"><type>class ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>const smart_library &amp;</paramtype></parameter><parameter name="name"><paramtype>const std::string &amp;</paramtype></parameter></signature><signature><type>result_type</type><template>
          <template-nontype-parameter name="Args"><type>class ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>smart_library &amp;&amp;</paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter></signature><signature><type>result_type</type><template>
          <template-nontype-parameter name="Args"><type>class ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>smart_library &amp;&amp;</paramtype></parameter><parameter name="name"><paramtype>const std::string &amp;</paramtype></parameter></signature><signature><type>result_type</type><template>
          <template-nontype-parameter name="Args"><type>class ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>const shared_library &amp;</paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter></signature><signature><type>result_type</type><template>
          <template-nontype-parameter name="Args"><type>class ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>const shared_library &amp;</paramtype></parameter><parameter name="name"><paramtype>const std::string &amp;</paramtype></parameter></signature><signature><type>result_type</type><template>
          <template-nontype-parameter name="Args"><type>class ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>shared_library &amp;&amp;</paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter></signature><signature><type>result_type</type><template>
          <template-nontype-parameter name="Args"><type>class ...</type></template-nontype-parameter>
        </template><parameter name="lib"><paramtype>shared_library &amp;&amp;</paramtype></parameter><parameter name="name"><paramtype>const std::string &amp;</paramtype></parameter></signature><description><para>Returns callable object or boost::shared_ptr&lt;T&gt; that holds the symbol imported from the loaded library. Returned value refcounts usage of the loaded shared library, so that it won't get unload until all copies of return value are not destroyed.</para><para>For importing symbols by <emphasis role="bold">alias</emphasis> names use <link linkend="boost.dll.import_alias">boost::dll::import_alias</link> method.</para><para><emphasis role="bold">Examples:</emphasis> </para><para><programlisting language="c++">boost::function&lt;int(int)&gt; f = import_mangled&lt;int(int)&gt;("test_lib.so", "integer_func_name");

auto f_cpp11 = import_mangled&lt;int(int)&gt;("test_lib.so", "integer_func_name");
</programlisting></para><para><programlisting language="c++">boost::shared_ptr&lt;int&gt; i = import_mangled&lt;int&gt;("test_lib.so", "integer_name");
</programlisting></para><para>Additionally you can also import overloaded symbols, including member-functions.</para><para><programlisting language="c++">auto fp = import_mangled&lt;void(int), void(double)&gt;("test_lib.so", "func");
</programlisting></para><para><programlisting language="c++">auto fp = import_mangled&lt;my_class, void(int), void(double)&gt;("test_lib.so", "func");
</programlisting></para><para>If qualified member-functions are needed, this can be set by repeating the class name with const or volatile. All following signatures after the redifintion will use this, i.e. the latest.</para><para><itemizedlist>
<listitem><para>*<programlisting language="c++">auto fp = import_mangled&lt;my_class, void(int), void(double),
                         const my_class, void(int), void(double)&gt;("test_lib.so", "func");
</programlisting></para>
</listitem></itemizedlist>
</para><para><emphasis role="bold">Template</emphasis> <emphasis role="bold">parameter</emphasis> <emphasis role="bold">T:</emphasis> Type of the symbol that we are going to import. Must be explicitly specified.</para><para>


</para></description><returns><para>callable object if T is a function type, or boost::shared_ptr&lt;T&gt; if T is an object type.</para>
</returns><throws><simpara><classname/> </simpara></throws></overloaded-function>









</namespace>












</namespace>
</namespace>
</header>
</library-reference>