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

More C++11 doc tweaks

Browse source
This commit is contained in:
William S Fulton 2014-03-10 07:19:16 +00:00
commit 3fb973644e
2 changed files with 25 additions and 21 deletions
Download patch file Download diff file Expand all files Collapse all files

42
Doc/Manual/CPlusPlus11.html
View file

@ -137,19 +137,14 @@ When either of these is used from a target language, a runtime call is made to o
<H3><a name="CPlusPlus11_extern_template"></a>7.2.3 Extern template</H3> <H3><a name="CPlusPlus11_extern_template"></a>7.2.3 Extern template</H3>
<p>SWIG correctly parses the keywords <tt>extern template</tt>. However, the explicit template instantiation is not used by SWIG, a <tt>%template</tt> is still required.</p> <p>SWIG correctly parses the keywords <tt>extern template</tt>.
However, this template instantiation suppression in a translation unit has no relevance for SWIG.
SWIG only uses <tt>%template</tt> for instantiating and wrapping templates.</p>
<div class="code"><pre> <div class="code"><pre>
extern template class std::vector&lt;MyClass&gt;; // explicit instantiation template class std::vector&lt;int&gt;; // C++03 explicit instantiation in C++
extern template class std::vector&lt;int&gt;; // C++11 explicit instantiation suppression in C++
... %template(VectorInt) std::vector&lt;int&gt;; // SWIG instantiation
class MyClass {
public:
int a;
int b;
};
</pre></div> </pre></div>
<H3><a name="CPlusPlus11_initializer_lists"></a>7.2.4 Initializer lists</H3> <H3><a name="CPlusPlus11_initializer_lists"></a>7.2.4 Initializer lists</H3>
@ -272,7 +267,7 @@ public:
</pre></div> </pre></div>
<p> <p>
Any attempt at passing in values from the target language will be ignored and replaced by <tt>{10, 20, 30, 40, 50}</tt>. Any attempt at passing in values from the target language will be ignored and be replaced by <tt>{10, 20, 30, 40, 50}</tt>.
Needless to say, this approach is very limited, but could be improved upon, but only slightly. Needless to say, this approach is very limited, but could be improved upon, but only slightly.
A typemap could be written to map a fixed number of elements on to the <tt>std::initializer_list</tt>, A typemap could be written to map a fixed number of elements on to the <tt>std::initializer_list</tt>,
but with values decided at runtime. but with values decided at runtime.
@ -468,7 +463,7 @@ struct DerivedStruct : BaseStruct {
<H3><a name="CPlusPlus11_null_pointer_constant"></a>7.2.11 Null pointer constant</H3> <H3><a name="CPlusPlus11_null_pointer_constant"></a>7.2.11 Null pointer constant</H3>
<p>The <tt>nullptr</tt> constant is largely unimportant in wrappers. In the few places it has an effect, it is treated like <tt>NULL</tt>.</p> <p>The <tt>nullptr</tt> constant is mostly unimportant in wrappers. In the few places it has an effect, it is treated like <tt>NULL</tt>.</p>
<H3><a name="CPlusPlus11_strongly_typed_enumerations"></a>7.2.12 Strongly typed enumerations</H3> <H3><a name="CPlusPlus11_strongly_typed_enumerations"></a>7.2.12 Strongly typed enumerations</H3>
@ -479,7 +474,8 @@ enum class MyEnum : unsigned int;
</pre></div> </pre></div>
<p>The strongly typed enumerations are treated the same as the ordinary and anonymous enums. <p>The strongly typed enumerations are treated the same as the ordinary and anonymous enums.
This is because SWIG doesn't support nested classes. This is usually not a problem, however, This is because the required nested class support in SWIG is new and has not yet been incorporated into the wrapping of these strongly typed enum classes.
This is usually not a problem, however,
there may be some name clashes. For example, the following code:</p> there may be some name clashes. For example, the following code:</p>
<div class="code"><pre> <div class="code"><pre>
@ -521,6 +517,10 @@ class AllColors {
}; };
</pre></div> </pre></div>
<p>
Expect to see this improved in a future version of SWIG.
</p>
<H3><a name="CPlusPlus11_double_angle_brackets"></a>7.2.13 Double angle brackets</H3> <H3><a name="CPlusPlus11_double_angle_brackets"></a>7.2.13 Double angle brackets</H3>
@ -541,22 +541,22 @@ For example:</p>
<div class="code"><pre> <div class="code"><pre>
class U { class U {
public: public:
int u; int u;
}; };
class V { class V {
public: public:
int v; int v;
}; };
class TestClass { class TestClass {
public: public:
//implicit converting constructor //implicit converting constructor
TestClass(U const &amp;val) { t=val.u; } TestClass(U const &amp;val) { t=val.u; }
// explicit constructor // explicit constructor
explicit TestClass(V const &amp;val) { t=val.v; } explicit TestClass(V const &amp;val) { t=val.v; }
int t; int t;
}; };
</pre></div> </pre></div>

4
Examples/test-suite/cpp11_template_explicit.i
View file

@ -20,5 +20,9 @@ extern template class std::vector<A>;
template class std::vector<A*>; template class std::vector<A*>;
extern template class std::vector<A*>; extern template class std::vector<A*>;
template class std::vector<int>;
extern template class std::vector<int>;
%} %}
%template(VectorInt) std::vector<int>;