jyapayne/swig
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Document improved variadic template support

Browse source
This commit is contained in:
William S Fulton 2022-12-22 19:35:20 +00:00
commit cdf9a18603
2 changed files with 48 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

4
CHANGES.current
View file

@ -7,6 +7,10 @@ the issue number to the end of the URL: https://github.com/swig/swig/issues/
Version 4.2.0 (in progress) Version 4.2.0 (in progress)
=========================== ===========================
2022-12-22: wsfulton
Complete support for C++11 variadic templates. Support was previously limited
to just one template parameter. Now zero or more template parameters are supported.
2022-12-06: wsfulton 2022-12-06: wsfulton
#1636 Fix syntax error for misplaced Doxygen comment after struct/class member. #1636 Fix syntax error for misplaced Doxygen comment after struct/class member.
Fix syntax error using Doxygen member groups syntax, "///*}", when used after Fix syntax error using Doxygen member groups syntax, "///*}", when used after

55
Doc/Manual/CPlusPlus11.html
View file

@ -1125,38 +1125,71 @@ union P {
<H3><a name="CPlusPlus11_variadic_templates">7.2.18 Variadic templates</a></H3> <H3><a name="CPlusPlus11_variadic_templates">7.2.18 Variadic templates</a></H3>
<p>SWIG supports the variadic templates syntax (inside the &lt;&gt; <p>SWIG supports the variadic templates including the &lt;&gt;
block, variadic class inheritance and variadic constructor and variadic class inheritance, variadic methods, variadic constructors and
initializers) with some limitations. The following code is correctly parsed:</p> initializers. Example:</p>
<div class="code"><pre> <div class="code"><pre>
template &lt;typename... BaseClasses&gt; class ClassName : public BaseClasses... { template &lt;typename... BaseClasses&gt; class ClassName : public BaseClasses... {
public: public:
ClassName (BaseClasses &amp;&amp;... baseClasses) : BaseClasses(baseClasses)... {} ClassName(BaseClasses &amp;&amp;... baseClasses) : BaseClasses(baseClasses)... {}
void InstanceMethod(const BaseClasses&amp;... baseClasses) {}
}; };
</pre></div> </pre></div>
<p> <p>
For now however, the <tt>%template</tt> directive only accepts one parameter substitution The <tt>%template</tt> directive works as expected for variable template parameters.
for the variable template parameters.
</p> </p>
<div class="code"><pre> <div class="code"><pre>
%template(MyVariant1) ClassName&lt;&gt; // zero argument not supported yet struct A {
%template(MyVariant2) ClassName&lt;int&gt; // ok virtual void amethod();
%template(MyVariant3) ClassName&lt;int, int&gt; // too many arguments not supported yet virtual ~A();
};
struct B {
virtual void bmethod();
virtual ~B();
};
%template(ClassName0) ClassName&lt;&gt;
%template(ClassName1) ClassName&lt;A&gt;
%template(ClassName2) ClassName&lt;A, B&gt;
</pre></div> </pre></div>
<p>Support for the variadic <tt>sizeof()</tt> function is correctly parsed:</p> <p>
Example usage from say Python:
</p>
<div class="targetlang"><pre>
cn0 = ClassName0()
cn0.InstanceMethod()
a = A()
cn1 = ClassName1(a)
cn1.amethod()
cn1.InstanceMethod(a)
b = B()
cn2 = ClassName2(a, b)
cn2.InstanceMethod(a, b)
cn2.amethod()
cn2.bmethod()
</pre></div>
<p>Support for the variadic <tt>sizeof()</tt> function also works:</p>
<div class="code"><pre> <div class="code"><pre>
const int SIZE = sizeof...(ClassName&lt;int, int&gt;); const int SIZE = sizeof...(ClassName&lt;A, B&gt;);
</pre></div> </pre></div>
<p> <p>
In the above example <tt>SIZE</tt> is of course wrapped as a constant. In the above example <tt>SIZE</tt> is of course wrapped as a constant.
</p> </p>
<p>
<b>Compatibility note:</b> SWIG-4.2.0 was the first version to fully support variadic templates.
SWIG-3.0.0 provided initial support and was limited to only one variadic parameter.
</p>
<H3><a name="CPlusPlus11_new_char_literals">7.2.19 New character literals</a></H3> <H3><a name="CPlusPlus11_new_char_literals">7.2.19 New character literals</a></H3>