From 4d2a61ee3c510adc5a80d3e9d5cb20a6a53e460f Mon Sep 17 00:00:00 2001 From: "biao716.wang" Date: Fri, 6 Mar 2020 00:55:29 +0900 Subject: [PATCH] Bump to swig 3.0.10 Change-Id: If37a1592394f80a169c471dc7e45b79492ea92fa Signed-off-by: biao716.wang --- ANNOUNCE | 26 +- CCache/Makefile.in | 36 +- CCache/ccache-swig.1 | 453 - CCache/ccache.h | 4 +- CCache/configure | 205 +- CCache/test.sh | 28 + CHANGES | 1508 +- CHANGES.current | 106 +- COPYRIGHT | 101 +- Doc/Devel/cpp11.html | 788 + Doc/Devel/internals.html | 4 +- Doc/Devel/tree.html | 2 +- Doc/Manual/Allegrocl.html | 360 +- Doc/Manual/Android.html | 55 +- Doc/Manual/Arguments.html | 35 +- Doc/Manual/CCache.html | 65 +- Doc/Manual/CPlusPlus11.html | 1184 + Doc/Manual/CSharp.html | 271 +- Doc/Manual/Chicken.html | 86 +- Doc/Manual/Contents.html | 345 +- Doc/Manual/Contract.html | 13 +- Doc/Manual/Customization.html | 133 +- Doc/Manual/D.html | 72 +- Doc/Manual/Extending.html | 133 +- Doc/Manual/Go.html | 1114 +- Doc/Manual/Guile.html | 70 +- Doc/Manual/Introduction.html | 75 +- Doc/Manual/Java.html | 985 +- Doc/Manual/Javascript.html | 999 + Doc/Manual/Library.html | 133 +- Doc/Manual/Lisp.html | 128 +- Doc/Manual/Lua.html | 392 +- Doc/Manual/Makefile | 47 +- Doc/Manual/Modula3.html | 51 +- Doc/Manual/Modules.html | 25 +- Doc/Manual/Mzscheme.html | 24 +- Doc/Manual/Ocaml.html | 437 +- Doc/Manual/Octave.html | 211 +- Doc/Manual/Perl5.html | 668 +- Doc/Manual/Php.html | 159 +- Doc/Manual/Pike.html | 27 +- Doc/Manual/Preface.html | 52 +- Doc/Manual/Preprocessor.html | 35 +- Doc/Manual/Python.html | 1620 +- Doc/Manual/R.html | 36 +- Doc/Manual/Ruby.html | 324 +- Doc/Manual/SWIG.html | 398 +- Doc/Manual/SWIGDocumentation.html | 42528 +++++++++++-------- Doc/Manual/SWIGDocumentation.pdf | Bin 2054702 -> 5109520 bytes Doc/Manual/SWIGPlus.html | 449 +- Doc/Manual/Scilab.html | 2147 + Doc/Manual/Scripting.html | 91 +- Doc/Manual/Sections.html | 22 +- Doc/Manual/Tcl.html | 174 +- Doc/Manual/Typemaps.html | 297 +- Doc/Manual/Varargs.html | 27 +- Doc/Manual/Warnings.html | 54 +- Doc/Manual/Windows.html | 100 +- Doc/Manual/chapters | 3 + Doc/Manual/fixstyle.py | 15 +- Doc/Manual/index.html | 7 +- Doc/Manual/linkchecker.config | 4 +- Doc/Manual/makechap.py | 45 +- Doc/Manual/maketoc.py | 4 +- Doc/Manual/margin-left.patch | 277 - Doc/Manual/style.css | 10 +- Doc/Manual/swightml.book | 3 + Doc/Manual/swigpdf.book | 41 - Examples/Makefile.in | 1063 +- Examples/README | 12 +- Examples/android/class/Makefile | 16 +- Examples/android/class/jni/example.cpp | 8 +- Examples/android/class/jni/example.h | 20 +- Examples/android/extend/Makefile | 16 +- .../src/org/swig/extendexample/SwigExtend.java | 2 +- Examples/android/simple/Makefile | 14 +- Examples/chicken/class/Makefile | 38 +- Examples/chicken/class/example.cxx | 10 +- Examples/chicken/class/example.h | 25 +- Examples/chicken/class/example.i | 1 - Examples/chicken/constants/Makefile | 29 +- Examples/chicken/egg/Makefile | 10 +- Examples/chicken/multimap/Makefile | 31 +- Examples/chicken/overload/Makefile | 31 +- Examples/chicken/simple/Makefile | 31 +- Examples/contract/simple_cxx/example.h | 6 +- Examples/csharp/arrays/Makefile | 14 +- Examples/csharp/arrays/example-cs.csproj | 90 + Examples/csharp/arrays/example-vc.vcproj | 415 + Examples/csharp/arrays/example.sln | 38 + Examples/csharp/callback/Makefile | 14 +- Examples/csharp/callback/example-cs.csproj | 187 +- Examples/csharp/callback/example-vc.vcproj | 387 +- Examples/csharp/callback/example.i | 2 - Examples/csharp/callback/example.sln | 44 +- Examples/csharp/check.list | 1 + Examples/csharp/class/Makefile | 14 +- Examples/csharp/class/example-cs.csproj | 193 +- Examples/csharp/class/example-vc.vcproj | 383 +- Examples/csharp/class/example.cxx | 10 +- Examples/csharp/class/example.h | 25 +- Examples/csharp/class/example.i | 1 - Examples/csharp/class/example.sln | 44 +- Examples/csharp/enum/Makefile | 14 +- Examples/csharp/enum/example-cs.csproj | 187 +- Examples/csharp/enum/example-vc.vcproj | 383 +- Examples/csharp/enum/example.sln | 44 +- Examples/csharp/extend/Makefile | 14 +- Examples/csharp/extend/example-cs.csproj | 193 +- Examples/csharp/extend/example-vc.vcproj | 387 +- Examples/csharp/extend/example.h | 2 +- Examples/csharp/extend/example.sln | 44 +- Examples/csharp/extend/runme.cs | 2 +- Examples/csharp/funcptr/Makefile | 14 +- Examples/csharp/funcptr/example-cs.csproj | 181 +- Examples/csharp/funcptr/example-vc.vcproj | 385 +- Examples/csharp/funcptr/example.sln | 44 +- Examples/csharp/nested/Makefile | 21 + Examples/csharp/nested/example-cs.csproj | 87 + Examples/csharp/nested/example-vc.vcproj | 415 + Examples/csharp/nested/example.cxx | 62 + Examples/csharp/nested/example.h | 48 + Examples/csharp/nested/example.i | 13 + Examples/csharp/nested/example.sln | 38 + Examples/csharp/nested/runme.cs | 27 + Examples/csharp/reference/Makefile | 14 +- Examples/csharp/reference/example-cs.csproj | 187 +- Examples/csharp/reference/example-vc.vcproj | 383 +- Examples/csharp/reference/example.cxx | 2 +- Examples/csharp/reference/example.h | 8 +- Examples/csharp/reference/example.i | 6 +- Examples/csharp/reference/example.sln | 44 +- Examples/csharp/simple/Makefile | 14 +- Examples/csharp/simple/example-cs.csproj | 175 +- Examples/csharp/simple/example-vc.vcproj | 211 +- Examples/csharp/simple/example.sln | 18 +- Examples/csharp/template/Makefile | 14 +- Examples/csharp/template/example-cs.csproj | 199 +- Examples/csharp/template/example-vc.vcproj | 382 +- Examples/csharp/template/example.sln | 44 +- Examples/csharp/variables/Makefile | 14 +- Examples/csharp/variables/example-cs.csproj | 187 +- Examples/csharp/variables/example-vc.vcproj | 386 +- Examples/csharp/variables/example.c | 6 +- Examples/csharp/variables/example.sln | 44 +- Examples/d/callback/Makefile | 28 +- Examples/d/callback/example.i | 2 - Examples/d/class/Makefile | 28 +- Examples/d/class/example.cxx | 10 +- Examples/d/class/example.h | 18 +- Examples/d/class/example.i | 1 - Examples/d/constants/Makefile | 28 +- Examples/d/constants/example.d | 23 - Examples/d/enum/Makefile | 28 +- Examples/d/example.mk.in | 66 + Examples/d/extend/Makefile | 28 +- Examples/d/extend/d1/runme.d | 2 +- Examples/d/extend/d2/runme.d | 2 +- Examples/d/extend/example.h | 2 +- Examples/d/funcptr/Makefile | 28 +- Examples/d/simple/Makefile | 28 +- Examples/d/variables/Makefile | 28 +- Examples/d/variables/example.c | 6 +- Examples/go/callback/Makefile | 20 +- .../{extend/example.cxx => callback/callback.cxx} | 0 Examples/go/callback/example.h | 1 - Examples/go/callback/example.i | 2 - Examples/go/callback/gocallback.go | 41 + Examples/go/callback/index.html | 64 +- Examples/go/callback/runme.go | 16 +- Examples/go/check.list | 1 + Examples/go/class/Makefile | 12 +- Examples/go/class/class.cxx | 28 + Examples/go/class/example.h | 25 +- Examples/go/class/example.i | 1 - Examples/go/class/index.html | 8 +- Examples/go/constants/Makefile | 12 +- Examples/go/director/Makefile | 26 + Examples/go/director/director.go | 72 + Examples/go/director/director.h | 41 + Examples/go/director/example.i | 11 + Examples/go/director/index.html | 28 + Examples/go/director/runme.go | 39 + Examples/go/enum/Makefile | 12 +- Examples/go/enum/{example.cxx => enum.cxx} | 0 Examples/go/extend/Makefile | 20 +- Examples/go/extend/ceo.go | 37 + Examples/go/extend/example.h | 4 +- .../go/{callback/example.cxx => extend/extend.cxx} | 0 Examples/go/extend/index.html | 13 +- Examples/go/extend/runme.go | 22 +- Examples/go/funcptr/Makefile | 12 +- Examples/go/funcptr/{example.c => funcptr.c} | 0 Examples/go/index.html | 45 +- Examples/go/multimap/Makefile | 12 +- Examples/go/multimap/example.i | 9 +- Examples/go/multimap/{example.c => multimap.c} | 0 Examples/go/pointer/Makefile | 12 +- Examples/go/pointer/{example.c => pointer.c} | 0 Examples/go/reference/Makefile | 12 +- Examples/go/reference/example.h | 8 +- Examples/go/reference/example.i | 2 +- Examples/go/reference/reference.cxx | 46 + Examples/go/simple/Makefile | 12 +- Examples/go/simple/{example.c => simple.c} | 0 Examples/go/template/Makefile | 12 +- Examples/go/template/index.html | 2 +- Examples/go/variables/Makefile | 12 +- Examples/go/variables/{example.c => variables.c} | 2 +- Examples/guile/class/Makefile | 13 +- Examples/guile/class/example.cxx | 10 +- Examples/guile/class/example.h | 18 +- Examples/guile/constants/Makefile | 12 +- Examples/guile/matrix/Makefile | 12 +- Examples/guile/matrix/README | 2 +- Examples/guile/matrix/runme.scm | 0 Examples/guile/multimap/Makefile | 13 +- Examples/guile/multivalue/Makefile | 13 +- Examples/guile/port/Makefile | 12 +- Examples/guile/port/README | 2 +- Examples/guile/simple/Makefile | 10 +- Examples/guile/std_vector/Makefile | 13 +- Examples/java/callback/Makefile | 12 +- Examples/java/callback/example.i | 2 - Examples/java/check.list | 1 + Examples/java/class/Makefile | 12 +- Examples/java/class/example.cxx | 10 +- Examples/java/class/example.h | 25 +- Examples/java/class/example.i | 1 - Examples/java/class/index.html | 49 +- Examples/java/constants/Makefile | 14 +- Examples/java/enum/Makefile | 12 +- Examples/java/extend/Makefile | 12 +- Examples/java/extend/example.h | 2 +- Examples/java/extend/runme.java | 2 +- Examples/java/funcptr/Makefile | 12 +- Examples/java/multimap/Makefile | 12 +- Examples/java/native/Makefile | 14 +- Examples/java/nested/Makefile | 20 + Examples/java/nested/example.cxx | 62 + Examples/java/nested/example.dsp | 162 + Examples/java/nested/example.h | 48 + Examples/java/nested/example.i | 13 + Examples/java/nested/runme.java | 32 + Examples/java/pointer/Makefile | 12 +- Examples/java/pointer/example.i | 4 - Examples/java/reference/Makefile | 12 +- Examples/java/reference/example.cxx | 2 +- Examples/java/reference/example.h | 8 +- Examples/java/reference/example.i | 6 +- Examples/java/simple/Makefile | 12 +- Examples/java/template/Makefile | 14 +- Examples/java/template/index.html | 2 +- Examples/java/typemap/Makefile | 14 +- Examples/java/variables/Makefile | 12 +- Examples/java/variables/example.c | 6 +- Examples/javascript/check.list | 13 + Examples/javascript/class/Makefile | 3 + Examples/javascript/class/binding.gyp.in | 9 + Examples/{go => javascript}/class/example.cxx | 10 +- Examples/javascript/class/example.h | 34 + Examples/javascript/class/example.i | 9 + Examples/javascript/class/example.js | 1 + Examples/javascript/class/runme.js | 46 + Examples/javascript/constant/Makefile | 3 + Examples/javascript/constant/binding.gyp.in | 9 + Examples/javascript/constant/example.h | 8 + Examples/javascript/constant/example.i | 24 + Examples/javascript/constant/example.js | 1 + Examples/javascript/constant/runme.js | 14 + Examples/javascript/enum/Makefile | 3 + Examples/javascript/enum/binding.gyp.in | 9 + Examples/javascript/enum/example.cxx | 37 + Examples/javascript/enum/example.h | 13 + Examples/javascript/enum/example.i | 11 + Examples/javascript/enum/example.js | 1 + Examples/javascript/enum/runme.js | 34 + Examples/javascript/example.mk | 36 + Examples/javascript/exception/Makefile | 3 + Examples/javascript/exception/binding.gyp.in | 30 + Examples/javascript/exception/example.cxx | 1 + Examples/javascript/exception/example.h | 53 + Examples/javascript/exception/example.i | 12 + Examples/javascript/exception/example.js | 1 + Examples/javascript/exception/runme.js | 64 + Examples/javascript/functor/Makefile | 3 + Examples/javascript/functor/binding.gyp.in | 9 + Examples/javascript/functor/example.i | 25 + Examples/javascript/functor/example.js | 1 + Examples/javascript/functor/runme.js | 15 + Examples/javascript/nspace/Makefile | 3 + Examples/javascript/nspace/binding.gyp.in | 9 + Examples/javascript/nspace/example.h | 23 + Examples/javascript/nspace/example.i | 10 + Examples/javascript/nspace/example.js | 1 + Examples/javascript/nspace/runme.js | 50 + Examples/javascript/operator/Makefile | 3 + Examples/javascript/operator/binding.gyp.in | 9 + Examples/javascript/operator/example.h | 36 + Examples/javascript/operator/example.i | 34 + Examples/javascript/operator/example.js | 1 + Examples/javascript/operator/runme.js | 25 + Examples/javascript/overload/Makefile | 3 + Examples/javascript/overload/binding.gyp.in | 9 + Examples/javascript/overload/example.h | 28 + Examples/javascript/overload/example.i | 16 + Examples/javascript/overload/example.js | 1 + Examples/javascript/overload/runme.js | 9 + Examples/javascript/pointer/Makefile | 3 + Examples/javascript/pointer/binding.gyp.in | 9 + Examples/javascript/pointer/example.cxx | 16 + Examples/javascript/pointer/example.i | 30 + Examples/javascript/pointer/example.js | 1 + Examples/javascript/pointer/runme.js | 35 + Examples/javascript/reference/Makefile | 3 + Examples/javascript/reference/binding.gyp.in | 9 + Examples/{go => javascript}/reference/example.cxx | 2 +- Examples/javascript/reference/example.h | 22 + Examples/javascript/reference/example.i | 42 + Examples/javascript/reference/example.js | 1 + Examples/javascript/reference/runme.js | 67 + Examples/javascript/simple/Makefile | 3 + Examples/javascript/simple/binding.gyp.in | 9 + Examples/javascript/simple/example.cxx | 18 + Examples/javascript/simple/example.i | 7 + Examples/javascript/simple/example.js | 1 + Examples/javascript/simple/runme.js | 26 + Examples/javascript/template/Makefile | 3 + Examples/javascript/template/binding.gyp.in | 9 + Examples/javascript/template/example.h | 32 + Examples/javascript/template/example.i | 17 + Examples/javascript/template/example.js | 1 + Examples/javascript/template/runme.js | 30 + Examples/javascript/variables/Makefile | 3 + Examples/javascript/variables/binding.gyp.in | 9 + Examples/javascript/variables/example.cxx | 96 + Examples/javascript/variables/example.h | 6 + Examples/javascript/variables/example.i | 49 + Examples/javascript/variables/example.js | 1 + Examples/javascript/variables/runme.js | 68 + Examples/lua/arrays/Makefile | 13 +- Examples/lua/arrays/example.c | 2 +- Examples/lua/arrays/example.i | 9 +- Examples/lua/arrays/runme.lua | 2 +- Examples/lua/check.list | 1 + Examples/lua/class/Makefile | 13 +- Examples/lua/class/example.cxx | 10 +- Examples/lua/class/example.h | 25 +- Examples/lua/class/example.i | 1 - Examples/lua/class/runme.lua | 1 - Examples/lua/constants/Makefile | 17 +- Examples/lua/dual/Makefile | 20 +- Examples/lua/dual/dual.cpp | 16 +- Examples/lua/embed/Makefile | 13 +- Examples/lua/embed/embed.c | 29 +- Examples/lua/embed/runme.lua | 6 +- Examples/lua/embed2/Makefile | 13 +- Examples/lua/embed2/embed2.c | 39 +- Examples/lua/embed2/runme.lua | 36 +- Examples/lua/embed3/Makefile | 14 +- Examples/lua/embed3/embed3.cpp | 37 +- Examples/lua/embed3/example.h | 2 +- Examples/lua/embed3/runme.lua | 10 +- Examples/lua/exception/Makefile | 15 +- Examples/lua/exception/runme.lua | 4 +- Examples/lua/funcptr3/Makefile | 15 +- Examples/lua/functest/Makefile | 15 +- Examples/lua/functest/example.i | 13 +- Examples/lua/functor/Makefile | 17 +- Examples/lua/import.lua | 8 +- Examples/lua/import/Makefile | 29 +- Examples/lua/import/README | 66 +- Examples/lua/import/base.h | 4 +- Examples/lua/nspace/Makefile | 22 + Examples/lua/nspace/example.h | 23 + Examples/lua/nspace/example.i | 10 + Examples/lua/nspace/runme.lua | 46 + Examples/lua/owner/Makefile | 13 +- Examples/lua/owner/example.cxx | 11 +- Examples/lua/owner/example.h | 6 +- Examples/lua/owner/runme.lua | 14 +- Examples/lua/pointer/Makefile | 15 +- Examples/lua/simple/Makefile | 13 +- Examples/lua/variables/Makefile | 13 +- Examples/lua/variables/example.c | 6 +- Examples/modula3/class/Makefile | 12 +- Examples/modula3/class/example.cxx | 10 +- Examples/modula3/class/example.h | 44 +- Examples/modula3/enum/Makefile | 14 +- Examples/modula3/exception/Makefile | 12 +- Examples/modula3/reference/Makefile | 12 +- Examples/modula3/reference/example.cxx | 2 +- Examples/modula3/reference/example.h | 4 +- Examples/modula3/simple/Makefile | 12 +- Examples/modula3/typemap/Makefile | 12 +- Examples/mzscheme/multimap/Makefile | 12 +- Examples/mzscheme/simple/Makefile | 12 +- Examples/mzscheme/std_vector/Makefile | 17 +- Examples/ocaml/argout_ref/Makefile | 13 +- Examples/ocaml/contract/Makefile | 20 +- Examples/ocaml/scoped_enum/Makefile | 20 +- Examples/ocaml/shapes/Makefile | 18 +- Examples/ocaml/simple/Makefile | 16 +- Examples/ocaml/std_string/Makefile | 15 +- Examples/ocaml/std_vector/Makefile | 15 +- Examples/ocaml/stl/Makefile | 21 +- Examples/ocaml/string_from_ptr/Makefile | 20 +- Examples/ocaml/strings_test/Makefile | 18 +- Examples/octave/callback/Makefile | 18 +- Examples/octave/callback/example.i | 5 +- Examples/octave/class/Makefile | 18 +- Examples/octave/class/example.cxx | 10 +- Examples/octave/class/example.h | 18 +- Examples/octave/class/example.i | 2 + Examples/octave/constants/Makefile | 18 +- Examples/octave/constants/example.i | 2 + Examples/octave/contract/Makefile | 16 +- Examples/octave/contract/example.i | 2 + Examples/octave/enum/Makefile | 18 +- Examples/octave/enum/example.i | 2 + Examples/octave/example.mk | 37 + Examples/octave/extend/Makefile | 18 +- Examples/octave/extend/example.h | 2 +- Examples/octave/extend/example.i | 3 + Examples/octave/funcptr/Makefile | 16 +- Examples/octave/funcptr/example.i | 3 + Examples/octave/funcptr2/Makefile | 16 +- Examples/octave/funcptr2/example.i | 3 + Examples/octave/functor/Makefile | 18 +- Examples/octave/functor/example.i | 1 + Examples/octave/module_load/Makefile | 23 +- Examples/octave/module_load/example.i | 3 + Examples/octave/module_load/runme.m | 5 +- Examples/octave/operator/Makefile | 18 +- Examples/octave/operator/example.i | 25 + Examples/octave/operator/runme.m | 13 + Examples/octave/pointer/Makefile | 16 +- Examples/octave/pointer/example.i | 2 + Examples/octave/reference/Makefile | 18 +- Examples/octave/reference/example.cxx | 2 +- Examples/octave/reference/example.h | 4 +- Examples/octave/reference/example.i | 2 + Examples/octave/simple/Makefile | 16 +- Examples/octave/simple/example.i | 2 + Examples/octave/template/Makefile | 18 +- Examples/octave/template/example.i | 2 + Examples/octave/variables/Makefile | 16 +- Examples/octave/variables/example.c | 6 +- Examples/octave/variables/example.i | 3 + Examples/perl5/callback/Makefile | 23 + Examples/perl5/callback/example.cxx | 4 + Examples/perl5/callback/example.h | 23 + Examples/perl5/callback/example.i | 15 + Examples/perl5/callback/index.html | 20 + Examples/perl5/callback/runme.pl | 48 + Examples/perl5/check.list | 2 + Examples/perl5/class/Makefile | 13 +- Examples/perl5/class/example.cxx | 10 +- Examples/perl5/class/example.h | 29 +- Examples/perl5/class/example.i | 2 - Examples/perl5/class/index.html | 87 +- Examples/perl5/class/runme.pl | 2 +- Examples/perl5/constants/Makefile | 13 +- Examples/perl5/constants2/Makefile | 13 +- Examples/perl5/extend/Makefile | 23 + Examples/perl5/extend/example.cxx | 4 + .../{python/swigrun => perl5/extend}/example.h | 4 +- .../{python/swigrun => perl5/extend}/example.i | 5 + Examples/perl5/extend/index.html | 19 + Examples/perl5/extend/runme.pl | 79 + Examples/perl5/funcptr/Makefile | 15 +- Examples/perl5/import/Makefile | 27 +- Examples/perl5/import/base.h | 4 +- Examples/perl5/index.html | 2 + Examples/perl5/inline/Makefile | 4 +- Examples/perl5/java/Makefile | 24 +- Examples/perl5/multimap/Makefile | 15 +- Examples/perl5/multiple_inheritance/Makefile | 17 +- Examples/perl5/pointer/Makefile | 15 +- Examples/perl5/reference/Makefile | 15 +- Examples/perl5/reference/example.cxx | 2 +- Examples/perl5/reference/example.h | 8 +- Examples/perl5/reference/example.i | 6 +- Examples/perl5/simple/Makefile | 15 +- Examples/perl5/value/Makefile | 15 +- Examples/perl5/value/example.i | 2 +- Examples/perl5/variables/Makefile | 15 +- Examples/perl5/variables/example.c | 6 +- Examples/perl5/xmlstring/Makefile | 13 +- Examples/perl5/xmlstring/xmlstring.i | 12 + Examples/php/callback/Makefile | 15 +- Examples/php/callback/example.i | 2 - Examples/php/class/Makefile | 13 +- Examples/php/class/example.cxx | 23 +- Examples/php/class/example.h | 16 +- Examples/php/class/example.i | 1 - Examples/php/class/runme.php | 4 +- Examples/php/constants/Makefile | 13 +- Examples/php/cpointer/Makefile | 13 +- Examples/php/cpointer/example.c | 2 +- Examples/php/disown/Makefile | 13 +- Examples/php/disown/example.h | 10 +- Examples/php/enum/Makefile | 13 +- Examples/php/extend/Makefile | 15 +- Examples/php/extend/example.h | 2 +- Examples/php/funcptr/Makefile | 13 +- Examples/php/overloading/Makefile | 13 +- Examples/php/pointer/Makefile | 13 +- Examples/php/pointer/runme.php | 2 +- Examples/php/pragmas/Makefile | 13 +- Examples/php/pragmas/runme.php | 0 Examples/php/proxy/Makefile | 13 +- Examples/php/proxy/example.h | 8 +- Examples/php/reference/Makefile | 13 +- Examples/php/reference/example.cxx | 10 +- Examples/php/reference/example.h | 8 +- Examples/php/reference/example.i | 12 +- Examples/php/simple/Makefile | 13 +- Examples/php/simple/runme.php | 0 Examples/php/sync/Makefile | 13 +- Examples/php/sync/example.cxx | 2 +- Examples/php/value/Makefile | 13 +- Examples/php/value/example.i | 2 +- Examples/php/variables/Makefile | 13 +- Examples/php/variables/example.c | 6 +- Examples/pike/class/Makefile | 13 +- Examples/pike/class/example.cxx | 32 +- Examples/pike/class/example.h | 31 +- Examples/pike/class/example.i | 1 - Examples/pike/class/runme.pike | 0 Examples/pike/constants/Makefile | 15 +- Examples/pike/constants/runme.pike | 0 Examples/pike/enum/Makefile | 13 +- Examples/pike/overload/Makefile | 13 +- Examples/pike/simple/Makefile | 13 +- Examples/pike/template/Makefile | 17 +- Examples/pike/template/runme.pike | 0 Examples/python/callback/Makefile | 15 +- Examples/python/callback/example.i | 2 - Examples/python/callback/runme.py | 17 +- Examples/python/check.list | 2 +- Examples/python/class/Makefile | 13 +- Examples/python/class/example.cxx | 10 +- Examples/python/class/example.h | 25 +- Examples/python/class/example.i | 1 - Examples/python/class/index.html | 87 +- Examples/python/class/runme.py | 22 +- Examples/python/constants/Makefile | 15 +- Examples/python/constants/runme.py | 8 +- Examples/python/contract/Makefile | 19 +- Examples/python/contract/runme.py | 15 +- Examples/python/docstrings/Makefile | 13 +- Examples/python/docstrings/runme.py | 3 +- Examples/python/enum/Makefile | 13 +- Examples/python/enum/runme.py | 5 +- Examples/python/exception/Makefile | 15 +- Examples/python/exception/example.i | 9 + Examples/python/exception/runme.py | 54 +- Examples/python/exceptproxy/Makefile | 17 +- Examples/python/exceptproxy/example.i | 10 +- Examples/python/exceptproxy/runme.py | 44 +- Examples/python/extend/Makefile | 15 +- Examples/python/extend/example.h | 2 +- Examples/python/extend/runme.py | 13 +- Examples/python/funcptr/Makefile | 13 +- Examples/python/funcptr/runme.py | 8 +- Examples/python/funcptr2/Makefile | 13 +- Examples/python/funcptr2/runme.py | 12 +- Examples/python/functor/Makefile | 17 +- Examples/python/functor/runme.py | 3 +- Examples/python/import/Makefile | 27 +- Examples/python/import/base.h | 4 +- Examples/python/import/runme.py | 22 +- Examples/python/import_packages/Makefile | 48 + Examples/python/import_packages/README | 4 + .../python/import_packages/from_init1/Makefile | 22 + Examples/python/import_packages/from_init1/README | 63 + .../python/import_packages/from_init1/py2/Makefile | 13 + .../import_packages/from_init1/py2/__init__.py | 0 .../import_packages/from_init1/py2/pkg2/Makefile | 25 + .../from_init1/py2/pkg2/__init__.py | 1 + .../import_packages/from_init1/py2/pkg2/bar.hpp | 5 + .../import_packages/from_init1/py2/pkg2/bar.i | 6 + .../import_packages/from_init1/py2/pkg2/foo.hpp | 4 + .../import_packages/from_init1/py2/pkg2/foo.i | 5 + .../python/import_packages/from_init1/py3/Makefile | 13 + .../import_packages/from_init1/py3/__init__.py | 0 .../import_packages/from_init1/py3/pkg2/Makefile | 25 + .../from_init1/py3/pkg2/__init__.py | 1 + .../import_packages/from_init1/py3/pkg2/bar.hpp | 5 + .../import_packages/from_init1/py3/pkg2/bar.i | 6 + .../import_packages/from_init1/py3/pkg2/foo.hpp | 4 + .../import_packages/from_init1/py3/pkg2/foo.i | 5 + .../python/import_packages/from_init1/runme.py | 13 + .../python/import_packages/from_init2/Makefile | 22 + Examples/python/import_packages/from_init2/README | 81 + .../python/import_packages/from_init2/py2/Makefile | 13 + .../import_packages/from_init2/py2/__init__.py | 0 .../import_packages/from_init2/py2/pkg2/Makefile | 21 + .../from_init2/py2/pkg2/__init__.py | 1 + .../import_packages/from_init2/py2/pkg2/bar.hpp | 5 + .../import_packages/from_init2/py2/pkg2/bar.i | 6 + .../from_init2/py2/pkg2/pkg3/Makefile | 18 + .../from_init2/py2/pkg2/pkg3/__init__.py | 0 .../from_init2/py2/pkg2/pkg3/foo.hpp | 4 + .../import_packages/from_init2/py2/pkg2/pkg3/foo.i | 5 + .../python/import_packages/from_init2/py3/Makefile | 13 + .../import_packages/from_init2/py3/__init__.py | 0 .../import_packages/from_init2/py3/pkg2/Makefile | 21 + .../from_init2/py3/pkg2/__init__.py | 1 + .../import_packages/from_init2/py3/pkg2/bar.hpp | 5 + .../import_packages/from_init2/py3/pkg2/bar.i | 6 + .../from_init2/py3/pkg2/pkg3/Makefile | 18 + .../from_init2/py3/pkg2/pkg3/__init__.py | 0 .../from_init2/py3/pkg2/pkg3/foo.hpp | 4 + .../import_packages/from_init2/py3/pkg2/pkg3/foo.i | 5 + .../python/import_packages/from_init2/runme.py | 13 + .../python/import_packages/from_init3/Makefile | 22 + Examples/python/import_packages/from_init3/README | 67 + .../python/import_packages/from_init3/py2/Makefile | 13 + .../import_packages/from_init3/py2/__init__.py | 0 .../import_packages/from_init3/py2/pkg2/Makefile | 21 + .../from_init3/py2/pkg2/__init__.py | 1 + .../import_packages/from_init3/py2/pkg2/bar.hpp | 5 + .../import_packages/from_init3/py2/pkg2/bar.i | 6 + .../from_init3/py2/pkg2/pkg3/Makefile | 13 + .../from_init3/py2/pkg2/pkg3/__init__.py | 0 .../from_init3/py2/pkg2/pkg3/pkg4/Makefile | 18 + .../from_init3/py2/pkg2/pkg3/pkg4/__init__.py | 0 .../from_init3/py2/pkg2/pkg3/pkg4/foo.hpp | 4 + .../from_init3/py2/pkg2/pkg3/pkg4/foo.i | 5 + .../python/import_packages/from_init3/py3/Makefile | 13 + .../import_packages/from_init3/py3/__init__.py | 0 .../import_packages/from_init3/py3/pkg2/Makefile | 21 + .../from_init3/py3/pkg2/__init__.py | 1 + .../import_packages/from_init3/py3/pkg2/bar.hpp | 5 + .../import_packages/from_init3/py3/pkg2/bar.i | 6 + .../from_init3/py3/pkg2/pkg3/Makefile | 13 + .../from_init3/py3/pkg2/pkg3/__init__.py | 0 .../from_init3/py3/pkg2/pkg3/pkg4/Makefile | 18 + .../from_init3/py3/pkg2/pkg3/pkg4/__init__.py | 0 .../from_init3/py3/pkg2/pkg3/pkg4/foo.hpp | 4 + .../from_init3/py3/pkg2/pkg3/pkg4/foo.i | 5 + .../python/import_packages/from_init3/runme.py | 13 + .../python/import_packages/namespace_pkg/Makefile | 17 + .../python/import_packages/namespace_pkg/README | 25 + .../python/import_packages/namespace_pkg/nonpkg.py | 5 + .../python/import_packages/namespace_pkg/normal.py | 7 + .../python/import_packages/namespace_pkg/nstest.py | 45 + .../python/import_packages/namespace_pkg/robin.i | 7 + .../python/import_packages/namespace_pkg/runme.py | 17 + .../python/import_packages/namespace_pkg/split.py | 9 + .../import_packages/namespace_pkg/zipsplit.py | 9 + .../import_packages/relativeimport1/Makefile | 22 + .../python/import_packages/relativeimport1/README | 22 + .../import_packages/relativeimport1/py2/Makefile | 13 + .../relativeimport1/py2/__init__.py | 0 .../relativeimport1/py2/pkg2/Makefile | 21 + .../relativeimport1/py2/pkg2/__init__.py | 0 .../relativeimport1/py2/pkg2/bar.hpp | 5 + .../import_packages/relativeimport1/py2/pkg2/bar.i | 6 + .../relativeimport1/py2/pkg2/pkg3/Makefile | 18 + .../relativeimport1/py2/pkg2/pkg3/__init__.py | 0 .../relativeimport1/py2/pkg2/pkg3/foo.hpp | 4 + .../relativeimport1/py2/pkg2/pkg3/foo.i | 5 + .../import_packages/relativeimport1/py3/Makefile | 13 + .../relativeimport1/py3/__init__.py | 0 .../relativeimport1/py3/pkg2/Makefile | 21 + .../relativeimport1/py3/pkg2/__init__.py | 0 .../relativeimport1/py3/pkg2/bar.hpp | 5 + .../import_packages/relativeimport1/py3/pkg2/bar.i | 6 + .../relativeimport1/py3/pkg2/pkg3/Makefile | 18 + .../relativeimport1/py3/pkg2/pkg3/__init__.py | 0 .../relativeimport1/py3/pkg2/pkg3/foo.hpp | 4 + .../relativeimport1/py3/pkg2/pkg3/foo.i | 5 + .../import_packages/relativeimport1/runme.py | 13 + .../import_packages/relativeimport2/Makefile | 22 + .../python/import_packages/relativeimport2/README | 22 + .../import_packages/relativeimport2/py2/Makefile | 13 + .../relativeimport2/py2/__init__.py | 0 .../relativeimport2/py2/pkg2/Makefile | 21 + .../relativeimport2/py2/pkg2/__init__.py | 0 .../relativeimport2/py2/pkg2/bar.hpp | 5 + .../import_packages/relativeimport2/py2/pkg2/bar.i | 6 + .../relativeimport2/py2/pkg2/pkg3/Makefile | 13 + .../relativeimport2/py2/pkg2/pkg3/__init__.py | 0 .../relativeimport2/py2/pkg2/pkg3/pkg4/Makefile | 18 + .../relativeimport2/py2/pkg2/pkg3/pkg4/__init__.py | 0 .../relativeimport2/py2/pkg2/pkg3/pkg4/foo.hpp | 4 + .../relativeimport2/py2/pkg2/pkg3/pkg4/foo.i | 5 + .../import_packages/relativeimport2/py3/Makefile | 13 + .../relativeimport2/py3/__init__.py | 0 .../relativeimport2/py3/pkg2/Makefile | 21 + .../relativeimport2/py3/pkg2/__init__.py | 0 .../relativeimport2/py3/pkg2/bar.hpp | 5 + .../import_packages/relativeimport2/py3/pkg2/bar.i | 6 + .../relativeimport2/py3/pkg2/pkg3/Makefile | 13 + .../relativeimport2/py3/pkg2/pkg3/__init__.py | 0 .../relativeimport2/py3/pkg2/pkg3/pkg4/Makefile | 18 + .../relativeimport2/py3/pkg2/pkg3/pkg4/__init__.py | 0 .../relativeimport2/py3/pkg2/pkg3/pkg4/foo.hpp | 4 + .../relativeimport2/py3/pkg2/pkg3/pkg4/foo.i | 5 + .../import_packages/relativeimport2/runme.py | 13 + .../import_packages/relativeimport3/Makefile | 22 + .../python/import_packages/relativeimport3/README | 22 + .../import_packages/relativeimport3/py2/Makefile | 13 + .../relativeimport3/py2/__init__.py | 0 .../relativeimport3/py2/pkg2/Makefile | 21 + .../relativeimport3/py2/pkg2/__init__.py | 0 .../relativeimport3/py2/pkg2/bar.hpp | 5 + .../import_packages/relativeimport3/py2/pkg2/bar.i | 6 + .../relativeimport3/py2/pkg2/pkg3/Makefile | 18 + .../relativeimport3/py2/pkg2/pkg3/__init__.py | 0 .../relativeimport3/py2/pkg2/pkg3/foo.hpp | 4 + .../relativeimport3/py2/pkg2/pkg3/foo.i | 5 + .../import_packages/relativeimport3/py3/Makefile | 13 + .../relativeimport3/py3/__init__.py | 0 .../relativeimport3/py3/pkg2/Makefile | 21 + .../relativeimport3/py3/pkg2/__init__.py | 0 .../relativeimport3/py3/pkg2/bar.hpp | 5 + .../import_packages/relativeimport3/py3/pkg2/bar.i | 6 + .../relativeimport3/py3/pkg2/pkg3/Makefile | 18 + .../relativeimport3/py3/pkg2/pkg3/__init__.py | 0 .../relativeimport3/py3/pkg2/pkg3/foo.hpp | 4 + .../relativeimport3/py3/pkg2/pkg3/foo.i | 5 + .../import_packages/relativeimport3/runme.py | 13 + .../python/import_packages/same_modnames1/Makefile | 18 + .../python/import_packages/same_modnames1/README | 26 + .../import_packages/same_modnames1/pkg1/Makefile | 18 + .../same_modnames1/pkg1/__init__.py | 0 .../import_packages/same_modnames1/pkg1/foo.hpp | 4 + .../import_packages/same_modnames1/pkg1/foo.i | 5 + .../import_packages/same_modnames1/pkg2/Makefile | 18 + .../same_modnames1/pkg2/__init__.py | 0 .../import_packages/same_modnames1/pkg2/foo.hpp | 5 + .../import_packages/same_modnames1/pkg2/foo.i | 6 + .../python/import_packages/same_modnames1/runme.py | 19 + .../python/import_packages/same_modnames2/Makefile | 18 + .../python/import_packages/same_modnames2/README | 26 + .../import_packages/same_modnames2/pkg1/Makefile | 18 + .../same_modnames2/pkg1/__init__.py | 0 .../import_packages/same_modnames2/pkg1/foo.hpp | 4 + .../import_packages/same_modnames2/pkg1/foo.i | 5 + .../same_modnames2/pkg1/pkg2/Makefile | 18 + .../same_modnames2/pkg1/pkg2/__init__.py | 0 .../same_modnames2/pkg1/pkg2/foo.hpp | 5 + .../import_packages/same_modnames2/pkg1/pkg2/foo.i | 6 + .../python/import_packages/same_modnames2/runme.py | 18 + .../python/import_packages/split_modules/Makefile | 26 + .../python/import_packages/split_modules/README | 7 + .../import_packages/split_modules/vanilla/Makefile | 18 + .../split_modules/vanilla/pkg1/Makefile | 18 + .../split_modules/vanilla/pkg1/__init__.py | 1 + .../split_modules/vanilla/pkg1/foo.i | 10 + .../import_packages/split_modules/vanilla/runme.py | 10 + .../split_modules/vanilla_split/Makefile | 22 + .../split_modules/vanilla_split/foo.i | 10 + .../split_modules/vanilla_split/pkg1/__init__.py | 1 + .../split_modules/vanilla_split/runme.py | 10 + Examples/python/import_template/Makefile | 27 +- Examples/python/import_template/base.h | 4 +- Examples/python/import_template/runme.py | 22 +- Examples/python/index.html | 3 +- Examples/python/java/Makefile | 22 +- Examples/python/java/example.i | 4 + Examples/python/java/runme.py | 8 +- Examples/python/libffi/Makefile | 15 +- Examples/python/multimap/Makefile | 13 +- Examples/python/multimap/example.i | 12 +- Examples/python/multimap/runme.py | 15 +- Examples/python/operator/Makefile | 17 +- Examples/python/operator/runme.py | 23 +- Examples/python/performance/constructor/Makefile | 23 +- Examples/python/performance/constructor/runme.py | 7 +- Examples/python/performance/func/Makefile | 23 +- Examples/python/performance/func/runme.py | 7 +- Examples/python/performance/harness.py | 18 +- Examples/python/performance/hierarchy/Makefile | 23 +- Examples/python/performance/hierarchy/runme.py | 7 +- .../python/performance/hierarchy_operator/Makefile | 23 +- .../python/performance/hierarchy_operator/runme.py | 7 +- Examples/python/performance/operator/Makefile | 23 +- Examples/python/performance/operator/runme.py | 7 +- Examples/python/pointer/Makefile | 13 +- Examples/python/pointer/runme.py | 39 +- Examples/python/reference/Makefile | 13 +- Examples/python/reference/example.cxx | 2 +- Examples/python/reference/example.h | 8 +- Examples/python/reference/example.i | 6 +- Examples/python/reference/runme.py | 25 +- Examples/python/simple/Makefile | 13 +- Examples/python/simple/runme.py | 15 +- Examples/python/smartptr/Makefile | 15 +- Examples/python/smartptr/example.h | 4 +- Examples/python/smartptr/runme.py | 19 +- Examples/python/std_map/Makefile | 17 +- Examples/python/std_map/runme.py | 15 +- Examples/python/std_vector/Makefile | 17 +- Examples/python/std_vector/runme.py | 11 +- Examples/python/swigrun/Makefile | 23 - Examples/python/swigrun/example.cxx | 20 - Examples/python/swigrun/runme.py | 28 - Examples/python/template/Makefile | 17 +- Examples/python/template/runme.py | 22 +- Examples/python/varargs/Makefile | 15 +- Examples/python/varargs/runme.py | 22 +- Examples/python/variables/Makefile | 13 +- Examples/python/variables/example.c | 6 +- Examples/python/variables/runme.py | 39 +- Examples/r/class/Makefile | 10 +- Examples/r/class/example.cxx | 10 +- Examples/r/class/example.h | 25 +- Examples/r/class/example.i | 6 +- Examples/r/simple/Makefile | 10 +- Examples/ruby/class/Makefile | 13 +- Examples/ruby/class/example.cxx | 10 +- Examples/ruby/class/example.h | 25 +- Examples/ruby/class/example.i | 1 - Examples/ruby/class/index.html | 61 +- Examples/ruby/class/runme.rb | 4 + Examples/ruby/constants/Makefile | 15 +- Examples/ruby/constants/runme.rb | 0 Examples/ruby/enum/Makefile | 13 +- Examples/ruby/exception_class/Makefile | 15 +- Examples/ruby/free_function/Makefile | 13 +- Examples/ruby/funcptr/Makefile | 13 +- Examples/ruby/funcptr2/Makefile | 13 +- Examples/ruby/functor/Makefile | 13 +- Examples/ruby/hashargs/Makefile | 17 +- Examples/ruby/hashargs/runme.rb | 0 Examples/ruby/import/Makefile | 29 +- Examples/ruby/import_template/Makefile | 29 +- Examples/ruby/index.html | 2 +- Examples/ruby/java/Makefile | 23 +- Examples/ruby/mark_function/Makefile | 13 +- Examples/ruby/mark_function/runme.rb | 4 +- Examples/ruby/multimap/Makefile | 13 +- Examples/ruby/multimap/runme.rb | 0 Examples/ruby/operator/Makefile | 17 +- Examples/ruby/overloading/Makefile | 13 +- Examples/ruby/pointer/Makefile | 13 +- Examples/ruby/reference/Makefile | 13 +- Examples/ruby/reference/example.cxx | 2 +- Examples/ruby/reference/example.h | 8 +- Examples/ruby/reference/example.i | 6 +- Examples/ruby/simple/Makefile | 13 +- Examples/ruby/simple/runme.rb | 0 Examples/ruby/std_vector/Makefile | 17 +- Examples/ruby/template/Makefile | 17 +- Examples/ruby/value/Makefile | 13 +- Examples/ruby/value/example.i | 2 +- Examples/ruby/variables/Makefile | 13 +- Examples/ruby/variables/example.c | 6 +- Examples/s-exp/uffi.lisp | 2 +- Examples/scilab/check.list | 16 + Examples/scilab/class/Makefile | 17 + Examples/scilab/class/example.cxx | 28 + Examples/scilab/class/example.h | 34 + Examples/scilab/class/example.i | 9 + Examples/scilab/class/runme.sci | 52 + Examples/scilab/constants/Makefile | 17 + Examples/scilab/constants/example.i | 30 + Examples/scilab/constants/runme.sci | 18 + Examples/scilab/contract/Makefile | 17 + Examples/scilab/contract/example.c | 23 + Examples/scilab/contract/example.i | 21 + Examples/scilab/contract/runme.sci | 46 + Examples/scilab/enum/Makefile | 17 + Examples/scilab/enum/example.cxx | 37 + Examples/scilab/enum/example.h | 13 + Examples/scilab/enum/example.i | 10 + Examples/scilab/enum/runme.sci | 36 + Examples/scilab/funcptr/Makefile | 17 + Examples/scilab/funcptr/example.c | 19 + Examples/scilab/funcptr/example.h | 9 + Examples/scilab/funcptr/example.i | 11 + Examples/scilab/funcptr/runme.sci | 22 + Examples/scilab/matrix/Makefile | 17 + Examples/scilab/matrix/example.c | 61 + Examples/scilab/matrix/example.i | 36 + Examples/scilab/matrix/runme.sci | 43 + Examples/scilab/matrix2/Makefile | 17 + Examples/scilab/matrix2/example.c | 118 + Examples/scilab/matrix2/example.i | 26 + Examples/scilab/matrix2/main.c | 24 + Examples/scilab/matrix2/runme.sci | 51 + Examples/scilab/pointer/Makefile | 17 + Examples/scilab/pointer/example.c | 16 + Examples/scilab/pointer/example.i | 30 + Examples/scilab/pointer/runme.sci | 47 + Examples/scilab/simple/Makefile | 17 + Examples/scilab/simple/example.c | 18 + Examples/scilab/simple/example.i | 7 + Examples/scilab/simple/runme.sci | 29 + Examples/scilab/std_list/Makefile | 17 + Examples/scilab/std_list/example.cxx | 61 + Examples/scilab/std_list/example.h | 14 + Examples/scilab/std_list/example.i | 19 + Examples/scilab/std_list/runme.sci | 39 + Examples/scilab/std_vector/Makefile | 17 + Examples/scilab/std_vector/example.h | 25 + Examples/scilab/std_vector/example.i | 19 + Examples/scilab/std_vector/runme.sci | 37 + Examples/scilab/struct/Makefile | 17 + Examples/scilab/struct/example.i | 11 + Examples/scilab/struct/runme.sci | 18 + Examples/scilab/template/Makefile | 17 + Examples/scilab/template/example.h | 32 + Examples/scilab/template/example.i | 17 + Examples/scilab/template/runme.sci | 45 + Examples/scilab/variables/Makefile | 17 + Examples/scilab/variables/example.c | 95 + Examples/scilab/variables/example.h | 6 + Examples/scilab/variables/example.i | 52 + Examples/scilab/variables/runme.sci | 73 + Examples/tcl/class/Makefile | 13 +- Examples/tcl/class/example.cxx | 10 +- Examples/tcl/class/example.h | 25 +- Examples/tcl/class/example.i | 2 - Examples/tcl/class/index.html | 50 +- Examples/tcl/constants/Makefile | 13 +- Examples/tcl/contract/Makefile | 17 +- Examples/tcl/enum/Makefile | 13 +- Examples/tcl/funcptr/Makefile | 13 +- Examples/tcl/import/Makefile | 27 +- Examples/tcl/java/Makefile | 28 +- Examples/tcl/multimap/Makefile | 13 +- Examples/tcl/operator/Makefile | 15 +- Examples/tcl/pointer/Makefile | 13 +- Examples/tcl/reference/Makefile | 13 +- Examples/tcl/reference/example.cxx | 2 +- Examples/tcl/reference/example.h | 8 +- Examples/tcl/reference/example.i | 6 +- Examples/tcl/simple/Makefile | 13 +- Examples/tcl/std_vector/Makefile | 15 +- Examples/tcl/value/Makefile | 13 +- Examples/tcl/value/example.i | 2 +- Examples/tcl/variables/Makefile | 13 +- Examples/tcl/variables/example.c | 6 +- Examples/test-suite/allegrocl/Makefile.in | 18 +- Examples/test-suite/allowexcept.i | 2 +- Examples/test-suite/allprotected.i | 5 + Examples/test-suite/apply_signed_char.i | 4 + Examples/test-suite/apply_strings.i | 17 +- Examples/test-suite/array_member.i | 4 + Examples/test-suite/array_typedef_memberin.i | 16 +- Examples/test-suite/arrays.i | 4 + Examples/test-suite/autodoc.i | 12 +- Examples/test-suite/bloody_hell.i | 14 +- Examples/test-suite/bools.i | 5 + Examples/test-suite/c_delete.i | 20 + Examples/test-suite/c_delete_function.i | 13 + Examples/test-suite/callback.i | 26 +- Examples/test-suite/cffi/Makefile.in | 16 +- Examples/test-suite/char_binary.i | 4 + Examples/test-suite/char_constant.i | 30 + Examples/test-suite/char_strings.i | 4 - Examples/test-suite/chartest.i | 84 + Examples/test-suite/chicken/Makefile.in | 30 +- .../test-suite/chicken/overload_extend_c_runme.ss | 2 + Examples/test-suite/clisp/Makefile.in | 16 +- Examples/test-suite/common.mk | 220 +- Examples/test-suite/compactdefaultargs.i | 1 + Examples/test-suite/constant_directive.i | 44 + Examples/test-suite/constant_pointers.i | 5 + Examples/test-suite/constructor_copy.i | 24 +- Examples/test-suite/constructor_exception.i | 6 +- Examples/test-suite/conversion_ns_template.i | 4 + Examples/test-suite/conversion_operators.i | 55 + Examples/test-suite/cpp11_alignment.i | 16 + .../test-suite/cpp11_alternate_function_syntax.i | 18 + Examples/test-suite/cpp11_constexpr.i | 40 + Examples/test-suite/cpp11_decltype.i | 19 + Examples/test-suite/cpp11_default_delete.i | 81 + .../test-suite/cpp11_delegating_constructors.i | 18 + Examples/test-suite/cpp11_director_enums.i | 14 + .../cpp11_explicit_conversion_operators.i | 41 + Examples/test-suite/cpp11_final_override.i | 128 + Examples/test-suite/cpp11_function_objects.i | 41 + Examples/test-suite/cpp11_hash_tables.i | 43 + .../test-suite/cpp11_inheriting_constructors.i | 29 + Examples/test-suite/cpp11_initializer_list.i | 34 + .../test-suite/cpp11_initializer_list_extend.i | 29 + Examples/test-suite/cpp11_lambda_functions.i | 107 + Examples/test-suite/cpp11_li_std_array.i | 62 + Examples/test-suite/cpp11_noexcept.i | 49 + Examples/test-suite/cpp11_null_pointer_constant.i | 22 + Examples/test-suite/cpp11_raw_string_literals.i | 59 + Examples/test-suite/cpp11_reference_wrapper.i | 36 + Examples/test-suite/cpp11_result_of.i | 57 + Examples/test-suite/cpp11_rvalue_reference.i | 22 + Examples/test-suite/cpp11_rvalue_reference2.i | 89 + Examples/test-suite/cpp11_rvalue_reference3.i | 67 + Examples/test-suite/cpp11_sizeof_object.i | 17 + Examples/test-suite/cpp11_static_assert.i | 17 + .../test-suite/cpp11_strongly_typed_enumerations.i | 225 + .../cpp11_strongly_typed_enumerations_simple.i | 5 + .../test-suite/cpp11_template_double_brackets.i | 53 + Examples/test-suite/cpp11_template_explicit.i | 31 + Examples/test-suite/cpp11_template_typedefs.i | 56 + Examples/test-suite/cpp11_thread_local.i | 33 + Examples/test-suite/cpp11_type_aliasing.i | 66 + Examples/test-suite/cpp11_type_traits.i | 29 + Examples/test-suite/cpp11_uniform_initialization.i | 49 + Examples/test-suite/cpp11_unrestricted_unions.i | 23 + Examples/test-suite/cpp11_userdefined_literals.i | 53 + Examples/test-suite/cpp11_variadic_templates.i | 77 + Examples/test-suite/cpp_basic.i | 13 + Examples/test-suite/csharp/Makefile.in | 35 +- .../cpp11_strongly_typed_enumerations_runme.cs | 169 + .../test-suite/csharp/csharp_exceptions_runme.cs | 6 +- .../test-suite/csharp/default_constructor_runme.cs | 8 - .../csharp/director_pass_by_value_runme.cs | 43 + .../test-suite/csharp/director_smartptr_runme.cs | 34 +- .../csharp/li_boost_shared_ptr_bits_runme.cs | 7 + .../test-suite/csharp/li_boost_shared_ptr_runme.cs | 35 +- .../test-suite/csharp/li_std_auto_ptr_runme.cs | 57 + Examples/test-suite/csharp/li_std_vector_runme.cs | 13 - .../test-suite/csharp/li_swigtype_inout_runme.cs | 56 + .../csharp/multiple_inheritance_abstract_runme.cs | 245 + .../multiple_inheritance_interfaces_runme.cs | 87 + .../csharp/multiple_inheritance_nspace_runme.cs | 246 + .../multiple_inheritance_shared_ptr_runme.cs | 329 + Examples/test-suite/csharp/nested_class_runme.cs | 66 + .../test-suite/csharp/nested_directors_runme.cs | 20 + Examples/test-suite/csharp/nested_structs_runme.cs | 28 + .../test-suite/csharp/nested_workaround_runme.cs | 23 + .../test-suite/csharp/rename_pcre_encoder_runme.cs | 9 +- .../csharp/special_variable_attributes_runme.cs | 30 + .../test-suite/csharp/template_nested_runme.cs | 25 + Examples/test-suite/csharp_exceptions.i | 2 +- Examples/test-suite/csharp_features.i | 4 + .../test-suite/csharp_namespace_system_collision.i | 39 + Examples/test-suite/csharp_prepost.i | 6 +- Examples/test-suite/csharp_swig2_compatibility.i | 48 + Examples/test-suite/csharp_typemaps.i | 8 +- Examples/test-suite/d/Makefile.in | 22 +- .../test-suite/d/default_constructor_runme.1.d | 13 - .../test-suite/d/default_constructor_runme.2.d | 2 - .../test-suite/d/li_boost_shared_ptr_runme.2.d | 274 +- Examples/test-suite/d/operator_overload_runme.2.d | 2 +- Examples/test-suite/default_arg_values.i | 12 + Examples/test-suite/default_args.i | 64 + Examples/test-suite/default_args_c.i | 14 + Examples/test-suite/default_constructor.i | 31 +- Examples/test-suite/derived_nested.i | 5 +- Examples/test-suite/director_abstract.i | 2 +- Examples/test-suite/director_binary_string.i | 13 + Examples/test-suite/director_exception.i | 51 +- Examples/test-suite/director_frob.i | 14 +- Examples/test-suite/director_ignore.i | 17 +- Examples/test-suite/director_keywords.i | 9 +- Examples/test-suite/director_nested_class.i | 25 + Examples/test-suite/director_nestedmodule.i | 29 + Examples/test-suite/director_nspace.i | 4 +- .../director_nspace_director_name_collision.i | 4 +- Examples/test-suite/director_overload2.i | 8 +- Examples/test-suite/director_pass_by_value.i | 30 + Examples/test-suite/director_property.i | 151 + Examples/test-suite/director_ref.i | 82 + Examples/test-suite/director_smartptr.i | 10 +- Examples/test-suite/empty_c.i | 1 + Examples/test-suite/enum_forward.i | 28 +- Examples/test-suite/enum_ignore.i | 20 + Examples/test-suite/enum_macro.i | 7 + Examples/test-suite/enum_missing.i | 39 + Examples/test-suite/enum_rename.i | 2 +- Examples/test-suite/enum_thorough.i | 115 +- Examples/test-suite/equality.i | 69 + Examples/test-suite/errors/Makefile.in | 59 + Examples/test-suite/errors/c_bad_name.stderr | 2 + Examples/test-suite/errors/c_bad_native.stderr | 1 + Examples/test-suite/errors/c_class.stderr | 2 + Examples/test-suite/errors/c_default_error.i | 4 - Examples/test-suite/errors/c_deprecated.stderr | 2 + Examples/test-suite/errors/c_empty_char.stderr | 1 + Examples/test-suite/errors/c_enum_badvalue.stderr | 1 + Examples/test-suite/errors/c_extra_rblock.stderr | 1 + Examples/test-suite/errors/c_extra_rbrace.stderr | 1 + Examples/test-suite/errors/c_extra_unsigned.stderr | 3 + Examples/test-suite/errors/c_insert_missing.stderr | 1 + Examples/test-suite/errors/c_long_short.stderr | 4 + Examples/test-suite/errors/c_missing_rbrace.stderr | 2 + Examples/test-suite/errors/c_missing_semi.stderr | 1 + Examples/test-suite/errors/c_redefine.stderr | 6 + Examples/test-suite/errors/c_varargs.i | 3 - Examples/test-suite/errors/c_varargs_neg.stderr | 1 + Examples/test-suite/errors/cpp_bad_extern.stderr | 2 + .../errors/cpp_extend_destructors.stderr | 19 + .../test-suite/errors/cpp_extend_redefine.stderr | 4 + .../test-suite/errors/cpp_extend_undefined.stderr | 1 + Examples/test-suite/errors/cpp_extra_brackets.i | 6 + .../test-suite/errors/cpp_extra_brackets.stderr | 1 + Examples/test-suite/errors/cpp_extra_brackets2.i | 9 + .../test-suite/errors/cpp_extra_brackets2.stderr | 1 + Examples/test-suite/errors/cpp_inherit.stderr | 20 + Examples/test-suite/errors/cpp_inherit_ignored.i | 19 + .../test-suite/errors/cpp_inherit_ignored.stderr | 3 + .../test-suite/errors/cpp_inline_namespace.stderr | 1 + Examples/test-suite/errors/cpp_macro_locator.i | 7 +- .../test-suite/errors/cpp_macro_locator.stderr | 21 + .../errors/cpp_missing_rparenthesis.stderr | 2 + .../test-suite/errors/cpp_missing_rtemplate.stderr | 1 + .../test-suite/errors/cpp_namespace_alias.stderr | 1 + .../errors/cpp_namespace_aliasnot.stderr | 1 + .../errors/cpp_namespace_aliasundef.stderr | 1 + Examples/test-suite/errors/cpp_nested.i | 13 - Examples/test-suite/errors/cpp_nested_template.i | 20 + .../test-suite/errors/cpp_nested_template.stderr | 2 + Examples/test-suite/errors/cpp_no_access.stderr | 1 + .../test-suite/errors/cpp_no_return_type.stderr | 2 + Examples/test-suite/errors/cpp_nobase.stderr | 3 + Examples/test-suite/errors/cpp_overload.i | 15 - .../test-suite/errors/cpp_overload_const.stderr | 10 + Examples/test-suite/errors/cpp_private_defvalue.i | 7 - .../test-suite/errors/cpp_private_inherit.stderr | 2 + .../test-suite/errors/cpp_recursive_typedef.stderr | 1 + Examples/test-suite/errors/cpp_shared_ptr.stderr | 3 + Examples/test-suite/errors/cpp_template_argname.i | 8 - Examples/test-suite/errors/cpp_template_friend.i | 26 + .../test-suite/errors/cpp_template_friend.stderr | 8 + .../test-suite/errors/cpp_template_nargs.stderr | 2 + Examples/test-suite/errors/cpp_template_not.stderr | 1 + .../test-suite/errors/cpp_template_partial.stderr | 1 + Examples/test-suite/errors/cpp_template_repeat.i | 2 +- .../test-suite/errors/cpp_template_repeat.stderr | 0 .../test-suite/errors/cpp_template_undef.stderr | 1 + Examples/test-suite/errors/cpp_using_not.stderr | 1 + .../test-suite/errors/cpp_using_type_aliasing.i | 13 + .../errors/cpp_using_type_aliasing.stderr | 3 + Examples/test-suite/errors/cpp_using_undef.stderr | 2 + Examples/test-suite/errors/expected.log | 391 - Examples/test-suite/errors/make.sh | 124 - Examples/test-suite/errors/nomodule.stderr | 1 + Examples/test-suite/errors/pp_badeval.stderr | 2 + Examples/test-suite/errors/pp_constant.i | 4 +- Examples/test-suite/errors/pp_constant.stderr | 8 + Examples/test-suite/errors/pp_defined.stderr | 2 + Examples/test-suite/errors/pp_deprecated.stderr | 4 + .../test-suite/errors/pp_illegal_argument.stderr | 3 + Examples/test-suite/errors/pp_macro_args.i | 7 - Examples/test-suite/errors/pp_macro_badchar.stderr | 1 + .../errors/pp_macro_defined_unterminated.stderr | 1 + .../test-suite/errors/pp_macro_expansion.stderr | 1 + .../errors/pp_macro_expansion_multiline.stderr | 4 + .../errors/pp_macro_inline_unterminated.stderr | 2 + .../errors/pp_macro_missing_expression.stderr | 5 + Examples/test-suite/errors/pp_macro_nargs.stderr | 4 + Examples/test-suite/errors/pp_macro_redef.stderr | 4 + Examples/test-suite/errors/pp_macro_rparen.stderr | 1 + .../errors/pp_macro_unexpected_tokens.stderr | 5 + .../test-suite/errors/pp_macro_unterminated.stderr | 1 + .../test-suite/errors/pp_misplaced_elif.stderr | 2 + .../test-suite/errors/pp_misplaced_else.stderr | 2 + .../test-suite/errors/pp_missing_enddef.stderr | 1 + Examples/test-suite/errors/pp_missing_endif.stderr | 1 + Examples/test-suite/errors/pp_missing_endoffile.i | 7 + .../test-suite/errors/pp_missing_endoffile.stderr | 1 + Examples/test-suite/errors/pp_missing_file.stderr | 1 + .../test-suite/errors/pp_missing_rblock.stderr | 1 + Examples/test-suite/errors/pp_pragma.stderr | 1 + Examples/test-suite/errors/pp_unknowndirective.i | 12 + .../test-suite/errors/pp_unknowndirective.stderr | 1 + Examples/test-suite/errors/pp_unknowndirective2.i | 11 + .../test-suite/errors/pp_unknowndirective2.stderr | 1 + Examples/test-suite/errors/pp_unterm_char.stderr | 1 + .../test-suite/errors/pp_unterm_comment.stderr | 1 + Examples/test-suite/errors/pp_unterm_string.stderr | 1 + Examples/test-suite/errors/pp_unterminated_block.i | 5 + .../test-suite/errors/pp_unterminated_block.stderr | 1 + Examples/test-suite/errors/pp_variable_args.stderr | 1 + Examples/test-suite/errors/swig_apply_nargs.stderr | 1 + Examples/test-suite/errors/swig_extend.stderr | 8 + Examples/test-suite/errors/swig_fragment_missing.i | 4 + .../test-suite/errors/swig_fragment_missing.stderr | 1 + Examples/test-suite/errors/swig_identifier.stderr | 1 + Examples/test-suite/errors/swig_insert_bad.stderr | 1 + Examples/test-suite/errors/swig_pythoncode_bad.i | 7 + .../test-suite/errors/swig_pythoncode_bad.stderr | 1 + Examples/test-suite/errors/swig_pythoncode_bad2.i | 13 + .../test-suite/errors/swig_pythoncode_bad2.stderr | 1 + Examples/test-suite/errors/swig_pythoncode_bad3.i | 7 + .../test-suite/errors/swig_pythoncode_bad3.stderr | 1 + .../test-suite/errors/swig_typemap_copy.stderr | 1 + Examples/test-suite/errors/swig_typemap_old.stderr | 6 + .../test-suite/errors/swig_typemap_warn.stderr | 7 + Examples/test-suite/exception_classname.i | 13 + Examples/test-suite/exception_order.i | 7 + Examples/test-suite/exception_partial_info.i | 2 +- Examples/test-suite/extend.i | 3 + Examples/test-suite/extend_default.i | 2 +- Examples/test-suite/extend_special_variables.i | 16 + Examples/test-suite/extern_c.i | 15 + Examples/test-suite/friends_template.i | 46 + Examples/test-suite/funcptr_cpp.i | 2 +- Examples/test-suite/global_functions.i | 8 + Examples/test-suite/global_vars.i | 5 + Examples/test-suite/go/Makefile.in | 150 +- Examples/test-suite/go/argout_runme.go | 41 + Examples/test-suite/go/contract_runme.go | 4 +- .../go/cpp11_strongly_typed_enumerations_runme.go | 171 + .../test-suite/go/default_constructor_runme.go | 3 - Examples/test-suite/go/director_abstract_runme.go | 62 - Examples/test-suite/go/director_thread_runme.go | 28 - Examples/test-suite/go/empty_c_runme.go | 6 + Examples/test-suite/go/go_director_inout_runme.go | 32 + Examples/test-suite/go/go_inout_runme.go | 53 + Examples/test-suite/go/go_subdir_import_runme.go | 16 + Examples/test-suite/go/inherit_member_runme.go | 15 + Examples/test-suite/go/keyword_rename_c_runme.go | 8 + Examples/test-suite/go/li_carrays_cpp_runme.go | 14 + Examples/test-suite/go/li_cdata_cpp_runme.go | 13 + Examples/test-suite/go/li_cpointer_cpp_runme.go | 14 + ..._extendc_runme.go => overload_extend2_runme.go} | 4 +- Examples/test-suite/go/overload_extend_c_runme.go | 22 + .../test-suite/go/overload_polymorphic_runme.go | 15 + Examples/test-suite/go/template_opaque_runme.go | 2 +- .../test-suite/go/template_typedef_import_runme.go | 29 - Examples/test-suite/go/wrapmacro_runme.go | 4 +- Examples/test-suite/go_director_inout.i | 126 + Examples/test-suite/go_inout.i | 243 + Examples/test-suite/go_subdir_import.list | 3 + Examples/test-suite/go_subdir_import_a.i | 37 + Examples/test-suite/go_subdir_import_b.i | 12 + Examples/test-suite/guile/Makefile.in | 18 +- Examples/test-suite/guile/li_std_string_runme.scm | 27 +- .../test-suite/guile/overload_extend_c_runme.scm | 2 + Examples/test-suite/ignore_template_constructor.i | 10 +- Examples/test-suite/import_nomodule.i | 9 +- Examples/test-suite/infinity.i | 61 + Examples/test-suite/inherit_member.i | 17 + Examples/test-suite/insert_directive.i | 2 +- Examples/test-suite/java/Makefile.in | 32 +- Examples/test-suite/java/README | 2 +- Examples/test-suite/java/char_binary_runme.java | 6 + .../test-suite/java/constant_directive_runme.java | 26 + .../test-suite/java/cpp11_constexpr_runme.java | 33 + .../java/cpp11_lambda_functions_runme.java | 28 + .../test-suite/java/cpp11_li_std_array_runme.java | 82 + .../test-suite/java/cpp11_result_of_runme.java | 24 + .../cpp11_strongly_typed_enumerations_runme.java | 176 + ...1_strongly_typed_enumerations_simple_runme.java | 176 + .../test-suite/java/cpp11_thread_local_runme.java | 51 + .../test-suite/java/cpp11_type_aliasing_runme.java | 20 + .../test-suite/java/default_constructor_runme.java | 8 - Examples/test-suite/java/derived_nested_runme.java | 22 + .../java/director_binary_string_runme.java | 12 + .../test-suite/java/director_classes_runme.java | 2 +- .../java/director_nested_class_runme.java | 41 + .../java/director_pass_by_value_runme.java | 48 + Examples/test-suite/java/director_ref_runme.java | 71 + .../test-suite/java/director_smartptr_runme.java | 36 +- Examples/test-suite/java/dynamic_cast_runme.java | 3 +- .../test-suite/java/friends_template_runme.java | 28 + .../test-suite/java/ignore_parameter_runme.java | 16 +- ...va_director_exception_feature_nspace_runme.java | 150 + .../java_director_exception_feature_runme.java | 152 + .../java/java_director_ptrclass_runme.java | 47 + Examples/test-suite/java/java_director_runme.java | 39 +- Examples/test-suite/java/java_jnitypes_runme.java | 3 +- .../test-suite/java/java_lib_various_runme.java | 19 + Examples/test-suite/java/kwargs_feature_runme.java | 23 + .../java/li_boost_intrusive_ptr_runme.java | 39 +- .../java/li_boost_shared_ptr_attribute_runme.java | 38 + .../java/li_boost_shared_ptr_bits_runme.java | 7 + .../test-suite/java/li_boost_shared_ptr_runme.java | 37 +- Examples/test-suite/java/li_carrays_cpp_runme.java | 88 + Examples/test-suite/java/li_carrays_runme.java | 2 +- Examples/test-suite/java/li_cdata_cpp_runme.java | 24 + Examples/test-suite/java/li_cdata_runme.java | 24 + .../test-suite/java/li_std_auto_ptr_runme.java | 68 + Examples/test-suite/java/long_long_runme.java | 56 +- .../java/multiple_inheritance_abstract_runme.java | 253 + .../multiple_inheritance_interfaces_runme.java | 78 + .../java/multiple_inheritance_nspace_runme.java | 255 + .../multiple_inheritance_shared_ptr_runme.java | 337 + .../test-suite/java/naturalvar_more_runme.java | 23 + .../test-suite/java/naturalvar_onoff_runme.java | 37 + Examples/test-suite/java/nested_class_runme.java | 62 +- .../test-suite/java/nested_extend_c_runme.java | 45 + Examples/test-suite/java/nested_structs_runme.java | 21 +- .../java/nested_template_base_runme.java | 27 + .../test-suite/java/preproc_line_file_runme.java | 36 +- Examples/test-suite/java/primitive_ref_runme.java | 28 +- .../test-suite/java/rename_pcre_encoder_runme.java | 8 +- .../java/smart_pointer_const_overload_runme.java | 2 +- .../java/smart_pointer_ignore_runme.java | 19 + .../java/template_default_class_parms_runme.java | 5 + .../test-suite/java/template_nested_runme.java | 5 + .../template_templated_constructors_runme.java | 26 + .../java/template_typedef_typedef_runme.java | 26 + Examples/test-suite/java/unions_runme.java | 15 +- .../test-suite/java_director_exception_feature.i | 214 + .../java_director_exception_feature_nspace.i | 220 + Examples/test-suite/java_director_ptrclass.i | 107 + Examples/test-suite/java_lib_various.i | 4 + Examples/test-suite/java_typemaps_proxy.i | 8 +- Examples/test-suite/java_typemaps_typewrapper.i | 2 +- Examples/test-suite/javascript/Makefile.in | 136 + .../test-suite/javascript/abstract_access_runme.js | 6 + .../javascript/abstract_inherit_runme.js | 40 + .../javascript/abstract_typedef2_runme.js | 6 + .../javascript/abstract_typedef_runme.js | 8 + .../javascript/abstract_virtual_runme.js | 11 + .../test-suite/javascript/array_member_runme.js | 22 + .../test-suite/javascript/arrays_global_runme.js | 18 + Examples/test-suite/javascript/callback_runme.js | 30 + .../test-suite/javascript/char_binary_runme.js | 48 + .../test-suite/javascript/char_strings_runme.js | 11 + .../test-suite/javascript/class_ignore_runme.js | 6 + .../javascript/class_scope_weird_runme.js | 6 + .../test-suite/javascript/complextest_runme.js | 22 + Examples/test-suite/javascript/constover_runme.js | 33 + .../javascript/constructor_copy_runme.js | 42 + .../cpp11_strongly_typed_enumerations_runme.js | 165 + Examples/test-suite/javascript/cpp_enum_runme.js | 28 + .../test-suite/javascript/cpp_namespace_runme.js | 47 + Examples/test-suite/javascript/cpp_static_runme.js | 9 + .../javascript/director_alternating_runme.js | 5 + Examples/test-suite/javascript/disown_runme.js | 22 + .../test-suite/javascript/dynamic_cast_runme.js | 12 + Examples/test-suite/javascript/empty_c_runme.js | 1 + Examples/test-suite/javascript/empty_runme.js | 1 + .../test-suite/javascript/enum_template_runme.js | 8 + Examples/test-suite/javascript/infinity_runme.js | 5 + .../javascript/namespace_virtual_method_runme.js | 3 + .../javascript/node_template/binding.gyp.in | 30 + .../javascript/node_template/index.js.in | 1 + .../test-suite/javascript/nspace_extend_runme.js | 27 + Examples/test-suite/javascript/nspace_runme.js | 76 + .../test-suite/javascript/null_pointer_runme.js | 9 + .../test-suite/javascript/overload_copy_runme.js | 4 + .../test-suite/javascript/preproc_include_runme.js | 23 + Examples/test-suite/javascript/preproc_runme.js | 14 + Examples/test-suite/javascript/rename1_runme.js | 68 + Examples/test-suite/javascript/rename2_runme.js | 68 + Examples/test-suite/javascript/rename3_runme.js | 68 + Examples/test-suite/javascript/rename4_runme.js | 68 + .../test-suite/javascript/rename_scope_runme.js | 17 + .../test-suite/javascript/rename_simple_runme.js | 50 + .../test-suite/javascript/ret_by_value_runme.js | 8 + .../test-suite/javascript/string_simple_runme.js | 10 + .../test-suite/javascript/struct_value_runme.js | 11 + .../test-suite/javascript/template_static_runme.js | 3 + .../test-suite/javascript/typedef_class_runme.js | 7 + .../test-suite/javascript/typedef_inherit_runme.js | 23 + .../test-suite/javascript/typedef_scope_runme.js | 12 + .../test-suite/javascript/typemap_arrays_runme.js | 5 + .../test-suite/javascript/typemap_delete_runme.js | 5 + .../javascript/typemap_namespace_runme.js | 7 + .../javascript/typemap_ns_using_runme.js | 4 + Examples/test-suite/javascript/using1_runme.js | 4 + Examples/test-suite/javascript/using2_runme.js | 4 + Examples/test-suite/javascript/varargs_runme.js | 44 + Examples/test-suite/keyword_rename.i | 4 + Examples/test-suite/keyword_rename_c.i | 7 + Examples/test-suite/kwargs_feature.i | 22 +- Examples/test-suite/li_attribute_template.i | 28 +- Examples/test-suite/li_boost_array.i | 87 + Examples/test-suite/li_boost_intrusive_ptr.i | 15 +- Examples/test-suite/li_boost_shared_ptr.i | 37 +- .../test-suite/li_boost_shared_ptr_attribute.i | 46 + Examples/test-suite/li_boost_shared_ptr_bits.i | 88 +- Examples/test-suite/li_boost_shared_ptr_template.i | 4 +- Examples/test-suite/li_carrays_cpp.i | 28 + Examples/test-suite/li_cdata_carrays_cpp.i | 8 + Examples/test-suite/li_cdata_cpp.i | 8 + Examples/test-suite/li_cpointer_cpp.i | 10 + Examples/test-suite/li_std_auto_ptr.i | 62 + Examples/test-suite/li_std_combinations.i | 12 +- Examples/test-suite/li_std_container_typemaps.i | 132 + Examples/test-suite/li_std_except_as_class.i | 8 + Examples/test-suite/li_std_pair.i | 17 + Examples/test-suite/li_std_string.i | 10 + Examples/test-suite/li_std_string_extra.i | 6 + Examples/test-suite/li_std_vector.i | 32 + Examples/test-suite/li_std_vector_extra.i | 11 + Examples/test-suite/li_std_wstring.i | 6 + Examples/test-suite/li_stdint.i | 6 +- Examples/test-suite/li_swigtype_inout.i | 53 + Examples/test-suite/long_long.i | 6 + Examples/test-suite/lua/Makefile.in | 18 +- Examples/test-suite/lua/array_member_runme.lua | 30 + Examples/test-suite/lua/arrays_global_runme.lua | 14 + Examples/test-suite/lua/chartest_runme.lua | 14 + .../cpp11_strongly_typed_enumerations_runme.lua | 174 + Examples/test-suite/lua/cpp_basic_runme.lua | 27 + Examples/test-suite/lua/cpp_enum_runme.lua | 21 + Examples/test-suite/lua/cpp_namespace_runme.lua | 27 + Examples/test-suite/lua/cpp_nodefault_runme.lua | 24 + Examples/test-suite/lua/cpp_static_runme.lua | 16 + Examples/test-suite/lua/cpp_typedef_runme.lua | 23 + Examples/test-suite/lua/enum_plus_runme.lua | 11 + Examples/test-suite/lua/enum_rename_runme.lua | 11 + .../test-suite/lua/enum_scope_template_runme.lua | 12 + Examples/test-suite/lua/enum_template_runme.lua | 16 + Examples/test-suite/lua/enums_runme.lua | 8 + Examples/test-suite/lua/equality_runme.lua | 47 + .../lua/extend_constructor_destructor_runme.lua | 32 + Examples/test-suite/lua/extend_placement_runme.lua | 37 + Examples/test-suite/lua/extend_runme.lua | 28 + Examples/test-suite/lua/extend_template_runme.lua | 12 + .../test-suite/lua/extend_typedef_class_runme.lua | 37 + Examples/test-suite/lua/extend_variable_runme.lua | 29 + Examples/test-suite/lua/friends_runme.lua | 27 + Examples/test-suite/lua/funcptr_cpp_runme.lua | 19 + Examples/test-suite/lua/fvirtual_runme.lua | 17 + Examples/test-suite/lua/global_namespace_runme.lua | 58 + Examples/test-suite/lua/global_vars_runme.lua | 44 + Examples/test-suite/lua/grouping_runme.lua | 18 + Examples/test-suite/lua/iadd_runme.lua | 17 + Examples/test-suite/lua/import.lua | 6 +- Examples/test-suite/lua/inherit_missing_runme.lua | 14 + Examples/test-suite/lua/keyword_rename_c_runme.lua | 12 + Examples/test-suite/lua/keyword_rename_runme.lua | 12 + Examples/test-suite/lua/li_carrays_cpp_runme.lua | 29 + Examples/test-suite/lua/li_carrays_runme.lua | 20 +- Examples/test-suite/lua/li_std_vector_runme.lua | 2 +- .../test-suite/lua/lua_inherit_getitem_runme.lua | 12 + Examples/test-suite/lua/member_pointer_runme.lua | 39 +- .../test-suite/lua/nested_workaround_runme.lua | 22 + Examples/test-suite/lua/newobject1_runme.lua | 4 +- Examples/test-suite/lua/nspace_extend_runme.lua | 39 + Examples/test-suite/lua/nspace_runme.lua | 79 + .../test-suite/lua/operator_overload_runme.lua | 38 +- .../test-suite/lua/overload_complicated_runme.lua | 22 + Examples/test-suite/lua/refcount_runme.lua | 26 + Examples/test-suite/lua/rename_simple_runme.lua | 25 + .../test-suite/lua/smart_pointer_extend_runme.lua | 34 + .../test-suite/lua/smart_pointer_inherit_runme.lua | 18 + .../test-suite/lua/smart_pointer_multi_runme.lua | 23 + .../test-suite/lua/smart_pointer_not_runme.lua | 25 + .../test-suite/lua/smart_pointer_rename_runme.lua | 18 + .../test-suite/lua/smart_pointer_simple_runme.lua | 22 + .../lua/smart_pointer_templatemethods_runme.lua | 18 + .../test-suite/lua/static_const_member_2_runme.lua | 37 + .../test-suite/lua/static_const_member_runme.lua | 21 + .../test-suite/lua/template_construct_runme.lua | 10 + .../test-suite/lua/template_default_arg_runme.lua | 1 + Examples/test-suite/lua/template_extend1_runme.lua | 14 + Examples/test-suite/lua/template_extend2_runme.lua | 14 + Examples/test-suite/lua/template_inherit_runme.lua | 24 + Examples/test-suite/lua/template_static_runme.lua | 20 + Examples/test-suite/lua/valuewrapper_runme.lua | 17 + Examples/test-suite/lua/varargs_runme.lua | 18 + Examples/test-suite/lua_inherit_getitem.i | 19 + Examples/test-suite/member_funcptr_galore.i | 1 + .../test-suite/multiple_inheritance_abstract.i | 328 + .../test-suite/multiple_inheritance_interfaces.i | 66 + Examples/test-suite/multiple_inheritance_nspace.i | 338 + .../test-suite/multiple_inheritance_shared_ptr.i | 499 + Examples/test-suite/mzscheme/Makefile.in | 13 +- Examples/test-suite/namespace_class.i | 10 +- Examples/test-suite/namespace_typemap.i | 6 +- Examples/test-suite/naturalvar_more.i | 53 + Examples/test-suite/naturalvar_onoff.i | 29 + Examples/test-suite/nested.i | 55 +- Examples/test-suite/nested_class.i | 60 +- Examples/test-suite/nested_directors.i | 35 + Examples/test-suite/nested_extend_c.i | 106 + Examples/test-suite/nested_private.i | 32 + Examples/test-suite/nested_scope.i | 67 + Examples/test-suite/nested_structs.i | 23 +- Examples/test-suite/nested_template_base.i | 38 + Examples/test-suite/nested_workaround.i | 20 +- Examples/test-suite/nspace.i | 12 +- Examples/test-suite/nspace_extend.i | 4 +- Examples/test-suite/ocaml/Makefile.in | 32 +- Examples/test-suite/ocaml/makedebugtop | 0 Examples/test-suite/octave/Makefile.in | 27 +- .../cpp11_strongly_typed_enumerations_runme.m | 166 + .../test-suite/octave/default_constructor_runme.m | 27 +- Examples/test-suite/octave/director_detect_runme.m | 4 +- Examples/test-suite/octave/empty_c_runme.m | 2 + Examples/test-suite/octave/iadd_runme.m | 0 .../test-suite/octave/li_boost_shared_ptr_runme.m | 565 + Examples/test-suite/octave/li_carrays_cpp_runme.m | 10 + Examples/test-suite/octave/li_cpointer_cpp_runme.m | 12 + Examples/test-suite/octave/nested_structs_runme.m | 14 + .../test-suite/octave/overload_complicated_runme.m | 0 ...ad_extendc_runme.m => overload_extend2_runme.m} | 4 +- .../test-suite/octave/overload_extend_c_runme.m | 19 + Examples/test-suite/operator_overload.i | 115 +- Examples/test-suite/operator_overload_break.i | 16 + Examples/test-suite/overload_arrays.i | 148 + Examples/test-suite/overload_bool.i | 19 + .../{overload_extendc.i => overload_extend2.i} | 2 +- Examples/test-suite/overload_extend_c.i | 3 + Examples/test-suite/overload_polymorphic.i | 26 + Examples/test-suite/perl5/Makefile.in | 18 +- Examples/test-suite/perl5/README | 32 +- Examples/test-suite/perl5/char_binary_runme.pl | 5 +- Examples/test-suite/perl5/class_ignore_runme.pl | 0 Examples/test-suite/perl5/contract_runme.pl | 0 .../cpp11_strongly_typed_enumerations_runme.pl | 168 + .../test-suite/perl5/director_abstract_runme.pl | 62 + .../test-suite/perl5/director_alternating_runme.pl | 8 + Examples/test-suite/perl5/director_basic_runme.pl | 57 + .../test-suite/perl5/director_classes_runme.pl | 70 + .../test-suite/perl5/director_classic_runme.pl | 128 + .../test-suite/perl5/director_constructor_runme.pl | 46 + .../test-suite/perl5/director_default_runme.pl | 18 + Examples/test-suite/perl5/director_detect_runme.pl | 45 + Examples/test-suite/perl5/director_enum_runme.pl | 21 + .../test-suite/perl5/director_exception_runme.pl | 57 + Examples/test-suite/perl5/director_extend_runme.pl | 16 + .../test-suite/perl5/director_finalizer_runme.pl | 84 + Examples/test-suite/perl5/director_frob_runme.pl | 10 + Examples/test-suite/perl5/director_ignore_runme.pl | 25 + Examples/test-suite/perl5/director_nested_runme.pl | 59 + .../test-suite/perl5/director_primitives_runme.pl | 68 + .../test-suite/perl5/director_protected_runme.pl | 48 + Examples/test-suite/perl5/director_string_runme.pl | 34 + Examples/test-suite/perl5/director_unroll_runme.pl | 17 + Examples/test-suite/perl5/director_wombat_runme.pl | 53 + Examples/test-suite/perl5/enum_template_runme.pl | 0 Examples/test-suite/perl5/grouping_runme.pl | 0 .../test-suite/perl5/ignore_parameter_runme.pl | 0 Examples/test-suite/perl5/inherit_missing_runme.pl | 0 Examples/test-suite/perl5/li_carrays_cpp_runme.pl | 72 + Examples/test-suite/perl5/li_carrays_runme.pl | 4 +- .../test-suite/perl5/li_cdata_carrays_cpp_runme.pl | 14 + Examples/test-suite/perl5/li_std_except_runme.pl | 0 Examples/test-suite/perl5/minherit_runme.pl | 0 Examples/test-suite/perl5/naturalvar_runme.pl | 0 Examples/test-suite/perl5/overload_simple_runme.pl | 39 +- Examples/test-suite/perl5/preproc_runme.pl | 0 Examples/test-suite/perl5/primitive_types_runme.pl | 6 +- .../perl5/reference_global_vars_runme.pl | 0 Examples/test-suite/perl5/rename_scope_runme.pl | 0 .../test-suite/perl5/return_const_value_runme.pl | 0 Examples/test-suite/perl5/run-perl-test.pl | 0 Examples/test-suite/perl5/sizet_runme.pl | 0 Examples/test-suite/perl5/sneaky1_runme.pl | 0 .../perl5/template_typedef_cplx2_runme.pl | 0 Examples/test-suite/perl5/typedef_class_runme.pl | 0 Examples/test-suite/perl5/typename_runme.pl | 0 Examples/test-suite/perl5/using1_runme.pl | 0 Examples/test-suite/perl5/using2_runme.pl | 0 Examples/test-suite/perl5/wrapmacro_runme.pl | 43 +- Examples/test-suite/php/Makefile.in | 25 +- Examples/test-suite/php/arrays_runme.php | 1 + Examples/test-suite/php/autodoc_runme.php | 9 - Examples/test-suite/php/callback_runme.php | 9 + .../cpp11_strongly_typed_enumerations_runme.php | 169 + .../test-suite/php/director_exception_runme.php | 53 +- .../php/director_pass_by_value_runme.php | 24 + .../test-suite/php/director_protected_runme.php | 5 +- Examples/test-suite/php/director_thread_runme.php | 3 + Examples/test-suite/php/exception_order_runme.php | 2 +- Examples/test-suite/php/import_nomodule_runme.php | 2 +- Examples/test-suite/php/li_carrays_cpp_runme.php | 22 + Examples/test-suite/php/php_iterator_runme.php | 24 + .../test-suite/php/threads_exception_runme.php | 4 +- Examples/test-suite/php_iterator.i | 20 + Examples/test-suite/php_namewarn_rename.i | 10 + Examples/test-suite/pike/Makefile.in | 12 +- Examples/test-suite/preproc.i | 28 +- Examples/test-suite/preproc_constants.i | 10 + Examples/test-suite/preproc_defined.i | 16 + Examples/test-suite/preproc_line_file.i | 4 +- Examples/test-suite/primitive_types.i | 40 +- Examples/test-suite/python/Makefile.in | 95 +- .../test-suite/python/abstract_access_runme.py | 3 +- .../test-suite/python/abstract_typedef2_runme.py | 7 +- .../test-suite/python/abstract_typedef_runme.py | 9 +- Examples/test-suite/python/argcargvtest_runme.py | 29 +- Examples/test-suite/python/array_member_runme.py | 15 +- Examples/test-suite/python/arrays_global_runme.py | 8 +- Examples/test-suite/python/autodoc_runme.py | 506 +- Examples/test-suite/python/callback_runme.py | 18 +- Examples/test-suite/python/char_binary_runme.py | 24 +- .../test-suite/python/compactdefaultargs_runme.py | 10 +- Examples/test-suite/python/complextest_runme.py | 12 +- .../test-suite/python/constant_directive_runme.py | 28 + Examples/test-suite/python/constover_runme.py | 6 +- .../test-suite/python/constructor_copy_runme.py | 7 +- Examples/test-suite/python/contract_runme.py | 151 +- .../cpp11_alternate_function_syntax_runme.py | 14 + Examples/test-suite/python/cpp11_decltype_runme.py | 18 + .../python/cpp11_function_objects_runme.py | 28 + .../python/cpp11_initializer_list_extend_runme.py | 3 + .../python/cpp11_initializer_list_runme.py | 4 + .../test-suite/python/cpp11_li_std_array_runme.py | 163 + .../python/cpp11_null_pointer_constant_runme.py | 17 + .../python/cpp11_raw_string_literals_runme.py | 48 + .../test-suite/python/cpp11_result_of_runme.py | 11 + .../python/cpp11_rvalue_reference_runme.py | 27 + .../cpp11_strongly_typed_enumerations_runme.py | 165 + .../test-suite/python/cpp11_thread_local_runme.py | 37 + .../test-suite/python/cpp11_type_traits_runme.py | 7 + .../python/cpp11_uniform_initialization_runme.py | 21 + Examples/test-suite/python/cpp_enum_runme.py | 16 +- Examples/test-suite/python/cpp_namespace_runme.py | 12 +- Examples/test-suite/python/cpp_static_runme.py | 16 +- .../test-suite/python/default_arg_values_runme.py | 21 +- Examples/test-suite/python/default_args_c_runme.py | 6 + Examples/test-suite/python/default_args_runme.py | 220 +- .../test-suite/python/default_constructor_runme.py | 22 +- .../test-suite/python/director_abstract_runme.py | 87 +- .../python/director_alternating_runme.py | 2 +- Examples/test-suite/python/director_basic_runme.py | 69 +- .../test-suite/python/director_classic_runme.py | 143 +- .../test-suite/python/director_detect_runme.py | 36 +- Examples/test-suite/python/director_enum_runme.py | 8 +- .../test-suite/python/director_exception_runme.py | 83 +- .../test-suite/python/director_extend_runme.py | 12 +- .../test-suite/python/director_finalizer_runme.py | 27 +- Examples/test-suite/python/director_frob_runme.py | 6 +- .../test-suite/python/director_keywords_runme.py | 4 + .../test-suite/python/director_nested_runme.py | 61 +- .../python/director_pass_by_value_runme.py | 13 + .../test-suite/python/director_profile_runme.py | 48 +- .../test-suite/python/director_property_runme.py | 19 + .../test-suite/python/director_protected_runme.py | 143 +- .../test-suite/python/director_smartptr_runme.py | 37 + Examples/test-suite/python/director_stl_runme.py | 36 +- .../test-suite/python/director_string_runme.py | 26 +- .../test-suite/python/director_thread_runme.py | 4 +- .../test-suite/python/director_unroll_runme.py | 11 +- .../test-suite/python/director_wstring_runme.py | 24 +- Examples/test-suite/python/disown_runme.py | 2 +- Examples/test-suite/python/dynamic_cast_runme.py | 1 - Examples/test-suite/python/empty_c_runme.py | 1 + Examples/test-suite/python/enum_forward_runme.py | 14 +- Examples/test-suite/python/enum_template_runme.py | 5 +- Examples/test-suite/python/enums_runme.py | 9 +- .../test-suite/python/exception_classname_runme.py | 4 + .../test-suite/python/exception_order_runme.py | 45 +- .../test-suite/python/extend_placement_runme.py | 20 +- Examples/test-suite/python/extern_c_runme.py | 1 - Examples/test-suite/python/file_test_runme.py | 2 +- Examples/test-suite/python/friends_runme.py | 27 +- Examples/test-suite/python/funcptr_cpp_runme.py | 9 +- Examples/test-suite/python/fvirtual_runme.py | 5 +- .../test-suite/python/global_functions_runme.py | 52 + .../test-suite/python/global_namespace_runme.py | 42 +- Examples/test-suite/python/global_ns_arg_runme.py | 1 - Examples/test-suite/python/global_vars_runme.py | 34 + Examples/test-suite/python/iadd_runme.py | 2 +- Examples/test-suite/python/implicittest_runme.py | 45 +- .../test-suite/python/import_nomodule_runme.py | 9 +- Examples/test-suite/python/import_stl_runme.py | 7 +- Examples/test-suite/python/imports_runme.py | 2 +- Examples/test-suite/python/inctest_runme.py | 27 +- Examples/test-suite/python/inout_runme.py | 27 +- Examples/test-suite/python/inplaceadd_runme.py | 10 +- Examples/test-suite/python/input_runme.py | 18 +- .../test-suite/python/keyword_rename_c_runme.py | 4 + Examples/test-suite/python/kwargs_feature_runme.py | 66 +- Examples/test-suite/python/langobj_runme.py | 2 +- Examples/test-suite/python/li_attribute_runme.py | 57 +- .../python/li_attribute_template_runme.py | 57 +- Examples/test-suite/python/li_boost_array_runme.py | 55 + .../python/li_boost_shared_ptr_bits_runme.py | 31 +- .../test-suite/python/li_boost_shared_ptr_runme.py | 1083 +- .../python/li_boost_shared_ptr_template_runme.py | 20 +- Examples/test-suite/python/li_carrays_cpp_runme.py | 9 + Examples/test-suite/python/li_cdata_cpp_runme.py | 9 + Examples/test-suite/python/li_cdata_runme.py | 3 +- .../test-suite/python/li_cpointer_cpp_runme.py | 10 + Examples/test-suite/python/li_cpointer_runme.py | 2 +- Examples/test-suite/python/li_cstring_runme.py | 9 +- Examples/test-suite/python/li_cwstring_runme.py | 7 +- Examples/test-suite/python/li_implicit_runme.py | 7 +- .../test-suite/python/li_std_auto_ptr_runme.py | 17 + Examples/test-suite/python/li_std_carray_runme.py | 16 +- .../python/li_std_containers_int_runme.py | 363 +- .../python/li_std_except_as_class_runme.py | 36 +- .../test-suite/python/li_std_map_member_runme.py | 4 +- Examples/test-suite/python/li_std_map_runme.py | 36 +- .../test-suite/python/li_std_pair_extra_runme.py | 47 +- .../test-suite/python/li_std_pair_using_runme.py | 3 +- Examples/test-suite/python/li_std_set_runme.py | 20 +- Examples/test-suite/python/li_std_stream_runme.py | 7 +- .../test-suite/python/li_std_string_extra_runme.py | 92 +- .../test-suite/python/li_std_vector_enum_runme.py | 12 +- .../test-suite/python/li_std_vector_extra_runme.py | 111 +- .../test-suite/python/li_std_vector_ptr_runme.py | 1 - Examples/test-suite/python/li_std_wstream_runme.py | 7 +- Examples/test-suite/python/li_std_wstring_runme.py | 63 +- Examples/test-suite/python/member_pointer_runme.py | 26 +- .../test-suite/python/memberin_extend_c_runme.py | 2 +- Examples/test-suite/python/minherit_runme.py | 40 +- Examples/test-suite/python/multi_import_runme.py | 10 +- .../test-suite/python/namespace_class_runme.py | 30 +- .../test-suite/python/namespace_typemap_runme.py | 2 +- .../python/nested_template_base_runme.py | 13 + .../test-suite/python/nested_workaround_runme.py | 4 +- .../test-suite/python/operator_overload_runme.py | 77 + Examples/test-suite/python/operbool_runme.py | 1 - Examples/test-suite/python/overload_bool_runme.py | 54 + .../python/overload_complicated_runme.py | 26 +- ..._extendc_runme.py => overload_extend2_runme.py} | 15 +- .../test-suite/python/overload_extend_c_runme.py | 13 + .../test-suite/python/overload_extend_runme.py | 3 +- .../test-suite/python/overload_numeric_runme.py | 17 +- .../test-suite/python/overload_rename_runme.py | 7 +- .../test-suite/python/overload_simple_runme.py | 5 +- .../test-suite/python/overload_subtype_runme.py | 1 - .../python/overload_template_fast_runme.py | 92 +- .../test-suite/python/overload_template_runme.py | 82 +- .../test-suite/python/pointer_reference_runme.py | 8 +- .../test-suite/python/preproc_defined_runme.py | 2 +- .../test-suite/python/preproc_include_runme.py | 15 +- Examples/test-suite/python/preproc_runme.py | 12 +- Examples/test-suite/python/primitive_ref_runme.py | 2 +- .../test-suite/python/primitive_types_runme.py | 583 +- Examples/test-suite/python/profiletest_runme.py | 46 +- Examples/test-suite/python/profiletestc_runme.py | 88 +- .../python/python_abstractbase_runme3.py | 7 +- Examples/test-suite/python/python_append_runme.py | 26 +- .../python/python_destructor_exception_runme.py | 64 + .../test-suite/python/python_docstring_runme.py | 100 + .../test-suite/python/python_nondynamic_runme.py | 44 +- .../python/python_overload_simple_cast_runme.py | 31 +- Examples/test-suite/python/python_pybuf_runme3.py | 33 +- .../test-suite/python/python_pythoncode_runme.py | 5 + .../test-suite/python/python_richcompare_runme.py | 76 +- .../python/python_strict_unicode_runme.py | 79 + Examples/test-suite/python/python_threads_runme.py | 11 + .../python/python_varargs_typemap_runme.py | 4 +- Examples/test-suite/python/refcount_runme.py | 26 +- .../python/reference_global_vars_runme.py | 9 +- .../test-suite/python/rename_pcre_encoder_runme.py | 13 +- .../test-suite/python/rename_predicates_runme.py | 42 + .../python/rename_rstrip_encoder_runme.py | 5 + .../python/rename_strip_encoder_runme.py | 1 - .../test-suite/python/return_const_value_runme.py | 12 +- .../python/smart_pointer_const_overload_runme.py | 217 +- .../python/smart_pointer_extend_runme.py | 14 +- .../python/smart_pointer_member_runme.py | 27 +- .../test-suite/python/smart_pointer_multi_runme.py | 1 - .../python/smart_pointer_multi_typedef_runme.py | 1 - .../test-suite/python/smart_pointer_not_runme.py | 6 +- .../python/smart_pointer_overload_runme.py | 2 - .../python/smart_pointer_rename_runme.py | 2 +- .../smart_pointer_templatevariables_runme.py | 9 +- Examples/test-suite/python/sneaky1_runme.py | 8 +- .../python/special_variable_macros_runme.py | 15 +- .../python/static_const_member_2_runme.py | 2 +- Examples/test-suite/python/std_containers_runme.py | 91 +- .../python/struct_initialization_runme.py | 13 +- Examples/test-suite/python/struct_value_runme.py | 29 +- Examples/test-suite/python/swigobject_runme.py | 15 +- .../test-suite/python/template_classes_runme.py | 44 + ...template_default_arg_overloaded_extend_runme.py | 20 + .../template_default_arg_overloaded_runme.py | 47 + .../python/template_default_arg_runme.py | 47 +- .../test-suite/python/template_inherit_runme.py | 1 - .../test-suite/python/template_matrix_runme.py | 10 +- Examples/test-suite/python/template_ns4_runme.py | 4 +- Examples/test-suite/python/template_ns_runme.py | 4 +- .../test-suite/python/template_opaque_runme.py | 1 - .../test-suite/python/template_ref_type_runme.py | 2 +- .../test-suite/python/template_static_runme.py | 2 +- .../python/template_tbase_template_runme.py | 2 +- .../python/template_type_namespace_runme.py | 3 +- .../python/template_typedef_cplx2_runme.py | 79 +- .../python/template_typedef_cplx3_runme.py | 8 +- .../python/template_typedef_cplx4_runme.py | 8 +- .../python/template_typedef_cplx_runme.py | 72 +- .../python/template_typedef_import_runme.py | 8 +- .../test-suite/python/template_typedef_runme.py | 36 +- .../python/template_typemaps_typedef2_runme.py | 5 +- .../python/template_typemaps_typedef_runme.py | 5 +- .../test-suite/python/threads_exception_runme.py | 56 +- Examples/test-suite/python/typedef_class_runme.py | 10 +- Examples/test-suite/python/typedef_scope_runme.py | 6 +- .../test-suite/python/typedef_typedef_runme.py | 5 + Examples/test-suite/python/typemap_arrays_runme.py | 1 - .../test-suite/python/typemap_namespace_runme.py | 1 - .../test-suite/python/typemap_out_optimal_runme.py | 3 +- .../python/typemap_qualifier_strip_runme.py | 1 - Examples/test-suite/python/typename_runme.py | 9 +- .../test-suite/python/types_directive_runme.py | 11 +- .../test-suite/python/unicode_strings_runme.py | 23 + Examples/test-suite/python/unions_runme.py | 13 +- .../test-suite/python/using_composition_runme.py | 19 +- Examples/test-suite/python/using_extend_runme.py | 16 +- Examples/test-suite/python/using_inherit_runme.py | 25 +- .../test-suite/python/varargs_overload_runme.py | 1 - Examples/test-suite/python/varargs_runme.py | 2 +- .../test-suite/python/virtual_derivation_runme.py | 3 +- Examples/test-suite/python/virtual_poly_runme.py | 14 +- Examples/test-suite/python/voidtest_runme.py | 3 +- Examples/test-suite/python/wrapmacro_runme.py | 4 +- Examples/test-suite/python_abstractbase.i | 14 + Examples/test-suite/python_append.i | 30 +- Examples/test-suite/python_destructor_exception.i | 19 + Examples/test-suite/python_docstring.i | 98 + Examples/test-suite/python_nondynamic.i | 2 +- Examples/test-suite/python_pythoncode.i | 31 + Examples/test-suite/python_strict_unicode.i | 41 + Examples/test-suite/python_threads.i | 40 + Examples/test-suite/python_varargs_typemap.i | 2 +- Examples/test-suite/r/Makefile.in | 30 +- Examples/test-suite/r/arrays_dimensionless_runme.R | 4 +- Examples/test-suite/r/funcptr_runme.R | 4 +- Examples/test-suite/r/ignore_parameter_runme.R | 4 +- Examples/test-suite/r/integers_runme.R | 4 +- Examples/test-suite/r/li_std_vector_runme.R | 19 + Examples/test-suite/r/overload_method_runme.R | 4 +- Examples/test-suite/r/preproc_constants_runme.R | 12 + Examples/test-suite/r/r_copy_struct_runme.R | 4 +- Examples/test-suite/r/r_legacy_runme.R | 4 +- Examples/test-suite/r/r_sexp_runme.R | 4 +- Examples/test-suite/r/rename_simple_runme.R | 4 +- Examples/test-suite/r/simple_array_runme.R | 3 +- Examples/test-suite/r/unions_runme.R | 3 +- Examples/test-suite/r/unittest.R | 4 +- Examples/test-suite/r_copy_struct.i | 2 +- Examples/test-suite/r_overload_array.i | 7 +- Examples/test-suite/rename.h | 14 + Examples/test-suite/rename4.i | 12 + Examples/test-suite/rename_pcre_encoder.i | 13 +- Examples/test-suite/rename_predicates.i | 71 + Examples/test-suite/rename_rstrip_encoder.i | 15 + Examples/test-suite/rename_simple.i | 1 + Examples/test-suite/ruby/Makefile.in | 20 +- Examples/test-suite/ruby/abstract_access_runme.rb | 0 Examples/test-suite/ruby/access_change_runme.rb | 0 Examples/test-suite/ruby/add_link_runme.rb | 0 .../test-suite/ruby/anonymous_bitfield_runme.rb | 0 .../test-suite/ruby/apply_signed_char_runme.rb | 0 Examples/test-suite/ruby/apply_strings_runme.rb | 0 Examples/test-suite/ruby/argout_runme.rb | 0 Examples/test-suite/ruby/arrays_runme.rb | 0 Examples/test-suite/ruby/cast_operator_runme.rb | 0 Examples/test-suite/ruby/casts_runme.rb | 0 Examples/test-suite/ruby/check_missing_tests.rb | 0 Examples/test-suite/ruby/class_ignore_runme.rb | 0 Examples/test-suite/ruby/const_const_runme.rb | 0 Examples/test-suite/ruby/constover_runme.rb | 0 .../test-suite/ruby/cpp11_li_std_array_runme.rb | 134 + .../cpp11_strongly_typed_enumerations_runme.rb | 177 + Examples/test-suite/ruby/cpp_namespace_runme.rb | 0 .../test-suite/ruby/default_constructor_runme.rb | 3 - .../test-suite/ruby/director_smartptr_runme.rb | 54 + Examples/test-suite/ruby/dynamic_cast_runme.rb | 0 Examples/test-suite/ruby/enum_thorough_runme.rb | 0 Examples/test-suite/ruby/function_typedef_runme.rb | 0 Examples/test-suite/ruby/imports_runme.rb | 0 Examples/test-suite/ruby/integers_runme.rb | 0 Examples/test-suite/ruby/li_boost_array_runme.rb | 70 + .../ruby/li_boost_shared_ptr_bits_runme.rb | 32 + .../test-suite/ruby/li_boost_shared_ptr_runme.rb | 614 + .../ruby/li_boost_shared_ptr_template_runme.rb | 45 + Examples/test-suite/ruby/li_carrays_cpp_runme.rb | 36 + Examples/test-suite/ruby/li_cstring_runme.rb | 0 Examples/test-suite/ruby/li_math_runme.rb | 0 Examples/test-suite/ruby/li_std_functors_runme.rb | 0 Examples/test-suite/ruby/li_std_map_runme.rb | 0 Examples/test-suite/ruby/li_std_multimap_runme.rb | 0 Examples/test-suite/ruby/li_std_pair_runme.rb | 0 Examples/test-suite/ruby/li_std_queue_runme.rb | 0 Examples/test-suite/ruby/li_std_set_runme.rb | 0 Examples/test-suite/ruby/li_std_speed2_runme.rb | 0 Examples/test-suite/ruby/li_std_stack_runme.rb | 0 Examples/test-suite/ruby/li_std_stream_runme.rb | 0 .../test-suite/ruby/li_std_vector_enum_runme.rb | 0 Examples/test-suite/ruby/li_std_vector_runme.rb | 139 +- .../test-suite/ruby/namespace_typemap_runme.rb | 0 Examples/test-suite/ruby/overload_bool_runme.rb | 88 + Examples/test-suite/ruby/overload_copy_runme.rb | 0 Examples/test-suite/ruby/overload_extend2_runme.rb | 18 + ...extendc_runme.rb => overload_extend_c_runme.rb} | 5 +- Examples/test-suite/ruby/overload_extend_runme.rb | 0 Examples/test-suite/ruby/overload_simple_runme.rb | 0 .../test-suite/ruby/overload_template_runme.rb | 0 Examples/test-suite/ruby/primitive_ref_runme.rb | 0 .../test-suite/ruby/ruby_li_std_speed_runme.rb | 0 .../test-suite/ruby/ruby_manual_proxy_runme.rb | 49 + .../ruby/ruby_minherit_shared_ptr_runme.rb | 28 + Examples/test-suite/ruby/sneaky1_runme.rb | 0 Examples/test-suite/ruby/std_containers_runme.rb | 0 Examples/test-suite/ruby/stl_new_runme.rb | 0 Examples/test-suite/ruby/swig_assert.rb | 2 + Examples/test-suite/ruby/swig_gc.rb | 0 Examples/test-suite/ruby/template_inherit_runme.rb | 0 Examples/test-suite/ruby/template_ns4_runme.rb | 0 Examples/test-suite/ruby/template_ns_runme.rb | 0 Examples/test-suite/ruby/template_rename_runme.rb | 0 Examples/test-suite/ruby/typedef_inherit_runme.rb | 0 Examples/test-suite/ruby/typedef_scope_runme.rb | 0 .../test-suite/ruby/typemap_namespace_runme.rb | 0 Examples/test-suite/ruby/typename_runme.rb | 0 Examples/test-suite/ruby_manual_proxy.i | 66 + Examples/test-suite/ruby_minherit_shared_ptr.i | 39 + Examples/test-suite/schemerunme/integers.scm | 12 +- .../test-suite/schemerunme/overload_extend_c.scm | 12 + Examples/test-suite/scilab/Makefile.in | 90 + .../test-suite/scilab/abstract_access_runme.sci | 16 + .../scilab/abstract_inherit_ok_runme.sci | 11 + .../test-suite/scilab/abstract_inherit_runme.sci | 10 + .../test-suite/scilab/abstract_signature_runme.sci | 10 + .../test-suite/scilab/abstract_typedef2_runme.sci | 15 + .../test-suite/scilab/abstract_typedef_runme.sci | 17 + .../test-suite/scilab/abstract_virtual_runme.sci | 27 + Examples/test-suite/scilab/access_change_runme.sci | 39 + Examples/test-suite/scilab/add_link_runme.sci | 27 + Examples/test-suite/scilab/aggregate_runme.sci | 21 + Examples/test-suite/scilab/allowexcept_runme.sci | 5 + Examples/test-suite/scilab/allprotected_runme.sci | 80 + .../test-suite/scilab/anonymous_bitfield_runme.sci | 60 + .../test-suite/scilab/apply_signed_char_runme.sci | 43 + Examples/test-suite/scilab/apply_strings_runme.sci | 45 + Examples/test-suite/scilab/array_member_runme.sci | 16 + .../scilab/arrays_dimensionless_runme.sci | 55 + Examples/test-suite/scilab/arrays_global_runme.sci | 54 + .../scilab/arrays_global_twodim_runme.sci | 12 + Examples/test-suite/scilab/bools_runme.sci | 20 + Examples/test-suite/scilab/char_constant_runme.sci | 9 + Examples/test-suite/scilab/constover_runme.sci | 22 + .../test-suite/scilab/constructor_copy_runme.sci | 36 + Examples/test-suite/scilab/cpp_basic_runme.sci | 64 + Examples/test-suite/scilab/cpp_enum_runme.sci | 10 + Examples/test-suite/scilab/default_args_runme.sci | 67 + .../scilab/default_constructor_runme.sci | 104 + Examples/test-suite/scilab/empty_c_runme.sci | 3 + Examples/test-suite/scilab/empty_runme.sci | 3 + Examples/test-suite/scilab/enums_runme.sci | 39 + Examples/test-suite/scilab/funcptr_cpp_runme.sci | 8 + Examples/test-suite/scilab/funcptr_runme.sci | 6 + Examples/test-suite/scilab/global_vars_runme.sci | 31 + Examples/test-suite/scilab/inctest_runme.sci | 20 + .../test-suite/scilab/inherit_missing_runme.sci | 15 + Examples/test-suite/scilab/inout_runme.sci | 15 + Examples/test-suite/scilab/integers_runme.sci | 29 + .../test-suite/scilab/li_carrays_cpp_runme.sci | 11 + Examples/test-suite/scilab/li_carrays_runme.sci | 11 + .../test-suite/scilab/li_cpointer_cpp_runme.sci | 8 + Examples/test-suite/scilab/li_cpointer_runme.sci | 8 + Examples/test-suite/scilab/li_math_runme.sci | 9 + .../scilab/li_std_container_typemaps_runme.sci | 108 + Examples/test-suite/scilab/li_std_deque_runme.sci | 49 + Examples/test-suite/scilab/li_std_except_runme.sci | 33 + Examples/test-suite/scilab/li_std_pair_runme.sci | 38 + .../scilab/li_std_string_extra_runme.sci | 58 + Examples/test-suite/scilab/li_std_vector_runme.sci | 12 + Examples/test-suite/scilab/li_typemaps_runme.sci | 116 + .../test-suite/scilab/member_pointer_runme.sci | 20 + Examples/test-suite/scilab/name_runme.sci | 11 + .../test-suite/scilab/nested_structs_runme.sci | 34 + Examples/test-suite/scilab/newobject2_runme.sci | 31 + Examples/test-suite/scilab/null_pointer_runme.sci | 7 + .../test-suite/scilab/operator_overload_runme.sci | 82 + .../test-suite/scilab/overload_arrays_runme.sci | 46 + .../scilab/overload_complicated_runme.sci | 25 + Examples/test-suite/scilab/overload_copy_runme.sci | 10 + .../test-suite/scilab/overload_extend2_runme.sci | 15 + .../test-suite/scilab/overload_extend_c_runme.sci | 13 + .../test-suite/scilab/overload_extend_runme.sci | 13 + .../test-suite/scilab/overload_numeric_runme.sci | 16 + .../scilab/overload_polymorphic_runme.sci | 11 + .../test-suite/scilab/overload_simple_runme.sci | 75 + .../test-suite/scilab/overload_subtype_runme.sci | 13 + .../test-suite/scilab/preproc_constants_runme.sci | 30 + Examples/test-suite/scilab/preproc_runme.sci | 8 + Examples/test-suite/scilab/primitive_ref_runme.sci | 24 + .../test-suite/scilab/primitive_types_runme.sci | 57 + Examples/test-suite/scilab/ret_by_value_runme.sci | 28 + .../test-suite/scilab/return_const_value_runme.sci | 11 + Examples/test-suite/scilab/scilab_consts_runme.sci | 35 + Examples/test-suite/scilab/scilab_enums_runme.sci | 27 + .../scilab/scilab_identifier_name_runme.sci | 29 + .../test-suite/scilab/scilab_li_matrix_runme.sci | 67 + .../test-suite/scilab/scilab_multivalue_runme.sci | 87 + .../scilab_pointer_conversion_functions_runme.sci | 18 + Examples/test-suite/scilab/simple_array_runme.sci | 12 + Examples/test-suite/scilab/sizet_runme.sci | 11 + .../scilab/smart_pointer_simple_runme.sci | 13 + Examples/test-suite/scilab/sneaky1_runme.sci | 31 + .../scilab/struct_initialization_runme.sci | 15 + Examples/test-suite/scilab/struct_rename_runme.sci | 11 + Examples/test-suite/scilab/struct_value_runme.sci | 16 + Examples/test-suite/scilab/swigtest.quit | 2 + Examples/test-suite/scilab/swigtest.start | 57 + .../test-suite/scilab/template_classes_runme.sci | 8 + Examples/test-suite/scilab/template_ns_runme.sci | 15 + .../test-suite/scilab/template_rename_runme.sci | 15 + .../test-suite/scilab/template_static_runme.sci | 8 + .../test-suite/scilab/throw_exception_runme.sci | 23 + .../test-suite/scilab/typedef_struct_cpp_runme.sci | 29 + .../test-suite/scilab/typedef_struct_runme.sci | 29 + .../test-suite/scilab/union_parameter_runme.sci | 35 + Examples/test-suite/scilab/unions_runme.sci | 23 + .../test-suite/scilab/varargs_overload_runme.sci | 21 + Examples/test-suite/scilab/varargs_runme.sci | 17 + Examples/test-suite/scilab/voidtest_runme.sci | 22 + Examples/test-suite/scilab_consts.i | 52 + Examples/test-suite/scilab_enums.i | 38 + Examples/test-suite/scilab_identifier_name.i | 53 + Examples/test-suite/scilab_li_matrix.i | 161 + Examples/test-suite/scilab_multivalue.i | 123 + .../scilab_pointer_conversion_functions.i | 18 + Examples/test-suite/sizeof_pointer.i | 5 +- Examples/test-suite/smart_pointer_const_overload.i | 2 +- Examples/test-suite/smart_pointer_ignore.i | 33 + Examples/test-suite/smart_pointer_inherit.i | 1 + .../smart_pointer_template_defaults_overload.i | 56 + .../test-suite/smart_pointer_templatemethods.i | 2 +- Examples/test-suite/special_variable_attributes.i | 170 + Examples/test-suite/special_variable_macros.i | 2 +- Examples/test-suite/std_containers.i | 3 +- Examples/test-suite/string_constants.i | 44 + Examples/test-suite/string_simple.i | 13 + Examples/test-suite/struct_initialization.i | 2 +- Examples/test-suite/tcl/Makefile.in | 15 +- .../cpp11_strongly_typed_enumerations_runme.tcl | 172 + Examples/test-suite/template_classes.i | 3 + Examples/test-suite/template_default_arg.i | 2 +- .../test-suite/template_default_arg_overloaded.i | 67 + .../template_default_arg_overloaded_extend.i | 44 + Examples/test-suite/template_default_class_parms.i | 46 + Examples/test-suite/template_keyword_in_type.i | 42 + Examples/test-suite/template_matrix.i | 1 + Examples/test-suite/template_nested.i | 42 +- Examples/test-suite/template_opaque.i | 1 + Examples/test-suite/template_private_assignment.i | 24 + Examples/test-suite/template_template_parameters.i | 6 +- .../test-suite/template_templated_constructors.i | 47 + Examples/test-suite/template_typedef_inherit.i | 6 +- Examples/test-suite/template_typedef_typedef.i | 43 + Examples/test-suite/template_typemaps.i | 18 +- ...plate_using_directive_and_declaration_forward.i | 58 + .../testdir/go_subdir_import/go_subdir_import_c.i | 12 + Examples/test-suite/threads_exception.i | 6 + Examples/test-suite/throw_exception.i | 32 +- Examples/test-suite/typedef_struct_cpp.i | 3 + Examples/test-suite/typedef_typedef.i | 37 + Examples/test-suite/typemap_array_qualifiers.i | 20 +- Examples/test-suite/typemap_directorout.i | 20 +- Examples/test-suite/typemap_manyargs.i | 1 + Examples/test-suite/typemap_subst.i | 2 + Examples/test-suite/typemap_variables.i | 40 +- Examples/test-suite/typemap_various.i | 15 +- Examples/test-suite/uffi/Makefile.in | 16 +- Examples/test-suite/unicode_strings.i | 23 + Examples/test-suite/unions.i | 10 +- .../using_directive_and_declaration_forward.i | 60 + Examples/test-suite/using_protected.i | 1 + Examples/test-suite/varargs_overload.i | 2 + Examples/test-suite/virtual_vs_nonvirtual_base.i | 1 + Examples/test-suite/voidtest.i | 2 - Examples/test-suite/wallkw.i | 2 +- Examples/xml/Makefile.in | 15 +- Lib/allegrocl/allegrocl.swg | 15 +- Lib/allkw.swg | 11 +- Lib/carrays.i | 4 +- Lib/cdata.i | 33 + Lib/cffi/cffi.swg | 9 +- Lib/chicken/chicken.swg | 36 +- Lib/chicken/chickenrun.swg | 4 +- Lib/csharp/arrays_csharp.i | 12 +- Lib/csharp/boost_intrusive_ptr.i | 1021 +- Lib/csharp/boost_shared_ptr.i | 72 +- Lib/csharp/csharp.swg | 193 +- Lib/csharp/csharphead.swg | 50 +- Lib/csharp/csharpkw.swg | 3 + Lib/csharp/director.swg | 25 +- Lib/csharp/enums.swg | 8 +- Lib/csharp/enumsimple.swg | 8 +- Lib/csharp/enumtypesafe.swg | 10 +- Lib/csharp/std_auto_ptr.i | 25 + Lib/csharp/std_map.i | 71 +- Lib/csharp/std_vector.i | 60 +- Lib/csharp/std_wstring.i | 4 +- Lib/csharp/swiginterface.i | 63 + Lib/csharp/swigtype_inout.i | 34 + Lib/csharp/typemaps.i | 6 +- Lib/csharp/wchar.i | 12 +- Lib/d/boost_shared_ptr.i | 4 +- Lib/d/carrays.i | 4 +- Lib/d/dclassgen.swg | 8 +- Lib/d/denums.swg | 8 +- Lib/d/dhead.swg | 76 +- Lib/d/director.swg | 23 +- Lib/d/dmemberfunctionpointers.swg | 14 +- Lib/d/dswigtype.swg | 4 +- Lib/d/std_vector.i | 12 +- Lib/director_common.swg | 15 + Lib/exception.i | 2 +- Lib/gcj/cni.i | 6 +- Lib/go/cdata.i | 45 +- Lib/go/go.swg | 313 +- Lib/go/goruntime.swg | 321 +- Lib/go/gostring.swg | 29 + Lib/go/std_string.i | 54 +- Lib/go/std_vector.i | 2 +- Lib/go/typemaps.i | 6 + Lib/guile/Makefile | 1 - Lib/guile/guile_scm_run.swg | 18 +- Lib/guile/std_map.i | 138 +- Lib/guile/std_pair.i | 16 +- Lib/guile/std_vector.i | 34 +- Lib/guile/typemaps.i | 29 +- Lib/inttypes.i | 8 +- Lib/java/arrays_java.i | 6 +- Lib/java/boost_intrusive_ptr.i | 8 +- Lib/java/boost_shared_ptr.i | 6 +- Lib/java/director.swg | 239 +- Lib/java/enums.swg | 1 - Lib/java/enumtypesafe.swg | 1 - Lib/java/java.swg | 117 +- Lib/java/std_array.i | 42 + Lib/java/std_auto_ptr.i | 27 + Lib/java/std_string.i | 10 +- Lib/java/std_vector.i | 2 +- Lib/java/swiginterface.i | 74 + Lib/java/typemaps.i | 14 +- Lib/java/various.i | 46 +- Lib/javascript/jsc/arrays_javascript.i | 123 + Lib/javascript/jsc/ccomplex.i | 26 + Lib/javascript/jsc/cdata.i | 1 + Lib/javascript/jsc/complex.i | 6 + Lib/javascript/jsc/exception.i | 1 + Lib/javascript/jsc/javascript.swg | 19 + Lib/javascript/jsc/javascriptcode.swg | 428 + Lib/javascript/jsc/javascriptcomplex.swg | 146 + Lib/javascript/jsc/javascriptfragments.swg | 23 + Lib/javascript/jsc/javascripthelpers.swg | 69 + Lib/javascript/jsc/javascriptinit.swg | 67 + Lib/javascript/jsc/javascriptkw.swg | 40 + Lib/javascript/jsc/javascriptprimtypes.swg | 192 + Lib/javascript/jsc/javascriptrun.swg | 334 + Lib/javascript/jsc/javascriptruntime.swg | 19 + Lib/javascript/jsc/javascriptstrings.swg | 185 + Lib/javascript/jsc/javascripttypemaps.swg | 54 + Lib/javascript/jsc/std_common.i | 5 + Lib/javascript/jsc/std_complex.i | 19 + Lib/javascript/jsc/std_deque.i | 1 + Lib/javascript/jsc/std_except.i | 1 + Lib/javascript/jsc/std_map.i | 74 + Lib/javascript/jsc/std_pair.i | 34 + Lib/javascript/jsc/std_string.i | 1 + Lib/javascript/jsc/std_vector.i | 85 + Lib/javascript/jsc/stl.i | 10 + Lib/javascript/jsc/typemaps.i | 148 + Lib/javascript/v8/arrays_javascript.i | 125 + Lib/javascript/v8/ccomplex.i | 26 + Lib/javascript/v8/cdata.i | 1 + Lib/javascript/v8/complex.i | 6 + Lib/javascript/v8/exception.i | 1 + Lib/javascript/v8/javascript.swg | 19 + Lib/javascript/v8/javascriptcode.swg | 493 + Lib/javascript/v8/javascriptcomplex.swg | 124 + Lib/javascript/v8/javascriptfragments.swg | 23 + Lib/javascript/v8/javascripthelpers.swg | 88 + Lib/javascript/v8/javascriptinit.swg | 115 + Lib/javascript/v8/javascriptkw.swg | 40 + Lib/javascript/v8/javascriptprimtypes.swg | 206 + Lib/javascript/v8/javascriptrun.swg | 621 + Lib/javascript/v8/javascriptruntime.swg | 66 + Lib/javascript/v8/javascriptstrings.swg | 59 + Lib/javascript/v8/javascripttypemaps.swg | 43 + Lib/javascript/v8/std_common.i | 5 + Lib/javascript/v8/std_complex.i | 19 + Lib/javascript/v8/std_deque.i | 1 + Lib/javascript/v8/std_except.i | 1 + Lib/javascript/v8/std_map.i | 74 + Lib/javascript/v8/std_pair.i | 33 + Lib/javascript/v8/std_string.i | 1 + Lib/javascript/v8/std_vector.i | 85 + Lib/javascript/v8/stl.i | 10 + Lib/javascript/v8/typemaps.i | 148 + Lib/lua/lua.swg | 14 +- Lib/lua/lua_fnptr.i | 1 - Lib/lua/luakw.swg | 67 + Lib/lua/luarun.swg | 1461 +- Lib/lua/luaruntime.swg | 44 +- Lib/lua/luatypemaps.swg | 29 +- Lib/lua/typemaps.i | 2 +- Lib/lua/wchar.i | 4 +- Lib/modula3/modula3.swg | 51 +- Lib/mzscheme/Makefile | 1 - Lib/mzscheme/typemaps.i | 15 +- Lib/ocaml/director.swg | 57 +- Lib/ocaml/ocamldec.swg | 4 +- Lib/ocaml/{swigp4.ml.in => swigp4.ml} | 0 Lib/ocaml/typecheck.i | 2 +- Lib/ocaml/typemaps.i | 36 + Lib/octave/boost_shared_ptr.i | 12 +- Lib/octave/director.swg | 16 +- Lib/octave/octcontainer.swg | 5 +- Lib/octave/octprimtypes.swg | 20 +- Lib/octave/octrun.swg | 201 +- Lib/octave/octruntime.swg | 23 +- Lib/octave/octtypemaps.swg | 2 +- Lib/octave/std_carray.i | 56 - Lib/octave/std_common.i | 16 +- Lib/octave/std_shared_ptr.i | 2 + Lib/perl5/Makefile.in | 52 +- Lib/perl5/Makefile.pl | 4 +- Lib/perl5/director.swg | 317 + Lib/perl5/noembed.h | 3 + Lib/perl5/perlinit.swg | 3 +- Lib/perl5/perlprimtypes.swg | 48 +- Lib/perl5/perlrun.swg | 9 +- Lib/perl5/perltypemaps.swg | 11 +- Lib/perl5/std_common.i | 3 +- Lib/perl5/std_list.i | 16 +- Lib/perl5/std_map.i | 10 +- Lib/perl5/std_vector.i | 16 +- Lib/php/const.i | 7 +- Lib/php/director.swg | 121 +- Lib/php/globalvar.i | 28 +- Lib/php/php.swg | 58 +- Lib/php/phpkw.swg | 408 +- Lib/php/phppointers.i | 2 +- Lib/php/phprun.swg | 10 +- Lib/php/std_string.i | 8 +- Lib/php/std_vector.i | 2 +- Lib/php/typemaps.i | 16 +- Lib/php/utils.i | 8 +- Lib/pike/pike.swg | 14 +- Lib/pointer.i | 2 +- Lib/python/Makefile.in | 50 +- Lib/python/README | 1 - Lib/python/boost_shared_ptr.i | 6 +- Lib/python/builtin.swg | 29 +- Lib/python/director.swg | 283 +- Lib/python/embed.i | 29 +- Lib/python/embed15.i | 115 - Lib/python/pyabc.i | 2 +- Lib/python/pyclasses.swg | 8 + Lib/python/pycomplex.swg | 2 +- Lib/python/pycontainer.swg | 117 +- Lib/python/pydocs.swg | 2 + Lib/python/pyhead.swg | 4 - Lib/python/pyinit.swg | 24 +- Lib/python/pyiterators.swg | 3 +- Lib/python/pyopers.swg | 28 +- Lib/python/pyprimtypes.swg | 68 +- Lib/python/pyrun.swg | 105 +- Lib/python/pystdcommon.swg | 5 +- Lib/python/pystrings.swg | 70 +- Lib/python/pythonkw.swg | 8 +- Lib/python/pytypemaps.swg | 10 +- Lib/python/pyuserdir.swg | 1 - Lib/python/pywstrings.swg | 4 +- Lib/python/std_array.i | 91 + Lib/python/std_auto_ptr.i | 17 + Lib/python/std_common.i | 16 +- Lib/python/std_map.i | 38 +- Lib/python/std_multimap.i | 5 +- Lib/python/std_pair.i | 22 +- Lib/python/std_unordered_map.i | 251 + Lib/python/std_unordered_multimap.i | 78 + Lib/python/std_unordered_multiset.i | 41 + Lib/python/std_unordered_set.i | 55 + Lib/r/boost_shared_ptr.i | 6 +- Lib/r/r.swg | 4 +- Lib/r/rfragments.swg | 22 +- Lib/r/rkw.swg | 4 + Lib/r/rrun.swg | 4 - Lib/r/rtype.swg | 45 +- Lib/r/srun.swg | 4 +- Lib/r/std_common.i | 16 +- Lib/r/std_vector.i | 561 +- Lib/ruby/Makefile.swig | 2 +- Lib/ruby/boost_shared_ptr.i | 323 + Lib/ruby/director.swg | 241 +- Lib/ruby/file.i | 2 +- Lib/ruby/rubyclasses.swg | 16 +- Lib/ruby/rubycontainer.swg | 212 +- Lib/ruby/rubyprimtypes.swg | 21 +- Lib/ruby/rubyrun.swg | 54 +- Lib/ruby/rubytracking.swg | 132 +- Lib/ruby/rubytypemaps.swg | 2 +- Lib/ruby/rubywstrings.swg | 4 +- Lib/ruby/std_array.i | 102 + Lib/ruby/std_common.i | 16 +- Lib/ruby/std_shared_ptr.i | 2 + Lib/scilab/boost_shared_ptr.i | 320 + Lib/scilab/carrays.i | 5 + Lib/scilab/cmalloc.i | 1 + Lib/scilab/cpointer.i | 1 + Lib/scilab/exception.i | 6 + Lib/scilab/matrix.i | 11 + Lib/scilab/sciarray.swg | 115 + Lib/scilab/scibool.swg | 157 + Lib/scilab/scichar.swg | 292 + Lib/scilab/scicontainer.swg | 444 + Lib/scilab/scidouble.swg | 108 + Lib/scilab/scienum.swg | 31 + Lib/scilab/sciexception.swg | 60 + Lib/scilab/scifloat.swg | 83 + Lib/scilab/sciint.swg | 202 + Lib/scilab/sciiterators.swg | 363 + Lib/scilab/scilab.swg | 6 + Lib/scilab/scilist.swg | 91 + Lib/scilab/scilong.swg | 123 + Lib/scilab/scilonglong.swg | 54 + Lib/scilab/scimacros.swg | 5 + Lib/scilab/scimatrixbool.swg | 170 + Lib/scilab/scimatrixchar.swg | 199 + Lib/scilab/scimatrixdouble.swg | 170 + Lib/scilab/scimatrixint.swg | 175 + Lib/scilab/scimisctypes.swg | 69 + Lib/scilab/scipointer.swg | 32 + Lib/scilab/sciprimtypes.swg | 23 + Lib/scilab/scirun.swg | 459 + Lib/scilab/sciruntime.swg | 33 + Lib/scilab/scisequence.swg | 195 + Lib/scilab/scisequencebool.swg | 98 + Lib/scilab/scisequencedouble.swg | 99 + Lib/scilab/scisequencefloat.swg | 98 + Lib/scilab/scisequenceint.swg | 104 + Lib/scilab/scisequencepointer.swg | 123 + Lib/scilab/scisequencestring.swg | 97 + Lib/scilab/scishort.swg | 188 + Lib/scilab/scisignedchar.swg | 185 + Lib/scilab/scistdcommon.swg | 226 + Lib/scilab/scitypemaps.swg | 250 + Lib/scilab/sciunsignedchar.swg | 190 + Lib/scilab/sciunsignedint.swg | 204 + Lib/scilab/sciunsignedlong.swg | 53 + Lib/scilab/sciunsignedshort.swg | 189 + Lib/scilab/std_alloc.i | 2 + Lib/scilab/std_basic_string.i | 46 + Lib/scilab/std_char_traits.i | 1 + Lib/scilab/std_common.i | 72 + Lib/scilab/std_container.i | 3 + Lib/scilab/std_deque.i | 31 + Lib/scilab/std_except.i | 1 + Lib/scilab/std_list.i | 30 + Lib/scilab/std_map.i | 69 + Lib/scilab/std_multiset.i | 30 + Lib/scilab/std_pair.i | 34 + Lib/scilab/std_set.i | 32 + Lib/scilab/std_string.i | 39 + Lib/scilab/std_vector.i | 31 + Lib/scilab/stl.i | 6 + Lib/scilab/typemaps.i | 62 + Lib/std/_std_deque.i | 10 +- Lib/std/std_array.i | 85 + Lib/std/std_basic_string.i | 17 +- Lib/std/std_common.i | 38 +- Lib/std/std_container.i | 86 +- Lib/std/std_deque.i | 22 +- Lib/std/std_ios.i | 8 +- Lib/std/std_list.i | 24 +- Lib/std/std_map.i | 18 +- Lib/std/std_multimap.i | 18 +- Lib/std/std_multiset.i | 14 +- Lib/std/std_pair.i | 42 +- Lib/std/std_queue.i | 22 +- Lib/std/std_set.i | 12 +- Lib/std/std_stack.i | 22 +- Lib/std/std_unordered_map.i | 129 + Lib/std/std_unordered_multimap.i | 90 + Lib/std/std_unordered_multiset.i | 86 + Lib/std/std_unordered_set.i | 122 + Lib/std/std_vector.i | 28 +- Lib/swig.swg | 184 +- Lib/swigarch.i | 4 +- Lib/swiginit.swg | 14 +- Lib/swiglabels.swg | 21 +- Lib/swigrun.swg | 32 +- Lib/swigwarn.swg | 18 + Lib/swigwarnings.swg | 1 + Lib/tcl/Makefile.in | 51 +- Lib/tcl/std_map.i | 6 +- Lib/tcl/std_vector.i | 6 +- Lib/tcl/tclprimtypes.swg | 16 +- Lib/tcl/tclrun.swg | 6 + Lib/tcl/tcltypemaps.swg | 3 +- Lib/typemaps/attribute.swg | 7 +- Lib/typemaps/enumint.swg | 15 +- Lib/typemaps/exception.swg | 6 +- Lib/typemaps/fragments.swg | 19 +- Lib/typemaps/primtypes.swg | 70 +- Lib/typemaps/std_string.swg | 6 +- Lib/typemaps/std_wstring.swg | 2 +- Lib/typemaps/string.swg | 13 +- Lib/typemaps/strings.swg | 49 +- Lib/typemaps/swigmacros.swg | 10 +- Lib/typemaps/swigtype.swg | 104 +- Lib/typemaps/swigtypemaps.swg | 2 +- Lib/typemaps/traits.swg | 8 +- Lib/typemaps/wstring.swg | 14 +- Makefile.in | 157 +- README | 20 +- RELEASENOTES | 81 +- Source/CParse/cparse.h | 7 +- Source/CParse/cscanner.c | 91 +- Source/CParse/parser.c | 11689 ++--- Source/CParse/parser.h | 580 +- Source/CParse/parser.y | 2477 +- Source/CParse/templ.c | 13 +- Source/CParse/util.c | 36 + Source/DOH/README | 4 +- Source/DOH/base.c | 15 +- Source/DOH/doh.h | 6 + Source/DOH/file.c | 2 +- Source/DOH/fio.c | 31 +- Source/DOH/string.c | 15 +- Source/Include/swigconfig.h.in | 8 +- Source/Include/swigwarn.h | 18 + Source/Makefile.am | 12 +- Source/Makefile.in | 420 +- Source/Modules/allegrocl.cxx | 22 +- Source/Modules/allocate.cxx | 48 +- Source/Modules/browser.cxx | 6 + Source/Modules/cffi.cxx | 129 +- Source/Modules/chicken.cxx | 15 +- Source/Modules/clisp.cxx | 10 +- Source/Modules/contract.cxx | 8 +- Source/Modules/csharp.cxx | 956 +- Source/Modules/d.cxx | 264 +- Source/Modules/directors.cxx | 4 +- Source/Modules/go.cxx | 4110 +- Source/Modules/guile.cxx | 31 +- Source/Modules/interface.cxx | 183 + Source/Modules/java.cxx | 980 +- Source/Modules/javascript.cxx | 2457 ++ Source/Modules/lang.cxx | 399 +- Source/Modules/lua.cxx | 1992 +- Source/Modules/main.cxx | 82 +- Source/Modules/modula3.cxx | 78 +- Source/Modules/mzscheme.cxx | 8 +- Source/Modules/nested.cxx | 453 + Source/Modules/ocaml.cxx | 28 +- Source/Modules/octave.cxx | 727 +- Source/Modules/overload.cxx | 4 +- Source/Modules/perl5.cxx | 797 +- Source/Modules/php.cxx | 266 +- Source/Modules/pike.cxx | 6 +- Source/Modules/python.cxx | 1451 +- Source/Modules/r.cxx | 38 +- Source/Modules/ruby.cxx | 111 +- Source/Modules/scilab.cxx | 1125 + Source/Modules/swigmain.cxx | 9 +- Source/Modules/swigmod.h | 67 +- Source/Modules/tcl8.cxx | 9 +- Source/Modules/typepass.cxx | 123 +- Source/Modules/uffi.cxx | 2 +- Source/Preprocessor/cpp.c | 21 +- Source/Swig/cwrap.c | 131 +- Source/Swig/extend.c | 141 + Source/Swig/fragment.c | 10 +- Source/Swig/include.c | 4 +- Source/Swig/misc.c | 250 +- Source/Swig/naming.c | 347 +- Source/Swig/scanner.c | 522 +- Source/Swig/stype.c | 58 +- Source/Swig/swig.h | 30 +- Source/Swig/swigscan.h | 4 + Source/Swig/swigtree.h | 1 + Source/Swig/symbol.c | 20 +- Source/Swig/tree.c | 20 +- Source/Swig/typemap.c | 500 +- Source/Swig/typeobj.c | 51 +- Source/Swig/typesys.c | 112 +- Tools/brew-install | 25 + Tools/config/ac_compare_version.m4 | 40 - Tools/config/ac_compile_warnings.m4 | 2 +- Tools/config/ax_boost_base.m4 | 35 +- Tools/config/ax_cxx_compile_stdcxx_11.m4 | 121 + Tools/config/ax_path_generic.m4 | 4 +- Tools/config/compile | 99 +- Tools/config/config.guess | 381 +- Tools/config/config.sub | 150 +- Tools/config/depcomp | 487 +- Tools/config/install-sh | 381 +- Tools/config/missing | 414 +- Tools/config/ylwrap | 205 +- Tools/convertpath | 34 + Tools/javascript/Makefile.in | 72 + Tools/javascript/javascript.cxx | 66 + Tools/javascript/js_shell.cxx | 156 + Tools/javascript/js_shell.h | 53 + Tools/javascript/jsc_shell.cxx | 233 + Tools/javascript/v8_shell.cxx | 388 + Tools/mkdist.py | 2 - Tools/mkrelease.py | 2 +- Tools/mkwindows.sh | 32 +- Tools/nuget-install.cmd | 28 + Tools/obs-buildlogs.py | 34 + Tools/obs-update | 26 + Tools/testflags.py | 79 + Tools/travis-linux-install.sh | 110 + Tools/travis-osx-install.sh | 30 + Tools/vcfilter | 4 +- aclocal.m4 | 738 +- appveyor.yml | 78 + configure | 3954 +- configure.ac | 1638 +- packaging/swig.spec | 2 +- preinst-swig.in | 12 +- 2491 files changed, 133498 insertions(+), 50135 deletions(-) delete mode 100644 CCache/ccache-swig.1 create mode 100644 Doc/Devel/cpp11.html create mode 100644 Doc/Manual/CPlusPlus11.html create mode 100644 Doc/Manual/Javascript.html create mode 100644 Doc/Manual/Scilab.html delete mode 100644 Doc/Manual/margin-left.patch delete mode 100644 Doc/Manual/swigpdf.book create mode 100644 Examples/csharp/arrays/example-cs.csproj create mode 100644 Examples/csharp/arrays/example-vc.vcproj create mode 100644 Examples/csharp/arrays/example.sln create mode 100644 Examples/csharp/nested/Makefile create mode 100644 Examples/csharp/nested/example-cs.csproj create mode 100644 Examples/csharp/nested/example-vc.vcproj create mode 100644 Examples/csharp/nested/example.cxx create mode 100644 Examples/csharp/nested/example.h create mode 100644 Examples/csharp/nested/example.i create mode 100644 Examples/csharp/nested/example.sln create mode 100644 Examples/csharp/nested/runme.cs delete mode 100644 Examples/d/constants/example.d create mode 100644 Examples/d/example.mk.in rename Examples/go/{extend/example.cxx => callback/callback.cxx} (100%) create mode 100644 Examples/go/callback/gocallback.go create mode 100644 Examples/go/class/class.cxx create mode 100644 Examples/go/director/Makefile create mode 100644 Examples/go/director/director.go create mode 100644 Examples/go/director/director.h create mode 100644 Examples/go/director/example.i create mode 100644 Examples/go/director/index.html create mode 100644 Examples/go/director/runme.go rename Examples/go/enum/{example.cxx => enum.cxx} (100%) create mode 100644 Examples/go/extend/ceo.go rename Examples/go/{callback/example.cxx => extend/extend.cxx} (100%) rename Examples/go/funcptr/{example.c => funcptr.c} (100%) rename Examples/go/multimap/{example.c => multimap.c} (100%) rename Examples/go/pointer/{example.c => pointer.c} (100%) create mode 100644 Examples/go/reference/reference.cxx rename Examples/go/simple/{example.c => simple.c} (100%) rename Examples/go/variables/{example.c => variables.c} (97%) mode change 100755 => 100644 Examples/guile/matrix/runme.scm create mode 100644 Examples/java/nested/Makefile create mode 100644 Examples/java/nested/example.cxx create mode 100644 Examples/java/nested/example.dsp create mode 100644 Examples/java/nested/example.h create mode 100644 Examples/java/nested/example.i create mode 100644 Examples/java/nested/runme.java create mode 100644 Examples/javascript/check.list create mode 100644 Examples/javascript/class/Makefile create mode 100644 Examples/javascript/class/binding.gyp.in rename Examples/{go => javascript}/class/example.cxx (66%) create mode 100644 Examples/javascript/class/example.h create mode 100644 Examples/javascript/class/example.i create mode 100644 Examples/javascript/class/example.js create mode 100644 Examples/javascript/class/runme.js create mode 100644 Examples/javascript/constant/Makefile create mode 100644 Examples/javascript/constant/binding.gyp.in create mode 100644 Examples/javascript/constant/example.h create mode 100644 Examples/javascript/constant/example.i create mode 100644 Examples/javascript/constant/example.js create mode 100644 Examples/javascript/constant/runme.js create mode 100644 Examples/javascript/enum/Makefile create mode 100644 Examples/javascript/enum/binding.gyp.in create mode 100644 Examples/javascript/enum/example.cxx create mode 100644 Examples/javascript/enum/example.h create mode 100644 Examples/javascript/enum/example.i create mode 100644 Examples/javascript/enum/example.js create mode 100644 Examples/javascript/enum/runme.js create mode 100644 Examples/javascript/example.mk create mode 100644 Examples/javascript/exception/Makefile create mode 100644 Examples/javascript/exception/binding.gyp.in create mode 100644 Examples/javascript/exception/example.cxx create mode 100644 Examples/javascript/exception/example.h create mode 100644 Examples/javascript/exception/example.i create mode 100644 Examples/javascript/exception/example.js create mode 100644 Examples/javascript/exception/runme.js create mode 100644 Examples/javascript/functor/Makefile create mode 100644 Examples/javascript/functor/binding.gyp.in create mode 100644 Examples/javascript/functor/example.i create mode 100644 Examples/javascript/functor/example.js create mode 100644 Examples/javascript/functor/runme.js create mode 100644 Examples/javascript/nspace/Makefile create mode 100644 Examples/javascript/nspace/binding.gyp.in create mode 100644 Examples/javascript/nspace/example.h create mode 100644 Examples/javascript/nspace/example.i create mode 100644 Examples/javascript/nspace/example.js create mode 100644 Examples/javascript/nspace/runme.js create mode 100644 Examples/javascript/operator/Makefile create mode 100644 Examples/javascript/operator/binding.gyp.in create mode 100644 Examples/javascript/operator/example.h create mode 100644 Examples/javascript/operator/example.i create mode 100644 Examples/javascript/operator/example.js create mode 100644 Examples/javascript/operator/runme.js create mode 100644 Examples/javascript/overload/Makefile create mode 100644 Examples/javascript/overload/binding.gyp.in create mode 100644 Examples/javascript/overload/example.h create mode 100644 Examples/javascript/overload/example.i create mode 100644 Examples/javascript/overload/example.js create mode 100644 Examples/javascript/overload/runme.js create mode 100644 Examples/javascript/pointer/Makefile create mode 100644 Examples/javascript/pointer/binding.gyp.in create mode 100644 Examples/javascript/pointer/example.cxx create mode 100644 Examples/javascript/pointer/example.i create mode 100644 Examples/javascript/pointer/example.js create mode 100644 Examples/javascript/pointer/runme.js create mode 100644 Examples/javascript/reference/Makefile create mode 100644 Examples/javascript/reference/binding.gyp.in rename Examples/{go => javascript}/reference/example.cxx (93%) create mode 100644 Examples/javascript/reference/example.h create mode 100644 Examples/javascript/reference/example.i create mode 100644 Examples/javascript/reference/example.js create mode 100644 Examples/javascript/reference/runme.js create mode 100644 Examples/javascript/simple/Makefile create mode 100644 Examples/javascript/simple/binding.gyp.in create mode 100644 Examples/javascript/simple/example.cxx create mode 100644 Examples/javascript/simple/example.i create mode 100644 Examples/javascript/simple/example.js create mode 100644 Examples/javascript/simple/runme.js create mode 100644 Examples/javascript/template/Makefile create mode 100644 Examples/javascript/template/binding.gyp.in create mode 100644 Examples/javascript/template/example.h create mode 100644 Examples/javascript/template/example.i create mode 100644 Examples/javascript/template/example.js create mode 100644 Examples/javascript/template/runme.js create mode 100644 Examples/javascript/variables/Makefile create mode 100644 Examples/javascript/variables/binding.gyp.in create mode 100644 Examples/javascript/variables/example.cxx create mode 100644 Examples/javascript/variables/example.h create mode 100644 Examples/javascript/variables/example.i create mode 100644 Examples/javascript/variables/example.js create mode 100644 Examples/javascript/variables/runme.js create mode 100644 Examples/lua/nspace/Makefile create mode 100644 Examples/lua/nspace/example.h create mode 100644 Examples/lua/nspace/example.i create mode 100644 Examples/lua/nspace/runme.lua create mode 100644 Examples/octave/example.mk create mode 100644 Examples/perl5/callback/Makefile create mode 100644 Examples/perl5/callback/example.cxx create mode 100644 Examples/perl5/callback/example.h create mode 100644 Examples/perl5/callback/example.i create mode 100644 Examples/perl5/callback/index.html create mode 100644 Examples/perl5/callback/runme.pl create mode 100644 Examples/perl5/extend/Makefile create mode 100644 Examples/perl5/extend/example.cxx rename Examples/{python/swigrun => perl5/extend}/example.h (92%) rename Examples/{python/swigrun => perl5/extend}/example.i (57%) create mode 100644 Examples/perl5/extend/index.html create mode 100644 Examples/perl5/extend/runme.pl mode change 100755 => 100644 Examples/php/pragmas/runme.php mode change 100755 => 100644 Examples/php/simple/runme.php mode change 100755 => 100644 Examples/pike/class/runme.pike mode change 100755 => 100644 Examples/pike/constants/runme.pike mode change 100755 => 100644 Examples/pike/template/runme.pike create mode 100644 Examples/python/import_packages/Makefile create mode 100644 Examples/python/import_packages/README create mode 100644 Examples/python/import_packages/from_init1/Makefile create mode 100644 Examples/python/import_packages/from_init1/README create mode 100644 Examples/python/import_packages/from_init1/py2/Makefile create mode 100644 Examples/python/import_packages/from_init1/py2/__init__.py create mode 100644 Examples/python/import_packages/from_init1/py2/pkg2/Makefile create mode 100644 Examples/python/import_packages/from_init1/py2/pkg2/__init__.py create mode 100644 Examples/python/import_packages/from_init1/py2/pkg2/bar.hpp create mode 100644 Examples/python/import_packages/from_init1/py2/pkg2/bar.i create mode 100644 Examples/python/import_packages/from_init1/py2/pkg2/foo.hpp create mode 100644 Examples/python/import_packages/from_init1/py2/pkg2/foo.i create mode 100644 Examples/python/import_packages/from_init1/py3/Makefile create mode 100644 Examples/python/import_packages/from_init1/py3/__init__.py create mode 100644 Examples/python/import_packages/from_init1/py3/pkg2/Makefile create mode 100644 Examples/python/import_packages/from_init1/py3/pkg2/__init__.py create mode 100644 Examples/python/import_packages/from_init1/py3/pkg2/bar.hpp create mode 100644 Examples/python/import_packages/from_init1/py3/pkg2/bar.i create mode 100644 Examples/python/import_packages/from_init1/py3/pkg2/foo.hpp create mode 100644 Examples/python/import_packages/from_init1/py3/pkg2/foo.i create mode 100644 Examples/python/import_packages/from_init1/runme.py create mode 100644 Examples/python/import_packages/from_init2/Makefile create mode 100644 Examples/python/import_packages/from_init2/README create mode 100644 Examples/python/import_packages/from_init2/py2/Makefile create mode 100644 Examples/python/import_packages/from_init2/py2/__init__.py create mode 100644 Examples/python/import_packages/from_init2/py2/pkg2/Makefile create mode 100644 Examples/python/import_packages/from_init2/py2/pkg2/__init__.py create mode 100644 Examples/python/import_packages/from_init2/py2/pkg2/bar.hpp create mode 100644 Examples/python/import_packages/from_init2/py2/pkg2/bar.i create mode 100644 Examples/python/import_packages/from_init2/py2/pkg2/pkg3/Makefile create mode 100644 Examples/python/import_packages/from_init2/py2/pkg2/pkg3/__init__.py create mode 100644 Examples/python/import_packages/from_init2/py2/pkg2/pkg3/foo.hpp create mode 100644 Examples/python/import_packages/from_init2/py2/pkg2/pkg3/foo.i create mode 100644 Examples/python/import_packages/from_init2/py3/Makefile create mode 100644 Examples/python/import_packages/from_init2/py3/__init__.py create mode 100644 Examples/python/import_packages/from_init2/py3/pkg2/Makefile create mode 100644 Examples/python/import_packages/from_init2/py3/pkg2/__init__.py create mode 100644 Examples/python/import_packages/from_init2/py3/pkg2/bar.hpp create mode 100644 Examples/python/import_packages/from_init2/py3/pkg2/bar.i create mode 100644 Examples/python/import_packages/from_init2/py3/pkg2/pkg3/Makefile create mode 100644 Examples/python/import_packages/from_init2/py3/pkg2/pkg3/__init__.py create mode 100644 Examples/python/import_packages/from_init2/py3/pkg2/pkg3/foo.hpp create mode 100644 Examples/python/import_packages/from_init2/py3/pkg2/pkg3/foo.i create mode 100644 Examples/python/import_packages/from_init2/runme.py create mode 100644 Examples/python/import_packages/from_init3/Makefile create mode 100644 Examples/python/import_packages/from_init3/README create mode 100644 Examples/python/import_packages/from_init3/py2/Makefile create mode 100644 Examples/python/import_packages/from_init3/py2/__init__.py create mode 100644 Examples/python/import_packages/from_init3/py2/pkg2/Makefile create mode 100644 Examples/python/import_packages/from_init3/py2/pkg2/__init__.py create mode 100644 Examples/python/import_packages/from_init3/py2/pkg2/bar.hpp create mode 100644 Examples/python/import_packages/from_init3/py2/pkg2/bar.i create mode 100644 Examples/python/import_packages/from_init3/py2/pkg2/pkg3/Makefile create mode 100644 Examples/python/import_packages/from_init3/py2/pkg2/pkg3/__init__.py create mode 100644 Examples/python/import_packages/from_init3/py2/pkg2/pkg3/pkg4/Makefile create mode 100644 Examples/python/import_packages/from_init3/py2/pkg2/pkg3/pkg4/__init__.py create mode 100644 Examples/python/import_packages/from_init3/py2/pkg2/pkg3/pkg4/foo.hpp create mode 100644 Examples/python/import_packages/from_init3/py2/pkg2/pkg3/pkg4/foo.i create mode 100644 Examples/python/import_packages/from_init3/py3/Makefile create mode 100644 Examples/python/import_packages/from_init3/py3/__init__.py create mode 100644 Examples/python/import_packages/from_init3/py3/pkg2/Makefile create mode 100644 Examples/python/import_packages/from_init3/py3/pkg2/__init__.py create mode 100644 Examples/python/import_packages/from_init3/py3/pkg2/bar.hpp create mode 100644 Examples/python/import_packages/from_init3/py3/pkg2/bar.i create mode 100644 Examples/python/import_packages/from_init3/py3/pkg2/pkg3/Makefile create mode 100644 Examples/python/import_packages/from_init3/py3/pkg2/pkg3/__init__.py create mode 100644 Examples/python/import_packages/from_init3/py3/pkg2/pkg3/pkg4/Makefile create mode 100644 Examples/python/import_packages/from_init3/py3/pkg2/pkg3/pkg4/__init__.py create mode 100644 Examples/python/import_packages/from_init3/py3/pkg2/pkg3/pkg4/foo.hpp create mode 100644 Examples/python/import_packages/from_init3/py3/pkg2/pkg3/pkg4/foo.i create mode 100644 Examples/python/import_packages/from_init3/runme.py create mode 100644 Examples/python/import_packages/namespace_pkg/Makefile create mode 100644 Examples/python/import_packages/namespace_pkg/README create mode 100644 Examples/python/import_packages/namespace_pkg/nonpkg.py create mode 100644 Examples/python/import_packages/namespace_pkg/normal.py create mode 100644 Examples/python/import_packages/namespace_pkg/nstest.py create mode 100644 Examples/python/import_packages/namespace_pkg/robin.i create mode 100644 Examples/python/import_packages/namespace_pkg/runme.py create mode 100644 Examples/python/import_packages/namespace_pkg/split.py create mode 100644 Examples/python/import_packages/namespace_pkg/zipsplit.py create mode 100644 Examples/python/import_packages/relativeimport1/Makefile create mode 100644 Examples/python/import_packages/relativeimport1/README create mode 100644 Examples/python/import_packages/relativeimport1/py2/Makefile create mode 100644 Examples/python/import_packages/relativeimport1/py2/__init__.py create mode 100644 Examples/python/import_packages/relativeimport1/py2/pkg2/Makefile create mode 100644 Examples/python/import_packages/relativeimport1/py2/pkg2/__init__.py create mode 100644 Examples/python/import_packages/relativeimport1/py2/pkg2/bar.hpp create mode 100644 Examples/python/import_packages/relativeimport1/py2/pkg2/bar.i create mode 100644 Examples/python/import_packages/relativeimport1/py2/pkg2/pkg3/Makefile create mode 100644 Examples/python/import_packages/relativeimport1/py2/pkg2/pkg3/__init__.py create mode 100644 Examples/python/import_packages/relativeimport1/py2/pkg2/pkg3/foo.hpp create mode 100644 Examples/python/import_packages/relativeimport1/py2/pkg2/pkg3/foo.i create mode 100644 Examples/python/import_packages/relativeimport1/py3/Makefile create mode 100644 Examples/python/import_packages/relativeimport1/py3/__init__.py create mode 100644 Examples/python/import_packages/relativeimport1/py3/pkg2/Makefile create mode 100644 Examples/python/import_packages/relativeimport1/py3/pkg2/__init__.py create mode 100644 Examples/python/import_packages/relativeimport1/py3/pkg2/bar.hpp create mode 100644 Examples/python/import_packages/relativeimport1/py3/pkg2/bar.i create mode 100644 Examples/python/import_packages/relativeimport1/py3/pkg2/pkg3/Makefile create mode 100644 Examples/python/import_packages/relativeimport1/py3/pkg2/pkg3/__init__.py create mode 100644 Examples/python/import_packages/relativeimport1/py3/pkg2/pkg3/foo.hpp create mode 100644 Examples/python/import_packages/relativeimport1/py3/pkg2/pkg3/foo.i create mode 100644 Examples/python/import_packages/relativeimport1/runme.py create mode 100644 Examples/python/import_packages/relativeimport2/Makefile create mode 100644 Examples/python/import_packages/relativeimport2/README create mode 100644 Examples/python/import_packages/relativeimport2/py2/Makefile create mode 100644 Examples/python/import_packages/relativeimport2/py2/__init__.py create mode 100644 Examples/python/import_packages/relativeimport2/py2/pkg2/Makefile create mode 100644 Examples/python/import_packages/relativeimport2/py2/pkg2/__init__.py create mode 100644 Examples/python/import_packages/relativeimport2/py2/pkg2/bar.hpp create mode 100644 Examples/python/import_packages/relativeimport2/py2/pkg2/bar.i create mode 100644 Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/Makefile create mode 100644 Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/__init__.py create mode 100644 Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/pkg4/Makefile create mode 100644 Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/pkg4/__init__.py create mode 100644 Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/pkg4/foo.hpp create mode 100644 Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/pkg4/foo.i create mode 100644 Examples/python/import_packages/relativeimport2/py3/Makefile create mode 100644 Examples/python/import_packages/relativeimport2/py3/__init__.py create mode 100644 Examples/python/import_packages/relativeimport2/py3/pkg2/Makefile create mode 100644 Examples/python/import_packages/relativeimport2/py3/pkg2/__init__.py create mode 100644 Examples/python/import_packages/relativeimport2/py3/pkg2/bar.hpp create mode 100644 Examples/python/import_packages/relativeimport2/py3/pkg2/bar.i create mode 100644 Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/Makefile create mode 100644 Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/__init__.py create mode 100644 Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/pkg4/Makefile create mode 100644 Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/pkg4/__init__.py create mode 100644 Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/pkg4/foo.hpp create mode 100644 Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/pkg4/foo.i create mode 100644 Examples/python/import_packages/relativeimport2/runme.py create mode 100644 Examples/python/import_packages/relativeimport3/Makefile create mode 100644 Examples/python/import_packages/relativeimport3/README create mode 100644 Examples/python/import_packages/relativeimport3/py2/Makefile create mode 100644 Examples/python/import_packages/relativeimport3/py2/__init__.py create mode 100644 Examples/python/import_packages/relativeimport3/py2/pkg2/Makefile create mode 100644 Examples/python/import_packages/relativeimport3/py2/pkg2/__init__.py create mode 100644 Examples/python/import_packages/relativeimport3/py2/pkg2/bar.hpp create mode 100644 Examples/python/import_packages/relativeimport3/py2/pkg2/bar.i create mode 100644 Examples/python/import_packages/relativeimport3/py2/pkg2/pkg3/Makefile create mode 100644 Examples/python/import_packages/relativeimport3/py2/pkg2/pkg3/__init__.py create mode 100644 Examples/python/import_packages/relativeimport3/py2/pkg2/pkg3/foo.hpp create mode 100644 Examples/python/import_packages/relativeimport3/py2/pkg2/pkg3/foo.i create mode 100644 Examples/python/import_packages/relativeimport3/py3/Makefile create mode 100644 Examples/python/import_packages/relativeimport3/py3/__init__.py create mode 100644 Examples/python/import_packages/relativeimport3/py3/pkg2/Makefile create mode 100644 Examples/python/import_packages/relativeimport3/py3/pkg2/__init__.py create mode 100644 Examples/python/import_packages/relativeimport3/py3/pkg2/bar.hpp create mode 100644 Examples/python/import_packages/relativeimport3/py3/pkg2/bar.i create mode 100644 Examples/python/import_packages/relativeimport3/py3/pkg2/pkg3/Makefile create mode 100644 Examples/python/import_packages/relativeimport3/py3/pkg2/pkg3/__init__.py create mode 100644 Examples/python/import_packages/relativeimport3/py3/pkg2/pkg3/foo.hpp create mode 100644 Examples/python/import_packages/relativeimport3/py3/pkg2/pkg3/foo.i create mode 100644 Examples/python/import_packages/relativeimport3/runme.py create mode 100644 Examples/python/import_packages/same_modnames1/Makefile create mode 100644 Examples/python/import_packages/same_modnames1/README create mode 100644 Examples/python/import_packages/same_modnames1/pkg1/Makefile create mode 100644 Examples/python/import_packages/same_modnames1/pkg1/__init__.py create mode 100644 Examples/python/import_packages/same_modnames1/pkg1/foo.hpp create mode 100644 Examples/python/import_packages/same_modnames1/pkg1/foo.i create mode 100644 Examples/python/import_packages/same_modnames1/pkg2/Makefile create mode 100644 Examples/python/import_packages/same_modnames1/pkg2/__init__.py create mode 100644 Examples/python/import_packages/same_modnames1/pkg2/foo.hpp create mode 100644 Examples/python/import_packages/same_modnames1/pkg2/foo.i create mode 100644 Examples/python/import_packages/same_modnames1/runme.py create mode 100644 Examples/python/import_packages/same_modnames2/Makefile create mode 100644 Examples/python/import_packages/same_modnames2/README create mode 100644 Examples/python/import_packages/same_modnames2/pkg1/Makefile create mode 100644 Examples/python/import_packages/same_modnames2/pkg1/__init__.py create mode 100644 Examples/python/import_packages/same_modnames2/pkg1/foo.hpp create mode 100644 Examples/python/import_packages/same_modnames2/pkg1/foo.i create mode 100644 Examples/python/import_packages/same_modnames2/pkg1/pkg2/Makefile create mode 100644 Examples/python/import_packages/same_modnames2/pkg1/pkg2/__init__.py create mode 100644 Examples/python/import_packages/same_modnames2/pkg1/pkg2/foo.hpp create mode 100644 Examples/python/import_packages/same_modnames2/pkg1/pkg2/foo.i create mode 100644 Examples/python/import_packages/same_modnames2/runme.py create mode 100644 Examples/python/import_packages/split_modules/Makefile create mode 100644 Examples/python/import_packages/split_modules/README create mode 100644 Examples/python/import_packages/split_modules/vanilla/Makefile create mode 100644 Examples/python/import_packages/split_modules/vanilla/pkg1/Makefile create mode 100644 Examples/python/import_packages/split_modules/vanilla/pkg1/__init__.py create mode 100644 Examples/python/import_packages/split_modules/vanilla/pkg1/foo.i create mode 100644 Examples/python/import_packages/split_modules/vanilla/runme.py create mode 100644 Examples/python/import_packages/split_modules/vanilla_split/Makefile create mode 100644 Examples/python/import_packages/split_modules/vanilla_split/foo.i create mode 100644 Examples/python/import_packages/split_modules/vanilla_split/pkg1/__init__.py create mode 100644 Examples/python/import_packages/split_modules/vanilla_split/runme.py delete mode 100644 Examples/python/swigrun/Makefile delete mode 100644 Examples/python/swigrun/example.cxx delete mode 100644 Examples/python/swigrun/runme.py mode change 100755 => 100644 Examples/ruby/constants/runme.rb mode change 100755 => 100644 Examples/ruby/hashargs/runme.rb mode change 100755 => 100644 Examples/ruby/multimap/runme.rb mode change 100755 => 100644 Examples/ruby/simple/runme.rb create mode 100644 Examples/scilab/check.list create mode 100644 Examples/scilab/class/Makefile create mode 100644 Examples/scilab/class/example.cxx create mode 100644 Examples/scilab/class/example.h create mode 100644 Examples/scilab/class/example.i create mode 100644 Examples/scilab/class/runme.sci create mode 100644 Examples/scilab/constants/Makefile create mode 100644 Examples/scilab/constants/example.i create mode 100644 Examples/scilab/constants/runme.sci create mode 100644 Examples/scilab/contract/Makefile create mode 100644 Examples/scilab/contract/example.c create mode 100644 Examples/scilab/contract/example.i create mode 100644 Examples/scilab/contract/runme.sci create mode 100644 Examples/scilab/enum/Makefile create mode 100644 Examples/scilab/enum/example.cxx create mode 100644 Examples/scilab/enum/example.h create mode 100644 Examples/scilab/enum/example.i create mode 100644 Examples/scilab/enum/runme.sci create mode 100644 Examples/scilab/funcptr/Makefile create mode 100644 Examples/scilab/funcptr/example.c create mode 100644 Examples/scilab/funcptr/example.h create mode 100644 Examples/scilab/funcptr/example.i create mode 100644 Examples/scilab/funcptr/runme.sci create mode 100644 Examples/scilab/matrix/Makefile create mode 100644 Examples/scilab/matrix/example.c create mode 100644 Examples/scilab/matrix/example.i create mode 100644 Examples/scilab/matrix/runme.sci create mode 100644 Examples/scilab/matrix2/Makefile create mode 100644 Examples/scilab/matrix2/example.c create mode 100755 Examples/scilab/matrix2/example.i create mode 100644 Examples/scilab/matrix2/main.c create mode 100644 Examples/scilab/matrix2/runme.sci create mode 100644 Examples/scilab/pointer/Makefile create mode 100644 Examples/scilab/pointer/example.c create mode 100644 Examples/scilab/pointer/example.i create mode 100644 Examples/scilab/pointer/runme.sci create mode 100644 Examples/scilab/simple/Makefile create mode 100644 Examples/scilab/simple/example.c create mode 100644 Examples/scilab/simple/example.i create mode 100644 Examples/scilab/simple/runme.sci create mode 100644 Examples/scilab/std_list/Makefile create mode 100644 Examples/scilab/std_list/example.cxx create mode 100644 Examples/scilab/std_list/example.h create mode 100644 Examples/scilab/std_list/example.i create mode 100644 Examples/scilab/std_list/runme.sci create mode 100644 Examples/scilab/std_vector/Makefile create mode 100644 Examples/scilab/std_vector/example.h create mode 100644 Examples/scilab/std_vector/example.i create mode 100644 Examples/scilab/std_vector/runme.sci create mode 100644 Examples/scilab/struct/Makefile create mode 100644 Examples/scilab/struct/example.i create mode 100644 Examples/scilab/struct/runme.sci create mode 100644 Examples/scilab/template/Makefile create mode 100644 Examples/scilab/template/example.h create mode 100644 Examples/scilab/template/example.i create mode 100644 Examples/scilab/template/runme.sci create mode 100644 Examples/scilab/variables/Makefile create mode 100644 Examples/scilab/variables/example.c create mode 100644 Examples/scilab/variables/example.h create mode 100644 Examples/scilab/variables/example.i create mode 100644 Examples/scilab/variables/runme.sci create mode 100644 Examples/test-suite/c_delete.i create mode 100644 Examples/test-suite/c_delete_function.i create mode 100644 Examples/test-suite/chartest.i create mode 100644 Examples/test-suite/chicken/overload_extend_c_runme.ss create mode 100644 Examples/test-suite/constant_directive.i create mode 100644 Examples/test-suite/conversion_operators.i create mode 100644 Examples/test-suite/cpp11_alignment.i create mode 100644 Examples/test-suite/cpp11_alternate_function_syntax.i create mode 100644 Examples/test-suite/cpp11_constexpr.i create mode 100644 Examples/test-suite/cpp11_decltype.i create mode 100644 Examples/test-suite/cpp11_default_delete.i create mode 100644 Examples/test-suite/cpp11_delegating_constructors.i create mode 100644 Examples/test-suite/cpp11_director_enums.i create mode 100644 Examples/test-suite/cpp11_explicit_conversion_operators.i create mode 100644 Examples/test-suite/cpp11_final_override.i create mode 100644 Examples/test-suite/cpp11_function_objects.i create mode 100644 Examples/test-suite/cpp11_hash_tables.i create mode 100644 Examples/test-suite/cpp11_inheriting_constructors.i create mode 100644 Examples/test-suite/cpp11_initializer_list.i create mode 100644 Examples/test-suite/cpp11_initializer_list_extend.i create mode 100644 Examples/test-suite/cpp11_lambda_functions.i create mode 100644 Examples/test-suite/cpp11_li_std_array.i create mode 100644 Examples/test-suite/cpp11_noexcept.i create mode 100644 Examples/test-suite/cpp11_null_pointer_constant.i create mode 100644 Examples/test-suite/cpp11_raw_string_literals.i create mode 100644 Examples/test-suite/cpp11_reference_wrapper.i create mode 100644 Examples/test-suite/cpp11_result_of.i create mode 100644 Examples/test-suite/cpp11_rvalue_reference.i create mode 100644 Examples/test-suite/cpp11_rvalue_reference2.i create mode 100644 Examples/test-suite/cpp11_rvalue_reference3.i create mode 100644 Examples/test-suite/cpp11_sizeof_object.i create mode 100644 Examples/test-suite/cpp11_static_assert.i create mode 100644 Examples/test-suite/cpp11_strongly_typed_enumerations.i create mode 100644 Examples/test-suite/cpp11_strongly_typed_enumerations_simple.i create mode 100644 Examples/test-suite/cpp11_template_double_brackets.i create mode 100644 Examples/test-suite/cpp11_template_explicit.i create mode 100644 Examples/test-suite/cpp11_template_typedefs.i create mode 100644 Examples/test-suite/cpp11_thread_local.i create mode 100644 Examples/test-suite/cpp11_type_aliasing.i create mode 100644 Examples/test-suite/cpp11_type_traits.i create mode 100644 Examples/test-suite/cpp11_uniform_initialization.i create mode 100644 Examples/test-suite/cpp11_unrestricted_unions.i create mode 100644 Examples/test-suite/cpp11_userdefined_literals.i create mode 100644 Examples/test-suite/cpp11_variadic_templates.i create mode 100644 Examples/test-suite/csharp/cpp11_strongly_typed_enumerations_runme.cs create mode 100644 Examples/test-suite/csharp/director_pass_by_value_runme.cs create mode 100644 Examples/test-suite/csharp/li_std_auto_ptr_runme.cs create mode 100644 Examples/test-suite/csharp/li_swigtype_inout_runme.cs create mode 100644 Examples/test-suite/csharp/multiple_inheritance_abstract_runme.cs create mode 100644 Examples/test-suite/csharp/multiple_inheritance_interfaces_runme.cs create mode 100644 Examples/test-suite/csharp/multiple_inheritance_nspace_runme.cs create mode 100644 Examples/test-suite/csharp/multiple_inheritance_shared_ptr_runme.cs create mode 100644 Examples/test-suite/csharp/nested_class_runme.cs create mode 100644 Examples/test-suite/csharp/nested_directors_runme.cs create mode 100644 Examples/test-suite/csharp/nested_structs_runme.cs create mode 100644 Examples/test-suite/csharp/nested_workaround_runme.cs create mode 100644 Examples/test-suite/csharp/special_variable_attributes_runme.cs create mode 100644 Examples/test-suite/csharp/template_nested_runme.cs create mode 100644 Examples/test-suite/csharp_namespace_system_collision.i create mode 100644 Examples/test-suite/csharp_swig2_compatibility.i create mode 100644 Examples/test-suite/default_args_c.i create mode 100644 Examples/test-suite/director_nested_class.i create mode 100644 Examples/test-suite/director_nestedmodule.i create mode 100644 Examples/test-suite/director_pass_by_value.i create mode 100644 Examples/test-suite/director_property.i create mode 100644 Examples/test-suite/director_ref.i create mode 100644 Examples/test-suite/empty_c.i create mode 100644 Examples/test-suite/enum_ignore.i create mode 100644 Examples/test-suite/enum_missing.i create mode 100644 Examples/test-suite/equality.i create mode 100644 Examples/test-suite/errors/Makefile.in create mode 100644 Examples/test-suite/errors/c_bad_name.stderr create mode 100644 Examples/test-suite/errors/c_bad_native.stderr create mode 100644 Examples/test-suite/errors/c_class.stderr delete mode 100644 Examples/test-suite/errors/c_default_error.i create mode 100644 Examples/test-suite/errors/c_deprecated.stderr create mode 100644 Examples/test-suite/errors/c_empty_char.stderr create mode 100644 Examples/test-suite/errors/c_enum_badvalue.stderr create mode 100644 Examples/test-suite/errors/c_extra_rblock.stderr create mode 100644 Examples/test-suite/errors/c_extra_rbrace.stderr create mode 100644 Examples/test-suite/errors/c_extra_unsigned.stderr create mode 100644 Examples/test-suite/errors/c_insert_missing.stderr create mode 100644 Examples/test-suite/errors/c_long_short.stderr create mode 100644 Examples/test-suite/errors/c_missing_rbrace.stderr create mode 100644 Examples/test-suite/errors/c_missing_semi.stderr create mode 100644 Examples/test-suite/errors/c_redefine.stderr delete mode 100644 Examples/test-suite/errors/c_varargs.i create mode 100644 Examples/test-suite/errors/c_varargs_neg.stderr create mode 100644 Examples/test-suite/errors/cpp_bad_extern.stderr create mode 100644 Examples/test-suite/errors/cpp_extend_destructors.stderr create mode 100644 Examples/test-suite/errors/cpp_extend_redefine.stderr create mode 100644 Examples/test-suite/errors/cpp_extend_undefined.stderr create mode 100644 Examples/test-suite/errors/cpp_extra_brackets.i create mode 100644 Examples/test-suite/errors/cpp_extra_brackets.stderr create mode 100644 Examples/test-suite/errors/cpp_extra_brackets2.i create mode 100644 Examples/test-suite/errors/cpp_extra_brackets2.stderr create mode 100644 Examples/test-suite/errors/cpp_inherit.stderr create mode 100644 Examples/test-suite/errors/cpp_inherit_ignored.i create mode 100644 Examples/test-suite/errors/cpp_inherit_ignored.stderr create mode 100644 Examples/test-suite/errors/cpp_inline_namespace.stderr create mode 100644 Examples/test-suite/errors/cpp_macro_locator.stderr create mode 100644 Examples/test-suite/errors/cpp_missing_rparenthesis.stderr create mode 100644 Examples/test-suite/errors/cpp_missing_rtemplate.stderr create mode 100644 Examples/test-suite/errors/cpp_namespace_alias.stderr create mode 100644 Examples/test-suite/errors/cpp_namespace_aliasnot.stderr create mode 100644 Examples/test-suite/errors/cpp_namespace_aliasundef.stderr delete mode 100644 Examples/test-suite/errors/cpp_nested.i create mode 100644 Examples/test-suite/errors/cpp_nested_template.i create mode 100644 Examples/test-suite/errors/cpp_nested_template.stderr create mode 100644 Examples/test-suite/errors/cpp_no_access.stderr create mode 100644 Examples/test-suite/errors/cpp_no_return_type.stderr create mode 100644 Examples/test-suite/errors/cpp_nobase.stderr delete mode 100644 Examples/test-suite/errors/cpp_overload.i create mode 100644 Examples/test-suite/errors/cpp_overload_const.stderr delete mode 100644 Examples/test-suite/errors/cpp_private_defvalue.i create mode 100644 Examples/test-suite/errors/cpp_private_inherit.stderr create mode 100644 Examples/test-suite/errors/cpp_recursive_typedef.stderr create mode 100644 Examples/test-suite/errors/cpp_shared_ptr.stderr delete mode 100644 Examples/test-suite/errors/cpp_template_argname.i create mode 100644 Examples/test-suite/errors/cpp_template_friend.i create mode 100644 Examples/test-suite/errors/cpp_template_friend.stderr create mode 100644 Examples/test-suite/errors/cpp_template_nargs.stderr create mode 100644 Examples/test-suite/errors/cpp_template_not.stderr create mode 100644 Examples/test-suite/errors/cpp_template_partial.stderr create mode 100644 Examples/test-suite/errors/cpp_template_repeat.stderr create mode 100644 Examples/test-suite/errors/cpp_template_undef.stderr create mode 100644 Examples/test-suite/errors/cpp_using_not.stderr create mode 100644 Examples/test-suite/errors/cpp_using_type_aliasing.i create mode 100644 Examples/test-suite/errors/cpp_using_type_aliasing.stderr create mode 100644 Examples/test-suite/errors/cpp_using_undef.stderr delete mode 100644 Examples/test-suite/errors/expected.log delete mode 100755 Examples/test-suite/errors/make.sh create mode 100644 Examples/test-suite/errors/nomodule.stderr create mode 100644 Examples/test-suite/errors/pp_badeval.stderr create mode 100644 Examples/test-suite/errors/pp_constant.stderr create mode 100644 Examples/test-suite/errors/pp_defined.stderr create mode 100644 Examples/test-suite/errors/pp_deprecated.stderr create mode 100644 Examples/test-suite/errors/pp_illegal_argument.stderr delete mode 100644 Examples/test-suite/errors/pp_macro_args.i create mode 100644 Examples/test-suite/errors/pp_macro_badchar.stderr create mode 100644 Examples/test-suite/errors/pp_macro_defined_unterminated.stderr create mode 100644 Examples/test-suite/errors/pp_macro_expansion.stderr create mode 100644 Examples/test-suite/errors/pp_macro_expansion_multiline.stderr create mode 100644 Examples/test-suite/errors/pp_macro_inline_unterminated.stderr create mode 100644 Examples/test-suite/errors/pp_macro_missing_expression.stderr create mode 100644 Examples/test-suite/errors/pp_macro_nargs.stderr create mode 100644 Examples/test-suite/errors/pp_macro_redef.stderr create mode 100644 Examples/test-suite/errors/pp_macro_rparen.stderr create mode 100644 Examples/test-suite/errors/pp_macro_unexpected_tokens.stderr create mode 100644 Examples/test-suite/errors/pp_macro_unterminated.stderr create mode 100644 Examples/test-suite/errors/pp_misplaced_elif.stderr create mode 100644 Examples/test-suite/errors/pp_misplaced_else.stderr create mode 100644 Examples/test-suite/errors/pp_missing_enddef.stderr create mode 100644 Examples/test-suite/errors/pp_missing_endif.stderr create mode 100644 Examples/test-suite/errors/pp_missing_endoffile.i create mode 100644 Examples/test-suite/errors/pp_missing_endoffile.stderr create mode 100644 Examples/test-suite/errors/pp_missing_file.stderr create mode 100644 Examples/test-suite/errors/pp_missing_rblock.stderr create mode 100644 Examples/test-suite/errors/pp_pragma.stderr create mode 100644 Examples/test-suite/errors/pp_unknowndirective.i create mode 100644 Examples/test-suite/errors/pp_unknowndirective.stderr create mode 100644 Examples/test-suite/errors/pp_unknowndirective2.i create mode 100644 Examples/test-suite/errors/pp_unknowndirective2.stderr create mode 100644 Examples/test-suite/errors/pp_unterm_char.stderr create mode 100644 Examples/test-suite/errors/pp_unterm_comment.stderr create mode 100644 Examples/test-suite/errors/pp_unterm_string.stderr create mode 100644 Examples/test-suite/errors/pp_unterminated_block.i create mode 100644 Examples/test-suite/errors/pp_unterminated_block.stderr create mode 100644 Examples/test-suite/errors/pp_variable_args.stderr create mode 100644 Examples/test-suite/errors/swig_apply_nargs.stderr create mode 100644 Examples/test-suite/errors/swig_extend.stderr create mode 100644 Examples/test-suite/errors/swig_fragment_missing.i create mode 100644 Examples/test-suite/errors/swig_fragment_missing.stderr create mode 100644 Examples/test-suite/errors/swig_identifier.stderr create mode 100644 Examples/test-suite/errors/swig_insert_bad.stderr create mode 100644 Examples/test-suite/errors/swig_pythoncode_bad.i create mode 100644 Examples/test-suite/errors/swig_pythoncode_bad.stderr create mode 100644 Examples/test-suite/errors/swig_pythoncode_bad2.i create mode 100644 Examples/test-suite/errors/swig_pythoncode_bad2.stderr create mode 100644 Examples/test-suite/errors/swig_pythoncode_bad3.i create mode 100644 Examples/test-suite/errors/swig_pythoncode_bad3.stderr create mode 100644 Examples/test-suite/errors/swig_typemap_copy.stderr create mode 100644 Examples/test-suite/errors/swig_typemap_old.stderr create mode 100644 Examples/test-suite/errors/swig_typemap_warn.stderr create mode 100644 Examples/test-suite/exception_classname.i create mode 100644 Examples/test-suite/friends_template.i create mode 100644 Examples/test-suite/global_functions.i create mode 100644 Examples/test-suite/go/argout_runme.go create mode 100644 Examples/test-suite/go/cpp11_strongly_typed_enumerations_runme.go delete mode 100644 Examples/test-suite/go/director_abstract_runme.go delete mode 100644 Examples/test-suite/go/director_thread_runme.go create mode 100644 Examples/test-suite/go/empty_c_runme.go create mode 100644 Examples/test-suite/go/go_director_inout_runme.go create mode 100644 Examples/test-suite/go/go_inout_runme.go create mode 100644 Examples/test-suite/go/go_subdir_import_runme.go create mode 100644 Examples/test-suite/go/inherit_member_runme.go create mode 100644 Examples/test-suite/go/keyword_rename_c_runme.go create mode 100644 Examples/test-suite/go/li_carrays_cpp_runme.go create mode 100644 Examples/test-suite/go/li_cdata_cpp_runme.go create mode 100644 Examples/test-suite/go/li_cpointer_cpp_runme.go rename Examples/test-suite/go/{overload_extendc_runme.go => overload_extend2_runme.go} (86%) create mode 100644 Examples/test-suite/go/overload_extend_c_runme.go create mode 100644 Examples/test-suite/go/overload_polymorphic_runme.go delete mode 100644 Examples/test-suite/go/template_typedef_import_runme.go create mode 100644 Examples/test-suite/go_director_inout.i create mode 100644 Examples/test-suite/go_inout.i create mode 100644 Examples/test-suite/go_subdir_import.list create mode 100644 Examples/test-suite/go_subdir_import_a.i create mode 100644 Examples/test-suite/go_subdir_import_b.i create mode 100644 Examples/test-suite/guile/overload_extend_c_runme.scm create mode 100644 Examples/test-suite/infinity.i create mode 100644 Examples/test-suite/inherit_member.i create mode 100644 Examples/test-suite/java/constant_directive_runme.java create mode 100644 Examples/test-suite/java/cpp11_constexpr_runme.java create mode 100644 Examples/test-suite/java/cpp11_lambda_functions_runme.java create mode 100644 Examples/test-suite/java/cpp11_li_std_array_runme.java create mode 100644 Examples/test-suite/java/cpp11_result_of_runme.java create mode 100644 Examples/test-suite/java/cpp11_strongly_typed_enumerations_runme.java create mode 100644 Examples/test-suite/java/cpp11_strongly_typed_enumerations_simple_runme.java create mode 100644 Examples/test-suite/java/cpp11_thread_local_runme.java create mode 100644 Examples/test-suite/java/cpp11_type_aliasing_runme.java create mode 100644 Examples/test-suite/java/derived_nested_runme.java create mode 100644 Examples/test-suite/java/director_nested_class_runme.java create mode 100644 Examples/test-suite/java/director_pass_by_value_runme.java create mode 100644 Examples/test-suite/java/director_ref_runme.java create mode 100644 Examples/test-suite/java/friends_template_runme.java create mode 100644 Examples/test-suite/java/java_director_exception_feature_nspace_runme.java create mode 100644 Examples/test-suite/java/java_director_exception_feature_runme.java create mode 100644 Examples/test-suite/java/java_director_ptrclass_runme.java create mode 100644 Examples/test-suite/java/kwargs_feature_runme.java create mode 100644 Examples/test-suite/java/li_boost_shared_ptr_attribute_runme.java create mode 100644 Examples/test-suite/java/li_carrays_cpp_runme.java create mode 100644 Examples/test-suite/java/li_cdata_cpp_runme.java create mode 100644 Examples/test-suite/java/li_cdata_runme.java create mode 100644 Examples/test-suite/java/li_std_auto_ptr_runme.java create mode 100644 Examples/test-suite/java/multiple_inheritance_abstract_runme.java create mode 100644 Examples/test-suite/java/multiple_inheritance_interfaces_runme.java create mode 100644 Examples/test-suite/java/multiple_inheritance_nspace_runme.java create mode 100644 Examples/test-suite/java/multiple_inheritance_shared_ptr_runme.java create mode 100644 Examples/test-suite/java/naturalvar_more_runme.java create mode 100644 Examples/test-suite/java/naturalvar_onoff_runme.java create mode 100644 Examples/test-suite/java/nested_extend_c_runme.java create mode 100644 Examples/test-suite/java/nested_template_base_runme.java create mode 100644 Examples/test-suite/java/smart_pointer_ignore_runme.java create mode 100644 Examples/test-suite/java/template_templated_constructors_runme.java create mode 100644 Examples/test-suite/java/template_typedef_typedef_runme.java create mode 100644 Examples/test-suite/java_director_exception_feature.i create mode 100644 Examples/test-suite/java_director_exception_feature_nspace.i create mode 100644 Examples/test-suite/java_director_ptrclass.i create mode 100644 Examples/test-suite/javascript/Makefile.in create mode 100644 Examples/test-suite/javascript/abstract_access_runme.js create mode 100644 Examples/test-suite/javascript/abstract_inherit_runme.js create mode 100644 Examples/test-suite/javascript/abstract_typedef2_runme.js create mode 100644 Examples/test-suite/javascript/abstract_typedef_runme.js create mode 100644 Examples/test-suite/javascript/abstract_virtual_runme.js create mode 100644 Examples/test-suite/javascript/array_member_runme.js create mode 100644 Examples/test-suite/javascript/arrays_global_runme.js create mode 100644 Examples/test-suite/javascript/callback_runme.js create mode 100644 Examples/test-suite/javascript/char_binary_runme.js create mode 100644 Examples/test-suite/javascript/char_strings_runme.js create mode 100644 Examples/test-suite/javascript/class_ignore_runme.js create mode 100644 Examples/test-suite/javascript/class_scope_weird_runme.js create mode 100644 Examples/test-suite/javascript/complextest_runme.js create mode 100644 Examples/test-suite/javascript/constover_runme.js create mode 100644 Examples/test-suite/javascript/constructor_copy_runme.js create mode 100644 Examples/test-suite/javascript/cpp11_strongly_typed_enumerations_runme.js create mode 100644 Examples/test-suite/javascript/cpp_enum_runme.js create mode 100644 Examples/test-suite/javascript/cpp_namespace_runme.js create mode 100644 Examples/test-suite/javascript/cpp_static_runme.js create mode 100644 Examples/test-suite/javascript/director_alternating_runme.js create mode 100644 Examples/test-suite/javascript/disown_runme.js create mode 100644 Examples/test-suite/javascript/dynamic_cast_runme.js create mode 100644 Examples/test-suite/javascript/empty_c_runme.js create mode 100644 Examples/test-suite/javascript/empty_runme.js create mode 100644 Examples/test-suite/javascript/enum_template_runme.js create mode 100644 Examples/test-suite/javascript/infinity_runme.js create mode 100644 Examples/test-suite/javascript/namespace_virtual_method_runme.js create mode 100644 Examples/test-suite/javascript/node_template/binding.gyp.in create mode 100644 Examples/test-suite/javascript/node_template/index.js.in create mode 100644 Examples/test-suite/javascript/nspace_extend_runme.js create mode 100644 Examples/test-suite/javascript/nspace_runme.js create mode 100644 Examples/test-suite/javascript/null_pointer_runme.js create mode 100644 Examples/test-suite/javascript/overload_copy_runme.js create mode 100644 Examples/test-suite/javascript/preproc_include_runme.js create mode 100644 Examples/test-suite/javascript/preproc_runme.js create mode 100644 Examples/test-suite/javascript/rename1_runme.js create mode 100644 Examples/test-suite/javascript/rename2_runme.js create mode 100644 Examples/test-suite/javascript/rename3_runme.js create mode 100644 Examples/test-suite/javascript/rename4_runme.js create mode 100644 Examples/test-suite/javascript/rename_scope_runme.js create mode 100644 Examples/test-suite/javascript/rename_simple_runme.js create mode 100644 Examples/test-suite/javascript/ret_by_value_runme.js create mode 100644 Examples/test-suite/javascript/string_simple_runme.js create mode 100644 Examples/test-suite/javascript/struct_value_runme.js create mode 100644 Examples/test-suite/javascript/template_static_runme.js create mode 100644 Examples/test-suite/javascript/typedef_class_runme.js create mode 100644 Examples/test-suite/javascript/typedef_inherit_runme.js create mode 100644 Examples/test-suite/javascript/typedef_scope_runme.js create mode 100644 Examples/test-suite/javascript/typemap_arrays_runme.js create mode 100644 Examples/test-suite/javascript/typemap_delete_runme.js create mode 100644 Examples/test-suite/javascript/typemap_namespace_runme.js create mode 100644 Examples/test-suite/javascript/typemap_ns_using_runme.js create mode 100644 Examples/test-suite/javascript/using1_runme.js create mode 100644 Examples/test-suite/javascript/using2_runme.js create mode 100644 Examples/test-suite/javascript/varargs_runme.js create mode 100644 Examples/test-suite/keyword_rename_c.i create mode 100644 Examples/test-suite/li_boost_array.i create mode 100644 Examples/test-suite/li_boost_shared_ptr_attribute.i create mode 100644 Examples/test-suite/li_carrays_cpp.i create mode 100644 Examples/test-suite/li_cdata_carrays_cpp.i create mode 100644 Examples/test-suite/li_cdata_cpp.i create mode 100644 Examples/test-suite/li_cpointer_cpp.i create mode 100644 Examples/test-suite/li_std_auto_ptr.i create mode 100644 Examples/test-suite/li_std_container_typemaps.i create mode 100644 Examples/test-suite/li_swigtype_inout.i create mode 100644 Examples/test-suite/lua/array_member_runme.lua create mode 100644 Examples/test-suite/lua/arrays_global_runme.lua create mode 100644 Examples/test-suite/lua/chartest_runme.lua create mode 100644 Examples/test-suite/lua/cpp11_strongly_typed_enumerations_runme.lua create mode 100644 Examples/test-suite/lua/cpp_enum_runme.lua create mode 100644 Examples/test-suite/lua/cpp_namespace_runme.lua create mode 100644 Examples/test-suite/lua/cpp_nodefault_runme.lua create mode 100644 Examples/test-suite/lua/cpp_static_runme.lua create mode 100644 Examples/test-suite/lua/cpp_typedef_runme.lua create mode 100644 Examples/test-suite/lua/enum_plus_runme.lua create mode 100644 Examples/test-suite/lua/enum_rename_runme.lua create mode 100644 Examples/test-suite/lua/enum_scope_template_runme.lua create mode 100644 Examples/test-suite/lua/enum_template_runme.lua create mode 100644 Examples/test-suite/lua/equality_runme.lua create mode 100644 Examples/test-suite/lua/extend_constructor_destructor_runme.lua create mode 100644 Examples/test-suite/lua/extend_placement_runme.lua create mode 100644 Examples/test-suite/lua/extend_runme.lua create mode 100644 Examples/test-suite/lua/extend_template_runme.lua create mode 100644 Examples/test-suite/lua/extend_typedef_class_runme.lua create mode 100644 Examples/test-suite/lua/extend_variable_runme.lua create mode 100644 Examples/test-suite/lua/friends_runme.lua create mode 100644 Examples/test-suite/lua/funcptr_cpp_runme.lua create mode 100644 Examples/test-suite/lua/fvirtual_runme.lua create mode 100644 Examples/test-suite/lua/global_namespace_runme.lua create mode 100644 Examples/test-suite/lua/global_vars_runme.lua create mode 100644 Examples/test-suite/lua/grouping_runme.lua create mode 100644 Examples/test-suite/lua/iadd_runme.lua create mode 100644 Examples/test-suite/lua/inherit_missing_runme.lua create mode 100644 Examples/test-suite/lua/keyword_rename_c_runme.lua create mode 100644 Examples/test-suite/lua/keyword_rename_runme.lua create mode 100644 Examples/test-suite/lua/li_carrays_cpp_runme.lua create mode 100644 Examples/test-suite/lua/lua_inherit_getitem_runme.lua create mode 100644 Examples/test-suite/lua/nested_workaround_runme.lua create mode 100644 Examples/test-suite/lua/nspace_extend_runme.lua create mode 100644 Examples/test-suite/lua/nspace_runme.lua create mode 100644 Examples/test-suite/lua/overload_complicated_runme.lua create mode 100644 Examples/test-suite/lua/refcount_runme.lua create mode 100644 Examples/test-suite/lua/rename_simple_runme.lua create mode 100644 Examples/test-suite/lua/smart_pointer_extend_runme.lua create mode 100644 Examples/test-suite/lua/smart_pointer_inherit_runme.lua create mode 100644 Examples/test-suite/lua/smart_pointer_multi_runme.lua create mode 100644 Examples/test-suite/lua/smart_pointer_not_runme.lua create mode 100644 Examples/test-suite/lua/smart_pointer_rename_runme.lua create mode 100644 Examples/test-suite/lua/smart_pointer_simple_runme.lua create mode 100644 Examples/test-suite/lua/smart_pointer_templatemethods_runme.lua create mode 100644 Examples/test-suite/lua/static_const_member_2_runme.lua create mode 100644 Examples/test-suite/lua/static_const_member_runme.lua create mode 100644 Examples/test-suite/lua/template_construct_runme.lua create mode 100644 Examples/test-suite/lua/template_extend1_runme.lua create mode 100644 Examples/test-suite/lua/template_extend2_runme.lua create mode 100644 Examples/test-suite/lua/template_inherit_runme.lua create mode 100644 Examples/test-suite/lua/template_static_runme.lua create mode 100644 Examples/test-suite/lua/valuewrapper_runme.lua create mode 100644 Examples/test-suite/lua/varargs_runme.lua create mode 100644 Examples/test-suite/lua_inherit_getitem.i create mode 100644 Examples/test-suite/multiple_inheritance_abstract.i create mode 100644 Examples/test-suite/multiple_inheritance_interfaces.i create mode 100644 Examples/test-suite/multiple_inheritance_nspace.i create mode 100644 Examples/test-suite/multiple_inheritance_shared_ptr.i create mode 100644 Examples/test-suite/naturalvar_more.i create mode 100644 Examples/test-suite/naturalvar_onoff.i create mode 100644 Examples/test-suite/nested_directors.i create mode 100644 Examples/test-suite/nested_extend_c.i create mode 100644 Examples/test-suite/nested_private.i create mode 100644 Examples/test-suite/nested_scope.i create mode 100644 Examples/test-suite/nested_template_base.i mode change 100755 => 100644 Examples/test-suite/ocaml/makedebugtop create mode 100644 Examples/test-suite/octave/cpp11_strongly_typed_enumerations_runme.m create mode 100644 Examples/test-suite/octave/empty_c_runme.m mode change 100755 => 100644 Examples/test-suite/octave/iadd_runme.m create mode 100644 Examples/test-suite/octave/li_boost_shared_ptr_runme.m create mode 100644 Examples/test-suite/octave/li_carrays_cpp_runme.m create mode 100644 Examples/test-suite/octave/li_cpointer_cpp_runme.m create mode 100644 Examples/test-suite/octave/nested_structs_runme.m mode change 100755 => 100644 Examples/test-suite/octave/overload_complicated_runme.m rename Examples/test-suite/octave/{overload_extendc_runme.m => overload_extend2_runme.m} (88%) create mode 100644 Examples/test-suite/octave/overload_extend_c_runme.m create mode 100644 Examples/test-suite/overload_arrays.i create mode 100644 Examples/test-suite/overload_bool.i rename Examples/test-suite/{overload_extendc.i => overload_extend2.i} (94%) create mode 100644 Examples/test-suite/overload_extend_c.i create mode 100644 Examples/test-suite/overload_polymorphic.i mode change 100755 => 100644 Examples/test-suite/perl5/char_binary_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/class_ignore_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/contract_runme.pl create mode 100644 Examples/test-suite/perl5/cpp11_strongly_typed_enumerations_runme.pl create mode 100644 Examples/test-suite/perl5/director_abstract_runme.pl create mode 100644 Examples/test-suite/perl5/director_alternating_runme.pl create mode 100644 Examples/test-suite/perl5/director_basic_runme.pl create mode 100644 Examples/test-suite/perl5/director_classes_runme.pl create mode 100644 Examples/test-suite/perl5/director_classic_runme.pl create mode 100644 Examples/test-suite/perl5/director_constructor_runme.pl create mode 100644 Examples/test-suite/perl5/director_default_runme.pl create mode 100644 Examples/test-suite/perl5/director_detect_runme.pl create mode 100644 Examples/test-suite/perl5/director_enum_runme.pl create mode 100644 Examples/test-suite/perl5/director_exception_runme.pl create mode 100644 Examples/test-suite/perl5/director_extend_runme.pl create mode 100644 Examples/test-suite/perl5/director_finalizer_runme.pl create mode 100644 Examples/test-suite/perl5/director_frob_runme.pl create mode 100644 Examples/test-suite/perl5/director_ignore_runme.pl create mode 100644 Examples/test-suite/perl5/director_nested_runme.pl create mode 100644 Examples/test-suite/perl5/director_primitives_runme.pl create mode 100644 Examples/test-suite/perl5/director_protected_runme.pl create mode 100644 Examples/test-suite/perl5/director_string_runme.pl create mode 100644 Examples/test-suite/perl5/director_unroll_runme.pl create mode 100644 Examples/test-suite/perl5/director_wombat_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/enum_template_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/grouping_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/ignore_parameter_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/inherit_missing_runme.pl create mode 100644 Examples/test-suite/perl5/li_carrays_cpp_runme.pl create mode 100644 Examples/test-suite/perl5/li_cdata_carrays_cpp_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/li_std_except_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/minherit_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/naturalvar_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/preproc_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/primitive_types_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/reference_global_vars_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/rename_scope_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/return_const_value_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/run-perl-test.pl mode change 100755 => 100644 Examples/test-suite/perl5/sizet_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/sneaky1_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/template_typedef_cplx2_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/typedef_class_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/typename_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/using1_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/using2_runme.pl mode change 100755 => 100644 Examples/test-suite/perl5/wrapmacro_runme.pl delete mode 100644 Examples/test-suite/php/autodoc_runme.php create mode 100644 Examples/test-suite/php/callback_runme.php create mode 100644 Examples/test-suite/php/cpp11_strongly_typed_enumerations_runme.php create mode 100644 Examples/test-suite/php/director_pass_by_value_runme.php create mode 100644 Examples/test-suite/php/li_carrays_cpp_runme.php create mode 100644 Examples/test-suite/php/php_iterator_runme.php mode change 100755 => 100644 Examples/test-suite/php/threads_exception_runme.php create mode 100644 Examples/test-suite/php_iterator.i create mode 100644 Examples/test-suite/python/constant_directive_runme.py create mode 100644 Examples/test-suite/python/cpp11_alternate_function_syntax_runme.py create mode 100644 Examples/test-suite/python/cpp11_decltype_runme.py create mode 100644 Examples/test-suite/python/cpp11_function_objects_runme.py create mode 100644 Examples/test-suite/python/cpp11_initializer_list_extend_runme.py create mode 100644 Examples/test-suite/python/cpp11_initializer_list_runme.py create mode 100644 Examples/test-suite/python/cpp11_li_std_array_runme.py create mode 100644 Examples/test-suite/python/cpp11_null_pointer_constant_runme.py create mode 100644 Examples/test-suite/python/cpp11_raw_string_literals_runme.py create mode 100644 Examples/test-suite/python/cpp11_result_of_runme.py create mode 100644 Examples/test-suite/python/cpp11_rvalue_reference_runme.py create mode 100644 Examples/test-suite/python/cpp11_strongly_typed_enumerations_runme.py create mode 100644 Examples/test-suite/python/cpp11_thread_local_runme.py create mode 100644 Examples/test-suite/python/cpp11_type_traits_runme.py create mode 100644 Examples/test-suite/python/cpp11_uniform_initialization_runme.py create mode 100644 Examples/test-suite/python/default_args_c_runme.py create mode 100644 Examples/test-suite/python/director_keywords_runme.py create mode 100644 Examples/test-suite/python/director_pass_by_value_runme.py create mode 100644 Examples/test-suite/python/director_property_runme.py create mode 100644 Examples/test-suite/python/director_smartptr_runme.py create mode 100644 Examples/test-suite/python/empty_c_runme.py create mode 100644 Examples/test-suite/python/exception_classname_runme.py create mode 100644 Examples/test-suite/python/global_functions_runme.py create mode 100644 Examples/test-suite/python/global_vars_runme.py create mode 100644 Examples/test-suite/python/keyword_rename_c_runme.py create mode 100644 Examples/test-suite/python/li_boost_array_runme.py create mode 100644 Examples/test-suite/python/li_carrays_cpp_runme.py create mode 100644 Examples/test-suite/python/li_cdata_cpp_runme.py create mode 100644 Examples/test-suite/python/li_cpointer_cpp_runme.py create mode 100644 Examples/test-suite/python/li_std_auto_ptr_runme.py create mode 100644 Examples/test-suite/python/nested_template_base_runme.py create mode 100644 Examples/test-suite/python/operator_overload_runme.py create mode 100644 Examples/test-suite/python/overload_bool_runme.py rename Examples/test-suite/python/{overload_extendc_runme.py => overload_extend2_runme.py} (56%) create mode 100644 Examples/test-suite/python/overload_extend_c_runme.py create mode 100644 Examples/test-suite/python/python_destructor_exception_runme.py create mode 100644 Examples/test-suite/python/python_docstring_runme.py create mode 100644 Examples/test-suite/python/python_pythoncode_runme.py create mode 100644 Examples/test-suite/python/python_strict_unicode_runme.py create mode 100644 Examples/test-suite/python/python_threads_runme.py create mode 100644 Examples/test-suite/python/rename_predicates_runme.py create mode 100644 Examples/test-suite/python/rename_rstrip_encoder_runme.py create mode 100644 Examples/test-suite/python/template_classes_runme.py create mode 100644 Examples/test-suite/python/template_default_arg_overloaded_extend_runme.py create mode 100644 Examples/test-suite/python/template_default_arg_overloaded_runme.py create mode 100644 Examples/test-suite/python/typedef_typedef_runme.py create mode 100644 Examples/test-suite/python/unicode_strings_runme.py create mode 100644 Examples/test-suite/python_destructor_exception.i create mode 100644 Examples/test-suite/python_docstring.i create mode 100644 Examples/test-suite/python_pythoncode.i create mode 100644 Examples/test-suite/python_strict_unicode.i create mode 100644 Examples/test-suite/python_threads.i create mode 100644 Examples/test-suite/r/li_std_vector_runme.R create mode 100644 Examples/test-suite/r/preproc_constants_runme.R create mode 100644 Examples/test-suite/rename_predicates.i create mode 100644 Examples/test-suite/rename_rstrip_encoder.i mode change 100755 => 100644 Examples/test-suite/ruby/abstract_access_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/access_change_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/add_link_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/anonymous_bitfield_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/apply_signed_char_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/apply_strings_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/argout_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/arrays_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/cast_operator_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/casts_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/check_missing_tests.rb mode change 100755 => 100644 Examples/test-suite/ruby/class_ignore_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/const_const_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/constover_runme.rb create mode 100644 Examples/test-suite/ruby/cpp11_li_std_array_runme.rb create mode 100644 Examples/test-suite/ruby/cpp11_strongly_typed_enumerations_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/cpp_namespace_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/default_constructor_runme.rb create mode 100644 Examples/test-suite/ruby/director_smartptr_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/dynamic_cast_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/enum_thorough_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/function_typedef_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/imports_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/integers_runme.rb create mode 100644 Examples/test-suite/ruby/li_boost_array_runme.rb create mode 100644 Examples/test-suite/ruby/li_boost_shared_ptr_bits_runme.rb create mode 100644 Examples/test-suite/ruby/li_boost_shared_ptr_runme.rb create mode 100644 Examples/test-suite/ruby/li_boost_shared_ptr_template_runme.rb create mode 100644 Examples/test-suite/ruby/li_carrays_cpp_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/li_cstring_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/li_math_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/li_std_functors_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/li_std_map_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/li_std_multimap_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/li_std_pair_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/li_std_queue_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/li_std_set_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/li_std_speed2_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/li_std_stack_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/li_std_stream_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/li_std_vector_enum_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/li_std_vector_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/namespace_typemap_runme.rb create mode 100644 Examples/test-suite/ruby/overload_bool_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/overload_copy_runme.rb create mode 100644 Examples/test-suite/ruby/overload_extend2_runme.rb rename Examples/test-suite/ruby/{overload_extendc_runme.rb => overload_extend_c_runme.rb} (77%) mode change 100755 => 100644 mode change 100755 => 100644 Examples/test-suite/ruby/overload_extend_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/overload_simple_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/overload_template_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/primitive_ref_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/ruby_li_std_speed_runme.rb create mode 100644 Examples/test-suite/ruby/ruby_manual_proxy_runme.rb create mode 100644 Examples/test-suite/ruby/ruby_minherit_shared_ptr_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/sneaky1_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/std_containers_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/stl_new_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/swig_assert.rb mode change 100755 => 100644 Examples/test-suite/ruby/swig_gc.rb mode change 100755 => 100644 Examples/test-suite/ruby/template_inherit_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/template_ns4_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/template_ns_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/template_rename_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/typedef_inherit_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/typedef_scope_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/typemap_namespace_runme.rb mode change 100755 => 100644 Examples/test-suite/ruby/typename_runme.rb create mode 100644 Examples/test-suite/ruby_manual_proxy.i create mode 100644 Examples/test-suite/ruby_minherit_shared_ptr.i create mode 100644 Examples/test-suite/schemerunme/overload_extend_c.scm create mode 100644 Examples/test-suite/scilab/Makefile.in create mode 100644 Examples/test-suite/scilab/abstract_access_runme.sci create mode 100644 Examples/test-suite/scilab/abstract_inherit_ok_runme.sci create mode 100644 Examples/test-suite/scilab/abstract_inherit_runme.sci create mode 100644 Examples/test-suite/scilab/abstract_signature_runme.sci create mode 100644 Examples/test-suite/scilab/abstract_typedef2_runme.sci create mode 100644 Examples/test-suite/scilab/abstract_typedef_runme.sci create mode 100644 Examples/test-suite/scilab/abstract_virtual_runme.sci create mode 100644 Examples/test-suite/scilab/access_change_runme.sci create mode 100644 Examples/test-suite/scilab/add_link_runme.sci create mode 100644 Examples/test-suite/scilab/aggregate_runme.sci create mode 100644 Examples/test-suite/scilab/allowexcept_runme.sci create mode 100644 Examples/test-suite/scilab/allprotected_runme.sci create mode 100644 Examples/test-suite/scilab/anonymous_bitfield_runme.sci create mode 100644 Examples/test-suite/scilab/apply_signed_char_runme.sci create mode 100644 Examples/test-suite/scilab/apply_strings_runme.sci create mode 100644 Examples/test-suite/scilab/array_member_runme.sci create mode 100644 Examples/test-suite/scilab/arrays_dimensionless_runme.sci create mode 100644 Examples/test-suite/scilab/arrays_global_runme.sci create mode 100644 Examples/test-suite/scilab/arrays_global_twodim_runme.sci create mode 100644 Examples/test-suite/scilab/bools_runme.sci create mode 100644 Examples/test-suite/scilab/char_constant_runme.sci create mode 100644 Examples/test-suite/scilab/constover_runme.sci create mode 100644 Examples/test-suite/scilab/constructor_copy_runme.sci create mode 100644 Examples/test-suite/scilab/cpp_basic_runme.sci create mode 100644 Examples/test-suite/scilab/cpp_enum_runme.sci create mode 100644 Examples/test-suite/scilab/default_args_runme.sci create mode 100644 Examples/test-suite/scilab/default_constructor_runme.sci create mode 100644 Examples/test-suite/scilab/empty_c_runme.sci create mode 100644 Examples/test-suite/scilab/empty_runme.sci create mode 100644 Examples/test-suite/scilab/enums_runme.sci create mode 100644 Examples/test-suite/scilab/funcptr_cpp_runme.sci create mode 100644 Examples/test-suite/scilab/funcptr_runme.sci create mode 100644 Examples/test-suite/scilab/global_vars_runme.sci create mode 100644 Examples/test-suite/scilab/inctest_runme.sci create mode 100644 Examples/test-suite/scilab/inherit_missing_runme.sci create mode 100644 Examples/test-suite/scilab/inout_runme.sci create mode 100644 Examples/test-suite/scilab/integers_runme.sci create mode 100644 Examples/test-suite/scilab/li_carrays_cpp_runme.sci create mode 100644 Examples/test-suite/scilab/li_carrays_runme.sci create mode 100644 Examples/test-suite/scilab/li_cpointer_cpp_runme.sci create mode 100644 Examples/test-suite/scilab/li_cpointer_runme.sci create mode 100644 Examples/test-suite/scilab/li_math_runme.sci create mode 100644 Examples/test-suite/scilab/li_std_container_typemaps_runme.sci create mode 100644 Examples/test-suite/scilab/li_std_deque_runme.sci create mode 100644 Examples/test-suite/scilab/li_std_except_runme.sci create mode 100644 Examples/test-suite/scilab/li_std_pair_runme.sci create mode 100644 Examples/test-suite/scilab/li_std_string_extra_runme.sci create mode 100644 Examples/test-suite/scilab/li_std_vector_runme.sci create mode 100644 Examples/test-suite/scilab/li_typemaps_runme.sci create mode 100644 Examples/test-suite/scilab/member_pointer_runme.sci create mode 100644 Examples/test-suite/scilab/name_runme.sci create mode 100644 Examples/test-suite/scilab/nested_structs_runme.sci create mode 100644 Examples/test-suite/scilab/newobject2_runme.sci create mode 100644 Examples/test-suite/scilab/null_pointer_runme.sci create mode 100644 Examples/test-suite/scilab/operator_overload_runme.sci create mode 100644 Examples/test-suite/scilab/overload_arrays_runme.sci create mode 100644 Examples/test-suite/scilab/overload_complicated_runme.sci create mode 100644 Examples/test-suite/scilab/overload_copy_runme.sci create mode 100644 Examples/test-suite/scilab/overload_extend2_runme.sci create mode 100644 Examples/test-suite/scilab/overload_extend_c_runme.sci create mode 100644 Examples/test-suite/scilab/overload_extend_runme.sci create mode 100644 Examples/test-suite/scilab/overload_numeric_runme.sci create mode 100644 Examples/test-suite/scilab/overload_polymorphic_runme.sci create mode 100644 Examples/test-suite/scilab/overload_simple_runme.sci create mode 100644 Examples/test-suite/scilab/overload_subtype_runme.sci create mode 100644 Examples/test-suite/scilab/preproc_constants_runme.sci create mode 100644 Examples/test-suite/scilab/preproc_runme.sci create mode 100644 Examples/test-suite/scilab/primitive_ref_runme.sci create mode 100644 Examples/test-suite/scilab/primitive_types_runme.sci create mode 100644 Examples/test-suite/scilab/ret_by_value_runme.sci create mode 100644 Examples/test-suite/scilab/return_const_value_runme.sci create mode 100644 Examples/test-suite/scilab/scilab_consts_runme.sci create mode 100644 Examples/test-suite/scilab/scilab_enums_runme.sci create mode 100644 Examples/test-suite/scilab/scilab_identifier_name_runme.sci create mode 100644 Examples/test-suite/scilab/scilab_li_matrix_runme.sci create mode 100644 Examples/test-suite/scilab/scilab_multivalue_runme.sci create mode 100644 Examples/test-suite/scilab/scilab_pointer_conversion_functions_runme.sci create mode 100644 Examples/test-suite/scilab/simple_array_runme.sci create mode 100644 Examples/test-suite/scilab/sizet_runme.sci create mode 100644 Examples/test-suite/scilab/smart_pointer_simple_runme.sci create mode 100644 Examples/test-suite/scilab/sneaky1_runme.sci create mode 100644 Examples/test-suite/scilab/struct_initialization_runme.sci create mode 100644 Examples/test-suite/scilab/struct_rename_runme.sci create mode 100644 Examples/test-suite/scilab/struct_value_runme.sci create mode 100644 Examples/test-suite/scilab/swigtest.quit create mode 100644 Examples/test-suite/scilab/swigtest.start create mode 100644 Examples/test-suite/scilab/template_classes_runme.sci create mode 100644 Examples/test-suite/scilab/template_ns_runme.sci create mode 100644 Examples/test-suite/scilab/template_rename_runme.sci create mode 100644 Examples/test-suite/scilab/template_static_runme.sci create mode 100644 Examples/test-suite/scilab/throw_exception_runme.sci create mode 100644 Examples/test-suite/scilab/typedef_struct_cpp_runme.sci create mode 100644 Examples/test-suite/scilab/typedef_struct_runme.sci create mode 100644 Examples/test-suite/scilab/union_parameter_runme.sci create mode 100644 Examples/test-suite/scilab/unions_runme.sci create mode 100644 Examples/test-suite/scilab/varargs_overload_runme.sci create mode 100644 Examples/test-suite/scilab/varargs_runme.sci create mode 100644 Examples/test-suite/scilab/voidtest_runme.sci create mode 100644 Examples/test-suite/scilab_consts.i create mode 100644 Examples/test-suite/scilab_enums.i create mode 100644 Examples/test-suite/scilab_identifier_name.i create mode 100644 Examples/test-suite/scilab_li_matrix.i create mode 100644 Examples/test-suite/scilab_multivalue.i create mode 100644 Examples/test-suite/scilab_pointer_conversion_functions.i create mode 100644 Examples/test-suite/smart_pointer_ignore.i create mode 100644 Examples/test-suite/smart_pointer_template_defaults_overload.i create mode 100644 Examples/test-suite/special_variable_attributes.i create mode 100644 Examples/test-suite/string_constants.i create mode 100644 Examples/test-suite/string_simple.i create mode 100644 Examples/test-suite/tcl/cpp11_strongly_typed_enumerations_runme.tcl create mode 100644 Examples/test-suite/template_default_arg_overloaded.i create mode 100644 Examples/test-suite/template_default_arg_overloaded_extend.i create mode 100644 Examples/test-suite/template_keyword_in_type.i create mode 100644 Examples/test-suite/template_private_assignment.i create mode 100644 Examples/test-suite/template_templated_constructors.i create mode 100644 Examples/test-suite/template_typedef_typedef.i create mode 100644 Examples/test-suite/testdir/go_subdir_import/go_subdir_import_c.i create mode 100644 Examples/test-suite/typedef_struct_cpp.i create mode 100644 Examples/test-suite/typedef_typedef.i create mode 100644 Examples/test-suite/unicode_strings.i create mode 100644 Lib/csharp/std_auto_ptr.i create mode 100644 Lib/csharp/swiginterface.i create mode 100644 Lib/csharp/swigtype_inout.i create mode 100644 Lib/director_common.swg create mode 100644 Lib/go/gostring.swg create mode 100644 Lib/java/std_array.i create mode 100644 Lib/java/std_auto_ptr.i create mode 100644 Lib/java/swiginterface.i create mode 100644 Lib/javascript/jsc/arrays_javascript.i create mode 100644 Lib/javascript/jsc/ccomplex.i create mode 100644 Lib/javascript/jsc/cdata.i create mode 100644 Lib/javascript/jsc/complex.i create mode 100644 Lib/javascript/jsc/exception.i create mode 100644 Lib/javascript/jsc/javascript.swg create mode 100644 Lib/javascript/jsc/javascriptcode.swg create mode 100644 Lib/javascript/jsc/javascriptcomplex.swg create mode 100644 Lib/javascript/jsc/javascriptfragments.swg create mode 100644 Lib/javascript/jsc/javascripthelpers.swg create mode 100644 Lib/javascript/jsc/javascriptinit.swg create mode 100644 Lib/javascript/jsc/javascriptkw.swg create mode 100644 Lib/javascript/jsc/javascriptprimtypes.swg create mode 100644 Lib/javascript/jsc/javascriptrun.swg create mode 100644 Lib/javascript/jsc/javascriptruntime.swg create mode 100644 Lib/javascript/jsc/javascriptstrings.swg create mode 100644 Lib/javascript/jsc/javascripttypemaps.swg create mode 100644 Lib/javascript/jsc/std_common.i create mode 100644 Lib/javascript/jsc/std_complex.i create mode 100644 Lib/javascript/jsc/std_deque.i create mode 100644 Lib/javascript/jsc/std_except.i create mode 100644 Lib/javascript/jsc/std_map.i create mode 100644 Lib/javascript/jsc/std_pair.i create mode 100644 Lib/javascript/jsc/std_string.i create mode 100644 Lib/javascript/jsc/std_vector.i create mode 100644 Lib/javascript/jsc/stl.i create mode 100644 Lib/javascript/jsc/typemaps.i create mode 100644 Lib/javascript/v8/arrays_javascript.i create mode 100644 Lib/javascript/v8/ccomplex.i create mode 100644 Lib/javascript/v8/cdata.i create mode 100644 Lib/javascript/v8/complex.i create mode 100644 Lib/javascript/v8/exception.i create mode 100644 Lib/javascript/v8/javascript.swg create mode 100644 Lib/javascript/v8/javascriptcode.swg create mode 100644 Lib/javascript/v8/javascriptcomplex.swg create mode 100644 Lib/javascript/v8/javascriptfragments.swg create mode 100644 Lib/javascript/v8/javascripthelpers.swg create mode 100644 Lib/javascript/v8/javascriptinit.swg create mode 100644 Lib/javascript/v8/javascriptkw.swg create mode 100644 Lib/javascript/v8/javascriptprimtypes.swg create mode 100644 Lib/javascript/v8/javascriptrun.swg create mode 100644 Lib/javascript/v8/javascriptruntime.swg create mode 100644 Lib/javascript/v8/javascriptstrings.swg create mode 100644 Lib/javascript/v8/javascripttypemaps.swg create mode 100644 Lib/javascript/v8/std_common.i create mode 100644 Lib/javascript/v8/std_complex.i create mode 100644 Lib/javascript/v8/std_deque.i create mode 100644 Lib/javascript/v8/std_except.i create mode 100644 Lib/javascript/v8/std_map.i create mode 100644 Lib/javascript/v8/std_pair.i create mode 100644 Lib/javascript/v8/std_string.i create mode 100644 Lib/javascript/v8/std_vector.i create mode 100644 Lib/javascript/v8/stl.i create mode 100644 Lib/javascript/v8/typemaps.i create mode 100644 Lib/lua/luakw.swg rename Lib/ocaml/{swigp4.ml.in => swigp4.ml} (100%) create mode 100644 Lib/octave/std_shared_ptr.i create mode 100644 Lib/perl5/director.swg delete mode 100644 Lib/python/embed15.i create mode 100644 Lib/python/std_array.i create mode 100644 Lib/python/std_auto_ptr.i create mode 100644 Lib/python/std_unordered_map.i create mode 100644 Lib/python/std_unordered_multimap.i create mode 100644 Lib/python/std_unordered_multiset.i create mode 100644 Lib/python/std_unordered_set.i create mode 100644 Lib/ruby/boost_shared_ptr.i create mode 100644 Lib/ruby/std_array.i create mode 100644 Lib/ruby/std_shared_ptr.i create mode 100644 Lib/scilab/boost_shared_ptr.i create mode 100644 Lib/scilab/carrays.i create mode 100644 Lib/scilab/cmalloc.i create mode 100644 Lib/scilab/cpointer.i create mode 100644 Lib/scilab/exception.i create mode 100644 Lib/scilab/matrix.i create mode 100644 Lib/scilab/sciarray.swg create mode 100644 Lib/scilab/scibool.swg create mode 100644 Lib/scilab/scichar.swg create mode 100644 Lib/scilab/scicontainer.swg create mode 100644 Lib/scilab/scidouble.swg create mode 100644 Lib/scilab/scienum.swg create mode 100644 Lib/scilab/sciexception.swg create mode 100644 Lib/scilab/scifloat.swg create mode 100644 Lib/scilab/sciint.swg create mode 100644 Lib/scilab/sciiterators.swg create mode 100644 Lib/scilab/scilab.swg create mode 100644 Lib/scilab/scilist.swg create mode 100644 Lib/scilab/scilong.swg create mode 100644 Lib/scilab/scilonglong.swg create mode 100644 Lib/scilab/scimacros.swg create mode 100644 Lib/scilab/scimatrixbool.swg create mode 100644 Lib/scilab/scimatrixchar.swg create mode 100644 Lib/scilab/scimatrixdouble.swg create mode 100644 Lib/scilab/scimatrixint.swg create mode 100644 Lib/scilab/scimisctypes.swg create mode 100644 Lib/scilab/scipointer.swg create mode 100644 Lib/scilab/sciprimtypes.swg create mode 100644 Lib/scilab/scirun.swg create mode 100644 Lib/scilab/sciruntime.swg create mode 100644 Lib/scilab/scisequence.swg create mode 100644 Lib/scilab/scisequencebool.swg create mode 100644 Lib/scilab/scisequencedouble.swg create mode 100644 Lib/scilab/scisequencefloat.swg create mode 100644 Lib/scilab/scisequenceint.swg create mode 100644 Lib/scilab/scisequencepointer.swg create mode 100644 Lib/scilab/scisequencestring.swg create mode 100644 Lib/scilab/scishort.swg create mode 100644 Lib/scilab/scisignedchar.swg create mode 100644 Lib/scilab/scistdcommon.swg create mode 100644 Lib/scilab/scitypemaps.swg create mode 100644 Lib/scilab/sciunsignedchar.swg create mode 100644 Lib/scilab/sciunsignedint.swg create mode 100644 Lib/scilab/sciunsignedlong.swg create mode 100644 Lib/scilab/sciunsignedshort.swg create mode 100644 Lib/scilab/std_alloc.i create mode 100644 Lib/scilab/std_basic_string.i create mode 100644 Lib/scilab/std_char_traits.i create mode 100644 Lib/scilab/std_common.i create mode 100644 Lib/scilab/std_container.i create mode 100644 Lib/scilab/std_deque.i create mode 100644 Lib/scilab/std_except.i create mode 100644 Lib/scilab/std_list.i create mode 100644 Lib/scilab/std_map.i create mode 100644 Lib/scilab/std_multiset.i create mode 100644 Lib/scilab/std_pair.i create mode 100644 Lib/scilab/std_set.i create mode 100644 Lib/scilab/std_string.i create mode 100644 Lib/scilab/std_vector.i create mode 100644 Lib/scilab/stl.i create mode 100644 Lib/scilab/typemaps.i create mode 100644 Lib/std/std_array.i create mode 100644 Lib/std/std_unordered_map.i create mode 100644 Lib/std/std_unordered_multimap.i create mode 100644 Lib/std/std_unordered_multiset.i create mode 100644 Lib/std/std_unordered_set.i create mode 100644 Source/Modules/interface.cxx create mode 100644 Source/Modules/javascript.cxx create mode 100644 Source/Modules/nested.cxx create mode 100644 Source/Modules/scilab.cxx create mode 100644 Source/Swig/extend.c create mode 100755 Tools/brew-install delete mode 100644 Tools/config/ac_compare_version.m4 create mode 100644 Tools/config/ax_cxx_compile_stdcxx_11.m4 create mode 100755 Tools/convertpath create mode 100644 Tools/javascript/Makefile.in create mode 100644 Tools/javascript/javascript.cxx create mode 100644 Tools/javascript/js_shell.cxx create mode 100644 Tools/javascript/js_shell.h create mode 100644 Tools/javascript/jsc_shell.cxx create mode 100644 Tools/javascript/v8_shell.cxx create mode 100644 Tools/nuget-install.cmd create mode 100755 Tools/obs-buildlogs.py create mode 100755 Tools/obs-update create mode 100755 Tools/testflags.py create mode 100755 Tools/travis-linux-install.sh create mode 100755 Tools/travis-osx-install.sh create mode 100644 appveyor.yml mode change 100755 => 100644 preinst-swig.in diff --git a/ANNOUNCE b/ANNOUNCE index 06a24cc..5fec2f4 100644 --- a/ANNOUNCE +++ b/ANNOUNCE @@ -1,8 +1,8 @@ -*** ANNOUNCE: SWIG 2.0.12 (9 Feb 2014) *** +*** ANNOUNCE: SWIG 3.0.10 (12 Jun 2016) *** http://www.swig.org -We're pleased to announce SWIG-2.0.12, the latest SWIG release. +We're pleased to announce SWIG-3.0.10, the latest SWIG release. What is SWIG? ============= @@ -10,22 +10,28 @@ What is SWIG? SWIG is a software development tool that reads C/C++ header files and generates the wrapper code needed to make C and C++ code accessible from other programming languages including Perl, Python, Tcl, Ruby, -PHP, C#, Go, Java, Lua, Scheme (Guile, MzScheme, CHICKEN), D, Ocaml, -Pike, Modula-3, Octave, R, Common Lisp (CLISP, Allegro CL, CFFI, UFFI). -SWIG can also export its parse tree in the form of XML and Lisp -s-expressions. Major applications of SWIG include generation of -scripting language extension modules, rapid prototyping, testing, -and user interface development for large C/C++ systems. +PHP, C#, Go, Java, Javascript, Lua, Scheme (Guile, MzScheme, CHICKEN), +D, Ocaml, Pike, Modula-3, Octave, R, Scilab, Common Lisp (CLISP, +Allegro CL, CFFI, UFFI). SWIG can also export its parse tree in +the form of XML and Lisp s-expressions. Major applications of SWIG +include generation of scripting language extension modules, rapid +prototyping, testing, and user interface development for large +C/C++ systems. + +Release Notes +============= +Detailed release notes are available with the release and are also +published on the SWIG web site at http://swig.org/release.html. Availability ============ The release is available for download on Sourceforge at - http://prdownloads.sourceforge.net/swig/swig-2.0.12.tar.gz + http://prdownloads.sourceforge.net/swig/swig-3.0.10.tar.gz A Windows version is also available at - http://prdownloads.sourceforge.net/swig/swigwin-2.0.12.zip + http://prdownloads.sourceforge.net/swig/swigwin-3.0.10.zip Please report problems with this release to the swig-devel mailing list, details at http://www.swig.org/mail.html. diff --git a/CCache/Makefile.in b/CCache/Makefile.in index d8f9042..67fd3f3 100644 --- a/CCache/Makefile.in +++ b/CCache/Makefile.in @@ -14,7 +14,7 @@ NOSOFTLINKSTEST= CC=@CC@ CFLAGS=@CFLAGS@ -I. SWIG=swig -SWIG_LIB=../../Lib +SWIG_LIB=../$(srcdir)/../Lib EXEEXT=@EXEEXT@ # Use standard autoconf approach to transform executable name using --program-prefix and --program-suffix @@ -27,38 +27,44 @@ HEADERS = ccache.h mdfour.h all: $(PACKAGE_NAME)$(EXEEXT) +# Regenerate Makefile if Makefile.in or config.status have changed. +Makefile: $(srcdir)/Makefile.in ./config.status + $(SHELL) ./config.status + # Note that HTML documentation is actually generated and used from the main SWIG documentation Makefile -docs: $(PACKAGE_NAME).1 web/ccache-man.html +docs: $(srcdir)/$(PACKAGE_NAME).1 $(srcdir)/web/ccache-man.html $(PACKAGE_NAME)$(EXEEXT): $(OBJS) $(HEADERS) $(CC) $(CFLAGS) $(LDFLAGS) -o $@ $(OBJS) $(LIBS) -$(PACKAGE_NAME).1: ccache.yo - -yodl2man -o $(PACKAGE_NAME).1 ccache.yo +$(srcdir)/$(PACKAGE_NAME).1: $(srcdir)/ccache.yo + -yodl2man -o $(srcdir)/$(PACKAGE_NAME).1 $(srcdir)/ccache.yo -web/ccache-man.html: ccache.yo - yodl2html -o web/ccache-man.html ccache.yo +$(srcdir)/web/ccache-man.html: $(srcdir)/ccache.yo + yodl2html -o $(srcdir)/web/ccache-man.html $(srcdir)/ccache.yo -install: $(PACKAGE_NAME)$(EXEEXT) $(PACKAGE_NAME).1 +install: $(PACKAGE_NAME)$(EXEEXT) @echo "Installing $(PACKAGE_NAME)" @echo "Installing $(DESTDIR)${bindir}/`echo $(PACKAGE_NAME) | sed '$(transform)'`$(EXEEXT)" ${INSTALLCMD} -d $(DESTDIR)${bindir} ${INSTALLCMD} -m 755 $(PACKAGE_NAME)$(EXEEXT) $(DESTDIR)${bindir}/`echo $(PACKAGE_NAME) | sed '$(transform)'`$(EXEEXT) + +install-docs: $(srcdir)/$(PACKAGE_NAME).1 @echo "Installing $(DESTDIR)${mandir}/man1/`echo $(PACKAGE_NAME) | sed '$(transform)'`.1" ${INSTALLCMD} -d $(DESTDIR)${mandir}/man1 - ${INSTALLCMD} -m 644 ${srcdir}/$(PACKAGE_NAME).1 $(DESTDIR)${mandir}/man1/`echo $(PACKAGE_NAME) | sed '$(transform)'`.1 + ${INSTALLCMD} -m 644 $(srcdir)/$(PACKAGE_NAME).1 $(DESTDIR)${mandir}/man1/`echo $(PACKAGE_NAME) | sed '$(transform)'`.1 -uninstall: $(PACKAGE_NAME)$(EXEEXT) $(PACKAGE_NAME).1 +uninstall: $(PACKAGE_NAME)$(EXEEXT) rm -f $(DESTDIR)${bindir}/`echo $(PACKAGE_NAME) | sed '$(transform)'`$(EXEEXT) + +uninstall-docs: $(srcdir)/$(PACKAGE_NAME).1 rm -f $(DESTDIR)${mandir}/man1/`echo $(PACKAGE_NAME) | sed '$(transform)'`.1 clean: /bin/rm -f $(OBJS) *~ $(PACKAGE_NAME)$(EXEEXT) -check : test - test: test.sh - SWIG_LIB='$(SWIG_LIB)' PATH=../..:$$PATH SWIG='$(SWIG)' CC='$(CC)' NOSOFTLINKSTEST='$(NOSOFTLINKSTEST)' ./test.sh + SWIG_LIB='$(SWIG_LIB)' PATH=../..:$$PATH SWIG='$(SWIG)' CC='$(CC)' NOSOFTLINKSTEST='$(NOSOFTLINKSTEST)' $(srcdir)/test.sh check: test @@ -67,11 +73,11 @@ distclean: clean /bin/rm -rf autom4te.cache maintainer-clean: distclean - /bin/rm -f $(PACKAGE_NAME).1 web/ccache-man.html + /bin/rm -f $(srcdir)/$(PACKAGE_NAME).1 $(srcdir)/web/ccache-man.html + - # FIXME: To fix this, test.sh needs to be able to take ccache from the # installed prefix, not from the source dir. -installcheck: +installcheck: @echo "WARNING! This is not really \"installcheck\" yet." $(MAKE) check diff --git a/CCache/ccache-swig.1 b/CCache/ccache-swig.1 deleted file mode 100644 index 0081b6d..0000000 --- a/CCache/ccache-swig.1 +++ /dev/null @@ -1,453 +0,0 @@ -.TH "ccache\-swig" "1" "" "" "" - -.PP -.SH "NAME" -ccache\-swig \- a fast compiler cache -.PP -.SH "SYNOPSIS" - -.PP -ccache\-swig [OPTION] -.PP -ccache\-swig [COMPILER OPTIONS] -.PP - [COMPILER OPTIONS] -.PP -.SH "DESCRIPTION" - -.PP -ccache\-swig is a compiler cache\&. It speeds up re\-compilation of C/C++/SWIG code -by caching previous compiles and detecting when the same compile is -being done again\&. ccache\-swig is ccache plus support for SWIG\&. ccache -and ccache\-swig are used interchangeably in this document\&. -.PP -.SH "OPTIONS SUMMARY" - -.PP -Here is a summary of the options to ccache\-swig\&. -.PP -.nf - -\-s show statistics summary -\-z zero statistics -\-c run a cache cleanup -\-C clear the cache completely -\-F set maximum files in cache -\-M set maximum size of cache (use G, M or K) -\-h this help page -\-V print version number - -.fi - -.PP -.SH "OPTIONS" - -.PP -These options only apply when you invoke ccache as \(dq\&ccache\-swig\(dq\&\&. When -invoked as a compiler none of these options apply\&. In that case your -normal compiler options apply and you should refer to your compilers -documentation\&. -.PP -.IP "\fB\-h\fP" -Print a options summary page -.IP -.IP "\fB\-s\fP" -Print the current statistics summary for the cache\&. The -statistics are stored spread across the subdirectories of the -cache\&. Using \(dq\&ccache\-swig \-s\(dq\& adds up the statistics across all -subdirectories and prints the totals\&. -.IP -.IP "\fB\-z\fP" -Zero the cache statistics\&. -.IP -.IP "\fB\-V\fP" -Print the ccache version number -.IP -.IP "\fB\-c\fP" -Clean the cache and re\-calculate the cache file count and -size totals\&. Normally the \-c option should not be necessary as ccache -keeps the cache below the specified limits at runtime and keeps -statistics up to date on each compile\&. This option is mostly useful -if you manually modify the cache contents or believe that the cache -size statistics may be inaccurate\&. -.IP -.IP "\fB\-C\fP" -Clear the entire cache, removing all cached files\&. -.IP -.IP "\fB\-F \fP" -This sets the maximum number of files allowed in -the cache\&. The value is stored inside the cache directory and applies -to all future compiles\&. Due to the way the value is stored the actual -value used is always rounded down to the nearest multiple of 16\&. -.IP -.IP "\fB\-M \fP" -This sets the maximum cache size\&. You can specify -a value in gigabytes, megabytes or kilobytes by appending a G, M or K -to the value\&. The default is gigabytes\&. The actual value stored is -rounded down to the nearest multiple of 16 kilobytes\&. -.IP -.SH "INSTALLATION" - -.PP -There are two ways to use ccache\&. You can either prefix your compile -commands with \(dq\&ccache\-swig\(dq\& or you can create a symbolic link between -ccache\-swig and the names of your compilers\&. The first method is most -convenient if you just want to try out ccache or wish to use it for -some specific projects\&. The second method is most useful for when you -wish to use ccache for all your compiles\&. -.PP -To install for usage by the first method just copy ccache\-swig to somewhere -in your path\&. -.PP -To install for the second method do something like this: -.nf - - cp ccache\-swig /usr/local/bin/ - ln \-s /usr/local/bin/ccache\-swig /usr/local/bin/gcc - ln \-s /usr/local/bin/ccache\-swig /usr/local/bin/g++ - ln \-s /usr/local/bin/ccache\-swig /usr/local/bin/cc - ln \-s /usr/local/bin/ccache\-swig /usr/local/bin/swig - -.fi -This will work as long as /usr/local/bin comes before the path to gcc -(which is usually in /usr/bin)\&. After installing you may wish to run -\(dq\&which gcc\(dq\& to make sure that the correct link is being used\&. -.PP -Note! Do not use a hard link, use a symbolic link\&. A hardlink will -cause \(dq\&interesting\(dq\& problems\&. -.PP -.SH "EXTRA OPTIONS" - -.PP -When run as a compiler front end ccache usually just takes the same -command line options as the compiler you are using\&. The only exception -to this is the option \(cq\&\-\-ccache\-skip\(cq\&\&. That option can be used to tell -ccache that the next option is definitely not a input filename, and -should be passed along to the compiler as\-is\&. -.PP -The reason this can be important is that ccache does need to parse the -command line and determine what is an input filename and what is a -compiler option, as it needs the input filename to determine the name -of the resulting object file (among other things)\&. The heuristic -ccache uses in this parse is that any string on the command line that -exists as a file is treated as an input file name (usually a C -file)\&. By using \-\-ccache\-skip you can force an option to not be -treated as an input file name and instead be passed along to the -compiler as a command line option\&. -.PP -.SH "ENVIRONMENT VARIABLES" - -.PP -ccache uses a number of environment variables to control operation\&. In -most cases you won\(cq\&t need any of these as the defaults will be fine\&. -.PP -.IP "\fBCCACHE_DIR\fP" -the CCACHE_DIR environment variable specifies -where ccache will keep its cached compiler output\&. The default is -\(dq\&$HOME/\&.ccache\(dq\&\&. -.IP -.IP "\fBCCACHE_TEMPDIR\fP" -the CCACHE_TEMPDIR environment variable specifies -where ccache will put temporary files\&. The default is the same as -CCACHE_DIR\&. Note that the CCACHE_TEMPDIR path must be on the same -filesystem as the CCACHE_DIR path, so that renames of files between -the two directories can work\&. -.IP -.IP "\fBCCACHE_LOGFILE\fP" -If you set the CCACHE_LOGFILE environment -variable then ccache will write some log information on cache hits -and misses in that file\&. This is useful for tracking down problems\&. -.IP -.IP "\fBCCACHE_VERBOSE\fP" -If you set the CCACHE_VERBOSE environment -variable then ccache will display on stdout all the compiler invocations -that it makes\&. This can useful for debugging unexpected problems\&. -.IP -.IP "\fBCCACHE_PATH\fP" -You can optionally set CCACHE_PATH to a colon -separated path where ccache will look for the real compilers\&. If you -don\(cq\&t do this then ccache will look for the first executable matching -the compiler name in the normal PATH that isn\(cq\&t a symbolic link to -ccache itself\&. -.IP -.IP "\fBCCACHE_CC\fP" -You can optionally set CCACHE_CC to force the name -of the compiler to use\&. If you don\(cq\&t do this then ccache works it out -from the command line\&. -.IP -.IP "\fBCCACHE_PREFIX\fP" -This option adds a prefix to the command line -that ccache runs when invoking the compiler\&. Also see the section -below on using ccache with distcc\&. -.IP -.IP "\fBCCACHE_DISABLE\fP" -If you set the environment variable -CCACHE_DISABLE then ccache will just call the real compiler, -bypassing the cache completely\&. -.IP -.IP "\fBCCACHE_READONLY\fP" -the CCACHE_READONLY environment variable -tells ccache to attempt to use existing cached object files, but not -to try to add anything new to the cache\&. If you are using this because -your CCACHE_DIR is read\-only, then you may find that you also need to -set CCACHE_TEMPDIR as otherwise ccache will fail to create the -temporary files\&. -.IP -.IP "\fBCCACHE_CPP2\fP" -If you set the environment variable CCACHE_CPP2 -then ccache will not use the optimisation of avoiding the 2nd call to -the pre\-processor by compiling the pre\-processed output that was used -for finding the hash in the case of a cache miss\&. This is primarily a -debugging option, although it is possible that some unusual compilers -will have problems with the intermediate filename extensions used in -this optimisation, in which case this option could allow ccache to be -used\&. -.IP -.IP "\fBCCACHE_NOCOMPRESS\fP" -If you set the environment variable -CCACHE_NOCOMPRESS then there is no compression used on files that go -into the cache\&. However, this setting has no effect on how files are -retrieved from the cache, compressed results will still be usable\&. -.IP -.IP "\fBCCACHE_NOSTATS\fP" -If you set the environment variable -CCACHE_NOSTATS then ccache will not update the statistics files on -each compile\&. -.IP -.IP "\fBCCACHE_NLEVELS\fP" -The environment variable CCACHE_NLEVELS allows -you to choose the number of levels of hash in the cache directory\&. The -default is 2\&. The minimum is 1 and the maximum is 8\&. -.IP -.IP "\fBCCACHE_HARDLINK\fP" -If you set the environment variable -CCACHE_HARDLINK then ccache will attempt to use hard links from the -cache directory when creating the compiler output rather than using a -file copy\&. Using hard links is faster, but can confuse programs like -\(cq\&make\(cq\& that rely on modification times\&. Hard links are never made for -compressed cache files\&. -.IP -.IP "\fBCCACHE_RECACHE\fP" -This forces ccache to not use any cached -results, even if it finds them\&. New results are still cached, but -existing cache entries are ignored\&. -.IP -.IP "\fBCCACHE_UMASK\fP" -This sets the umask for ccache and all child -processes (such as the compiler)\&. This is mostly useful when you wish -to share your cache with other users\&. Note that this also affects the -file permissions set on the object files created from your -compilations\&. -.IP -.IP "\fBCCACHE_HASHDIR\fP" -This tells ccache to hash the current working -directory when calculating the hash that is used to distinguish two -compiles\&. This prevents a problem with the storage of the current -working directory in the debug info of a object file, which can lead -ccache to give a cached object file that has the working directory in -the debug info set incorrectly\&. This option is off by default as the -incorrect setting of this debug info rarely causes problems\&. If you -strike problems with gdb not using the correct directory then enable -this option\&. -.IP -.IP "\fBCCACHE_UNIFY\fP" -If you set the environment variable CCACHE_UNIFY -then ccache will use the C/C++ unifier when hashing the pre\-processor -output if \-g is not used in the compile\&. The unifier is slower than a -normal hash, so setting this environment variable loses a little bit -of speed, but it means that ccache can take advantage of not -recompiling when the changes to the source code consist of -reformatting only\&. Note that using CCACHE_UNIFY changes the hash, so -cached compiles with CCACHE_UNIFY set cannot be used when -CCACHE_UNIFY is not set and vice versa\&. The reason the unifier is off -by default is that it can give incorrect line number information in -compiler warning messages\&. -.IP -.IP "\fBCCACHE_EXTENSION\fP" -Normally ccache tries to automatically -determine the extension to use for intermediate C pre\-processor files -based on the type of file being compiled\&. Unfortunately this sometimes -doesn\(cq\&t work, for example when using the aCC compiler on HP\-UX\&. On -systems like this you can use the CCACHE_EXTENSION option to override -the default\&. On HP\-UX set this environment variable to \(dq\&i\(dq\& if you use -the aCC compiler\&. -.IP -.IP "\fBCCACHE_STRIPC\fP" -If you set the environment variable -CCACHE_STRIPC then ccache will strip the \-c option when invoking -the preprocessor\&. This option is primarily for the Sun Workshop -C++ compiler as without this option an unwarranted warning is displayed: -CC: Warning: \(dq\&\-E\(dq\& redefines product from \(dq\&object\(dq\& to \(dq\&source (stdout)\(dq\& -when \-E and \-c is used together\&. -.IP -.IP "\fBCCACHE_SWIG\fP" -When using SWIG as the compiler and it does not -have \(cq\&swig\(cq\& in the executable name, then the CCACHE_SWIG environment -variable needs to be set in order for ccache to work correctly with -SWIG\&. The use of CCACHE_CPP2 is also recommended for SWIG due to some -preprocessor quirks, however, use of CCACHE_CPP2 can often be skipped -\-\- check your generated code with and without this option set\&. Known -problems are using preprocessor directives within %inline blocks and -the use of \(cq\&#pragma SWIG\(cq\&\&. -.IP -.SH "CACHE SIZE MANAGEMENT" - -.PP -By default ccache has a one gigabyte limit on the cache size and no -maximum number of files\&. You can set a different limit using the -\(dq\&ccache \-M\(dq\& and \(dq\&ccache \-F\(dq\& options, which set the size and number of -files limits\&. -.PP -When these limits are reached ccache will reduce the cache to 20% -below the numbers you specified in order to avoid doing the cache -clean operation too often\&. -.PP -.SH "CACHE COMPRESSION" - -.PP -By default on most platforms ccache will compress all files it puts -into the cache -using the zlib compression\&. While this involves a negligible -performance slowdown, it significantly increases the number of files -that fit in the cache\&. You can turn off compression setting the -CCACHE_NOCOMPRESS environment variable\&. -.PP -.SH "HOW IT WORKS" - -.PP -The basic idea is to detect when you are compiling exactly the same -code a 2nd time and use the previously compiled output\&. You detect -that it is the same code by forming a hash of: -.PP -.IP o -the pre\-processor output from running the compiler with \-E -.IP o -the command line options -.IP o -the real compilers size and modification time -.IP o -any stderr output generated by the compiler - -.PP -These are hashed using md4 (a strong hash) and a cache file is formed -based on that hash result\&. When the same compilation is done a second -time ccache is able to supply the correct compiler output (including -all warnings etc) from the cache\&. -.PP -ccache has been carefully written to always produce exactly the same -compiler output that you would get without the cache\&. If you ever -discover a case where ccache changes the output of your compiler then -please let me know\&. -.PP -.SH "USING CCACHE WITH DISTCC" - -.PP -distcc is a very useful program for distributing compilation across a -range of compiler servers\&. It is often useful to combine distcc with -ccache, so that compiles that are done are sped up by distcc, but that -ccache avoids the compile completely where possible\&. -.PP -To use distcc with ccache I recommend using the CCACHE_PREFIX -option\&. You just need to set the environment variable CCACHE_PREFIX to -\(cq\&distcc\(cq\& and ccache will prefix the command line used with the -compiler with the command \(cq\&distcc\(cq\&\&. -.PP -.SH "SHARING A CACHE" - -.PP -A group of developers can increase the cache hit rate by sharing a -cache directory\&. The hard links however cause unwanted side effects, -as all links to a cached file share the file\(cq\&s modification timestamp\&. -This results in false dependencies to be triggered by timestamp\-based -build systems whenever another user links to an existing -file\&. Typically, users will see that their libraries and binaries are -relinked without reason\&. To share a cache without side effects, the -following conditions need to be met: -.PP -.IP o -Use the same \fBCCACHE_DIR\fP environment variable setting -.IP o -Unset the \fBCCACHE_HARDLINK\fP environment variable -.IP o -Make sure everyone sets the CCACHE_UMASK environment variable -to 002, this ensures that cached files are accessible to everyone in -the group\&. -.IP o -Make sure that all users have write permission in the entire -cache directory (and that you trust all users of the shared cache)\&. -.IP o -Make sure that the setgid bit is set on all directories in the -cache\&. This tells the filesystem to inherit group ownership for new -directories\&. The command \(dq\&chmod g+s `find $CCACHE_DIR \-type d`\(dq\& might -be useful for this\&. -.IP o -Set \fBCCACHE_NOCOMPRESS\fP for all users, if there are users with -versions of ccache that do not support compression\&. - -.PP -.SH "HISTORY" - -.PP -ccache was inspired by the compilercache shell script script written -by Erik Thiele and I would like to thank him for an excellent piece of -work\&. See -http://www\&.erikyyy\&.de/compilercache/ -for the Erik\(cq\&s scripts\&. -ccache\-swig is a port of the original ccache with support added for use -with SWIG\&. -.PP -I wrote ccache because I wanted to get a bit more speed out of a -compiler cache and I wanted to remove some of the limitations of the -shell\-script version\&. -.PP -.SH "DIFFERENCES FROM COMPILERCACHE" - -.PP -The biggest differences between Erik\(cq\&s compilercache script and ccache -are: -.IP o -ccache is written in C, which makes it a bit faster (calling out to -external programs is mostly what slowed down the scripts)\&. -.IP o -ccache can automatically find the real compiler -.IP o -ccache keeps statistics on hits/misses -.IP o -ccache can do automatic cache management -.IP o -ccache can cache compiler output that includes warnings\&. In many -cases this gives ccache a much higher cache hit rate\&. -.IP o -ccache can handle a much wider ranger of compiler options -.IP o -ccache avoids a double call to cpp on a cache miss - -.PP -.SH "CREDITS" - -.PP -Thanks to the following people for their contributions to ccache -.IP o -Erik Thiele for the original compilercache script -.IP o -Luciano Rocha for the idea of compiling the pre\-processor output -to avoid a 2nd cpp pass -.IP o -Paul Russell for many suggestions and the debian packaging - -.PP -.SH "AUTHOR" - -.PP -ccache was written by Andrew Tridgell -http://samba\&.org/~tridge/\&. -ccache was adapted to create ccache\-swig for use with SWIG by William Fulton\&. -.PP -If you wish to report a problem or make a suggestion then please email -the SWIG developers on the swig\-devel mailing list, see -http://www\&.swig\&.org/mail\&.html -.PP -ccache is released under the GNU General Public License version 2 or -later\&. Please see the file COPYING for license details\&. -.PP - diff --git a/CCache/ccache.h b/CCache/ccache.h index dcbb03f..a79d883 100644 --- a/CCache/ccache.h +++ b/CCache/ccache.h @@ -20,7 +20,9 @@ #include #include #else -#define _WIN32_WINNT 0x0500 +#ifndef _WIN32_WINNT + #define _WIN32_WINNT 0x0500 +#endif #include #include #endif diff --git a/CCache/configure b/CCache/configure index a8ea118..997b3d2 100755 --- a/CCache/configure +++ b/CCache/configure @@ -1,11 +1,9 @@ #! /bin/sh # Guess values for system-dependent variables and create Makefiles. -# Generated by GNU Autoconf 2.68 for ccache-swig 0.0. +# Generated by GNU Autoconf 2.69 for ccache-swig 0.0. # # -# Copyright (C) 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000, 2001, -# 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software -# Foundation, Inc. +# Copyright (C) 1992-1996, 1998-2012 Free Software Foundation, Inc. # # # This configure script is free software; the Free Software Foundation @@ -134,6 +132,31 @@ export LANGUAGE # CDPATH. (unset CDPATH) >/dev/null 2>&1 && unset CDPATH +# Use a proper internal environment variable to ensure we don't fall + # into an infinite loop, continuously re-executing ourselves. + if test x"${_as_can_reexec}" != xno && test "x$CONFIG_SHELL" != x; then + _as_can_reexec=no; export _as_can_reexec; + # We cannot yet assume a decent shell, so we have to provide a +# neutralization value for shells without unset; and this also +# works around shells that cannot unset nonexistent variables. +# Preserve -v and -x to the replacement shell. +BASH_ENV=/dev/null +ENV=/dev/null +(unset BASH_ENV) >/dev/null 2>&1 && unset BASH_ENV ENV +case $- in # (((( + *v*x* | *x*v* ) as_opts=-vx ;; + *v* ) as_opts=-v ;; + *x* ) as_opts=-x ;; + * ) as_opts= ;; +esac +exec $CONFIG_SHELL $as_opts "$as_myself" ${1+"$@"} +# Admittedly, this is quite paranoid, since all the known shells bail +# out after a failed `exec'. +$as_echo "$0: could not re-execute with $CONFIG_SHELL" >&2 +as_fn_exit 255 + fi + # We don't want this to propagate to other subprocesses. + { _as_can_reexec=; unset _as_can_reexec;} if test "x$CONFIG_SHELL" = x; then as_bourne_compatible="if test -n \"\${ZSH_VERSION+set}\" && (emulate sh) >/dev/null 2>&1; then : emulate sh @@ -167,7 +190,8 @@ if ( set x; as_fn_ret_success y && test x = \"\$1\" ); then : else exitcode=1; echo positional parameters were not saved. fi -test x\$exitcode = x0 || exit 1" +test x\$exitcode = x0 || exit 1 +test -x / || exit 1" as_suggested=" as_lineno_1=";as_suggested=$as_suggested$LINENO;as_suggested=$as_suggested" as_lineno_1a=\$LINENO as_lineno_2=";as_suggested=$as_suggested$LINENO;as_suggested=$as_suggested" as_lineno_2a=\$LINENO eval 'test \"x\$as_lineno_1'\$as_run'\" != \"x\$as_lineno_2'\$as_run'\" && @@ -212,21 +236,25 @@ IFS=$as_save_IFS if test "x$CONFIG_SHELL" != x; then : - # We cannot yet assume a decent shell, so we have to provide a - # neutralization value for shells without unset; and this also - # works around shells that cannot unset nonexistent variables. - # Preserve -v and -x to the replacement shell. - BASH_ENV=/dev/null - ENV=/dev/null - (unset BASH_ENV) >/dev/null 2>&1 && unset BASH_ENV ENV - export CONFIG_SHELL - case $- in # (((( - *v*x* | *x*v* ) as_opts=-vx ;; - *v* ) as_opts=-v ;; - *x* ) as_opts=-x ;; - * ) as_opts= ;; - esac - exec "$CONFIG_SHELL" $as_opts "$as_myself" ${1+"$@"} + export CONFIG_SHELL + # We cannot yet assume a decent shell, so we have to provide a +# neutralization value for shells without unset; and this also +# works around shells that cannot unset nonexistent variables. +# Preserve -v and -x to the replacement shell. +BASH_ENV=/dev/null +ENV=/dev/null +(unset BASH_ENV) >/dev/null 2>&1 && unset BASH_ENV ENV +case $- in # (((( + *v*x* | *x*v* ) as_opts=-vx ;; + *v* ) as_opts=-v ;; + *x* ) as_opts=-x ;; + * ) as_opts= ;; +esac +exec $CONFIG_SHELL $as_opts "$as_myself" ${1+"$@"} +# Admittedly, this is quite paranoid, since all the known shells bail +# out after a failed `exec'. +$as_echo "$0: could not re-execute with $CONFIG_SHELL" >&2 +exit 255 fi if test x$as_have_required = xno; then : @@ -328,6 +356,14 @@ $as_echo X"$as_dir" | } # as_fn_mkdir_p + +# as_fn_executable_p FILE +# ----------------------- +# Test if FILE is an executable regular file. +as_fn_executable_p () +{ + test -f "$1" && test -x "$1" +} # as_fn_executable_p # as_fn_append VAR VALUE # ---------------------- # Append the text in VALUE to the end of the definition contained in VAR. Take @@ -449,6 +485,10 @@ as_cr_alnum=$as_cr_Letters$as_cr_digits chmod +x "$as_me.lineno" || { $as_echo "$as_me: error: cannot create $as_me.lineno; rerun with a POSIX shell" >&2; as_fn_exit 1; } + # If we had to re-execute with $CONFIG_SHELL, we're ensured to have + # already done that, so ensure we don't try to do so again and fall + # in an infinite loop. This has already happened in practice. + _as_can_reexec=no; export _as_can_reexec # Don't try to exec as it changes $[0], causing all sort of problems # (the dirname of $[0] is not the place where we might find the # original and so on. Autoconf is especially sensitive to this). @@ -483,16 +523,16 @@ if (echo >conf$$.file) 2>/dev/null; then # ... but there are two gotchas: # 1) On MSYS, both `ln -s file dir' and `ln file dir' fail. # 2) DJGPP < 2.04 has no symlinks; `ln -s' creates a wrapper executable. - # In both cases, we have to default to `cp -p'. + # In both cases, we have to default to `cp -pR'. ln -s conf$$.file conf$$.dir 2>/dev/null && test ! -f conf$$.exe || - as_ln_s='cp -p' + as_ln_s='cp -pR' elif ln conf$$.file conf$$ 2>/dev/null; then as_ln_s=ln else - as_ln_s='cp -p' + as_ln_s='cp -pR' fi else - as_ln_s='cp -p' + as_ln_s='cp -pR' fi rm -f conf$$ conf$$.exe conf$$.dir/conf$$.file conf$$.file rmdir conf$$.dir 2>/dev/null @@ -504,28 +544,8 @@ else as_mkdir_p=false fi -if test -x / >/dev/null 2>&1; then - as_test_x='test -x' -else - if ls -dL / >/dev/null 2>&1; then - as_ls_L_option=L - else - as_ls_L_option= - fi - as_test_x=' - eval sh -c '\'' - if test -d "$1"; then - test -d "$1/."; - else - case $1 in #( - -*)set "./$1";; - esac; - case `ls -ld'$as_ls_L_option' "$1" 2>/dev/null` in #(( - ???[sx]*):;;*)false;;esac;fi - '\'' sh - ' -fi -as_executable_p=$as_test_x +as_test_x='test -x' +as_executable_p=as_fn_executable_p # Sed expression to map a string onto a valid CPP name. as_tr_cpp="eval sed 'y%*$as_cr_letters%P$as_cr_LETTERS%;s%[^_$as_cr_alnum]%_%g'" @@ -633,6 +653,7 @@ infodir docdir oldincludedir includedir +runstatedir localstatedir sharedstatedir sysconfdir @@ -704,6 +725,7 @@ datadir='${datarootdir}' sysconfdir='${prefix}/etc' sharedstatedir='${prefix}/com' localstatedir='${prefix}/var' +runstatedir='${localstatedir}/run' includedir='${prefix}/include' oldincludedir='/usr/include' docdir='${datarootdir}/doc/${PACKAGE_TARNAME}' @@ -956,6 +978,15 @@ do | -silent | --silent | --silen | --sile | --sil) silent=yes ;; + -runstatedir | --runstatedir | --runstatedi | --runstated \ + | --runstate | --runstat | --runsta | --runst | --runs \ + | --run | --ru | --r) + ac_prev=runstatedir ;; + -runstatedir=* | --runstatedir=* | --runstatedi=* | --runstated=* \ + | --runstate=* | --runstat=* | --runsta=* | --runst=* | --runs=* \ + | --run=* | --ru=* | --r=*) + runstatedir=$ac_optarg ;; + -sbindir | --sbindir | --sbindi | --sbind | --sbin | --sbi | --sb) ac_prev=sbindir ;; -sbindir=* | --sbindir=* | --sbindi=* | --sbind=* | --sbin=* \ @@ -1093,7 +1124,7 @@ fi for ac_var in exec_prefix prefix bindir sbindir libexecdir datarootdir \ datadir sysconfdir sharedstatedir localstatedir includedir \ oldincludedir docdir infodir htmldir dvidir pdfdir psdir \ - libdir localedir mandir + libdir localedir mandir runstatedir do eval ac_val=\$$ac_var # Remove trailing slashes. @@ -1121,8 +1152,6 @@ target=$target_alias if test "x$host_alias" != x; then if test "x$build_alias" = x; then cross_compiling=maybe - $as_echo "$as_me: WARNING: if you wanted to set the --build type, don't use --host. - If a cross compiler is detected then cross compile mode will be used" >&2 elif test "x$build_alias" != "x$host_alias"; then cross_compiling=yes fi @@ -1248,6 +1277,7 @@ Fine tuning of the installation directories: --sysconfdir=DIR read-only single-machine data [PREFIX/etc] --sharedstatedir=DIR modifiable architecture-independent data [PREFIX/com] --localstatedir=DIR modifiable single-machine data [PREFIX/var] + --runstatedir=DIR modifiable per-process data [LOCALSTATEDIR/run] --libdir=DIR object code libraries [EPREFIX/lib] --includedir=DIR C header files [PREFIX/include] --oldincludedir=DIR C header files for non-gcc [/usr/include] @@ -1361,9 +1391,9 @@ test -n "$ac_init_help" && exit $ac_status if $ac_init_version; then cat <<\_ACEOF ccache-swig configure 0.0 -generated by GNU Autoconf 2.68 +generated by GNU Autoconf 2.69 -Copyright (C) 2010 Free Software Foundation, Inc. +Copyright (C) 2012 Free Software Foundation, Inc. This configure script is free software; the Free Software Foundation gives unlimited permission to copy, distribute and modify it. _ACEOF @@ -1476,7 +1506,7 @@ $as_echo "$ac_try_echo"; } >&5 test ! -s conftest.err } && test -s conftest$ac_exeext && { test "$cross_compiling" = yes || - $as_test_x conftest$ac_exeext + test -x conftest$ac_exeext }; then : ac_retval=0 else @@ -1726,7 +1756,7 @@ This file contains any messages produced by compilers while running configure, to aid debugging if configure makes a mistake. It was created by ccache-swig $as_me 0.0, which was -generated by GNU Autoconf 2.68. Invocation command line was +generated by GNU Autoconf 2.69. Invocation command line was $ $0 $@ @@ -2104,7 +2134,7 @@ do IFS=$as_save_IFS test -z "$as_dir" && as_dir=. for ac_exec_ext in '' $ac_executable_extensions; do - if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then + if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then ac_cv_prog_CC="${ac_tool_prefix}gcc" $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5 break 2 @@ -2144,7 +2174,7 @@ do IFS=$as_save_IFS test -z "$as_dir" && as_dir=. for ac_exec_ext in '' $ac_executable_extensions; do - if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then + if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then ac_cv_prog_ac_ct_CC="gcc" $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5 break 2 @@ -2197,7 +2227,7 @@ do IFS=$as_save_IFS test -z "$as_dir" && as_dir=. for ac_exec_ext in '' $ac_executable_extensions; do - if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then + if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then ac_cv_prog_CC="${ac_tool_prefix}cc" $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5 break 2 @@ -2238,7 +2268,7 @@ do IFS=$as_save_IFS test -z "$as_dir" && as_dir=. for ac_exec_ext in '' $ac_executable_extensions; do - if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then + if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then if test "$as_dir/$ac_word$ac_exec_ext" = "/usr/ucb/cc"; then ac_prog_rejected=yes continue @@ -2296,7 +2326,7 @@ do IFS=$as_save_IFS test -z "$as_dir" && as_dir=. for ac_exec_ext in '' $ac_executable_extensions; do - if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then + if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then ac_cv_prog_CC="$ac_tool_prefix$ac_prog" $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5 break 2 @@ -2340,7 +2370,7 @@ do IFS=$as_save_IFS test -z "$as_dir" && as_dir=. for ac_exec_ext in '' $ac_executable_extensions; do - if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then + if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then ac_cv_prog_ac_ct_CC="$ac_prog" $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5 break 2 @@ -2786,8 +2816,7 @@ cat confdefs.h - <<_ACEOF >conftest.$ac_ext /* end confdefs.h. */ #include #include -#include -#include +struct stat; /* Most of the following tests are stolen from RCS 5.7's src/conf.sh. */ struct buf { int x; }; FILE * (*rcsopen) (struct buf *, struct stat *, int); @@ -3075,7 +3104,7 @@ case $as_dir/ in #(( # by default. for ac_prog in ginstall scoinst install; do for ac_exec_ext in '' $ac_executable_extensions; do - if { test -f "$as_dir/$ac_prog$ac_exec_ext" && $as_test_x "$as_dir/$ac_prog$ac_exec_ext"; }; then + if as_fn_executable_p "$as_dir/$ac_prog$ac_exec_ext"; then if test $ac_prog = install && grep dspmsg "$as_dir/$ac_prog$ac_exec_ext" >/dev/null 2>&1; then # AIX install. It has an incompatible calling convention. @@ -3407,7 +3436,7 @@ do for ac_prog in grep ggrep; do for ac_exec_ext in '' $ac_executable_extensions; do ac_path_GREP="$as_dir/$ac_prog$ac_exec_ext" - { test -f "$ac_path_GREP" && $as_test_x "$ac_path_GREP"; } || continue + as_fn_executable_p "$ac_path_GREP" || continue # Check for GNU ac_path_GREP and select it if it is found. # Check for GNU $ac_path_GREP case `"$ac_path_GREP" --version 2>&1` in @@ -3473,7 +3502,7 @@ do for ac_prog in egrep; do for ac_exec_ext in '' $ac_executable_extensions; do ac_path_EGREP="$as_dir/$ac_prog$ac_exec_ext" - { test -f "$ac_path_EGREP" && $as_test_x "$ac_path_EGREP"; } || continue + as_fn_executable_p "$ac_path_EGREP" || continue # Check for GNU ac_path_EGREP and select it if it is found. # Check for GNU $ac_path_EGREP case `"$ac_path_EGREP" --version 2>&1` in @@ -4251,16 +4280,16 @@ if (echo >conf$$.file) 2>/dev/null; then # ... but there are two gotchas: # 1) On MSYS, both `ln -s file dir' and `ln file dir' fail. # 2) DJGPP < 2.04 has no symlinks; `ln -s' creates a wrapper executable. - # In both cases, we have to default to `cp -p'. + # In both cases, we have to default to `cp -pR'. ln -s conf$$.file conf$$.dir 2>/dev/null && test ! -f conf$$.exe || - as_ln_s='cp -p' + as_ln_s='cp -pR' elif ln conf$$.file conf$$ 2>/dev/null; then as_ln_s=ln else - as_ln_s='cp -p' + as_ln_s='cp -pR' fi else - as_ln_s='cp -p' + as_ln_s='cp -pR' fi rm -f conf$$ conf$$.exe conf$$.dir/conf$$.file conf$$.file rmdir conf$$.dir 2>/dev/null @@ -4320,28 +4349,16 @@ else as_mkdir_p=false fi -if test -x / >/dev/null 2>&1; then - as_test_x='test -x' -else - if ls -dL / >/dev/null 2>&1; then - as_ls_L_option=L - else - as_ls_L_option= - fi - as_test_x=' - eval sh -c '\'' - if test -d "$1"; then - test -d "$1/."; - else - case $1 in #( - -*)set "./$1";; - esac; - case `ls -ld'$as_ls_L_option' "$1" 2>/dev/null` in #(( - ???[sx]*):;;*)false;;esac;fi - '\'' sh - ' -fi -as_executable_p=$as_test_x + +# as_fn_executable_p FILE +# ----------------------- +# Test if FILE is an executable regular file. +as_fn_executable_p () +{ + test -f "$1" && test -x "$1" +} # as_fn_executable_p +as_test_x='test -x' +as_executable_p=as_fn_executable_p # Sed expression to map a string onto a valid CPP name. as_tr_cpp="eval sed 'y%*$as_cr_letters%P$as_cr_LETTERS%;s%[^_$as_cr_alnum]%_%g'" @@ -4363,7 +4380,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1 # values after options handling. ac_log=" This file was extended by ccache-swig $as_me 0.0, which was -generated by GNU Autoconf 2.68. Invocation command line was +generated by GNU Autoconf 2.69. Invocation command line was CONFIG_FILES = $CONFIG_FILES CONFIG_HEADERS = $CONFIG_HEADERS @@ -4425,10 +4442,10 @@ cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1 ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`" ac_cs_version="\\ ccache-swig config.status 0.0 -configured by $0, generated by GNU Autoconf 2.68, +configured by $0, generated by GNU Autoconf 2.69, with options \\"\$ac_cs_config\\" -Copyright (C) 2010 Free Software Foundation, Inc. +Copyright (C) 2012 Free Software Foundation, Inc. This config.status script is free software; the Free Software Foundation gives unlimited permission to copy, distribute and modify it." @@ -4517,7 +4534,7 @@ fi _ACEOF cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1 if \$ac_cs_recheck; then - set X '$SHELL' '$0' $ac_configure_args \$ac_configure_extra_args --no-create --no-recursion + set X $SHELL '$0' $ac_configure_args \$ac_configure_extra_args --no-create --no-recursion shift \$as_echo "running CONFIG_SHELL=$SHELL \$*" >&6 CONFIG_SHELL='$SHELL' diff --git a/CCache/test.sh b/CCache/test.sh index f64c3e3..438e782 100755 --- a/CCache/test.sh +++ b/CCache/test.sh @@ -15,6 +15,11 @@ else SWIG=swig fi +# fix: Remove ccache from $PATH if it exists +# as it will influence the unit tests +PATH="`echo $PATH | \ + sed -e 's!:/usr\(/local\)*/lib\([0-9]\)*/ccache\(/\)*!!g'`" + CCACHE=../ccache-swig TESTDIR=test.$$ @@ -402,6 +407,29 @@ swigtests() { rm -rf $TESTDIR mkdir $TESTDIR cd $TESTDIR || exit 1 + +unset CCACHE_DIR +unset CCACHE_TEMPDIR +unset CCACHE_LOGFILE +unset CCACHE_VERBOSE +unset CCACHE_PATH +unset CCACHE_CC +unset CCACHE_PREFIX +unset CCACHE_DISABLE +unset CCACHE_READONLY +unset CCACHE_CPP2 +unset CCACHE_NOCOMPRESS +unset CCACHE_NOSTATS +unset CCACHE_NLEVELS +unset CCACHE_HARDLINK +unset CCACHE_RECACHE +unset CCACHE_UMASK +unset CCACHE_HASHDIR +unset CCACHE_UNIFY +unset CCACHE_EXTENSION +unset CCACHE_STRIPC +unset CCACHE_SWIG + CCACHE_DIR="ccache dir" # with space in directory name (like Windows default) mkdir "$CCACHE_DIR" export CCACHE_DIR diff --git a/CHANGES b/CHANGES index b40597e..d6e1d29 100644 --- a/CHANGES +++ b/CHANGES @@ -3,6 +3,1416 @@ SWIG (Simplified Wrapper and Interface Generator) See the CHANGES.current file for changes in the current version. See the RELEASENOTES file for a summary of changes in each release. +Version 3.0.9 (29 May 2016) +=========================== + +2016-05-24: mromberg + [Python] Patch #612 - Add support for Python's implicit namespace packages. + +2016-05-23: wsfulton + [Ruby] Fix #602 - Error handling regression of opaque pointers introduced + in swig-3.0.8 when C functions explicitly reset a pointer using 'DATA_PTR(self) = 0'. + An ObjectPreviouslyDeleted error was incorrectly thrown when the pointer was used + as a parameter. + +2016-05-17: tamuratak + [Ruby] Patch #651 - Correct overloaded function error message when function is + using %newobject. + +2016-05-17: aurelj + [Ruby] Patch #582 - add support for docstring option in %module() + +2016-05-14: wsfulton + Fix #434 - Passing classes by value as parameters in director methods did not create + a copy of the argument leading to invalid memory accesses if the object was used + after the upcall into the target language. Passing arguments by value shouldn't give + rise to these sorts of memory problems and so the objects are now copied and ownership + of their lifetime is controlled by the target language. + +2016-05-07: wsfulton + Fix #611. Fix assertion handling defaultargs when using %extend for a template + class and the extended methods contain default arguments. + +2016-05-05: ejulian + [Python] Patch #617. Fix operator/ wrappers. + +2016-05-02: wsfulton + Fix #669. Don't issue warning about ignoring base classes when the derived class is + itself ignored. + +2016-04-18: ianlancetaylor + [Go] Fix use of goout typemap when calling base method by + forcing the "type" attribute to the value we need. + +2016-04-17: ianlancetaylor + [Go] Fixes for Go 1.6: avoid returning Go pointers from + directors that return string values; add a trailing 0 byte + when treating Go string as C char*. + +2016-04-06: smarchetto + [Scilab] #552 Make Scilab runtime keep track of pointer types + Instead of a Scilab pointer which has no type, SWIG Scilab maps a + pointer to a structure tlist containing the pointer adress and its type. + +2016-04-02: ahnolds + [Python] Apply #598. Fix misleading error message when attempting to read a non-existent + attribute. The previous cryptic error message: + AttributeError: type object 'object' has no attribute '__getattr__' + is now replaced with one mentioning the attribute name, eg: + AttributeError: 'Foo' object has no attribute 'bar' + +2016-04-02: derkuci + [Python] Patch #610 to fix #607. + Fix single arguments when using python -builtin -O with %feature("compactdefaultargs") + +2016-03-31: wsfulton + Fixes #594. Fix assertion for some languages when wrapping a C++11 enum class that + is private in a class. + + Also don't wrap private enums for a few languages that attempted to do so. + +2016-03-31: wsfulton + [Java] unsigned long long marshalling improvements when a negative number + is passed from Java to C. A cast to signed long long in the C layer will now + result in the expected value. No change for positive numbers passed to C. + Fixes #623. + +2016-03-22: alexwarg + [Lua] #398 Fix lua __getitem + inheritance + The new handling of classes in Lua (not merging methods into the derived classes) + breaks for classes that provide a __getitem function. The __getitem function + prevents method calls to any method defined in a base class. This fix calls + __getitem only if the member is not found using recursive lookup. + +2016-03-18: ptomulik + [Python] #563 Stop generating unnecessary _swigconstant helpers. + +2016-03-16: richardbeare + [R] #636 Add extra std::vector numeric types + +2016-03-14: wsfulton + [Java] Add std_array.i for C++11 std::array support. + +2016-03-12: wsfulton + [Java, C#, D] Fix static const char member variables wrappers with %javaconst(1) + %csconst(1) or %dmanifestconst. + This fixes the case when an integer is used as the initializer, such as: + + struct W { static const char w = 100; }; + + Fix generated code parsing enum values using char escape sequences + when these values appear in the Java code (usually when using %javaconst(1)) + such as: + + enum X { x1 = '\n', x2 = '\1' }; + + Similarly for static const member char variables such as: + + struct Y { static const char y = '\n'; } + + Likewise for D and %dmanifestconstant. For C# and %csconst(1), char + values in C# are now hex escaped as C# doesn't support C octal escaping. + +2016-03-11: wsfulton + [Java C#] Add support for treating C++ base classes as Java interfaces + instead of Java proxy classes. This enable some sort of support for + multiple inheritance. The implementation is in swiginterface.i and + provides additional macros (see Java.html for full documentation): + + %interface(CTYPE) + %interface_impl(CTYPE) + %interface_custom("PROXY", "INTERFACE", CTYPE) + +2016-03-01: wsfulton + Add rstrip encoder for use in %rename. This is like the strip encoder but + strips the symbol's suffix instead of the prefix. The example below + will rename SomeThingCls to SomeThing and AnotherThingCls to AnotherThing: + + %rename("%(rstrip:[Cls])s") ""; + + class SomeThingCls {}; + struct AnotherThingCls {}; + +2016-03-01: olly + Fix isfinite() check to work with GCC6. Fixes + https://github.com/swig/swig/issues/615 reported by jplesnik. + +2016-02-17: olly + [Python] Add missing keywords 'as' and 'with' to pythonkw.swg. + +2016-02-07: kwwette + [Octave] recognise various unary functions + * Use __float__() for numeric conversions, e.g. when calling double() + * Map various unary functions, e.g. abs() to __abs__(), see full list + in section 32.3.10 of manual; only available in Octave 3.8.0 or later + +2016-02-07: kwwette + [Octave] export function swig_octave_prereq() for testing Octave version + +2016-02-06: pjohangustavsson + [C#] Fix duplicate symbol problems when linking the source generated + from multiple SWIG modules into one shared library for the -namespace + option. The namespace is now mangled into the global PInvoke function + names. + + *** POTENTIAL INCOMPATIBILITY *** + +2016-01-27: ahnolds + [Python] Added support for differentiating between Python Bytes + and Unicode objects using by defining SWIG_PYTHON_STRICT_BYTE_CHAR + and SWIG_PYTHON_STRICT_UNICODE_WCHAR. + +2016-01-27: steeve + [Go] Ensure structs are properly packed between gc and GCC/clang. + +2016-01-25: ahnolds + [Python] Support the full Python test suite in -classic mode + * Convert long/unsigned long/long long/unsigned long long to PyInt + rather than PyLong when possible. Certain python functions like + len() require a PyInt when operating on old-style classes. + * Add support for static methods in classic mode, including support + for pythonappend, pythonprepend, and docstrings. + * Removing the use of __swig_getmethods__ for static member methods + since they will always be found by the standard argument lookup + * Fix a bug where the wrong type of exception was caught when + checking for new-style class support + +2016-01-23: ahnolds + [Go] Enable support for the Go test-suite on OSX: + * The linker on OSX requires that all symbols (even weak symbols) + are defined at link time. Because the function _cgo_topofstack is + only defined starting in Go version 1.4, we explicitly mark it as + undefined for older versions of Go on OSX. + * Avoid writing empty swigargs structs, since empty structs are not + allowed in extern "C" blocks. + +2016-01-12: olly + [Javascript] Look for "nodejs" as well as "node", as it's packaged + as the former on Debian. + +2016-01-12: olly + [Javascript] For v8 >= 4.3.0, use V8_MAJOR_VERSION. + Fixes https://github.com/swig/swig/issues/561. + +2016-01-10: ahnolds + Improved size_t and ptrdiff_t typemaps to support large values + on platforms where sizeof(size_t) > sizeof(unsigned long) and + sizeof(ptrdiff_t) > sizeof(long). + +Version 3.0.8 (31 Dec 2015) +=========================== + +2015-12-30: wsfulton + The pdf documentation is now generated by wkhtmltopdf and has colour + for the code snippets just like the html documentation! + +2015-12-23: ahnolds + [Python] Fixes for conversion of signed and unsigned integer types: + + No longer check for PyInt objects in Python3. Because PyInt_Check + and friends are #defined to the corresponding PyLong methods, this + had caused errors in Python3 where values greater than what could be + stored in a long were incorrectly interpreted as the value -1 with + the Python error indicator set to OverflowError. This applies to + both the conversions PyLong->long and PyLong->double. + + Conversion from PyLong to long, unsigned long, long long, and + unsigned long long now raise OverflowError instead of TypeError in + both Python2 and Python3 for PyLong values outside the range + expressible by the corresponding C type. This matches the existing + behavior for other integral types (signed and unsigned ints, shorts, + and chars), as well as the conversion for PyInt to all numeric + types. This also indirectly applies to the size_t and ptrdiff_t + types, which depend on the conversions for unsigned long and long. + +2015-12-19: wsfulton + [Python] Python 2 Unicode UTF-8 strings can be used as inputs to char * or + std::string types if the generated C/C++ code has SWIG_PYTHON_2_UNICODE defined. + +2015-12-17: wsfulton + Issues #286, #128 + Remove ccache-swig.1 man page - please use the CCache.html docs instead. + The yodl2man and yodl2html tools are no longer used and so SWIG no + longer has a dependency on these packages which were required when + building from git. + +2015-12-16: zturner/coleb + [Python] Fix Python3.5 interpreter assertions when objects are being + deleted due to an existing exception. Most notably in generators + which terminate using a StopIteration exception. Fixes #559 #560 #573. + If a further exception is raised during an object destruction, + PyErr_WriteUnraisable is used on this second exception and the + original exception bubbles through. + +2015-12-14: ahnolds/wsfulton + [Python] Add in missing initializers for tp_finalize, + nb_matrix_multiply, nb_inplace_matrix_multiply, ht_qualname + ht_cached_keys and tp_prev. + +2015-12-12: wsfulton + Fix STL wrappers to not generate <: digraphs. + For example std::vector<::X::Y> was sometimes generated, now + corrected to std::vector< ::X::Y >. + +2015-11-25: wsfulton + [Ruby] STL ranges and slices fixes. + + Ruby STL container setting slices fixes: + + Setting an STL container wrapper slice better matches the way Ruby + arrays work. The behaviour is now the same as Ruby arrays. The only + exception is the default value used when expanding a container + cannot be nil as this is not a valid type/value for C++ container + elements. + + Obtaining a Ruby STL container ranges and slices fixes: + + Access via ranges and slices now behave identically to Ruby arrays. + The fixes are mostly for out of range indices and lengths. + - Zero length slice requests return an empty container instead of nil. + - Slices which request a length greater than the size of the container + no longer chop off the last element. + - Ranges which used to return nil now return an empty array when the + the start element is a valid index. + + Ruby STL container negative indexing support improved. + + Using negative indexes to set values works the same as Ruby arrays, eg + + %template(IntVector) std::vector; + + iv = IntVector.new([1,2,3,4]) + iv[-4] = 9 # => [1,2,3,9] + iv[-5] = 9 # => IndexError + +2015-11-21: wsfulton + [Ruby, Python] Add std::array container wrappers. + + These work much like any of the other STL containers except Python/Ruby slicing + is somewhat limited because the array is a fixed size. Only slices of + the full size are supported. + +2015-10-10: wsfulton + [Python] #539 - Support Python 3.5 and -builtin. PyAsyncMethods is a new + member in PyHeapTypeObject. + +2015-10-06: ianlancetaylor + [Go] Don't emit a constructor function for a director + class with an abstract method, since the function will + always panic. + +2015-10-01: wsfulton + Fix %shared_ptr support for private and protected inheritance. + - Remove unnecessary Warning 520: Derived class 'Derived' of 'Base' + is not similarly marked as a smart pointer + - Do not generate code that attempts to cast up the inheritance chain in the + type system runtime in such cases as it doesn't compile and can't be used. + Remove unnecessary warning 520 for %shared_ptr when the base class is ignored. + +2015-10-01: vkalinin + Fix #508: Fix segfault parsing anonymous typedef nested classes. + +2015-09-26: wsfulton + [Ruby] Add shared_ptr support + +2015-09-13: kkaempf + [Ruby] Resolve tracking bug - issue #225. + The bug is that the tracking code uses a ruby hash and thus may + allocate objects (Bignum) while running the GC. This was tolerated in + 1.8 but is invalid (raises an exception) in 1.9. + The patch uses a C hash (also used by ruby) instead. + +2015-09-09: lyze + [CFFI] Extend the "export" feature in the CFFI module to support + exporting to a specified package. + +2015-09-04: olly + [Python] Fix docstrings for %callback functions. + +2015-09-03: demi-rluddy + [Go] Removed golang stringing for signed/unsigned char + + Changed default handling of signed char* and unsigned char* to be + opaque pointers rather than strings, similarly to how other + languages work. + + Any existing code relying on treating signed char* or unsigned + char* as a string can restore the old behavior with typemaps.i by + using %apply to copy the [unchanged] char* behavior. + + *** POTENTIAL INCOMPATIBILITY *** + +2015-08-07: talby + [Perl] tidy -Wtautological-constant-out-of-range-compare warnings when building generated code under clang + +2015-08-07: xantares + [Python] pep257 & numpydoc conforming docstrings: + - Mono-line module docsstring + - Rewrite autodoc parameters section in numpydoc style: + https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt + - One line summary should end with "." + - Adds a blank line after class docstring + +2015-08-05: vadz + [Java] Make (char* STRING, size_t LENGTH) typemaps usable for + strings of other types, e.g. "unsigned char*". + +Version 3.0.7 (3 Aug 2015) +========================== + +2015-08-02: wsfulton + [Java] Fix potential security exploit in generated Java classes. + The swigCPtr and swigCMemOwn member variables in the generated Java + classes are now declared 'transient' by default. Further details of the exploit + in Android is being published in an academic paper as part of USENIX WOOT '15: + https://www.usenix.org/conference/woot15/workshop-program/presentation/peles. + + In the unlikely event that you are relying on these members being serializable, + then you will need to override the default javabody and javabody_derived typemaps + to generate the old generated code. The relevant typemaps are in the Lib directory + in the java.swg, boost_shared_ptr.i and boost_intrusive_ptr.i files. Copy the + relevant default typemaps into your interface file and remove the 'transient' keyword. + + *** POTENTIAL INCOMPATIBILITY *** + +2015-08-01: vadz + Make configure --without-alllang option more useful: it can now be overridden by the following + --with-xxx options, allowing to easily enable just one or two languages. + +2015-07-30: wsfulton + Fix #440 - Initialise all newly created arrays when using %array_functions and %array_class + in the carrays.i library - bug is only relevant when using C++. + +2015-07-29: wsfulton + [Python] Improve indentation warning and error messages for code in the following directives: + + %pythonprepend + %pythonappend + %pythoncode + %pythonbegin + %feature("shadow") + + Old error example: + Error: Line indented less than expected (line 3 of pythoncode) + + New error example: + Error: Line indented less than expected (line 3 of %pythoncode or %insert("python") block) + as no line should be indented less than the indentation in line 1 + + Old warning example: + Warning 740: Whitespace prefix doesn't match (line 2 of %pythoncode or %insert("python") block) + + New warning example: + Warning 740: Whitespace indentation is inconsistent compared to earlier lines (line 3 of + %pythoncode or %insert("python") block) + + +2015-07-28: wsfulton + [Python] Fix #475. Improve docstring indentation handling. + + SWIG-3.0.5 and earlier sometimes truncated text provided in the docstring feature. + This occurred when the indentation (whitespace) in the docstring was less in the + second or later lines when compared to the first line. + SWIG-3.0.6 gave a 'Line indented less than expected' error instead of truncating + the docstring text. + Now the indentation for the 'docstring' feature is smarter and is appropriately + adjusted so that no truncation occurs. + +2015-07-22: wsfulton + Support for special variable expansion in typemap attributes. Example usage expansion + in the 'out' attribute (C# specific): + + %typemap(ctype, out="$*1_ltype") unsigned int& "$*1_ltype" + + is equivalent to the following as $*1_ltype expands to 'unsigned int': + + %typemap(ctype, out="unsigned int") unsigned int& "unsigned int" + + Special variables can be used within special variable macros too. Example usage expansion: + + %typemap(cstype) unsigned int "uint" + %typemap(cstype, out="$typemap(cstype, $*1_ltype)") unsigned int& "$typemap(cstype, $*1_ltype)" + + Special variables are expanded first and hence the above is equivalent to: + + %typemap(cstype, out="$typemap(cstype, unsigned int)") unsigned int& "$typemap(cstype, unsigned int)" + + which then expands to: + + %typemap(cstype, out="uint") unsigned int& "uint" + +2015-07-22: lindleyf + Apply patch #439 - support for $typemap() (aka embedded typemaps or special variable + macros) in typemap attributes. A simple example where $typemap() is expanded in the + 'out' attribute (C# specific): + + %typemap(cstype) unsigned int "uint" + %typemap(cstype, out="$typemap(cstype, unsigned int)") unsigned int& "$typemap(cstype, unsigned int)" + + is equivalent to: + + %typemap(cstype, out="uint") unsigned int& "uint" + +2015-07-18: m7thon + [Python] Docstrings provided via %feature("docstring") are now quoted and added to + the tp_doc slot when using python builtin classes (-builtin). When no docstring is + provided, the tp_doc slot is set to the fully qualified C/C++ class name. + Github issues #445 and #461. + +2015-07-17: kwwette + [octave] Support Octave version 4.0.0 (thanks to patches from Orion Poplawski). + +2015-07-07: wsfulton + SWIG no longer generates a wrapper for a class' constructor if that class has + any base class with a private destructor. This is because your compiler should + not allow a class to be instantiated if a base has a private destructor. Some + compilers do, so if you need the old behaviour, use the "notabstract" feature, eg: + + %feature("notabstract") Derived; + class Base { + ~Base() {} + }; + struct Derived : Base {}; + +Version 3.0.6 (5 Jul 2015) +========================== + +2015-07-02: wsfulton + Fix syntax error when the template keyword is used in types, eg: + + std::template vector v; + +2015-07-02: ngladitz + [Lua] Push characters as unformatted 1-character strings to avoid + unprintable characters such as (char)127 being converted to + "<\127>" with Lua 5.3 and later. (github PR #452) + +2015-06-29: olly + [Python] Improve handling of whitespace in %pythoncode. + + Previously SWIG looked at the indentation of the first line and + removed that many characters from each subsequent line, regardless + of what those characters were. This was made worse because SWIG's + preprocessor removes any whitespace before a '#'. Fixes github + issue #379, reported by Joe Orton. + +2015-06-12: wsfulton + [R] Fix #430 - call to SWIG_createNewRef in copyToC was incorrectly named. + +2015-06-11: sghirate + [C#] Patch #427 adds in new command line option -outfile to combine all the + generated C# code into a single file. + +2015-06-09: wsfulton + Fix seg fault processing C++11 type aliasing. Issue #424. + +2015-05-28: wsfulton + [Python] Add new feature "python:cdefaultargs" to control default argument + code generation. By default, SWIG attempts to convert C/C++ default argument values + into Python values and generates code into the Python layer with these values. + Recent versions of SWIG are able to convert more of these values, however, the + new behaviour can be circumvented if desired via this new feature, such that + the default argument values are obtained from the C layer and not the Python layer. + For example: + + struct CDA { + int fff(int a = 1, bool b = false); + }; + + The default code generation in the Python layer is: + + class CDA(_object): + ... + def fff(self, a=1, b=False): + return _default_args.CDA_fff(self, a, b) + + Adding the feature: + + %feature("python:cdefaultargs") CDA::fff; + + Results in: + + class CDA(_object): + ... + def fff(self, *args): + return _default_args.CDA_fff(self, *args) + + Some code generation modes, eg -builtin and -fastproxy, are unaffected by this as + the default values are always obtained from the C layer. + +2015-05-27: wsfulton + [Python] Deal with an integer as the default value of a typedef to bool + parameter in the C++ prototype. See #327. Regression from 3.0.0 onwards. + +2015-05-19: olly + [Python] Fix warning when compiling generated code with MSVC. + (Fixes https://sourceforge.net/p/swig/patches/351/ reported by + Mateusz Szyma¿ski). + +2015-05-14: wsfulton + Fix seg fault wrapping shared_ptr of classes with private constructors and destructors. + This also fixes the "unref" feature when used on classes with private destructors. + +2015-05-10: wsfulton + [Java] Fix multi-argument typemaps (char *STRING, size_t LENGTH) + so that they can be applied to a wider range of types. Fixes #385. + +2015-05-07: olly + [Python] Deal with an integer as the default value of a bool + parameter in the C++ prototype. Fixes github #327, reported by + Greg Allen. + +2015-05-07: LindleyF + [Java] Allow feature("director") and feature("ref") to be used + together. Github PR#403. + +2015-05-05: olly + Suppress warning 325 "Nested class not currently supported (Foo + ignored)" when Foo has already been explicitly ignored with "%ignore". + +2015-05-04: wsfulton + Add support for friend templates, including operator overloading - fixes #196. Considering + the example below, previously the operator gave a syntax error and friendfunc incorrectly + warned with: + + "Warning 503: Can't wrap 'friendfunc<(Type)>' unless renamed to a valid identifier." + + template class MyClass { + friend int friendfunc (double is, MyClass & x); + friend int operator<< (double un, const MyClass &x); + }; + + The following also previously incorrectly warned with: + + "Warning 302: Identifier 'template_friend' redefined (ignored)," + + template T template_friend(T); + struct MyTemplate { + template friend T template_friend(T); + }; + +2015-05-01: wsfulton + Fix handling of conversion operators where the operator is split over multiple + lines or has comments within the operator type. Fixes #401. + + Also fix similar problem with normal operators which gave a syntax error if split over + multiple lines or had a comment within the operator declaration. + +2015-04-30: olly + Ignore unknown preprocessor directives which are inside an inactive + conditional (github issue #394, reported by Dan Wilcox). + Regression introduced in 3.0.3. + +2015-04-27: vadz + [Python] Fix "default" typemap used after an argument with "numinputs=0" (#377). + +2015-04-24: wsfulton + [Python] Fix #256. Code generated with '-builtin -modernargs' segfaults for any + method taking zero arguments. + + Also fixes: "SystemError: error return without exception set" during error checking + when using just -builtin and the incorrect number of arguments is passed to a class + method expecting zero arguments. + +2015-04-23: wsfulton + [Java] Bug #386 - Memory leak fix in (char *STRING, size_t LENGTH) typemaps. + +2015-04-23: vadz + [Python] Make "default" typemap work again (#330, #377). + +2015-04-23: vadz + [Python] Fix the use of default values for the pointer types (#365, #376). + +2015-04-23: wsfulton + Fix 'make check-ccache' which is part of 'make check' when one of the CCACHE_ + environment variables, for example CCACHE_DISABLE, is set. + +2015-04-14: wsfulton + Clearer warning message for badly constructed typecheck typemaps. For example, was: + + example.i:3: Warning 467: Overloaded foo(int) not supported (no type checking + rule for 'int'). + + Now: + + example.i:3: Warning 467: Overloaded foo(int) not supported (incomplete type checking + rule - no precedence level in typecheck typemap for 'int'). + +2015-04-11: wsfulton + [Java] Fix #353 - Linker multiple definition of 'ExceptionMatches' when + using directors and multiple modules. + +2015-04-11: wsfulton + Merge #320 - Make __dict__ accessible for Python builtin classes. + +2015-04-07: wsfulton + Fix #375 - parsing of extern "C" and typedef for example: + extern "C" typedef void (*Hook2_t)(int, const char *); + extern "C" typedef int Integer; + +2015-03-12: olly + -DSWIG_DIRECTOR_STATIC is now supported for all languages with + director support, not only Python and PHP. + +2015-03-02: ianlancetaylor + [Go] Add -cgo option, required for Go versions 1.5 and + later. + +2015-02-26: olly + Fix segmentation fault when top==NULL, introduced by nested class + handling (reported in issue#346 by Pawe¿ Tomulik). + +2015-02-09: wsfulton + [Guile] Fix generated code for static const char member variables when + defined and declared inline. + +2015-02-09: mishas + [Go] Fix %import of files in sub directories. + +2015-02-05: ianlancetaylor + [Go] Ignore Go specific type maps (goin, goout, etc.) if they are empty. + +2015-02-05: ianlancetaylor + [Go] Generated Go code no longer calls _swig_goallocate or + _swig_makegostring, as they will no longer work as of Go 1.5. + +Version 3.0.5 (31 Jan 2015) +=========================== + +2015-01-30: wsfulton + [Python] Fix Python -classic and property setting. Setting properties on classic classes + was broken in swig-3.0.3 by attempting to use __setattr__. This regression is fixed now + by using __dict__ again when using -classic. + Fixes patch #232. + +2015-01-27: smarchetto + [Scilab] Support for the Scilab language has been added + +2015-01-23: olly + [PHP] When wrapping a returned resource as an object, check if all + cases wrap it in the same class, and if so eliminate the pointless + switch statement wrapper we previously generated. + +2015-01-22: wsfulton + [Octave] Merge patch #297 for SF bug #1277 - Octave shared_ptr support + +2015-01-15: wsfulton + [Python] Merge patch #250 - Fixes for using %constant and objects (non-primitive types) + +2015-01-15: wsfulton + [C# Go] Merge patch #308 and fix #307 - C++11 strongly typed enum support + in directors + +2015-01-15: wsfulton + [Python] Second fix for #294 #296 - Regression introduced in SWIG-3.0.3 when + wrapping functions with default arguments, this time when using kwargs. + +Version 3.0.4 (14 Jan 2015) +=========================== + +2015-01-12: olly + [PHP] Fix segfault in director upcall check when using PHP built with + ZTS enabled. Fixes #155, reported by Pierre Labastie. + +2015-01-12: vadz + [Python] Fix #294 #296 - Regression introduced in SWIG-3.0.3 when + wrapping functions with default arguments. Invalid or missing default + arguments were sometimes being generated into the python layer. + +2015-01-08: olly + Allow C++11 "explicit constexpr". Fixes github issue #284 reported + by Pawel Tomulik. Also handle "constexpr explicit" and "constexpr + static". + +2015-01-08: olly + When reporting an error for a construct which hasn't been + terminated when the end of the file is reached, report it at the + start line rather than "EOF" as then tools like editors and IDEs + will take you to a generally more useful place for fixing the + problem. + +2015-01-08: olly + Improve error messages for a few cases which previously gave the + one of the cryptic catch-all errors "Syntax error in input". + +2015-01-08: olly + Provide -cppext as a general command line option for setting the + extension used for generated C++ files (previously it was specific + to the PHP backend). Deprecate the equivalent -suffix option + provided by the Ocaml backend, but continue to support that for + now. + +Version 3.0.3 (30 Dec 2014) +=========================== + +2014-12-27: wsfulton + Fix #280 - abort using all default template parameters within other template + parameters. + +2014-12-27: talby + [Perl] Issue #282 perl5 archlib vs archlibexp + [Perl] tidy "warning: duplicate 'extern' declaration specifier" when building generated code + under clang + +2014-12-18: wsfulton + Add support for %constant and structs/classes - issue #272 + +2014-12-09: wsfulton + Fix #245 - regression (since swig-3.0.0) in templated constructors. + Templated constructors could not be instantiated - they were incorrectly ignored with a warning 504: + "Function: xyz must have a return type. Ignored." + +2014-12-07: wsfulton + Add support for C++11 strongly typed enumerations. + +2014-11-21: wsfulton + [Java C#] Fix multiply defined error when using %rename of enum items when using the "simple enum" + wrappers. + +2014-10-28: vadz + [Python] Patch #201 The generated .py file no longer uses *args for all Python parameters. + Instead, the parameters are named using the C++ parameter names. + + "compactdefaultargs" feature can be enabled to restore the old behaviour. + + *** POTENTIAL INCOMPATIBILITY *** + +2014-10-24: timotheecour + [D] Patch #204 Use core.atomic.atomicOp to mutate shared variables + +2014-10-21: wsfulton + Fix issue #242 - Use of the "kwargs" feature no longer automatically turns on the + "compactdefaultargs" feature if the target language does not support kwargs. + This change affects all languages except Python and Ruby. + + *** POTENTIAL INCOMPATIBILITY *** + +2014-10-10: diorcety + [Python] Patch #232 Fix property access using directors + +2014-10-06: wsfulton + [Python] Fixes when using -builtin and std::vector/std::list wrappers to allow deletion + of single elements, such as 'del vec[0]'. + +2014-09-30: oliverb + [Javascript] Merge patch #216 by Richie765 - Added support for many versions of v8 javascript. + +2014-09-30: oliverb + [Javascript] Merge patch #195 by zittix - Fixed JSClassRef declaration not using the static one. + +2014-09-30: ianlancetaylor + [Go] In configure script, require Go 1.1 or later. + +2014-09-30: wsfulton + [Python] Patch #207 - Fix No module error with -relativeimport when using single + header file import. + +2014-09-27: wsfulton + Patch #208 - Initialise newly created array when using array_functions in the + carrays.i library (C++ usage). + +2014-09-27: wsfulton + [Ruby] Patch #187 - Fix crash on shutdown of the Ruby interpreter if more than one + module was loaded at a time when data is being shared between modules. + +2014-09-27: wsfulton + [Java] Patch #168 - Fix leak in Java director string handling after the Java + upcall when called from a native thread. + +2014-09-25: ianlancetaylor + [Go] Adjust generated code to work with upcoming Go 1.4 + release. + +2014-09-23: wsfulton + [Python] Add patch from Thomas Maslach to fix crash in wrappers when using -threads in + the STL iterators (SwigPyIterator destructor). + +2014-09-17: wsfulton + [C#] Merge patch #229 from contre - Add bool array types to arrays_csharp.i + +2014-09-12: olly + [PHP] Add support for specifying any PHP interfaces a wrapped class + implements, e.g.: %typemap("phpinterfaces") MyIterator "Iterator"; + +2014-09-11: olly + [PHP] Fix throwing a PHP exception through C++ from a subclassed + director method - PHP NULL gets returned by the subclassed method + in this case, so the directorout typemap needs to allow that (at + least if an exception is active). + +2014-09-09: ianlancetaylor + [Go] Add goargout typemap. + +2014-09-09: olly + [PHP] Fix segmentation faults with directors in PHP >= 5.4, and + reenable runme tests for director_basic testcase. Fix from + pavel-charvat in issue#164. + +2014-09-05: ianlancetaylor + [Go] Add imtype, goin, goout, godirectorin, and + godirectorout typemaps, to support writing Go code to + convert between types. + +2014-09-02: olly + [Python] Fix regression in indentation of python code produced with + -modern, introduced by changes in #188. Reported by fabiencastan + in #218. + +2014-09-01: olly + Issue an error for unknown SWIG preprocessor directives, rather + than quietly ignoring them. Reported by jrhelsey in issue#217. + + *** POTENTIAL INCOMPATIBILITY *** + +2014-08-15: talby + [Perl] Include guard fix for nested modules from Anthony Heading (SF Patch #350). + +2014-08-04: wsfulton + [C#] Merge patch #200 from gpetrou - Changed CSharp license header to include auto-generated + tag so that StyleCop ignores the files. + +2014-08-04: wsfulton + [Java] Merge patch #198 from Yuval Kashtan - Support for java.nio.ByteBuffer mapping to + unsigned char * in various.i in NIOBUFFER typemaps. + +2014-07-14: ianlancetaylor + [Go] Change struct definition to use void *, not uint8, so + that the type is recorded as possibly containing + pointers. This ensures that the 1.3 garbage collector + does not collect pointers passed to C++ code. + +2014-07-01: wsfulton + Fix SF Bug #1375 - Expansion of the $parentclassname special variable incorrectly contains + brackets in the expanded name. + +Version 3.0.2 (4 Jun 2014) +========================== + +2014-06-02: v-for-vandal + [Lua] Pull request #176: + If class has no __eq implemented, then default __eq is generated. + Default __eq compares actual pointers stored inside Lua userdata. + +2014-06-02: vkalinin + Fix #183 - %extend and unnamed nested structs + +2014-05-28: kwwette + Fix install failure when using an 'out of source' build using the shipped + tarball - regression introduced in swig-3.0.1. + +2014-05-24: kwwette + [Octave] Remove deprecated -global/-noglobal command-line arguments + + *** POTENTIAL INCOMPATIBILITY *** + +Version 3.0.1 (27 May 2014) +=========================== + +2014-05-25: hfalcic + [Python] Python 3 byte string output: use errors="surrogateescape" + if available on the version of Python that's in use. This allows + obtaining the original byte string (and potentially trying a fallback + encoding) if the bytes can't be decoded as UTF-8. + + Previously, a UnicodeDecodeError would be raised with no way to treat + the data as bytes or try another codec. + +2014-05-18: vkalinin + Bug #175 - Restore %extend to work for unnamed nested structures by using a C + symbol comprising the outer structure name and unnamed variable instance name. + +2014-05-15: kwwette + Add #166 - 'make check' now works out of source. This required the examples to build + out of source. The main languages have been tested - C#, Go, Guile, Java, Javascript, + Lua, Octave, Perl, PHP, Python, Ruby and Tcl. + +2014-05-01: Oliver Buchtala + Javascript support added, see Javascript chapter in the documentation. + +2014-05-01: olly + [PHP] The generated __isset() method now returns true for read-only properties. + +2014-04-24: kwwette + [Go] Fix go ./configure parsing of gccgo --version, and + goruntime.swg typo in __GNUC_PATCHLEVEL__ (SF Bug #1298) + +2014-04-24: kwwette + Fix {python|perl5|ruby|tcl}/java examples + + In Lib/gcj/cni.i, for compatibility with newer gcj versions: + + - remove JvAllocObject() which gcj no longer defines, from gcj Changelog: + 2004-04-16 Bryce McKinlay + * gcj/cni.h (JvAllocObject): Remove these obsolete, + undocumented CNI calls. + + - change JvCreateJavaVM() argument from void* to JvVMInitArgs*, from gcj Changelog: + 2005-02-23 Thomas Fitzsimmons + PR libgcj/16923 + ... + (JvCreateJavaVM): Declare vm_args as JvVMInitArgs* rather than void*. + + *** POTENTIAL INCOMPATIBILITY *** + +2014-04-08: wsfulton + SF Bug #1366 - Remove duplicate declarations of strtoimax and strtoumax in inttypes.i + +2014-04-08: wsfulton + [Java C#] Enums which have been ignored via %ignore and are subsequently + used are handled slightly differently. Type wrapper classes are now generated + which are effectively a wrapper of an empty enum. Previously in Java uncompilable + code was generated and in C# an int was used. + +2014-04-04: wsfulton + Fix regression in 3.0.0 where legal code following an operator<< definition might + give a syntax error. SF Bug #1365. + +2014-04-03: olly + [PHP] Fix wrapping director constructors with default parameters + with a ZTS-enabled build of PHP. + +2014-04-02: olly + [PHP] Pass the ZTS context we already have to avoid needing to + call TSRMLS_FETCH, which is relatively expensive. + +2014-04-02: olly + [PHP] Pass ZTS context through to t_output_helper() so it works + with a ZTS-enabled build of PHP. Reported by Pierre Labastie in + github PR#155. + +2014-03-28: wsfulton + [Java C# D Go] Fixes for C enums used in an API and the definition of the enum + has not been parsed. For D, this fixes a segfault in SWIG. The other languages + now produce code that compiles, although the definition of the enum is needed + in order to use the enum properly from the target language. + +2014-03-23: v-for-vandal + [Lua] Fix for usage of snprintf in Lua runtime which Visual Studio does not have. + +Version 3.0.0 (16 Mar 2014) +=========================== + +2014-03-16: wsfulton + C++11 support initially developed as C++0x support by Matevz Jekovec as a Google Summer of Code + project has been further extended. The C++11 support is comprehensive, but by no means complete + or without limitations. Full details for each new feature in C++11 is covered in the + CPlusPlus11.html chapter in the documentation which is included in SWIG and also available + online at http://www.swig.org/Doc3.0/CPlusPlus11.html. + +2014-03-14: v-for-vandal + [Lua] Numerous Lua improvements: + 1. %nspace support has been added. Namespaces are mapped to tables in the module, with the same + name as the C++ namespace. + 2. Inheritance is now handled differently. Each class metatable keeps a list of class bases instead + of merging all members of all bases into the derived class. + 3. The new metatables result in differences in accessing class members. For example: + + %module example + struct Test { + enum { TEST1 = 10, TEST2 = 20 }; + static const int ICONST = 12; + }; + + Now this can be used as follows: + print(example.Test.TEST1) + print(example.Test.ICONST) + The old way was: + print(example.Test_TEST1) + print(example.Test_ICONST) + + 4. The special class metatable member ".constructor" was removed. Now SWIG generates the proxy + function by itself and assigns it directly to the class table "__call" method. + 5. eLua should also now support inheritance. + 6. 'const' subtable in eLua is considered deprecated. + + Changes in behaviour: + a. You can no longer assign to non-existing class members in classes without a __setitem__ method. + It will cause a Lua error. + b. You can no longer iterate over a module table and copy everything into the global namespace. + Actually, this was never the case, but it is now explicitly prohibited. + c. Now changing a base class will immediately affect all derived classes. + d. There might be some issues with inheritance. Although the bases iteration scheme is the same + as was used for merging base classes into derived one, some unknown issues may arise. + + The old metatable behaviour can be restored by using the -no-old-metatable-bindings option. + + *** POTENTIAL INCOMPATIBILITY *** + +2014-03-06: wsfulton + [Python] Change in default behaviour wrapping C++ bool. Only a Python True or False + will now work for C++ bool parameters. This fixes overloading bool with other types. + Python 2.3 minimum is now required for wrapping bool. + + When wrapping: + + const char* overloaded(bool value) { return "bool"; } + const char* overloaded(int value) { return "int"; } + + Previous behaviour: + >>> overloaded(False) + 'int' + >>> overloaded(True) + 'int' + >>> overloaded(0) + 'int' + + Now we get the expected behaviour: + >>> overloaded(False) + 'bool' + >>> overloaded(0) + 'int' + + The consequence is when wrapping bool in non-overloaded functions: + + const char* boolfunction(bool value) { return value ? "true" : "false"; } + + The previous behaviour was very Pythonic: + >>> boolfunction("") + 'false' + >>> boolfunction("hi") + 'true' + >>> boolfunction(12.34) + 'true' + >>> boolfunction(0) + 'false' + >>> boolfunction(1) + 'true' + + Now the new behaviour more along the lines of C++ due to stricter type checking. The + above calls result in an exception and need to be explicitly converted into a bool as + follows: + >>> boolfunction(0) + Traceback (most recent call last): + File "", line 1, in + TypeError: in method 'boolfunction', argument 1 of type 'bool' + >>> boolfunction(bool(0)) + 'false' + + The old behaviour can be resurrected by passing the -DSWIG_PYTHON_LEGACY_BOOL command line + parameter when executing SWIG. Typemaps can of course be written to customise the behaviour + for specific parameters. + + *** POTENTIAL INCOMPATIBILITY *** + +2014-03-06: wsfulton + Fix SF Bug #1363 - Problem with method overloading when some methods are added by %extend + and others are real methods and using template default parameters with smart pointers. + This is noticeable as a regression since 2.0.12 when using the default smart pointer + handling for some languages when the smart pointer wraps std::map and other STL containers. + +2014-03-02: wsfulton + [Python] SF Patch #346 from Jens Krueger. Correct exception thrown attempting to + access a non-existent C/C++ global variable on the 'cvar' object. The exception thrown + used to be a NameError. However, as this access is via a primary, an AttributeError + is more correct and so the exception thrown now is an AttributeError. Reference: + http://docs.python.org/2/reference/expressions.html#attribute-references + + *** POTENTIAL INCOMPATIBILITY *** + +2014-03-01: wsfulton + [Python] Patch #143 Fix type shown when using type() to include the module and package + name when using -builtin. + +2014-03-01: wsfulton + [Python] SF patch #347 Fix missing argument count checking with -modern. + Fixes regression introduced when builtin changes were introduced in SWIG-2.0.3. + +2014-02-21: wsfulton + [PHP] Fix warning suppression using %warnfilter for PHP reserved class names. + +2014-02-19: olly + [Lua] Add keyword warnings for Lua keywords and Basic Functions. + +2014-02-19: olly + -Wallkw now includes keywords for all languages with keyword + warnings (previously Go and R were missing). + +2014-02-19: olly + [PHP] Update the lists of PHP keywords with new ones from PHP 5.4 + and newer (and some missing ones from 5.3). Reserved PHP constants + names are now checked against enum values and constants, instead + of against function and method names. Built-in PHP function names + no longer match methods added by %extend. Functions and methods + named '__sleep', '__wakeup', 'not', 'parent', or 'virtual' are no + longer needlessly renamed. + +2014-02-15: wsfulton + Fix the %$ismember %rename predicates to also apply to members added via %extend. + + Add %$isextendmember for %rename of members added via %extend. This can be used to + distinguish between normal class/struct members and %extend members. For example + '%$ismember, %$not %$isextendmember' will now identify just class/struct members. + + *** POTENTIAL INCOMPATIBILITY *** + +2014-02-16: hfalcic + [Python] Patch #137 - fix crashes/exceptions in exception handling in Python 3.3 + +2014-02-15: wsfulton + [Java] Add support for the cdata library. + +2014-02-08: vkalinin + Nested class support added. This primarily allows SWIG to properly parse nested + classes and keep the nested class information in the parse tree. Java and C# + have utilised this information wrapping the C++ nested classes as Java/C# + nested classes. The remaining target languages ignore nested classes as in + previous versions. Help is needed by users of these remaining languages to + design how C++ nested classes can be best wrapped. Please talk to us on the + swig-devel mailing list if you think you can help. + + Previously, there was limited nested class support. Nested classes were treated + as opaque pointers. However, the "nestedworkaround" feature provided a way to + wrap a nested class as if it was a global class. This feature no longer exists + and is replaced by the new "flatnested" feature. This effectively does the same + thing with less manual code to be written. Please see the 'Nested classes' + section in the documentation in SWIGPlus.html if you were previously using this + feature. + + SWIG now parses the contents of nested classes where previously it did not. You + may find that you will need to make adjustments to your interface file as + effectively extra code is being wrapped. + + *** POTENTIAL INCOMPATIBILITY *** + +2014-02-06: gjanssens + [Guile] Patch #133. Make scm to string conversion work with non-ascii strings. + Guile 2 has a completely rewritten string implementation. SWIG made some assumptions + that are no longer valid as to the internals of guile's string representation. + +2014-01-30: wsfulton + [C#] Add new swigtype_inout.i library containing SWIGTYPE *& OUTPUT typemaps. + + Example usage wrapping: + + void f(XXX *& x) { x = new XXX(111); } + + would be: + + XXX x = null; + f(out x); + // use x + x.Dispose(); // manually clear memory or otherwise leave out and leave it to the garbage collector + +2014-01-21: ianlancetaylor + [Go] Add %go_import directive. + +2014-01-21: ianlancetaylor + [Go] Add support for Go 1.3, not yet released. + +2014-01-20: wsfulton + Director exceptions (Swig::DirectorException) now derive from std::exception + and hence provide the what() method. In Python and Ruby, this replaces the now + deprecated DirectorException::getMessage() method. + +2014-01-14: diorcety + Patch #112 - Fix symbol resolution involving scopes that have multiple levels + of typedefs - fixes some template resolutions as well as some typemap searches. + +2014-01-11: wsfulton + Fix and document the naturalvar feature override behaviour - the naturalvar + feature attached to a variable name has precedence over the naturalvar + feature attached to the variable's type. The overriding was not working + when turning the feature off on the variable's name. + + Fix so that any use of the naturalvar feature will override the global + setting. Previously when set globally by -naturalvar or %module(naturalvar=1), + use of the naturalvar feature was not always honoured. + +2014-01-06: ianlancetaylor + [Go] Fix bug that broke using directors from a thread not + created by Go. + +2013-12-24: ptomulik + [Python] SF Bug #1297 + + Resolve several issues related to python imports. + For example, it's now possible to import modules having the same module + names, but belonging in different packages. + + From the user's viewpoint, this patch gives a little bit more control on + import statements generated by SWIG. The user may choose to use relative + or absolute imports. + + Some details: + - we (still) generate import statements in the form 'import a.b.c' which + corresponds to absolute imports in python3 and (the only available) + ambiguous one in python2. + - added -relativeimport option to use explicit relative import syntax + (python3), + + The "Python Packages" section in the documentation discusses how to work + with importing packages including the new -relativeimport command line option. + +2013-12-23: vadz + [Octave, Perl, Python, R, Ruby, Tcl] Change the length of strings created from fixed-size char + buffers in C code. + + This is a potential backwards compatibility break: a "char buf[5]" containing "ho\0la" was + returned as a string of length 5 before, but is returned as a string of length 2 now. Also, + it was possible to assign a (non-NUL-terminated) string "hello" to such a buffer before but + now this fails and only "helo" can fit. + + Apply "char FIXSIZE[ANY]" typemaps to explicitly choose the old behaviour. + + *** POTENTIAL INCOMPATIBILITY *** + +2013-12-23: talby + [Perl] Add support for directors. + +2013-12-18: ianlancetaylor + [Go] Don't require that Go environment variables be set + when running examples or testsuite when using Go 1 or + later. + +2013-12-17: ianlancetaylor + [Go] Remove -longsize option (for backward compatibility, + ignore it if seen). + +2013-12-17: ianlancetaylor + [Go] Add -go-pkgpath option. + +2013-12-16: ianlancetaylor + [Go] Update for Go 1.2 release. Add support for linking + SWIG code directly into executable, rather than using a + shared library. + +2013-12-13: ianlancetaylor + [Go] Add SWIG source file name as comments in generated + files. This can be used by Go documentation tools. + +2013-12-12: jleveque + [Lua] Fix typo (wchar instead of wchar_t) which made wchar.i + for Lua useless. + +2013-12-12: vmiklos + [PHP] PHP's peculiar call-time pass-by-reference feature was + deprecated in PHP 5.3 and removed in PHP 5.4, so update the REF + typemaps in phppointers.i to specify pass-by-reference in the + function definition. Examples/php/pointer has been updated + accordingly. + +2013-12-12: olly + [PHP] The usage of $input in PHP directorout typemaps has been + changed to be consistent with other languages. The typemaps + provided by SWIG have been updated accordingly, but if you + have written your own directorout typemaps, you'll need to + update $input to &$input (or make equivalent changes). + + *** POTENTIAL INCOMPATIBILITY *** + +2013-11-27: vadz + [C#, Java, Python] Add std_auto_ptr.i defining typemaps for returning std::auto_ptr<>. + +2013-11-09: wsfulton + [C#] Apply patch #79 from Brant Kyser + - Remove using directives from the generated C# code and fully qualify the use of all .NET + framework types in order to minimize potential name collisions from input files defining + types, namespace, etc with the same name as .NET framework members. + - Globally qualify the use of .NET framework types in the System namespace + - Remove .NET 1.1 support, .NET 2 is the minimum for the C# module + + This is a potential backwards compatibility break if code has been added relying on these using + statements that used to be generated: + + using System; + using System.Runtime.InteropServices; + + The quick fix to add these back in is to add the -DSWIG2_CSHARP command line option when + executing SWIG. See CSharp.html documentation for more info. + + *** POTENTIAL INCOMPATIBILITY *** + +2013-11-05: wsfulton + [Java] Fix some corner cases for the $packagepath/$javaclassname special variable substitution. + +2013-11-05: wsfulton + [Java] Apply patch #91 from Marvin Greenberg - Add director:except feature for improved + exception handling in director methods for Java. + +2013-10-15: vadz + Allow using \l, \L, \u, \U and \E in the substitution part of %(regex:/pattern/subst/) + inside %rename to change the case of the text being replaced. + +2013-10-12: wsfulton + [CFFI] Apply #96 - superclass not lispify + +2013-10-12: wsfulton + Merge in C++11 support from the gsoc2009-matevz branch where Matevz Jekovec first + started the C++0x additions. Documentation of the C++11 features supported is in a + new Chapter of the documentation, "SWIG and C++11" in Doc/Manual/CPlusPlus11.html. + +2013-10-04: wsfulton + Fix %naturalvar not having any affect on templated classes instantiated with an + enum as the template parameter type. Problem reported by Vadim Zeitlin. + +2013-09-20: wsfulton + [Java] Fix a memory leak for the java char **STRING_ARRAY typemaps. + +Version 2.0.12 (9 Feb 2014) +=========================== + +2014-01-16: wsfulton + [PHP] Fix compilation error in ZTS mode (64 bit windows) due to incorrect placement + of TSRMLS_FETCH() in SWIG_Php_GetModule() as reported by Mark Dawson-Butterworth. + +2014-01-13: kwwette + [Octave] update support to Octave version 3.8.0 + + - Octave 3.8.0 no longer defines OCTAVE_API_VERSION_NUMBER, but 3.8.1 + will define OCTAVE_{MAJOR,MINOR,PATCH}_VERSION instead: see + http://hg.savannah.gnu.org/hgweb/octave/rev/b6b6e0dc700e + So we now use a new macro SWIG_OCTAVE_PREREQ(major,minor,patch) to + enable features requiring Octave version major.minor.patch or later. + + For Octave versions prior to 3.8.1, we reconstruct values for + OCTAVE_{MAJOR,MINOR,PATCH}_VERSION based on OCTAVE_API_VERSION_NUMBER, + extracted from Octave's ChangeLogs. An additional hack is needed to + distinguish between Octave <= 3.2.x and 3.8.0, neither of which define + OCTAVE_API_VERSION_NUMBER. + + - Octave 3.8.0 deprecates symbol_table::varref(), so remove its use + for this and future versions of Octave. + + - Octave 3.8.0 removes octave_value::is_real_nd_array(), used in + octave_swig_type::dims(). Its use is not required here, so remove it. + + - Retested against Octave versions 3.0.5, 3.2.4, 3.4.3, 3.6.4, and 3.8.0. + + - Updated Octave documentation with tested Octave versions, and added a + warning against using versions <= 3.x.x, which are no longer tested. + +2013-12-22: wsfulton + C++11 support for new versions of erase and insert in the STL containers. + + The erase and insert methods in the containers use const_iterator instead + of iterator in C++11. There are times when the methods wrapped must match + the parameters exactly. Specifically when full type information for + template types is missing or SWIG fails to look up the type correctly, + for example: + + %include + typedef float Real; + %template(RealVector) std::vector; + + SWIG does not find std::vector::iterator because %template using + typedefs does not always work and so SWIG doesn't know if the type is + copyable and so uses SwigValueWrapper which does + not support conversion to another type (const_iterator). This resulted + in compilation errors when using the C++11 version of the containers. + + Closes #73 + +2013-10-17: wsfulton + [R] Fix SF #1340 - Visual Studio compile error in C++ wrappers due to #include + within extern "C" block. + +2013-10-17: wsfulton + [Python] Fix SF #1345 - Missing #include for offsetof when using -builtin. + +2013-10-12: wsfulton + [Lua] Apply #92 - missing return statements for SWIG_Lua_add_namespace_details() + and SWIG_Lua_namespace_register(). + Version 2.0.11 (15 Sep 2013) ============================ @@ -200,7 +1610,7 @@ Version 2.0.10 (27 May 2013) The macros are silently ignored. 2013-04-17: wsfulton - [C#] Pull patch #34 from BrantKyser to fix smart pointers in conjuction with directors. + [C#] Pull patch #34 from BrantKyser to fix smart pointers in conjunction with directors. 2013-04-15: kwwette [Octave] Fix bugs in output of cleanup code. @@ -493,13 +1903,13 @@ Version 2.0.9 (16 December 2012) 2012-10-11: wsfulton Most of the special variables available for use in %exception are now also available for expansion in - %extend blocks. These are: $name $symname $overname $decl $fulldecl $parentname $parentsymname, see docs + %extend blocks. These are: $name $symname $overname $decl $fulldecl $parentclassname $parentclasssymname, see docs on "Class extension" in SWIGPlus.html. Patch based on submission from Kris Thielemans. 2012-10-10: wsfulton Additional new special variables in %exception are expanded as follows: - $parentname - The parent class name (if any) for a method. - $parentsymname - The target language parent class name (if any) for a method. + $parentclassname - The parent class name (if any) for a method. + $parentclasssymname - The target language parent class name (if any) for a method. 2012-10-08: iant [Go] Generating Go code now requires using the -intgosize option to @@ -787,7 +2197,7 @@ Version 2.0.6 (30 April 2012) [Lua] Fix uninitialised variable in SWIGTYPE **OUTPUT typemaps as reported by Jim Anderson. 2012-04-28: wsfulton - [Python] Fix compilation errors when wrapping STL containers on Mac OSX and possibly other systems. + [Python] Fix compilation errors when wrapping STL containers on Mac OS X and possibly other systems. 2012-04-28: wsfulton [Java] Patch 3521811 from Leo Davis - char **STRING_ARRAY typemaps fixed to handle @@ -1094,7 +2504,7 @@ Version 2.0.5 (19 April 2012) -tmsearch and -tmused. 2011-08-26: wsfulton - [C#, D] Fix %callback which was generating uncompileable code. + [C#, D] Fix %callback which was generating uncompilable code. 2011-08-25: wsfulton Fix constructors in named typedef class declarations as reported by Gregory Bronner: @@ -1333,7 +2743,7 @@ Version 2.0.4 (21 May 2011) PySlice_GetIndices, which changed signatures in python3.2. 2011-04-07: wsfulton - Fix wrapping of const array typedefs which were generating uncompileable code as + Fix wrapping of const array typedefs which were generating uncompilable code as reported by Karl Wette. 2011-04-03: szager @@ -1482,7 +2892,7 @@ Version 2.0.2 (20 February 2011) Update chapter name to MzScheme/Racket accounting for the rename of MzScheme to Racket. 2011-02-05: wsfulton - [C#] SF #3085906 - Possible fix running test-suite on Mac OSX. + [C#] SF #3085906 - Possible fix running test-suite on Mac OS X. 2011-02-05: wsfulton SF #3173367 Better information during configure about Boost prerequisite for running @@ -1560,8 +2970,8 @@ Version 2.0.2 (20 February 2011) Fix handling of multiple regex-using %renames attached to the same declaration. For example, now - %rename("%(regex/^Set(.*)/put\\1/)s") ""; - %rename("%(regex/^Get(.*)/get\\1/)s") ""; + %rename("%(regex:/^Set(.*)/put\\1/)s") ""; + %rename("%(regex:/^Get(.*)/get\\1/)s") ""; works as expected whereas before only the last anonymous rename was taken into account. @@ -1771,7 +3181,7 @@ Version 2.0.1 (4 October 2010) in this case). 2010-06-03: wsfulton - Fix uncompileable code when %rename results in two enum items + Fix uncompilable code when %rename results in two enum items with the same name. Reported by Vadim Zeitlin. Version 2.0.0 (2 June 2010) @@ -2284,7 +3694,7 @@ Version 2.0.0 (2 June 2010) Fix #2310483 - function pointer typedef within extern "C" block. 2009-11-13: wsfulton - Fix usage of nested template classes within templated classes so that compileable code + Fix usage of nested template classes within templated classes so that compilable code is generated. 2009-11-13: olly @@ -2292,7 +3702,7 @@ Version 2.0.0 (2 June 2010) wasn't being used. Patch from gverbruggen in SF#2892647. 2009-11-12: wsfulton - Fix usage of nested template classes so that compileable code is generated - the nested + Fix usage of nested template classes so that compilable code is generated - the nested template class is now treated like a normal nested classes, that is, as an opaque type unless the nestedworkaround feature is used. @@ -2318,7 +3728,7 @@ Version 2.0.0 (2 June 2010) 2009-11-11: wsfulton There were a number of C++ cases where nested classes/structs/unions were being handled - as if C code was being parsed which would oftentimes lead to uncompileable code as an + as if C code was being parsed which would oftentimes lead to uncompilable code as an attempt was made to wrap the nested structs like it is documented for C code. Now all nested structs/classes/unions are ignored in C++ mode, as was always documented. However, there is an improvement as usage of nested structs/classes/unions is now always treated @@ -2330,7 +3740,7 @@ Version 2.0.0 (2 June 2010) Fix R for -fcompact and add std_map.i 2009-11-08: wsfulton - Fix inconsistency for nested structs/unions/classes. Uncompileable code was being + Fix inconsistency for nested structs/unions/classes. Uncompilable code was being generated when inner struct and union declarations were used as types within the inner struct. The inner struct/union is now treated as a forward declaration making the behaviour the same as an inner class. (C++ code), eg: @@ -2344,7 +3754,7 @@ Version 2.0.0 (2 June 2010) Ignored nested class/struct warnings now display the name of the ignored class/struct. 2009-11-07: wsfulton - Bug #1514681 - Fix nested template classes within a namespace generated uncompileable + Bug #1514681 - Fix nested template classes within a namespace generated uncompilable code and introduced strange side effects to other wrapper code especially code after the nested template class. Note that nested template classes are still ignored. @@ -2370,8 +3780,8 @@ Version 2.0.0 (2 June 2010) and in template parameter specializations: struct S {}; - template struct X { void a() {}; }; - template <> struct X { void b() {}; }; + template struct X { void a() {} }; + template <> struct X { void b() {} }; %template(MyTConcrete) X< ::S >; plus probably some other corner case usage of ::. @@ -3135,7 +4545,7 @@ Version 1.3.37 (13 January 2009) in Allegro CL 2008-07-19: wsfulton - Fix building of Tcl examples/test-suite on Mac OSX reported by Gideon Simpson. + Fix building of Tcl examples/test-suite on Mac OS X reported by Gideon Simpson. 2008-07-17: wsfulton Fix SF #2019156 Configuring with --without-octave or --without-alllang @@ -3199,7 +4609,7 @@ Version 1.3.36 (24 June 2008) 06/19/2008: wsfulton [Java, C#] C# and Java keywords will be renamed instead of just issuing a warning - and then generating uncompileable code. Warning 314 gives the new name when a + and then generating uncompilable code. Warning 314 gives the new name when a keyword is found. 06/19/2008: wsfulton @@ -3302,8 +4712,8 @@ Version 1.3.36 (24 June 2008) Makefile target being generated when generating makefiles with the -M family of options. For example: - $ swig -java -MM -MT overiddenname -c++ example.i - overiddenname: \ + $ swig -java -MM -MT overriddenname -c++ example.i + overriddenname: \ example.i \ example.h @@ -3642,7 +5052,7 @@ Version 1.3.34 (27 February 2008) 11/30/2007: wsfulton Fix using statements using a base class method where the methods were overloaded. Depending on the order of the using statements and method declarations, these - were previously generating uncompileable wrappers, eg: + were previously generating uncompilable wrappers, eg: struct Derived : Base { virtual void funk(); @@ -3780,7 +5190,7 @@ Version 1.3.32 (November 15, 2007) %attributeref(Class, AttributeType, AttributeName, AccessorMethod) 10/16/2007: olly - [Tcl] Fix several ocurrences of "warning: deprecated conversion + [Tcl] Fix several occurrences of "warning: deprecated conversion from string constant to 'char*'" from GCC 4.2 in generated C/C++ code. @@ -4730,7 +6140,7 @@ Version 1.3.30 (November 13, 2006) 10/03/2006: wsfulton [Ruby] Fix #1527885 - Overloaded director virtual methods sometimes produced - uncompileable code when used with the director:except feature. + uncompilable code when used with the director:except feature. 10/03/2006: wsfulton Directors: Directors are output in the order in which they are declared in @@ -5205,7 +6615,7 @@ Version 1.3.29 (March 21, 2006) 6146 _std_containers.so 174 _std_containers.so.hidden - Excecution times: + Execution times: real 0m0.050s user 0m0.039s sys 0m0.005s _std_containers.so real 0m0.039s user 0m0.026s sys 0m0.007s _std_containers.so.hidden @@ -5291,7 +6701,7 @@ Version 1.3.29 (March 21, 2006) protected methods by default. In previous releases, you needed to use the 'dirprot' - option to acheive the same. + option to achieve the same. If you want, you can disable the new default behaviour, use the 'nodirprot' option: @@ -5618,7 +7028,7 @@ Version 1.3.28 (February 12, 2006) %rename("%(utitle)s",%$isfunction,%$ismember) ""; - to avoid clashings with other swig macros/directives. + to avoid clashes with other swig macros/directives. 01/14/2006: cfisavage [Ruby] @@ -6639,7 +8049,7 @@ Version 1.3.28 (February 12, 2006) 12/10/2005: mmatus [UTF] - - Fix unneccessary calls to SWIG_TypeQuery for 'char *' + - Fix unnecessary calls to SWIG_TypeQuery for 'char *' and 'wchar_t *', problem found by Clay Culver while profiling the PyOgre project. @@ -8928,7 +10338,7 @@ Version 1.3.23 (November 11, 2004) wrapper method only and not the extra overloaded methods that SWIG generates. For example: - %feature("except") void hello(int i=0, double d=0.0); + %feature("except") hello(int i=0, double d=0.0); void hello(int i=0, double d=0.0); will apply the feature to all three wrapper methods, that is: @@ -8939,7 +10349,7 @@ Version 1.3.23 (November 11, 2004) If the default arguments are not specified in the feature: - %feature("except") void hello(int i, double d); + %feature("except") hello(int i, double d); void hello(int i=0, double d=0.0); then the feature will only apply to this wrapper method: @@ -9546,7 +10956,7 @@ Version 1.3.23 (November 11, 2004) - Remove the ability to share type information by using c linking. All type sharing happens through a global variable in the target language. + Remove SWIG_NOIMPORT, SWIG_RUNTIME, and related defines. - + Depreciate -runtime, -noruntime command line options + + Deprecate -runtime, -noruntime command line options + Update test-suite common.mk to correctly build multicpptest + Remove reference to precommon.swg + Update the guile_gh interface to share data by a global var instead @@ -9974,7 +11384,7 @@ Version 1.3.23 (November 11, 2004) now if you have - %pythonnondynamic(1) A; + %pythonnondynamic A; struct A { int a; @@ -9992,11 +11402,11 @@ Version 1.3.23 (November 11, 2004) Since this is a feature, you can use - %pythonnondynamic(1); + %pythonnondynamic; or - %pythondynamic(0); [ Note: %pythondynamic since deprecated ] + %pythondynamic; [ Note: %pythondynamic since deprecated ] to force all the wrapped classes to be "nondynamic" ones. @@ -10314,7 +11724,7 @@ Version 1.3.22 (September 4, 2004) ... } - Previously, none of BIG, LARGE or BAR would have produced compileable code + Previously, none of BIG, LARGE or BAR would have produced compilable code when using %javaconst(1). 06/27/2004: wsfulton @@ -11721,7 +13131,7 @@ Version 1.3.20 (December 17, 2003) 11/30/2003: cheetah (William Fulton) [Java] Fixed [ 766409 ] missing symbol SWIG_JavaThrowException during module load - SWIGs internal functions are all static as there is no need for different SWIG + SWIG's internal functions are all static as there is no need for different SWIG generated modules to share any code at runtime. 11/30/2003: beazley @@ -11956,7 +13366,7 @@ Version 1.3.20 (December 17, 2003) Suggested by Kerim Borchaev. 11/11/2003: beazley - Configuration changes to make SWIG work on Mac OSX 10.3.x (Panther). + Configuration changes to make SWIG work on Mac OS X 10.3.x (Panther). Tested with Python, Tcl, Perl, and Ruby---all of which seem to work. 11/08/2003: cheetah (William Fulton) @@ -19706,13 +21116,13 @@ Version 1.3.6 (July 9, 2001) class TestClass { public: - TestClass() {}; - TestClass(int a) {}; - ~TestClass() {}; - unsigned long xyz(short k) {}; - unsigned long xyz(int n) {}; - static void static_func() {}; - static void static_func(int a) {}; + TestClass() {} + TestClass(int a) {} + ~TestClass() {} + unsigned long xyz(short k) {} + unsigned long xyz(int n) {} + static void static_func() {} + static void static_func(int a) {} }; void delete_TestClass(int a); @@ -20788,9 +22198,9 @@ Version 1.3 Alpha 1 (February 11, 2000) *** POTENTIAL INCOMPATIBILITY *** 1/30/00 : loic - Conditionaly compile experimental code with --enable-experiment + Conditionally compile experimental code with --enable-experiment configure flag. - Fix .cvsignore to ignore configrue & yacc generated files + Fix .cvsignore to ignore configure & yacc generated files 1/28/00 : loic Apply automake everywhere @@ -21302,7 +22712,7 @@ Version 1.1 Patch 4 (January 4, 1998) 12/29/97: Fixed configure script and a few makefiles to support Python 1.5 12/29/97: Added 'embed15.i' library file. This file should be used to - staticly link versions of Python 1.5. To make it the default, + statically link versions of Python 1.5. To make it the default, simply copy 'swig_lib/python/embed15.i' to 'swig_lib/python/embed.i' Version 1.1 Patch 3 (November 24, 1997) @@ -22362,7 +23772,7 @@ Version 1.1b5 (March 12, 1997) 2/23/97 : Modified Python module to be better behaved under Windows - Module initialization function is now properly exported. - It should not be neccessary to explicitly export this function + It should not be necessary to explicitly export this function yourself. - Bizarre compilation problems when compiling the SWIG wrapper diff --git a/CHANGES.current b/CHANGES.current index d55bb97..b5b4567 100644 --- a/CHANGES.current +++ b/CHANGES.current @@ -2,68 +2,44 @@ Below are the changes for the current release. See the CHANGES file for changes in older releases. See the RELEASENOTES file for a summary of changes in each release. -Version 2.0.12 (9 Feb 2014) -=========================== - -2014-01-16: wsfulton - [PHP] Fix compilation error in ZTS mode (64 bit windows) due to incorrect placement - of TSRMLS_FETCH() in SWIG_Php_GetModule() as reported by Mark Dawson-Butterworth. - -2014-01-13: kwwette - [Octave] update support to Octave version 3.8.0 - - - Octave 3.8.0 no longer defines OCTAVE_API_VERSION_NUMBER, but 3.8.1 - will define OCTAVE_{MAJOR,MINOR,PATCH}_VERSION instead: see - http://hg.savannah.gnu.org/hgweb/octave/rev/b6b6e0dc700e - So we now use a new macro SWIG_OCTAVE_PREREQ(major,minor,patch) to - enable features requiring Octave version major.minor.patch or later. - - For Octave versions prior to 3.8.1, we reconstruct values for - OCTAVE_{MAJOR,MINOR,PATCH}_VERSION based on OCTAVE_API_VERSION_NUMBER, - extracted from Octave's ChangeLogs. An additional hack is needed to - distinguish between Octave <= 3.2.x and 3.8.0, neither of which define - OCTAVE_API_VERSION_NUMBER. - - - Octave 3.8.0 deprecates symbol_table::varref(), so remove its use - for this and future versions of Octave. - - - Octave 3.8.0 removes octave_value::is_real_nd_array(), used in - octave_swig_type::dims(). Its use is not required here, so remove it. - - - Retested against Octave versions 3.0.5, 3.2.4, 3.4.3, 3.6.4, and 3.8.0. - - - Updated Octave documentation with tested Octave versions, and added a - warning against using versions <= 3.x.x, which are no longer tested. - -2013-12-22: wsfulton - C++11 support for new versions of erase and insert in the STL containers. - - The erase and insert methods in the containers use const_iterator instead - of iterator in C++11. There are times when the methods wrapped must match - the parameters exactly. Specifically when full type information for - template types is missing or SWIG fails to look up the type correctly, - for example: - - %include - typedef float Real; - %template(RealVector) std::vector; - - SWIG does not find std::vector::iterator because %template using - typedefs does not always work and so SWIG doesn't know if the type is - copyable and so uses SwigValueWrapper which does - not support conversion to another type (const_iterator). This resulted - in compilation errors when using the C++11 version of the containers. - - Closes #73 - -2013-10-17: wsfulton - [R] Fix SF #1340 - Visual Studio compile error in C++ wrappers due to #include - within extern "C" block. - -2013-10-17: wsfulton - [Python] Fix SF #1345 - Missing #include for offsetof when using -builtin. - -2013-10-12: wsfulton - [Lua] Apply #92 - missing return statements for SWIG_Lua_add_namespace_details() - and SWIG_Lua_namespace_register(). - +Version 3.0.10 (12 Jun 2016) +============================ + +2016-06-06: mromberg + [Python] Patch #698. Add support for -relativeimport for python 2.7, so -py3 is no + longer also required for relative import support. + +2016-06-05: mromberg + [Python] Patch #694 - Fix package import regressions introduced in swig-3.0.9. + + 1) The code in 3.0.9 did not fall back to 'import _foo' if 'import bar._foo' failed + (assuming bar.foo was the main module). Every place _foo is imported now first tries + it from the package where foo was found and if that fails tries _foo as a global module. + + 2) The separate block of Python code that injected code to pull in the attributes + from _foo when -builtin is used made use of the -py3 switch to either do + 'from ._foo import *' or "from _foo import *". This block of code no longer does this + and instead checks the Python version at runtime to switch between the two syntaxes. + + In summary, swig-3.0.10 has been modified to ease the creation of wrapper modules + that can be fully made part of a Python package. SWIG no longer + assumes the dynamically linked C module is a global module. + The dynamic module can now be placed into either the same package as the pure Python + module or as a global module. Both locations are used by the Python wrapper to + locate the C module. + + However, this could cause a backwards incompatibility with some code + that was relying on the ability of "from package import _module" to + pull attributes out of the package directly. If your code populates a + module (which is also a package) with attributes that are SWIG + generated modules which were not loaded in a conventional way, + swig-3.0.8 and earlier may have worked due to 'from package import + _module' bypassing a real import and pulling your module in as an + attribute. This will no longer work. Since this is not a common (or + even recommended) practice, most folk should not be affected. + + *** POTENTIAL INCOMPATIBILITY *** + +2016-05-31: wsfulton + Fix #690 - Smart pointer to %ignored class doesn't expose inherited methods. + Regression introduced in swig-3.0.9. diff --git a/COPYRIGHT b/COPYRIGHT index 3f4711a..c3fbbde 100644 --- a/COPYRIGHT +++ b/COPYRIGHT @@ -11,55 +11,62 @@ Portions also copyrighted by: Information-technology Promotion Agency, Japan Active SWIG Developers: - William Fulton (wsf@fultondesigns.co.uk) (SWIG core, Java, C#, Windows, Cygwin) - Olly Betts (olly@survex.com) (PHP) - Joseph Wang (joequant@gmail.com) (R) - Xavier Delacour (xavier.delacour@gmail.com) (Octave) - David Nadlinger (code@klickverbot.at) (D) + William Fulton (wsf@fultondesigns.co.uk) (SWIG core, Java, C#, Windows, Cygwin) + Olly Betts (olly@survex.com) (PHP) + Joseph Wang (joequant@gmail.com) (R) + Xavier Delacour (xavier.delacour@gmail.com) (Octave) + David Nadlinger (code@klickverbot.at) (D) + Oliver Buchtala (oliver.buchtala@gmail.com) (Javascript) + Neha Narang (narangneha03@gmail.com) (Javascript) + Simon Marchetto (simon.marchetto@scilab-enterprises.com) (Scilab) Past SWIG developers and major contributors include: - Dave Beazley (dave-swig@dabeaz.com) (SWIG core, Python, Tcl, Perl) - Henning Thielemann (swig@henning-thielemann.de) (Modula3) - Matthias Köppe (mkoeppe@mail.math.uni-magdeburg.de) (Guile, MzScheme) - Luigi Ballabio (luigi.ballabio@fastwebnet.it) (STL wrapping) - Mikel Bancroft (mikel@franz.com) (Allegro CL) - Surendra Singhi (efuzzyone@netscape.net) (CLISP, CFFI) - Marcelo Matus (mmatus@acms.arizona.edu) (SWIG core, Python, UTL[python,perl,tcl,ruby]) - Art Yerkes (ayerkes@speakeasy.net) (Ocaml) - Lyle Johnson (lyle@users.sourceforge.net) (Ruby) - Charlie Savage (cfis@interserv.com) (Ruby) - Thien-Thi Nguyen (ttn@glug.org) (build/test/misc) - Richard Palmer (richard@magicality.org) (PHP) - Sam Liddicott - Ananova Ltd (saml@liddicott.com) (PHP) - Tim Hockin - Sun Microsystems (thockin@sun.com) (PHP) - Kevin Ruland (PHP) - Shibukawa Yoshiki (Japanese Translation) - Jason Stewart (jason@openinformatics.com) (Perl5) - Loic Dachary (Perl5) - David Fletcher (Perl5) - Gary Holt (Perl5) - Masaki Fukushima (Ruby) - Scott Michel (scottm@cs.ucla.edu) (Java directors) - Tiger Feng (songyanf@cs.uchicago.edu) (SWIG core) - Mark Rose (mrose@stm.lbl.gov) (Directors) - Jonah Beckford (beckford@usermail.com) (CHICKEN) - Ahmon Dancy (dancy@franz.com) (Allegro CL) - Dirk Gerrits (Allegro CL) - Neil Cawse (C#) - Harco de Hilster (Java) - Alexey Dyachenko (dyachenko@fromru.com) (Tcl) - Bob Techentin (Tcl) - Martin Froehlich (Guile) - Marcio Luis Teixeira (Guile) - Duncan Temple Lang (R) - Miklos Vajna (PHP directors) - Mark Gossage (mark@gossage.cjb.net) (Lua) - Raman Gopalan (ramangopalan@gmail.com) (eLua) - Gonzalo Garramuno (ggarra@advancedsl.com.ar) (Ruby, Ruby's UTL) - John Lenz (Guile, MzScheme updates, Chicken module, runtime system) - Ian Lance Taylor (Go) - Vadim Zeitlin (PCRE) - Stefan Zager (szager@gmail.com) (Python) + Dave Beazley (dave-swig@dabeaz.com) (SWIG core, Python, Tcl, Perl) + Henning Thielemann (swig@henning-thielemann.de) (Modula3) + Matthias Köppe (mkoeppe@mail.math.uni-magdeburg.de) (Guile, MzScheme) + Luigi Ballabio (luigi.ballabio@fastwebnet.it) (STL wrapping) + Mikel Bancroft (mikel@franz.com) (Allegro CL) + Surendra Singhi (efuzzyone@netscape.net) (CLISP, CFFI) + Marcelo Matus (mmatus@acms.arizona.edu) (SWIG core, Python, UTL[python,perl,tcl,ruby]) + Art Yerkes (ayerkes@speakeasy.net) (Ocaml) + Lyle Johnson (lyle@users.sourceforge.net) (Ruby) + Charlie Savage (cfis@interserv.com) (Ruby) + Thien-Thi Nguyen (ttn@glug.org) (build/test/misc) + Richard Palmer (richard@magicality.org) (PHP) + Sam Liddicott - Ananova Ltd (saml@liddicott.com) (PHP) + Tim Hockin - Sun Microsystems (thockin@sun.com) (PHP) + Kevin Ruland (PHP) + Shibukawa Yoshiki (Japanese Translation) + Jason Stewart (jason@openinformatics.com) (Perl5) + Loic Dachary (Perl5) + David Fletcher (Perl5) + Gary Holt (Perl5) + Masaki Fukushima (Ruby) + Scott Michel (scottm@cs.ucla.edu) (Java directors) + Tiger Feng (songyanf@cs.uchicago.edu) (SWIG core) + Mark Rose (mrose@stm.lbl.gov) (Directors) + Jonah Beckford (beckford@usermail.com) (CHICKEN) + Ahmon Dancy (dancy@franz.com) (Allegro CL) + Dirk Gerrits (Allegro CL) + Neil Cawse (C#) + Harco de Hilster (Java) + Alexey Dyachenko (dyachenko@fromru.com) (Tcl) + Bob Techentin (Tcl) + Martin Froehlich (Guile) + Marcio Luis Teixeira (Guile) + Duncan Temple Lang (R) + Miklos Vajna (PHP directors) + Mark Gossage (mark@gossage.cjb.net) (Lua) + Raman Gopalan (ramangopalan@gmail.com) (eLua) + Gonzalo Garramuno (ggarra@advancedsl.com.ar) (Ruby, Ruby's UTL) + John Lenz (Guile, MzScheme updates, Chicken module, runtime system) + Baozeng Ding (Scilab) + Ian Lance Taylor (Go) + Vadim Zeitlin (PCRE, Python) + Stefan Zager (szager@gmail.com) (Python) + Vincent Couvert (Scilab) + Sylvestre Ledru (Scilab) + Wolfgang Frisch (Scilab) Past contributors include: James Michael DuPont, Clark McGrew, Dustin Mitchell, Ian Cooke, Catalin Dumitrescu, Baran diff --git a/Doc/Devel/cpp11.html b/Doc/Devel/cpp11.html new file mode 100644 index 0000000..fc35465 --- /dev/null +++ b/Doc/Devel/cpp11.html @@ -0,0 +1,788 @@ + + + + + + + + + + + + + + + +

C++0x/C++11 support for SWIG

+

Summary

+

This is a technical overview of the C++0x/C++11 support for the Swig. +This area of Swig is a work in progress. Initial C++0x/C++11 support for +Swig was written during the Google Summer of Code 2009 period by +Matevž Jekovec.

+

SVN branch

+

branches/gsoc2009-matevz

+

New C++11 features status

+

Wikipedia article: http://en.wikipedia.org/wiki/C%2B%2B0x +

+

Rvalue reference and move semantics [done]

+

The Rvalues are used in practice to speed up the move operations +on different containers.

+

In the following example, we want to swap the given elements:

+
template <class T> swap(T& a, T& b) {
+    T tmp(a);   // now we have two copies of a
+    a = b;      // now we have two copies of b
+    b = tmp;    // now we have two copies of tmp (aka a)
+}

+This can now be solved using the new function std::move():

+
template <class T> swap(T& a, T& b) {
+    T tmp(std::move(a));
+    a = std::move(b);   
+    b = std::move(tmp);
+}

+For the move function to take effect, user needs to reimplement the +move constructor (taking ClassType&& as an argument) and +operator=(ClassType&&):

+
class MyClass {
+  MyClass(MyClass&& p) : ptr(p.ptr) {p.ptr = 0;}
+  MyClass& operator=(MyClass&& p) {
+    std::swap(ptr, p.ptr);
+    return *this;
+  }
+};

+In practice, the Rvalues are used for temporaries (when passing the +result of one function as an argument to another).

+

Done: Added type&& to Swig parser. Added testcase +cpp11_rvalue_reference.i. Operator && is treated the same as +operator &. R11450

+

Article: +http://www.artima.com/cppsource/rvalue.html

+

Generalized constant expressions [done]

+

In C++11 you can define functions as constant expressions. +Functions need to return constant value in form "return expr", +where expr is a constant expression. +

+

A keyword "constexpr" is introduced for this. eg.: +constexpr int getNumber() { return 5; } const int MY_CONSTANT = +getNumber(); +

+

Constants are treated as normal variables in interpreted languages +because they are not compiled into the executable. Java "final" +constants are defined runtime as well. C++ constants need to be +declared in the header file and defined in the implementation file, +so swig doesn't need to know about the constant values when parsing +the header file. +

+

Done: Added the “constexpr “ keyword to Swig. Added testcase +cpp11_constexpr. R11322

+

Problem: No compilers were known to support constexpr yet, so the +testcase was temporarily commented out in common.mk. +

+

Extern template [done]

+

Extern template forces the GCC compiler to not instantiate the +template in the translation unit at that time. It's a feature +specifically aimed at compilers to speed up the compilation process. +

+

Done: Added support for 'extern template class +std::vector<MyClass>;'. Added testcase cpp11_template_explicit. +R11385 , R11386

+

Initializer lists [done]

+

Initializer list is a new type in standard library: +std::initializer_list<T>. New symbols {} are introduced for the +initializer lists. +

+

One can now use: +

+
 class A {
+ public:
+   A( std::initializer_list<int> );
+ };
+ A a1 = {1,2,3,4};

+Languages like Java, C# and Python already support direct creation of +lists natively.

+

Problem: initializer_list cannot be treated as an ordinary list. +The constructor containing initializer_list can only be accessed by +assigning the value using the {} brackets. I also don't think there +is a simple way to convert an ordinary list or a vector to the +initializer_list.

+

Done: Ignored the constructor having initializer_list as its +argument. Show warning to the user. Added testcase +cpp11_initializer_list. R11450

+

Article: +http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2005/n1919.pdf

+

Uniform initialization [done]

+

The new C++11 standard will allow the following:

+
struct IdString {
+  std::string name;
+  int identifier;
+};
+ 
+IdString GetString() {
+  return {"SomeName", 4}; //Note the lack of explicit type.
+}

+The feature works exactly as it did now for POD types only (eg. int +a[] = {1,2,3};). The following declarations are the same in the new +C++11:

+
IdString str1 = {„SomeName“, 4};
+IdString str2{„SomeName“, 4};

+The new way of using uniform initialization allows the following:

+
struct BasicStruct {
+ int x;
+ double y;
+};
+ 
+struct AltStruct {
+  AltStruct(int x, double y) : x_{x}, y_{y} {}
+ 
+private:
+  int x_;
+  double y_;
+};
+ 
+BasicStruct var1{5, 3.2}; // only fills the struct components
+AltStruct var2{2, 4.3};   // calls the constructor

+The new syntax is specific to C++. Java, C# and scripting languages +do not support this behaviour, but always need constructors. They +support {} brackets for declaration of arrays as C does + they add +support for creation of arrays on-the-fly (what C++11 introduced with +this feature and more).

+

Done: Added syntax for {} member initialization in class +constructor. Added testcase cpp11_uniform_initialization. R11413

+

Type inference [partially done]

+

A new keyword 'auto' is introduced in C++11:

+
auto a1 = 100;
+auto a2 = myFunc();

+The type of a1 and a2 is automatically determined according to the +initialization value during the semantic phase of the compiler.

+

Another macro 'decltype()' is introduced. The macro takes the +concrete object as an argument and returns its type. User could use +this as:

+
int i = 100;
+decltype(i) j = 200; // decltype(i) = int

+Calling operators are allowed as well:

+
decltype(i+j) k = 300;

+Done: Added support for decltype() syntax. Test cases for normal +decltype members and alternate function members work fine. Currently +only syntax in form decltype(variable name) work. No support for +custom expresions eg. decltype(i+j) yet. R11525

+

TODO: William proposed to support the hidden variables as well +(ones not parsed by Swig and added to symbol table). This also allows +Swig to parse custom expressions like decltype(i+j). The idea is to +introduce a new SwigType for this.

+

Range-based for-loop [ignored]

+

This feature is always present inside the implementation block +only. +

+

Lambda functions and expressions [done]

+

C++11 introduces lambda functions defined as:

+
[](int x, int y) -> int { return x + y; }

+If the lambda function contains a single return statement only or the +function doesn't return any type, the return type '->' can be +omitted. Lambda functions are function objects.

+

The following example prints the number of items stored in a list:

+
std::vector<int> someList;
+int total = 0;
+std::for_each( someList.begin(), someList.end(), [&total](int x) {total += x} );
+std::cout << total;

+Parameters inside the [] are the visible parameters of the lambda +functions. These can be & (references), = (copies), variable name +(variable copy), &variable name (variable reference) or this +(copy of the current object).

+

Lambda functions can be stored using:

+
auto myLambdaFunc = [this]() { this->SomePrivateMemberFunction() };

+Proposal: Lambda functions are most commonly used inside the function +block to quickly define how the sort, find and similar functions +should work (the other way would be overriding a class – the Java +style). The latest GCC does not support lambda functions yet so it is +difficult to test the feature once implemented. I would implement the +syntax support for this feature, but produce no wrapper code. Lambda +functions still work inside the function block though.

+

Article: +http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2550.pdf

+

Done: Added syntax support for the lambda functions. Added +testcase cpp11_lambda_functions.i. R11491, R11492

+

Alternate function syntax [done]

+

The problem with decltype() is that the parameters need to be +defined before the decltype. The following syntax is not valid, +because lhs and rhs hasn't been defined at the time of decltype:

+
template< typename LHS, typename RHS> 
+  decltype(lhs+rhs) AddingFunc(const LHS &lhs, const RHS &rhs) {return lhs + rhs;} //Not legal C++11

+The solution C++11 offers is the combination of the 'auto' keyword +before and '-> rettype' after the function declaration:

+
template< typename LHS, typename RHS> 
+  auto AddingFunc(const LHS &lhs, const RHS &rhs) -> decltype(lhs+rhs) {return lhs + rhs;}

+The new syntax only makes the job for the C++ compilers easier when +parsing such functions. The new syntax can be used for ordinary +functions as well:

+
struct SomeStruct {
+  auto FuncName(int x, int y) -> int;
+};
+ 
+auto SomeStruct::FuncName(int x, int y) -> int {
+  return x + y;
+}

+Done: Added support for the 'auto' return type. Added support for the +'-> type' after the funtion declaration. Added testcases +cpp11_alternate_function_syntax.i and +cpp11_alternate_function_syntax_runme.py. R11414

+

Concepts, Axioms [ignored]

+

In C++ there is a common problem when you use a template in the +class which doesn't support all the operations the functions in the +class actually do on the type. Compiler errors are usually very long +and unreadable. C++11 adds support for the "concepts". The +idea is to define what operations and attributes should the template +have. In contrast to class inheritance and polimorphism, all lookups +are done in compile-time. +

+

Basic syntax (note LessThanComparable? +instead of "class" or "typename"): +

+
 template<LessThanComparable? T>
+ const T& min(const T &x, const T &y) {
+   return y < x ? y : x;
+ }

+Extended syntax (requires conditions are separated with &&, +|| or !): +

+
 template< typename T> requires LessThanComparable?<T>
+ const T& min(const T &x, const T &y) {
+   return y < x ? y : x;
+ }

+Definition of the concepts: +

+
 concept LessThanComparable?< typename T > {
+   bool operator<(T,T);
+   requires GreaterThanComparable?<T>;
+   typename value_type;
+   typename reference;
+ };

+Concept maps allow usage of a specific type: +

+
 template< typename T>
+ concept_map InputIterator?<T*> {
+   typedef T value_type ;
+   typedef T& reference ;
+   typedef T* pointer ;
+   typedef std::ptrdiff_t difference_type ;
+ };

+Concept maps can act as mini-types, with function definitions and +other constructs commonly associated with classes: +

+
 concept Stack< typename X> {
+   typename value_type;
+   void push(X&, const value_type&);
+   void pop(X&);
+   value_type top(const X&);
+   bool empty(const X&);
+ };
+ template< typename T>
+ concept_map Stack<std::vector<T> > {
+   typedef T value_type;
+   void push(std::vector<T>& v, const T& x) { v.push_back(x); }
+   void pop(std::vector<T>& v) { v.pop_back(); }
+   T top(const std::vector<T>& v) { return v.back(); }
+   bool empty(const std::vector<T>& v) { return v.empty(); }
+ };

+Axioms are a facility pertaining to concepts supplied by C++11 to +express the semantic properties of concepts. For example, the concept +Semigroup can be defined with an axiom Associativity as: +

+
 concept Semigroup< typename Op, typename T> : CopyConstructible?<T> {
+   T operator()(Op, T, T);
+   axiom Associativity(Op op, T x, T y, T z) {
+     op(x, op(y, z)) == op(op(x, y), z);
+   }
+ };

+Axioms are more like hints to the compiler to speed-up the process of +compilation. +

+

Ignored: Concepts and axioms were removed from the C++11 standard. +

+

Object construction improvement [done]

+

This feature allows classes constructors to call other +constructors with different arguments (similar to Java and C# +behaviour). +

+

The syntax is as follows: +

+
 class SomeType {
+  int number;
+ public:
+   SomeType(int newNumber) : number(newNumber) {}
+   SomeType() : SomeType(42) {}
+ };

+Also when using the inheritance, the feature introduces inheritance +of all superclass constructors without being defined separately in +the inherited class: +

+
 class BaseClass {
+ public:
+   BaseClass(int iValue);
+ };
+ class DerivedClass: public BaseClass {
+   public:
+   using BaseClass::BaseClass; // Adds DerivedClass(int) constructor
+ };

+Swig already correctly parses and produces the correct wrapper for +the “using” keyword.

+

Done: Added testcase cpp11_constructors.i which covers both +constructor delegation and constructor inheritance. R11532

+

Problem: Constructor delegation and constructor inheritance is not +supported by any compiler yet, so it's impossible to try and test +this feature.

+

Null pointer constant [done]

+

nullptr is part of the standard library. +

+

It's defined as typedef decltype(nullptr) nullptr_t; +

+

nullptr_t is defined in <cstddef>. +

+

As far as the C++ is compatible with 0 as the pointer value, swig +values will work for the C++. And the other way around, nullptr +behaves as the ordinary pointer (false, if empty, true, if not +empty), so it's ok for swig to compare it.

+

Done: Written a testcase cpp11_null_pointer_constant.i and +cpp11_null_pointer_constant_runme.py to prove the nullptr +functionality. R11484

+

Strongly typed enumerations [partially done]

+

C++11 introduces a new syntax for strongly typed enum declaration: +

+
 enum class Enumeration {
+  Val1,
+  Val2,
+  Val3 = 100,
+  Val4 /* = 101 */
+ };

+Typing if (Val4 == 101) will result in compilation error. +

+

The enum itself can now be explicitely of type int, long, unsigned +int etc.: +

+
 enum class Enum2 : unsigned int {Val1, Val2};

+And it can be forward declared as well: +

+
 enum Enum1;                   //Illegal in C++ and C++11; no size is explicitly specified.
+ enum Enum2 : unsigned int;    //Legal in C++11.
+ enum class Enum3;             //Legal in C++11, because enum class declarations have a default type of "int".
+ enum class Enum4: unsigned int; //Legal C++11.
+ enum Enum2 : unsigned short;  //Illegal in C++11, because Enum2 was previously declared with a different type.

+Done: Added syntax 'enum class Name' and forward declarators 'enum +Name : inherited type' or 'enum class Name : inherited type' in +R11449.

+

TODO: Add semantic support for enum elements not clashing with +enum elements in other enum classes. See cpp11_strongly_typed_enums.i +warnings.

+

Problem: Swig currently doesn't support nested classes. This +feature should be implemented using a new nested class when using +“enum class” with a single anonymous “enum {elements}” +element inside. For example:

+
class A { enum class EA { a,b,c,d }; };

+should be mapped to

+
class A { class EA { enum {a,b,c,d}; }; };

+Angle bracket [done]

+

Support for right angled brackets was implemented using the +following article as a base: +http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2005/n1757.html +

+

Done: Added support for angle brackets. Used the preferred +"Approach 1". Added a testcase named +cpp11_template_double_brackets. R11245

+

Explicit conversion operators [done]

+

This is used when converting one type to another (eg. if +(myObject) {}, where myObject is your custom class converted to +bool). +

+

Requires both operator and function overloading which is not +supported in any target language (eg. python, php). +

+

Done: Swig already supports the keyword "explicit" for +function types as well. Added test case +cpp11_explicit_conversion_operators. R11323

+

Template typedefs [partially done]

+

The new C++11 will allow creation of wrapper around the template. +For example, if we want to do this:

+
template< typename first, typename second, int third>
+class SomeType;
+ 
+template< typename second>
+typedef SomeType<OtherType, second, 5> TypedefName; //Illegal in C++

+This is still illegal! But we can now use the new syntax for +achieving the same effect:

+
template< typename first, typename second, int third>
+class SomeType;
+
+template< typename second>
+using TypedefName = SomeType<OtherType, second, 5>;

+Here we created a new wrapper TypedefName taking one template +argument <second> which creates a type SomeType<OtherType, +second, 5>. OtherType and 5 are predefined here and hidden from +the user – the user only uses TypedefName type.

+

The same goes for the following example:

+
typedef void (*PFD)(double);            // Old style
+using PF = void (*)(double);            // New introduced syntax

+Swig supports parsing typedefs for templates as well for example:

+
typedef List<int> intList;

+Done: Expanded support for the new 'using' syntax and template +aliasing. Added testcase cpp11_template_typedefs. R11533

+

TODO: Make Swig aware of the newly defined typedef. The TYPEDEF +keyword is part of the storage_class rule and type+declarator (see +c_decl rule) is the right part of the definition – for example void +(*PFD)(double) cannot be transformed to void *(double) easily. To +fully support the new 'using' form, we'll probably have to change the +type, type_right rules and declarator, direct_declarator, +notso_direct_declarator etc., which is PITA.

+

Unrestricted unions [done]

+

C++ currently offers usage of unions for types with trivial +constructors only. The new C++11 standard allows usage of types with +non-trivial constructors as well:

+
 struct point {
+  point() {}
+  point(int x, int y): x_(x), y_(y) {}
+  int x_, y_;
+ };
+ union P {
+  int z;
+  double w;
+  point p;  // Illegal in C++; point has a non-trivial constructor.  However, this is legal in C++11.
+ } p1;

+Swig already parses the given syntax.

+

Done: Added testcase cpp11_unrestricted_unions. R11435, R11447

+

Problem: GCC doesn't support unrestricted unions yet so there is +no way to actually test, if it works.

+

Variadic templates [partially done]

+

The new C++11 offers the following syntax:

+
template<typename... Values> class tuple;

+This can be used for example:

+
class tuple<int, std::vector<int>, std::map<std::string, std::vector<int>>> someInstanceName;

+The ... is used in two cases. One is in the template header where it +marks on the left the keywords 'typename' or 'class' and a type name +on the right. The second case is usually in the function block to +decompose typename on the left of the ... . For example:

+
void printf(const char *s) {
+  while (*s) {
+    if (*s == '%' && *(++s) != '%')
+      throw std::runtime_error("invalid format string: missing arguments");
+    std::cout << *s++;
+  }
+}
+ 
+template<typename T, typename... Args>
+void printf(const char* s, T value, Args... args) { // recursive action – split previous args to value + args
+  while (*s) {
+    if (*s == '%' && *(++s) != '%') {
+      std::cout << value;
+      printf(*s ? ++s : s, args...); // call even when *s == 0 to detect extra arguments
+      return;
+    }
+    std::cout << *s++;
+  }
+  throw std::logic_error("extra arguments provided to printf");
+}

+The tricky part is that variadic templates can unpack actually +anywhere – including the class inheritance :(

+
template <typename... BaseClasses> class ClassName : public BaseClasses... {
+public:
+ 
+   ClassName (BaseClasses&&... baseClasses) : BaseClasses(baseClasses)... {}
+}

+A new extension to sizeof is also introduced with this feature. The +... after sizeof returns number of arguments:

+
template<typename ...Args> struct SomeStruct {
+  static const int size = sizeof...(Args);
+}
+// SomeStruct<Type1, Type2>::size is 2 and SomeStruct<>::size is 0

+Done: Added syntax support for 'typename' or 'class' + ... + id. +Added testcase cpp11_variadic_templates. R11458

+

Done: Added syntax support for BaseClass + ..., type + ... + id in +parameters and baseclass + ... for intializers after constructor. +Extended Swig syntax to support sizeof...(Args). R11467

+

Done: Fixed %template to support variadic number of templates.

+

TODO: Only (if present) first variadically defined argument is +currently used in %template directive. The next ones are ignored.

+

New string literals [partially done]

+

Beside the implementation, the new C++11 Unicode and custom +delimeter constants can occur in templates in the header file. +

+

Done: Added symbols 'u', 'u8' and 'U' to mark the beginning of the +UTF string. Also added test case cpp11_raw_string_literals. R11327

+

Done: Added R"DELIMITER[, ]DELIMITER" for a custom +delimiter for the beginning/end of the string. R11328

+

TODO: Fix the Swig's C++ preprocessor bug when parsing an odd +number of “ inside the string brackets. See +Source/Preprocessor/cpp.c.

+

User-defined literals [partially done]

+

C++ has different suffix literals. eg. 12.5f marks the number 12.5 +as float. +

+

C++11 allows user to define his own suffix for the strings always +starting with the underscore (_). eg. int a = "hello"_mySuffix; +

+

The syntax is similar to other operator overloading functions: +

+
 OutputType operator "" _mySuffix(const char * string_values);

+The null terminated const char* is the string between the "". +The _mySuffix is the name of the suffix operator. And the OutputType +is the outputType the operator returns. +

+

Other forms are: +

+
 OutputType operator "" _mySuffix(const char * string_values, size_t num_chars);
+ OutputType operator "" _mySuffix(const wchar_t * string_values, size_t num_chars);
+ OutputType operator "" _mySuffix(const char16_t * string_values, size_t num_chars);
+ OutputType operator "" _mySuffix(const char32_t * string_values, size_t num_chars);
+ OutputType operator "" _mySuffix(int value); /* cooked version - ie. atoi() of string */

+Another possibility is to use variadic templates: +

+
 template<char...> OutputType operator "" _mySuffix();
+ OutputType someVariable = "1234"_mySuffix;

+This instantiates the literal processing function as +operator""_Suffix<'1', '2', '3', '4'>. In this form, +there is no terminating null character to the string. The main +purpose to doing this is to use C++11's constexpr keyword and the +compiler to allow the literal to be transformed entirely at compile +time, assuming OutputType is a constexpr-constructable and copyable +type, and the literal processing function is a constexpr function.

+

Article: +http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2765.pdf

+

Done: Added syntax support for userdefined literals. Added +testcase cpp11_userdefined_literals.i. R11494

+

TODO: %rename doesn't parse operator”” yet.

+

Thread-local storage [done] +

+

New C++11 introduces keyword "thread_local" which marks +the following variable dynamically located depending on the current +thread when using the address-of (&) operator. +

+

Syntax: +

+
 struct A {
+   thread_local int val;
+ };

+Done: Add "thread_local" keyword to Swig. Added testcase +cpp11_thread_local. R11393

+

Defaulting/deleting of standard functions on C++ objects [done]

+

C++ automatically creates default constructor with empty +parameters, copy constructor, operator= and destructor for any class. +Sometimes user wants to explicitly remove one of them or enable them +(eg. default constructor with empty parameters doesn't work any more, +if any other constructor is defined). +

+

Words "default" and "delete" are introduced. +The syntax is similar to declaration of pure virtual function: +

+
 struct NonCopyable {
+   NonCopyable & operator=(const NonCopyable&) = delete; /* Removes operator= */
+   NonCopyable(const NonCopyable&) = delete; /* Removed copy constructor */
+   NonCopyable() = default; /* Explicitly allows the empty constructor */
+   void *operator new(std::size_t) = delete; /* Removes new NonCopyable */
+ };

+User has the ability by using keyword delete to disallow calling of +the standard functions brought by C++ itself. +

+
 struct A1 {
+   void f(int i);
+   void f(double i) = delete;  /* Don't cast double to int. Compiler returns an error */
+ };
+ struct A2 {
+   void f(int i);
+   template<class T> void f(T) = delete; /* Only accept int */
+ };

+Ignored: Swig already parses the keywords "= delete" and "= +default". These keywords are used for built-in functions (copy +constructor, operator= etc.), which are ignored by Swig anyway.

+

Done: Added testcase cpp11_default_delete. R11535

+

Type long long int [done]

+

Type long long int is an integer type that has at least 64 useful +bits. C99 added it to its standard, but the C++ didn't adopt it until +C++11. Most C++ compilers supported it though. +

+

Done: Swig already parses the C code including the long long type. +

+

Static assertions [done]

+

static_assert() can be used at class scope as well eg.: +

+
 template <typename T>
+ struct Check {
+  static_assert(sizeof(int) <= sizeof(T), "not big enough");
+ };

+Done: Added syntax support for "static_assert()". Added +test case cpp11_static_assert. R11369

+

Allow sizeof to work on members of classes without an explicit +object [done]

+

C++11 allows calls of sizeof to concrete objects as well: +

+
 struct A { int member; };
+ sizeof(A::member); //Does not work with C++03. Okay with C++11

+This kind of syntax is already supported by Swig.

+

Done: Added testcase cpp11_sizeof_objects. R11538 +

+

Threading facilities [ignored]

+

C++11 will add the following classes to the standard library: +

+
 * std::thread
+ * std::mutex, std::recursive_mutex
+ * std::condition_variable, std::condition_variable_any
+ * std::lock_guard, std::unique_lock
+ * std::packaged_task

+Ignored: No changes to the language itself is made. +

+

Tuple types [TODO]

+

Tuple is array of various types. C++11 introduced this feature +using variadic templates. Tuple is defined as:

+
template <class ...Types> class tuple;

+Constructor is automatically generated filling the tuple elements. +get<X> function is introduced to get the Xth element in the +tuple.

+
typedef tuple< int, double, long &, const char * > test_tuple ;
+long lengthy = 12 ;
+test_tuple proof( 18, 6.5, lengthy, "Ciao!" ) ;
+lengthy = get<0>(proof) ;  // Assign to 'lengthy' the value 18.
+get<3>(proof) = " Beautiful!" ;  // Modify the tuple’s fourth element.

+Tuples can be copied to each other, if all the elements are copiable:

+
typedef tuple< int , double, string       > tuple_1 t1 ;
+typedef tuple< char, short , const char * > tuple_2 t2( 'X', 2, "Hola!" ) ;
+t1 = t2 ;  // Ok, first two elements can be converted,
+           // the third one can be constructed from a 'const char *'.

+TODO: Implement wrappers for the tuplet<> class.

+

Hash tables [TODO]

+

C++11 introduces the "unordered" version of existing +types, which in practice work faster than the linear types: +

+
 - unordered set
+ - unordered multiset
+ - unordered map
+ - unordered multimap

+Swig should use the "unordered" types exactly the same as +the original linear types.

+

Problem: Unordered types do not contain exactly same members as +ordered ones (eg. _Hashtable_iterator does not offer operator--() and +constructor with compare function which is required). So simply +aliasing unordered classes to ordered ones doesn't work.

+

TODO: Implement wrappers for unordered_ types. Initial work is +already done in Lib/std/unordered_*.i files.

+

Regular expressions [ignored]

+

Two new classes are introduced in C++11: basic_regex and +match_results. Both are defined in regex header file. +

+

Ignored: The new feature extends the standardy library only. No +changes to Swig needed. +

+

General-purpose smart pointers [done]

+

This feature deprecates auto_ptr and adds shared_ptr, weak_ptr and +unique_ptr to the standard library. +

+

This feature only adds the smart pointers to the standard library +and doesn't effect the C++ syntax.

+

Done: Added test case which uses all three smart pointers in the +class. R11394

+

Problem: GCC standard library doesn't contain the new smart +pointers yet. +

+

Extensible random number facility [ignored]

+

This feature standardize the pseudo random number algorithm +(currently, the random number generator was dependent on the +platform/compiler). It adds functions linear_congruential, +subtract_with_carry and mersenne_twister and symbols +uniform_int_distribution, bernoulli_distribution, +geometric_distribution, poisson_distribution, binomial_distribution, +uniform_real_distribution, exponential_distribution, +normal_distribution and gamma_distribution to the standard library. +

+

Ignored: The new feature extends the standardy library only. No +changes to Swig needed. +

+

Wrapper reference [ignored]

+

This feature adds ref and cref classes to the standard library +(#include <utility>) usually used in tempalte functions. +

+

Ignored: The new feature extends the standardy library only. No +changes to Swig needed. +

+

Polymorphous wrappers for function objects [done]

+

Two features are introduced: +

+
    +
  • The function template wrapper: +

    +
+
 function<int ( int, int )> pF;
+
    +
  • and the function object: +

    +
+
 struct Test {
+   bool operator()( short x, short y );
+ };

+Swig already supports the two.

+

Done: Added a runtime testcase for function objects +cpp11_function_objects. R11419.

+

Type traits for metaprogramming [ignored]

+

C++11 adds a new header file <type_traits> which includes +helper functions to determine the template type while initializing +the object at compile time. +

+

Swig already supports the following code: +

+
 template< int B, int N >
+ struct Pow {
+  // recursive call and recombination.
+  enum{ value = B*Pow< B, N-1 >::value };
+ };
+ template< int B > struct Pow< B, 0 >  // N == 0 condition of termination.
+ {
+  enum{ value = 1 };
+ };
+ int quartic_of_three = Pow< 3, 4 >::value ;

+Functions is_convertible, is_integral, is_integral_const etc. are +part of the new header: +

+
// First way of operating.
+template< bool B > struct algorithm {
+  template< class T1, class T2 > int do_it( T1 &, T2 & )  { /*...*/ }
+};
+// Second way of operating.
+template<> struct algorithm<true> {
+  template< class T1, class T2 > int do_it( T1, T2 )  { /*...*/ }
+};
+// Instantiating 'elaborate' will automatically instantiate the correct way to operate.
+template< class T1, class T2 > int elaborate( T1 A, T2 B ) {
+  // Use the second way only if 'T1' is an integer and if 'T2' is
+  // in floating point, otherwise use the first way.
+  return algorithm< is_integral<T1>::value && is_floating_point<T2>::value >::do_it( A, B );
+}

+Swig correctly parses the syntax for template<bool>, +template<class T> and template<>. +

+

Ignored: Swig requires explicitly defined template class +(%template directive) to export it to the target language.

+

Uniform method for computing return type of function objects +[partially done]

+

The template function is introduced: std::result_of() which +depends on decltype: +

+
template< class Obj >
+class calculus_ver2 {
+ public:
+   template< class Arg >
+   typename std::result_of<Obj(Arg)>::type operator()( Arg& a ) const { 
+     return member(a);
+   }
+ private:
+   Obj member;
+};

+Swig correctly parses the result_of class.

+

TODO: The return type (the result_of::type member) is not +calculated by Swig. This needs a much more complex semantic parser.

+

Done: Added testcase cpp11_result_of. R11534

+ + diff --git a/Doc/Devel/internals.html b/Doc/Devel/internals.html index 94a8251..c9082d3 100644 --- a/Doc/Devel/internals.html +++ b/Doc/Devel/internals.html @@ -347,7 +347,7 @@ Delete(a); /* Destroy a */ All objects are referenced counted and given a reference count of 1 when initially created. The Delete() function only destroys an object when the reference count reaches zero. When -an object is placed in a list or hash table, it's reference count is automatically increased. For example: +an object is placed in a list or hash table, its reference count is automatically increased. For example:
@@ -844,7 +844,7 @@ Returns a type object corresponding to the type string produced by the Swig_cloc
 
  • char *Swig_clocal_deref(DataType *t, char *name)
    This function is the inverse of the clocal() function. Given a type and a name, it produces a string containing the code needed to cast/convert the type produced by -Swig_clocal() back into it's original type. +Swig_clocal() back into its original type.

  • char *Swig_clocal_assign(DataType *t, char *name)
    diff --git a/Doc/Devel/tree.html b/Doc/Devel/tree.html index db3c6fe..73a49ed 100644 --- a/Doc/Devel/tree.html +++ b/Doc/Devel/tree.html @@ -185,7 +185,7 @@ this function merely records that those attributes did not exist in the original
    This function is similar to Swig_save() except that adds additional attribute checking. There are different interpretations of the attribute names. A name of "attr" merely requests that the function check for the presence of an attribute. If the attribute is missing, SWIG will exit with a failed assertion. An attribute name of "?attr" specifies that the attribute "attr" is optional and -that it's old value must be saved (if any). An attribute name of "*attr" specifies that the attribute is required and that +that its old value must be saved (if any). An attribute name of "*attr" specifies that the attribute is required and that its value must be saved. The saving of attributes is performed in the same manner as with Swig_save(). Here is an example:
    diff --git a/Doc/Manual/Allegrocl.html b/Doc/Manual/Allegrocl.html
    index 12b915e..4b6bad4 100644
    --- a/Doc/Manual/Allegrocl.html
    +++ b/Doc/Manual/Allegrocl.html
    @@ -1,14 +1,14 @@
    -
    -
    +
     
     
     SWIG and Allegro Common Lisp
     
    +
     
     
     
     
    -

    17 SWIG and Allegro Common Lisp

    +

    18 SWIG and Allegro Common Lisp

      @@ -135,10 +135,10 @@ be unhappy to see some enterprising folk use this work to add to it.

      -

      17.1 Basics

      +

      18.1 Basics

      -

      17.1.1 Running SWIG

      +

      18.1.1 Running SWIG

      @@ -360,7 +360,7 @@ need to link in the Allegro shared library. The library you create from the C++ wrapper will be what you then load into Allegro CL.

      -

      17.1.2 Command Line Options

      +

      18.1.2 Command Line Options

      @@ -373,21 +373,21 @@ swig -allegrocl [ options ] filename -identifier-converter [name] - Binds the variable swig:*swig-identifier-convert* in the generated .cl file to name. - This function is used to generate symbols - for the lisp side of the interface. + This function is used to generate symbols + for the lisp side of the interface. -cwrap - [default] Generate a .cxx file containing C wrapper function when wrapping C code. The interface generated is similar to what is - done for C++ code. + done for C++ code. -nocwrap - Explicitly turn off generation of .cxx wrappers for C code. Reasonable for modules with simple interfaces. Can not handle all legal enum - and constant constructs, or take advantage of SWIG customization features. + and constant constructs, or take advantage of SWIG customization features. -isolate - With this command-line argument, all lisp helper functions are defined in a unique package named swig.<module-name> rather than - swig. This prevents conflicts when the module is - intended to be used with other swig generated interfaces that may, - for instance, make use of different identifier converters. + swig. This prevents conflicts when the module is + intended to be used with other swig generated interfaces that may, + for instance, make use of different identifier converters.

    @@ -396,7 +396,7 @@ See Section 17.5 Identifier converter functions for more details.

    -

    17.1.3 Inserting user code into generated files

    +

    18.1.3 Inserting user code into generated files

    @@ -436,7 +436,7 @@ Note that the block %{ ... %} is effectively a shortcut for

    -

    17.2 Wrapping Overview

    +

    18.2 Wrapping Overview

    @@ -446,7 +446,7 @@ New users to SWIG are encouraged to read interested in generating an interface to C++.

    -

    17.2.1 Function Wrapping

    +

    18.2.1 Function Wrapping

    @@ -472,7 +472,7 @@ interested in generating an interface to C++. | Foreign Code | What we're generating an interface to. |______________| | - | + | _______v______ | | (foreign side) | Wrapper code | extern "C" wrappers calling C++ @@ -484,22 +484,22 @@ interested in generating an interface to C++. | FFI Layer | Low level lisp interface. ff:def-foreign-call, |______________| ff:def-foreign-variable | - +---------------------------- + +---------------------------- _______v______ _______v______ | | | | (lisp side) | Defuns | | Defmethods | wrapper for overloaded |______________| |______________| functions or those with (lisp side) | defaulted arguments - Wrapper for non-overloaded | - functions and methods _______v______ - | | (lisp side) - | Defuns | dispatch function - |______________| to overloads based - on arity + Wrapper for non-overloaded | + functions and methods _______v______ + | | (lisp side) + | Defuns | dispatch function + |______________| to overloads based + on arity

  • -

    17.2.2 Foreign Wrappers

    +

    18.2.2 Foreign Wrappers

    @@ -512,7 +512,7 @@ interested in generating an interface to C++. typemap.

    -

    17.2.3 FFI Wrappers

    +

    18.2.3 FFI Wrappers

    @@ -593,7 +593,7 @@ char *xxx(); ff:def-foreign-call's.

    -

    17.2.4 Non-overloaded Defuns

    +

    18.2.4 Non-overloaded Defuns

    @@ -606,7 +606,7 @@ char *xxx(); this function can be manipulated via the lout typemap.

    -

    17.2.5 Overloaded Defuns

    +

    18.2.5 Overloaded Defuns

    @@ -622,7 +622,7 @@ char *xxx(); can be manipulated via the lout typemap.

    -

    17.2.6 What about constant and variable access?

    +

    18.2.6 What about constant and variable access?

    @@ -635,7 +635,7 @@ char *xxx(); into the foreign module.

    -

    17.2.7 Object Wrapping

    +

    18.2.7 Object Wrapping

    @@ -657,7 +657,7 @@ char *xxx(); foreign function interface.

    -

    17.3 Wrapping Details

    +

    18.3 Wrapping Details

    @@ -665,7 +665,7 @@ char *xxx(); translated into lisp.

    -

    17.3.1 Namespaces

    +

    18.3.1 Namespaces

    @@ -742,13 +742,13 @@ namespace car { function such as (car '(1 2 3).

    -

    17.3.2 Constants

    +

    18.3.2 Constants

    Constants, as declared by the preprocessor #define macro or SWIG - %constant directive, are included in SWIGs parse tree + %constant directive, are included in SWIG's parse tree when it can be determined that they are, or could be reduced to, a literal value. Such values are translated into defconstant forms in the generated lisp wrapper when the -nocwrap command-line @@ -799,11 +799,11 @@ namespace car {

    - Users are cautioned to get to know their constants before use, or - not use the -nocwrap command-line option. + Users are cautioned to get to know their constants before use, or + not use the -nocwrap command-line option.

    -

    17.3.3 Variables

    +

    18.3.3 Variables

    @@ -881,13 +881,13 @@ globalvar> (globalvar.nnn::glob_float) -

    17.3.4 Enumerations

    +

    18.3.4 Enumerations

    In C, an enumeration value is an integer value, while in C++ an enumeration value is implicitly convertible to an integer value, - but can also be distinguished by it's enum type. For each enum + but can also be distinguished by its enum type. For each enum declaration a def-foreign-type is generated, assigning the enum a default type of :int. Users may adjust the foreign type of enums via SWIG typemaps. @@ -901,13 +901,13 @@ globalvar> (globalvar.nnn::glob_float) of it not being necessary to probe into foreign space to retrieve enum values. When generating a .cxx wrapper file, a more general solution is employed. A wrapper variable is created in the module_wrap.cxx file, and - a ff:def-foreign-variable call is generated to retrieve it's value into lisp. + a ff:def-foreign-variable call is generated to retrieve its value into lisp.

    For example, the following header file

    enum.h:
    -enum COL { RED, GREEN, BLUE };	
    +enum COL { RED, GREEN, BLUE };
     enum FOO { FOO1 = 10, FOO2, FOO3 };
           
    @@ -957,7 +957,7 @@ EXPORT const int ACL_ENUM___FOO3__SWIG_0 = FOO3; -

    17.3.5 Arrays

    +

    18.3.5 Arrays

    @@ -1105,10 +1105,10 @@ namespace BAR { -

    17.3.6 Classes and Structs and Unions (oh my!)

    +

    18.3.6 Classes and Structs and Unions (oh my!)

    -

    17.3.6.1 CLOS wrapping of

    +

    18.3.6.1 CLOS wrapping of

    @@ -1123,7 +1123,7 @@ namespace BAR { integer values.

    -

    17.3.6.2 CLOS Inheritance

    +

    18.3.6.2 CLOS Inheritance

    @@ -1131,12 +1131,12 @@ namespace BAR { inheritance of the classes in foreign code, with the ff:foreign-pointer class at its root. ff:foreign-pointer is a thin wrapper for pointers that is made available by the foreign function - interface. It's key benefit is that it may be passed as an argument + interface. Its key benefit is that it may be passed as an argument to any ff:def-foreign-call that is expecting a pointer as the parameter.

    -

    17.3.6.3 Member fields and functions

    +

    18.3.6.3 Member fields and functions

    @@ -1152,7 +1152,7 @@ namespace BAR { the interface does nothing for friend directives,

    -

    17.3.6.4 Why not directly access C++ classes using foreign types?

    +

    18.3.6.4 Why not directly access C++ classes using foreign types?

    @@ -1170,34 +1170,34 @@ namespace BAR { use the more robust wrapper functions.

    -

    17.3.7 Templates

    +

    18.3.7 Templates

    -

    17.3.7.1 Generating wrapper code for templates

    +

    18.3.7.1 Generating wrapper code for templates

    -

    - SWIG provides support for dealing with templates, but by - default, it will not generate any member variable or function - wrappers for templated classes. In order to create these - wrappers, you need to explicitly tell SWIG to instantiate - them. This is done via the - %template - directive. -

    +

    +SWIG provides support for dealing with templates, but by +default, it will not generate any member variable or function +wrappers for templated classes. In order to create these +wrappers, you need to explicitly tell SWIG to instantiate +them. This is done via the +%template +directive. +

    -

    17.3.7.2 Implicit Template instantiation

    +

    18.3.7.2 Implicit Template instantiation

    -

    - While no wrapper code is generated for accessing member - variables, or calling member functions, type code is generated - to include these templated classes in the foreign-type and CLOS - class schema. -

    +

    +While no wrapper code is generated for accessing member +variables, or calling member functions, type code is generated +to include these templated classes in the foreign-type and CLOS +class schema. +

    -

    17.3.8 Typedef, Templates, and Synonym Types

    +

    18.3.8 Typedef, Templates, and Synonym Types

    @@ -1243,7 +1243,7 @@ int zzz(A *inst = 0); /* return inst->x + inst->y */ definition, we generate a form that expands to:

    - (setf (find-class <synonym>) <primary>) + (setf (find-class <synonym>) <primary>)

    The result is that all references to synonym types in foreign @@ -1277,7 +1277,7 @@ synonym> -

    17.3.8.1 Choosing a primary type

    +

    18.3.8.1 Choosing a primary type

    @@ -1285,20 +1285,20 @@ synonym> criteria from a set of synonym types.

      -
    • - If a synonym type has a class definition, it is the primary type. -
    • -
    • - If a synonym type is a class template and has been explicitly - instantiated via %template, it is the primary type. -
    • -
    • - For all other sets of synonymous types, the synonym which is - parsed first becomes the primary type. -
    • +
    • + If a synonym type has a class definition, it is the primary type. +
    • +
    • + If a synonym type is a class template and has been explicitly + instantiated via %template, it is the primary type. +
    • +
    • + For all other sets of synonymous types, the synonym which is + parsed first becomes the primary type. +
    -

    17.3.9 Function overloading/Parameter defaulting

    +

    18.3.9 Function overloading/Parameter defaulting

    @@ -1461,7 +1461,7 @@ overload> -

    17.3.10 Operator wrapping and Operator overloading

    +

    18.3.10 Operator wrapping and Operator overloading

    @@ -1472,68 +1472,68 @@ overload>

     /* name conversion for overloaded operators. */
     #ifdef __cplusplus
    -%rename(__add__)	     *::operator+;
    -%rename(__pos__)	     *::operator+();
    -%rename(__pos__)	     *::operator+() const;
    +%rename(__add__)             *::operator+;
    +%rename(__pos__)             *::operator+();
    +%rename(__pos__)             *::operator+() const;
     
    -%rename(__sub__)	     *::operator-;
    -%rename(__neg__)	     *::operator-() const;
    -%rename(__neg__)	     *::operator-();
    +%rename(__sub__)             *::operator-;
    +%rename(__neg__)             *::operator-() const;
    +%rename(__neg__)             *::operator-();
     
    -%rename(__mul__)	     *::operator*;
    -%rename(__deref__)	     *::operator*();
    -%rename(__deref__)	     *::operator*() const;
    +%rename(__mul__)             *::operator*;
    +%rename(__deref__)           *::operator*();
    +%rename(__deref__)           *::operator*() const;
     
    -%rename(__div__)	     *::operator/;
    -%rename(__mod__)	     *::operator%;
    -%rename(__logxor__)	     *::operator^;
    -%rename(__logand__)	     *::operator&;
    -%rename(__logior__)	     *::operator|;
    -%rename(__lognot__)	     *::operator~();
    -%rename(__lognot__)	     *::operator~() const;
    +%rename(__div__)             *::operator/;
    +%rename(__mod__)             *::operator%;
    +%rename(__logxor__)          *::operator^;
    +%rename(__logand__)          *::operator&;
    +%rename(__logior__)          *::operator|;
    +%rename(__lognot__)          *::operator~();
    +%rename(__lognot__)          *::operator~() const;
     
    -%rename(__not__)	     *::operator!();
    -%rename(__not__)	     *::operator!() const;
    +%rename(__not__)             *::operator!();
    +%rename(__not__)             *::operator!() const;
     
    -%rename(__assign__)	     *::operator=;
    +%rename(__assign__)          *::operator=;
     
     %rename(__add_assign__)      *::operator+=;
    -%rename(__sub_assign__)	     *::operator-=;
    -%rename(__mul_assign__)	     *::operator*=;
    -%rename(__div_assign__)	     *::operator/=;
    -%rename(__mod_assign__)	     *::operator%=;
    +%rename(__sub_assign__)      *::operator-=;
    +%rename(__mul_assign__)      *::operator*=;
    +%rename(__div_assign__)      *::operator/=;
    +%rename(__mod_assign__)      *::operator%=;
     %rename(__logxor_assign__)   *::operator^=;
     %rename(__logand_assign__)   *::operator&=;
     %rename(__logior_assign__)   *::operator|=;
     
    -%rename(__lshift__)	     *::operator<<;
    +%rename(__lshift__)          *::operator<<;
     %rename(__lshift_assign__)   *::operator<<=;
    -%rename(__rshift__)	     *::operator>>;
    +%rename(__rshift__)          *::operator>>;
     %rename(__rshift_assign__)   *::operator>>=;
     
    -%rename(__eq__)		     *::operator==;
    -%rename(__ne__)		     *::operator!=;
    -%rename(__lt__)		     *::operator<;
    -%rename(__gt__)		     *::operator>;
    -%rename(__lte__)	     *::operator<=;
    -%rename(__gte__)	     *::operator>=;
    +%rename(__eq__)              *::operator==;
    +%rename(__ne__)              *::operator!=;
    +%rename(__lt__)              *::operator<;
    +%rename(__gt__)              *::operator>;
    +%rename(__lte__)             *::operator<=;
    +%rename(__gte__)             *::operator>=;
     
    -%rename(__and__)	     *::operator&&;
    -%rename(__or__)		     *::operator||;
    +%rename(__and__)             *::operator&&;
    +%rename(__or__)              *::operator||;
     
    -%rename(__preincr__)	     *::operator++();
    -%rename(__postincr__)	     *::operator++(int);
    -%rename(__predecr__)	     *::operator--();
    -%rename(__postdecr__)	     *::operator--(int);
    +%rename(__preincr__)         *::operator++();
    +%rename(__postincr__)        *::operator++(int);
    +%rename(__predecr__)         *::operator--();
    +%rename(__postdecr__)        *::operator--(int);
     
    -%rename(__comma__)	     *::operator,();
    -%rename(__comma__)	     *::operator,() const;
    +%rename(__comma__)           *::operator,();
    +%rename(__comma__)           *::operator,() const;
     
     %rename(__member_ref__)      *::operator->;
     %rename(__member_func_ref__) *::operator->*;
     
    -%rename(__funcall__)	     *::operator();
    -%rename(__aref__)	     *::operator[];
    +%rename(__funcall__)         *::operator();
    +%rename(__aref__)            *::operator[];
         
    @@ -1607,7 +1607,7 @@ opoverload> -

    17.3.11 Varargs

    +

    18.3.11 Varargs

    @@ -1617,7 +1617,7 @@ opoverload> directive. This directive allows you to specify a (finite) argument list which will be inserted into the wrapper in place of the variable length argument indicator. As an example, - consider the function printf(). It's declaration would + consider the function printf(). Its declaration would appear as follows:

    @@ -1628,7 +1628,7 @@ opoverload> with other ways such functions can be wrapped.

    -

    17.3.12 C++ Exceptions

    +

    18.3.12 C++ Exceptions

    @@ -1640,7 +1640,7 @@ opoverload> implemented.

    -

    17.3.13 Pass by value, pass by reference

    +

    18.3.13 Pass by value, pass by reference

    @@ -1652,7 +1652,7 @@ opoverload> newly defined types.

    -

    17.4 Typemaps

    +

    18.4 Typemaps

    @@ -1663,7 +1663,7 @@ opoverload> on Typemaps for more information.

    -

    17.4.1 Code Generation in the C++ Wrapper

    +

    18.4.1 Code Generation in the C++ Wrapper

    @@ -1693,7 +1693,7 @@ return-val wrapper-name(parm0, parm1, ..., parmN) -

    17.4.1.1 IN Typemap

    +

    18.4.1.1 IN Typemap

    @@ -1728,14 +1728,14 @@ return-val wrapper-name(parm0, parm1, ..., parmN) -

    17.4.1.2 OUT Typemap

    +

    18.4.1.2 OUT Typemap

    The out typemap is used to generate code to form the return value of the wrapper from the return value of the wrapped function. This code is placed in the <convert and bind result to lresult> - section of the above code diagram. It's default mapping is as follows: + section of the above code diagram. Its default mapping is as follows:

    @@ -1752,13 +1752,13 @@ return-val wrapper-name(parm0, parm1, ..., parmN)
    -

    17.4.1.3 CTYPE Typemap

    +

    18.4.1.3 CTYPE Typemap

    This typemap is not used for code generation, but purely for the transformation of types in the parameter list of the wrapper function. - It's primary use is to handle by-value to by-reference conversion in the + Its primary use is to handle by-value to by-reference conversion in the wrappers parameter list. Its default settings are:

    @@ -1784,7 +1784,7 @@ return-val wrapper-name(parm0, parm1, ..., parmN) these common typemaps here.

    -

    17.4.2 Code generation in Lisp wrappers

    +

    18.4.2 Code generation in Lisp wrappers

    @@ -1803,7 +1803,7 @@ return-val wrapper-name(parm0, parm1, ..., parmN) 16.3.1 Namespaces for details.

    -

    17.4.2.1 LIN Typemap

    +

    18.4.2.1 LIN Typemap

    @@ -1821,32 +1821,32 @@ return-val wrapper-name(parm0, parm1, ..., parmN)

    The LIN typemap accepts the following $variable references.

      -
    • $in - expands to the name of the parameter being - applied to this typemap -
    • -
    • $out - expands to the name of the local variable - assigned to this typemap -
    • -
    • $in_fftype - the foreign function type of the C type.
    • -
    • $*in_fftype - the foreign function type of the C type - with one pointer removed. If there is no pointer, then $*in_fftype - is the same as $in_fftype. -
    • -
    • $body - very important. Instructs SWIG where - subsequent code generation steps should be inserted into the - current typemap. Leaving out a $body reference - will result in lisp wrappers that do very little by way of - calling into foreign code. Not recommended. -
    • +
    • $in - expands to the name of the parameter being + applied to this typemap +
    • +
    • $out - expands to the name of the local variable + assigned to this typemap +
    • +
    • $in_fftype - the foreign function type of the C type.
    • +
    • $*in_fftype - the foreign function type of the C type + with one pointer removed. If there is no pointer, then $*in_fftype + is the same as $in_fftype. +
    • +
    • $body - very important. Instructs SWIG where + subsequent code generation steps should be inserted into the + current typemap. Leaving out a $body reference + will result in lisp wrappers that do very little by way of + calling into foreign code. Not recommended. +
    -%typemap(lin)	SWIGTYPE 	"(cl:let (($out $in))\n  $body)";
    +%typemap(lin) SWIGTYPE "(cl:let (($out $in))\n  $body)";
         
    -

    17.4.2.2 LOUT Typemap

    +

    18.4.2.2 LOUT Typemap

    @@ -1858,17 +1858,17 @@ return-val wrapper-name(parm0, parm1, ..., parmN)

    The LOUT typemap uses the following $variable

      -
    • $lclass - Expands to the CLOS class that - represents foreign-objects of the return type matching this - typemap. -
    • -
    • $body - Same as for the LIN map. Place this - variable where you want the foreign-function call to occur. -
    • -
    • $ldestructor - Expands to the symbol naming the destructor for this - class ($lclass) of object. Allows you to insert finalization or automatic garbage - collection into the wrapper code (see default mappings below). -
    • +
    • $lclass - Expands to the CLOS class that + represents foreign-objects of the return type matching this + typemap. +
    • +
    • $body - Same as for the LIN map. Place this + variable where you want the foreign-function call to occur. +
    • +
    • $ldestructor - Expands to the symbol naming the destructor for this + class ($lclass) of object. Allows you to insert finalization or automatic garbage + collection into the wrapper code (see default mappings below). +
    @@ -1889,7 +1889,7 @@ return-val wrapper-name(parm0, parm1, ..., parmN)
    -

    17.4.2.3 FFITYPE Typemap

    +

    18.4.2.3 FFITYPE Typemap

    @@ -1939,7 +1939,7 @@ return-val wrapper-name(parm0, parm1, ..., parmN) -

    17.4.2.4 LISPTYPE Typemap

    +

    18.4.2.4 LISPTYPE Typemap

    @@ -1959,7 +1959,7 @@ return-val wrapper-name(parm0, parm1, ..., parmN) -

    17.4.2.5 LISPCLASS Typemap

    +

    18.4.2.5 LISPCLASS Typemap

    @@ -1983,7 +1983,7 @@ return-val wrapper-name(parm0, parm1, ..., parmN) -

    17.4.3 Modifying SWIG behavior using typemaps

    +

    18.4.3 Modifying SWIG behavior using typemaps

    @@ -2017,10 +2017,10 @@ return-val wrapper-name(parm0, parm1, ..., parmN) -

    17.5 Identifier Converter functions

    +

    18.5 Identifier Converter functions

    -

    17.5.1 Creating symbols in the lisp environment

    +

    18.5.1 Creating symbols in the lisp environment

    @@ -2041,11 +2041,11 @@ return-val wrapper-name(parm0, parm1, ..., parmN) of arguments.

    -

    17.5.2 Existing identifier-converter functions

    +

    18.5.2 Existing identifier-converter functions

    Two basic identifier routines have been defined. -

    17.5.2.1 identifier-convert-null

    +

    18.5.2.1 identifier-convert-null

    @@ -2054,7 +2054,7 @@ return-val wrapper-name(parm0, parm1, ..., parmN) strings, from which a symbol will be created.

    -

    17.5.2.2 identifier-convert-lispify

    +

    18.5.2.2 identifier-convert-lispify

    @@ -2063,7 +2063,7 @@ return-val wrapper-name(parm0, parm1, ..., parmN) same symbol transformations.

    -

    17.5.2.3 Default identifier to symbol conversions

    +

    18.5.2.3 Default identifier to symbol conversions

    @@ -2072,7 +2072,7 @@ return-val wrapper-name(parm0, parm1, ..., parmN) default naming conventions.

    -

    17.5.3 Defining your own identifier-converter

    +

    18.5.3 Defining your own identifier-converter

    @@ -2093,7 +2093,7 @@ foreign environment.

    The :type keyword argument provides more information on the type of -identifier. It's value is a symbol. This allows the +identifier. Its value is a symbol. This allows the identifier-converter to apply different heuristics when mapping different types of identifiers to symbols. SWIG will generate calls to your identifier-converter using the following types. @@ -2123,12 +2123,12 @@ scope in the specified class.

    The :arity keyword argument only appears in swig:swig-defmethod forms -generated for overloaded functions. It's value is an integer +generated for overloaded functions. Its value is an integer indicating the number of arguments passed to the routine indicated by this identifier.

    -

    17.5.4 Instructing SWIG to use a particular identifier-converter

    +

    18.5.4 Instructing SWIG to use a particular identifier-converter

    diff --git a/Doc/Manual/Android.html b/Doc/Manual/Android.html index 4d1be39..8838e67 100644 --- a/Doc/Manual/Android.html +++ b/Doc/Manual/Android.html @@ -1,11 +1,12 @@ - + SWIG and Android + -

    18 SWIG and Android

    +

    19 SWIG and Android

      @@ -30,24 +31,24 @@ This chapter describes SWIG's support of Android. -

      18.1 Overview

      +

      19.1 Overview

      The Android chapter is fairly short as support for Android is the same as for Java, where the Java Native Interface (JNI) is used to call from Android Java into C or C++ compiled code. -Everything in the Java chapter applies to generating code for access from Android Java code. +Everything in the Java chapter applies to generating code for access from Android Java code. This chapter contains a few Android specific notes and examples.

      -

      18.2 Android examples

      +

      19.2 Android examples

      -

      18.2.1 Examples introduction

      +

      19.2.1 Examples introduction

      -The examples require the Android SDK and Android NDK which can be installed as per instructions in the links. +The examples require the Android SDK and Android NDK which can be installed as per instructions in the links. The Eclipse version is not required for these examples as just the command line tools are used (shown for Linux as the host, but Windows will be very similar, if not identical in most places). Add the SDK tools and NDK tools to your path and create a directory somewhere for your Android projects (adjust PATH as necessary to where you installed the tools):

      @@ -56,7 +57,7 @@ Add the SDK tools and NDK tools to your path and create a directory somewhere fo
       $ export PATH=$HOME/android/android-sdk-linux_x86/tools:$HOME/android/android-sdk-linux_x86/platform-tools:$HOME/android/android-ndk-r6b:$PATH
       $ mkdir AndroidApps 
      -$ cd AnrdoidApps
      +$ cd AndroidApps
       
    @@ -76,7 +77,7 @@ $ android list targets The following examples are shipped with SWIG under the Examples/android directory and include a Makefile to build and install each example.

    -

    18.2.2 Simple C example

    +

    19.2.2 Simple C example

    @@ -209,7 +210,7 @@ When complete your device should be listed in those attached, something like:

     $ adb devices
     List of devices attached 
    -A32-6DBE0001-9FF80000-015D62C3-02018028	device
    +A32-6DBE0001-9FF80000-015D62C3-02018028 device
     
    @@ -221,7 +222,7 @@ This means you are now ready to install the application...
     $ adb install bin/SwigSimple-debug.apk 
     95 KB/s (4834 bytes in 0.049s)
    -	pkg: /data/local/tmp/SwigSimple-debug.apk
    +        pkg: /data/local/tmp/SwigSimple-debug.apk
     Success
     
    @@ -398,7 +399,7 @@ Run the app again and this time you will see the output pictured below, showing
    Android screenshot of SwigSimple example
    -

    18.2.3 C++ class example

    +

    19.2.3 C++ class example

    @@ -435,11 +436,11 @@ public: } virtual ~Shape() { nshapes--; - }; + } double x, y; void move(double dx, double dy); - virtual double area(void) = 0; - virtual double perimeter(void) = 0; + virtual double area() = 0; + virtual double perimeter() = 0; static int nshapes; }; @@ -447,18 +448,18 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; - virtual double area(void); - virtual double perimeter(void); + Circle(double r) : radius(r) { } + virtual double area(); + virtual double perimeter(); }; class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; - virtual double area(void); - virtual double perimeter(void); + Square(double w) : width(w) { } + virtual double area(); + virtual double perimeter(); }; @@ -482,19 +483,19 @@ void Shape::move(double dx, double dy) { int Shape::nshapes = 0; -double Circle::area(void) { +double Circle::area() { return M_PI*radius*radius; } -double Circle::perimeter(void) { +double Circle::perimeter() { return 2*M_PI*radius; } -double Square::area(void) { +double Square::area() { return width*width; } -double Square::perimeter(void) { +double Square::perimeter() { return 4*width; } @@ -746,7 +747,7 @@ Run the app to see the result of calling the C++ code from Java:

    Android screenshot of SwigClass example
    -

    18.2.4 Other examples

    +

    19.2.4 Other examples

    @@ -758,7 +759,7 @@ Note that the 'extend' example is demonstrates the directors feature. Normally C++ exception handling and the STL is not available by default in the version of g++ shipped with Android, but this example turns these features on as described in the next section.

    -

    18.3 C++ STL

    +

    19.3 C++ STL

    diff --git a/Doc/Manual/Arguments.html b/Doc/Manual/Arguments.html index 1ae9a6d..48ec5c6 100644 --- a/Doc/Manual/Arguments.html +++ b/Doc/Manual/Arguments.html @@ -1,12 +1,13 @@ - + Argument Handling + -

    9 Argument Handling

    +

    10 Argument Handling

      @@ -42,7 +43,7 @@ return multiple values through the arguments of a function. This chapter describes some of the techniques for doing this.

      -

      9.1 The typemaps.i library

      +

      10.1 The typemaps.i library

      @@ -50,7 +51,7 @@ This section describes the typemaps.i library file--commonly used to change certain properties of argument conversion.

      -

      9.1.1 Introduction

      +

      10.1.1 Introduction

      @@ -59,7 +60,7 @@ Suppose you had a C function like this:

       void add(double a, double b, double *result) {
      -	*result = a + b;
      +  *result = a + b;
       }
       
      @@ -194,7 +195,7 @@ else. To clear a typemap, the %clear directive should be used. For e
    -

    9.1.2 Input parameters

    +

    10.1.2 Input parameters

    @@ -203,7 +204,7 @@ input value:

    -int *INPUT		
    +int *INPUT
     short *INPUT
     long *INPUT
     unsigned int *INPUT
    @@ -220,7 +221,7 @@ function:
     
     
     double add(double *a, double *b) {
    -	return *a+*b;
    +  return *a+*b;
     }
     
    @@ -247,7 +248,7 @@ When the function is used in the scripting language interpreter, it will work li result = add(3,4)
    -

    9.1.3 Output parameters

    +

    10.1.3 Output parameters

    @@ -272,7 +273,7 @@ These methods can be used as shown in an earlier example. For example, if you ha

     void add(double a, double b, double *c) {
    -	*c = a+b;
    +  *c = a+b;
     }
     
    @@ -314,7 +315,7 @@ iresult, dresult = foo(3.5, 2) -

    9.1.4 Input/Output parameters

    +

    10.1.4 Input/Output parameters

    @@ -338,7 +339,7 @@ A C function that uses this might be something like this:

     void negate(double *x) {
    -	*x = -(*x);
    +  *x = -(*x);
     }
     
     
    @@ -379,7 +380,7 @@ rather than directly overwriting the value of the original input object. SWIG. Backwards compatibility is preserved, but deprecated.

    -

    9.1.5 Using different names

    +

    10.1.5 Using different names

    @@ -413,7 +414,7 @@ Typemap declarations are lexically scoped so a typemap takes effect from the poi file or a matching %clear declaration.

    -

    9.2 Applying constraints to input values

    +

    10.2 Applying constraints to input values

    @@ -423,7 +424,7 @@ insure that a value is positive, or that a pointer is non-NULL. This can be accomplished including the constraints.i library file.

    -

    9.2.1 Simple constraint example

    +

    10.2.1 Simple constraint example

    @@ -449,7 +450,7 @@ the arguments violate the constraint condition, a scripting language exception will be raised. As a result, it is possible to catch bad values, prevent mysterious program crashes and so on.

    -

    9.2.2 Constraint methods

    +

    10.2.2 Constraint methods

    @@ -465,7 +466,7 @@ NONNULL Non-NULL pointer (pointers only). -

    9.2.3 Applying constraints to new datatypes

    +

    10.2.3 Applying constraints to new datatypes

    diff --git a/Doc/Manual/CCache.html b/Doc/Manual/CCache.html index 7db5583..d23b0cb 100644 --- a/Doc/Manual/CCache.html +++ b/Doc/Manual/CCache.html @@ -1,12 +1,13 @@ - + ccache-swig(1) manpage + -

    16 Using SWIG with ccache - ccache-swig(1) manpage

    +

    17 Using SWIG with ccache - ccache-swig(1) manpage

      @@ -34,7 +35,7 @@

      -

      16.1 NAME

      +

      17.1 NAME

      @@ -42,7 +43,7 @@ ccache-swig - a fast compiler cache

      -

      16.2 SYNOPSIS

      +

      17.2 SYNOPSIS

      @@ -52,16 +53,16 @@ ccache-swig <compiler> [COMPILER OPTIONS]

      <compiler> [COMPILER OPTIONS]

      -

      16.3 DESCRIPTION

      +

      17.3 DESCRIPTION

      -ccache-swig is a compiler cache. It speeds up re-compilation of C/C++/SWIG code +ccache-swig is a compiler cache. It speeds up re-compilation of C/C++/SWIG code by caching previous compiles and detecting when the same compile is being done again. ccache-swig is ccache plus support for SWIG. ccache and ccache-swig are used interchangeably in this document.

      -

      16.4 OPTIONS SUMMARY

      +

      17.4 OPTIONS SUMMARY

      @@ -81,7 +82,7 @@ Here is a summary of the options to ccache-swig.

      -

      16.5 OPTIONS

      +

      17.5 OPTIONS

      @@ -98,7 +99,7 @@ statistics are stored spread across the subdirectories of the cache. Using "ccache-swig -s" adds up the statistics across all subdirectories and prints the totals.

      -

      -z
      Zero the cache statistics. +

      -z
      Zero the cache statistics.

      -V
      Print the ccache version number

      @@ -123,7 +124,7 @@ rounded down to the nearest multiple of 16 kilobytes.

      -

      16.6 INSTALLATION

      +

      17.6 INSTALLATION

      @@ -135,7 +136,7 @@ some specific projects. The second method is most useful for when you wish to use ccache for all your compiles.

      To install for usage by the first method just copy ccache-swig to somewhere -in your path. +in your path.

      To install for the second method do something like this:

      @@ -155,7 +156,7 @@ This will work as long as /usr/local/bin comes before the path to gcc
       Note! Do not use a hard link, use a symbolic link. A hardlink will
       cause "interesting" problems.
       

      -

      16.7 EXTRA OPTIONS

      +

      17.7 EXTRA OPTIONS

      @@ -163,7 +164,7 @@ When run as a compiler front end ccache usually just takes the same command line options as the compiler you are using. The only exception to this is the option '--ccache-skip'. That option can be used to tell ccache that the next option is definitely not a input filename, and -should be passed along to the compiler as-is. +should be passed along to the compiler as-is.

      The reason this can be important is that ccache does need to parse the command line and determine what is an input filename and what is a @@ -175,7 +176,7 @@ file). By using --ccache-skip you can force an option to not be treated as an input file name and instead be passed along to the compiler as a command line option.

      -

      16.8 ENVIRONMENT VARIABLES

      +

      17.8 ENVIRONMENT VARIABLES

      @@ -247,7 +248,7 @@ each compile.

      CCACHE_NLEVELS
      The environment variable CCACHE_NLEVELS allows you to choose the number of levels of hash in the cache directory. The -default is 2. The minimum is 1 and the maximum is 8. +default is 2. The minimum is 1 and the maximum is 8.

      CCACHE_HARDLINK
      If you set the environment variable CCACHE_HARDLINK then ccache will attempt to use hard links from the @@ -296,7 +297,7 @@ systems like this you can use the CCACHE_EXTENSION option to override the default. On HP-UX set this environment variable to "i" if you use the aCC compiler.

      -

      CCACHE_STRIPC
      If you set the environment variable +

      CCACHE_STRIPC
      If you set the environment variable CCACHE_STRIPC then ccache will strip the -c option when invoking the preprocessor. This option is primarily for the Sun Workshop C++ compiler as without this option an unwarranted warning is displayed: @@ -304,8 +305,8 @@ CC: Warning: "-E" redefines product from "object" to "source (stdout)" when -E and -c is used together.

      CCACHE_SWIG
      When using SWIG as the compiler and it does not -have 'swig' in the executable name, then the CCACHE_SWIG environment -variable needs to be set in order for ccache to work correctly with +have 'swig' in the executable name, then the CCACHE_SWIG environment +variable needs to be set in order for ccache to work correctly with SWIG. The use of CCACHE_CPP2 is also recommended for SWIG due to some preprocessor quirks, however, use of CCACHE_CPP2 can often be skipped -- check your generated code with and without this option set. Known @@ -314,7 +315,7 @@ the use of '#pragma SWIG'.

      -

      16.9 CACHE SIZE MANAGEMENT

      +

      17.9 CACHE SIZE MANAGEMENT

      @@ -327,18 +328,18 @@ When these limits are reached ccache will reduce the cache to 20% below the numbers you specified in order to avoid doing the cache clean operation too often.

      -

      16.10 CACHE COMPRESSION

      +

      17.10 CACHE COMPRESSION

      -By default on most platforms ccache will compress all files it puts +By default on most platforms ccache will compress all files it puts into the cache using the zlib compression. While this involves a negligible performance slowdown, it significantly increases the number of files that fit in the cache. You can turn off compression setting the CCACHE_NOCOMPRESS environment variable.

      -

      16.11 HOW IT WORKS

      +

      17.11 HOW IT WORKS

      @@ -363,7 +364,7 @@ compiler output that you would get without the cache. If you ever discover a case where ccache changes the output of your compiler then please let me know.

      -

      16.12 USING CCACHE WITH DISTCC

      +

      17.12 USING CCACHE WITH DISTCC

      @@ -375,9 +376,9 @@ ccache avoids the compile completely where possible. To use distcc with ccache I recommend using the CCACHE_PREFIX option. You just need to set the environment variable CCACHE_PREFIX to 'distcc' and ccache will prefix the command line used with the -compiler with the command 'distcc'. +compiler with the command 'distcc'.

      -

      16.13 SHARING A CACHE

      +

      17.13 SHARING A CACHE

      @@ -397,7 +398,7 @@ following conditions need to be met: to 002, this ensures that cached files are accessible to everyone in the group.

    • Make sure that all users have write permission in the entire - cache directory (and that you trust all users of the shared cache). + cache directory (and that you trust all users of the shared cache).
    • Make sure that the setgid bit is set on all directories in the cache. This tells the filesystem to inherit group ownership for new directories. The command "chmod g+s `find $CCACHE_DIR -type d`" might @@ -406,13 +407,13 @@ following conditions need to be met: versions of ccache that do not support compression.

    -

    16.14 HISTORY

    +

    17.14 HISTORY

    ccache was inspired by the compilercache shell script script written by Erik Thiele and I would like to thank him for an excellent piece of -work. See +work. See http://www.erikyyy.de/compilercache/ for the Erik's scripts. ccache-swig is a port of the original ccache with support added for use @@ -422,7 +423,7 @@ I wrote ccache because I wanted to get a bit more speed out of a compiler cache and I wanted to remove some of the limitations of the shell-script version.

    -

    16.15 DIFFERENCES FROM COMPILERCACHE

    +

    17.15 DIFFERENCES FROM COMPILERCACHE

    @@ -440,7 +441,7 @@ are:

  • ccache avoids a double call to cpp on a cache miss

    -

    16.16 CREDITS

    +

    17.16 CREDITS

    @@ -452,7 +453,7 @@ Thanks to the following people for their contributions to ccache

  • Paul Russell for many suggestions and the debian packaging

    -

    16.17 AUTHOR

    +

    17.17 AUTHOR

    @@ -471,5 +472,3 @@ later. Please see the file COPYING for license details. - - diff --git a/Doc/Manual/CPlusPlus11.html b/Doc/Manual/CPlusPlus11.html new file mode 100644 index 0000000..714845b --- /dev/null +++ b/Doc/Manual/CPlusPlus11.html @@ -0,0 +1,1184 @@ + + + +SWIG and C++11 + + + + + +

    7 SWIG and C++11

    + + + + + + +

    7.1 Introduction

    + + +

    This chapter gives you a brief overview about the SWIG +implementation of the C++11 standard. This part of SWIG is still a work in +progress. +

    +

    SWIG supports the new C++ syntax changes with some minor limitations +in some areas such as decltype expressions and variadic templates. Wrappers for the +new STL types (unordered_ containers, result_of, tuples) are incomplete. +The wrappers for the new containers would work much like the C++03 containers and +users are welcome to help by adapting the existing container interface files and submitting them +as a patch for inclusion in future versions of SWIG. +

    + +

    7.2 Core language changes

    + + +

    7.2.1 Rvalue reference and move semantics

    + + +

    +SWIG correctly parses the rvalue reference syntax '&&', +for example the typical usage of it in the move constructor and move assignment operator below: +

    + +
    +class MyClass {
    +...
    +  std::vector<int> numbers;
    +public:
    +  MyClass(MyClass &&other) : numbers(std::move(other.numbers)) {}
    +  MyClass & operator=(MyClass &&other) {
    +    numbers = std::move(other.numbers);
    +    return *this;
    +  }
    +};
    +
    + +

    +Rvalue references are designed for C++ temporaries and so are not very useful when used from non-C++ target languages. +Generally you would just ignore them via %ignore before parsing the class. +For example, ignore the move constructor: +

    + +
    +%ignore MyClass::MyClass(MyClass &&);
    +
    + +

    +The plan is to ignore move constructors by default in a future version of SWIG. Note that both normal assignment operators as well as move assignment operators are ignored by default in most target languages with the following warning: +

    + +
    +
    +example.i:18: Warning 503: Can't wrap 'operator =' unless renamed to a valid identifier.
    +
    +
    + + +

    7.2.2 Generalized constant expressions

    + + +

    SWIG parses and identifies the keyword constexpr, but cannot fully utilise it. +These C++ compile time constants are usable as runtime constants from the target languages. +Below shows example usage for assigning a C++ compile time constant from a compile time constant function: +

    + +
    +constexpr int XXX() { return 10; }
    +constexpr int YYY = XXX() + 100;
    +
    + +

    +When either of these is used from a target language, a runtime call is made to obtain the underlying constant. +

    + +

    7.2.3 Extern template

    + + +

    SWIG correctly parses the keywords extern template. +However, this template instantiation suppression in a translation unit has no relevance outside of the C++ compiler and so is not used by SWIG. +SWIG only uses %template for instantiating and wrapping templates.

    + +
    +template class std::vector<int>;        // C++03 explicit instantiation in C++
    +extern template class std::vector<int>; // C++11 explicit instantiation suppression in C++
    +%template(VectorInt) std::vector<int>;  // SWIG instantiation
    +
    + +

    7.2.4 Initializer lists

    + + +

    +Initializer lists are very much a C++ compiler construct and are not very accessible from wrappers as +they are intended for compile time initialization of classes using the special std::initializer_list type. +SWIG detects usage of initializer lists and will emit a special informative warning each time one is used: +

    + +
    +
    +example.i:33: Warning 476: Initialization using std::initializer_list.
    +
    +
    + +

    +Initializer lists usually appear in constructors but can appear in any function or method. +They often appear in constructors which are overloaded with alternative approaches to initializing a class, +such as the std container's push_back method for adding elements to a container. +The recommended approach then is to simply ignore the initializer-list constructor, for example: +

    + +
    +%ignore Container::Container(std::initializer_list<int>);
    +class Container {
    +public:
    +  Container(std::initializer_list<int>); // initializer-list constructor
    +  Container();
    +  void push_back(const int &);
    +  ...
    +};
    +
    + +

    Alternatively you could modify the class and add another constructor for initialization by some other means, +for example by a std::vector:

    + +
    +%include <std_vector.i>
    +class Container {
    +public:
    +  Container(const std::vector<int> &);
    +  Container(std::initializer_list<int>); // initializer-list constructor
    +  Container();
    +  void push_back(const int &);
    +  ...
    +};
    +
    + +

    And then call this constructor from your target language, for example, in Python, the following will call the constructor taking the std::vector:

    + +
    +>>> c = Container( [1,2,3,4] )
    +
    + +

    +If you are unable to modify the class being wrapped, consider ignoring the initializer-list constructor and using +%extend to add in an alternative constructor: +

    + +
    +%include <std_vector.i>
    +%extend Container {
    +  Container(const std::vector<int> &elements) {
    +    Container *c = new Container();
    +    for (int element : elements)
    +      c->push_back(element);
    +    return c;
    +  }
    +}
    +
    +%ignore Container::Container(std::initializer_list<int>);
    +
    +class Container {
    +public:
    +  Container(std::initializer_list<int>); // initializer-list constructor
    +  Container();
    +  void push_back(const int &);
    +  ...
    +};
    +
    + +

    +The above makes the wrappers look is as if the class had been declared as follows: +

    + +
    +%include <std_vector.i>
    +class Container {
    +public:
    +  Container(const std::vector<int> &);
    +//  Container(std::initializer_list<int>); // initializer-list constructor (ignored)
    +  Container();
    +  void push_back(const int &);
    +  ...
    +};
    +
    + +

    +std::initializer_list is simply a container that can only be initialized at compile time. +As it is just a C++ type, it is possible to write typemaps for a target language container to map onto +std::initializer_list. However, this can only be done for a fixed number of elements as +initializer lists are not designed to be constructed with a variable number of arguments at runtime. +The example below is a very simple approach which ignores any parameters passed in and merely initializes +with a fixed list of fixed integer values chosen at compile time: +

    + +
    +%typemap(in) std::initializer_list<int> {
    +  $1 = {10, 20, 30, 40, 50};
    +}
    +class Container {
    +public:
    +  Container(std::initializer_list<int>); // initializer-list constructor
    +  Container();
    +  void push_back(const int &);
    +  ...
    +};
    +
    + +

    +Any attempt at passing in values from the target language will be ignored and be replaced by {10, 20, 30, 40, 50}. +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 std::initializer_list, +but with values decided at runtime. +The typemaps would be target language specific. +

    + +

    +Note that the default typemap for std::initializer_list does nothing but issue the warning +and hence any user supplied typemaps will override it and suppress the warning. +

    + +

    7.2.5 Uniform initialization

    + + +

    The curly brackets {} for member initialization are fully +supported by SWIG:

    + +
    +struct BasicStruct {
    + int x;
    + double y;
    +};
    + 
    +struct AltStruct {
    +  AltStruct(int x, double y) : x_{x}, y_{y} {}
    + 
    +  int x_;
    +  double y_;
    +};
    +
    +BasicStruct var1{5, 3.2}; // only fills the struct components
    +AltStruct var2{2, 4.3};   // calls the constructor
    +
    + +

    Uniform initialization does not affect usage from the target language, for example in Python:

    + +
    +>>> a = AltStruct(10, 142.15)
    +>>> a.x_
    +10
    +>>> a.y_
    +142.15
    +
    + +

    7.2.6 Type inference

    + + +

    SWIG supports decltype() with some limitations. Single +variables are allowed, however, expressions are not supported yet. For +example, the following code will work:

    +
    +int i;
    +decltype(i) j;
    +
    + +

    However, using an expression inside the decltype results in syntax error:

    +
    +int i; int j;
    +decltype(i+j) k;  // syntax error
    +
    + +

    7.2.7 Range-based for-loop

    + + +

    This feature is part of the implementation block only. SWIG +ignores it.

    + +

    7.2.8 Lambda functions and expressions

    + + +

    SWIG correctly parses most of the Lambda functions syntax. For example:

    +
    +auto val = [] { return something; };
    +auto sum = [](int x, int y) { return x+y; };
    +auto sum = [](int x, int y) -> int { return x+y; };
    +
    + +

    The lambda functions are removed from the wrappers for now, because of the lack of support +for closures (scope of the lambda functions) in the target languages.

    + +

    +Lambda functions used to create variables can also be parsed, but due to limited support of auto when +the type is deduced from the expression, the variables are simply ignored. +

    + +
    +auto six = [](int x, int y) { return x+y; }(4, 2);
    +
    + +

    +Better support should be available in a later release. +

    + +

    7.2.9 Alternate function syntax

    + + +

    SWIG fully supports the new definition of functions. For example:

    +
    +struct SomeStruct {
    +  int FuncName(int x, int y);
    +};
    +
    + +

    can now be written as in C++11:

    + +
    +struct SomeStruct {
    +  auto FuncName(int x, int y) -> int;
    +};
    + 
    +auto SomeStruct::FuncName(int x, int y) -> int {
    +  return x + y;
    +}
    +
    + +

    The usage in the target languages remains the same, for example in Python:

    + +
    +>>> a = SomeStruct()
    +>>> a.FuncName(10,5)
    +15
    +
    + +

    SWIG will also deal with type inference for the return type, as per the limitations described earlier. For example:

    +
    +auto square(float a, float b) -> decltype(a);
    +
    + +

    7.2.10 Object construction improvement

    + + +

    +There are three parts to object construction improvement. +The first improvement is constructor delegation such as the following: +

    + +
    +class A {
    +public:
    +  int a;
    +  int b;
    +  int c;
    +
    +  A() : A(10) {}
    +  A(int aa) : A(aa, 20) {}
    +  A(int aa, int bb) : A(aa, bb, 30) {}
    +  A(int aa, int bb, int cc) { a=aa; b=bb; c=cc; }
    +};
    +
    + +

    +where peer constructors can be called. SWIG handles this without any issue. +

    + +

    +The second improvement is constructor inheritance via a using declaration. +This is parsed correctly, but the additional constructors are not currently added to the derived proxy class in the target language. +An example is shown below: + +

    + +
    +class BaseClass {
    +public:
    +  BaseClass(int iValue);
    +};
    +
    +class DerivedClass: public BaseClass {
    +  public:
    +  using BaseClass::BaseClass; // Adds DerivedClass(int) constructor
    +};
    +
    + +

    +The final part is member initialization at the site of the declaration. +This kind of initialization is handled by SWIG. +

    + +
    +class SomeClass {
    +public:
    +    SomeClass() {}
    +    explicit SomeClass(int new_value) : value(new_value) {}
    +
    +    int value = 5;
    +};
    +
    + +

    7.2.11 Explicit overrides and final

    + + +

    +The special identifiers final and override can be used on methods and destructors, +such as in the following example: +

    + +
    +struct BaseStruct {
    +  virtual void ab() const = 0;
    +  virtual void cd();
    +  virtual void ef();
    +  virtual ~BaseStruct();
    +};
    +struct DerivedStruct : BaseStruct {
    +  virtual void ab() const override;
    +  virtual void cd() final;
    +  virtual void ef() final override;
    +  virtual ~DerivedStruct() override;
    +};
    +
    + + +

    7.2.12 Null pointer constant

    + + +

    The nullptr constant is mostly unimportant in wrappers. In the few places it has an effect, it is treated like NULL.

    + +

    7.2.13 Strongly typed enumerations

    + + +

    SWIG supports strongly typed enumerations and parses the new enum class syntax and forward declarator for the enums, such as:

    +
    +enum class MyEnum : unsigned int;
    +
    + +

    +Strongly typed enums are often used to avoid name clashes such as the following: +

    + +
    +struct Color {
    +  enum class RainbowColors : unsigned int {
    +    Red, Orange, Yellow, Green, Blue, Indigo, Violet
    +  };
    +  
    +  enum class WarmColors {
    +    Yellow, Orange, Red
    +  };
    +
    +  // Note normal enum
    +  enum PrimeColors {
    +    Red=100, Green, Blue
    +  };
    +};
    +
    + +

    +There are various ways that the target languages handle enums, so it is not possible to precisely state how they are handled in this section. +However, generally, most scripting languages mangle in the strongly typed enumeration's class name, +but do not use any additional mangling for normal enumerations. For example, in Python, the following code +

    + +
    +print Color.RainbowColors_Red, Color.WarmColors_Red, Color.Red
    +
    + +

    +results in +

    + +
    +0 2 100
    +
    + +

    +The strongly typed languages often wrap normal enums into an enum class and so treat normal enums and strongly typed enums the same. +The equivalent in Java is: +

    + +
    +System.out.println(Color.RainbowColors.Red.swigValue() + " " + Color.WarmColors.Red.swigValue() + " " + Color.PrimeColors.Red.swigValue());
    +
    + +

    7.2.14 Double angle brackets

    + + +

    SWIG correctly parses the symbols >> as closing the +template block, if found inside it at the top level, or as the right +shift operator >> otherwise.

    + +
    +std::vector<std::vector<int>> myIntTable;
    +
    + +

    7.2.15 Explicit conversion operators

    + + +

    SWIG correctly parses the keyword explicit for operators in addition to constructors now. +For example:

    + +
    +class U {
    +public:
    +  int u;
    +};
    +
    +class V {
    +public:
    +  int v;
    +};
    +
    +class TestClass {
    +public:
    +  //implicit converting constructor
    +  TestClass(U const &val) { t=val.u; }
    +
    +  // explicit constructor
    +  explicit TestClass(V const &val) { t=val.v; }
    +
    +  int t;
    +};
    +
    +struct Testable {
    +  // explicit conversion operator
    +  explicit operator bool() const {
    +    return false;
    +  }
    +};
    +
    + +

    +The effect of explicit constructors and operators has little relevance for the proxy classes as target +languages don't have the same concepts of implicit conversions as C++. +Conversion operators either with or without explicit need renaming to a valid identifier name in order to make +them available as a normal proxy method. +

    + +

    7.2.16 Alias templates

    + + +

    +The following is an example of an alias template: + +

    +template< typename T1, typename T2, int >
    +class SomeType {
    +public:
    +  T1 a;
    +  T2 b;
    +  int c;
    +};
    +
    +template< typename T2 >
    +using TypedefName = SomeType<char*, T2, 5>;
    +
    + +

    +These are partially supported as SWIG will parse these and identify them, however, they are ignored as they are not added to the type system. A warning such as the following is issued: +

    + +
    +
    +example.i:13: Warning 342: The 'using' keyword in template aliasing is not fully supported yet.
    +
    +
    + +

    +Similarly for non-template type aliasing: +

    + +
    +using PFD = void (*)(double); // New introduced syntax
    +
    + +

    +A warning will be issued: +

    + +
    +
    +example.i:17: Warning 341: The 'using' keyword in type aliasing is not fully supported yet.
    +
    +
    + + +

    The equivalent old style typedefs can be used as a workaround:

    + +
    +typedef void (*PFD)(double);  // The old style
    +
    + +

    7.2.17 Unrestricted unions

    + + +

    SWIG fully supports any type inside a union even if it does not +define a trivial constructor. For example, the wrapper for the following +code correctly provides access to all members in the union:

    + +
    +struct point {
    +  point() {}
    +  point(int x, int y) : x_(x), y_(y) {}
    +  int x_, y_;
    +};
    +
    +#include <new> // For placement 'new' in the constructor below
    +union P {
    +  int z;
    +  double w;
    +  point p; // Illegal in C++03; legal in C++11.
    +  // Due to the point member, a constructor definition is required.
    +  P() {
    +    new(&p) point();
    +  }
    +} p1;
    +
    + +

    7.2.18 Variadic templates

    + + +

    SWIG supports the variadic templates syntax (inside the <> +block, variadic class inheritance and variadic constructor and +initializers) with some limitations. The following code is correctly parsed:

    + +
    +template <typename... BaseClasses> class ClassName : public BaseClasses... {
    +public:
    +   ClassName (BaseClasses &&... baseClasses) : BaseClasses(baseClasses)... {}
    +}
    +
    + +

    +For now however, the %template directive only accepts one parameter substitution +for the variable template parameters. +

    + +
    +%template(MyVariant1) ClassName<>         // zero argument not supported yet
    +%template(MyVariant2) ClassName<int>      // ok
    +%template(MyVariant3) ClassName<int, int> // too many arguments not supported yet
    +
    + +

    Support for the variadic sizeof() function is correctly parsed:

    + +
    +const int SIZE = sizeof...(ClassName<int, int>);
    +
    + +

    +In the above example SIZE is of course wrapped as a constant. +

    + +

    7.2.19 New string literals

    + + +

    SWIG supports wide string and Unicode string constants and raw string literals.

    + +
    +// New string literals
    +wstring         aa =  L"Wide string";
    +const char     *bb = u8"UTF-8 string";
    +const char16_t *cc =  u"UTF-16 string";
    +const char32_t *dd =  U"UTF-32 string";
    +
    +// Raw string literals
    +const char      *xx =        ")I'm an \"ascii\" \\ string.";
    +const char      *ee =   R"XXX()I'm an "ascii" \ string.)XXX"; // same as xx
    +wstring          ff =  LR"XXX(I'm a "raw wide" \ string.)XXX";
    +const char      *gg = u8R"XXX(I'm a "raw UTF-8" \ string.)XXX";
    +const char16_t  *hh =  uR"XXX(I'm a "raw UTF-16" \ string.)XXX";
    +const char32_t  *ii =  UR"XXX(I'm a "raw UTF-32" \ string.)XXX";
    +
    + +

    +Non-ASCII string support varies quite a bit among the various target languages though. +

    + +

    +Note: There is a bug currently where SWIG's preprocessor incorrectly parses an odd number of double quotes +inside raw string literals. +

    + +

    7.2.20 User-defined literals

    + + +

    +SWIG parses the declaration of user-defined literals, that is, the operator "" _mysuffix() function syntax. +

    + +

    +Some examples are the raw literal: +

    +
    +OutputType operator "" _myRawLiteral(const char * value);
    +
    + +

    +numeric cooked literals: +

    +
    +OutputType operator "" _mySuffixIntegral(unsigned long long);
    +OutputType operator "" _mySuffixFloat(long double);
    +
    + +

    +and cooked string literals: +

    +
    +OutputType operator "" _mySuffix(const char * string_values, size_t num_chars);
    +OutputType operator "" _mySuffix(const wchar_t * string_values, size_t num_chars);
    +OutputType operator "" _mySuffix(const char16_t * string_values, size_t num_chars);
    +OutputType operator "" _mySuffix(const char32_t * string_values, size_t num_chars);
    +
    + +

    +Like other operators that SWIG parses, a warning is given about renaming the operator in order for it to be wrapped: +

    + +
    +example.i:27: Warning 503: Can't wrap 'operator "" _myRawLiteral' unless renamed to a valid identifier.
    +
    + +

    +If %rename is used, then it can be called like any other wrapped method. +Currently you need to specify the full declaration including parameters for %rename: +

    + +
    +%rename(MyRawLiteral)  operator"" _myRawLiteral(const char * value);
    +
    + +

    +Or if you just wish to ignore it altogether: +

    + +
    +%ignore operator "" _myRawLiteral(const char * value);
    +
    + +

    +Note that use of user-defined literals such as the following still give a syntax error: +

    + +
    +OutputType var1 = "1234"_suffix;
    +OutputType var2 = 1234_suffix;
    +OutputType var3 = 3.1416_suffix;
    +
    + +

    7.2.21 Thread-local storage

    + + +

    SWIG correctly parses the thread_local keyword. For example, variables +reachable by the current thread can be defined as:

    + +
    +struct A {
    +   static thread_local int val;
    +};
    +thread_local int global_val;
    +
    + +

    +The use of the thread_local storage specifier does not affect the wrapping process; it does not modify +the wrapper code compared to when it is not specified. +A variable will be thread local if accessed from different threads from the target language in the +same way that it will be thread local if accessed from C++ code. +

    + +

    7.2.22 Explicitly defaulted functions and deleted functions

    + + +

    SWIG handles explicitly defaulted functions, that is, = default added to a function declaration. Deleted definitions, which are also called deleted functions, have = delete added to the function declaration. +For example:

    + +
    +struct NonCopyable {
    +  NonCopyable & operator=(const NonCopyable &) = delete; /* Removes operator= */
    +  NonCopyable(const NonCopyable &) = delete;             /* Removes copy constructor */
    +  NonCopyable() = default;                               /* Explicitly allows the empty constructor */
    +};
    +
    + +

    +Wrappers for deleted functions will not be available in the target language. +Wrappers for defaulted functions will of course be available in the target language. +Explicitly defaulted functions have no direct effect for SWIG wrapping as the declaration is handled +much like any other method declaration parsed by SWIG. +

    + +

    +Deleted functions are also designed to prevent implicit conversions when calling the function. +For example, the C++ compiler will not compile any code which attempts to use an int as the type of the parameter passed to f below: +

    + +
    +struct NoInt {
    +    void f(double i);
    +    void f(int) = delete;
    +};
    +
    + +

    +This is a C++ compile time check and SWIG does not make any attempt to detect if the target language is using an int instead of a double though, +so in this case it is entirely possible to pass an int instead of a double to f from Java, Python etc. +

    + +

    7.2.23 Type long long int

    + + +

    SWIG correctly parses and uses the new long long type already introduced in C99 some time ago.

    + +

    7.2.24 Static assertions

    + + +

    +SWIG correctly parses the new static_assert declarations. +This is a C++ compile time directive so there isn't anything useful that SWIG can do with it. +

    + +
    +template <typename T>
    +struct Check {
    +  static_assert(sizeof(int) <= sizeof(T), "not big enough");
    +};
    +
    + +

    7.2.25 Allow sizeof to work on members of classes without an explicit object

    + + +

    +SWIG can parse the new sizeof() on types as well as on objects. For example: +

    + +
    +struct A {
    +  int member;
    +};
    +
    +const int SIZE = sizeof(A::member); // does not work with C++03. Okay with C++11
    +
    + +

    In Python:

    +
    +>>> SIZE
    +8
    +
    + +

    7.2.26 Exception specifications and noexcept

    + + +

    +C++11 added in the noexcept specification to exception specifications to indicate that a function simply may or may not throw an exception, without actually naming any exception. +SWIG understands these, although there isn't any useful way that this information can be taken advantage of by target languages, +so it is as good as ignored during the wrapping process. +Below are some examples of noexcept in function declarations: +

    + +
    +static void noex1() noexcept;
    +int noex2(int) noexcept(true);
    +int noex3(int, bool) noexcept(false);
    +
    + +

    7.2.27 Control and query object alignment

    + + +

    +An alignof operator is used mostly within C++ to return alignment in number of bytes, but could be used to initialize a variable as shown below. +The variable's value will be available for access by the target language as any other variable's compile time initialised value. + +

    +const int align1 = alignof(A::member);
    +
    + +

    +The alignas specifier for variable alignment is not yet supported. +Example usage: +

    + +
    +struct alignas(16) S {
    +  int num;
    +};
    +alignas(double) unsigned char c[sizeof(double)];
    +
    + +

    +Use the preprocessor to work around this for now: +

    + +
    +#define alignas(T)
    +
    + + +

    7.2.28 Attributes

    + + +

    +Attributes such as those shown below, are not yet supported and will give a syntax error. +

    + +
    +int [[attr1]] i [[attr2, attr3]];
    +
    +[[noreturn, nothrow]] void f [[noreturn]] ();
    +
    + +

    7.3 Standard library changes

    + + +

    7.3.1 Threading facilities

    + + +

    SWIG does not currently wrap or use any of the new threading +classes introduced (thread, mutex, locks, condition variables, task). The main reason is that +SWIG target languages offer their own threading facilities so there is limited use for them. +

    + +

    7.3.2 Tuple types

    + + +

    +SWIG does not provide library files for the new tuple types yet. +Variadic template support requires further work to provide substantial tuple wrappers. +

    + +

    7.3.3 Hash tables

    + + +

    +The new hash tables in the STL are unordered_set, unordered_multiset, unordered_map, unordered_multimap. +These are not available in SWIG, but in principle should be easily implemented by adapting the current STL containers. +

    + +

    7.3.4 Regular expressions

    + + +

    +While SWIG could provide wrappers for the new C++11 regular expressions classes, there is little need as the target languages have their own regular expression facilities. +

    + +

    7.3.5 General-purpose smart pointers

    + + +

    +SWIG provides special smart pointer handling for std::shared_ptr in the same way it has support for boost::shared_ptr. +Please see the shared_ptr smart pointer library section. +There is no special smart pointer handling available for std::weak_ptr and std::unique_ptr yet. +

    + +

    7.3.6 Extensible random number facility

    + + +

    This feature extends and standardizes the standard library only and does not effect the C++ language nor SWIG.

    + +

    7.3.7 Wrapper reference

    + + +

    +Wrapper references are similar to normal C++ references but are copy-constructible and copy-assignable. +They could conceivably be used in public APIs. +There is no special support for std::reference_wrapper in SWIG though. +Users would need to write their own typemaps if wrapper references are being used and these would be similar to the plain C++ reference typemaps. +

    + + +

    7.3.8 Polymorphous wrappers for function objects

    + + +

    +SWIG supports functor classes in a few languages in a very natural way. +However nothing is provided yet for the new std::function template. +SWIG will parse usage of the template like any other template. +

    + +
    +%rename(__call__) Test::operator(); // Default renaming used for Python
    +
    +struct Test {
    +  bool operator()(int x, int y); // function object
    +};
    +
    +#include <functional>
    +std::function<void (int, int)> pF = Test;   // function template wrapper
    +
    +
    + +

    +Example of supported usage of the plain functor from Python is shown below. +It does not involve std::function. +

    + +
    +t = Test()
    +b = t(1,2) # invoke C++ function object
    +
    + +

    7.3.9 Type traits for metaprogramming

    + + +

    The type_traits functions to support C++ metaprogramming is useful at compile time and is aimed specifically at C++ development:

    + +
    +#include <type_traits>
    +
    +// First way of operating.
    +template< bool B > struct algorithm {
    +  template< class T1, class T2 > static int do_it(T1 &, T2 &)  { /*...*/ return 1; }
    +};
    +
    +// Second way of operating.
    +template<> struct algorithm<true> {
    +  template< class T1, class T2 > static int do_it(T1, T2)  { /*...*/ return 2; }
    +};
    +
    +// Instantiating 'elaborate' will automatically instantiate the correct way to operate, depending on the types used.
    +template< class T1, class T2 > int elaborate(T1 A, T2 B) {
    +  // Use the second way only if 'T1' is an integer and if 'T2' is a floating point,
    +  // otherwise use the first way.
    +  return algorithm< std::is_integral<T1>::value && std::is_floating_point<T2>::value >::do_it(A, B);
    +}
    +
    + +

    +SWIG correctly parses the template specialization, template types etc. +However, metaprogramming and the additional support in the type_traits header is really for compile time and is not much use at runtime for the target languages. +For example, as SWIG requires explicit instantiation of templates via %template, there isn't much that std::is_integral<int> is going to provide by itself. +However, template functions using such metaprogramming techniques might be useful to wrap. +For example, the following instantiations could be made: +

    + +
    +%template(Elaborate) elaborate<int, int>;
    +%template(Elaborate) elaborate<int, double>;
    +
    + +

    +Then the appropriate algorithm can be called for the subset of types given by the above %template instantiations from a target language, such as Python: +

    + +
    +>>> Elaborate(0, 0)
    +1
    +>>> Elaborate(0, 0.0)
    +2
    +
    + +

    7.3.10 Uniform method for computing return type of function objects

    + + +

    +The new std::result_of class introduced in the <functional> header provides a generic way to obtain the return type of a function type via std::result_of::type. +There isn't any library interface file to support this type. +With a bit of work, SWIG will deduce the return type of functions when used in std::result_of using the approach shown below. +The technique basically forward declares the std::result_of template class, then partially specializes it for the function types of interest. +SWIG will use the partial specialization and hence correctly use the std::result_of::type provided in the partial specialization. +

    + +
    +%inline %{
    +#include <functional>
    +typedef double(*fn_ptr)(double);
    +%}
    +
    +namespace std {
    +  // Forward declaration of result_of
    +  template<typename Func> struct result_of;
    +  // Add in a partial specialization of result_of
    +  template<> struct result_of< fn_ptr(double) > {
    +    typedef double type;
    +  };
    +}
    +
    +%template() std::result_of< fn_ptr(double) >;
    +
    +%inline %{
    +
    +double square(double x) {
    +  return (x * x);
    +}
    +
    +template<class Fun, class Arg>
    +typename std::result_of<Fun(Arg)>::type test_result_impl(Fun fun, Arg arg) {
    +  return fun(arg);
    +}
    +%}
    +
    +%template(test_result) test_result_impl< fn_ptr, double >;
    +%constant double (*SQUARE)(double) = square;
    +
    + +

    +Note the first use of %template which SWIG requires to instantiate the template. +The empty template instantiation suffices as no proxy class is required for std::result_of<Fun(Arg)>::type as this type is really just a double. +The second %template instantiates the template function which is being wrapped for use as a callback. +The %constant can then be used for any callback function as described in Pointers to functions and callbacks. +

    + +

    +Example usage from Python should give the not too surprising result: +

    + +
    +>>> test_result(SQUARE, 5.0)
    +25.0
    +
    + +

    +Phew, that is a lot of hard work to get a callback working. +You could just go with the more attractive option of just using double as the return type in the function declaration instead of result_of! +

    + + + diff --git a/Doc/Manual/CSharp.html b/Doc/Manual/CSharp.html index 6df2594..26f0c74 100644 --- a/Doc/Manual/CSharp.html +++ b/Doc/Manual/CSharp.html @@ -1,15 +1,20 @@ - + SWIG and C# + -

    19 SWIG and C#

    +

    20 SWIG and C#

  • Multiples modules +
  • Multiple modules
  • C# Typemap examples
    • Memory management when returning references to member variables @@ -49,7 +54,7 @@ -

      19.1 Introduction

      +

      20.1 Introduction

      @@ -66,10 +71,70 @@ SWIG C# works equally well on non-Microsoft operating systems such as Linux, Sol

      To get the most out of this chapter an understanding of interop is required. The Microsoft Developer Network (MSDN) has a good reference guide in a section titled "Interop Marshaling". -Monodoc, available from the Mono project, has a very useful section titled Interop with native libraries. +Monodoc, available from the Mono project, has a very useful section titled Interop with native libraries. +

      + +

      20.1.1 SWIG 2 Compatibility

      + + +

      +In order to minimize name collisions between names generated based on input to SWIG and names used in the generated code from the .NET framework, SWIG 3 fully qualifies the use of all .NET types. Furthermore, SWIG 3 avoids using directives in generated code. This breaks backwards compatibility with typemaps, pragmas, etc written for use with SWIG 2 that assume the presence of using System; or using System.Runtime.InteropServices; directives in the intermediate class imports, module imports, or proxy imports. SWIG 3 supports backwards compatibility though the use of the SWIG2_CSHARP macro. If SWIG2_CSHARP is defined, SWIG 3 generates using directives in the intermediate class, module class, and proxy class code similar to those generated by SWIG 2. This can be done without modifying any of the input code by passing the -DSWIG2_CSHARP commandline parameter when executing swig. +

      + + +

      20.1.2 Additional command line options

      + + +

      +The following table lists the additional commandline options available for the C# module. They can also be seen by using: +

      + +
      +swig -csharp -help 
      +
      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      C# specific options
      -dllimport <dl>Override DllImport attribute name to <dl>
      -namespace <nm>Generate wrappers into C# namespace <nm>
      -noproxyGenerate the low-level functional interface instead of proxy classes
      -oldvarnamesOld intermediary method names for variable wrappers
      -outfile <file>Write all C# into a single <file> located in the output directory +
      + +

      +The -outfile option combines all the generated C# code into a single output file instead of creating multiple C# files. +The default, when this option is not provided, is to generate separate .cs files for the module class, +intermediary class and each of the generated proxy and type wrapper classes. +Note that the file extension (.cs) will not be automatically added and needs to be provided. +Due to possible compiler limits it is not advisable to use -outfile for large projects.

      -

      19.2 Differences to the Java module

      +

      20.2 Differences to the Java module

      @@ -168,6 +233,7 @@ javabody -> csbody javafinalize -> csfinalize javadestruct -> csdestruct javadestruct_derived -> csdestruct_derived +javainterfacecode -> csinterfacecode

  • @@ -235,6 +301,9 @@ $*javaclassname -> $*csclassname $javaclazzname -> $csclazzname $javainput -> $csinput $jnicall -> $imcall +$javainterfacename -> $csinterfacename +$&javainterfacename -> $&csinterfacename +$*javainterfacename -> $*csinterfacename @@ -262,7 +331,7 @@ An example shows that char * could be marshalled in different ways,
    -%typemap(imtype, out="IntPtr") char * "string"
    +%typemap(imtype, out="global::System.IntPtr") char * "string"
     char * function(char *);
     
    @@ -273,7 +342,7 @@ The output type is thus IntPtr and the input type is string. The resulting inter
    -public static extern IntPtr function(string jarg1);
    +public static extern global::System.IntPtr function(string jarg1);
     
    @@ -294,8 +363,8 @@ For example:
     %typemap(imtype,
    -         inattributes="[MarshalAs(UnmanagedType.LPStr)]",
    -         outattributes="[return: MarshalAs(UnmanagedType.LPStr)]") const char * "String"
    +         inattributes="[global::System.Runtime.InteropServices.MarshalAs(UnmanagedType.LPStr)]",
    +         outattributes="[return: global::System.Runtime.InteropServices.MarshalAs(UnmanagedType.LPStr)]") const char * "String"
     
     const char * GetMsg() {}
     void SetMsg(const char *msg) {}
    @@ -310,12 +379,12 @@ The intermediary class will then have the marshalling as specified by everything
     
     class examplePINVOKE {
       ...
    -  [DllImport("example", EntryPoint="CSharp_GetMsg")]
    -  [return: MarshalAs(UnmanagedType.LPStr)]
    +  [global::System.Runtime.InteropServices.DllImport("example", EntryPoint="CSharp_GetMsg")]
    +  [return: global::System.Runtime.InteropServices.MarshalAs(UnmanagedType.LPStr)]
       public static extern String GetMsg();
     
    -  [DllImport("example", EntryPoint="CSharp_SetMsg")]
    -  public static extern void SetMsg([MarshalAs(UnmanagedType.LPStr)]String jarg1);
    +  [global::System.Runtime.InteropServices.DllImport("example", EntryPoint="CSharp_SetMsg")]
    +  public static extern void SetMsg([global::System.Runtime.InteropServices.MarshalAs(UnmanagedType.LPStr)]String jarg1);
     }
     
    @@ -368,7 +437,7 @@ will generate a C# proxy class:
     [ThreadSafe]
    -public class AClass : IDisposable {
    +public class AClass : global::System.IDisposable {
       ...
       [ThreadSafe(false)]
       public AClass(double a) ...
    @@ -392,9 +461,9 @@ An example for attaching attributes to the enum and enum values is shown below.
     
     
    -%typemap(csattributes) Couleur "[System.ComponentModel.Description(\"Colours\")]"
    -%csattributes Rouge "[System.ComponentModel.Description(\"Red\")]"
    -%csattributes Vert "[System.ComponentModel.Description(\"Green\")]"
    +%typemap(csattributes) Couleur "[global::System.ComponentModel.Description(\"Colours\")]"
    +%csattributes Rouge "[global::System.ComponentModel.Description(\"Red\")]"
    +%csattributes Vert "[global::System.ComponentModel.Description(\"Green\")]"
     %inline %{
       enum Couleur { Rouge, Orange, Vert };
     %}
    @@ -407,12 +476,12 @@ which will result in the following C# enum:
     
     
    -[System.ComponentModel.Description("Colours")]
    +[global::System.ComponentModel.Description("Colours")]
     public enum Couleur {
    -  [System.ComponentModel.Description("Red")]
    +  [global::System.ComponentModel.Description("Red")]
       Rouge,
       Orange,
    -  [System.ComponentModel.Description("Green")]
    +  [global::System.ComponentModel.Description("Green")]
       Vert
     }
     
    @@ -482,7 +551,7 @@ Windows users can also get the examples working using a Cygwin or MinGW environment for automatic configuration of the example makefiles. Any one of the three C# compilers (Portable.NET, Mono or Microsoft) can be detected from within a Cygwin or Mingw environment if installed in your path. -

    19.3 Void pointers

    +

    20.3 Void pointers

    @@ -500,7 +569,7 @@ void * f(void *v);

    -

    19.4 C# Arrays

    +

    20.4 C# Arrays

    @@ -512,7 +581,7 @@ with one of the following three approaches; namely the SWIG C arrays library, P/ pinned arrays.

    -

    19.4.1 The SWIG C arrays library

    +

    20.4.1 The SWIG C arrays library

    @@ -549,7 +618,7 @@ example.print_array(c.cast()); // Pass to C

    -

    19.4.2 Managed arrays using P/Invoke default array marshalling

    +

    20.4.2 Managed arrays using P/Invoke default array marshalling

    @@ -618,9 +687,9 @@ marshalling for the arrays:

    -[DllImport("example", EntryPoint="CSharp_myArrayCopy")]
    -public static extern void myArrayCopy([In, MarshalAs(UnmanagedType.LPArray)]int[] jarg1, 
    -                                      [Out, MarshalAs(UnmanagedType.LPArray)]int[] jarg2,
    +[global::System.Runtime.InteropServices.DllImport("example", EntryPoint="CSharp_myArrayCopy")]
    +public static extern void myArrayCopy([global::System.Runtime.InteropServices.In, global::System.Runtime.InteropServices.MarshalAs(UnmanagedType.LPArray)]int[] jarg1, 
    +                                      [global::System.Runtime.InteropServices.Out, global::System.Runtime.InteropServices.MarshalAs(UnmanagedType.LPArray)]int[] jarg2,
                                            int jarg3);
     
    @@ -668,15 +737,15 @@ and intermediary class method
    -  [DllImport("example", EntryPoint="CSharp_myArraySwap")]
    -  public static extern void myArraySwap([In, Out, MarshalAs(UnmanagedType.LPArray)]int[] jarg1, 
    -                                        [In, Out, MarshalAs(UnmanagedType.LPArray)]int[] jarg2,
    +  [global::System.Runtime.InteropServices.DllImport("example", EntryPoint="CSharp_myArraySwap")]
    +  public static extern void myArraySwap([global::System.Runtime.InteropServices.In, global::System.Runtime.InteropServices.Out, global::System.Runtime.InteropServices.MarshalAs(UnmanagedType.LPArray)]int[] jarg1, 
    +                                        [global::System.Runtime.InteropServices.In, global::System.Runtime.InteropServices.Out, global::System.Runtime.InteropServices.MarshalAs(UnmanagedType.LPArray)]int[] jarg2,
                                              int jarg3);
     
    -

    19.4.3 Managed arrays using pinning

    +

    20.4.3 Managed arrays using pinning

    @@ -743,7 +812,7 @@ As a result, we get the following method in the module class: fixed ( int *swig_ptrTo_sourceArray = sourceArray ) { fixed ( int *swig_ptrTo_targetArray = targetArray ) { { - examplePINVOKE.myArrayCopy((IntPtr)swig_ptrTo_sourceArray, (IntPtr)swig_ptrTo_targetArray, + examplePINVOKE.myArrayCopy((global::System.IntPtr)swig_ptrTo_sourceArray, (global::System.IntPtr)swig_ptrTo_targetArray, nitems); } } @@ -764,14 +833,14 @@ example - the method is expecting an IntPtr as the parameter type.

    -[DllImport("example", EntryPoint="CSharp_myArrayCopy")]
    -public static extern void myArrayCopy(IntPtr jarg1, IntPtr jarg2, int jarg3);
    +[global::System.Runtime.InteropServices.DllImport("example", EntryPoint="CSharp_myArrayCopy")]
    +public static extern void myArrayCopy(global::System.IntPtr jarg1, global::System.IntPtr jarg2, int jarg3);
     
    -

    19.5 C# Exceptions

    +

    20.5 C# Exceptions

    @@ -868,11 +937,11 @@ set so should only be used when a C# exception is not created.

    -

    19.5.1 C# exception example using "check" typemap

    +

    20.5.1 C# exception example using "check" typemap

    -Lets say we have the following simple C++ method: +Let's say we have the following simple C++ method:

    @@ -1050,7 +1119,7 @@ method and C# code does not handle pending exceptions via the canthrow attribute Actually it will issue this warning for any function beginning with SWIG_CSharpSetPendingException.

    -

    19.5.2 C# exception example using %exception

    +

    20.5.2 C# exception example using %exception

    @@ -1065,6 +1134,7 @@ try { $action } catch (std::out_of_range e) { SWIG_CSharpSetPendingException(SWIG_CSharpApplicationException, e.what()); + return $null; } %} @@ -1115,7 +1185,7 @@ The managed code generated does check for the pending exception as mentioned ear -

    19.5.3 C# exception example using exception specifications

    +

    20.5.3 C# exception example using exception specifications

    @@ -1172,7 +1242,7 @@ SWIGEXPORT void SWIGSTDCALL CSharp_evensonly(int jarg1) { Multiple catch handlers are generated should there be more than one exception specifications declared.

    -

    19.5.4 Custom C# ApplicationException example

    +

    20.5.4 Custom C# ApplicationException example

    @@ -1220,7 +1290,7 @@ the C# code can be generated into the intermediary class using the imclassco static CustomExceptionDelegate customDelegate = new CustomExceptionDelegate(SetPendingCustomException); - [DllImport("$dllimport", EntryPoint="CustomExceptionRegisterCallback")] + [global::System.Runtime.InteropServices.DllImport("$dllimport", EntryPoint="CustomExceptionRegisterCallback")] public static extern void CustomExceptionRegisterCallback(CustomExceptionDelegate customCallback); @@ -1264,7 +1334,7 @@ The boiler plate code above must be used in addition to a handcrafted Custom

     // Custom C# Exception
    -class CustomApplicationException : System.ApplicationException {
    +class CustomApplicationException : global::System.ApplicationException {
       public CustomApplicationException(string message) 
         : base(message) {
       }
    @@ -1306,7 +1376,7 @@ try {
     
    -

    19.6 C# Directors

    +

    20.6 C# Directors

    @@ -1319,7 +1389,7 @@ The following sections provide information on the C# director implementation and However, the Java directors section should also be read in order to gain more insight into directors.

    -

    19.6.1 Directors example

    +

    20.6.1 Directors example

    @@ -1440,7 +1510,7 @@ CSharpDerived - UIntMethod(123) -

    19.6.2 Directors implementation

    +

    20.6.2 Directors implementation

    @@ -1457,20 +1527,17 @@ Below is the generated C# Base director class.

    -using System;
    -using System.Runtime.InteropServices;
    -
    -public class Base : IDisposable {
    -  private HandleRef swigCPtr;
    +public class Base : global::System.IDisposable {
    +  private global::System.Runtime.InteropServices.HandleRef swigCPtr;
       protected bool swigCMemOwn;
     
    -  internal Base(IntPtr cPtr, bool cMemoryOwn) {
    +  internal Base(global::System.IntPtr cPtr, bool cMemoryOwn) {
         swigCMemOwn = cMemoryOwn;
    -    swigCPtr = new HandleRef(this, cPtr);
    +    swigCPtr = new global::System.Runtime.InteropServices.HandleRef(this, cPtr);
       }
     
    -  internal static HandleRef getCPtr(Base obj) {
    -    return (obj == null) ? new HandleRef(null, IntPtr.Zero) : obj.swigCPtr;
    +  internal static global::System.Runtime.InteropServices.HandleRef getCPtr(Base obj) {
    +    return (obj == null) ? new global::System.Runtime.InteropServices.HandleRef(null, global::System.IntPtr.Zero) : obj.swigCPtr;
       }
     
       ~Base() {
    @@ -1479,12 +1546,12 @@ public class Base : IDisposable {
     
       public virtual void Dispose() {
         lock(this) {
    -      if(swigCPtr.Handle != IntPtr.Zero && swigCMemOwn) {
    +      if(swigCPtr.Handle != global::System.IntPtr.Zero && swigCMemOwn) {
             swigCMemOwn = false;
             examplePINVOKE.delete_Base(swigCPtr);
           }
    -      swigCPtr = new HandleRef(null, IntPtr.Zero);
    -      GC.SuppressFinalize(this);
    +      swigCPtr = new global::System.Runtime.InteropServices.HandleRef(null, global::System.IntPtr.Zero);
    +      global::System.GC.SuppressFinalize(this);
         }
       }
     
    @@ -1511,7 +1578,7 @@ public class Base : IDisposable {
         examplePINVOKE.Base_director_connect(swigCPtr, swigDelegate0, swigDelegate1);
       }
     
    -  private bool SwigDerivedClassHasMethod(string methodName, Type[] methodTypes) {
    +  private bool SwigDerivedClassHasMethod(string methodName, global::System.global::System.Type[] methodTypes) {
         System.Reflection.MethodInfo methodInfo = this.GetType().GetMethod(methodName, methodTypes);
         bool hasDerivedMethod = methodInfo.DeclaringType.IsSubclassOf(typeof(Base));
         return hasDerivedMethod;
    @@ -1521,18 +1588,18 @@ public class Base : IDisposable {
         return UIntMethod(x);
       }
     
    -  private void SwigDirectorBaseBoolMethod(IntPtr b, bool flag) {
    +  private void SwigDirectorBaseBoolMethod(global::System.IntPtr b, bool flag) {
         BaseBoolMethod(new Base(b, false), flag);
       }
     
       internal delegate uint SwigDelegateBase_0(uint x);
    -  internal delegate void SwigDelegateBase_1(IntPtr b, bool flag);
    +  internal delegate void SwigDelegateBase_1(global::System.IntPtr b, bool flag);
     
       private SwigDelegateBase_0 swigDelegate0;
       private SwigDelegateBase_1 swigDelegate1;
     
    -  private static Type[] swigMethodTypes0 = new Type[] { typeof(uint) };
    -  private static Type[] swigMethodTypes1 = new Type[] { typeof(Base), typeof(bool) };
    +  private static global::System.Type[] swigMethodTypes0 = new global::System.Type[] { typeof(uint) };
    +  private static global::System.Type[] swigMethodTypes1 = new global::System.Type[] { typeof(Base), typeof(bool) };
     }
     
    @@ -1626,7 +1693,7 @@ void SwigDirector_Base::BaseBoolMethod(Base const &b, bool flag) { -

    19.6.3 Director caveats

    +

    20.6.3 Director caveats

    @@ -1674,11 +1741,11 @@ However, a call from C# to CSharpDefaults.DefaultMethod() will of cours should pass the call on to CSharpDefaults.DefaultMethod(int)using the C++ default value, as shown above.

    -

    19.7 Multiples modules

    +

    20.7 Multiple modules

    -When using multiple modules it is is possible to compile each SWIG generated wrapper +When using multiple modules it is is possible to compile each SWIG generated wrapper into a different assembly. However, by default the generated code may not compile if generated classes in one assembly use generated classes in another assembly. @@ -1709,7 +1776,7 @@ the [System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrows if you don't want users to easily stumble upon these so called 'internal workings' of the wrappers.

    -

    19.8 C# Typemap examples

    +

    20.8 C# Typemap examples

    This section includes a few examples of typemaps. For more examples, you @@ -1717,7 +1784,7 @@ might look at the files "csharp.swg" and "typemaps.i" in the SWIG library. -

    19.8.1 Memory management when returning references to member variables

    +

    20.8.1 Memory management when returning references to member variables

    @@ -1755,9 +1822,9 @@ and the following usage from C# after running the code through SWIG: Wheel wheel = new Bike(10).getWheel(); Console.WriteLine("wheel size: " + wheel.size); // Simulate a garbage collection - System.GC.Collect(); - System.GC.WaitForPendingFinalizers(); - Console.WriteLine("wheel size: " + wheel.size); + global::System.GC.Collect(); + global::System.GC.WaitForPendingFinalizers(); + global::System.Console.WriteLine("wheel size: " + wheel.size); @@ -1795,9 +1862,9 @@ is called using the following typemaps. // of dangling C++ pointer. Intended for methods that return pointers or // references to a member variable. %typemap(csout, excode=SWIGEXCODE) Wheel& getWheel { - IntPtr cPtr = $imcall;$excode + global::System.IntPtr cPtr = $imcall;$excode $csclassname ret = null; - if (cPtr != IntPtr.Zero) { + if (cPtr != global::System.IntPtr.Zero) { ret = new $csclassname(cPtr, $owner); ret.addReference(this); } @@ -1813,7 +1880,7 @@ The code in the second typemap constitutes the bulk of the code in the generated

    -public class Wheel : IDisposable {
    +public class Wheel : global::System.IDisposable {
       ...
       // Ensure that the GC doesn't collect any Bike instance set from C#
       private Bike bikeReference;
    @@ -1822,12 +1889,12 @@ public class Wheel : IDisposable {
       }
     }
     
    -public class Bike : IDisposable {
    +public class Bike : global::System.IDisposable {
       ...
       public Wheel getWheel() {
    -    IntPtr cPtr = examplePINVOKE.Bike_getWheel(swigCPtr);
    +    global::System.IntPtr cPtr = examplePINVOKE.Bike_getWheel(swigCPtr);
         Wheel ret = null;
    -    if (cPtr != IntPtr.Zero) {
    +    if (cPtr != global::System.IntPtr.Zero) {
           ret = new Wheel(cPtr, false);
           ret.addReference(this);
         }
    @@ -1841,7 +1908,7 @@ public class Bike : IDisposable {
     Note the addReference call.
     

    -

    19.8.2 Memory management for objects passed to the C++ layer

    +

    20.8.2 Memory management for objects passed to the C++ layer

    @@ -1904,9 +1971,9 @@ In order to understand why, consider a garbage collection occuring... container.setElement(element); Console.WriteLine("element.value: " + container.getElement().value); // Simulate a garbage collection - System.GC.Collect(); - System.GC.WaitForPendingFinalizers(); - Console.WriteLine("element.value: " + container.getElement().value); + global::System.GC.Collect(); + global::System.GC.WaitForPendingFinalizers(); + global::System.Console.WriteLine("element.value: " + container.getElement().value);

    @@ -1918,14 +1985,14 @@ One solution is to add in the appropriate references in the C# layer...
    -public class Container : IDisposable {
    +public class Container : global::System.IDisposable {
     
       ...
     
       // Ensure that the GC doesn't collect any Element set from C#
       // as the underlying C++ class stores a shallow copy
       private Element elementReference;
    -  private HandleRef getCPtrAndAddReference(Element element) {
    +  private global::System.Runtime.InteropServices.HandleRef getCPtrAndAddReference(Element element) {
         elementReference = element;
         return Element.getCPtr(element);
       }
    @@ -1951,7 +2018,7 @@ The 'cscode' typemap simply adds in the specified code into the C# proxy class.
       // Ensure that the GC doesn't collect any Element set from C#
       // as the underlying C++ class stores a shallow copy
       private Element elementReference;
    -  private HandleRef getCPtrAndAddReference(Element element) {
    +  private global::System.Runtime.InteropServices.HandleRef getCPtrAndAddReference(Element element) {
         elementReference = element;
         return Element.getCPtr(element);
       }
    @@ -1960,7 +2027,7 @@ The 'cscode' typemap simply adds in the specified code into the C# proxy class.
     
    -

    19.8.3 Date marshalling using the csin typemap and associated attributes

    +

    20.8.3 Date marshalling using the csin typemap and associated attributes

    @@ -2000,7 +2067,7 @@ First let's look at the code that is generated by default, where the C# proxy cl

    -public class Action : IDisposable {
    +public class Action : global::System.IDisposable {
       ...
       public Action(CDate dateIn, CDate dateOut) 
           : this(examplePINVOKE.new_Action(CDate.getCPtr(dateIn), CDate.getCPtr(dateOut)), true) {
    @@ -2081,7 +2148,7 @@ The resulting generated proxy code in the Action class follows:
     
     
    -public class Action : IDisposable {
    +public class Action : global::System.IDisposable {
       ...
       public int doSomething(System.DateTime dateIn, out System.DateTime dateOut) {
         CDate tempdateIn = new CDate(dateIn.Year, dateIn.Month, dateIn.Day);
    @@ -2099,7 +2166,7 @@ public class Action : IDisposable {
         }
       }
     
    -  static private IntPtr SwigConstructAction(System.DateTime dateIn, out System.DateTime dateOut) {
    +  static private global::System.IntPtr SwigConstructAction(System.DateTime dateIn, out System.DateTime dateOut) {
         CDate tempdateIn = new CDate(dateIn.Year, dateIn.Month, dateIn.Day);
         CDate tempdateOut = new CDate();
         try {
    @@ -2246,7 +2313,7 @@ public class example {
     
    -

    19.8.4 A date example demonstrating marshalling of C# properties

    +

    20.8.4 A date example demonstrating marshalling of C# properties

    @@ -2299,8 +2366,8 @@ The typemap type required is thus CDate *. Given that the previous sect %typemap(csvarout, excode=SWIGEXCODE2) CDate * %{ /* csvarout typemap code */ get { - IntPtr cPtr = $imcall; - CDate tempDate = (cPtr == IntPtr.Zero) ? null : new CDate(cPtr, $owner);$excode + global::System.IntPtr cPtr = $imcall; + CDate tempDate = (cPtr == global::System.IntPtr.Zero) ? null : new CDate(cPtr, $owner);$excode return new System.DateTime(tempDate.getYear(), tempDate.getMonth(), tempDate.getDay(), 0, 0, 0); } %} @@ -2322,8 +2389,8 @@ public class example { } /* csvarout typemap code */ get { - IntPtr cPtr = examplePINVOKE.ImportantDate_get(); - CDate tempDate = (cPtr == IntPtr.Zero) ? null : new CDate(cPtr, false); + global::System.IntPtr cPtr = examplePINVOKE.ImportantDate_get(); + CDate tempDate = (cPtr == global::System.IntPtr.Zero) ? null : new CDate(cPtr, false); return new System.DateTime(tempDate.getYear(), tempDate.getMonth(), tempDate.getDay(), 0, 0, 0); } @@ -2346,7 +2413,7 @@ Some points to note:

  • The 'csin' typemap has 'pre', 'post' and 'cshin' attributes, and these are all ignored in the property set. The code in these attributes must instead be replicated within the 'csvarin' typemap. The line creating the temp$csinput variable is such an example; it is identical to what is in the 'pre' attribute. -

    19.8.5 Date example demonstrating the 'pre' and 'post' typemap attributes for directors

    +

    20.8.5 Date example demonstrating the 'pre' and 'post' typemap attributes for directors

    @@ -2389,7 +2456,7 @@ The generated proxy class code will then contain the following wrapper for calli

     ...
    -  private void SwigDirectorsomeCallback(IntPtr date) {
    +  private void SwigDirectorsomeCallback(global::System.IntPtr date) {
         System.DateTime tempdate = new System.DateTime();
         try {
           someCallback(out tempdate);
    @@ -2408,7 +2475,7 @@ Pay special attention to the memory management issues, using these attributes.
     

    -

    19.8.6 Turning wrapped classes into partial classes

    +

    20.8.6 Turning wrapped classes into partial classes

    @@ -2432,7 +2499,7 @@ The default C# proxy class generated is:

    -public class ExtendMe : IDisposable {
    +public class ExtendMe : global::System.IDisposable {
       ...
       public int Part1() {
         ...
    @@ -2468,7 +2535,7 @@ The C# proxy class becomes a partial class:
     
     
    -public partial class ExtendMe : IDisposable {
    +public partial class ExtendMe : global::System.IDisposable {
       ...
       public int Part1() {
         ...
    @@ -2483,7 +2550,7 @@ You can then of course declare another part of the partial class elsewhere, for
     
     
    -public partial class ExtendMe : IDisposable {
    +public partial class ExtendMe : global::System.IDisposable {
       public int Part2() {
         return 2;
       }
    @@ -2508,7 +2575,7 @@ demonstrating that the class contains methods calling both unmanaged code - 
     The following example is an alternative approach to adding managed code to the generated proxy class.
     

    -

    19.8.7 Extending proxy classes with additional C# code

    +

    20.8.7 Extending proxy classes with additional C# code

    @@ -2535,7 +2602,7 @@ The generated C# proxy class will instead be:

    -public class ExtendMe : IDisposable {
    +public class ExtendMe : global::System.IDisposable {
       ...
       public int Part3() {
         return 3;
    @@ -2547,7 +2614,7 @@ public class ExtendMe : IDisposable {
     
    -

    19.8.8 Underlying type for enums

    +

    20.8.8 Underlying type for enums

    diff --git a/Doc/Manual/Chicken.html b/Doc/Manual/Chicken.html index 4e43b9b..820d01f 100644 --- a/Doc/Manual/Chicken.html +++ b/Doc/Manual/Chicken.html @@ -1,14 +1,14 @@ - - + SWIG and Chicken + -

    20 SWIG and Chicken

    +

    21 SWIG and Chicken

      @@ -55,10 +55,10 @@

        -
      1. generates portable C code
      2. -
      3. includes a customizable interpreter
      4. -
      5. links to C libraries with a simple Foreign Function Interface
      6. -
      7. supports full tail-recursion and first-class continuations
      8. +
      9. generates portable C code
      10. +
      11. includes a customizable interpreter
      12. +
      13. links to C libraries with a simple Foreign Function Interface
      14. +
      15. supports full tail-recursion and first-class continuations

      @@ -72,7 +72,7 @@

      -

      20.1 Preliminaries

      +

      21.1 Preliminaries

      @@ -89,7 +89,7 @@ directory for the basic steps to run SWIG CHICKEN.

      -

      20.1.1 Running SWIG in C mode

      +

      21.1.1 Running SWIG in C mode

      @@ -98,7 +98,7 @@

      -
      % swig -chicken example.i
      +
      % swig -chicken example.i

      @@ -122,7 +122,7 @@ object files and linked into your project.

      -

      20.1.2 Running SWIG in C++ mode

      +

      21.1.2 Running SWIG in C++ mode

      @@ -131,7 +131,7 @@

      -
      % swig -chicken -c++ example.i
      +
      % swig -chicken -c++ example.i

      @@ -142,7 +142,7 @@

      -
      % chicken example.scm -output-file oexample.c
      +
      % chicken example.scm -output-file oexample.c

      @@ -151,10 +151,10 @@ object files and linked into your project.

      -

      20.2 Code Generation

      +

      21.2 Code Generation

      -

      20.2.1 Naming Conventions

      +

      21.2.1 Naming Conventions

      @@ -170,16 +170,16 @@ %rename SWIG directive in the SWIG interface file.

      -

      20.2.2 Modules

      +

      21.2.2 Modules

      The name of the module must be declared one of two ways:

        -
      • Placing %module example in the SWIG interface - file.
      • -
      • Using -module example on the SWIG command - line.
      • +
      • Placing %module example in the SWIG interface + file.
      • +
      • Using -module example on the SWIG command + line.

      @@ -189,10 +189,10 @@

      CHICKEN will be able to access the module using the (declare - (uses modulename)) CHICKEN Scheme form. + (uses modulename)) CHICKEN Scheme form.

      -

      20.2.3 Constants and Variables

      +

      21.2.3 Constants and Variables

      @@ -200,10 +200,10 @@ the interface file:

        -
      1. #define MYCONSTANT1 ...
      2. -
      3. %constant int MYCONSTANT2 = ...
      4. -
      5. const int MYCONSTANT3 = ...
      6. -
      7. enum { MYCONSTANT4 = ... };
      8. +
      9. #define MYCONSTANT1 ...
      10. +
      11. %constant int MYCONSTANT2 = ...
      12. +
      13. const int MYCONSTANT3 = ...
      14. +
      15. enum { MYCONSTANT4 = ... };

      @@ -229,7 +229,7 @@ for info on how to apply the %feature.

      -

      20.2.4 Functions

      +

      21.2.4 Functions

      @@ -248,7 +248,7 @@ parameters). The return values can then be accessed with (call-with-values).

      -

      20.2.5 Exceptions

      +

      21.2.5 Exceptions

      The SWIG chicken module has support for exceptions thrown from @@ -290,16 +290,16 @@

    -

    20.3 TinyCLOS

    +

    21.3 TinyCLOS

    The author of TinyCLOS, Gregor Kiczales, describes TinyCLOS as: - "Tiny CLOS is a Scheme implementation of a `kernelized' CLOS, with a - metaobject protocol. The implementation is even simpler than - the simple CLOS found in `The Art of the Metaobject Protocol,' - weighing in at around 850 lines of code, including (some) - comments and documentation." + "Tiny CLOS is a Scheme implementation of a `kernelized' CLOS, with a + metaobject protocol. The implementation is even simpler than + the simple CLOS found in `The Art of the Metaobject Protocol,' + weighing in at around 850 lines of code, including (some) + comments and documentation."

    @@ -333,7 +333,7 @@

    -

    20.4 Linkage

    +

    21.4 Linkage

    @@ -354,7 +354,7 @@

    -

    20.4.1 Static binary or shared library linked at compile time

    +

    21.4.1 Static binary or shared library linked at compile time

    We can easily use csc to build a static binary.

    @@ -395,7 +395,7 @@ in which case the test script does not need to be linked with example.so. The t be run with csi.

    -

    20.4.2 Building chicken extension libraries

    +

    21.4.2 Building chicken extension libraries

    Building a shared library like in the above section only works if the library @@ -453,7 +453,7 @@ distributed and used by anyone, even if SWIG is not installed.

    See the Examples/chicken/egg directory in the SWIG source for an example that builds two eggs, one using the first method and one using the second method.

    -

    20.4.3 Linking multiple SWIG modules with TinyCLOS

    +

    21.4.3 Linking multiple SWIG modules with TinyCLOS

    Linking together multiple modules that share type information using the %import @@ -477,7 +477,7 @@ with (declare (uses ...)). To create an extension library or an egg, just create a module_load.scm file that (declare (uses ...)) all the modules.

    -

    20.5 Typemaps

    +

    21.5 Typemaps

    @@ -486,7 +486,7 @@ all the modules.

    Lib/chicken/chicken.swg.

    -

    20.6 Pointers

    +

    21.6 Pointers

    @@ -519,7 +519,7 @@ all the modules.

    type. flags is either zero or SWIG_POINTER_DISOWN (see below).

    -

    20.6.1 Garbage collection

    +

    21.6.1 Garbage collection

    If the owner flag passed to SWIG_NewPointerObj is 1, NewPointerObj will add a @@ -550,7 +550,7 @@ all the modules.

    must be called manually.

    -

    20.7 Unsupported features and known problems

    +

    21.7 Unsupported features and known problems

    -

    20.7.1 TinyCLOS problems with Chicken version <= 1.92

    +

    21.7.1 TinyCLOS problems with Chicken version <= 1.92

    In Chicken versions equal to or below 1.92, TinyCLOS has a limitation such that generic methods do not properly work on methods diff --git a/Doc/Manual/Contents.html b/Doc/Manual/Contents.html index 77280c8..7107384 100644 --- a/Doc/Manual/Contents.html +++ b/Doc/Manual/Contents.html @@ -1,10 +1,12 @@ - + SWIG Users Manual + +

    SWIG Users Manual

    @@ -142,8 +144,8 @@

  • Basic Type Handling
  • Global Variables
  • Constants -
  • A brief word about const -
  • A cautionary tale of char * +
  • A brief word about const +
  • A cautionary tale of char *
  • Pointers and complex objects
  • -

    7 Preprocessing

    +

    7 SWIG and C++11

    + + + + + +

    8 Preprocessing

    @@ -285,7 +341,7 @@
    -

    8 SWIG library

    +

    9 SWIG library

    -

    9 Argument Handling

    +

    10 Argument Handling

    @@ -343,7 +400,7 @@
    -

    10 Typemaps

    +

    11 Typemaps

    -

    11 Customization Features

    +

    12 Customization Features

    @@ -459,7 +518,7 @@
    -

    12 Contracts

    +

    13 Contracts

    @@ -472,7 +531,7 @@
    -

    13 Variable Length Arguments

    +

    14 Variable Length Arguments

    @@ -490,7 +549,7 @@
    -

    14 Warning Messages

    +

    15 Warning Messages

    @@ -518,7 +577,7 @@
    -

    15 Working with Modules

    +

    16 Working with Modules

    @@ -534,7 +593,7 @@
    -

    16 Using SWIG with ccache - ccache-swig(1) manpage

    +

    17 Using SWIG with ccache - ccache-swig(1) manpage

    @@ -560,7 +619,7 @@
    -

    17 SWIG and Allegro Common Lisp

    +

    18 SWIG and Allegro Common Lisp

    @@ -644,7 +703,7 @@
    -

    18 SWIG and Android

    +

    19 SWIG and Android

    @@ -662,12 +721,16 @@
    -

    19 SWIG and C#

    +

    20 SWIG and C#

    -

    20 SWIG and Chicken

    +

    21 SWIG and Chicken

    @@ -743,7 +806,7 @@
    -

    21 SWIG and D

    +

    22 SWIG and D

    -

    22 SWIG and Go

    +

    23 SWIG and Go

    -

    23 SWIG and Guile

    +

    24 SWIG and Guile

    @@ -843,7 +919,7 @@
    -

    24 SWIG and Java

    +

    25 SWIG and Java

    -

    25 SWIG and Common Lisp

    +

    26 SWIG and Javascript

    + + + + + +

    27 SWIG and Common Lisp

    @@ -1010,7 +1134,7 @@
    -

    26 SWIG and Lua

    +

    28 SWIG and Lua

    -

    27 SWIG and Modula-3

    +

    29 SWIG and Modula-3

    @@ -1107,7 +1240,7 @@
    -

    28 SWIG and MzScheme/Racket

    +

    30 SWIG and MzScheme/Racket

    @@ -1119,7 +1252,7 @@
    -

    29 SWIG and Ocaml

    +

    31 SWIG and Ocaml

    -

    30 SWIG and Octave

    +

    32 SWIG and Octave

    -

    31 SWIG and Perl5

    +

    33 SWIG and Perl5

    -

    32 SWIG and PHP

    +

    34 SWIG and PHP

    -

    33 SWIG and Pike

    +

    35 SWIG and Pike

    @@ -1337,7 +1484,7 @@
    -

    34 SWIG and Python

    +

    36 SWIG and Python

    -

    35 SWIG and R

    +

    37 SWIG and R

    @@ -1463,7 +1631,7 @@
    -

    36 SWIG and Ruby

    +

    38 SWIG and Ruby

    -

    37 SWIG and Tcl

    +

    39 SWIG and Scilab

    + + + + + +

    40 SWIG and Tcl

    @@ -1663,7 +1904,7 @@
    -

    38 Extending SWIG to support new languages

    +

    41 Extending SWIG to support new languages

    diff --git a/Doc/Manual/Contract.html b/Doc/Manual/Contract.html index de390fb..4b49958 100644 --- a/Doc/Manual/Contract.html +++ b/Doc/Manual/Contract.html @@ -1,12 +1,13 @@ - + Contract Checking + -

    12 Contracts

    +

    13 Contracts

      @@ -38,7 +39,7 @@ When one of the rules is violated by a script, a runtime exception is generated rather than having the program continue to execute.

      -

      12.1 The %contract directive

      +

      13.1 The %contract directive

      @@ -94,7 +95,7 @@ RuntimeError: Contract violation: require: (arg1>=0)

    -

    12.2 %contract and classes

    +

    13.2 %contract and classes

    @@ -173,7 +174,7 @@ specified for the derived class all must hold. In the above example, this means that both the arguments to Spam::bar must be positive.

    -

    12.3 Constant aggregation and %aggregate_check

    +

    13.3 Constant aggregation and %aggregate_check

    @@ -262,7 +263,7 @@ Regrettably, there is no automatic way to perform similar checks with enums valu release.

    -

    12.4 Notes

    +

    13.4 Notes

    diff --git a/Doc/Manual/Customization.html b/Doc/Manual/Customization.html index f420f42..8705534 100644 --- a/Doc/Manual/Customization.html +++ b/Doc/Manual/Customization.html @@ -1,12 +1,13 @@ - + Customization Features + -

    11 Customization Features

    +

    12 Customization Features

      @@ -45,7 +46,7 @@ of exception handling is presented. Then, a more general-purpose customization mechanism known as "features" is described.

      -

      11.1 Exception handling with %exception

      +

      12.1 Exception handling with %exception

      @@ -100,7 +101,7 @@ for exception handling. That directive is deprecated--%exception provides the same functionality, but is substantially more flexible.

      -

      11.1.1 Handling exceptions in C code

      +

      12.1.1 Handling exceptions in C code

      @@ -115,16 +116,18 @@ static char error_message[256]; static int error_status = 0; void throw_exception(char *msg) { - strncpy(error_message,msg,256); - error_status = 1; + strncpy(error_message,msg,256); + error_status = 1; } void clear_exception() { - error_status = 0; + error_status = 0; } char *check_exception() { - if (error_status) return error_message; - else return NULL; + if (error_status) + return error_message; + else + return NULL; }

    @@ -136,13 +139,13 @@ To use these functions, functions simply call
     double inv(double x) {
    -	if (x != 0) return 1.0/x;
    -	else {
    -		throw_exception("Division by zero");
    -		return 0;
    -	}
    +  if (x != 0)
    +    return 1.0/x;
    +  else {
    +    throw_exception("Division by zero");
    +    return 0;
    +  }
     }
    -
     

    @@ -151,12 +154,12 @@ as the following (shown for Perl5) :

     %exception {
    -    char *err;
    -    clear_exception();
    -    $action
    -    if ((err = check_exception())) {
    -       croak(err);
    -    }
    +  char *err;
    +  clear_exception();
    +  $action
    +  if ((err = check_exception())) {
    +    croak(err);
    +  }
     }
     
    @@ -166,7 +169,7 @@ Each target language has its own approach to creating a runtime error/exception and for Perl it is the croak method shown above.

    -

    11.1.2 Exception handling with longjmp()

    +

    12.1.2 Exception handling with longjmp()

    @@ -206,8 +209,10 @@ Now, within a C program, you can do the following :

     double inv(double x) {
    -	if (x) return 1.0/x;
    -	else throw(DivisionByZero);
    +  if (x)
    +    return 1.0/x;
    +  else
    +    throw(DivisionByZero);
     }
     
     
    @@ -221,17 +226,17 @@ Finally, to create a SWIG exception handler, write the following :

    %} %exception { - try { - $action - } catch(RangeError) { - croak("Range Error"); - } catch(DivisionByZero) { - croak("Division by zero"); - } catch(OutOfMemory) { - croak("Out of memory"); - } finally { - croak("Unknown exception"); - } + try { + $action + } catch(RangeError) { + croak("Range Error"); + } catch(DivisionByZero) { + croak("Division by zero"); + } catch(OutOfMemory) { + croak("Out of memory"); + } finally { + croak("Unknown exception"); + } }
  • @@ -240,7 +245,7 @@ Note: This implementation is only intended to illustrate the general idea. To m modify it to handle nested try declarations.

    -

    11.1.3 Handling C++ exceptions

    +

    12.1.3 Handling C++ exceptions

    @@ -249,17 +254,17 @@ Handling C++ exceptions is also straightforward. For example:

     %exception {
    -	try {
    -		$action
    -	} catch(RangeError) {
    -		croak("Range Error");
    -	} catch(DivisionByZero) {
    -		croak("Division by zero");
    -	} catch(OutOfMemory) {
    -		croak("Out of memory");
    -	} catch(...) {
    -		croak("Unknown exception");
    -	}
    +  try {
    +    $action
    +  } catch(RangeError) {
    +    croak("Range Error");
    +  } catch(DivisionByZero) {
    +    croak("Division by zero");
    +  } catch(OutOfMemory) {
    +    croak("Out of memory");
    +  } catch(...) {
    +    croak("Unknown exception");
    +  }
     }
     
     
    @@ -275,7 +280,7 @@ class OutOfMemory {}; -

    11.1.4 Exception handlers for variables

    +

    12.1.4 Exception handlers for variables

    @@ -300,7 +305,7 @@ The %allowexception feature works like any other feature and so can be -

    11.1.5 Defining different exception handlers

    +

    12.1.5 Defining different exception handlers

    @@ -319,7 +324,7 @@ critical pieces of code. For example:

     %exception {
    -	... your exception handler ...
    +  ... your exception handler ...
     }
     /* Define critical operations that can throw exceptions here */
     
    @@ -437,7 +442,7 @@ declarations.  However, it never really worked that well and the new
     %exception directive is much better.
     

    -

    11.1.6 Special variables for %exception

    +

    12.1.6 Special variables for %exception

    @@ -485,12 +490,12 @@ variables are replaced with. -$parentname +$parentclassname The parent class name (if any) for a method. -$parentsymname +$parentclasssymname The target language parent class name (if any) for a method. @@ -540,14 +545,14 @@ Below shows the expansions for the 1st of the overloaded something wrap

    -

    11.1.7 Using The SWIG exception library

    +

    12.1.7 Using The SWIG exception library

    The exception.i library file provides support for creating language independent exceptions in your interfaces. To use it, simply put an "%include exception.i" in your interface file. This -creates a function SWIG_exception() that can be used to raise +provides a function SWIG_exception() that can be used to raise common scripting language exceptions in a portable manner. For example :

    @@ -595,7 +600,7 @@ SWIG_NullReferenceError
     The SWIG_exception() function can also be used in typemaps.
     

    -

    11.2 Object ownership and %newobject

    +

    12.2 Object ownership and %newobject

    @@ -752,7 +757,7 @@ char *strdup(const char *s); The results might not be what you expect.

    -

    11.3 Features and the %feature directive

    +

    12.3 Features and the %feature directive

    @@ -834,7 +839,7 @@ The following are all equivalent: The syntax in the first variation will generate the { } delimiters used whereas the other variations will not.

    -

    11.3.1 Feature attributes

    +

    12.3.1 Feature attributes

    @@ -875,7 +880,7 @@ In the following example, MyExceptionClass is the name of the Java clas Further details can be obtained from the Java exception handling section.

    -

    11.3.2 Feature flags

    +

    12.3.2 Feature flags

    @@ -973,7 +978,7 @@ in the swig.swg Library file. The following shows the alternative synta The concept of clearing features is discussed next.

    -

    11.3.3 Clearing features

    +

    12.3.3 Clearing features

    @@ -1066,7 +1071,7 @@ The three macros below show this for the "except" feature:

    -

    11.3.4 Features and default arguments

    +

    12.3.4 Features and default arguments

    @@ -1082,7 +1087,7 @@ For example:

    -%feature("except") void hello(int i=0, double d=0.0) { ... }
    +%feature("except") hello(int i=0, double d=0.0) { ... }
     void hello(int i=0, double d=0.0);
     
    @@ -1105,7 +1110,7 @@ If the default arguments are not specified in the feature:
    -%feature("except") void hello(int i, double d) { ... }
    +%feature("except") hello(int i, double d) { ... }
     void hello(int i=0, double d=0.0);
     
    @@ -1141,7 +1146,7 @@ specifying or not specifying default arguments in a feature is not applicable as in SWIG-1.3.23 when the approach to wrapping methods with default arguments was changed.

    -

    11.3.5 Feature example

    +

    12.3.5 Feature example

    diff --git a/Doc/Manual/D.html b/Doc/Manual/D.html index 43fa691..9e8e653 100644 --- a/Doc/Manual/D.html +++ b/Doc/Manual/D.html @@ -1,4 +1,4 @@ - + SWIG and D @@ -6,7 +6,7 @@ -

    21 SWIG and D

    +

    22 SWIG and D

    -
  • %features +
  • D and %feature
  • Pragmas
  • D Exceptions
  • D Directors
  • Other features
      -
    • Extended namespace support (nspace) +
    • Extended namespace support (nspace)
    • Native pointer support
    • Operator overloading
    • Running the test-suite @@ -41,7 +41,7 @@ -

      21.1 Introduction

      +

      22.1 Introduction

      From the D Programming Language web site: D is a systems programming language. Its focus is on combining the power and high performance of C and C++ with the programmer productivity of modern languages like Ruby and Python. [...] The D language is statically typed and compiles directly to machine code. As such, it is not very surprising that D is able to directly interface with C libraries. Why would a SWIG module for D be needed then in the first place?

      @@ -50,10 +50,10 @@

      While these issues can be worked around relatively easy by hand-coding a thin wrapper layer around the C library in question, there is another issue where writing wrapper code per hand is not feasible: C++ libraries. D did not support interfacing to C++ in version 1 at all, and even if extern(C++) has been added to D2, the support is still very limited, and a custom wrapper layer is still required in many cases.

      -

      To help addressing these issues, the SWIG C# module has been forked to support D. Is has evolved quite a lot since then, but there are still many similarities, so if you do not find what you are looking for on this page, it might be worth having a look at the chapter on C# (and also on Java, since the C# module was in turn forked from it).

      +

      To help addressing these issues, the SWIG C# module has been forked to support D. Is has evolved quite a lot since then, but there are still many similarities, so if you do not find what you are looking for on this page, it might be worth having a look at the chapter on C# (and also on Java, since the C# module was in turn forked from it).

      -

      21.2 Command line invocation

      +

      22.2 Command line invocation

      To activate the D module, pass the -d option to SWIG at the command line. The same standard command line switches as with any other language module are available, plus the following D specific ones:

      @@ -64,7 +64,7 @@

      By default, SWIG generates code for D1/Tango. Use the -d2 flag to target D2/Phobos instead.

      -
      -splitproxy
      +
      -splitproxy

      By default, SWIG generates two D modules: the proxy module, named like the source module (either specified via the %module directive or via the module command line switch), which contains all the proxy classes, functions, enums, etc., and the intermediary module (named like the proxy module, but suffixed with _im), which contains all the extern(C) function declarations and other private parts only used internally by the proxy module.

      If the split proxy mode is enabled by passing this switch at the command line, all proxy classes and enums are emitted to their own D module instead. The main proxy module only contains free functions and constants in this case.

      @@ -83,10 +83,10 @@ -

      21.3 Typemaps

      +

      22.3 Typemaps

      -

      21.3.1 C# <-> D name comparison

      +

      22.3.1 C# <-> D name comparison

      If you already know the SWIG C# module, you might find the following name comparison table useful:

      @@ -112,7 +112,7 @@
  • -

    21.3.2 ctype, imtype, dtype

    +

    22.3.2 ctype, imtype, dtype

    Mapping of types between the C/C++ library, the C/C++ library wrapper exposing the C functions, the D wrapper module importing these functions and the D proxy code.

    @@ -120,26 +120,26 @@

    The ctype typemap is used to determine the types to use in the C wrapper functions. The types from the imtype typemap are used in the extern(C) declarations of these functions in the intermediary D module. The dtype typemap contains the D types used in the D proxy module/class.

    -

    21.3.3 in, out, directorin, directorout

    +

    22.3.3 in, out, directorin, directorout

    Used for converting between the types for C/C++ and D when generating the code for the wrapper functions (on the C++ side).

    -

    The code from the in typemap is used to convert arguments to the C wrapper function to the type used in the wrapped code (ctype->original C++ type), the out typemap is utilized to convert values from the wrapped code to wrapper function return types (original C++ type->ctype).

    +

    The code from the in typemap is used to convert arguments to the C wrapper function to the type used in the wrapped code (ctype->original C++ type), the out typemap is utilized to convert values from the wrapped code to wrapper function return types (original C++ type->ctype).

    The directorin typemap is used to convert parameters to the type used in the D director callback function, its return value is processed by directorout (see below).

    -

    21.3.4 din, dout, ddirectorin, ddirectorout

    +

    22.3.4 din, dout, ddirectorin, ddirectorout

    Typemaps for code generation in D proxy and type wrapper classes.

    -

    The din typemap is used for converting function parameter types from the type used in the proxy module or class to the type used in the intermediary D module (the $dinput macro is replaced). To inject further parameter processing code before or after the call to the intermediary layer, the pre, post and terminator attributes can be used (please refer to the C# date marshalling example for more information on these).

    +

    The din typemap is used for converting function parameter types from the type used in the proxy module or class to the type used in the intermediary D module (the $dinput macro is replaced). To inject further parameter processing code before or after the call to the intermediary layer, the pre, post and terminator attributes can be used (please refer to the C# date marshalling example for more information on these).

    -

    The dout typemap is used for converting function return values from the return type used in the intermediary D module to the type returned by the proxy function. The $excode special variable in dout typemaps is replaced by the excode typemap attribute code if the method can throw any exceptions from unmanaged code, otherwise by nothing (the $imcall and $owner macros are replaced).

    +

    The dout typemap is used for converting function return values from the return type used in the intermediary D module to the type returned by the proxy function. The $excode special variable in dout typemaps is replaced by the excode typemap attribute code if the method can throw any exceptions from unmanaged code, otherwise by nothing (the $imcall and $owner macros are replaced).

    -

    The code from the ddirectorin and ddirectorout typemaps is used for conversion in director callback functions. Arguments are converted to the type used in the proxy class method they are calling by using the code from ddirectorin, the proxy class method return value is converted to the type the C++ code expects via the ddirectorout typemap (the $dcall and $winput macros are replaced).

    +

    The code from the ddirectorin and ddirectorout typemaps is used for conversion in director callback functions. Arguments are converted to the type used in the proxy class method they are calling by using the code from ddirectorin, the proxy class method return value is converted to the type the C++ code expects via the ddirectorout typemap (the $dcall and $winput macros are replaced).

    The full chain of type conversions when a director callback is invoked looks like this:

    @@ -157,13 +157,13 @@ dtype DClass.method(dtype a) -

    21.3.5 typecheck typemaps

    +

    22.3.5 typecheck typemaps

    Because, unlike many scripting languages supported by SWIG, D does not need any dynamic dispatch helper to access an overloaded function, the purpose of these is merely to issue a warning for overloaded C++ functions that cannot be overloaded in D (as more than one C++ type maps to a single D type).

    -

    21.3.6 Code injection typemaps

    +

    22.3.6 Code injection typemaps

    These typemaps are used for generating the skeleton of proxy classes for C++ types.

    @@ -172,10 +172,10 @@

    Using dcode and dimports, you can specify additional D code which will be emitted into the class body respectively the imports section of the D module the class is written to.

    -

    dconstructor, ddestructor, ddispose and ddispose_derived are used to generate the class constructor, destructor and dispose() method, respectively. The auxiliary code for handling the pointer to the C++ object is stored in dbody and dbody_derived. You can override them for specific types.

    +

    dconstructor, ddestructor, ddispose and ddispose_derived are used to generate the class constructor, destructor and dispose() method, respectively. The auxiliary code for handling the pointer to the C++ object is stored in dbody and dbody_derived. You can override them for specific types.

    -

    21.3.7 Special variable macros

    +

    22.3.7 Special variable macros

    The standard SWIG special variables are available for use within typemaps as described in the Typemaps documentation, for example $1, $input, $result etc.

    @@ -197,7 +197,7 @@
    $null

    In code inserted into the generated C/C++ wrapper functions, this variable is replaced by either 0 or nothing at all, depending on whether the function has a return value or not. It can be used to bail out early e.g. in case of errors (return $null;).

    -
    $dinput (C#: $csinput)
    +
    $dinput (C#: $csinput)

    This variable is used in din typemaps and is replaced by the expression which is to be passed to C/C++.

    For example, this input

    @@ -214,7 +214,7 @@ void foo(SomeClass arg) { example_im.foo(SomeClass.getCPointer(arg)); }
    -
    $imcall and $owner (C#: $imcall)
    +
    $imcall and $owner (C#: $imcall)

    These variables are used in dout typemaps. $imcall contains the call to the intermediary module which provides the value to be used, and $owner signals if the caller is responsible for managing the object lifetime (that is, if the called method is a constructor or has been marked via %newobject).

    Consider the following example:

    @@ -243,7 +243,7 @@ SomeClass bar() {
    $dcall and $winput (C#: $cscall, $iminput)
    -

    These variables are used in the director-specific typemaps ddirectorin and ddirectorout. They are more or less the reverse of the $imcall and $dinput macros: $dcall contains the invocation of the D proxy method of which the return value is to be passed back to C++, $winput contains the parameter value from C++.

    +

    These variables are used in the director-specific typemaps ddirectorin and ddirectorout. They are more or less the reverse of the $imcall and $dinput macros: $dcall contains the invocation of the D proxy method of which the return value is to be passed back to C++, $winput contains the parameter value from C++.

    $excode

    This variable is used in dout and dconstructor typemaps and is filled with the contents of the excode typemap attribute if an exception could be thrown from the C++ side. See the C# documentation for details.

    @@ -263,7 +263,7 @@ SomeClass bar() { -
    $importtype(SomeDType)
    +
    $importtype(SomeDType)

    This macro is used in the dimports typemap if a dependency on another D type generated by SWIG is added by a custom typemap.

    Consider the following code snippet:

    @@ -295,7 +295,7 @@ $importtype(AnotherInterface) -

    21.4 %features

    +

    22.4 D and %feature

    The D module defines a number of directives which modify the SWIG features set globally or for a specific declaration:

    @@ -325,7 +325,7 @@ struct A { -

    21.5 Pragmas

    +

    22.5 Pragmas

    There are a few SWIG pragmas specific to the D module, which you can use to influence the D code SWIG generates:

    @@ -364,7 +364,7 @@ struct A { -

    21.6 D Exceptions

    +

    22.6 D Exceptions

    Out of the box, C++ exceptions are fundamentally incompatible to their equivalent in the D world and cannot simply be propagated to a calling D method. There is, however, an easy way to solve this problem: Just catch the exception in the C/C++ wrapper layer, pass the contents to D, and make the wrapper code rethrow the exception in the D world.

    @@ -374,7 +374,7 @@ struct A {

    As this feature is implemented in exactly the same way it is for C#, please see the C# documentation for a more detailed explanation.

    -

    21.7 D Directors

    +

    22.7 D Directors

    When the directors feature is activated, SWIG generates extra code on both the C++ and the D side to enable cross-language polymorphism. Essentially, this means that if you subclass a proxy class in D, C++ code can access any overridden virtual methods just as if you created a derived class in C++.

    @@ -383,16 +383,16 @@ struct A {

    -

    21.8 Other features

    +

    22.8 Other features

    -

    21.8.1 Extended namespace support (nspace)

    +

    22.8.1 Extended namespace support (nspace)

    By default, SWIG flattens all C++ namespaces into a single target language namespace, but as for Java and C#, the nspace feature is supported for D. If it is active, C++ namespaces are mapped to D packages/modules. Note, however, that like for the other languages, free variables and functions are not supported yet; currently, they are all allows written to the main proxy D module.

    -

    21.8.2 Native pointer support

    +

    22.8.2 Native pointer support

    Contrary to many of the scripting languages supported by SWIG, D fully supports C-style pointers. The D module thus includes a custom mechanism to wrap C pointers directly as D pointers where applicable, that is, if the type that is pointed to is represented the same in C and D (on the bit-level), dubbed a primitive type below.

    @@ -404,7 +404,7 @@ struct A {

    To determine if a type should be considered primitive, the cprimitive attribute on its dtype attribute is used. For example, the dtype typemap for float has cprimitive="1", so the code from the nativepointer attribute is taken into account e.g. for float ** or the function pointer float (*)(float *).

    -

    21.8.3 Operator overloading

    +

    22.8.3 Operator overloading

    The D module comes with basic operator overloading support for both D1 and D2. There are, however, a few limitations arising from conceptual differences between C++ and D:

    @@ -416,7 +416,7 @@ struct A {

    There are also some cases where the operators can be translated to D, but the differences in the implementation details are big enough that a rather involved scheme would be required for automatic wrapping them, which has not been implemented yet. This affects, for example, the array subscript operator, [], in combination with assignments - while operator [] in C++ simply returns a reference which is then written to, D resorts to a separate opIndexAssign method -, or implicit casting (which was introduced in D2 via alias this). Despite the lack of automatic support, manually handling these cases should be perfectly possible.

    -

    21.8.4 Running the test-suite

    +

    22.8.4 Running the test-suite

    As with any other language, the SWIG test-suite can be built for D using the *-d-test-suite targets of the top-level Makefile. By default, D1 is targeted, to build it with D2, use the optional D_VERSION variable, e.g. make check-d-test-suite D_VERSION=2.

    @@ -424,14 +424,14 @@ struct A {

    Note: If you want to use GDC on Linux or another platform which requires you to link libdl for dynamically loading the shared library, you might have to add -ldl manually to the d_compile target in Examples/Makefile, because GDC does not currently honor the pragma(lib,...) statement.

    -

    21.9 D Typemap examples

    +

    22.9 D Typemap examples

    There are no D-specific typemap examples yet. However, with the above name comparison table, you should be able to get an idea what can be done by looking at the corresponding C# section.

    -

    21.10 Work in progress and planned features

    +

    22.10 Work in progress and planned features

    There are a couple of features which are not implemented yet, but would be very useful and might be added in the near future:

    diff --git a/Doc/Manual/Extending.html b/Doc/Manual/Extending.html index 5ea4e51f..14dcbdc 100644 --- a/Doc/Manual/Extending.html +++ b/Doc/Manual/Extending.html @@ -1,12 +1,13 @@ - + Extending SWIG to support new languages + -

    38 Extending SWIG to support new languages

    +

    41 Extending SWIG to support new languages

      @@ -75,7 +76,7 @@ -

      38.1 Introduction

      +

      41.1 Introduction

      @@ -91,7 +92,7 @@ Also, this chapter is not meant to be a hand-holding tutorial. As a starting po you should probably look at one of SWIG's existing modules.

      -

      38.2 Prerequisites

      +

      41.2 Prerequisites

      @@ -121,7 +122,7 @@ obvious, but almost all SWIG directives as well as the low-level generation of wrapper code are driven by C++ datatypes.

      -

      38.3 The Big Picture

      +

      41.3 The Big Picture

      @@ -158,7 +159,7 @@ role in making the system work. For example, both typemaps and declaration anno based on pattern matching and interact heavily with the underlying type system.

      -

      38.4 Execution Model

      +

      41.4 Execution Model

      @@ -203,7 +204,7 @@ latter stage of compilation. The next few sections briefly describe some of these stages.

      -

      38.4.1 Preprocessing

      +

      41.4.1 Preprocessing

      @@ -284,7 +285,7 @@ been expanded as well as everything else that goes into the low-level construction of the wrapper code.

      -

      38.4.2 Parsing

      +

      41.4.2 Parsing

      @@ -385,7 +386,7 @@ returning a foo and taking types a and b as arguments).

      -

      38.4.3 Parse Trees

      +

      41.4.3 Parse Trees

      @@ -640,7 +641,7 @@ $ swig -c++ -python -debug-module 4 example.i

    -

    38.4.4 Attribute namespaces

    +

    41.4.4 Attribute namespaces

    @@ -659,7 +660,7 @@ that matches the name of the target language. For example, python:foo perl:foo.

    -

    38.4.5 Symbol Tables

    +

    41.4.5 Symbol Tables

    @@ -750,7 +751,7 @@ example.i:5. Previous declaration is foo_i(int ) -

    38.4.6 The %feature directive

    +

    41.4.6 The %feature directive

    @@ -806,7 +807,7 @@ For example, the exception code above is simply stored without any modifications.

    -

    38.4.7 Code Generation

    +

    41.4.7 Code Generation

    @@ -928,7 +929,7 @@ public : The role of these functions is described shortly.

    -

    38.4.8 SWIG and XML

    +

    41.4.8 SWIG and XML

    @@ -941,7 +942,7 @@ internal data structures, it may be useful to keep XML in the back of your mind as a model.

    -

    38.5 Primitive Data Structures

    +

    41.5 Primitive Data Structures

    @@ -987,7 +988,7 @@ typedef Hash Typetab; -

    38.5.1 Strings

    +

    41.5.1 Strings

    @@ -1128,7 +1129,7 @@ Returns the number of replacements made (if any). -

    38.5.2 Hashes

    +

    41.5.2 Hashes

    @@ -1205,7 +1206,7 @@ Returns the list of hash table keys. -

    38.5.3 Lists

    +

    41.5.3 Lists

    @@ -1294,7 +1295,7 @@ If t is not a standard object, it is assumed to be a char * and is used to create a String object. -

    38.5.4 Common operations

    +

    41.5.4 Common operations

    The following operations are applicable to all datatypes. @@ -1349,7 +1350,7 @@ objects and report errors. Gets the line number associated with x. -

    38.5.5 Iterating over Lists and Hashes

    +

    41.5.5 Iterating over Lists and Hashes

    To iterate over the elements of a list or a hash table, the following functions are used: @@ -1394,7 +1395,7 @@ for (j = First(j); j.item; j= Next(j)) { -

    38.5.6 I/O

    +

    41.5.6 I/O

    Special I/O functions are used for all internal I/O. These operations @@ -1500,12 +1501,11 @@ Create a File object wrapper around an existing FILE * object.

    -int Close(String_or_FILE *f) +There's no explicit function to close a file, just call Delete(f) - +this decreases the reference count, and the file will be closed when the +reference count reaches zero.

    -
    -

    Closes a file. Has no effect on strings.

    -

    The use of the above I/O functions and strings play a critical role in SWIG. It is common to see small code fragments of code generated using code like this: @@ -1529,9 +1529,7 @@ Printf(f, "%s\n", s); Similarly, the preprocessor and parser all operate on string-files.

    -
    - -

    38.6 Navigating and manipulating parse trees

    +

    41.6 Navigating and manipulating parse trees

    Parse trees are built as collections of hash tables. Each node is a hash table in which @@ -1665,7 +1663,7 @@ Deletes a node from the parse tree. Deletion reconnects siblings and properly u the parent so that sibling nodes are unaffected. -

    38.7 Working with attributes

    +

    41.7 Working with attributes

    @@ -1782,7 +1780,7 @@ the attribute is optional. Swig_restore() must always be called after function. -

    38.8 Type system

    +

    41.8 Type system

    @@ -1791,7 +1789,7 @@ pointers, references, and pointers to members. A detailed discussion of type theory is impossible here. However, let's cover the highlights.

    -

    38.8.1 String encoding of types

    +

    41.8.1 String encoding of types

    @@ -1892,7 +1890,7 @@ make the final type, the two parts are just joined together using string concatenation.

    -

    38.8.2 Type construction

    +

    41.8.2 Type construction

    @@ -2061,7 +2059,7 @@ Returns the prefix of a type. For example, if ty is ty is unmodified. -

    38.8.3 Type tests

    +

    41.8.3 Type tests

    @@ -2148,7 +2146,7 @@ Checks if ty is a varargs type. Checks if ty is a templatized type. -

    38.8.4 Typedef and inheritance

    +

    41.8.4 Typedef and inheritance

    @@ -2250,7 +2248,7 @@ Fully reduces ty according to typedef rules. Resulting datatype will consist only of primitive typenames. -

    38.8.5 Lvalues

    +

    41.8.5 Lvalues

    @@ -2287,7 +2285,7 @@ Literal y; // type = 'Literal', ltype='p.char' -

    38.8.6 Output functions

    +

    41.8.6 Output functions

    @@ -2349,7 +2347,7 @@ SWIG, but is most commonly associated with type-descriptor objects that appear in wrappers (e.g., SWIGTYPE_p_double). -

    38.9 Parameters

    +

    41.9 Parameters

    @@ -2448,7 +2446,7 @@ included. Used to emit prototypes. Returns the number of required (non-optional) arguments in p. -

    38.10 Writing a Language Module

    +

    41.10 Writing a Language Module

    @@ -2463,7 +2461,7 @@ describes the creation of a minimal Python module. You should be able to extra this to other languages.

    -

    38.10.1 Execution model

    +

    41.10.1 Execution model

    @@ -2473,7 +2471,7 @@ the parsing of command line options, all aspects of code generation are controll different methods of the Language that must be defined by your module.

    -

    38.10.2 Starting out

    +

    41.10.2 Starting out

    @@ -2581,7 +2579,7 @@ that activates your module. For example, swig -python foo.i. The messages from your new module should appear.

    -

    38.10.3 Command line options

    +

    41.10.3 Command line options

    @@ -2640,7 +2638,7 @@ to mark the option as valid. If you forget to do this, SWIG will terminate wit unrecognized command line option error.

    -

    38.10.4 Configuration and preprocessing

    +

    41.10.4 Configuration and preprocessing

    @@ -2689,7 +2687,7 @@ an implementation file python.cxx and a configuration file python.swg.

    -

    38.10.5 Entry point to code generation

    +

    41.10.5 Entry point to code generation

    @@ -2747,7 +2745,7 @@ int Python::top(Node *n) { -

    38.10.6 Module I/O and wrapper skeleton

    +

    41.10.6 Module I/O and wrapper skeleton

    @@ -2761,8 +2759,8 @@ Within SWIG wrappers, there are five main sections. These are (in order)
  • begin: This section is a placeholder for users to put code at the beginning of the C/C++ wrapper file.
  • runtime: This section has most of the common SWIG runtime code.
  • header: This section holds declarations and inclusions from the .i file. -
  • wrapper: This section holds all the wrappering code. -
  • init: This section holds the module initalisation function +
  • wrapper: This section holds all the wrapper code. +
  • init: This section holds the module initialisation function (the entry point for the interpreter).

    @@ -2832,7 +2830,6 @@ int Python::top(Node *n) { Delete(f_header); Delete(f_wrappers); Delete(f_init); - Close(f_begin); Delete(f_begin); return SWIG_OK; @@ -2896,7 +2893,7 @@ functionWrapper : void Shape_y_set(Shape *self,double y) -

    38.10.7 Low-level code generators

    +

    41.10.7 Low-level code generators

    @@ -3005,7 +3002,7 @@ virtual int functionWrapper(Node *n) { /* write typemaps(in) */ .... - /* write constriants */ + /* write constraints */ .... /* Emit the function call */ @@ -3050,7 +3047,7 @@ but without the typemaps, there is still work to do.

    -

    38.10.8 Configuration files

    +

    41.10.8 Configuration files

    @@ -3194,7 +3191,7 @@ politely displays the ignoring language message. -

    38.10.9 Runtime support

    +

    41.10.9 Runtime support

    @@ -3203,7 +3200,7 @@ Discuss the kinds of functions typically needed for SWIG runtime support (e.g. the SWIG files that implement those functions.

    -

    38.10.10 Standard library files

    +

    41.10.10 Standard library files

    @@ -3222,7 +3219,7 @@ The following are the minimum that are usually supported: Please copy these and modify for any new language.

    -

    38.10.11 User examples

    +

    41.10.11 User examples

    @@ -3251,7 +3248,7 @@ during this process, see the section on .

    -

    38.10.12 Test driven development and the test-suite

    +

    41.10.12 Test driven development and the test-suite

    @@ -3310,7 +3307,7 @@ It is therefore essential that the runtime tests are written in a manner that di but error/exception out with an error message on stderr on failure.

    -

    38.10.12.1 Running the test-suite

    +

    41.10.12.1 Running the test-suite

    @@ -3350,10 +3347,10 @@ Note that if a runtime test is available, a message "(with run test)" is display

     $ make check-python-test-suite
     checking python test-suite
    -checking testcase argcargvtest (with run test) under python
    -checking testcase python_autodoc under python
    -checking testcase python_append (with run test) under python
    -checking testcase callback (with run test) under python
    +checking python testcase argcargvtest (with run test)
    +checking python testcase python_autodoc
    +checking python testcase python_append (with run test)
    +checking python testcase callback (with run test)
     

    @@ -3496,7 +3493,13 @@ The syntax for setting environment variables varies from one shell to the next, make ret_by_value.ctest SWIG_FEATURES="-debug-tmsearch" -

    38.10.13 Documentation

    +

    +There is also a special 'errors' test-suite which is a set of regression tests checking SWIG warning and error messages. +It can be run in the same way as the other language test-suites, replacing [lang] with errors, such as make check-errors-test-suite. +The test cases used and the way it works is described in Examples/test-suite/errors/Makefile.in. +

    + +

    41.10.13 Documentation

    @@ -3528,7 +3531,7 @@ Some topics that you'll want to be sure to address include: if available. -

    38.10.14 Prerequisites for adding a new language module to the SWIG distribution

    +

    41.10.14 Prerequisites for adding a new language module to the SWIG distribution

    @@ -3585,7 +3588,7 @@ should be added should there be an area not already covered by the existing tests.

    -

    38.10.15 Coding style guidelines

    +

    41.10.15 Coding style guidelines

    @@ -3609,7 +3612,7 @@ The generated C/C++ code should also follow this style as close as possible. How should be avoided as unlike the SWIG developers, users will never have consistent tab settings.

    -

    38.11 Debugging Options

    +

    41.11 Debugging Options

    @@ -3636,7 +3639,7 @@ There are various command line options which can aid debugging a SWIG interface The complete list of command line options for SWIG are available by running swig -help.

    -

    38.12 Guide to parse tree nodes

    +

    41.12 Guide to parse tree nodes

    @@ -4044,7 +4047,7 @@ extern "X" { ... } declaration. -

    38.13 Further Development Information

    +

    41.13 Further Development Information

    diff --git a/Doc/Manual/Go.html b/Doc/Manual/Go.html index 7a55a43..f25e985 100644 --- a/Doc/Manual/Go.html +++ b/Doc/Manual/Go.html @@ -1,19 +1,21 @@ - + SWIG and Go + -

    22 SWIG and Go

    +

    23 SWIG and Go

    @@ -43,44 +57,135 @@ the Go programming language see golang.org.

    -

    22.1 Overview

    +

    23.1 Overview

    + + +

    +Go does not support direct calling of functions written in C/C++. The +cgo program may be used to generate +wrappers to call C code from Go, but there is no convenient way to call C++ +code. SWIG fills this gap. +

    + +

    +There are (at least) two different Go compilers. The first is the gc compiler +of the Go distribution, normally +invoked via the go tool. +The second Go compiler is the +gccgo compiler, which is a frontend to the GCC compiler suite. +The interface to C/C++ code is completely different for the two Go compilers. +SWIG supports both Go compilers, selected by the -gccgo command line +option. +

    + +

    +Go is a type-safe compiled language and the wrapper code generated by SWIG is +type-safe as well. In case of type issues the build will fail and hence SWIG's +runtime library and +runtime type checking +are not used. +

    + +

    23.2 Examples

    -Go is a compiled language, not a scripting language. However, it does -not support direct calling of functions written in C/C++. The cgo -program may be used to generate wrappers to call C code from Go, but -there is no convenient way to call C++ code. SWIG fills this gap. +Working examples can be found in the +SWIG source tree +.

    -There are (at least) two different Go compilers. One is the gc -compiler, normally invoked under the names 6g, 8g, or 5g. The other -is the gccgo compiler, which is a frontend to the gcc compiler suite. -The interface to C/C++ code is completely different for the two Go -compilers. SWIG supports both, selected by a command line option. +Please note that the examples in the SWIG source tree use makefiles with the .i +SWIG interface file extension for backwards compatibility with Go 1.

    + +

    23.3 Running SWIG with Go

    + + +

    +Most Go programs are built using the go +tool. Since Go 1.1 the go tool has support for SWIG. To use it, give your +SWIG interface file the extension .swig (for C code) or .swigcxx (for C++ code). +Put that file in a GOPATH/src directory as usual for Go sources. Put other +C/C++ code in the same directory with extensions of .c and .cxx. The +go build and go install commands will automatically run SWIG +for you and compile the generated wrapper code. To check the SWIG command line +options the go tool uses run go build -x. To access the automatically +generated files run go build -work. You'll find the files under the +temporary WORK directory. +

    + +

    +To manually generate and compile C/C++ wrapper code for Go, use the -go +option with SWIG. By default SWIG will generate code for the Go compiler of the +Go distribution. To generate code for gccgo, you should also use the +-gccgo option. +

    + +

    +When using the -cgo option, SWIG will generate files that can be used +directly by go build. Starting with the Go 1.5 distribution the +-cgo option has to be given. Put your SWIG interface file in a +directory under GOPATH/src, and give it a name that does not end in the +.swig or .swigcxx extension. Typically the SWIG interface file extension is .i +in this case. +

    + +
    +% swig -go -cgo example.i
    +% go install
    +
    +

    -Because Go is a type-safe compiled language, SWIG's runtime type -checking and runtime library are not used with Go. This should be -borne in mind when reading the rest of the SWIG documentation. +You will now have a Go package that you can import from other Go packages as +usual.

    -

    22.2 Running SWIG with Go

    +

    +To use SWIG without the -cgo option, more steps are required. Recall +that this only works with Go versions before 1.5. When using Go version 1.2 or +later, or when using gccgo, the code generated by SWIG can be linked directly +into the Go program. A typical command sequence when using the Go compiler of +the Go distribution would look like this: +

    +
    +% swig -go example.i
    +% gcc -c code.c    # The C library being wrapped.
    +% gcc -c example_wrap.c
    +% go tool 6g example.go
    +% go tool 6c example_gc.c
    +% go tool pack grc example.a example.6 example_gc.6 code.o example_wrap.o
    +% go tool 6g main.go
    +% go tool 6l main.6
    +

    -To generate Go code, use the -go option with SWIG. By -default SWIG will generate code for the gc compilers. To generate -code for gccgo, you should also use the -gccgo option. +You can also put the wrapped code into a shared library, and when using the Go +versions before 1.2 this is the only supported option. A typical command +sequence for this approach would look like this:

    -

    22.2.1 Additional Commandline Options

    +
    +% swig -go -use-shlib example.i
    +% gcc -c -fpic example.c
    +% gcc -c -fpic example_wrap.c
    +% gcc -shared example.o example_wrap.o -o example.so
    +% go tool 6g example.go
    +% go tool 6c example_gc.c
    +% go tool pack grc example.a example.6 example_gc.6
    +% go tool 6g main.go  # your code, not generated by SWIG
    +% go tool 6l main.6
    +
    + + +

    23.3.1 Go-specific Commandline Options

    -These are the command line options for SWIG's GO module. They can +These are the command line options for SWIG's Go module. They can also be seen by using:

    @@ -88,15 +193,23 @@ also be seen by using: swig -go -help - +
    + + + + - + + - + + the Go compiler of the Go distribution. @@ -118,34 +231,49 @@ swig -go -help - + + + + + + + the Go compiler of the Go distribution; when using gccgo, the equivalent name + will be taken from the -soname option passed to the linker. + Using this option implies the -use-shlib option. - - + + - - + +
    Go-specific options
    Go specific options-cgoGenerate files to be used as input for the Go cgo tool. This + option is required for Go 1.5 and later, and works for Go 1.2 and + later. In the future this option will likely become the + default.
    -intgo-type-size %lt;s%gt;-intgosize <s> Set the size for the Go type int. This controls the size - that the C/C++ code expects to see. The %lt;s%gt; argument should + that the C/C++ code expects to see. The <s> argument should be 32 or 64. This option is currently required during the transition from Go 1.0 to Go 1.1, as the size of int on 64-bit x86 systems changes between those releases (from 32 bits to @@ -108,7 +221,7 @@ swig -go -help
    -gccgo Generate code for gccgo. The default is to generate code for - 6g/8g/5g.
    -soname %lt;name%gt;-use-shlibTell SWIG to emit code that uses a shared library. This is only + meaningful for the Go compiler of the Go distribution, which needs to know at + compile time whether a shared library will be used.
    -soname <name> Set the runtime name of the shared library that the dynamic linker should include at runtime. The default is the package name with ".so" appended. This is only used when generating code for - 6g/8g/5g; when using gccgo, the equivalent name will be taken from - the -soname option passed to the linker.
    -go-prefix <prefix>When generating code for gccgo, set the prefix to use. This - corresponds to the -fgo-prefix option to gccgo.-go-pkgpath <pkgpath>When generating code for gccgo, set the pkgpath to use. This + corresponds to the -fgo-pkgpath option to gccgo.
    -long-type-size <s>Set the size for the C/C++ type long. This controls - whether long is converted to the Go type int32 - or int64. The <s> argument should be 32 or 64.-go-prefix <prefix>When generating code for gccgo, set the prefix to use. This + corresponds to the -fgo-prefix option to gccgo. + If -go-pkgpath is used, -go-prefix will be + ignored.
    -

    22.2.2 Go Output Files

    +

    23.3.2 Generated Wrapper Files

    + + +

    There are two different approaches to generating wrapper files, + controlled by SWIG's -cgo option. The -cgo option + works with Go version 1.2 or later. It is required when using Go + version 1.5 or later.

    -

    When generating Go code, SWIG will generate the following - files:

    +

    With or without the -cgo option, SWIG will generate the + following files when generating wrapper code:

    • @@ -153,40 +281,34 @@ MODULE.go will contain the Go functions that your Go code will call. These functions will be wrappers for the C++ functions defined by your module. This file should, of course, be compiled with the Go compiler. +
    • MODULE_wrap.c or MODULE_wrap.cxx will contain C/C++ functions will be invoked by the Go wrapper code. This file should be compiled with the -usual C or C++ compiler and linked into a shared library. +usual C or C++ compiler. +
    • MODULE_wrap.h will be generated if you use the directors feature. It provides a definition of the generated C++ director classes. It is generally not necessary to use this file, but in some special cases it may be helpful to include it in your code, compiled with the usual C or C++ compiler. -
    • -If using the gc compiler, MODULE_gc.c will contain C code which should -be compiled with the C compiler distributed as part of the gc compiler: 6c, 8c, -or 5c. It should then be combined with the compiled MODULE.go using -gopack. This file will not be generated when using gccgo. +
    -

    -A typical command sequence would look like this: -

    +

    When neither the -cgo nor the -gccgo option is + used, SWIG will also generate an additional file:

    + +
      +
    • +MODULE_gc.c will contain C code which should be compiled with the C +compiler distributed as part of the gc compiler. It should then be +combined with the compiled MODULE.go using go tool pack. +
    • +
    -
    -% swig -go example.i
    -% gcc -c -fpic example.c
    -% gcc -c -fpic example_wrap.c
    -% gcc -shared example.o example_wrap.o -o example.so
    -% 6g example.go
    -% 6c example_gc.c
    -% gopack grc example.a example.6 example_gc.6
    -% 6g main.go  # your code, not generated by SWIG
    -% 6l main.6
    -
    -

    22.3 A tour of basic C/C++ wrapping

    +

    23.4 A tour of basic C/C++ wrapping

    @@ -196,7 +318,7 @@ modifications have to occur. This section briefly covers the essential aspects of this wrapping.

    -

    22.3.1 Go Package Name

    +

    23.4.1 Go Package Name

    @@ -206,7 +328,7 @@ directive. You may override this by using SWIG's -package command line option.

    -

    22.3.2 Go Names

    +

    23.4.2 Go Names

    @@ -238,7 +360,7 @@ followed by that name, and the destructor will be named Delete followed by that name.

    -

    22.3.3 Go Constants

    +

    23.4.3 Go Constants

    @@ -246,7 +368,7 @@ C/C++ constants created via #define or the %constant directive become Go constants, declared with a const declaration. -

    22.3.4 Go Enumerations

    +

    23.4.4 Go Enumerations

    @@ -256,7 +378,7 @@ usual). The values of the enumeration will become variables in Go; code should avoid modifying those variables.

    -

    22.3.5 Go Classes

    +

    23.4.5 Go Classes

    @@ -324,7 +446,7 @@ type MyClass interface { MyMethod() int } -MyClassMyFactoryFunction() MyClass { +func MyClassMyFactoryFunction() MyClass { // swig magic here } @@ -334,7 +456,129 @@ returns a go interface. If the returned pointer can be null, you can check for this by calling the Swigcptr() method.

    -

    22.3.5.1 Go Class Inheritance

    +

    23.4.5.1 Go Class Memory Management

    + + +

    +Calling NewClassName for a C++ class ClassName will allocate +memory using the C++ memory allocator. This memory will not be automatically +freed by Go's garbage collector as the object ownership is not tracked. When +you are done with the C++ object you must free it using +DeleteClassName.
    +
    +The most Go idiomatic way to manage the memory for some C++ class is to call +NewClassName followed by a +defer of +the DeleteClassName call. Using defer ensures that the memory +of the C++ object is freed as soon as the function containing the defer +statement returns. Furthemore defer works great for short-lived +objects and fits nicely C++'s RAII idiom. Example: +

    +
    +
    +func UseClassName(...) ... {
    +  o := NewClassName(...)
    +  defer DeleteClassName(o)
    +  // Use the ClassName object
    +  return ...
    +}
    +
    +
    + +

    +With increasing complexity, especially complex C++ object hierarchies, the +correct placement of defer statements becomes harder and harder as C++ +objects need to be freed in the correct order. This problem can be eased by +keeping a C++ object function local so that it is only available to the function +that creates a C++ object and functions called by this function. Example: +

    +
    +
    +func WithClassName(constructor args, f func(ClassName, ...interface{}) error, data ...interface{}) error {
    +  o := NewClassName(constructor args)
    +  defer DeleteClassName(o)
    +  return f(o, data...)
    +}
    +
    +func UseClassName(o ClassName, data ...interface{}) (err error) {
    +  // Use the ClassName object and additional data and return error.
    +}
    +
    +func main() {
    +  WithClassName(constructor args, UseClassName, additional data)
    +}
    +
    +
    + +

    +Using defer has limitations though, especially when it comes to +long-lived C++ objects whichs lifetimes are hard to predict. For such C++ +objects a common technique is to store the C++ object into a Go object, and to +use the Go function runtime.SetFinalizer to add a finalizer which frees +the C++ object when the Go object is freed. It is strongly recommended to read +the runtime.SetFinalizer + documentation before using this technique to understand the +runtime.SetFinalizer limitations.
    +

    +

    +Common pitfalls with runtime.SetFinalizer are: +

    +
      +
    • +If a hierarchy of C++ objects will be automatically freed by Go finalizers then +the Go objects that store the C++ objects need to replicate the hierarchy of the +C++ objects to prevent that C++ objects are freed prematurely while other C++ +objects still rely on them. +
    • +
    • +The usage of Go finalizers is problematic with C++'s RAII idiom as it isn't +predictable when the finalizer will run and this might require a Close or Delete +method to be added the Go object that stores a C++ object to mitigate. +
    • +
    • +The Go finalizer function typically runs in a different OS thread which can be +problematic with C++ code that uses thread-local storage. +
    • +
    + +

    +runtime.SetFinalizer Example: +

    +
    +
    +import (
    +  "runtime"
    +  "wrap" // SWIG generated wrapper code
    +)
    +
    +type GoClassName struct {
    +  wcn wrap.ClassName
    +}
    +
    +func NewGoClassName() *GoClassName {
    +  o := &GoClassName{wcn: wrap.NewClassName()}
    +  runtime.SetFinalizer(o, deleteGoClassName)
    +  return o
    +}
    +
    +func deleteGoClassName(o *GoClassName) {
    +  // Runs typically in a different OS thread!
    +  wrap.DeleteClassName(o.wcn)
    +  o.wcn = nil
    +}
    +
    +func (o *GoClassName) Close() {
    +  // If the C++ object has a Close method.
    +  o.wcn.Close()
    +
    +  // If the GoClassName object is no longer in an usable state.
    +  runtime.SetFinalizer(o, nil) // Remove finalizer.
    +  deleteGoClassName() // Free the C++ object.
    +}
    +
    +
    + +

    23.4.5.2 Go Class Inheritance

    @@ -346,7 +590,7 @@ Doing the reverse will require an explicit type assertion, which will be checked dynamically.

    -

    22.3.6 Go Templates

    +

    23.4.6 Go Templates

    @@ -354,50 +598,551 @@ In order to use C++ templates in Go, you must tell SWIG to create wrappers for a particular template instantation. To do this, use the %template directive. -

    22.3.7 Go Director Classes

    +

    23.4.7 Go Director Classes

    + + +

    +SWIG's director feature permits a Go type to act as the subclass of a C++ class. +This is complicated by the fact that C++ and Go define inheritance differently. +SWIG normally represents the C++ class inheritance automatically in Go via +interfaces but with a Go type representing a subclass of a C++ class some manual +work is necessary. +

    + +

    +This subchapter gives a step by step guide how to properly sublass a C++ class +with a Go type. In general it is strongly recommended to follow this guide +completely to avoid common pitfalls with directors in Go. +

    + + +

    23.4.7.1 Example C++ code

    + + +

    +The step by step guide is based on two example C++ classes. FooBarAbstract is +an abstract C++ class and the FooBarCpp class inherits from it. This guide +explains how to implement a FooBarGo class similar to the FooBarCpp class. +

    + +

    +FooBarAbstract abstract C++ class: +

    + +
    +
    +class FooBarAbstract
    +{
    +public:
    +  FooBarAbstract() {};
    +  virtual ~FooBarAbstract() {};
    +
    +  std::string FooBar() {
    +          return this->Foo() + ", " + this->Bar();
    +  };
    +
    +protected:
    +  virtual std::string Foo() {
    +          return "Foo";
    +  };
    +
    +  virtual std::string Bar() = 0;
    +};
    +
    +
    + +

    +FooBarCpp C++ class: +

    + +
    +
    +class FooBarCpp : public FooBarAbstract
    +{
    +protected:
    +  virtual std::string Foo() {
    +    return "C++ " + FooBarAbstract::Foo();
    +  }
    +
    +  virtual std::string Bar() {
    +    return "C++ Bar";
    +  }
    +};
    +
    +
    + +

    +Returned string by the FooBarCpp::FooBar method is: +

    + +
    +
    +C++ Foo, C++ Bar
    +
    +
    + + +

    +The complete example, including the FooBarGoo class implementation, can +be found in the end of the guide. +

    + + +

    23.4.7.2 Enable director feature

    + + +

    +The director feature is disabled by default. To use directors you must make two +changes to the interface file. First, add the "directors" option to the %module +directive, like this: +

    + +
    +
    +%module(directors="1") modulename
    +
    +
    + +

    +Second, you must use the %feature("director") directive to tell SWIG which +classes should get directors. In the example the FooBarAbstract class needs the +director feature enabled so that the FooBarGo class can inherit from it, like +this: +

    + +
    +
    +%feature("director") FooBarAbstract;
    +
    +

    -SWIG's director feature permits a Go type to act as the subclass of a -C++ class with virtual methods. This is complicated by the fact that -C++ and Go define inheritance differently. In Go, structs can inherit -methods via anonymous field embedding. However, when a method is -called for an embedded struct, if that method calls any other methods, -they are called for the embedded struct, not for the original type. -Therefore, SWIG must use Go interfaces to represent C++ inheritance. +For a more detailed documentation of the director feature and how to enable or +disable it for specific classes and virtual methods see SWIG's Java +documentation on directors. +

    + + +

    23.4.7.3 Constructor and destructor

    + + +

    +SWIG creates an additional set of constructor and destructor functions once the +director feature has been enabled for a C++ class. +NewDirectorClassName allows overriding virtual methods on the new +object instance and DeleteDirectorClassName needs to be used to free a +director object instance created with NewDirectorClassName. +More on overriding virtual methods follows later in this guide under +overriding virtual methods.

    -In order to use the director feature in Go, you must define a type in -your Go code. You must then add methods for the type. Define a -method in Go for each C++ virtual function that you want to override. -You must then create a value of your new type, and pass a pointer to -it to the function NewDirectorClassName, -where ClassName is the name of the C++ class. That will -return a value of type ClassName. +The default constructor and destructor functions NewClassName and +DeleteClassName can still be used as before so that existing code +doesn't break just because the director feature has been enabled for a C++ +class. The behavior is undefined if the default and director constructor and +destructor functions get mixed and so great care needs to be taken that only one +of the constructor and destructor function pairs is used for any object +instance. Both constructor functions, the default and the director one, return +the same interface type. This makes it potentially hard to know which +destructor function, the default or the director one, needs to be called to +delete an object instance.

    -For example: +In theory the DirectorInterface method could be used to +determine if an object instance was created via NewDirectorClassName:

    -type GoClass struct { }
    -func (p *GoClass) VirtualFunction() { }
    -func MakeClass() ClassName {
    -	return NewDirectorClassName(&GoClass{})
    +if o.DirectorInterface() != nil {
    +  DeleteDirectorClassName(o)
    +} else {
    +  DeleteClassName(o)
     }
     

    -Any call in C++ code to the virtual function will wind up calling the -method defined in Go. The Go code may of course call other methods on -itself, and those methods may be defined either in Go or in C++. +In practice it is strongly recommended to embed a director object +instance in a Go struct so that a director object instance will be represented +as a distinct Go type that subclasses a C++ class. For this Go type custom +constructor and destructor functions take care of the director constructor and +destructor function calls and the resulting Go class will appear to the user as +any other SWIG wrapped C++ class. More on properly subclassing a C++ class +follows later in this guide under subclass via +embedding. +

    + + +

    23.4.7.4 Override virtual methods

    + + +

    +In order to override virtual methods on a C++ class with Go methods the +NewDirectorClassName constructor functions receives a +DirectorInterface argument. The methods in the +DirectorInterface are a subset of the public and protected virtual methods +of the C++ class. If the DirectorInterface contains a method with a +matching signature to a virtual method of the C++ class then the virtual C++ +method will be overwritten with the Go method. As Go doesn't support protected +methods all overriden protected virtual C++ methods will be public in Go.

    -

    22.3.8 Default Go primitive type mappings

    +

    +As an example see part of the FooBarGo class: +

    + +
    +
    +type overwrittenMethodsOnFooBarAbstract struct {
    +  fb FooBarAbstract
    +}
    +
    +func (om *overwrittenMethodsOnFooBarAbstract) Foo() string {
    +  ...
    +}
    +
    +func (om *overwrittenMethodsOnFooBarAbstract) Bar() string {
    +  ...
    +}
    +
    +func NewFooBarGo() FooBarGo {
    +  om := &overwrittenMethodsOnFooBarAbstract{}
    +  fb := NewDirectorFooBarAbstract(om)
    +  om.fb = fb
    +  ...
    +}
    +
    +
    + +

    +The complete example, including the FooBarGoo class implementation, can +be found in the end of the guide. In +this part of the example the virtual methods FooBarAbstract::Foo and +FooBarAbstract::Bar have been overwritten with Go methods similarly to +how the FooBarAbstract virtual methods are overwritten by the +FooBarCpp class. +

    + +

    +The DirectorInterface in the example is implemented by the +overwrittenMethodsOnFooBarAbstract Go struct type. A pointer to a +overwrittenMethodsOnFooBarAbstract struct instance will be given to the +NewDirectorFooBarAbstract constructor function. The constructor return +value implements the FooBarAbstract interface. +overwrittenMethodsOnFooBarAbstract could in theory be any Go type but +in practice a struct is used as it typically contains at least a value of the +C++ class interface so that the overwritten methods can use the rest of the +C++ class. If the FooBarGo class would receive additional constructor +arguments then these would also typically be stored in the +overwrittenMethodsOnFooBarAbstract struct so that they can be used by +the Go methods. +

    + + +

    23.4.7.5 Call base methods

    + + +

    +Often a virtual method will be overwritten to extend the original behavior of +the method in the base class. This is also the case for the +FooBarCpp::Foo method of the example code: +

    + +
    +
    +virtual std::string Foo() {
    +  return "C++ " + FooBarAbstract::Foo();
    +}
    +
    +
    + +

    +To use base methods the DirectorClassNameMethodName wrapper functions +are automatically generated by SWIG for public and protected virtual methods. +The FooBarGo.Foo implementation in the example looks like this: +

    + +
    +
    +func (om *overwrittenMethodsOnFooBarAbstract) Foo() string {
    +  return "Go " + DirectorFooBarAbstractFoo(om.fb)
    +}
    +
    +
    + +

    +The complete example, including the FooBarGoo class implementation, can +be found in the end of the guide. +

    + + +

    23.4.7.6 Subclass via embedding

    + + +

    +As previously mentioned in this guide the +default and director constructor functions return the same interface type. To +properly subclass a C++ class with a Go type the director object instance +returned by the NewDirectorClassName constructor function should be +embedded into a Go struct so that it represents a distinct but compatible type +in Go's type system. This Go struct should be private and the constructor and +destructor functions should instead work with a public interface type so that +the Go class that subclasses a C++ class can be used as a compatible drop in. +

    + +

    +The subclassing part of the FooBarGo class for an example looks like +this: +

    + +
    +
    +type FooBarGo interface {
    +  FooBarAbstract
    +  deleteFooBarAbstract()
    +  IsFooBarGo()
    +}
    +
    +type fooBarGo struct {
    +  FooBarAbstract
    +}
    +
    +func (fbgs *fooBarGo) deleteFooBarAbstract() {
    +  DeleteDirectorFooBarAbstract(fbgs.FooBarAbstract)
    +}
    +
    +func (fbgs *fooBarGo) IsFooBarGo() {}
    +
    +func NewFooBarGo() FooBarGo {
    +  om := &overwrittenMethodsOnFooBarAbstract{}
    +  fb := NewDirectorFooBarAbstract(om)
    +  om.fb = fb
    +
    +  return &fooBarGo{FooBarAbstract: fb}
    +}
    +
    +func DeleteFooBarGo(fbg FooBarGo) {
    +  fbg.deleteFooBarAbstract()
    +}
    +
    +
    + + +

    +The complete example, including the FooBarGoo class implementation, can +be found in the end of the guide. In +this part of the example the private fooBarGo struct embeds +FooBarAbstract which lets the fooBarGo Go type "inherit" all the +methods of the FooBarAbstract C++ class by means of embedding. The +public FooBarGo interface type includes the FooBarAbstract +interface and hence FooBarGo can be used as a drop in replacement for +FooBarAbstract while the reverse isn't possible and would raise a +compile time error. Furthemore the constructor and destructor functions +NewFooBarGo and DeleteFooBarGo take care of all the director +specifics and to the user the class appears as any other SWIG wrapped C++ +class. +

    + + +

    23.4.7.7 Memory management with runtime.SetFinalizer

    + + +

    +In general all guidelines for C++ class memory +management apply as well to director classes. One often overlooked +limitation with runtime.SetFinalizer is that a finalizer doesn't run +in case of a cycle and director classes typically have a cycle. The cycle +in the FooBarGo class is here: +

    + +
    +
    +type overwrittenMethodsOnFooBarAbstract struct {
    +  fb FooBarAbstract
    +}
    +
    +func NewFooBarGo() FooBarGo {
    +  om := &overwrittenMethodsOnFooBarAbstract{}
    +  fb := NewDirectorFooBarAbstract(om) // fb.v = om
    +  om.fb = fb // Backlink causes cycle as fb.v = om!
    +  ...
    +}
    +
    +
    + +

    +In order to be able to use runtime.SetFinalizer nevertheless the +finalizer needs to be set on something that isn't in a cycle and that references +the director object instance. In the FooBarGo class example the +FooBarAbstract director instance can be automatically deleted by setting +the finalizer on fooBarGo: +

    + +
    +
    +type fooBarGo struct {
    +  FooBarAbstract
    +}
    +
    +type overwrittenMethodsOnFooBarAbstract struct {
    +  fb FooBarAbstract
    +}
    +
    +func NewFooBarGo() FooBarGo {
    +  om := &overwrittenMethodsOnFooBarAbstract{}
    +  fb := NewDirectorFooBarAbstract(om)
    +  om.fb = fb // Backlink causes cycle as fb.v = om!
    +
    +  fbgs := &fooBarGo{FooBarAbstract: fb}
    +  runtime.SetFinalizer(fbgs, FooBarGo.deleteFooBarAbstract)
    +  return fbgs
    +}
    +
    +
    + +

    +Furthermore if runtime.SetFinalizer is in use either the +DeleteClassName destructor function needs to be removed or the +fooBarGo struct needs additional data to prevent double deletion. Please +read the C++ class memory management subchapter +before using runtime.SetFinalizer to know all of its gotchas. +

    + + +

    23.4.7.8 Complete FooBarGo example class

    + + +

    +The complete and annotated FooBarGo class looks like this: +

    + +
    +
    +// FooBarGo is a superset of FooBarAbstract and hence FooBarGo can be used as a
    +// drop in replacement for FooBarAbstract but the reverse causes a compile time
    +// error.
    +type FooBarGo interface {
    +  FooBarAbstract
    +  deleteFooBarAbstract()
    +  IsFooBarGo()
    +}
    +
    +// Via embedding fooBarGo "inherits" all methods of FooBarAbstract.
    +type fooBarGo struct {
    +  FooBarAbstract
    +}
    +
    +func (fbgs *fooBarGo) deleteFooBarAbstract() {
    +  DeleteDirectorFooBarAbstract(fbgs.FooBarAbstract)
    +}
    +
    +// The IsFooBarGo method ensures that FooBarGo is a superset of FooBarAbstract.
    +// This is also how the class hierarchy gets represented by the SWIG generated
    +// wrapper code.  For an instance FooBarCpp has the IsFooBarAbstract and
    +// IsFooBarCpp methods.
    +func (fbgs *fooBarGo) IsFooBarGo() {}
    +
    +// Go type that defines the DirectorInterface. It contains the Foo and Bar
    +// methods that overwrite the respective virtual C++ methods on FooBarAbstract.
    +type overwrittenMethodsOnFooBarAbstract struct {
    +  // Backlink to FooBarAbstract so that the rest of the class can be used by
    +  // the overridden methods.
    +  fb FooBarAbstract
    +
    +  // If additional constructor arguments have been given they are typically
    +  // stored here so that the overriden methods can use them.
    +}
    +
    +func (om *overwrittenMethodsOnFooBarAbstract) Foo() string {
    +  // DirectorFooBarAbstractFoo calls the base method FooBarAbstract::Foo.
    +  return "Go " + DirectorFooBarAbstractFoo(om.fb)
    +}
    +
    +func (om *overwrittenMethodsOnFooBarAbstract) Bar() string {
    +  return "Go Bar"
    +}
    +
    +func NewFooBarGo() FooBarGo {
    +  // Instantiate FooBarAbstract with selected methods overridden.  The methods
    +  // that will be overwritten are defined on
    +  // overwrittenMethodsOnFooBarAbstract and have a compatible signature to the
    +  // respective virtual C++ methods. Furthermore additional constructor
    +  // arguments will be typically stored in the
    +  // overwrittenMethodsOnFooBarAbstract struct.
    +  om := &overwrittenMethodsOnFooBarAbstract{}
    +  fb := NewDirectorFooBarAbstract(om)
    +  om.fb = fb // Backlink causes cycle as fb.v = om!
    +
    +  fbgs := &fooBarGo{FooBarAbstract: fb}
    +  // The memory of the FooBarAbstract director object instance can be
    +  // automatically freed once the FooBarGo instance is garbage collected by
    +  // uncommenting the following line.  Please make sure to understand the
    +  // runtime.SetFinalizer specific gotchas before doing this.  Furthemore
    +  // DeleteFooBarGo should be deleted if a finalizer is in use or the fooBarGo
    +  // struct needs additional data to prevent double deletion.
    +  // runtime.SetFinalizer(fbgs, FooBarGo.deleteFooBarAbstract)
    +  return fbgs
    +}
    +
    +// Recommended to be removed if runtime.SetFinalizer is in use.
    +func DeleteFooBarGo(fbg FooBarGo) {
    +  fbg.deleteFooBarAbstract()
    +}
    +
    +
    + +

    +Returned string by the FooBarGo.FooBar method is: +

    + +
    +
    +Go Foo, Go Bar
    +
    +
    + +

    +For comparison the FooBarCpp class looks like this: +

    + +
    +
    +class FooBarCpp : public FooBarAbstract
    +{
    +protected:
    +  virtual std::string Foo() {
    +    return "C++ " + FooBarAbstract::Foo();
    +  }
    +
    +  virtual std::string Bar() {
    +    return "C++ Bar";
    +  }
    +};
    +
    +
    + +

    +For comparison the returned string by the FooBarCpp::FooBar method is: +

    + +
    +
    +C++ Foo, C++ Bar
    +
    +
    + +

    +The complete source of this example can be found under + +SWIG/Examples/go/director/. +

    + + +

    23.4.8 Default Go primitive type mappings

    @@ -454,12 +1199,12 @@ uses a given C/C++ type. long -int32 or int64, depending on -long-type-size +int64 unsigned long -uint32 or uint64, depending on -long-type-size +uint64 @@ -504,7 +1249,7 @@ that typemap, or add new values, to control how C/C++ types are mapped into Go types.

    -

    22.3.9 Output arguments

    +

    23.4.9 Output arguments

    Because of limitations in the way output arguments are processed in swig, @@ -557,7 +1302,7 @@ void f(char *output); -

    22.3.10 Adding additional go code

    +

    23.4.10 Adding additional go code

    Often the APIs generated by swig are not very natural in go, especially if @@ -626,9 +1371,174 @@ func (arg SwigcptrWrapped_MyClass) GetAValue() (int, bool) { few, then you might as well define your own struct that includes the swig-wrapped object, instead of adding methods to the swig-generated object.

    -

    This only works if your wrappers do not need to import other go modules. -There is at present no way to insert import statements in the correct place -in swig-generated go. If you need to do that, you must put your go code -in a separate file.

    +

    If you need to import other go packages, you can do this with +%go_import. For example,

    +
    +
    +%go_import("fmt", _ "unusedPackage", rp "renamed/package")
    +
    +%insert(go_wrapper) %{
    +
    +func foo() {
    +  fmt.Println("Some string:", rp.GetString())
    +}
    +
    +// Importing the same package twice is permitted,
    +// Go code will be generated with only the first instance of the import.
    +%go_import("fmt")
    +
    +%insert(go_wrapper) %{
    +
    +func bar() {
    +  fmt.Println("Hello world!")
    +}
    +
    +%}
    +
    +
    + +

    23.4.11 Go typemaps

    + + +

    +You can use the %typemap directive to modify SWIG's default +wrapping behavior for specific C/C++ types. You need to be familiar +with the material in the general +"Typemaps" chapter. That chapter +explains how to define a typemap. This section describes some +specific typemaps used for Go. +

    + +

    +In general type conversion code may be written either in C/C++ or in +Go. The choice to make normally depends on where memory should be +allocated. To allocate memory controlled by the Go garbage collector, +write Go code. To allocate memory in the C/C++ heap, write C code. +

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    TypemapDescription
    gotype +The Go type to use for a C++ type. This type will appear in the +generated Go wrapper function. If this is not defined SWIG will use a +default as described above. +
    imtype +An intermediate Go type used by the "goin", "goout", "godirectorin", +and "godirectorout" typemaps. If this typemap is not defined for a +C/C++ type, the gotype typemape will be used. This is useful when +gotype is best converted to C/C++ using Go code. +
    goin +Go code to convert from gotype to imtype when calling a C/C++ +function. SWIG will then internally convert imtype to a C/C++ type +and pass it down. If this is not defined, or is the empty string, no +conversion is done. +
    in +C/C++ code to convert the internally generated C/C++ type, based on +imtype, into the C/C++ type that a function call expects. If this is +not defined the value will simply be cast to the desired type. +
    out +C/C++ code to convert the C/C++ type that a function call returns into +the internally generated C/C++ type, based on imtype, that will be +returned to Go. If this is not defined the value will simply be cast +to the desired type. +
    goout +Go code to convert a value returned from a C/C++ function from imtype +to gotype. If this is not defined, or is the empty string, no +conversion is done. +
    argout +C/C++ code to adjust an argument value when returning from a function. +This is called after the real C/C++ function has run. This uses the +internally generated C/C++ type, based on imtype. This is only useful +for a pointer type of some sort. If this is not defined nothing will +be done. +
    goargout +Go code to adjust an argument value when returning from a function. +This is called after the real C/C++ function has run. The value will +be in imtype. This is only useful for a pointer type of some sort. +If this is not defined, or is the empty string, nothing will be done. +
    directorin +C/C++ code to convert the C/C++ type used to call a director method +into the internally generated C/C++ type, based on imtype, that will +be passed to Go. If this is not defined the value will simply be cast +to the desired type. +
    godirectorin +Go code to convert a value used to call a director method from imtype +to gotype. If this is not defined, or is the empty string, no +conversion is done. +
    godirectorout +Go code to convert a value returned from a director method from gotype +to imtype. If this is not defined, or is the empty string, no +conversion is done. +
    directorout +C/C++ code to convert a value returned from a director method from the +internally generated C/C++ type, based on imtype, into the type that +the method should return If this is not defined the value will simply +be cast to the desired type. +
    + diff --git a/Doc/Manual/Guile.html b/Doc/Manual/Guile.html index 17e3a3f..f30e139 100644 --- a/Doc/Manual/Guile.html +++ b/Doc/Manual/Guile.html @@ -1,14 +1,14 @@ - - + SWIG and Guile + -

    23 SWIG and Guile

    +

    24 SWIG and Guile

      @@ -47,7 +47,7 @@

      This section details guile-specific support in SWIG. -

      23.1 Supported Guile Versions

      +

      24.1 Supported Guile Versions

      @@ -61,7 +61,7 @@ improved performance. This is currently not tested with swig so your mileage may vary. To be safe set environment variable GUILE_AUTO_COMPILE to 0 when using swig generated guile code. -

      23.2 Meaning of "Module"

      +

      24.2 Meaning of "Module"

      @@ -69,7 +69,7 @@ There are three different concepts of "module" involved, defined separately for SWIG, Guile, and Libtool. To avoid horrible confusion, we explicitly prefix the context, e.g., "guile-module". -

      23.3 Old GH Guile API

      +

      24.3 Old GH Guile API

      Guile 1.8 and older could be interfaced using two different api's, the SCM @@ -80,7 +80,7 @@ or the GH API. The GH interface to guile is deprecated. Read more about why in version of SWIG that can still generate guile GH wrapper code is 2.0.9. Please use that version if you really need the GH wrapper code. -

      23.4 Linkage

      +

      24.4 Linkage

      @@ -88,7 +88,7 @@ Guile support is complicated by a lack of user community cohesiveness, which manifests in multiple shared-library usage conventions. A set of policies implementing a usage convention is called a linkage. -

      23.4.1 Simple Linkage

      +

      24.4.1 Simple Linkage

      @@ -158,8 +158,8 @@ following module-system hack:

       (module-map (lambda (sym var)
      -	      (module-export! (current-module) (list sym)))
      -	    (current-module))
      +              (module-export! (current-module) (list sym)))
      +            (current-module))
       
      @@ -193,7 +193,7 @@ placed between the define-module form and the SWIG_init via a preprocessor define to avoid symbol clashes. For this case, however, passive linkage is available. -

      23.4.2 Passive Linkage

      +

      24.4.2 Passive Linkage

      Passive linkage is just like simple linkage, but it generates an @@ -203,7 +203,7 @@ package name (see below).

      You should use passive linkage rather than simple linkage when you are using multiple modules. -

      23.4.3 Native Guile Module Linkage

      +

      24.4.3 Native Guile Module Linkage

      SWIG can also generate wrapper code that does all the Guile module @@ -244,7 +244,7 @@ Newer Guile versions have a shorthand procedure for this:

    -

    23.4.4 Old Auto-Loading Guile Module Linkage

    +

    24.4.4 Old Auto-Loading Guile Module Linkage

    Guile used to support an autoloading facility for object-code @@ -270,7 +270,7 @@ option, SWIG generates an exported module initialization function with an appropriate name. -

    23.4.5 Hobbit4D Linkage

    +

    24.4.5 Hobbit4D Linkage

    @@ -295,7 +295,7 @@ my/lib/libfoo.so.X.Y.Z and friends. This scheme is still very experimental; the (hobbit4d link) conventions are not well understood.

    -

    23.5 Underscore Folding

    +

    24.5 Underscore Folding

    @@ -307,7 +307,7 @@ complained so far. %rename to specify the Guile name of the wrapped functions and variables (see CHANGES). -

    23.6 Typemaps

    +

    24.6 Typemaps

    @@ -399,7 +399,7 @@ constant will appear as a scheme variable. See Features and the %feature directive for info on how to apply the %feature.

    -

    23.7 Representation of pointers as smobs

    +

    24.7 Representation of pointers as smobs

    @@ -420,7 +420,7 @@ representing the expected pointer type. See also If the Scheme object passed was not a SWIG smob representing a compatible pointer, a wrong-type-arg exception is raised. -

    23.7.1 Smobs

    +

    24.7.1 Smobs

    @@ -439,7 +439,7 @@ structure describing this type. If a generated GOOPS module has been loaded, sm the corresponding GOOPS class.

    -

    23.7.2 Garbage Collection

    +

    24.7.2 Garbage Collection

    Garbage collection is a feature of Guile since version 1.6. As SWIG now requires Guile > 1.8, @@ -453,7 +453,7 @@ is exactly like described in 23.8 Exception Handling +

    24.8 Exception Handling

    @@ -462,16 +462,16 @@ mapping:

    -      MAP(SWIG_MemoryError,	"swig-memory-error");
    -      MAP(SWIG_IOError,		"swig-io-error");
    -      MAP(SWIG_RuntimeError,	"swig-runtime-error");
    -      MAP(SWIG_IndexError,	"swig-index-error");
    -      MAP(SWIG_TypeError,	"swig-type-error");
    -      MAP(SWIG_DivisionByZero,	"swig-division-by-zero");
    -      MAP(SWIG_OverflowError,	"swig-overflow-error");
    -      MAP(SWIG_SyntaxError,	"swig-syntax-error");
    -      MAP(SWIG_ValueError,	"swig-value-error");
    -      MAP(SWIG_SystemError,	"swig-system-error");
    +      MAP(SWIG_MemoryError,     "swig-memory-error");
    +      MAP(SWIG_IOError,         "swig-io-error");
    +      MAP(SWIG_RuntimeError,    "swig-runtime-error");
    +      MAP(SWIG_IndexError,      "swig-index-error");
    +      MAP(SWIG_TypeError,       "swig-type-error");
    +      MAP(SWIG_DivisionByZero,  "swig-division-by-zero");
    +      MAP(SWIG_OverflowError,   "swig-overflow-error");
    +      MAP(SWIG_SyntaxError,     "swig-syntax-error");
    +      MAP(SWIG_ValueError,      "swig-value-error");
    +      MAP(SWIG_SystemError,     "swig-system-error");
     
    @@ -479,7 +479,7 @@ mapping: The default when not specified here is to use "swig-error". See Lib/exception.i for details. -

    23.9 Procedure documentation

    +

    24.9 Procedure documentation

    If invoked with the command-line option -procdoc @@ -514,7 +514,7 @@ like this: typemap argument doc. See Lib/guile/typemaps.i for details. -

    23.10 Procedures with setters

    +

    24.10 Procedures with setters

    For global variables, SWIG creates a single wrapper procedure @@ -542,7 +542,7 @@ struct members, the procedures (struct-member-get pointer) and (struct-member-set pointer value) are not generated. -

    23.11 GOOPS Proxy Classes

    +

    24.11 GOOPS Proxy Classes

    SWIG can also generate classes and generic functions for use with @@ -688,7 +688,7 @@ Notice that <Foo> is used before it is defined. The fix is to just put th %import "foo.h" before the %inline block.

    -

    23.11.1 Naming Issues

    +

    24.11.1 Naming Issues

    As you can see in the example above, there are potential naming conflicts. The default exported @@ -725,7 +725,7 @@ guile-modules. For example,

    (use-modules ((Test) #:renamer (symbol-prefix-proc 'goops:))) -

    23.11.2 Linking

    +

    24.11.2 Linking

    The guile-modules generated above all need to be linked together. GOOPS support requires diff --git a/Doc/Manual/Introduction.html b/Doc/Manual/Introduction.html index a8d15a5..1c29f47 100644 --- a/Doc/Manual/Introduction.html +++ b/Doc/Manual/Introduction.html @@ -1,12 +1,13 @@ - + Introduction + -

    2 Introduction

    +

    2 Introduction

      @@ -31,14 +32,14 @@ -

      2.1 What is SWIG?

      +

      2.1 What is SWIG?

      SWIG is a software development tool that simplifies the task of interfacing different languages to C and C++ programs. In a nutshell, SWIG is a compiler that takes C/C++ declarations and creates -the wrappers needed to access those declarations from other languages including +the wrappers needed to access those declarations from other languages including Perl, Python, Tcl, Ruby, Guile, and Java. SWIG normally requires no modifications to existing code and can often be used to build a usable interface in only a few minutes. Possible applications @@ -49,7 +50,7 @@ of SWIG include:

    • Building interpreted interfaces to existing C programs.
    • Rapid prototyping and application development.
    • Interactive debugging. -
    • Reengineering or refactoring of legacy software into a scripting language components. +
    • Reengineering or refactoring of legacy software into scripting language components.
    • Making a graphical user interface (using Tk for example).
    • Testing of C libraries and programs (using scripts).
    • Building high performance C modules for scripting languages. @@ -71,7 +72,7 @@ small; especially the research and development work that is commonly found in scientific and engineering projects. However, nowadays SWIG is known to be used in many large open source and commercial projects. -

      2.2 Why use SWIG?

      +

      2.2 Why use SWIG?

      @@ -98,7 +99,7 @@ of other libraries).

    • Testing is time consuming (the compile/debug cycle).
    • Not easy to reconfigure or customize without recompilation.
    • Modularization can be tricky. -
    • Security concerns (buffer overflow for instance). +
    • Security concerns (buffer overflows for instance).

    To address these limitations, many programmers have arrived at the @@ -143,7 +144,7 @@ it provides a wide variety of customization features that let you change almost every aspect of the language bindings. This is the main reason why SWIG has such a large user manual ;-). -

    2.3 A SWIG example

    +

    2.3 A SWIG example

    @@ -157,14 +158,16 @@ following C code: double My_variable = 3.0; /* Compute factorial of n */ -int fact(int n) { - if (n <= 1) return 1; - else return n*fact(n-1); +int fact(int n) { + if (n <= 1) + return 1; + else + return n*fact(n-1); } /* Compute n mod m */ int my_mod(int n, int m) { - return(n % m); + return(n % m); }

    @@ -174,7 +177,7 @@ variable My_variable from Tcl. You start by making a SWIG interface file as shown below (by convention, these files carry a .i suffix) : -

    2.3.1 SWIG interface file

    +

    2.3.1 SWIG interface file

    @@ -199,7 +202,7 @@ module that will be created by SWIG.  The %{ %} block
     provides a location for inserting additional code, such as C header
     files or additional C declarations, into the generated C wrapper code.
     
    -

    2.3.2 The swig command

    +

    2.3.2 The swig command

    @@ -221,8 +224,7 @@ unix > tclsh 7.5 %

    -

    - +

    The swig command produced a new file called example_wrap.c that should be compiled along with the example.c file. Most operating systems and scripting @@ -233,7 +235,7 @@ and variables declared in the SWIG interface. A look at the file example_wrap.c reveals a hideous mess. However, you almost never need to worry about it. -

    2.3.3 Building a Perl5 module

    +

    2.3.3 Building a Perl5 module

    @@ -244,8 +246,8 @@ any changes type the following (shown for Solaris):

     unix > swig -perl5 example.i
     unix > gcc -c example.c example_wrap.c \
    -	-I/usr/local/lib/perl5/sun4-solaris/5.003/CORE
    -unix > ld -G example.o example_wrap.o -o example.so		# This is for Solaris
    +        -I/usr/local/lib/perl5/sun4-solaris/5.003/CORE
    +unix > ld -G example.o example_wrap.o -o example.so # This is for Solaris
     unix > perl5.003
     use example;
     print example::fact(4), "\n";
    @@ -259,7 +261,7 @@ unix >
     
    -

    2.3.4 Building a Python module

    +

    2.3.4 Building a Python module

    @@ -283,7 +285,7 @@ Type "copyright", "credits" or "license" for more information. 7.5 -

    2.3.5 Shortcuts

    +

    2.3.5 Shortcuts

    @@ -296,7 +298,7 @@ SWIG on the C header file and specifying a module name as follows

     unix > swig -perl5 -module example example.h
     unix > gcc -c example.c example_wrap.c \
    -	-I/usr/local/lib/perl5/sun4-solaris/5.003/CORE
    +        -I/usr/local/lib/perl5/sun4-solaris/5.003/CORE
     unix > ld -G example.o example_wrap.o -o example.so
     unix > perl5.003
     use example;
    @@ -309,7 +311,7 @@ print $example::My_variable + 4.5, "\n";
     7.5
     
    -

    2.4 Supported C/C++ language features

    +

    2.4 Supported C/C++ language features

    @@ -334,8 +336,7 @@ major features include:

    -Currently, the only major C++ feature not supported is nested classes--a limitation -that should be removed in a future release, but has some workarounds for the moment. +Most of C++11 is also supported. Details are in the C++11 section.

    @@ -345,11 +346,11 @@ not only parses C++, it implements the full C++ type system and it is able to understand C++ semantics. SWIG generates its wrappers with full knowledge of this information. As a result, you will find SWIG to be just as capable of dealing with nasty corner cases as it is in -wrapping simple C++ code. In fact, SWIG is able handle C++ code that +wrapping simple C++ code. In fact, SWIG is able to handle C++ code that stresses the very limits of many C++ compilers. -

    2.5 Non-intrusive interface building

    +

    2.5 Non-intrusive interface building

    @@ -361,7 +362,7 @@ interface and reuse the code in other applications. It is also possible to support different types of interfaces depending on the application.

    -

    2.6 Incorporating SWIG into a build system

    +

    2.6 Incorporating SWIG into a build system

    @@ -384,12 +385,12 @@ for further information on this and other Autoconf macros.

    -There is growing support for SWIG in some build tools, for example CMake +There is growing support for SWIG in some build tools, for example CMake is a cross-platform, open-source build manager with built in support for SWIG. CMake can detect the SWIG executable and many of the target language libraries for linking against. CMake knows how to build shared libraries and loadable modules on many different operating systems. -This allows easy cross platform SWIG development. It also can generate the custom commands necessary for -driving SWIG from IDE's and makefiles. All of this can be done from a single cross platform input file. +This allows easy cross platform SWIG development. It can also generate the custom commands necessary for +driving SWIG from IDEs and makefiles. All of this can be done from a single cross platform input file. The following example is a CMake input file for creating a python wrapper for the SWIG interface file, example.i:

    @@ -419,7 +420,7 @@ which will invoke SWIG and compile the generated C++ files into _example.so (UNI For other target languages on Windows a dll, instead of a .pyd file, is usually generated.

    -

    2.7 Hands off code generation

    +

    2.7 Hands off code generation

    @@ -432,7 +433,7 @@ it allows others to forget about the low-level implementation details.

    -

    2.8 SWIG and freedom

    +

    2.8 SWIG and freedom

    @@ -449,7 +450,7 @@ to work with complicated and unusual C/C++ applications.

    Ironically, the freedom that SWIG provides is countered by an -extremely conservative approach to code generation. At it's core, SWIG +extremely conservative approach to code generation. At its core, SWIG tries to distill even the most advanced C++ code down to a small well-defined set of interface building techniques based on ANSI C programming. Because of this, you will find that SWIG interfaces can @@ -458,6 +459,12 @@ be used on any platform. Again, this is an important part of staying out of the programmer's way----the last thing any developer wants to do is to spend their time debugging the output of a tool that relies on non-portable or unreliable programming features. +Dependencies are often a source of incompatibilities and problems and so +additional third party libraries are not used in the generated code. +SWIG will also generally avoid generating code that introduces a dependency +on the C++ Standard Template Library (STL). +SWIG will generate code that depends on the C libraries though. +

    diff --git a/Doc/Manual/Java.html b/Doc/Manual/Java.html index 0024d60..d3c5926 100644 --- a/Doc/Manual/Java.html +++ b/Doc/Manual/Java.html @@ -1,11 +1,12 @@ - + SWIG and Java + -

    24 SWIG and Java

    +

    25 SWIG and Java

  • Further details on the generated Java classes +
  • Interfaces
  • Cross language polymorphism using directors
  • Accessing protected members
  • Common customization features @@ -156,7 +163,7 @@ It covers most SWIG features, but certain low-level details are covered in less

    -

    24.1 Overview

    +

    25.1 Overview

    @@ -191,7 +198,7 @@ Various customisation tips and techniques using SWIG directives are covered. The latter sections cover the advanced techniques of using typemaps for complete control of the wrapping process.

    -

    24.2 Preliminaries

    +

    25.2 Preliminaries

    @@ -208,10 +215,10 @@ The Java module requires your system to support shared libraries and dynamic loa This is the commonly used method to load JNI code so your system will more than likely support this.

    -Android uses Java JNI and also works with SWIG. Please read the Android chapter in conjunction with this one if you are targeting Android. +Android uses Java JNI and also works with SWIG. Please read the Android chapter in conjunction with this one if you are targeting Android.

    -

    24.2.1 Running SWIG

    +

    25.2.1 Running SWIG

    @@ -270,7 +277,7 @@ The following sections have further practical examples and details on how you mi compiling and using the generated files.

    -

    24.2.2 Additional Commandline Options

    +

    25.2.2 Additional Commandline Options

    @@ -307,7 +314,7 @@ swig -java -help Their use will become clearer by the time you have finished reading this section on SWIG and Java.

    -

    24.2.3 Getting the right header files

    +

    25.2.3 Getting the right header files

    @@ -322,7 +329,7 @@ They are usually in directories like this:

    The exact location may vary on your machine, but the above locations are typical.

    -

    24.2.4 Compiling a dynamic module

    +

    25.2.4 Compiling a dynamic module

    @@ -331,8 +338,8 @@ Assuming you have code you need to link to in a file called example.c,

     $ swig -java example.i
    -$ gcc -c example_wrap.c  -I/usr/java/include -I/usr/java/include/solaris
    -$ gcc -c example.c
    +$ gcc -fPIC -c example_wrap.c -I/usr/java/include -I/usr/java/include/solaris
    +$ gcc -fPIC -c example.c
     $ ld -G example_wrap.o example.o -o libexample.so
     
    @@ -344,8 +351,6 @@ directory. If that doesn't work, you will need to read the man-pages for your compiler and linker to get the right set of options. You might also check the SWIG Wiki for additional information. -JNI compilation -is a useful reference for compiling on different platforms.

    @@ -357,9 +362,9 @@ more aggressive from gcc-4.0 onwards and will result in code that fails with str

    The name of the shared library output file is important. If the name of your SWIG module is "example", the name of the corresponding shared library file should be "libexample.so" (or equivalent depending on your machine, see Dynamic linking problems for more information). -The name of the module is specified using the %module directive or -module command line option.

    +The name of the module is specified using the %module directive or -module command line option.

    -

    24.2.5 Using your module

    +

    25.2.5 Using your module

    @@ -394,7 +399,7 @@ $ If it doesn't work have a look at the following section which discusses problems loading the shared library.

    -

    24.2.6 Dynamic linking problems

    +

    25.2.6 Dynamic linking problems

    @@ -460,9 +465,9 @@ If you forget to compile and link in the SWIG wrapper file into your native libr

     $ java runme
     Exception in thread "main" java.lang.UnsatisfiedLinkError: exampleJNI.gcd(II)I
    -	at exampleJNI.gcd(Native Method)
    -	at example.gcd(example.java:12)
    -	at runme.main(runme.java:18)
    +        at exampleJNI.gcd(Native Method)
    +        at example.gcd(example.java:12)
    +        at runme.main(runme.java:18)
     

    @@ -481,7 +486,7 @@ The following section also contains some C++ specific linking problems and solut

    -

    24.2.7 Compilation problems and compiling with C++

    +

    25.2.7 Compilation problems and compiling with C++

    @@ -492,8 +497,7 @@ compiler. For example:

     % swig -c++ -java example.i
     % g++ -c -fpic example.cxx
    -% g++ -c -fpic example_wrap.cxx -I/usr/java/j2sdk1.4.1/include -I/usr/java/
    -j2sdk1.4.1/include/linux
    +% g++ -c -fpic example_wrap.cxx -I/usr/java/j2sdk1.4.1/include -I/usr/java/j2sdk1.4.1/include/linux
     % g++ -shared example.o example_wrap.o -o libexample.so
     
    @@ -534,7 +538,7 @@ Finally make sure the version of JDK header files matches the version of Java th

    -

    24.2.8 Building on Windows

    +

    25.2.8 Building on Windows

    @@ -543,7 +547,7 @@ You will want to produce a DLL that can be loaded by the Java Virtual Machine. This section covers the process of using SWIG with Microsoft Visual C++ 6 although the procedure may be similar with other compilers. In order for everything to work, you will need to have a JDK installed on your machine in order to read the JNI header files.

    -

    24.2.8.1 Running SWIG from Visual Studio

    +

    25.2.8.1 Running SWIG from Visual Studio

    @@ -582,7 +586,7 @@ To run the native code in the DLL (example.dll), make sure that it is in your pa If the library fails to load have a look at Dynamic linking problems.

    -

    24.2.8.2 Using NMAKE

    +

    25.2.8.2 Using NMAKE

    @@ -627,11 +631,11 @@ CFLAGS = /Z7 /Od /c /nologo JAVA_INCLUDE = -ID:\jdk1.3\include -ID:\jdk1.3\include\win32 java:: - swig -java -o $(WRAPFILE) $(INTERFACE) - $(CC) $(CFLAGS) $(JAVA_INCLUDE) $(SRCS) $(WRAPFILE) - set LIB=$(TOOLS)\lib - $(LINK) $(LOPT) -out:example.dll $(LIBS) example.obj example_wrap.obj - javac *.java + swig -java -o $(WRAPFILE) $(INTERFACE) + $(CC) $(CFLAGS) $(JAVA_INCLUDE) $(SRCS) $(WRAPFILE) + set LIB=$(TOOLS)\lib + $(LINK) $(LOPT) -out:example.dll $(LIBS) example.obj example_wrap.obj + javac *.java

    @@ -641,7 +645,7 @@ Of course you may want to make changes for it to work for C++ by adding in the -

    -

    24.3 A tour of basic C/C++ wrapping

    +

    25.3 A tour of basic C/C++ wrapping

    @@ -651,7 +655,7 @@ variables are wrapped with JavaBean type getters and setters and so forth. This section briefly covers the essential aspects of this wrapping.

    -

    24.3.1 Modules, packages and generated Java classes

    +

    25.3.1 Modules, packages and generated Java classes

    @@ -687,7 +691,7 @@ swig -java -package com.bloggs.swig -outdir com/bloggs/swig example.i SWIG won't create the directory, so make sure it exists beforehand.

    -

    24.3.2 Functions

    +

    25.3.2 Functions

    @@ -721,7 +725,7 @@ System.out.println(example.fact(4)); -

    24.3.3 Global variables

    +

    25.3.3 Global variables

    @@ -808,7 +812,7 @@ extern char *path; // Read-only (due to %immutable) -

    24.3.4 Constants

    +

    25.3.4 Constants

    @@ -948,7 +952,7 @@ Or if you decide this practice isn't so bad and your own class implements ex

    -

    24.3.5 Enumerations

    +

    25.3.5 Enumerations

    @@ -962,7 +966,7 @@ The final two approaches use simple integers for each enum item. Before looking at the various approaches for wrapping named C/C++ enums, anonymous enums are considered.

    -

    24.3.5.1 Anonymous enums

    +

    25.3.5.1 Anonymous enums

    @@ -1025,7 +1029,7 @@ As in the case of constants, you can access them through either the module class

    -

    24.3.5.2 Typesafe enums

    +

    25.3.5.2 Typesafe enums

    @@ -1119,7 +1123,7 @@ When upgrading to JDK 1.5 or later, proper Java enums could be used instead, wit The following section details proper Java enum generation.

    -

    24.3.5.3 Proper Java enums

    +

    25.3.5.3 Proper Java enums

    @@ -1172,7 +1176,7 @@ The additional support methods need not be generated if none of the enum items h Simpler Java enums for enums without initializers section.

    -

    24.3.5.4 Type unsafe enums

    +

    25.3.5.4 Type unsafe enums

    @@ -1220,7 +1224,7 @@ Note that unlike typesafe enums, this approach requires users to mostly use diff Thus the upgrade path to proper enums provided in JDK 1.5 is more painful.

    -

    24.3.5.5 Simple enums

    +

    25.3.5.5 Simple enums

    @@ -1239,7 +1243,7 @@ SWIG-1.3.21 and earlier versions wrapped all enums using this approach. The type unsafe approach is preferable to this one and this simple approach is only included for backwards compatibility with these earlier versions of SWIG.

    -

    24.3.6 Pointers

    +

    25.3.6 Pointers

    @@ -1327,7 +1331,7 @@ C-style cast may return a bogus result whereas as the C++-style cast will return a NULL pointer if the conversion can't be performed.

    -

    24.3.7 Structures

    +

    25.3.7 Structures

    @@ -1337,7 +1341,7 @@ member variables. For example,

     struct Vector {
    -	double x,y,z;
    +  double x,y,z;
     };
     
     
    @@ -1495,7 +1499,7 @@ x.setA(3); // Modify x.a - this is the same as b.f.a -

    24.3.8 C++ classes

    +

    25.3.8 C++ classes

    @@ -1558,7 +1562,7 @@ int bar = Spam.getBar(); -

    24.3.9 C++ inheritance

    +

    25.3.9 C++ inheritance

    @@ -1619,7 +1623,7 @@ Note that Java does not support multiple inheritance so any multiple inheritance A warning is given when multiple inheritance is detected and only the first base class is used.

    -

    24.3.10 Pointers, references, arrays and pass by value

    +

    25.3.10 Pointers, references, arrays and pass by value

    @@ -1674,7 +1678,7 @@ to hold the result and a pointer is returned (Java will release this memory when the returned object's finalizer is run by the garbage collector).

    -

    24.3.10.1 Null pointers

    +

    25.3.10.1 Null pointers

    @@ -1698,7 +1702,7 @@ For spam1 and spam4 above the Java null gets translat The converse also occurs, that is, NULL pointers are translated into null Java objects when returned from a C/C++ function.

    -

    24.3.11 C++ overloaded functions

    +

    25.3.11 C++ overloaded functions

    @@ -1813,7 +1817,7 @@ void spam(unsigned short); // Ignored -

    24.3.12 C++ default arguments

    +

    25.3.12 C++ default arguments

    @@ -1856,7 +1860,7 @@ Further details on default arguments and how to restore this approach are given

    -

    24.3.13 C++ namespaces

    +

    25.3.13 C++ namespaces

    @@ -1946,7 +1950,7 @@ If the resulting use of the nspace feature and hence packages results in a proxy you will need to open up the visibility for the pointer constructor and getCPtr method from the default 'protected' to 'public' with the SWIG_JAVABODY_PROXY macro. See Java code typemaps.

    -

    24.3.14 C++ templates

    +

    25.3.14 C++ templates

    @@ -1995,7 +1999,21 @@ Obviously, there is more to template wrapping than shown in this example. More details can be found in the SWIG and C++ chapter.

    -

    24.3.15 C++ Smart Pointers

    +

    25.3.15 C++ Smart Pointers

    + + +

    25.3.15.1 The shared_ptr Smart Pointer

    + + +

    +The C++11 standard provides std::shared_ptr which was derived from the Boost +implementation, boost::shared_ptr. +Both of these are available for Java in the SWIG library and usage is outlined +in the shared_ptr smart pointer library section. +

    + + +

    25.3.15.2 Generic Smart Pointers

    @@ -2079,7 +2097,7 @@ Foo f = p.__deref__(); // Returns underlying Foo * -

    24.4 Further details on the generated Java classes

    +

    25.4 Further details on the generated Java classes

    @@ -2094,7 +2112,7 @@ Finally enum classes are covered. First, the crucial intermediary JNI class is considered.

    -

    24.4.1 The intermediary JNI class

    +

    25.4.1 The intermediary JNI class

    @@ -2214,7 +2232,7 @@ If name is the same as modulename then the module class name g from modulename to modulenameModule.

    -

    24.4.1.1 The intermediary JNI class pragmas

    +

    25.4.1.1 The intermediary JNI class pragmas

    @@ -2271,7 +2289,7 @@ The jniclasscode pragma is quite useful for adding in a static block fo %pragma(java) jniclasscode=%{ static { try { - System.loadLibrary("example"); + System.loadLibrary("example"); } catch (UnsatisfiedLinkError e) { System.err.println("Native code library failed to load. \n" + e); System.exit(1); @@ -2296,7 +2314,7 @@ For example, let's change the intermediary JNI class access to just the default All the methods in the intermediary JNI class will then not be callable outside of the package as the method modifiers have been changed from public access to default access. This is useful if you want to prevent users calling these low level functions.

    -

    24.4.2 The Java module class

    +

    25.4.2 The Java module class

    @@ -2327,7 +2345,7 @@ example.egg(new Foo()); The primary reason for having the module class wrapping the calls in the intermediary JNI class is to implement static type checking. In this case only a Foo can be passed to the egg function, whereas any long can be passed to the egg function in the intermediary JNI class.

    -

    24.4.2.1 The Java module class pragmas

    +

    25.4.2.1 The Java module class pragmas

    @@ -2378,7 +2396,7 @@ See The intermediary JNI class pragmas secti

    -

    24.4.3 Java proxy classes

    +

    25.4.3 Java proxy classes

    @@ -2390,8 +2408,8 @@ The default proxy class for our previous example looks like this:

     public class Foo {
    -  private long swigCPtr;
    -  protected boolean swigCMemOwn;
    +  private transient long swigCPtr;
    +  protected transient boolean swigCMemOwn;
     
       protected Foo(long cPtr, boolean cMemoryOwn) {
         swigCMemOwn = cMemoryOwn;
    @@ -2441,7 +2459,7 @@ It also contains all the methods in the C++ class it is proxying plus getters an
     member variables. These functions call the native methods in the intermediary JNI class. 
     The advantage of having this extra layer is the type safety that the proxy class functions offer. 
     It adds static type checking which leads to fewer surprises at runtime. 
    -For example, you can see that if you attempt to use the  spam()  
    +For example, you can see that if you attempt to use the spam()
     function it will only compile when the parameters passed are an int and a Foo. 
     From a user's point of view, it makes the class work as if it were a Java class:
     

    @@ -2454,7 +2472,7 @@ int y = f.spam(5, new Foo());
    -

    24.4.3.1 Memory management

    +

    25.4.3.1 Memory management

    @@ -2616,7 +2634,7 @@ and

    -

    24.4.3.2 Inheritance

    +

    25.4.3.2 Inheritance

    @@ -2641,8 +2659,8 @@ The base class is generated much like any other proxy class seen so far:

     public class Base {
    -  private long swigCPtr;
    -  protected boolean swigCMemOwn;
    +  private transient long swigCPtr;
    +  protected transient boolean swigCMemOwn;
     
       protected Base(long cPtr, boolean cMemoryOwn) {
         swigCMemOwn = cMemoryOwn;
    @@ -2682,7 +2700,7 @@ The Derived class extends Base mirroring the C++ class inherit
     
     
     public class Derived extends Base {
    -  private long swigCPtr;
    +  private transient long swigCPtr;
     
       protected Derived(long cPtr, boolean cMemoryOwn) {
         super(exampleJNI.SWIGDerivedUpcast(cPtr), cMemoryOwn);
    @@ -2732,7 +2750,7 @@ However, true cross language polymorphism can be achieved using the 24.4.3.3 Proxy classes and garbage collection
    +

    25.4.3.3 Proxy classes and garbage collection

    @@ -2815,7 +2833,7 @@ The section on Java typemaps details how to specify See the How to Handle Java Finalization's Memory-Retention Issues article for alternative approaches to managing memory by avoiding finalizers altogether.

    -

    24.4.3.4 The premature garbage collection prevention parameter for proxy class marshalling

    +

    25.4.3.4 The premature garbage collection prevention parameter for proxy class marshalling

    @@ -2937,7 +2955,7 @@ For example: Compatibility note: The generation of this additional parameter did not occur in versions prior to SWIG-1.3.30.

    -

    24.4.3.5 Single threaded applications and thread safety

    +

    25.4.3.5 Single threaded applications and thread safety

    @@ -2960,8 +2978,8 @@ and the Java proxy class generated by SWIG:

     public class Test {
    -  private long swigCPtr;
    -  protected boolean swigCMemOwn;
    +  private transient long swigCPtr;
    +  protected transient boolean swigCMemOwn;
     
       protected Test(long cPtr, boolean cMemoryOwn) {
         swigCMemOwn = cMemoryOwn;
    @@ -3025,7 +3043,7 @@ for (int i=0; i<100000; i++) {
     
    -

    24.4.4 Type wrapper classes

    +

    25.4.4 Type wrapper classes

    @@ -3034,7 +3052,7 @@ The generated type wrapper class, for say an int *, looks like this:

     public class SWIGTYPE_p_int {
    -  private long swigCPtr;
    +  private transient long swigCPtr;
     
       protected SWIGTYPE_p_int(long cPtr, boolean bFutureUse) {
         swigCPtr = cPtr;
    @@ -3112,7 +3130,7 @@ public static void spam(SWIGTYPE_p_int x, SWIGTYPE_p_int y, int z) { ... }
     
    -

    24.4.5 Enum classes

    +

    25.4.5 Enum classes

    @@ -3121,7 +3139,7 @@ The Enumerations section discussed these but om The following sub-sections detail the various types of enum classes that can be generated.

    -

    24.4.5.1 Typesafe enum classes

    +

    25.4.5.1 Typesafe enum classes

    @@ -3205,7 +3223,7 @@ The swigValue method is used for marshalling in the other direction. The toString method is overridden so that the enum name is available.

    -

    24.4.5.2 Proper Java enum classes

    +

    25.4.5.2 Proper Java enum classes

    @@ -3283,7 +3301,7 @@ These needn't be generated if the enum being wrapped does not have any initializ Simpler Java enums for enums without initializers section describes how typemaps can be used to achieve this.

    -

    24.4.5.3 Type unsafe enum classes

    +

    25.4.5.3 Type unsafe enum classes

    @@ -3314,7 +3332,252 @@ public final class Beverage {

    -

    24.5 Cross language polymorphism using directors

    +

    25.4.6 Interfaces

    + + +

    +By default SWIG wraps all C++ classes as Java classes. +As Java only supports derivation from a single base class, SWIG has to ignore all +bases except the first when a C++ class inherits from more than one base class. +However, there is a family of SWIG macros that change the default wrapping and allows a C++ class +to be wrapped as a Java interface instead of a Java class. +These macros provide a way to support some sort of multiple inheritance as there is no limit to +the number of interfaces that a Java class can inherit from. +

    + +

    +When a C++ class is wrapped as a Java interface, a Java proxy class is still needed. +The swiginterface.i library file provides three macros for marking a C++ class to be +wrapped as a Java interface. +There is more than one macro in order to provide a choice for choosing the Java interface and Java proxy names. +

    + + + + + + + + + + + + + + + + + + +
    Interface Macro NameDescription
    %interface(CTYPE)Proxy class name is unchanged, interface name has SwigInterface added as a suffix for C++ class CTYPE.
    %interface_impl(CTYPE)Proxy class name has SwigImpl as a suffix, interface name has SwigInterface added as a suffix for C++ class CTYPE.
    %interface_custom("PROXY", "INTERFACE", CTYPE)Proxy class name is given by the string PROXY, interface name is given by the string INTERFACE for C++ class CTYPE. The PROXY and INTERFACE names can use the string formatting functions used in %rename.
    + +

    +The table below has a few examples showing the resulting proxy and interface names. +

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Example UsageProxy Class NameInterface Class Name
    %interface(Base)BaseBaseSwigInterface
    %interface_impl(Base)BaseSwigImplBase
    %interface_custom("BaseProxy", "IBase", Base)BaseProxyIBase
    %interface_custom("%sProxy", "IBase", Base)BaseProxyIBase
    %interface_custom("%sProxy", "%sInterface", Base)BaseProxyBaseProxyInterface
    %interface_custom("%sProxy", "%(rstrip:[Proxy])sInterface", Base)BaseProxyBaseInterface
    + +

    +The 2nd last example shows the names used in the string formatting functions. +The input for PROXY that "%s" expands to is the proxy name, that is, Base. +The input for INTERFACE that "%s" expands to is the proxy name, that is, BaseProxy. +

    +

    +The last example shows rstrip and in this case strips the Proxy suffix and then adds on Interface. +

    + +

    +Consider the following C++ code: +

    + +
    +
    +namespace Space {
    +  struct Base1 {
    +    virtual void Method1();
    +  };
    +  struct Base2 {
    +    virtual void Method2();
    +  };
    +  struct Derived : Base1, Base2 {
    +  };
    +  void UseBases(const Base1 &b1, const Base2 &b2);
    +}
    +
    +
    + +

    +By default all classes are wrapped and are available in Java, but, Derived +has all bases ignored except the first. +SWIG generates a warning for the above code: +

    + +
    +
    +example.i:10: Warning 813: Warning for Derived, base Base2 ignored. 
    +Multiple inheritance is not supported in Java.
    +
    +
    + +

    +If we decide to wrap the two base classes as interfaces and add the following before SWIG parses the above example code: +

    + +
    +
    +%include <swiginterface.i>
    +%interface_impl(Space::Base1);
    +%interface_impl(Space::Base2);
    +
    +
    + +

    +then two interface files are generated, Base1.java and Base2.java in addition to proxy class files, Base1SwigImpl.java and Base2SwigImpl.java. +The contents of interface file Base1.java for Base1 is shown below: +

    + +
    +
    +public interface Base1 {
    +  long Base1_GetInterfaceCPtr();
    +  void Method1();
    +}
    +
    +
    + +

    +The proxy class in Base1SwigImpl.java for Base1 is as it would have been if %interface was not used, +except the name has changed to Base1SwigImpl and it implements the appropriate base: +

    + +
    +
    +public class Base1SwigImpl implements Base1 {
    +...
    +  public long Base1_GetInterfaceCPtr() {
    +    return exampleJNI.Base1SwigImpl_Base1_GetInterfaceCPtr(swigCPtr);
    +  }
    +
    +  public void Method1() {
    +    exampleJNI.Base1SwigImpl_Method1(swigCPtr, this);
    +  }
    +...
    +}
    +
    +
    + +

    +In fact any class deriving from Base will now implement the interface instead of +deriving from it (or ignoring the base in the case of multiple base classes). +Hence the Derived proxy class will now implement both bases: +

    + +
    +
    +public class Derived implements Base1, Base2 {
    +...
    +  public long Base1_GetInterfaceCPtr() {
    +    return exampleJNI.Derived_Base1_GetInterfaceCPtr(swigCPtr);
    +  }
    +
    +  public long Base2_GetInterfaceCPtr() {
    +    return exampleJNI.Derived_Base2_GetInterfaceCPtr(swigCPtr);
    +  }
    +
    +  public void Method1() {
    +    exampleJNI.Derived_Method1(swigCPtr, this);
    +  }
    +
    +  public void Method2() {
    +    exampleJNI.Derived_Method2(swigCPtr, this);
    +  }
    +...
    +}
    +
    +
    + +

    +Wherever a class marked as an interface is used, such as the UseBases method in the example, +the interface name is used as the type in the Java layer: +

    + +
    +
    +  public static void UseBases(Base1 b1, Base2 b2) {
    +    exampleJNI.UseBases(b1.Base1_GetInterfaceCPtr(), b1, b2.Base2_GetInterfaceCPtr(), b2);
    +  }
    +
    +
    + +

    +Note that each Java interface has a method added to obtain the correct C++ pointer for passing to the native function - +Base1_GetInterfaceCPtr for Base1. +This method is similar to the getCPtr method in the proxy classes. +In fact, as shown above in the Derived class, the proxy classes implement +this generated interface by calling a native method (Derived_Base1_GetInterfaceCPtr) +which calls an appropriate C++ cast of the pointer up the inheritance chain. +

    + +

    +The interface macros are implemented using the interface feature and typemaps. +For example: +

    + +
    +
    +%define %interface(CTYPE...)
    +%feature("interface", name="%sSwigInterface") CTYPE;
    +INTERFACE_TYPEMAPS(CTYPE)
    +%enddef
    +
    +
    + +

    +The feature accepts one attribute called name, which is the name of the Java interface mentioned earlier. +The INTERFACE_TYPEMAPS macro implements the typemaps and can be viewed in the +swiginterface.i file and contain +the usual Java typemaps for generating code plus the javainterfacecode +typemap which is only used when a class is marked with the interface feature. +See Java code typemaps for details. +

    + +

    25.5 Cross language polymorphism using directors

    @@ -3336,7 +3599,7 @@ The upshot is that C++ classes can be extended in Java and from C++ these extens Neither C++ code nor Java code needs to know where a particular method is implemented: the combination of proxy classes, director classes, and C wrapper functions transparently takes care of all the cross-language method routing.

    -

    24.5.1 Enabling directors

    +

    25.5.1 Enabling directors

    @@ -3404,7 +3667,7 @@ public:

    -

    24.5.2 Director classes

    +

    25.5.2 Director classes

    @@ -3431,7 +3694,7 @@ If the correct implementation is in Java, the Java API is used to call the metho

    -

    24.5.3 Overhead and code bloat

    +

    25.5.3 Overhead and code bloat

    @@ -3449,7 +3712,7 @@ This situation can be optimized by selectively enabling director methods (using

    -

    24.5.4 Simple directors example

    +

    25.5.4 Simple directors example

    @@ -3514,7 +3777,7 @@ DirectorDerived::upcall_method() invoked. -

    24.5.5 Director threading issues

    +

    25.5.5 Director threading issues

    @@ -3534,7 +3797,7 @@ Macros can be defined on the commandline when compiling your C++ code, or altern -

    24.5.6 Director performance tuning

    +

    25.5.6 Director performance tuning

    @@ -3555,8 +3818,315 @@ However, if all director methods are expected to usually be overridden by Java s The disadvantage is that invocation of director methods from C++ when Java doesn't actually override the method will require an additional call up into Java and back to C++. As such, this option is only useful when overrides are extremely common and instantiation is frequent enough that its performance is critical.

    +

    25.5.7 Java exceptions from directors

    + + +

    +With directors routing method calls to Java, and proxies routing them +to C++, the handling of exceptions is an important concern. +The default behavior from SWIG 3.0 +onwards is to convert the thrown Java exception into a SWIG defined +DirectorException C++ exception. +SWIG 2.0 and earlier versions didn't provide any mechanism to handle the Java director method exceptions in C++. +

    + +

    +Converting Java exceptions into C++ exceptions can be done in two different ways using +the director:except feature. +In the simplest approach, a code block is attached to each director method to +handle the mapping of Java exceptions into C++ exceptions. +

    + +
    +
    +%feature("director:except") MyClass::method(int x) {
    +  jthrowable $error = jenv->ExceptionOccurred();
    +  if ($error) {
    +    jenv->ExceptionClear();
    +    if (Swig::ExceptionMatches(jenv, $error, "java/lang/IndexOutOfBoundsException"))
    +      throw std::out_of_range(Swig::JavaExceptionMessage(jenv, $error).message());
    +    if (Swig::ExceptionMatches(jenv, $error, "$packagepath/MyJavaException"))
    +      throw MyCppException(Swig::JavaExceptionMessage(jenv, $error).message());
    +    throw std::runtime_error("Unexpected exception thrown in MyClass::method");
    +  }
    +}
    +
    +class MyClass {
    +  /** Throws either a std::out_of_range or MyCppException on error */
    +  void method(int x);
    +}
    +
    +
    + +

    +This approach allows a flexible mapping of Java exceptions thrown by director methods into +C++ exceptions expected by a C++ caller. There +need not be any C++ exception specifications on the C++ method. The +utility function Swig::ExceptionMatches +and class Swig::JavaExceptionMessage are provided to simplify +writing code for wrappers that use the director:except feature. The +function Swig::ExceptionMatches matches the type of the +jthrowable thrown against a fully qualified JNI style class +name, such as "java/lang/IOError". If the throwable class is the same +type, or derives from the given type, Swig::ExceptionMatches will return true. Care must be taken to +provide the correct fully qualified name, since for wrapped exceptions the +generated proxy class will have additional package qualification, depending on +the '-package' argument and use of the nspace + feature. The special variable $error is expanded by SWIG into a unique variable name and +should be used for the +assignment of the exception that occurred. The special variable $packagepath is +replaced by the outer package provided for SWIG generation by the -package +option. The utility class Swig::JavaExceptionMessage is a holder +providing access to the message from the thrown Java exception. +The message() method returns the exception message as a const char *, +which is only valid during the lifetime of the holder. Any code using this message +needs to copy it, for example into a std::string or a newly constructed C++ exception. +

    + +

    +Using the above approach to +write handlers for a large number of methods will require +repetitive duplication of the director:except feature code. +To mitigate this, an alternative approach is provided via typemaps in a +fashion analagous to +the "throws" typemap. The +"throws" typemap provides an approach to automatically map all the C++ +exceptions listed in a method's defined exceptions (either from +a C++ exception specification or a %catches +feature) into Java exceptions. +The "directorthrows" typemap provides the inverse mapping and should contain +code to convert a suitably matching Java exception into a C++ exception. +The example below converts a Java java.lang.IndexOutOfBoundsException exception +to the typemap's type, that is std::out_of_range: + +

    +
    +%typemap(directorthrows) std::out_of_range %{
    +  if (Swig::ExceptionMatches(jenv, $error, "java/lang/IndexOutOfBoundsException")) {
    +    throw std::out_of_range(Swig::JavaExceptionMessage(jenv, $error).message());
    +  }
    +%}
    +
    +
    + +

    +The "directorthrows" typemap is then used in conjunction with the +director:except feature if the $directorthrowshandlers special variable +is used in the feature code. Consider the following, which also happens to be the default: +

    + +
    +
    +%feature("director:except") %{
    +   jthrowable $error = jenv->ExceptionOccurred();
    +   if ($error) {
    +     jenv->ExceptionClear();
    +     $directorthrowshandlers
    +     throw Swig::DirectorException(jenv, $error);
    +   }
    +%}
    +
    +
    + +

    The code generated using the director:except feature +replaces the $directorthrowshandlers special variable with the code in +the "directorthrows" typemaps, for each and every exception defined for the method. +The possible exceptions can be defined either with a C++ exception +specification or %catches as described for the +"throws" typemap. +

    + +

    +Consider the following director method: +

    + +
    +
    +  ...
    +  virtual void doSomething(int index) throw (std::out_of_range);
    +  ...
    +
    +
    + +

    +When combined with the default director:except feature and the "directorthrows" typemap above, +the resulting code generated in the director method after calling up to Java will be: +

    + +
    +
    +jthrowable swigerror = jenv->ExceptionOccurred();
    +if (swigerror) {
    +  jenv->ExceptionClear();
    +  if (Swig::ExceptionMatches(jenv, swigerror, "java/lang/IndexOutOfBoundsException")) {
    +    throw std::out_of_range(Swig::JavaExceptionMessage(jenv, swigerror).message());
    +  }
    +  
    +  throw Swig::DirectorException(jenv, swigerror);
    +}
    +
    +
    + +

    +Note: Beware of using exception specifications as the SWIG director methods +will be generated with the same exception specifications and if the +director method throws an exception that is not specified it is likely +to terminate your program. See the C++ standard for more details. +Using the %catches feature instead to define the handled exceptions does not suffer +this potential fate. +

    + +

    Because the default code generation maps any unhandled Java exceptions to +Swig::DirectorException, any director methods that have exception +specifications may cause program termination. To simply ignore +unexpected exceptions, the default handling can be changed with: +

    + +
    +
    +%feature("director:except") %{
    +   jthrowable $error = jenv->ExceptionOccurred();
    +   if ($error) {
    +     jenv->ExceptionClear();
    +     $directorthrowshandlers
    +     return $null; // exception is ignored
    +   }
    +%}
    +
    +
    + +

    Alternatively an exception compatible with the existing director +method exception specifications can be thrown. Assuming that all +methods allow std::runtime_error to be thrown, +the return $null; could be changed to: +

    + +
    +
    +   throw std::runtime_error(Swig::JavaExceptionMessage(jenv, $error).message());
    +
    +
    + +

    In more complex situations, a separate director:except feature +may need to be attached to specific methods. +

    + +

    Below is a complete example demonstrating the use +of the "directorthrows" typemaps. In this example, a +generic "directorthrows" typemap is appropriate for all three exceptions - all +take single string constructors. If the exceptions had different constructors, +it would be necessary to have separate typemaps for each exception type. + + + +

    +
    +%module(directors="1") example
    +
    +%{
    +  #include <string>
    +  #include <stdexcept>
    +%}
    +
    +// Define exceptions in header section using std::runtime_error
    +%define DEFINE_EXCEPTION(NAME)
    +%{
    +  namespace MyNS {
    +    struct NAME : public std::runtime_error { NAME(const std::string &what) : runtime_error(what) {} };
    +  }
    +%}
    +%enddef
    +
    +// Expose C++ exceptions as Java Exceptions by changing the Java base class and providing a getMessage()
    +%define DECLARE_EXCEPTION(NAME)
    +%typemap(javabase) MyNS::NAME "java.lang.Exception";
    +%rename(getMessage) MyNS::NAME::what;
    +namespace MyNS {
    +  struct NAME {
    +    NAME(const std::string& what);
    +    const char * what();
    +  };
    +}
    +%enddef
    +
    +DEFINE_EXCEPTION(ExceptionA)
    +DEFINE_EXCEPTION(ExceptionB)
    +DEFINE_EXCEPTION(Unexpected)
    +
    +// Mark three methods to map director thrown exceptions.
    +%feature("director:except") MyClass::meth1(int);
    +%feature("director:except") MyClass::meth2;
    +%feature("director:except") meth3;
    +
    +%typemap(directorthrows) MyNS::ExceptionA, MyNS::ExceptionB, MyNS::Unexpected %{
    +  if (Swig::ExceptionMatches(jenv, $error, "$packagepath/$javaclassname"))
    +    throw $1_type(Swig::JavaExceptionMessage(jenv, $error).message());
    +%}
    +
    +DECLARE_EXCEPTION(ExceptionA)
    +DECLARE_EXCEPTION(ExceptionB)
    +DECLARE_EXCEPTION(Unexpected)
    +
    +%catches(MyNS::ExceptionA, MyNS::ExceptionB, MyNS::Unexpected) MyClass::meth2();
    +
    +%inline {
    +  class MyClass {
    +  public:
    +    virtual void meth1(int x) throw(MyNS::ExceptionA, MyNS::ExceptionB) = 0;
    +    virtual void meth2() = 0;   /* throws MyNS::ExceptionA, MyNS::ExceptionB, MyNS::Unexpected */
    +    virtual void meth3(float x) throw(MyNS::Unexpected) = 0;
    +    virtual ~MyClass() {}
    +  };
    +}
    +
    +
    + +

    +In this case the three different "directorthrows" typemaps will be used +to generate the three different exception handlers for +meth1, meth2 and meth3. The generated +handlers will have "if" blocks for each exception type specified, in +the exception specification or %catches feature. +

    + +

    Note that the "directorthrows" typemaps are important +only if it is important for the the exceptions passed through the C++ +layer to be mapped to distinct C++ exceptions. If director methods +are being called by C++ code that is itself wrapped in a +SWIG generated Java wrapper and access is always through this wrapper, +the default Swig::DirectorException class provides enough information +to reconstruct the original exception. In this case removing the +$directorthrowshandlers special variable from the +default director:except feature and simply always +throwing a Swig::DirectorException will achieve the desired result. +Along with this a generic exception feature is added to convert any +caught Swig::DirectorExceptions back into the underlying +Java exceptions via the Swig::DirectorException::raiseJavaException method, +as demonstrated with %javaexception below: +

    -

    24.6 Accessing protected members

    +
    +
    +%javaexception("Exception") MyClass::myMethod %{
    +  try {
    +    $action
    +  } catch (Swig::DirectorException &e) {
    +    // raise/throw the Java exception that originally caused the DirectorException
    +    e.raiseJavaException(jenv);
    +    return $null;
    +  }
    +%}
    +
    +
    + +

    +See the Exception handling with %exception and %javaexception +section for more on converting C++ exceptions to Java exceptions. +

    + +

    25.6 Accessing protected members

    @@ -3652,7 +4222,7 @@ class MyProtectedBase extends ProtectedBase -

    24.7 Common customization features

    +

    25.7 Common customization features

    @@ -3664,7 +4234,7 @@ be awkward. This section describes some common SWIG features that are used to improve the interface to existing C/C++ code.

    -

    24.7.1 C/C++ helper functions

    +

    25.7.1 C/C++ helper functions

    @@ -3730,7 +4300,7 @@ hard to implement. It is possible to improve on this using Java code, typemaps, customization features as covered in later sections, but sometimes helper functions are a quick and easy solution to difficult cases.

    -

    24.7.2 Class extension with %extend

    +

    25.7.2 Class extension with %extend

    @@ -3793,7 +4363,7 @@ Vector(2,3,4) in any way---the extensions only show up in the Java interface.

    -

    24.7.3 Exception handling with %exception and %javaexception

    +

    25.7.3 Exception handling with %exception and %javaexception

    @@ -3866,8 +4436,8 @@ void *malloc(size_t nbytes);

    If no declaration name is given to %exception, it is applied to all wrapper functions. -The $action is a SWIG special variable and is replaced by the C/C++ function call being wrapped. -The return $null; handles all native method return types, namely those that have a void return and those that do not. +The $action is a SWIG special variable and is replaced by the C/C++ function call being wrapped. +The return $null; handles all native method return types, namely those that have a void return and those that do not. This is useful for typemaps that will be used in native method returning all return types. See the section on Java special variables for further explanation. @@ -3952,7 +4522,7 @@ to raise exceptions. See the SWIG Library ch The typemap example Handling C++ exception specifications as Java exceptions provides further exception handling capabilities.

    -

    24.7.4 Method access with %javamethodmodifiers

    +

    25.7.4 Method access with %javamethodmodifiers

    @@ -3978,7 +4548,7 @@ protected static void protect_me() { -

    24.8 Tips and techniques

    +

    25.8 Tips and techniques

    @@ -3988,7 +4558,7 @@ strings and arrays. This chapter discusses the common techniques for solving these problems.

    -

    24.8.1 Input and output parameters using primitive pointers and references

    +

    25.8.1 Input and output parameters using primitive pointers and references

    @@ -4162,7 +4732,7 @@ void foo(Bar *OUTPUT); will not have the intended effect since typemaps.i does not define an OUTPUT rule for Bar.

    -

    24.8.2 Simple pointers

    +

    25.8.2 Simple pointers

    @@ -4228,7 +4798,7 @@ System.out.println("3 + 4 = " + result); See the SWIG Library chapter for further details.

    -

    24.8.3 Wrapping C arrays with Java arrays

    +

    25.8.3 Wrapping C arrays with Java arrays

    @@ -4295,7 +4865,7 @@ Please be aware that the typemaps in this library are not efficient as all the e There is an alternative approach using the SWIG array library and this is covered in the next section.

    -

    24.8.4 Unbounded C Arrays

    +

    25.8.4 Unbounded C Arrays

    @@ -4440,7 +5010,7 @@ well suited for applications in which you need to create buffers, package binary data, etc.

    -

    24.8.5 Binary data vs Strings

    +

    25.8.5 Binary data vs Strings

    @@ -4484,7 +5054,7 @@ len: 5 data: 68 69 0 6a 6b -

    24.8.6 Overriding new and delete to allocate from Java heap

    +

    25.8.6 Overriding new and delete to allocate from Java heap

    @@ -4601,7 +5171,7 @@ model and use these functions in place of malloc and free in your own code.

    -

    24.9 Java typemaps

    +

    25.9 Java typemaps

    @@ -4622,7 +5192,7 @@ Before proceeding, it should be stressed that typemaps are not a required part of using SWIG---the default wrapping behavior is enough in most cases. Typemaps are only used if you want to change some aspect of the generated code. -

    24.9.1 Default primitive type mappings

    +

    25.9.1 Default primitive type mappings

    @@ -4774,7 +5344,7 @@ However, the mappings allow the full range of values for each C type from Java.

    -

    24.9.2 Default typemaps for non-primitive types

    +

    25.9.2 Default typemaps for non-primitive types

    @@ -4789,7 +5359,7 @@ So in summary, the C/C++ pointer to non-primitive types is cast into the 64 bit The Java type is either the proxy class or type wrapper class.

    -

    24.9.3 Sixty four bit JVMs

    +

    25.9.3 Sixty four bit JVMs

    @@ -4802,7 +5372,7 @@ Unfortunately it won't of course hold true for JNI code.

    -

    24.9.4 What is a typemap?

    +

    25.9.4 What is a typemap?

    @@ -4925,7 +5495,7 @@ int c = example.count('e',"Hello World"); -

    24.9.5 Typemaps for mapping C/C++ types to Java types

    +

    25.9.5 Typemaps for mapping C/C++ types to Java types

    @@ -5183,9 +5753,18 @@ These are listed below: Use for mapping NULL terminated arrays of C strings to Java String arrays + +unsigned char * +NIOBUFFER +various.i +input
    output +java.nio.Buffer +Use for mapping directly allocated buffers to c/c++. useful with directors and long lived memory objects + + -

    24.9.6 Java typemap attributes

    +

    25.9.6 Java typemap attributes

    @@ -5231,7 +5810,7 @@ The "javain" typemap has the optional 'pre', 'post' and 'pgcppname' attributes. Note that when the 'pre' or 'post' attributes are specified and the associated type is used in a constructor, a constructor helper function is generated. This is necessary as the Java proxy constructor wrapper makes a call to a support constructor using a this call. In Java the this call must be the first statement in the constructor body. The constructor body thus calls the helper function and the helper function instead makes the JNI call, ensuring the 'pre' code is called before the JNI call is made. There is a Date marshalling example showing 'pre', 'post' and 'pgcppname' attributes in action.

    -

    24.9.7 Java special variables

    +

    25.9.7 Java special variables

    @@ -5252,6 +5831,8 @@ For example, $javaclassname is replaced by the proxy classname Foo< expands to the proxy classname when wrapping Foo *&. If the type does not have an associated proxy class, it expands to the type wrapper class name, for example, SWIGTYPE_p_unsigned_short is generated when wrapping unsigned short *. +The class name is fully qualified with the package name when using the +nspace feature.

    @@ -5263,7 +5844,7 @@ This special variable is usually used for making calls to a function in the inte

    -$null
    +$null
    Used in input typemaps to return early from JNI functions that have either void or a non-void return type. Example:

    @@ -5367,7 +5948,7 @@ can be wrapped with the Java equivalent, that is, static inner proxy classes.

    -$jniinput, $javacall and $packagepath
    +$error, $jniinput, $javacall and $packagepath
    These special variables are used in the directors typemaps. See Director specific typemaps for details.

    @@ -5382,7 +5963,36 @@ This special variable expands to the intermediary class name. Usually this is th unless the jniclassname attribute is specified in the %module directive.

    -

    24.9.8 Typemaps for both C and C++ compilation

    +

    +$javainterfacename
    +This special variable is only expanded when the interface feature is applied to a class. +It works much like $javaclassname, but instead of expanding to the proxy classname, +it expands to the value in the name attribute in the interface feature. +For example: +

    + +
    +%feature("interface", name="MyInterface") MyClass;
    +%typemap(jstype) MyClass  "$&javainterfacename"
    +%typemap(jstype) MyClass * "$javainterfacename"
    +
    + +

    +will result in the jstype typemap expanding to MyInterface for both +MyClass and MyClass *. +The interface name is fully qualified with the package name when using the +nspace feature. +

    + +

    +$interfacename
    +This special variable is only expanded when the interface feature is applied to a class. +It expands to just the interface name and is thus different to $javainterfacename +in that it is not fully qualified with the package name when using the +nspace feature. +

    + +

    25.9.8 Typemaps for both C and C++ compilation

    @@ -5419,7 +6029,7 @@ If you do not intend your code to be targeting both C and C++ then your typemaps

    -

    24.9.9 Java code typemaps

    +

    25.9.9 Java code typemaps

    @@ -5515,9 +6125,39 @@ Below shows an example modifying the finalizer, assuming the delete met +

    %typemap(javainterfacecode, declaration="...", cptrmethod="...")

    +
    +

    +The code in this typemap is added to the body of a Java proxy class but only when a class is +marked with the interface feature. +The typemap is used in the proxy class marked with the interface feature as well as all proxy classes derived from the marked C++ class, +as they are all generated as implementing the Java interface. +The default typemap used in the %interface family of macros mentioned in +the Java interfaces section, +where CTYPE is the C++ class macro argument, +is as follows: +

    + +
    +%typemap(javainterfacecode,
    +         declaration="  long $interfacename_GetInterfaceCPtr();\n",
    +         cptrmethod="$interfacename_GetInterfaceCPtr") CTYPE %{
    +  public long $interfacename_GetInterfaceCPtr() {
    +    return $imclassname.$javaclazzname$interfacename_GetInterfaceCPtr(swigCPtr);
    +  }
    +%}
    +
    +
    + +

    +The special variable $interfacename is expanded into the +name specified in the interface feature. +

    +

    Compatibility Note: In SWIG-1.3.21 and earlier releases, typemaps called "javagetcptr" and "javaptrconstructormodifiers" were available. These are deprecated and the "javabody" typemap can be used instead. +The javainterfacecode typemap and interface feature was introduced in SWIG-3.0.9.

    @@ -5533,6 +6173,7 @@ In summary the contents of the typemaps make up a proxy class like this: [ javafinalize typemap ] public synchronized void delete() [ javadestruct OR javadestruct_derived typemap ] [ javacode typemap ] +[ javainterfacecode typemap] ... proxy functions ... } @@ -5543,6 +6184,11 @@ Note the delete() methodname and method modifiers are configurab

    +The javainterfacecode typemap is only used when bases are marked by the interface +feature and the implements list will also then be expanded to include these Java interfaces. +

    + +

    The type wrapper class is similar in construction:

    @@ -5574,8 +6220,23 @@ The type wrapper class is similar in construction: The "javaimports" typemap is ignored if the enum class is wrapped by an inner Java class, that is when wrapping an enum declared within a C++ class.

    +

    The Java interface turned on by the interface feature is fairly simple:

    +
    +
    +[ javaimports typemap ]
    +public interface [ javainterfacename ] {
    +[ javainterfacecode:cptrmethod typemap attribute ]
    +... interface declarations ...
    +}
    +
    +
    +

    -The defaults can be overridden to tailor these classes. +where javainterfacename is the name attribute in the interface feature. +

    + +

    +The defaults can be overridden to tailor the generated classes. Here is an example which will change the getCPtr method and constructor from the default public access to protected access. If the classes in one package are not using the classes in another package, then these methods need not be public and removing access to these low level implementation details, is a good thing. If you are invoking SWIG more than once and generating the wrapped classes into different packages in each invocation, then you cannot do this as you will then have different packages. @@ -5584,8 +6245,8 @@ If you are invoking SWIG more than once and generating the wrapped classes into

     %typemap(javabody) SWIGTYPE %{
    -  private long swigCPtr;
    -  protected boolean swigCMemOwn;
    +  private transient long swigCPtr;
    +  protected transient boolean swigCMemOwn;
     
       protected $javaclassname(long cPtr, boolean cMemoryOwn) {
         swigCMemOwn = cMemoryOwn;
    @@ -5613,7 +6274,7 @@ For the typemap to be used in all type wrapper classes, all the different types
     
     %typemap(javabody) SWIGTYPE *, SWIGTYPE &, SWIGTYPE [], SWIGTYPE (CLASS::*) %{
    -  private long swigCPtr;
    +  private transient long swigCPtr;
     
       protected $javaclassname(long cPtr, boolean bFutureUse) {
         swigCPtr = cPtr;
    @@ -5635,7 +6296,7 @@ Again this is the same that is in "java.swg", barring the method modifi
     

    -When using multiple modules or the nspace feature it is common to invoke SWIG with a different -package +When using multiple modules or the nspace feature it is common to invoke SWIG with a different -package command line option for each module. However, by default the generated code may not compile if generated classes in one package use generated classes in another package. @@ -5657,7 +6318,7 @@ to make the method and constructor public:

    -

    24.9.10 Director specific typemaps

    +

    25.9.10 Director specific typemaps

    @@ -5701,6 +6362,10 @@ is the package name passed from the SWIG command line and $javaclassname-package commandline option is not used to specify the package, then '$packagepath/' will be removed from the resulting output JNI field descriptor. Do not forget the terminating ';' for JNI field descriptors starting with 'L'. If the ';' is left out, Java will generate a "method not found" runtime error. +Note that the $packagepath substitution always uses the path separator '/' when expanded. +The $javaclassname expansion can be confusing as it is normally expanded using the '.' separator. +However, $javaclassname is expanded using the path separator '/' in typemap's "descriptor" attribute +as well as in the "directorthrows" typemap.

    @@ -5796,6 +6461,40 @@ The target method is the method in the Java proxy class which overrides the virt +

    %typemap(directorthrows)

    +
    + +

    +Conversion of Java exceptions to C++ exceptions in director method's exception handling. +This typemap is expected to test the $error special variable for a matching Java exception +and if successful convert and throw it into a C++ exception given by the typemap's type. +The $error special variable is of type jthrowable and is +substituted with a unique variable name in the generated code. +

    + +

    +The example below converts a Java java.lang.IndexOutOfBoundsException exception +to the typemap's type, that is std::out_of_range: +

    + +
    +
    +%typemap(directorthrows) std::out_of_range %{
    +  if (Swig::ExceptionMatches(jenv, $error, "java/lang/IndexOutOfBoundsException")) {
    +    throw std::out_of_range(Swig::JavaExceptionMessage(jenv, $error).message());
    +  }
    +%}
    +
    +
    + +

    +The utility function Swig::ExceptionMatches +and class Swig::JavaExceptionMessage are helpers available when using directors and are described +in the Java Exceptions from Directors section. +

    + +
    +

    %typemap(javapackage)

    @@ -5883,7 +6582,7 @@ The basic strategy here is to provide a default package typemap for the majority
    -

    24.10 Typemap Examples

    +

    25.10 Typemap Examples

    @@ -5893,7 +6592,7 @@ the SWIG library.

    -

    24.10.1 Simpler Java enums for enums without initializers

    +

    25.10.1 Simpler Java enums for enums without initializers

    @@ -5972,7 +6671,7 @@ This would be done by using the original versions of these typemaps in "enums.sw

    -

    24.10.2 Handling C++ exception specifications as Java exceptions

    +

    25.10.2 Handling C++ exception specifications as Java exceptions

    @@ -6097,7 +6796,7 @@ We could alternatively have used %rename to rename what() into

    -

    24.10.3 NaN Exception - exception handling for a particular type

    +

    25.10.3 NaN Exception - exception handling for a particular type

    @@ -6252,7 +6951,7 @@ If we were a martyr to the JNI cause, we could replace the succinct code within If we had, we would have put it in the "in" typemap which, like all JNI and Java typemaps, also supports the 'throws' attribute.

    -

    24.10.4 Converting Java String arrays to char **

    +

    25.10.4 Converting Java String arrays to char **

    @@ -6396,7 +7095,7 @@ Lastly the "jni", "jtype" and "jstype" typemaps are also required to specify what Java types to use.

    -

    24.10.5 Expanding a Java object to multiple arguments

    +

    25.10.5 Expanding a Java object to multiple arguments

    @@ -6478,7 +7177,7 @@ example.foo(new String[]{"red", "green", "blue", "white"}); -

    24.10.6 Using typemaps to return arguments

    +

    25.10.6 Using typemaps to return arguments

    @@ -6524,7 +7223,7 @@ int spam(double a, double b, double *out1, double *out2) { *out1 = a*10.0; *out2 = b*100.0; return status; -}; +} %} /* @@ -6596,7 +7295,7 @@ $ java runme 1 12.0 340.0 -

    24.10.7 Adding Java downcasts to polymorphic return types

    +

    25.10.7 Adding Java downcasts to polymorphic return types

    @@ -6802,7 +7501,7 @@ SWIG usually generates code which constructs the proxy classes using Java code a Note that the JNI code above uses a number of string lookups to call a constructor, whereas this would not occur using byte compiled Java code.

    -

    24.10.8 Adding an equals method to the Java classes

    +

    25.10.8 Adding an equals method to the Java classes

    @@ -6846,7 +7545,7 @@ System.out.println("foo1? " + foo1.equals(foo2)); -

    24.10.9 Void pointers and a common Java base class

    +

    25.10.9 Void pointers and a common Java base class

    @@ -6905,7 +7604,7 @@ This example contains some useful functionality which you may want in your code.

  • It also has a function which effectively implements a cast from the type of the proxy/type wrapper class to a void pointer. This is necessary for passing a proxy class or a type wrapper class to a function that takes a void pointer. -

    24.10.10 Struct pointer to pointer

    +

    25.10.10 Struct pointer to pointer

    @@ -7085,7 +7784,7 @@ The C functional interface has been completely morphed into an object-oriented i the Butler class would behave much like any pure Java class and feel more natural to Java users.

    -

    24.10.11 Memory management when returning references to member variables

    +

    25.10.11 Memory management when returning references to member variables

    @@ -7208,7 +7907,7 @@ public class Bike { Note the addReference call.

    -

    24.10.12 Memory management for objects passed to the C++ layer

    +

    25.10.12 Memory management for objects passed to the C++ layer

    @@ -7324,7 +8023,7 @@ The 'javacode' typemap simply adds in the specified code into the Java proxy cla -

    24.10.13 Date marshalling using the javain typemap and associated attributes

    +

    25.10.13 Date marshalling using the javain typemap and associated attributes

    @@ -7501,7 +8200,7 @@ A few things to note: -

    24.11 Living with Java Directors

    +

    25.11 Living with Java Directors

    @@ -7682,10 +8381,10 @@ public abstract class UserVisibleFoo extends Foo {

  • -

    24.12 Odds and ends

    +

    25.12 Odds and ends

    -

    24.12.1 JavaDoc comments

    +

    25.12.1 JavaDoc comments

    @@ -7741,7 +8440,7 @@ public class Barmy { -

    24.12.2 Functional interface without proxy classes

    +

    25.12.2 Functional interface without proxy classes

    @@ -7802,7 +8501,7 @@ All destructors have to be called manually for example the delete_Foo(foo) -

    24.12.3 Using your own JNI functions

    +

    25.12.3 Using your own JNI functions

    @@ -7852,7 +8551,7 @@ This directive is only really useful if you want to mix your own hand crafted JN

    -

    24.12.4 Performance concerns and hints

    +

    25.12.4 Performance concerns and hints

    @@ -7873,7 +8572,7 @@ However, you will have to be careful about memory management and make sure that This method normally calls the C++ destructor or free() for C code.

    -

    24.12.5 Debugging

    +

    25.12.5 Debugging

    @@ -7886,7 +8585,7 @@ where it is possible to step from Java code into a JNI method within one environ

    Alternatively, debugging can involve placing debug printout statements in the JNI layer using the %exception directive. See the special variables for %exception section. -Many of the default typemaps can also be overidden and modified for adding in extra logging/debug display information. +Many of the default typemaps can also be overridden and modified for adding in extra logging/debug display information.

    @@ -7895,7 +8594,7 @@ The -verbose:jni and -verbose:gc are also useful options for monitoring code beh

    -

    24.13 Java Examples

    +

    25.13 Java Examples

    diff --git a/Doc/Manual/Javascript.html b/Doc/Manual/Javascript.html new file mode 100644 index 0000000..16f6748 --- /dev/null +++ b/Doc/Manual/Javascript.html @@ -0,0 +1,999 @@ + + + + + + + + + +

    26 SWIG and Javascript

    + + + + + + +

    This chapter describes SWIG's support of Javascript. It does not cover SWIG basics, but only information that is specific to this module.

    + +

    26.1 Overview

    + + +

    Javascript is a prototype-based scripting language that is dynamic, weakly typed and has first-class functions. Its arguably the most popular language for web development. +Javascript has gone beyond being a browser-based scripting language and with node.js, it is also used as a backend development language.

    +

    Native Javascript extensions can be used for applications that embed a web-browser view or that embed a Javascript engine (such as node.js). Extending a general purpose web-browser is not possible as this would be a severe security issue.

    +

    SWIG Javascript currently supports JavascriptCore, the Javascript engine used by Safari/Webkit, and v8, which is used by Chromium and node.js.

    +

    WebKit is a modern browser implementation available as open-source which can be embedded into an application. +With node-webkit there is a platform which uses Google's Chromium as Web-Browser widget and node.js for javascript extensions. +

    + +

    26.2 Preliminaries

    + + +

    26.2.1 Running SWIG

    + + +

    Suppose that you defined a SWIG module such as the following:

    +
    +
    +%module example
    +%{
    +#include "example.h"
    +%}
    +int gcd(int x, int y);
    +extern double Foo;
    +
    +

    To build a Javascript module, run SWIG using the -javascript option and a desired target engine -jsc, -v8, or -node. The generator for node is essentially delegating to the v8 generator and adds some necessary preprocessor definitions.

    +
    +
    +$ swig -javascript -jsc example.i
    +
    +

    If building a C++ extension, add the -c++ option:

    +
    +
    +$ swig -c++ -javascript -jsc example.i
    +
    +

    The V8 code that SWIG generates should work with most versions from 3.11.10 up to 3.29.14 and later.

    +

    The API headers for V8 >= 4.3.0 define constants which SWIG can use to +determine the V8 version it is compiling for. For versions < 4.3.0, you +need to specify the V8 version when running SWIG. This is specified as a hex +constant, but the constant is read as pairs of decimal digits, so for V8 +3.25.30 use constant 0x032530. This scheme can't represent components > 99, +but this constant is only useful for V8 < 4.3.0, and no V8 versions from +that era had a component > 99. For example:

    +
    +
    +$ swig -c++ -javascript -v8 -DV8_VERSION=0x032530 example.i
    +
    +

    If you're targetting V8 >= 4.3.0, you would just run swig like so:

    +
    +
    +$ swig -c++ -javascript -v8 example.i
    +
    +

    This creates a C/C++ source file example_wrap.c or example_wrap.cxx. The generated C source file contains the low-level wrappers that need to be compiled and linked with the rest of your C/C++ application to create an extension module.

    +

    The name of the wrapper file is derived from the name of the input file. For example, if the input file is example.i, the name of the wrapper file is example_wrap.c. To change this, you can use the -o option. The wrapped module will export one function which must be called to register the module with the Javascript interpreter. For example, if your module is named example the corresponding initializer for JavascriptCore would be

    +
    +
    +bool example_initialize(JSGlobalContextRef context, JSObjectRef *exports)
    +
    +

    and for v8:

    +
    +
    +void example_initialize(v8::Handle<v8::Object> exports)
    +
    +

    +Note: be aware that v8 has a C++ API, and thus, the generated modules must be compiled as C++. +

    + +

    26.2.2 Running Tests and Examples

    + + +

    The configuration for tests and examples currently supports Linux and Mac only and not MinGW (Windows) yet.

    +

    The default interpreter is node.js as it is available on all platforms and convenient to use.

    +

    Running the examples with JavascriptCore requires libjavascriptcoregtk-1.0 to be installed, e.g., under Ubuntu with

    +
    +
    +$ sudo apt-get install libjavascriptcoregtk-1.0-dev
    +
    +

    Running with V8 requires libv8:

    +
    +
    +$ sudo apt-get install libv8-dev
    +
    +

    Examples can be run using

    +
    +
    +$ make check-javascript-examples ENGINE=jsc
    +
    +

    ENGINE can be node, jsc, or v8.

    +

    The test-suite can be run using

    +
    +
    +$ make check-javascript-test-suite ENGINE=jsc
    +
    +

    You can specify a specific V8 version for running the examples and tests

    +
    +
    +$ make check-javascript-examples V8_VERSION=0x032530 ENGINE=v8
    +
    + +

    26.2.3 Known Issues

    + + +

    At the moment, the Javascript generators pass all tests syntactically, i.e., the generated source code compiles. However, there are still remaining runtime issues.

    + +
      +
    • Default optional arguments do not work for all targeted interpreters

    • +
    • Multiple output arguments do not work for JSC

    • +
    • C89 incompatibily: the JSC generator might still generate C89 violating code

    • +
    • long long is not supported

    • +
    • %native is not supported

    • +
    • Javascript callbacks are not supported

    • +
    • instanceOf does not work under JSC

    • +
    + +

    The primary development environment has been Linux (Ubuntu 12.04). Windows and Mac OS X have been tested sporadically. Therefore, the generators might have more issues on those platforms. Please report back any problem you observe to help us improving this module quickly.

    + +

    26.3 Integration

    + + +

    This chapter gives a short introduction how to use a native Javascript extension: as a node.js module, and as an extension for an embedded Webkit.

    + +

    26.3.1 Creating node.js Extensions

    + + +

    To install node.js you can download an installer from their web-site for Mac OS X and Windows. For Linux you can either build the source yourself and run sudo checkinstall or keep to the (probably stone-age) packaged version. For Ubuntu there is a PPA available.

    +
    +
    +$ sudo add-apt-repository ppa:chris-lea/node.js
    +$ sudo apt-get update
    +$ sudo apt-get install nodejs
    +
    +

    As v8 is written in C++ and comes as a C++ library it is crucial to compile your module using the same compiler flags as used for building v8. To make things easier, node.js provides a build tool called node-gyp.

    +

    You have to install it using npm:

    +
    +
    +$ sudo npm install -g node-gyp
    +
    +

    node-gyp expects a configuration file named binding.gyp which is basically in JSON format and conforms to the same format that is used with Google's build-tool gyp.

    +

    binding.gyp:

    +
    +
    +{
    +  "targets": [
    +    {
    +      "target_name": "example",
    +      "sources": [ "example.cxx", "example_wrap.cxx" ]
    +    }
    +  ]
    +}
    +
    +

    First create the wrapper using SWIG:

    +
    +
    +$ swig -javascript -node -c++ example.i
    +
    +

    Then run node-gyp build to actually create the module:

    +
    +
    +$ node-gyp build
    +
    +

    This will create a build folder containing the native module. To use the extension you need to 'require' it in your Javascript source file:

    +
    +
    +require("./build/Release/example")
    +
    +

    A more detailed explanation is given in the Examples section.

    + +

    26.3.1.1 Troubleshooting

    + + +
      +
    • 'module' object has no attribute 'script_main'
    • +
    +

    This error happens when gyp is installed as a distribution package. It seems to be outdated. Removing it resolves the problem.

    +
    +
    +$ sudo apt-get remove gyp
    +
    + +

    26.3.2 Embedded Webkit

    + + +

    Webkit is pre-installed on Mac OS X and available as a library for GTK.

    + +

    26.3.2.1 Mac OS X

    + + +

    There is general information about programming with WebKit on Apple Developer Documentation. Details about Cocoa programming are not covered here.

    +

    An integration of a native extension 'example' would look like this:

    +
    +
    +#import "appDelegate.h"
    +
    +extern bool example_initialize(JSGlobalContextRef context, JSObjectRef* exports);
    +
    +
    +@implementation ExampleAppDelegate
    +
    +@synthesize webView;
    +
    +- (void)addGlobalObject:(JSContextRef) context:(NSString *)objectName:(JSObjectRef) theObject {
    +  JSObjectRef global = JSContextGetGlobalObject(context);
    +  JSStringRef objectJSName = JSStringCreateWithCFString( (CFStringRef) objectName )
    +  if ( objectJSName != NULL ) {
    +    JSObjectSetProperty(context, global, objectJSName, theObject, kJSPropertyAttributeReadOnly, NULL);
    +    JSStringRelease( objectJSName );
    +  }
    +}
    +
    +- (void)applicationDidFinishLaunching:(NSNotification *)aNotification {
    +
    +  // Start a webview with the bundled index.html file
    +  NSString *path = [[NSBundle mainBundle] bundlePath];
    +  NSString *url =  [NSString stringWithFormat: @"file://%@/Contents/Assets/index.html", path];
    +
    +  WebFrame *webframe = [webView mainFrame];
    +  JSGlobalContextRef context = [webframe globalContext];
    +
    +  JSObjectRef example;
    +  example_initialize(context, &example);
    +  [self addGlobalObject:context:@"example":example]
    +
    +  JSObjectSetProperty(context, global, JSStringRef propertyName, example, JSPropertyAttributes attributes, NULL);
    +
    +  [ [webView mainFrame] loadRequest:
    +    [NSURLRequest requestWithURL: [NSURL URLWithString:url] ]
    +  ];
    +}
    +
    +@end
    +
    + +

    26.3.2.2 GTK

    + + +

    There is general information about programming GTK at GTK documentation and in the GTK tutorial, and for Webkit there is a Webkit GTK+ API Reference.

    +

    An integration of a native extension 'example' would look like this:

    +
    +
    +#include <gtk/gtk.h>
    +#include <webkit/webkit.h>
    +
    +extern bool example_initialize(JSGlobalContextRef context);
    +
    +int main(int argc, char* argv[])
    +{
    +    // Initialize GTK+
    +    gtk_init(&argc, &argv);
    +
    +    ...
    +
    +    // Create a browser instance
    +    WebKitWebView *webView = WEBKIT_WEB_VIEW(webkit_web_view_new());
    +    WebFrame *webframe = webkit_web_view_get_main_frame(webView);
    +    JSGlobalContextRef context = webkit_web_frame_get_global_context(webFrame);
    +    JSObjectRef global = JSContextGetGlobalObject(context);
    +
    +    JSObjectRef exampleModule;
    +    example_initialize(context, &exampleModule);
    +    JSStringRef jsName = JSStringCreateWithUTF8CString("example");
    +    JSObjectSetProperty(context, global, jsName, exampleModule, kJSPropertyAttributeReadOnly, NULL);
    +    JSStringRelease(jsName);
    +
    +    ...
    +
    +    // Load a web page into the browser instance
    +    webkit_web_view_load_uri(webView, "http://www.webkitgtk.org/");
    +
    +    ...
    +
    +    // Run the main GTK+ event loop
    +    gtk_main();
    +
    +    return 0;
    +}
    +
    + +

    26.3.3 Creating Applications with node-webkit

    + + +

    To get started with node-webkit there is a very informative set of wiki pages.

    +

    Similar to node.js, node-webkit is started from command line within a node.js project directory. +Native extensions are created in the very same way as for node.js, except that a customized gyp derivate has to be used: nw-gyp. +

    + +

    +A simple example would have the following structure: +

    + +
    +
    +- package.json
    +- app.html
    +- app.js
    +- node_modules
    +  / example
    +  ... (as known from node.js)
    +
    +
    + +

    +The configuration file essentially conforms to node.js syntax. +It has some extras to configure node-webkit. See the Manifest specification for more details. +

    + +

    +package.json: +

    +
    +
    +{
    +  "name": "example",
    +  "main": "app.html",
    +  "window": {
    +    "show": true,
    +    "width": 800,
    +    "height": 600
    +  }
    +}
    +
    + +

    +The 'main' property of package.json specifies a web-page to be rendered in +the main window.

    + +

    +app.html: +

    + +
    +
    +<html>
    +  <head>
    +    <script src="app.js"></script>
    +  </head>
    +  <body>
    +    <div>
    +      The greatest common divisor of
    +      <span id="x"></span> and
    +      <span id="y"></span> is
    +      <span id="z"></span>.
    +    </div>
    +  </body>
    +</html>
    +
    + +

    +As known from node.js one can use require to load javascript modules. +Additionally, node-webkit provides an API that allows to manipulate the window's menu, +open new windows, and many more things. +

    + +

    +app.js: +

    + +
    +
    window.onload = function() {
    +  var example = require("example");
    +  var x = 18;
    +  var y = 24;
    +  var z = example.gcd(x,y);
    +  document.querySelector('#x').innerHTML = x;
    +  document.querySelector('#y').innerHTML = y;
    +  document.querySelector('#z').innerHTML = z;
    +};
    +
    + +

    26.4 Examples

    + + +

    Some basic examples are shown here in more detail.

    + +

    26.4.1 Simple

    + + +

    The common example simple looks like this:

    +
    +
    +/* File : example.i */
    +%module example
    +
    +%inline %{
    +extern int    gcd(int x, int y);
    +extern double Foo;
    +%}
    +
    +

    To make this available as a node extension a binding.gyp has to be created:

    +
    +
    +{
    +  "targets": [
    +    {
    +      "target_name": "example",
    +      "sources": [ "example.cxx", "example_wrap.cxx" ]
    +    }
    +  ]
    +}
    +
    +

    Then node-gyp is used to build the extension:

    +
    +
    +$ node-gyp configure build
    +
    +

    From a 'nodejs` application the extension would be used like this:

    +
    +
    +// import the extension via require
    +var example = require("./build/Release/example");
    +
    +// calling the global method
    +var x = 42;
    +var y = 105;
    +var g = example.gcd(x,y);
    +
    +// Accessing the global variable
    +var f = example.Foo;
    +example.Foo = 3.1415926;
    +
    +

    First the module example is loaded from the previously built extension. Global methods and variables are available in the scope of the module.

    + +

    Note: ECMAScript 5, the currently implemented Javascript standard, does not have modules. node.js and other implementations provide this mechanism defined by the CommonJS group. For browsers this is provided by Browserify, for instance.

    + +

    26.4.2 Class

    + + +

    The common example class defines three classes, Shape, Circle, and Square:

    +
    +
    +class Shape {
    +public:
    +  Shape() {
    +    nshapes++;
    +  }
    +  virtual ~Shape() {
    +    nshapes--;
    +  }
    +  double  x, y;
    +  void    move(double dx, double dy);
    +  virtual double area(void) = 0;
    +  virtual double perimeter(void) = 0;
    +  static  int nshapes;
    +};
    +
    +class Circle : public Shape {
    +private:
    +  double radius;
    +public:
    +  Circle(double r) : radius(r) { }
    +  virtual double area(void);
    +  virtual double perimeter(void);
    +};
    +
    +class Square : public Shape {
    +private:
    +  double width;
    +public:
    +  Square(double w) : width(w) { }
    +  virtual double area(void);
    +  virtual double perimeter(void);
    +};
    +
    +

    Circle and Square inherit from Shape. Shape has a static variable nshapes, a function move that can't be overridden (non-virtual), and two abstract functions area and perimeter (pure virtual) that must be overridden by the sub-classes.

    +

    A nodejs extension is built the same way as for the simple example.

    +

    In Javascript it can be used as follows:

    +
    +
    +var example = require("./build/Release/example");
    +
    +// local aliases for convenience
    +var Shape = example.Shape;
    +var Circle = example.Circle;
    +var Square = example.Square;
    +
    +// creating new instances using the 'new' operator
    +var c = new Circle(10);
    +var s = new Square(10);
    +
    +// accessing a static member
    +Shape.nshapes;
    +
    +// accessing member variables
    +c.x = 20;
    +c.y = 30;
    +s.x = -10;
    +s.y = 5;
    +
    +// calling some methods
    +c.area();
    +c.perimeter();
    +s.area();
    +s.perimeter();
    +
    +// instantiation of Shape is not permitted
    +new Shape();
    +
    +

    Running these commands in an interactive node shell results in the following output:

    +
    +
    +$ node -i
    +& var example = require("./build/Release/example");
    +undefined
    +& var Shape = example.Shape;
    +undefined
    +& var Circle = example.Circle;
    +undefined
    +& var Square = example.Square;
    +undefined
    +& var c = new Circle(10);
    +undefined
    +& var s = new Square(10);
    +undefined
    +& Shape.nshapes;
    +2
    +& c.x = 20;
    +20
    +& c.y = 30;
    +30
    +& s.x = -10;
    +-10
    +& s.y = 5;
    +5
    +& c.area();
    +314.1592653589793
    +& c.perimeter();
    +62.83185307179586
    +& s.area();
    +100
    +& s.perimeter();
    +40
    +& c.move(40, 40)
    +undefined
    +& c.x
    +60
    +& c.y
    +70
    +& new Shape()
    +Error: Class Shape can not be instantiated
    +at repl:1:2
    +at REPLServer.self.eval (repl.js:110:21)
    +at Interface.<anonymous> (repl.js:239:12)
    +at Interface.EventEmitter.emit (events.js:95:17)
    +at Interface._onLine (readline.js:202:10)
    +at Interface._line (readline.js:531:8)
    +at Interface._ttyWrite (readline.js:760:14)
    +at ReadStream.onkeypress (readline.js:99:10)
    +at ReadStream.EventEmitter.emit (events.js:98:17)
    +at emitKey (readline.js:1095:12)
    +
    +

    +Note: In ECMAScript 5 there is no concept for classes. Instead each function can be used as a constructor function which is executed by the 'new' operator. Furthermore, during construction the key property prototype of the constructor function is used to attach a prototype instance to the created object. A prototype is essentially an object itself that is the first-class delegate of a class used whenever the access to a property of an object fails. The very same prototype instance is shared among all instances of one type. Prototypal inheritance is explained in more detail on in Inheritance and the prototype chain, for instance. +

    + +

    26.5 Implementation

    + + +

    The Javascript Module implementation has taken a very different approach compared to other language modules in order to support different Javascript interpreters.

    + +

    26.5.1 Source Code

    + + +

    The Javascript module is implemented in Source/Modules/javascript.cxx. It dispatches the code generation to a JSEmitter instance, V8Emitter or JSCEmitter. Additionally there are some helpers: Template, for templated code generation, and JSEmitterState, which is used to manage state information during AST traversal. This rough map shall make it easier to find a way through this huge source file:

    +
    +
    +// module wide defines
    +
    +#define NAME "name"
    +...
    +
    +// ###############################
    +// #  Helper class declarations
    +
    +class JSEmitterState { ... };
    +
    +class Template { ... };
    +
    +// ###############################
    +// # JSEmitter declaration
    +
    +class JSEmitter { ... };
    +
    +// Emitter factory declarations
    +
    +JSEmitter *swig_javascript_create_JSCEmitter();
    +JSEmitter *swig_javascript_create_V8Emitter();
    +
    +// ###############################
    +// # Javascript module
    +
    +// Javascript module declaration
    +
    +class JAVASCRIPT:public Language { ... };
    +
    +// Javascript module implementation
    +
    +int JAVASCRIPT::functionWrapper(Node *n) { ... }
    +...
    +
    +// Module factory implementation
    +
    +static Language *new_swig_javascript() { ... }
    +
    +extern "C" Language *swig_javascript(void) { ... }
    +
    +// ###############################
    +// # JSEmitter base implementation
    +
    +JSEmitter::JSEmitter() { ... }
    +
    +Template JSEmitter::getTemplate(const String *name) { ... }
    +...
    +
    +// ###############################
    +// # JSCEmitter
    +
    +// JSCEmitter declaration
    +
    +class JSCEmitter: public JSEmitter { ... };
    +
    +// JSCEmitter implementation
    +
    +JSCEmitter::JSCEmitter() { ... }
    +
    +void JSCEmitter::marshalInputArgs(Node *n, ParmList *parms, Wrapper *wrapper, MarshallingMode mode, bool is_member, bool is_static) { ... }
    +...
    +
    +// JSCEmitter factory
    +
    +JSEmitter *swig_javascript_create_JSCEmitter() { ... }
    +
    +
    +// ###############################
    +// # V8Emitter
    +
    +// V8Emitter declaration
    +
    +class V8Emitter: public JSEmitter { ... };
    +
    +// V8Emitter implementation
    +
    +V8Emitter::V8Emitter() { ... }
    +
    +int V8Emitter::initialize(Node *n) { ... }
    +
    +// V8Emitter factory
    +
    +JSEmitter *swig_javascript_create_V8Emitter() { ... }
    +
    +
    +// ###############################
    +// # Helper implementation (JSEmitterState, Template)
    +
    +JSEmitterState::JSEmitterState() { ... }
    +...
    +
    +Template::Template(const String *code_) { ... }
    +...
    +
    + +

    26.5.2 Code Templates

    + + +

    All generated code is created on the basis of code templates. The templates for JavascriptCore can be found in Lib/javascript/jsc/javascriptcode.swg, for v8 in Lib/javascript/v8/javascriptcode.swg.

    +

    To track the originating code template for generated code you can run

    +
    +
    +$ swig -javascript -jsc -debug-codetemplates
    +
    +

    which wraps generated code with a descriptive comment

    +
    +
    +/* begin fragment("template_name") */
    +
    +...generated code ...
    +
    +/* end fragment("template_name") */
    +
    +

    The Template class is used like this:

    +
    +
    +Template t_register = getTemplate("jsv8_register_static_variable");
    +t_register.replace("$jsparent", state.clazz(NAME_MANGLED))
    +    .replace("$jsname", state.variable(NAME))
    +    .replace("$jsgetter", state.variable(GETTER))
    +    .replace("$jssetter", state.variable(SETTER))
    +    .trim().
    +    print(f_init_static_wrappers);
    +
    +

    A code template is registered with the JSEmitter via fragment(name, "template"), e.g.,

    +
    +
    +%fragment ("jsc_variable_declaration", "templates")
    +%{
    +  {"$jsname", $jsgetter, $jssetter, kJSPropertyAttributeNone},
    +%}
    +
    +

    Template creates a copy of that string and Template::replace uses Swig's Replaceall to replace variables in the template. Template::trim can be used to eliminate leading and trailing whitespaces. Template::print is used to write the final template string to a Swig DOH (based on Printv). All methods allow chaining.

    + +

    26.5.3 Emitter

    + + +

    The Javascript module delegates code generation to a JSEmitter instance. The following extract shows the essential interface:

    +
    +
    +class JSEmitter {
    +  ...
    +
    +  /**
    +   * Opens output files and temporary output DOHs.
    +   */
    +  virtual int initialize(Node *n);
    +
    +  /**
    +   * Writes all collected code into the output file(s).
    +   */
    +  virtual int dump(Node *n) = 0;
    +
    +  /**
    +   * Cleans up all open output DOHs.
    +   */
    +  virtual int close() = 0;
    +
    +  ...
    +
    +  /**
    +   * Invoked at the beginning of the classHandler.
    +   */
    +  virtual int enterClass(Node *);
    +
    +  /**
    +   * Invoked at the end of the classHandler.
    +   */
    +  virtual int exitClass(Node *) {
    +    return SWIG_OK;
    +  }
    +
    +  /**
    +   * Invoked at the beginning of the variableHandler.
    +   */
    +  virtual int enterVariable(Node *);
    +
    +  /**
    +   * Invoked at the end of the variableHandler.
    +   */
    +  virtual int exitVariable(Node *) {
    +    return SWIG_OK;
    +  }
    +
    +  /**
    +   * Invoked at the beginning of the functionHandler.
    +   */
    +  virtual int enterFunction(Node *);
    +
    +  /**
    +   * Invoked at the end of the functionHandler.
    +   */
    +  virtual int exitFunction(Node *) {
    +    return SWIG_OK;
    +  }
    +
    +  /**
    +   * Invoked by functionWrapper callback after call to Language::functionWrapper.
    +   */
    +  virtual int emitWrapperFunction(Node *n);
    +
    +  /**
    +   * Invoked from constantWrapper after call to Language::constantWrapper.
    +   **/
    +  virtual int emitConstant(Node *n);
    +
    +  /**
    +   * Registers a given code snippet for a given key name.
    +   *
    +   * This method is called by the fragmentDirective handler
    +   * of the JAVASCRIPT language module.
    +   **/
    +  int registerTemplate(const String *name, const String *code);
    +
    +  /**
    +   * Retrieve the code template registered for a given name.
    +   */
    +  Template getTemplate(const String *name);
    +
    +  State &getState();
    +
    +  ...
    +
    +}
    +
    +

    The module calls initialize, dump, and close from within the top method:

    +
    +
    +int JAVASCRIPT::top(Node *n) {
    +  emitter->initialize(n);
    +
    +  Language::top(n);
    +
    +  emitter->dump(n);
    +  emitter->close();
    +
    +  return SWIG_OK;
    +}
    +
    +

    The methods enterClass and exitClass are called from within the classHandler method:

    +
    +
    +int JAVASCRIPT::classHandler(Node *n) {
    +
    +  emitter->enterClass(n);
    +  Language::classHandler(n);
    +  emitter->exitClass(n);
    +
    +  return SWIG_OK;
    +}
    +
    +

    In enterClass the emitter stores state information that is necessary when processing class members. In exitClass the wrapper code for the whole class is generated.

    + +

    26.5.4 Emitter states

    + + +

    For storing information during the AST traversal the emitter provides a JSEmitterState with different slots to store data representing the scopes global, class, function, and variable.

    +
    +
    +class JSEmitterState {
    +
    +public:
    +
    +  JSEmitterState();
    +
    +  ~JSEmitterState();
    +
    +  DOH *global();
    +
    +  DOH *global(const char* key, DOH *initial = 0);
    +
    +  DOH *clazz(bool reset = false);
    +
    +  DOH *clazz(const char* key, DOH *initial = 0);
    +
    +  DOH *function(bool reset = false);
    +
    +  DOH *function(const char* key, DOH *initial = 0);
    +
    +  DOH *variable(bool reset = false);
    +
    +  DOH *variable(const char* key, DOH *initial = 0);
    +
    +  static int IsSet(DOH *val);
    +
    +  ...
    +};
    +
    +

    When entering a scope, such as in enterClass, the corresponding state is reset and new data is stored:

    +
    +
    +state.clazz(RESET);
    +state.clazz(NAME, Getattr(n, "sym:name"));
    +
    +

    State information can be retrieved using state.clazz(NAME) or with Getattr on state.clazz() which actually returns a Hash instance.

    + + +

    26.5.5 Handling Exceptions in JavascriptCore

    + + +

    Applications with an embedded JavascriptCore should be able to present detailed exception messages that occur in the Javascript engine. Below is an example derived from code provided by Brian Barnes on how these exception details can be extracted.

    +
    +
    +void script_exception_to_string(JSContextRef js_context,JSValueRef exception_value_ref,char* return_error_string, int return_error_string_max_length)
    +{
    +  JSObjectRef exception_object;
    +  JSValueRef value_ref;
    +  JSStringRef jsstring_property_name = NULL;
    +  JSValueRef temporary_exception = NULL;
    +  JSStringRef js_return_string = NULL;
    +  size_t bytes_needed;
    +  char* c_result_string = NULL;
    +  exception_object = JSValueToObject(js_context, exception_value_ref, NULL);
    +
    +  /* source url */
    +  strcpy(return_error_string,"[");
    +  jsstring_property_name = JSStringCreateWithUTF8CString("sourceURL");
    +  value_ref = JSObjectGetProperty(js_context, exception_object, jsstring_property_name, &temporary_exception);
    +  JSStringRelease(jsstring_property_name);
    +  js_return_string = JSValueToStringCopy(js_context, value_ref, NULL);
    +  bytes_needed = JSStringGetMaximumUTF8CStringSize(js_return_string);
    +  c_result_string = (char*)calloc(bytes_needed, sizeof(char));
    +  JSStringGetUTF8CString(js_return_string, c_result_string, bytes_needed);
    +  JSStringRelease(js_return_string);
    +  strncat(return_error_string, c_result_string, return_error_string_max_length-1);
    +  free(c_result_string);
    +
    +  strncat(return_error_string, ":", return_error_string_max_length-1);
    +
    +  /* line number */
    +
    +  jsstring_property_name = JSStringCreateWithUTF8CString("line");
    +  value_ref = JSObjectGetProperty(js_context, exception_object, jsstring_property_name, &temporary_exception);
    +  JSStringRelease(jsstring_property_name);
    +  js_return_string = JSValueToStringCopy(js_context, value_ref, NULL);
    +  bytes_needed = JSStringGetMaximumUTF8CStringSize(js_return_string);
    +  c_result_string = (char*)calloc(bytes_needed, sizeof(char));
    +  JSStringGetUTF8CString(js_return_string, c_result_string, bytes_needed);
    +  JSStringRelease(js_return_string);
    +  strncat(return_error_string, c_result_string, return_error_string_max_length-1);
    +  free(c_result_string);
    +
    +  strncat(return_error_string, "]", return_error_string_max_length-1);
    +
    +  /* error message */
    +
    +  jsstring_property_name = JSStringCreateWithUTF8CString("message");
    +  value_ref = JSObjectGetProperty(js_context, exception_object, jsstring_property_name, &temporary_exception);
    +  JSStringRelease(jsstring_property_name);
    +  if(NULL == value_ref)
    +  {
    +    strncat(return_error_string, "Unknown Error", return_error_string_max_length-1);
    +  }
    +  else
    +  {
    +    js_return_string = JSValueToStringCopy(js_context, value_ref, NULL);
    +    bytes_needed = JSStringGetMaximumUTF8CStringSize(js_return_string);
    +    c_result_string = (char*)calloc(bytes_needed, sizeof(char));
    +    JSStringGetUTF8CString(js_return_string, c_result_string, bytes_needed);
    +    JSStringRelease(js_return_string);
    +    strncat(return_error_string, c_result_string, return_error_string_max_length-1);
    +    free(c_result_string);
    +  }
    +}
    +
    + +

    It would be used in the following way:

    +
    +
    +if(js_exception)
    +{
    +  char return_error_string[256];
    +  script_exception_to_string(js_context, js_exception, return_error_string, 256);
    +  printf("Compile error is %s", return_error_string);
    +}
    +
    + + + diff --git a/Doc/Manual/Library.html b/Doc/Manual/Library.html index 1ae3c77..954de54 100644 --- a/Doc/Manual/Library.html +++ b/Doc/Manual/Library.html @@ -1,12 +1,13 @@ - + SWIG Library + -

    8 SWIG library

    +

    9 SWIG library

  • Utility Libraries
      @@ -58,7 +60,7 @@ Alternative libraries provide similar functionality. Please read this chapter carefully if you used the old libraries.

      -

      8.1 The %include directive and library search path

      +

      9.1 The %include directive and library search path

      @@ -90,7 +92,7 @@ Set the environment variable to hold an alternative library directory. The directories that are searched are displayed when using -verbose commandline option.

      -

      8.2 C Arrays and Pointers

      +

      9.2 C Arrays and Pointers

      @@ -102,7 +104,7 @@ pointers as class-like objects. Since these functions provide direct access to memory, their use is potentially unsafe and you should exercise caution.

      -

      8.2.1 cpointer.i

      +

      9.2.1 cpointer.i

      @@ -318,7 +320,7 @@ In this example, the function int_to_uint() would be used to cast type Note: When working with simple pointers, typemaps can often be used to provide more seamless operation.

      -

      8.2.2 carrays.i

      +

      9.2.2 carrays.i

      @@ -496,7 +498,7 @@ you should consider using a special array object rather than a bare pointer. used with types of char or char *.

      -

      8.2.3 cmalloc.i

      +

      9.2.3 cmalloc.i

      @@ -657,7 +659,7 @@ Now, in a script:

  • -

    8.2.4 cdata.i

    +

    9.2.4 cdata.i

    @@ -759,7 +761,7 @@ char *cdata_name(type* ptr, int nitems) Clearly they are unsafe.

    -

    8.3 C String Handling

    +

    9.3 C String Handling

    @@ -779,7 +781,7 @@ morality. The modules in this section provide basic functionality for manipulating raw C strings.

    -

    8.3.1 Default string handling

    +

    9.3.1 Default string handling

    @@ -820,7 +822,7 @@ interpreter and lead to a crash). Furthermore, the default behavior does not work well with binary data. Instead, strings are assumed to be NULL-terminated.

    -

    8.3.2 Passing binary data

    +

    9.3.2 Passing binary data

    @@ -862,7 +864,7 @@ In the wrapper function, the passed string will be expanded to a pointer and len The (char *STRING, int LENGTH) multi-argument typemap is also available in addition to (char *STRING, size_t LENGTH).

    -

    8.3.3 Using %newobject to release memory

    +

    9.3.3 Using %newobject to release memory

    @@ -903,7 +905,7 @@ however, you may need to provide your own "newfree" typemap for other types. See Object ownership and %newobject for more details.

    -

    8.3.4 cstring.i

    +

    9.3.4 cstring.i

    @@ -1363,7 +1365,7 @@ structure or class instead. -

    8.4 STL/C++ Library

    +

    9.4 STL/C++ Library

    @@ -1383,6 +1385,7 @@ The following table shows which C++ classes are supported and the equivalent SWI SWIG Interface library file + std::auto_ptr memory std_auto_ptr.i std::deque deque std_deque.i std::list list std_list.i std::map map std_map.i @@ -1390,7 +1393,8 @@ The following table shows which C++ classes are supported and the equivalent SWI std::set set std_set.i std::string string std_string.i std::vector vector std_vector.i - std::shared_ptr shared_ptr std_shared_ptr.i + std::array array (C++11) std_array.i + std::shared_ptr shared_ptr (C++11) std_shared_ptr.i @@ -1400,7 +1404,7 @@ Please look for the library files in the appropriate language library directory.

    -

    8.4.1 std::string

    +

    9.4.1 std::string

    @@ -1484,7 +1488,7 @@ void foo(string s, const String &t); // std_string typemaps still applie -

    8.4.2 std::vector

    +

    9.4.2 std::vector

    @@ -1663,7 +1667,7 @@ if you want to make their head explode. details and the public API exposed to the interpreter vary.

    -

    8.4.3 STL exceptions

    +

    9.4.3 STL exceptions

    @@ -1713,13 +1717,28 @@ The %exception directive can be used by placing the following code befo Any thrown STL exceptions will then be gracefully handled instead of causing a crash.

    -

    8.4.4 shared_ptr smart pointer

    +

    9.4.4 shared_ptr smart pointer

    -Some target languages have support for handling the widely used boost::shared_ptr smart pointer. -This smart pointer is also available as std::tr1::shared_ptr before it becomes fully standardized as std::shared_ptr. -The boost_shared_ptr.i library provides support for boost::shared_ptr and std_shared_ptr.i provides support for std::shared_ptr, but if the following macro is defined as shown, it can be used for std::tr1::shared_ptr: +Some target languages have support for handling the shared_ptr reference counted smart pointer. +This smart pointer is available in the standard C++11 library as std::shared_ptr. +It was also in TR1 as std::tr1::shared_ptr before it was fully standardized. +Support for the widely used boost::shared_ptr is also available. +

    + +

    +In order to use std::shared_ptr, the std_shared_ptr.i library file should be included: +

    + +
    +
    +%include <std_shared_ptr.i>
    +
    +
    + +

    +The pre-standard std::tr1::shared_ptr can be used by including the following macro before including the std_shared_ptr.i library file:

    @@ -1730,6 +1749,16 @@ The boost_shared_ptr.i library provides support for boost::shared_p

    +In order to use boost::shared_ptr, the boost_shared_ptr.i library file should be included: +

    + +
    +
    +%include <boost_shared_ptr.i>
    +
    +
    + +

    You can only use one of these variants of shared_ptr in your interface file at a time. and all three variants must be used in conjunction with the %shared_ptr(T) macro, where T is the underlying pointer type equating to usage shared_ptr<T>. @@ -1872,12 +1901,66 @@ Adding the missing %shared_ptr macros will fix this: -Note: There is currently no support for %shared_ptr and the director feature. +

    +Note: There is somewhat limited support for %shared_ptr and the director feature +and the degress of success varies among the different target languages. +Please help to improve this support by providing patches with improvements. +

    + + +

    9.4.5 auto_ptr smart pointer

    + + +

    +While std::auto_ptr is deprecated in C++11, some existing code may +still be using it, so SWIG provides limited support for this class: +std_auto_ptr.i defines the typemaps which apply to the functions +returning objects of this type. Any other use of std_auto_ptr.i is not +directly supported. +

    + +

    +A typical example of use would be +

    +
    +
    +%include <std_auto_ptr.i>
    +
    +%auto_ptr(Klass)
    +%inline %{
    +class Klass {
    +public:
    +  // Factory function creating objects of this class:
    +  static std::auto_ptr<Klass> Create(int value) {
    +    return std::auto_ptr<Klass>(new Klass(value));
    +  }
    +
    +  int getValue() const { return m_value; }
    +
    +private:
    +  DerivedIntValue(int value) : m_value(value) {}
    +  int m_value;
    +};
    +%}
    +
    +
    + +

    +The returned objects can be used naturally from the target language, e.g. from +C#: +

    + +
    +
    +Klass k = Klass.Create(17);
    +int value = k.getValue();
    +
    +
    -

    8.5 Utility Libraries

    +

    9.5 Utility Libraries

    -

    8.5.1 exception.i

    +

    9.5.1 exception.i

    diff --git a/Doc/Manual/Lisp.html b/Doc/Manual/Lisp.html index 01ff3a3..0867ba9 100644 --- a/Doc/Manual/Lisp.html +++ b/Doc/Manual/Lisp.html @@ -1,12 +1,13 @@ - + SWIG and Common Lisp + -

    25 SWIG and Common Lisp

    +

    27 SWIG and Common Lisp

      @@ -41,7 +42,7 @@ Lisp, Common Foreign Function Interface(CFFI), CLisp and UFFI foreign function interfaces.

      -

      25.1 Allegro Common Lisp

      +

      27.1 Allegro Common Lisp

      @@ -50,7 +51,7 @@ here

      -

      25.2 Common Foreign Function Interface(CFFI)

      +

      27.2 Common Foreign Function Interface(CFFI)

      @@ -77,7 +78,7 @@ swig -cffi -module module-name file-name files and the various things which you can do with them.

      -

      25.2.1 Additional Commandline Options

      +

      27.2.1 Additional Commandline Options

      @@ -118,11 +119,11 @@ swig -cffi -help -

      25.2.2 Generating CFFI bindings

      +

      27.2.2 Generating CFFI bindings

      As we mentioned earlier the ideal way to use SWIG is to use interface - files. To illustrate the use of it, lets assume that we have a + files. To illustrate the use of it, let's assume that we have a file named test.h with the following C code:
      @@ -219,19 +220,19 @@ The generated SWIG Code will be:
       (cl:defconstant x (cl:ash 5 -1))
       
       (cffi:defcstruct bar
      -	(p :short)
      -	(q :short)
      -	(a :char)
      -	(b :char)
      -	(z :pointer)
      -	(n :pointer))
      +        (p :short)
      +        (q :short)
      +        (a :char)
      +        (b :char)
      +        (z :pointer)
      +        (n :pointer))
       
       (cffi:defcvar ("my_struct" my_struct)
        :pointer)
       
       (cffi:defcstruct foo
      -	(a :int)
      -	(b :pointer))
      +        (a :int)
      +        (b :pointer))
       
       (cffi:defcfun ("pointer_func" pointer_func) :int
         (ClosureFun :pointer)
      @@ -247,9 +248,9 @@ The generated SWIG Code will be:
         (array :pointer))
       
       (cffi:defcenum color
      -	:RED
      -	:BLUE
      -	:GREEN)
      +        :RED
      +        :BLUE
      +        :GREEN)
       

      @@ -284,9 +285,11 @@ Let's edit the interface file such that the C type "div_t*" is changed %feature("export"); %feature("inline") lispsort_double; - %feature("intern_function", "my-lispify") lispsort_double; +%feature("export", package="'some-other-package") lispsort_double; + %rename func123 renamed_cool_func; + %ignore "pointer_func"; %include "test.h" @@ -310,12 +313,13 @@ The feature intern_function ensures that all C names are lispsort_double;, here we are using an additional feature which allows us to use our lispify function.

      -

      The export feature allows us to export the symbols. The inline - feature declaims the declared function as inline. The rename - directive allows us to change the name(it is useful when - generating C wrapper code for handling overloaded - functions). The ignore directive ignores a certain - declaration. +

      The export feature allows us to export the symbols. If + the package argument is given, then the symbol will be exported to + the specified Lisp package. The inline feature declaims the + declared function as inline. The rename directive allows us to + change the name(it is useful when generating C wrapper code for handling + overloaded functions). The ignore directive ignores a certain + declaration.

      There are several other things which are possible, to see some example of usage of SWIG look at the Lispbuilder and wxCL @@ -332,12 +336,12 @@ The feature intern_function ensures that all C names are (cl:export '#.(swig-lispify "x" 'constant)) (cffi:defcstruct #.(swig-lispify "bar" 'classname) - (#.(swig-lispify "p" 'slotname) :short) - (#.(swig-lispify "q" 'slotname) :short) - (#.(swig-lispify "a" 'slotname) :char) - (#.(swig-lispify "b" 'slotname) :char) - (#.(swig-lispify "z" 'slotname) :pointer) - (#.(swig-lispify "n" 'slotname) :pointer)) + (#.(swig-lispify "p" 'slotname) :short) + (#.(swig-lispify "q" 'slotname) :short) + (#.(swig-lispify "a" 'slotname) :char) + (#.(swig-lispify "b" 'slotname) :char) + (#.(swig-lispify "z" 'slotname) :pointer) + (#.(swig-lispify "n" 'slotname) :pointer)) (cl:export '#.(swig-lispify "bar" 'classname)) @@ -359,8 +363,8 @@ The feature intern_function ensures that all C names are (cl:export '#.(swig-lispify "my_struct" 'variable)) (cffi:defcstruct #.(swig-lispify "foo" 'classname) - (#.(swig-lispify "a" 'slotname) :int) - (#.(swig-lispify "b" 'slotname) :pointer)) + (#.(swig-lispify "a" 'slotname) :int) + (#.(swig-lispify "b" 'slotname) :pointer)) (cl:export '#.(swig-lispify "foo" 'classname)) @@ -381,18 +385,18 @@ The feature intern_function ensures that all C names are (n :int) (array :pointer)) -(cl:export '#.(my-lispify "lispsort_double" 'function)) +(cl:export '#.(my-lispify "lispsort_double" 'function) 'some-other-package) (cffi:defcenum #.(swig-lispify "color" 'enumname) - #.(swig-lispify "RED" 'enumvalue :keyword) - #.(swig-lispify "BLUE" 'enumvalue :keyword) - #.(swig-lispify "GREEN" 'enumvalue :keyword)) + #.(swig-lispify "RED" 'enumvalue :keyword) + #.(swig-lispify "BLUE" 'enumvalue :keyword) + #.(swig-lispify "GREEN" 'enumvalue :keyword)) (cl:export '#.(swig-lispify "color" 'enumname))

    -

    25.2.3 Generating CFFI bindings for C++ code

    +

    27.2.3 Generating CFFI bindings for C++ code

    This feature to SWIG (for CFFI) is very new and still far from @@ -568,7 +572,7 @@ If you have any questions, suggestions, patches, etc., related to CFFI module feel free to contact us on the SWIG mailing list, and also please add a "[CFFI]" tag in the subject line. -

    25.2.4 Inserting user code into generated files

    +

    27.2.4 Inserting user code into generated files

    @@ -608,7 +612,7 @@ Note that the block %{ ... %} is effectively a shortcut for

    -

    25.3 CLISP

    +

    27.3 CLISP

    @@ -638,7 +642,7 @@ swig -clisp -module module-name file-name interface file for the CLISP module. The CLISP module tries to produce code which is both human readable and easily modifyable.

    -

    25.3.1 Additional Commandline Options

    +

    27.3.1 Additional Commandline Options

    @@ -658,33 +662,33 @@ swig -clisp -help -extern-all If this option is given then clisp definitions for all the functions
    and global variables will be created otherwise only definitions for
    - externed functions and variables are created. +externed functions and variables are created. -generate-typedef If this option is given then def-c-type will be used to generate
    - shortcuts according to the typedefs in the input. +shortcuts according to the typedefs in the input. -

    25.3.2 Details on CLISP bindings

    +

    27.3.2 Details on CLISP bindings

    As mentioned earlier the CLISP bindings generated by SWIG may need - some modifications. The clisp module creates a lisp file with - the same name as the module name. This - lisp file contains a 'defpackage' declaration, with the - package name same as the module name. This package uses the - 'common-lisp' and 'ffi' packages. Also, package exports all - the functions, structures and variables for which an ffi - binding was generated.
    - After generating the defpackage statement, the clisp module also - sets the default language. +some modifications. The clisp module creates a lisp file with +the same name as the module name. This +lisp file contains a 'defpackage' declaration, with the +package name same as the module name. This package uses the +'common-lisp' and 'ffi' packages. Also, package exports all +the functions, structures and variables for which an ffi +binding was generated.
    +After generating the defpackage statement, the clisp module also +sets the default language.

     (defpackage :test
    @@ -734,18 +738,18 @@ void test123(float x , double y);
     (ffi:def-call-out pointer_func
         (:name "pointer_func")
       (:arguments (ClosureFun (ffi:c-function (:arguments (arg0 (ffi:c-pointer NIL))
    -						      (arg1 (ffi:c-pointer NIL))
    -						      (arg2 (ffi:c-pointer NIL)))
    -					  (:return-type NIL)))
    -	      (y ffi:int))
    +                                                      (arg1 (ffi:c-pointer NIL))
    +                                                      (arg2 (ffi:c-pointer NIL)))
    +                                          (:return-type NIL)))
    +              (y ffi:int))
       (:return-type ffi:int)
       (:library +library-name+))
     
     (ffi:def-call-out func123
         (:name "func123")
       (:arguments (x (ffi:c-pointer div_t))
    -	      (z (ffi:c-ptr (ffi:c-array (ffi:c-ptr (ffi:c-ptr ffi:int)) 100)))
    -	      (y (ffi:c-ptr (ffi:c-ptr (ffi:c-array ffi:int (1000 10))))))
    +              (z (ffi:c-ptr (ffi:c-array (ffi:c-ptr (ffi:c-ptr ffi:int)) 100)))
    +              (y (ffi:c-ptr (ffi:c-ptr (ffi:c-array ffi:int (1000 10))))))
       (:return-type ffi:int)
       (:library +library-name+))
     
    @@ -753,14 +757,14 @@ void test123(float x , double y);
     (ffi:def-call-out lispsort_double
         (:name "lispsort_double")
       (:arguments (n ffi:int)
    -	      (array (ffi:c-ptr DOUBLE-FLOAT)))
    +              (array (ffi:c-ptr DOUBLE-FLOAT)))
       (:return-type NIL)
       (:library +library-name+))
     
     (ffi:def-call-out test123
         (:name "test")
       (:arguments (x SINGLE-FLOAT)
    -	      (y DOUBLE-FLOAT))
    +              (y DOUBLE-FLOAT))
       (:return-type NIL)
       (:library +library-name+))
     
    @@ -795,7 +799,7 @@ struct bar {
     
     
    -

    25.4 UFFI

    +

    27.4 UFFI

    diff --git a/Doc/Manual/Lua.html b/Doc/Manual/Lua.html index 88d26f3..004ca6f 100644 --- a/Doc/Manual/Lua.html +++ b/Doc/Manual/Lua.html @@ -1,12 +1,13 @@ - + SWIG and Lua + -

    26 SWIG and Lua

    +

    28 SWIG and Lua

  • Typemaps -
  • Writing typemaps +
  • Writing typemaps
  • Customization of your Bindings @@ -73,14 +83,14 @@ Lua is an extension programming language designed to support general procedural eLua stands for Embedded Lua (can be thought of as a flavor of Lua) and offers the full implementation of the Lua programming language to the embedded world, extending it with specific features for efficient and portable software embedded development. eLua runs on smaller devices like microcontrollers and provides the full features of the regular Lua desktop version. More information on eLua can be found here: http://www.eluaproject.net

    -

    26.1 Preliminaries

    +

    28.1 Preliminaries

    -The current SWIG implementation is designed to work with Lua 5.0.x, 5.1.x and 5.2.x. It should work with later versions of Lua, but certainly not with Lua 4.0 due to substantial API changes. It is possible to either static link or dynamic link a Lua module into the interpreter (normally Lua static links its libraries, as dynamic linking is not available on all platforms). SWIG also supports eLua and works with eLua 0.8. SWIG generated code for eLua has been tested on Stellaris ARM Cortex-M3 LM3S and Infineon TriCore. +The current SWIG implementation is designed to work with Lua 5.0.x, 5.1.x and 5.2.x. It should work with later versions of Lua, but certainly not with Lua 4.0 due to substantial API changes. It is possible to either static link or dynamic link a Lua module into the interpreter (normally Lua static links its libraries, as dynamic linking is not available on all platforms). SWIG also has support for eLua starting from eLua 0.8. Due to substantial changes between SWIG 2.x and SWIG 3.0 and unavailability of testing platform, eLua status was downgraded to 'experimental'.

    -

    26.2 Running SWIG

    +

    28.2 Running SWIG

    @@ -128,7 +138,7 @@ $ swig -lua -eluac example.i The -elua option puts all the C function wrappers and variable get/set wrappers in rotables. It also generates a metatable which will control the access to these variables from eLua. It also offers a significant amount of module size compression. On the other hand, the -eluac option puts all the wrappers in a single rotable. With this option, no matter how huge the module, it will consume no additional microcontroller SRAM (crass compression). There is a catch though: Metatables are not generated with -eluac. To access any value from eLua, one must directly call the wrapper function associated with that value.

    -

    26.2.1 Additional command line options

    +

    28.2.1 Additional command line options

    @@ -159,9 +169,17 @@ swig -lua -help Do not register the module name as a global variable but return the module table from calls to require. + + -no-old-metatable-bindings + Disable backward compatibility: old-style binding names generations and a few other things. Explanations are included in appropriate later sections. + + + -squash-bases + Squashes symbols from all inheritance tree of a given class into itself. Emulates pre-SWIG3.0 inheritance. Insignificantly speeds things up, but increases memory consumption. + -

    26.2.2 Compiling and Linking and Interpreter

    +

    28.2.2 Compiling and Linking and Interpreter

    @@ -184,8 +202,8 @@ int main(int argc,char* argv[]) return 0; } L=lua_open(); - luaopen_base(L); // load basic libs (eg. print) - luaopen_example(L); // load the wrapped module + luaopen_base(L); // load basic libs (eg. print) + luaopen_example(L); // load the wrapped module if (luaL_loadfile(L,argv[1])==0) // load and run the file lua_pcall(L,0,0,0); else @@ -232,7 +250,7 @@ LUALIB_API int ( luaopen_mod )(lua_State *L ); More information on building and configuring eLua can be found here: http://www.eluaproject.net/doc/v0.8/en_building.html

    -

    26.2.3 Compiling a dynamic module

    +

    28.2.3 Compiling a dynamic module

    @@ -240,8 +258,8 @@ Most, but not all platforms support the dynamic loading of modules (Windows &

     $ swig -lua example.i -o example_wrap.c
    -$ gcc -I/usr/include/lua -c example_wrap.c -o example_wrap.o
    -$ gcc -c example.c -o example.o
    +$ gcc -fPIC -I/usr/include/lua -c example_wrap.c -o example_wrap.o
    +$ gcc -fPIC -c example.c -o example.o
     $ gcc -shared -I/usr/include/lua -L/usr/lib/lua example_wrap.o example.o -o example.so
     

    @@ -300,7 +318,7 @@ Is quite obvious (Go back and consult the Lua documents on how to enable loadlib -

    26.2.4 Using your module

    +

    28.2.4 Using your module

    @@ -318,19 +336,19 @@ $ ./my_lua >

  • -

    26.3 A tour of basic C/C++ wrapping

    +

    28.3 A tour of basic C/C++ wrapping

    By default, SWIG tries to build a very natural Lua interface to your C/C++ code. This section briefly covers the essential aspects of this wrapping.

    -

    26.3.1 Modules

    +

    28.3.1 Modules

    The SWIG module directive specifies the name of the Lua module. If you specify `module example', then everything is wrapped into a Lua table 'example' containing all the functions and variables. When choosing a module name, make sure you don't use the same name as a built-in Lua command or standard module name.

    -

    26.3.2 Functions

    +

    28.3.2 Functions

    @@ -349,7 +367,10 @@ creates a built-in function example.fact(n) that works exactly like you >

    -To avoid name collisions, SWIG create a Lua table which it keeps all the functions and global variables in. It is possible to copy the functions out of this and into the global environment with the following code. This can easily overwrite existing functions, so this must be used with care. +To avoid name collisions, SWIG create a Lua table which keeps all the functions, constants, classes and global variables in. +It is possible to copy the functions, constants and classes (but not variables) out of this and into the global environment with the following code. +This can easily overwrite existing functions, so this must be used with care. +This option is considered deprecated and will be removed in the near future.

     > for k,v in pairs(example) do _G[k]=v end
    @@ -368,7 +389,7 @@ It is also possible to rename the module with an assignment.
     24
     
    -

    26.3.3 Global variables

    +

    28.3.3 Global variables

    @@ -456,7 +477,7 @@ If you have used the -eluac option for your eLua module, you will have In general, functions of the form "variable_get()" and "variable_set()" are automatically generated by SWIG for use with -eluac.

    -

    26.3.4 Constants and enums

    +

    28.3.4 Constants and enums

    @@ -490,7 +511,64 @@ If you're using eLua and have used -elua or -eluac to generate > print(example.const.SCONST) Hello World -

    26.3.5 Pointers

    + +

    28.3.4.1 Constants/enums and classes/structures

    + + +

    +Enums are exported into a class table. For example, given some enums: +

    +
    %module example
    +enum Days { SUNDAY = 0, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY };
    +struct Test {
    +    enum { TEST1 = 10, TEST2 = 20 };
    +#ifdef __cplusplus // There are no static members in C
    +    static const int ICONST = 12;
    +#endif
    +};
    +
    +

    +There is a slight difference in behaviour wrapping C and C++ code due to the different scoping rules of C and C++. +The wrapped C++ code is used as follows from Lua code: +

    +
    +> print(example.SUNDAY)
    +0
    +> print(example.Test.TEST1)
    +10
    +> print(example.Test.ICONST)
    +12
    +
    + +

    Enums within a C struct are in the global namespace and are used as follows from Lua

    +
    +> print(example.SUNDAY)
    +0
    +> -- See the difference here
    +> print(example.TEST1)
    +10
    +
    + +

    +Compatibility Note: Versions of SWIG prior to SWIG-3.0.0 did not generate the class table members above. +There is no change in the C wrappers, but +the following code was the only way to access these constants/enums when wrapping C++ member constants: +

    +
    +> print(example.Test_TEST1)
    +10
    +> print(example.Test_ICONST)
    +12
    +
    +

    +The old-style bindings are still generated in addition to the new ones. +If the -no-old-metatable-bindings option is used, then these old-style bindings are not generated. +

    +

    +It is worth mentioning, that example.Test.TEST1 and example.Test_TEST1 are different entities and changing one does not change the other. +Given the fact that these are constantes and they are not supposed to be changed, it is up to you to avoid such issues. +

    +

    28.3.5 Pointers

    @@ -528,7 +606,7 @@ Lua enforces the integrity of its userdata, so it is virtually impossible to cor nil -

    26.3.6 Structures

    +

    28.3.6 Structures

    @@ -551,7 +629,7 @@ is used as follows:

    Similar access is provided for unions and the data members of C++ classes.
    -C structures are created using a function new_Point(), but for C++ classes are created using just the name Point(). +C structures can be created using a function new_Point(), and both C structures and C++ classes can be created using just the name Point().

    If you print out the value of p in the above example, you will see something like this: @@ -632,7 +710,7 @@ For eLua with the -eluac option, structure manipulation has to be perfo In general, functions of the form "new_struct()", "struct_member_get()", "struct_member_set()" and "free_struct()" are automatically generated by SWIG for each structure defined in C. (Please note: This doesn't apply for modules generated with the -elua option)

    -

    26.3.7 C++ classes

    +

    28.3.7 C++ classes

    @@ -676,12 +754,12 @@ public: };

    -In Lua, the static members can be accessed as follows: +In Lua, C++ static members can be accessed as follows:

    -> example.Spam_foo()            -- calling Spam::foo()
    -> a=example.Spam_bar            -- reading Spam::bar 
    -> example.Spam_bar=b            -- writing to Spam::bar
    +> example.Spam.foo()            -- calling Spam::foo()
    +> a=example.Spam.bar            -- reading Spam::bar 
    +> example.Spam.bar=b            -- writing to Spam::bar
     

    It is not (currently) possible to access static members of an instance: @@ -692,7 +770,22 @@ It is not (currently) possible to access static members of an instance: -- does NOT work -

    26.3.8 C++ inheritance

    +

    +Compatibility Note: In versions prior to SWIG-3.0.0 only the following names would work: +

    + +
    +> example.Spam_foo()            -- calling Spam::foo()
    +> a=example.Spam_bar            -- reading Spam::bar 
    +> example.Spam_bar=b            -- writing to Spam::bar
    +
    + +

    +Both style names are generated by default now. +However, if the -no-old-metatable-bindings option is used, then the backward compatible names are not generated in addition to ordinary ones. +

    + +

    28.3.8 C++ inheritance

    @@ -717,7 +810,7 @@ then the function spam() accepts a Foo pointer or a pointer to any clas

    It is safe to use multiple inheritance with SWIG.

    -

    26.3.9 Pointers, references, values, and arrays

    +

    28.3.9 Pointers, references, values, and arrays

    @@ -748,7 +841,7 @@ Foo spam7();

    then all three functions will return a pointer to some Foo object. Since the third function (spam7) returns a value, newly allocated memory is used to hold the result and a pointer is returned (Lua will release this memory when the return value is garbage collected). The other two are pointers which are assumed to be managed by the C code and so will not be garbage collected.

    -

    26.3.10 C++ overloaded functions

    +

    28.3.10 C++ overloaded functions

    @@ -799,7 +892,7 @@ void spam(short);

    or

    -
    VOID FOO(bAR *B);
    +
    void foo(Bar *b);
     void foo(Bar &b);
     

    @@ -834,7 +927,7 @@ Please refer to the "SWIG and C++" chapter for more information about overloadin

    Dealing with the Lua coercion mechanism, the priority is roughly (integers, floats, strings, userdata). But it is better to rename the functions rather than rely upon the ordering.

    -

    26.3.11 C++ operators

    +

    28.3.11 C++ operators

    @@ -898,10 +991,10 @@ The current list of operators which can be overloaded (and the alternative funct

  • __sub__ operator-
  • __mul__ operator *
  • __div__ operator/ -
  • __neg__ unary minus +
  • __unm__ unary minus
  • __call__ operator() (often used in functor classes)
  • __pow__ the exponential fn (no C++ equivalent, Lua uses ^) -
  • __concat__ the concatenation operator (SWIG maps C++'s ~ to Lua's ..) +
  • __concat__ the concatenation operator (Lua's ..)
  • __eq__ operator==
  • __lt__ operator<
  • __le__ operator<= @@ -945,8 +1038,30 @@ It is also possible to overload the operator[], but currently this cann void __setitem__(int i,double d); // i is the index, d is the data };
  • - -

    26.3.12 Class extension with %extend

    +

    +C++ operators are mapped to Lua predefined metafunctions. Class inherits from its bases the following list of metafunctions ( thus inheriting the folloging +operators and pseudo-operators):

    +
      +
    • __add__ +
    • __sub__ +
    • __mul__ +
    • __div__ +
    • __unm__ +
    • __mod__ +
    • __call__ +
    • __pow__ +
    • __concat__ +
    • __eq__ +
    • __lt__ +
    • __le__ +
    • __len__ +
    • __getitem__ +
    • __setitem__ +
    • __tostring used internally by Lua for tostring() function. __str__ is mapped to this function +
    +

    No other lua metafunction is inherited. For example, __gc is not inherited and must be redefined in every class. __tostring is subject to a special handling. If absent in class and in class bases, a default one will be provided by SWIG. +

    +

    28.3.12 Class extension with %extend

    @@ -981,7 +1096,7 @@ Now we extend it with some new code return tmp; } bool operator==(const Complex& c) - { return ($self->re()==c.re() && $self->im()==c.im();} + { return ($self->re()==c.re() && $self->im()==c.im());} };

    @@ -1002,7 +1117,7 @@ true Extend works with both C and C++ code, on classes and structs. It does not modify the underlying object in any way---the extensions only show up in the Lua interface. The only item to take note of is the code has to use the '$self' instead of 'this', and that you cannot access protected/private members of the code (as you are not officially part of the class).

    -

    26.3.13 Using %newobject to release memory

    +

    28.3.13 Using %newobject to release memory

    If you have a function that allocates memory like this,

    @@ -1026,7 +1141,7 @@ char *foo();

    This will release the allocated memory.

    -

    26.3.14 C++ templates

    +

    28.3.14 C++ templates

    @@ -1061,7 +1176,7 @@ In Lua:

    Obviously, there is more to template wrapping than shown in this example. More details can be found in the SWIG and C++ chapter. Some more complicated examples will appear later.

    -

    26.3.15 C++ Smart Pointers

    +

    28.3.15 C++ Smart Pointers

    @@ -1113,7 +1228,7 @@ If you ever need to access the underlying pointer returned by operator->( > f = p:__deref__() -- Returns underlying Foo * -

    26.3.16 C++ Exceptions

    +

    28.3.16 C++ Exceptions

    @@ -1256,13 +1371,164 @@ and the "Exception handling add exception specification to functions or globally (respectively).

    +

    28.3.17 Namespaces

    + + +

    +Since SWIG-3.0.0 C++ namespaces are supported via the %nspace feature. +

    +

    Namespaces are mapped into Lua tables. Each of those tables contains names that were defined within appropriate namespace. Namespaces structure (a.k.a nested namespaces) is preserved. Consider the following C++ code: +

    +
    %module example
    +%nspace MyWorld::Nested::Dweller;
    +%nspace MyWorld::World;
    +
    +int module_function() { return 7; }
    +int module_variable = 9;
    +
    +namespace MyWorld {
    +  class World {
    +  public:
    +    World() : world_max_count(9) {}
    +    int create_world() { return 17; }
    +    const int world_max_count; // = 9
    +  };
    +  namespace Nested {
    +    class Dweller {
    +      public:
    +        enum Gender { MALE = 0, FEMALE = 1 };
    +        static int count() { return 19; }
    +    };
    +  }
    +}
    +
    + +

    +Now, from Lua usage is as follows: +

    + +
    +> print(example.module_function())
    +7
    +> print(example.module_variable)
    +9
    +> print(example.MyWorld.World():create_world())
    +17
    +> print(example.MyWorld.World.world_max_count)
    +9
    +> print(example.MyWorld.Nested.Dweller.MALE)
    +0
    +> print(example.MyWorld.Nested.Dweller.count())
    +19
    +>
    +
    +

    28.3.17.1 Compatibility Note

    + + +

    +If SWIG is running in a backwards compatible way, i.e. without the -no-old-metatable-bindings option, then additional old-style names are generated (notice the underscore): +

    +
    +9
    +> print(example.MyWorld.Nested.Dweller_MALE)
    +0
    +> print(example.MyWorld.Nested.Dweller_count())
    +11
    +>
    +
    + + +

    28.3.17.2 Names

    + + +

    If SWIG is launched without -no-old-metatable-bindings option, then it enters backward-compatible mode. While in this mode, it tries +to generate additional names for static functions, class static constants and class enums. +Those names are in a form $classname_$symbolname and are added to the scope surrounding the class. +If %nspace is enabled, then class namespace is taken as scope. If there is no namespace, or %nspace is disabled, +then module is considered a class namespace.

    +

    Consider the following C++ code

    +
    %module example
    +%nspace MyWorld::Test;
    +namespace MyWorld {
    +class Test {
    +  public:
    +  enum { TEST1 = 10, TEST2 }
    +  static const int ICONST = 12;
    +};
    +class Test2 {
    +  public:
    +  enum { TEST3 = 20, TEST4 }
    +  static const int ICONST2 = 23;
    +}
    +
    +

    When in backward compatible mode, in addition to the usual names, the following ones will be generated (notice the underscore):

    +
    +9
    +> print(example.MyWorld.Test_TEST1) -- Test has %nspace enabled
    +10
    +> print(example.MyWorld.Test_ICONST) -- Test has %nspace enabled
    +12
    +> print(example.Test2_TEST3) -- Test2 doesn't have %nspace enabled
    +20
    +> print(example.Test2_ICONST2) -- Test2 doesn't have %nspace enabled
    +23
    +>
    +
    +

    There is a slight difference with enums when in C mode. As per C standard, enums from C structures are exported to +surrounding scope without any prefixing. Pretending that Test2 is a struct, not class, that would be:

    +
    +> print(example.TEST3) -- NOT Test2_TEST3
    +20
    +>
    +
    + +

    28.3.17.3 Inheritance

    + + +

    The internal organization of inheritance has changed. +Consider the following C++ code:

    +
    %module example
    +class Base {
    +  public:
    +  int base_func()
    +};
    +class Derived : public Base {
    +  public:
    +  int derived_func()
    +}
    +
    +

    Lets assume for a moment that class member functions are stored in .fn table. Previously, when classes +were exported to Lua during module initialization, for every derived class all service tables ST(i.e. ".fn") +were squashed and added to corresponding derived class ST: Everything from .fn table of class Base +was copied to .fn table of class Derived and so on. This was a recursive procedure, so in the end the whole +inheritance tree of derived class was squashed into derived class.

    +

    That means that any changes done to class Base after module initialization wouldn't affect class Derived:

    +
    +base = example.Base()
    +der = example.Derived()
    +> print(base.base_func)
    +function: 0x1367940
    +> getmetatable(base)[".fn"].new_func = function (x) return x -- Adding new function to class Base (to class, not to an instance!)
    +> print(base.new_func) -- Checking this function
    +function
    +> print(der.new_func) -- Wouldn't work. Derived doesn't check Base any more.
    +nil
    +>
    +
    +

    This behaviour was changed. Now unless -squash-bases option is provided, Derived store a list of it's bases and if some symbol is not found in it's own service tables +then its bases are searched for it. Option -squash-bases will effectively return old behaviour. +

    +> print(der.new_func) -- Now it works
    +function
    +>
    +
    -

    26.4 Typemaps

    +

    28.4 Typemaps

    This section explains what typemaps are and how to use them. The default wrapping behaviour of SWIG is enough in most cases. However sometimes SWIG may need a little additional assistance to know which typemap to apply to provide the best wrapping. This section will be explaining how to use typemaps to best effect

    -

    26.4.1 What is a typemap?

    +

    28.4.1 What is a typemap?

    A typemap is nothing more than a code generation rule that is attached to a specific C datatype. For example, to convert integers from Lua to C, you might define a typemap like this:

    @@ -1270,8 +1536,8 @@ add exception specification to functions or globally (respectively).
    %module example
     
     %typemap(in) int {
    -	$1 = (int) lua_tonumber(L,$input);
    -	printf("Received an integer : %d\n",$1);
    +  $1 = (int) lua_tonumber(L,$input);
    +  printf("Received an integer : %d\n",$1);
     }
     %inline %{
     extern int fact(int n);
    @@ -1290,7 +1556,7 @@ Received an integer : 6
     720
     
    -

    26.4.2 Using typemaps

    +

    28.4.2 Using typemaps

    There are many ready written typemaps built into SWIG for all common types (int, float, short, long, char*, enum and more), which SWIG uses automatically, with no effort required on your part.

    @@ -1343,7 +1609,7 @@ void swap(int *sx, int *sy);

    Note: C++ references must be handled exactly the same way. However SWIG will automatically wrap a const int& as an input parameter (since that it obviously input).

    -

    26.4.3 Typemaps and arrays

    +

    28.4.3 Typemaps and arrays

    Arrays present a challenge for SWIG, because like pointers SWIG does not know whether these are input or output values, nor @@ -1407,7 +1673,7 @@ and Lua tables to be 1..N, (the indexing follows the norm for the language). In

    Note: SWIG also can support arrays of pointers in a similar manner.

    -

    26.4.4 Typemaps and pointer-pointer functions

    +

    28.4.4 Typemaps and pointer-pointer functions

    Several C++ libraries use a pointer-pointer functions to create its objects. These functions require a pointer to a pointer which is then filled with the pointer to the new object. Microsoft's COM and DirectX as well as many other libraries have this kind of function. An example is given below:

    @@ -1441,7 +1707,7 @@ int Create_Math(iMath** pptr); // its creator (assume it mallocs) ptr=nil -- the iMath* will be GC'ed as normal -

    26.5 Writing typemaps

    +

    28.5 Writing typemaps

    This section describes how you can modify SWIG's default wrapping behavior for various C/C++ datatypes using the %typemap directive. This is an advanced topic that assumes familiarity with the Lua C API as well as the material in the "Typemaps" chapter.

    @@ -1450,7 +1716,7 @@ ptr=nil -- the iMath* will be GC'ed as normal

    Before proceeding, you should read the previous section on using typemaps, and look at the existing typemaps found in luatypemaps.swg and typemaps.i. These are both well documented and fairly easy to read. You should not attempt to write your own typemaps until you have read and can understand both of these files (they may well also give you an idea to base your work on).

    -

    26.5.1 Typemaps you can write

    +

    28.5.1 Typemaps you can write

    There are many different types of typemap that can be written, the full list can be found in the "Typemaps" chapter. However the following are the most commonly used ones.

    @@ -1463,7 +1729,7 @@ ptr=nil -- the iMath* will be GC'ed as normal (the syntax for the typecheck is different from the typemap, see typemaps for details). -

    26.5.2 SWIG's Lua-C API

    +

    28.5.2 SWIG's Lua-C API

    This section explains the SWIG specific Lua-C API. It does not cover the main Lua-C api, as this is well documented and not worth covering.

    @@ -1512,7 +1778,7 @@ This macro, when called within the context of a SWIG wrapped function, will disp
    Similar to SWIG_fail_arg, except that it will display the swig_type_info information instead.
    -

    26.6 Customization of your Bindings

    +

    28.6 Customization of your Bindings

    @@ -1521,7 +1787,7 @@ This section covers adding of some small extra bits to your module to add the la -

    26.6.1 Writing your own custom wrappers

    +

    28.6.1 Writing your own custom wrappers

    @@ -1540,7 +1806,7 @@ int native_function(lua_State*L) // my native code The %native directive in the above example, tells SWIG that there is a function int native_function(lua_State*L); which is to be added into the module under the name 'my_func'. SWIG will not add any wrapper for this function, beyond adding it into the function table. How you write your code is entirely up to you.

    -

    26.6.2 Adding additional Lua code

    +

    28.6.2 Adding additional Lua code

    @@ -1578,7 +1844,7 @@ Good uses for this feature is adding of new code, or writing helper functions to See Examples/lua/arrays for an example of this code.

    -

    26.7 Details on the Lua binding

    +

    28.7 Details on the Lua binding

    @@ -1589,7 +1855,7 @@ See Examples/lua/arrays for an example of this code.

    -

    26.7.1 Binding global data into the module.

    +

    28.7.1 Binding global data into the module.

    @@ -1649,7 +1915,7 @@ end

    That way when you call 'a=example.Foo', the interpreter looks at the table 'example' sees that there is no field 'Foo' and calls __index. This will in turn check in '.get' table and find the existence of 'Foo' and then return the value of the C function call 'Foo_get()'. Similarly for the code 'example.Foo=10', the interpreter will check the table, then call the __newindex which will then check the '.set' table and call the C function 'Foo_set(10)'.

    -

    26.7.2 Userdata and Metatables

    +

    28.7.2 Userdata and Metatables

    @@ -1729,7 +1995,7 @@ Note: Both the opaque structures (like the FILE*) and normal wrapped classes/str

    Note: Operator overloads are basically done in the same way, by adding functions such as '__add' & '__call' to the class' metatable. The current implementation is a bit rough as it will add any member function beginning with '__' into the metatable too, assuming its an operator overload.

    -

    26.7.3 Memory management

    +

    28.7.3 Memory management

    diff --git a/Doc/Manual/Makefile b/Doc/Manual/Makefile index 42149ba..fb5f67c 100644 --- a/Doc/Manual/Makefile +++ b/Doc/Manual/Makefile @@ -9,7 +9,7 @@ # validation. # # Additional html validation can be done using the validate target. -# Additional link checking can be done using the linkchecker target. +# Additional link checking can be done using the linkchecker1 and linkchecker2 target. # # Note the # and " are escaped @@ -19,31 +19,35 @@ HTMLDOC_OPTIONS = "--book --toclevels 4 --no-numbered --toctitle \"Table of Cont all: maketoc check generate -maketoc: CCache.html +maketoc: python maketoc.py +# Use this to regenerate CCache.html should this ever be needed CCache.html: ../../CCache/ccache.yo yodl2html -o CCache.html ../../CCache/ccache.yo +# Tabs in the html files will stop the build as wkhtmltopdf does not expand them correctly - replace them with the appropriate number of tabs # Use htmltidy to warn about some HTML errors. Note that it is not used to clean/tidy the HTML, # it is just used as a primitive HTML checker. # CCache.html is generated by yodl2html and has a few insignificant problems, so we don't put it through tidy check: - tidy -errors --gnu-emacs yes -quiet index.html - tidy -errors --gnu-emacs yes -quiet Sections.html - all=`sed '/^#/d' chapters | grep -v CCache.html`; for a in $$all; do tidy -errors --gnu-emacs yes -quiet $$a; done; + all="index.html Sections.html `sed '/^#/d' chapters | grep -v CCache.html`" && for a in $$all; do echo "Check for tabs $$a" && if grep -P '\t' $$a; then echo "Please delete the tabs from the lines above" && exit 1; fi; done && for a in $$all; do echo "HTML tidy check $$a" && tidy -errors --gnu-emacs yes -quiet $$a; done; -generate: swightml.book swigpdf.book +# Note wkhtmltopdf limitations for generating pdf docs: +# 1)

    Text

    style links don't work and need changing to +#

    Text

    +# 2) Tabs in
     elements should be expanded to 8 spaces by default, but
    +#     are expanded to just one space and css tab-size is not working.
    +#  3) 
       elements do not always select a fixed-width font - try installing the
    +#     Courier font to fix - these have been added to style.css.
    +generate: SWIGDocumentation.html
    +	wkhtmltopdf --version | grep "with patched qt" || (echo "wkhtmltopdf is not the patched qt version and so cannot be used - download it from http://wkhtmltopdf.org/downloads.html" && false)
    +	wkhtmltopdf --margin-top 20mm --margin-bottom 20mm --margin-left 10mm --margin-right 10mm --header-font-size 6 --footer-font-size 6 --header-spacing 6 --footer-spacing 6 --header-center '[doctitle]' --footer-left '[subsection]' --footer-right '[page]' SWIGDocumentation.html SWIGDocumentation.pdf
    +
    +SWIGDocumentation.html: swightml.book
     	htmldoc --batch swightml.book || true
    -	htmldoc --batch swigpdf.book || true
     	python fixstyle.py SWIGDocumentation.html
     
    -swigpdf.book: chapters Sections.html
    -	echo "#HTMLDOC 1.8.24" > swigpdf.book
    -	echo -t pdf13 -f SWIGDocumentation.pdf $(HTMLDOC_OPTIONS) --stylesheet style.css >> swigpdf.book
    -	echo "Sections.html" >> swigpdf.book
    -	cat chapters >> swigpdf.book
    -
     swightml.book: chapters Sections.html
     	echo "#HTMLDOC 1.8.24" > swightml.book
     	echo -t html -f SWIGDocumentation.html $(HTMLDOC_OPTIONS) >> swightml.book
    @@ -52,10 +56,9 @@ swightml.book: chapters Sections.html
     
     maintainer-clean: clean-baks
     	rm -f swightml.book
    -	rm -f swigpdf.book
    -	rm -f CCache.html
     	rm -f SWIGDocumentation.html
     	rm -f SWIGDocumentation.pdf
    +	rm -rf linkchecker-tmp
     
     clean-baks:
     	rm -f *.bak
    @@ -69,10 +72,18 @@ test:
     validate:
     	all=`sed '/^#/d' chapters`; for a in $$all; do validate --emacs $$a; done;
     
    -# Link checking using linkchecker
    -linkchecker:
    +# Link checking using linkchecker of the index.html only file (including anchors)
    +linkchecker1:
     	@echo -----------------------------------------------------------------------
     	@echo Note linkchecker versions prior to 6.1 do not work properly wrt anchors
     	@echo -----------------------------------------------------------------------
    -	linkchecker --config=./linkchecker.config index.html
    +	linkchecker --config=./linkchecker.config --anchors index.html
    +
    +# Check for links which don't work including those generated from the individual .html files into SWIGDocumentation.html
    +linkchecker2:
    +	rm -rf linkchecker-tmp
    +	mkdir linkchecker-tmp
    +	cp SWIGDocumentation.html linkchecker-tmp
    +	cp *.png linkchecker-tmp
    +	(cd linkchecker-tmp && linkchecker --config=../linkchecker.config -F text --no-warnings SWIGDocumentation.html)
     
    diff --git a/Doc/Manual/Modula3.html b/Doc/Manual/Modula3.html
    index 065313f..f324495 100644
    --- a/Doc/Manual/Modula3.html
    +++ b/Doc/Manual/Modula3.html
    @@ -1,11 +1,12 @@
    -
    +
     
     
     SWIG and Modula-3
     
    +
     
     
    -

    27 SWIG and Modula-3

    +

    29 SWIG and Modula-3

      @@ -45,7 +46,7 @@

      -This chapter describes SWIG's support of +This chapter describes SWIG's support for Modula-3. You should be familiar with the basics @@ -54,7 +55,7 @@ especially typemaps.

      -

      27.1 Overview

      +

      29.1 Overview

      @@ -84,7 +85,7 @@ FFTW -

      27.1.1 Motivation

      +

      29.1.1 Motivation

      @@ -109,7 +110,7 @@ into exceptions.

      If the library API is ill designed -writing appropriate typemaps can be still time-consuming. +writing appropriate typemaps can still be time-consuming. E.g. C programmers are very creative to work-around missing data types like (real) enumerations and sets. You should turn such work-arounds back to the Modula-3 way @@ -120,21 +121,21 @@ otherwise you lose static safety and consistency. Without SWIG you would probably never consider trying to call C++ libraries from Modula-3, but with SWIG this is becomes feasible. SWIG can generate C wrappers to C++ functions and object methods -that may throw exceptions, and then wrap these C wrappers for Module-3. +that may throw exceptions, and then wrap these C wrappers for Modula-3. To make it complete you can then hide the C interface with Modula-3 classes and exceptions.

      SWIG allows you to call C and C++ libraries from Modula-3 (even with call back -functions), but it doesn't allow you to easily integrate a Module-3 module into +functions), but it doesn't allow you to easily integrate a Modula-3 module into a C/C++ project.

      -

      27.2 Conception

      +

      29.2 Conception

      -

      27.2.1 Interfaces to C libraries

      +

      29.2.1 Interfaces to C libraries

      @@ -283,7 +284,7 @@ and the principal type must be renamed (%typemap).

      -

      27.2.2 Interfaces to C++ libraries

      +

      29.2.2 Interfaces to C++ libraries

      @@ -384,10 +385,10 @@ There is no C++ library I wrote a SWIG interface for, so I'm not sure if this is possible or sensible, yet.

      -

      27.3 Preliminaries

      +

      29.3 Preliminaries

      -

      27.3.1 Compilers

      +

      29.3.1 Compilers

      @@ -400,7 +401,7 @@ For testing examples I use Critical Mass cm3.

      -

      27.3.2 Additional Commandline Options

      +

      29.3.2 Additional Commandline Options

      @@ -477,10 +478,10 @@ Instead generate templates for some basic typemaps. -

      27.4 Modula-3 typemaps

      +

      29.4 Modula-3 typemaps

      -

      27.4.1 Inputs and outputs

      +

      29.4.1 Inputs and outputs

      @@ -694,7 +695,7 @@ consist of the following parts: -

      27.4.2 Subranges, Enumerations, Sets

      +

      29.4.2 Subranges, Enumerations, Sets

      @@ -746,7 +747,7 @@ that I'd like to automate.

      -

      27.4.3 Objects

      +

      29.4.3 Objects

      @@ -759,7 +760,7 @@ is not really useful, yet.

      -

      27.4.4 Imports

      +

      29.4.4 Imports

      @@ -792,7 +793,7 @@ IMPORT M3toC;

    -

    27.4.5 Exceptions

    +

    29.4.5 Exceptions

    @@ -816,7 +817,7 @@ you should declare %typemap("m3wrapinconv:throws") blah * %{OSError.E%}.

    -

    27.4.6 Example

    +

    29.4.6 Example

    @@ -863,10 +864,10 @@ where almost everything is generated by a typemap:

    -

    27.5 More hints to the generator

    +

    29.5 More hints to the generator

    -

    27.5.1 Features

    +

    29.5.1 Features

    @@ -903,7 +904,7 @@ where almost everything is generated by a typemap:
    -

    27.5.2 Pragmas

    +

    29.5.2 Pragmas

    @@ -926,7 +927,7 @@ where almost everything is generated by a typemap:
    -

    27.6 Remarks

    +

    29.6 Remarks

      diff --git a/Doc/Manual/Modules.html b/Doc/Manual/Modules.html index 70b0f11..089b1a4 100644 --- a/Doc/Manual/Modules.html +++ b/Doc/Manual/Modules.html @@ -1,12 +1,13 @@ - + Working with Modules + -

      15 Working with Modules

      +

      16 Working with Modules

        @@ -23,7 +24,7 @@ -

        15.1 Modules Introduction

        +

        16.1 Modules Introduction

        @@ -77,7 +78,7 @@ where you want to create a collection of modules. Each module in the collection is created via separate invocations of SWIG.

        -

        15.2 Basics

        +

        16.2 Basics

        @@ -130,7 +131,7 @@ public:

        To create the wrapper properly, module derived_module needs to know about the base class and that its interface is covered in another module. The -line %import "base_module.i" lets SWIG know exactly that. Oftentimes +line %import "base_module.i" lets SWIG know exactly that. Often the .h file is passed to %import instead of the .i, which unfortunately doesn't work for all language modules. For example, Python requires the name of module that the base class exists in so that the proxy classes can fully inherit the @@ -176,7 +177,7 @@ in parallel from multiple threads as SWIG provides no locking - for more on that issue, read on.

        -

        15.3 The SWIG runtime code

        +

        16.3 The SWIG runtime code

        @@ -242,7 +243,7 @@ can peacefully coexist. So the type structures are separated by the is empty. Only modules compiled with the same pair will share type information.

        -

        15.4 External access to the runtime

        +

        16.4 External access to the runtime

        As described in The run-time type checker, @@ -250,7 +251,9 @@ the functions SWIG_TypeQuery, SWIG_NewPointerObj, and others s to be called. Calling these functions from a typemap is supported, since the typemap code is embedded into the _wrap.c file, which has those declarations available. If you need to call the SWIG run-time functions from another C file, there is one header you need -to include. To generate the header that needs to be included, run the following command: +to include. To generate the header that needs to be included, SWIG can be run in a different +mode via -external-runtime to generate the run-time instead of the normal mode of +processing an input interface file. For example:

         $ swig -python -external-runtime <filename>
        @@ -279,7 +282,7 @@ SWIG_TYPE_TABLE to be the same as the module whose types you are trying to
         access.
         

        -

        15.5 A word of caution about static libraries

        +

        16.5 A word of caution about static libraries

        @@ -290,7 +293,7 @@ into it. This is very often NOT what you want and it can lead to unexpect behavior. When working with dynamically loadable modules, you should try to work exclusively with shared libraries.

        -

        15.6 References

        +

        16.6 References

        @@ -298,7 +301,7 @@ Due to the complexity of working with shared libraries and multiple modules, it an outside reference. John Levine's "Linkers and Loaders" is highly recommended.

        -

        15.7 Reducing the wrapper file size

        +

        16.7 Reducing the wrapper file size

        diff --git a/Doc/Manual/Mzscheme.html b/Doc/Manual/Mzscheme.html index 3b49a29..c5c1992 100644 --- a/Doc/Manual/Mzscheme.html +++ b/Doc/Manual/Mzscheme.html @@ -1,14 +1,14 @@ - - + SWIG and MzScheme/Racket + -

        28 SWIG and MzScheme/Racket

        +

        30 SWIG and MzScheme/Racket

          @@ -24,7 +24,7 @@

          This section contains information on SWIG's support of Racket, formally known as MzScheme. -

          28.1 Creating native structures

          +

          30.1 Creating native structures

          @@ -56,16 +56,16 @@ Then in scheme, you can use regular struct access procedures like

          -	; suppose a function created a struct foo as 
          -	; (define foo (make-diag-cntrs (#x1 #x2 #x3) (make-inspector))
          -	; Then you can do
          -	(format "0x~x" (diag-cntrs-field1 foo))
          -	(format "0x~x" (diag-cntrs-field2 foo))
          -	;etc...
          +        ; suppose a function created a struct foo as
          +        ; (define foo (make-diag-cntrs (#x1 #x2 #x3) (make-inspector))
          +        ; Then you can do
          +        (format "0x~x" (diag-cntrs-field1 foo))
          +        (format "0x~x" (diag-cntrs-field2 foo))
          +        ;etc...
           
          -

          28.2 Simple example

          +

          30.2 Simple example

          @@ -166,7 +166,7 @@ Some points of interest:

        • The above requests mzc to create an extension using the CGC garbage-collector. The alternative -- the 3m collector -- has generally better performance, but work is still required for SWIG to emit code which is compatible with it.
        -

        28.3 External documentation

        +

        30.3 External documentation

        diff --git a/Doc/Manual/Ocaml.html b/Doc/Manual/Ocaml.html index 127be90..e489c41 100644 --- a/Doc/Manual/Ocaml.html +++ b/Doc/Manual/Ocaml.html @@ -1,12 +1,13 @@ - + - SWIG and Ocaml +SWIG and Ocaml + - - -

        29 SWIG and Ocaml

        + + +

        31 SWIG and Ocaml

      @@ -59,74 +60,76 @@

      - This chapter describes SWIG's -support of Ocaml. Ocaml is a relatively recent addition to the ML family, -and is a recent addition to SWIG. It's the second compiled, typed -language to be added. Ocaml has widely acknowledged benefits for engineers, -mostly derived from a sophisticated type system, compile-time checking -which eliminates several classes of common programming errors, and good -native performance. While all of this is wonderful, there are well-written -C and C++ libraries that Ocaml users will want to take advantage of as -part of their arsenal (such as SSL and gdbm), as well as their own mature -C and C++ code. SWIG allows this code to be used in a natural, type-safe -way with Ocaml, by providing the necessary, but repetitive glue code -which creates and uses Ocaml values to communicate with C and C++ code. - In addition, SWIG also produces the needed Ocaml source that binds -variants, functions, classes, etc. +This chapter describes SWIG's support of Ocaml. +

      + +

      +Ocaml is a relatively recent addition to the ML family, +and is a recent addition to SWIG. It's the second compiled, typed +language to be added. Ocaml has widely acknowledged benefits for engineers, +mostly derived from a sophisticated type system, compile-time checking +which eliminates several classes of common programming errors, and good +native performance. While all of this is wonderful, there are well-written +C and C++ libraries that Ocaml users will want to take advantage of as +part of their arsenal (such as SSL and gdbm), as well as their own mature +C and C++ code. SWIG allows this code to be used in a natural, type-safe +way with Ocaml, by providing the necessary, but repetitive glue code +which creates and uses Ocaml values to communicate with C and C++ code. +In addition, SWIG also produces the needed Ocaml source that binds +variants, functions, classes, etc.

      If you're not familiar with the Objective Caml language, you can visit -The Ocaml Website. +The Ocaml Website.

      -

      29.1 Preliminaries

      +

      31.1 Preliminaries

      - SWIG 1.3 works with Ocaml 3.04 and above. Given the choice, - you should use the latest stable release. The SWIG Ocaml module has -been tested on Linux (x86,PPC,Sparc) and Cygwin on Windows. The -best way to determine whether your system will work is to compile the -examples and test-suite which come with SWIG. You can do this by running -make check from the SWIG root directory after installing SWIG. - The Ocaml module has been tested using the system's dynamic linking (the -usual -lxxx against libxxx.so, as well as with Gerd Stolpmann's -Dl package -. The ocaml_dynamic and ocaml_dynamic_cpp targets in the +SWIG 3.0 works with Ocaml 3.08.3 and above. Given the choice, +you should use the latest stable release. The SWIG Ocaml module has +been tested on Linux (x86,PPC,Sparc) and Cygwin on Windows. The +best way to determine whether your system will work is to compile the +examples and test-suite which come with SWIG. You can do this by running +make check from the SWIG root directory after installing SWIG. +The Ocaml module has been tested using the system's dynamic linking (the +usual -lxxx against libxxx.so, as well as with Gerd Stolpmann's +Dl package. +The ocaml_dynamic and ocaml_dynamic_cpp targets in the file Examples/Makefile illustrate how to compile and link SWIG modules that will be loaded dynamically. This has only been tested on Linux so far.

      -

      29.1.1 Running SWIG

      +

      31.1.1 Running SWIG

      - The basics of getting a SWIG Ocaml module up and running - can be seen from one of SWIG's example Makefiles, but is also described - here. To build an Ocaml module, run SWIG using the -ocaml -option. +The basics of getting a SWIG Ocaml module up and running +can be seen from one of SWIG's example Makefiles, but is also described +here. To build an Ocaml module, run SWIG using the -ocaml +option.

      -
      -
      +
      +
       %swig -ocaml example.i
      -  
      +
      - -

      This will produce 3 files. The file example_wrap.c contains + +

      This will produce 3 files. The file example_wrap.c contains all of the C code needed to build an Ocaml module. To build the module, -you will compile the file example_wrap.c with ocamlc or +you will compile the file example_wrap.c with ocamlc or ocamlopt to create the needed .o file. You will need to compile the resulting .ml and .mli files as well, and do the final link with -custom -(not needed for native link).

      - -

      29.1.2 Compiling the code

      +(not needed for native link).

      + +

      31.1.2 Compiling the code

      -The OCaml SWIG module now requires you to compile a module (Swig) +The OCaml SWIG module now requires you to compile a module (Swig) separately. In addition to aggregating common SWIG functionality, the Swig module contains the data structure that represents C/C++ values. This allows easier data sharing between modules if two or more are combined, because @@ -134,39 +137,40 @@ the type of each SWIG'ed module's c_obj is derived from Swig.c_obj_t. This also allows SWIG to acquire new conversions painlessly, as well as giving the user more freedom with respect to custom typing. - Use ocamlc or ocamlopt to compile your - SWIG interface like: +Use ocamlc or ocamlopt to compile your SWIG interface like:

      - -
      -
      +
      +
      +
       % swig -ocaml -co swig.mli ; swig -ocaml co swig.ml
       % ocamlc -c swig.mli ; ocamlc -c swig.ml
       % ocamlc -c -ccopt "-I/usr/include/foo" example_wrap.c
       % ocamlc -c example.mli
       % ocamlc -c example.ml
      -  
      +
      - -

      ocamlc is aware of .c files and knows how to handle them. Unfortunately, - it does not know about .cxx, .cc, or .cpp files, so when SWIG is invoked - in C++ mode, you must:

      - -
      -
      -% cp example_wrap.cxx example_wrap.cxx.c
      % ocamlc -c ... -ccopt -xc++ example_wrap.cxx.c
      % ...
      -
      + +

      ocamlc is aware of .c files and knows how to handle them. Unfortunately, +it does not know about .cxx, .cc, or .cpp files, so when SWIG is invoked +in C++ mode, you must:

      + +
      +
      +% cp example_wrap.cxx example_wrap.cxx.c
      +% ocamlc -c ... -ccopt -xc++ example_wrap.cxx.c
      +% ...
      +
      -

      29.1.3 The camlp4 module

      +

      31.1.3 The camlp4 module

      The camlp4 module (swigp4.ml -> swigp4.cmo) contains a simple rewriter which -makes C++ code blend more seamlessly with objective caml code. It's use is +makes C++ code blend more seamlessly with objective caml code. Its use is optional, but encouraged. The source file is included in the Lib/ocaml -directory of the SWIG source distribution. You can checkout this file with -"swig -ocaml -co swigp4.ml". You should compile the file with +directory of the SWIG source distribution. You can checkout this file with +"swig -ocaml -co swigp4.ml". You should compile the file with "ocamlc -I `camlp4 -where` -pp 'camlp4o pa_extend.cmo q_MLast.cmo' -c swigp4.ml"

      @@ -192,7 +196,7 @@ a '+= b (invoke object) "+=" argument as in
      (invoke a) "+=" b -Note that because camlp4 always recognizes << +Note that because camlp4 always recognizes << and >>, they are replaced by lsl and lsr in operator names. 'unop object as in
      @@ -234,21 +238,21 @@ let b = C_string (getenv "PATH") -

      29.1.4 Using your module

      +

      31.1.4 Using your module

      You can test-drive your module by building a toplevel ocaml interpreter. Consult the ocaml manual for details.

      - +

      When linking any ocaml bytecode with your module, use the -custom - option to build your functions into the primitive list. This - option is not needed when you build native code. +option to build your functions into the primitive list. This +option is not needed when you build native code.

      -

      29.1.5 Compilation problems and compiling with C++

      +

      31.1.5 Compilation problems and compiling with C++

      @@ -259,7 +263,7 @@ liberal with pointer types may not compile under the C++ compiler. Most code meant to be compiled as C++ will not have problems.

      -

      29.2 The low-level Ocaml/C interface

      +

      31.2 The low-level Ocaml/C interface

      @@ -273,9 +277,9 @@ In the code as seen by the typemap writer, there is a value, swig_result, that always contains the current return data. It is a list, and must be appended with the caml_list_append function, or with functions and macros provided by -objective caml.
      +objective caml.

      - +
       type c_obj =
           C_void
      @@ -299,68 +303,67 @@ type c_obj =
       

      - A few functions exist which generate and return these: +A few functions exist which generate and return these:

      - +
        -
      • caml_ptr_val receives a c_obj and returns a void *.  This - should be used for all pointer purposes.
      • -
      • caml_long_val receives a c_obj and returns a long.  This - should be used for most integral purposes.
        -
      • -
      • caml_val_ptr receives a void * and returns a c_obj.
      • -
      • caml_val_bool receives a C int and returns a c_obj representing - it's bool value.
      • -
      • caml_val_(u)?(char|short|int|long|float|double) receives an -appropriate C value and returns a c_obj representing it.
      • -
      • caml_val_string receives a char * and returns a string value.
      • -
      • caml_val_string_len receives a char * and a length and returns - a string value.
      • -
      • caml_val_obj receives a void * and an object type and returns - a C_obj, which contains a closure giving method access.
      • - +
      • caml_ptr_val receives a c_obj and returns a void *. This + should be used for all pointer purposes.
      • +
      • caml_long_val receives a c_obj and returns a long. This + should be used for most integral purposes.
      • +
      • caml_val_ptr receives a void * and returns a c_obj.
      • +
      • caml_val_bool receives a C int and returns a c_obj representing + its bool value.
      • +
      • caml_val_(u)?(char|short|int|long|float|double) receives an + appropriate C value and returns a c_obj representing it.
      • +
      • caml_val_string receives a char * and returns a string value.
      • +
      • caml_val_string_len receives a char * and a length and returns + a string value.
      • +
      • caml_val_obj receives a void * and an object type and returns + a C_obj, which contains a closure giving method access.

      Because of this style, a typemap can return any kind of value it -wants from a function.  This enables out typemaps and inout typemaps -to work well.  The one thing to remember about outputting values -is that you must append them to the return list with swig_result = caml_list_append(swig_result,v). -

      - -

      - This function will return a new list that has your element - appended. Upon return to caml space, the fnhelper function - beautifies the result. A list containing a single item degrades to - only that item (i.e. [ C_int 3 ] -> C_int 3), and a list - containing more than one item is wrapped in C_list (i.e. [ C_char - 'a' ; C_char 'b' -> C_list [ C_char 'a' ; C_char b - ]).  This is in order to make return values easier to handle - when functions have only one return value, such as constructors, - and operators.  In addition, string, pointer, and object - values are interchangeable with respect to caml_ptr_val, so you can - allocate memory as caml strings and still use the resulting - pointers for C purposes, even using them to construct simple objects - on. Note, though, that foreign C++ code does not respect the garbage - collector, although the SWIG interface does.

      - -

      - The wild card type that you can use in lots of different ways is - C_obj. It allows you to wrap any type of thing you like as an - object using the same mechanism that the ocaml module - does.  When evaluated in caml_ptr_val, the returned value is - the result of a call to the object's "&" operator, taken as a pointer. -

      -

      - You should only construct values using objective caml, or using the - functions caml_val_* functions provided as static functions to a SWIG - ocaml module, as well as the caml_list_* functions. These functions - provide everything a typemap needs to produce values. In addition, - value items pass through directly, but you must make your own type - signature for a function that uses value in this way. -

      - -

      29.2.1 The generated module

      +wants from a function. This enables out typemaps and inout typemaps +to work well. The one thing to remember about outputting values +is that you must append them to the return list with swig_result = caml_list_append(swig_result,v). +

      + +

      +This function will return a new list that has your element +appended. Upon return to caml space, the fnhelper function +beautifies the result. A list containing a single item degrades to +only that item (i.e. [ C_int 3 ] -> C_int 3), and a list +containing more than one item is wrapped in C_list (i.e. [ C_char +'a' ; C_char 'b' -> C_list [ C_char 'a' ; C_char b +]). This is in order to make return values easier to handle +when functions have only one return value, such as constructors, +and operators. In addition, string, pointer, and object +values are interchangeable with respect to caml_ptr_val, so you can +allocate memory as caml strings and still use the resulting +pointers for C purposes, even using them to construct simple objects +on. Note, though, that foreign C++ code does not respect the garbage +collector, although the SWIG interface does.

      + +

      +The wild card type that you can use in lots of different ways is +C_obj. It allows you to wrap any type of thing you like as an +object using the same mechanism that the ocaml module +does. When evaluated in caml_ptr_val, the returned value is +the result of a call to the object's "&" operator, taken as a pointer. +

      + +

      +You should only construct values using objective caml, or using the +functions caml_val_* functions provided as static functions to a SWIG +ocaml module, as well as the caml_list_* functions. These functions +provide everything a typemap needs to produce values. In addition, +value items pass through directly, but you must make your own type +signature for a function that uses value in this way. +

      + +

      31.2.1 The generated module

      @@ -376,7 +379,7 @@ that the keywords are not the same as the C++ ones. You can introduce extra code into the output wherever you like with SWIG. These are the places you can introduce code: - @@ -385,25 +388,25 @@ file. - +
      "header"This code is inserted near the beginning of the +
      "header"This code is inserted near the beginning of the C wrapper file, before any function definitions.
      "wrapper"This code is inserted in the function definition section.
      "mli"This code is inserted into the caml interface file. Special signatures should be inserted here.
      "ml"This code is inserted in the caml code defining the +
      "ml"This code is inserted in the caml code defining the interface to your C code. Special caml code, as well as any initialization which should run when the module is loaded may be inserted here. -
      "classtemplate"The "classtemplate" place is special because it describes the output SWIG will generate for class definitions.
      - -

      29.2.2 Enums

      + +

      31.2.2 Enums

      SWIG will wrap enumerations as polymorphic variants in the output -Ocaml code, as above in C_enum.  In order to support all +Ocaml code, as above in C_enum. In order to support all C++-style uses of enums, the function int_to_enum and enum_to_int are provided for ocaml code to produce and consume these values as -integers.  Other than that, correct uses of enums will not have -a problem.  Since enum labels may overlap between enums, the +integers. Other than that, correct uses of enums will not have +a problem. Since enum labels may overlap between enums, the enum_to_int and int_to_enum functions take an enum type label as an argument. Example:

      @@ -416,9 +419,9 @@ enum c_enum_type { a = 1, b, c = 4, d = 8 }; enum c_enum_type { a = 1, b, c = 4, d = 8 };
      -

      +

      The output mli contains: -

      +

       type c_enum_type = [
      @@ -435,16 +438,16 @@ type c_enum_tag = [
       val int_to_enum c_enum_type -> int -> c_obj
       val enum_to_int c_enum_type -> c_obj -> c_obj
       
      -
      +

      - So it's possible to do this: +So it's possible to do this:

      -
      -
      +
      +
       bash-2.05a$ ocamlmktop -custom enum_test_wrap.o enum_test.cmo -o enum_test_top
      -bash-2.05a$ ./enum_test_top 
      +bash-2.05a$ ./enum_test_top
               Objective Caml version 3.04
       
       # open Enum_test ;;
      @@ -455,9 +458,9 @@ val x : Enum_test.c_obj = C_enum `a
       # int_to_enum `c_enum_type 4 ;;
       - : Enum_test.c_obj = C_enum `c
       
      -
      +
      -

      29.2.2.1 Enum typing in Ocaml

      +

      31.2.2.1 Enum typing in Ocaml

      @@ -470,10 +473,10 @@ functions imported from different modules. You must convert values to master values using the swig_val function before sharing them with another module.

      -

      29.2.3 Arrays

      +

      31.2.3 Arrays

      -

      29.2.3.1 Simple types of bounded arrays

      +

      31.2.3.1 Simple types of bounded arrays

      @@ -485,7 +488,7 @@ distribution.

      By including "carray.i", you will get access to some macros that help you -create typemaps for array types fairly easily. +create typemaps for array types fairly easily.

      @@ -494,7 +497,7 @@ arrays of simple types with known bounds in your code, but this only works for arrays whose bounds are completely specified.

      -

      29.2.3.2 Complex and unbounded arrays

      +

      31.2.3.2 Complex and unbounded arrays

      @@ -507,7 +510,7 @@ SWIG can't predict which of these methods will be used in the array, so you have to specify it for yourself in the form of a typemap.

      -

      29.2.3.3 Using an object

      +

      31.2.3.3 Using an object

      @@ -521,7 +524,7 @@ Consider writing an object when the ending condition of your array is complex, such as using a required sentinel, etc.

      -

      29.2.3.4 Example typemap for a function taking float * and int

      +

      31.2.3.4 Example typemap for a function taking float * and int

      @@ -541,24 +544,24 @@ into this type of function convenient. #include <stdio.h> void printfloats( float *tab, int len ) { - int i; + int i; - for( i = 0; i < len; i++ ) { - printf( "%f ", tab[i] ); - } + for( i = 0; i < len; i++ ) { + printf( "%f ", tab[i] ); + } - printf( "\n" ); + printf( "\n" ); } %} %typemap(in) (float *tab, int len) { - int i; - /* $*1_type */ - $2 = caml_array_len($input); - $1 = ($*1_type *)malloc( $2 * sizeof( float ) ); - for( i = 0; i < $2; i++ ) { - $1[i] = caml_double_val(caml_array_nth($input,i)); - } + int i; + /* $*1_type */ + $2 = caml_array_len($input); + $1 = ($*1_type *)malloc( $2 * sizeof( float ) ); + for( i = 0; i < $2; i++ ) { + $1[i] = caml_double_val(caml_array_nth($input,i)); + } } void printfloats( float *tab, int len ); @@ -572,30 +575,30 @@ void printfloats( float *tab, int len ); -

      29.2.4 C++ Classes

      +

      31.2.4 C++ Classes

      C++ classes, along with structs and unions are represented by C_obj -(string -> c_obj -> c_obj) wrapped closures.  These objects +(string -> c_obj -> c_obj) wrapped closures. These objects contain a method list, and a type, which allow them to be used like C++ objects. When passed into typemaps that use pointers, they -degrade to pointers through their "&" method.  Every method +degrade to pointers through their "&" method. Every method an object has is represented as a string in the object's method table, -and each method table exists in memory only once.  In addition +and each method table exists in memory only once. In addition to any other operators an object might have, certain builtin ones are -provided by SWIG: (all of these take no arguments (C_void)) +provided by SWIG: (all of these take no arguments (C_void))

      - - @@ -603,8 +606,8 @@ have been wrapped by SWIG. indicated parent class. This is mainly used internally by the SWIG module, but may be useful to client programs.
      "~"Delete this object
      "&"Return an ordinary C_ptr value representing this +
      "&"Return an ordinary C_ptr value representing this object's address
      "sizeof"If enabled with ("sizeof"="1") on the module node, return the object's size in char.
      ":methods"Returns a list of strings containing the names of the methods this object contains
      ":classof"Returns the name of the class this object belongs +
      ":classof"Returns the name of the class this object belongs to.
      ":parents"Returns a list of all direct parent classes which have been wrapped by SWIG.
      "[member-variable]"Each member variable is wrapped as a -method with an optional parameter. -Called with one argument, the member variable is set to the value of the +method with an optional parameter. +Called with one argument, the member variable is set to the value of the argument. With zero arguments, the value is returned.
      @@ -615,7 +618,7 @@ the underlying pointer, so using create_[x]_from_ptr alters the returned value for the same object.

      -

      29.2.4.1 STL vector and string Example

      +

      31.2.4.1 STL vector and string Example

      @@ -637,7 +640,7 @@ length. Instead, use multiple returns, as in the argout_ref example. %include <stl.i> namespace std { - %template(StringVector) std::vector < string >; + %template(StringVector) std::vector < string >; }; %include "example.h" @@ -652,12 +655,12 @@ Since there's a makefile in that directory, the example is easy to build.

      Here's a sample transcript of an interactive session using a string vector -after making a toplevel (make toplevel). This example uses the camlp4 +after making a toplevel (make toplevel). This example uses the camlp4 module.

      -bash-2.05a$ ./example_top 
      +bash-2.05a$ ./example_top
               Objective Caml version 3.06
       
               Camlp4 Parsing version 3.06
      @@ -685,17 +688,17 @@ C_list
       - : Example.c_obj = C_void
       # x '[1] ;;
       - : Example.c_obj = C_string "spam"
      -# for i = 0 to (x -> size() as int) - 1 do 
      -    print_endline ((x '[i to int]) as string) 
      +# for i = 0 to (x -> size() as int) - 1 do
      +    print_endline ((x '[i to int]) as string)
         done ;;
       foo
       bar
       baz
       - : unit = ()
      -# 
      +#
       
      -

      29.2.4.2 C++ Class Example

      +

      31.2.4.2 C++ Class Example

      @@ -703,7 +706,7 @@ Here's a simple example using Trolltech's Qt Library:

      - +
      qt.i
      qt.i
       %module qt
       %{
      @@ -712,20 +715,20 @@ Here's a simple example using Trolltech's Qt Library:
       %}
       class QApplication {
       public:
      -        QApplication( int argc, char **argv );
      -        void setMainWidget( QWidget *widget );
      -        void exec();
      +  QApplication( int argc, char **argv );
      +  void setMainWidget( QWidget *widget );
      +  void exec();
       };
       
       class QPushButton {
       public:
      -        QPushButton( char *str, QWidget *w );
      -        void resize( int x, int y );
      -        void show();
      +  QPushButton( char *str, QWidget *w );
      +  void resize( int x, int y );
      +  void show();
       };
       
      -

      29.2.4.3 Compiling the example

      +

      31.2.4.3 Compiling the example

      @@ -733,9 +736,9 @@ bash-2.05a$ QTPATH=/your/qt/path
       bash-2.05a$ for file in swig.mli swig.ml swigp4.ml ; do swig -ocaml -co $file ; done
       bash-2.05a$ ocamlc -c swig.mli ; ocamlc -c swig.ml
       bash-2.05a$ ocamlc -I `camlp4 -where` -pp "camlp4o pa_extend.cmo q_MLast.cmo" -c swigp4.ml
      -bash-2.05a$ swig -ocaml -c++ -I$QTPATH/include  qt.i
      +bash-2.05a$ swig -ocaml -c++ -I$QTPATH/include qt.i
       bash-2.05a$ mv qt_wrap.cxx qt_wrap.c
      -bash-2.05a$ ocamlc -c -ccopt -xc++ -ccopt -g -g -ccopt -I$QTPATH/include qt_wrap.c 
      +bash-2.05a$ ocamlc -c -ccopt -xc++ -ccopt -g -g -ccopt -I$QTPATH/include qt_wrap.c
       bash-2.05a$ ocamlc -c qt.mli
       bash-2.05a$ ocamlc -c qt.ml
       bash-2.05a$ ocamlmktop -custom swig.cmo -I `camlp4 -where` \
      @@ -743,11 +746,11 @@ bash-2.05a$ ocamlmktop -custom swig.cmo -I `camlp4 -where` \
         -L$QTPATH/lib -cclib -lqt
       
      -

      29.2.4.4 Sample Session

      +

      31.2.4.4 Sample Session

      -bash-2.05a$ ./qt_top 
      +bash-2.05a$ ./qt_top
               Objective Caml version 3.06
       
               Camlp4 Parsing version 3.06
      @@ -767,13 +770,13 @@ val hello : Qt.c_obj = C_obj <fun>
       
       

      Assuming you have a working installation of QT, you will see a window -containing the string "hi" in a button. +containing the string "hi" in a button.

      -

      29.2.5 Director Classes

      +

      31.2.5 Director Classes

      -

      29.2.5.1 Director Introduction

      +

      31.2.5.1 Director Introduction

      @@ -800,7 +803,7 @@ class foo { };

      -

      29.2.5.2 Overriding Methods in Ocaml

      +

      31.2.5.2 Overriding Methods in Ocaml

      @@ -828,7 +831,7 @@ In this example, I'll examine the objective caml code involved in providing an overloaded class. This example is contained in Examples/ocaml/shapes.

      -

      29.2.5.3 Director Usage Example

      +

      31.2.5.3 Director Usage Example

      @@ -845,14 +848,14 @@ let triangle_class pts ob meth args = "cover" -> (match args with C_list [ x_arg ; y_arg ] -> - let xa = x_arg as float - and ya = y_arg as float in - (point_in_triangle pts xa ya) to bool + let xa = x_arg as float + and ya = y_arg as float in + (point_in_triangle pts xa ya) to bool | _ -> raise (Failure "cover needs two double arguments.")) | _ -> (invoke ob) meth args ;; let triangle = - new_derived_object + new_derived_object new_shape (triangle_class ((0.0,0.0),(0.5,1.0),(1.0,0.0))) '() ;; @@ -887,7 +890,7 @@ in a more effortless style in ocaml, while leaving the "engine" part of the program in C++.

      -

      29.2.5.4 Creating director objects

      +

      31.2.5.4 Creating director objects

      @@ -896,7 +899,7 @@ The definition of the actual object triangle can be described this way:

       let triangle =
      -  new_derived_object 
      +  new_derived_object
           new_shape
           (triangle_class ((0.0,0.0),(0.5,1.0),(1.0,0.0)))
           '()
      @@ -904,13 +907,13 @@ let triangle =
       
       

      The first argument to new_derived_object, new_shape is the method -which returns a shape instance. This function will be invoked with the +which returns a shape instance. This function will be invoked with the third argument will be appended to the argument list [ C_void ]. In the example, the actual argument list is sent as (C_list [ C_void ; C_void ]). The augmented constructor for a director class needs the first argument to determine whether it is being constructed as a derived object, or as an object of the indicated type only (in this case shape). The -Second argument is a closure that will be added to the final C_obj. +Second argument is a closure that will be added to the final C_obj.

      @@ -928,7 +931,7 @@ object from causing a core dump, as long as the object is destroyed properly.

      -

      29.2.5.5 Typemaps for directors, directorin, directorout, directorargout

      +

      31.2.5.5 Typemaps for directors, directorin, directorout, directorargout

      @@ -939,7 +942,7 @@ well as a function return value in the same way you provide function arguments, and to receive arguments the same way you normally receive function returns.

      -

      29.2.5.6 directorin typemap

      +

      31.2.5.6 typemap

      @@ -950,7 +953,7 @@ code receives when you are called. In general, a simple directorin typ can use the same body as a simple out typemap.

      -

      29.2.5.7 directorout typemap

      +

      31.2.5.7 directorout typemap

      @@ -961,7 +964,7 @@ for the same type, except when there are special requirements for object ownership, etc.

      -

      29.2.5.8 directorargout typemap

      +

      31.2.5.8 directorargout typemap

      @@ -978,7 +981,7 @@ In the event that you don't specify all of the necessary values, integral values will read zero, and struct or object returns have undefined results.

      -

      29.2.6 Exceptions

      +

      31.2.6 Exceptions

      diff --git a/Doc/Manual/Octave.html b/Doc/Manual/Octave.html index 3e12ce6..9b9744f 100644 --- a/Doc/Manual/Octave.html +++ b/Doc/Manual/Octave.html @@ -1,14 +1,15 @@ - + SWIG and Octave + -

      30 SWIG and Octave

      +

      32 SWIG and Octave

      -

      30.3 A tour of basic C/C++ wrapping

      +

      32.3 A tour of basic C/C++ wrapping

      -

      30.3.1 Modules

      +

      32.3.1 Modules

      @@ -211,7 +217,7 @@ octave:4> swigexample.gcd(4,6) ans = 2 -

      30.3.2 Functions

      +

      32.3.2 Functions

      @@ -228,7 +234,7 @@ int fact(int n);

      octave:1> swigexample.fact(4)
       24 
      -

      30.3.3 Global variables

      +

      32.3.3 Global variables

      @@ -281,7 +287,7 @@ octave:2> swigexample.PI=3.142; octave:3> swigexample.PI ans = 3.1420 -

      30.3.4 Constants and enums

      +

      32.3.4 Constants and enums

      @@ -303,7 +309,7 @@ swigexample.SCONST="Hello World" swigexample.SUNDAY=0 .... -

      30.3.5 Pointers

      +

      32.3.5 Pointers

      @@ -329,7 +335,7 @@ octave:4> swigexample.fclose(f);

      - Simply printing the value of a wrapped C++ type will print it's typename. E.g., + Simply printing the value of a wrapped C++ type will print its typename. E.g.,

      octave:1> swigexample;
      @@ -350,7 +356,7 @@ octave:2> f=swigexample.fopen("not there","r");
       error: value on right hand side of assignment is undefined
       error: evaluating assignment expression near line 2, column 2 
      -

      30.3.6 Structures and C++ classes

      +

      32.3.6 Structures and C++ classes

      @@ -485,7 +491,7 @@ ans = 1 Depending on the ownership setting of a swig_ref, it may call C++ destructors when its reference count goes to zero. See the section on memory management below for details.

      -

      30.3.7 C++ inheritance

      +

      32.3.7 C++ inheritance

      @@ -494,7 +500,7 @@ This information contains the full class hierarchy. When an indexing operation ( the tree is walked to find a match in the current class as well as any of its bases. The lookup is then cached in the swig_ref.

      -

      30.3.8 C++ overloaded functions

      +

      32.3.8 C++ overloaded functions

      @@ -504,7 +510,7 @@ The dispatch function selects which overload to call (if any) based on the passe typecheck typemaps are used to analyze each argument, as well as assign precedence. See the chapter on typemaps for details.

      -

      30.3.9 C++ operators

      +

      32.3.9 C++ operators

      @@ -512,7 +518,7 @@ C++ operator overloading is supported, in a way similar to other modules. The swig_ref type supports all unary and binary operators between itself and all other types that exist in the system at module load time. When an operator is used (where one of the operands is a swig_ref), the runtime routes the call to either a member function of the given object, or to a global function whose named is derived from the types of the operands (either both or just the lhs or rhs).

      -For example, if a and b are SWIG variables in Octave, a+b becomes a.__add(b). The wrapper is then free to implement __add to do whatever it wants. A wrapper may define the __add function manually, %rename some other function to it, or %rename a C++ operator to it. +For example, if a and b are SWIG variables in Octave, a+b becomes a.__add__(b). The wrapper is then free to implement __add__ to do whatever it wants. A wrapper may define the __add__ function manually, %rename some other function to it, or %rename a C++ operator to it.

      By default the C++ operators are renamed to their corresponding Octave operators. So without doing any work, the following interface @@ -539,87 +545,87 @@ assert(c.value==5); Octave operators are mapped in the following way:

      -__brace      a{args}
      -__brace_asgn a{args} = rhs
      -__paren      a(args)
      -__paren_asgn a(args) = rhs
      -__str        generates string rep
      -__not        !a
      -__uplus      +a
      -__uminus     -a
      -__transpose  a.'
      -__hermitian  a'
      -__incr       a++
      -__decr       a--
      -__add        a + b
      -__sub        a - b
      -__mul        a * b
      -__div        a / b
      -__pow        a ^ b
      -__ldiv       a \ b
      -__lshift     a << b
      -__rshift     a >> b
      -__lt         a < b
      -__le         a <= b
      -__eq         a == b
      -__ge         a >= b
      -__gt         a > b
      -__ne         a != b
      -__el_mul     a .* b
      -__el_div     a ./ b
      -__el_pow     a .^ b
      -__el_ldiv    a .\ b
      -__el_and     a & b
      -__el_or      a | b
      +__brace__      a{args}
      +__brace_asgn__ a{args} = rhs
      +__paren__      a(args)
      +__paren_asgn__ a(args) = rhs
      +__str__        generates string rep
      +__not__        !a
      +__uplus__      +a
      +__uminus__     -a
      +__transpose__  a.'
      +__hermitian__  a'
      +__incr__       a++
      +__decr__       a--
      +__add__        a + b
      +__sub__        a - b
      +__mul__        a * b
      +__div__        a / b
      +__pow__        a ^ b
      +__ldiv__       a \ b
      +__lshift__     a << b
      +__rshift__     a >> b
      +__lt__         a < b
      +__le__         a <= b
      +__eq__         a == b
      +__ge__         a >= b
      +__gt__         a > b
      +__ne__         a != b
      +__el_mul__     a .* b
      +__el_div__     a ./ b
      +__el_pow__     a .^ b
      +__el_ldiv__    a .\ b
      +__el_and__     a & b
      +__el_or__      a | b
       

      On the C++ side, the default mappings are as follows:

      -%rename(__add)       *::operator+;
      -%rename(__add)       *::operator+();
      -%rename(__add)       *::operator+() const;
      -%rename(__sub)       *::operator-;
      -%rename(__uminus)    *::operator-();
      -%rename(__uminus)    *::operator-() const;
      -%rename(__mul)       *::operator*;
      -%rename(__div)       *::operator/;
      -%rename(__mod)       *::operator%;
      -%rename(__lshift)    *::operator<<;
      -%rename(__rshift)    *::operator>>;
      -%rename(__el_and)    *::operator&&;
      -%rename(__el_or)     *::operator||;
      -%rename(__xor)       *::operator^;
      -%rename(__invert)    *::operator~;
      -%rename(__lt)        *::operator<;
      -%rename(__le)        *::operator<=;
      -%rename(__gt)        *::operator>;
      -%rename(__ge)        *::operator>=;
      -%rename(__eq)        *::operator==;
      -%rename(__ne)        *::operator!=;
      -%rename(__not)       *::operator!;
      -%rename(__incr)      *::operator++;
      -%rename(__decr)      *::operator--;
      -%rename(__paren)     *::operator();
      -%rename(__brace)     *::operator[];
      +%rename(__add__)       *::operator+;
      +%rename(__add__)       *::operator+();
      +%rename(__add__)       *::operator+() const;
      +%rename(__sub__)       *::operator-;
      +%rename(__uminus__)    *::operator-();
      +%rename(__uminus__)    *::operator-() const;
      +%rename(__mul__)       *::operator*;
      +%rename(__div__)       *::operator/;
      +%rename(__mod__)       *::operator%;
      +%rename(__lshift__)    *::operator<<;
      +%rename(__rshift__)    *::operator>>;
      +%rename(__el_and__)    *::operator&&;
      +%rename(__el_or__)     *::operator||;
      +%rename(__xor__)       *::operator^;
      +%rename(__invert__)    *::operator~;
      +%rename(__lt__)        *::operator<;
      +%rename(__le__)        *::operator<=;
      +%rename(__gt__)        *::operator>;
      +%rename(__ge__)        *::operator>=;
      +%rename(__eq__)        *::operator==;
      +%rename(__ne__)        *::operator!=;
      +%rename(__not__)       *::operator!;
      +%rename(__incr__)      *::operator++;
      +%rename(__decr__)      *::operator--;
      +%rename(__paren__)     *::operator();
      +%rename(__brace__)     *::operator[];
       

      Octave can also utilise friend (i.e. non-member) operators with a simple %rename: see the example in the Examples/octave/operator directory.

      -

      30.3.10 Class extension with %extend

      +

      32.3.10 Class extension with %extend

      The %extend directive works the same as in other modules.

      -You can use it to define special behavior, like for example defining Octave operators not mapped to C++ operators, or defining certain Octave mechanisms such as how an object prints. For example, the octave_value::{is_string,string_value,print} functions are routed to a special method __str that can be defined inside an %extend. +You can use it to define special behavior, like for example defining Octave operators not mapped to C++ operators, or defining certain Octave mechanisms such as how an object prints. For example, the octave_value::{is_string,string_value,print} functions are routed to a special method __str__ that can be defined inside an %extend.

       %extend A {
      -string __str() {
      +string __str__() {
         stringstream sout;
         sout<<$self->value;
         return sout.str();
      @@ -635,10 +641,19 @@ octave:2> a
       a = 4
       octave:3> printf("%s\n",a);
       4
      -octave:4> a.__str()
      +octave:4> a.__str__()
       4
       
      -

      30.3.11 C++ templates

      + +

      +Similarly, Octave can use the __float__ method to convert an object to a numeric value. +

      + +

      +Octave 3.8.0 and later versions will also map unary functions X() to the corresponding __X__ method, where X includes: abs(), acos(), acosh(), angle(), arg(), asin(), asinh(), atan(), atanh(), cbrt(), ceil(), conj(), cos(), cosh(), dawson(), erf(), erfc(), erfcinv(), erfcx(), erfi(), erfinv(), exp(), expm1(), finite(), fix(), floor(), gamma(), imag(), isalnum(), isalpha(), isascii(), iscntrl(), isdigit(), isgraph(), isinf(), islower(), isna(), isnan(), isprint(), ispunct(), isspace(), isupper(), isxdigit(), lgamma(), log(), log10(), log1p(), log2(), real(), round(), roundb(), signbit(), signum(), sin(), sinh(), sqrt(), tan(), tanh(), toascii(), tolower(), toupper() +

      + +

      32.3.11 C++ templates

      @@ -687,7 +702,7 @@ Similarly, class templates can be instantiated as in the following example, s+=_s; return *this; } - std::string __str() const { + std::string __str__() const { std::stringstream sout; sout<<s; return sout.str(); @@ -715,14 +730,28 @@ ans = -

      30.3.12 C++ Smart Pointers

      +

      32.3.12 C++ Smart Pointers

      + + +

      32.3.12.1 The shared_ptr Smart Pointer

      + + +

      +The C++11 standard provides std::shared_ptr which was derived from the Boost +implementation, boost::shared_ptr. +Both of these are available for Octave in the SWIG library and usage is outlined +in the shared_ptr smart pointer library section. +

      + + +

      32.3.12.2 Generic Smart Pointers

      C++ smart pointers are fully supported as in other modules.

      -

      30.3.13 Directors (calling Octave from C++ code)

      +

      32.3.13 Directors (calling Octave from C++ code)

      @@ -803,14 +832,14 @@ c-side routine called octave-side routine called -

      30.3.14 Threads

      +

      32.3.14 Threads

      The use of threads in wrapped Director code is not supported; i.e., an Octave-side implementation of a C++ class must be called from the Octave interpreter's thread. Anything fancier (apartment/queue model, whatever) is left to the user. Without anything fancier, this amounts to the limitation that Octave must drive the module... like, for example, an optimization package that calls Octave to evaluate an objective function.

      -

      30.3.15 Memory management

      +

      32.3.15 Memory management

      @@ -844,14 +873,14 @@ The %newobject directive may be used to control this behavior for pointers retur In the case where one wishes for the C++ side to own an object that was created in Octave (especially a Director object), one can use the __disown() method to invert this logic. Then letting the Octave reference count go to zero will not destroy the object, but destroying the object will invalidate the Octave-side object if it still exists (and call destructors of other C++ bases in the case of multiple inheritance/subclass()'ing).

      -

      30.3.16 STL support

      +

      32.3.16 STL support

      Various STL library files are provided for wrapping STL containers.

      -

      30.3.17 Matrix typemaps

      +

      32.3.17 Matrix typemaps

      diff --git a/Doc/Manual/Perl5.html b/Doc/Manual/Perl5.html index 49e8965..8d7b866 100644 --- a/Doc/Manual/Perl5.html +++ b/Doc/Manual/Perl5.html @@ -1,12 +1,13 @@ - + SWIG and Perl5 + -

      31 SWIG and Perl5

      +

      33 SWIG and Perl5

      @@ -87,7 +97,7 @@ later. We're no longer testing regularly with older versions, but Perl 5.6 seems to mostly work, while older versions don't.

      -

      31.1 Overview

      +

      33.1 Overview

      @@ -108,7 +118,7 @@ described. Advanced customization features, typemaps, and other options are found near the end of the chapter.

      -

      31.2 Preliminaries

      +

      33.2 Preliminaries

      @@ -133,7 +143,7 @@ To build the module, you will need to compile the file example_wrap.c and link it with the rest of your program.

      -

      31.2.1 Getting the right header files

      +

      33.2.1 Getting the right header files

      @@ -165,7 +175,7 @@ $ perl -e 'use Config; print "$Config{archlib}\n";' -

      31.2.2 Compiling a dynamic module

      +

      33.2.2 Compiling a dynamic module

      @@ -198,7 +208,7 @@ the target should be named `example.so', `example.sl', or the appropriate dynamic module name on your system.

      -

      31.2.3 Building a dynamic module with MakeMaker

      +

      33.2.3 Building a dynamic module with MakeMaker

      @@ -210,9 +220,9 @@ script such as the following:

      # File : Makefile.PL use ExtUtils::MakeMaker; WriteMakefile( - `NAME' => `example', # Name of package - `LIBS' => [`-lm'], # Name of custom libraries - `OBJECT' => `example.o example_wrap.o' # Object files + `NAME' => `example', # Name of package + `LIBS' => [`-lm'], # Name of custom libraries + `OBJECT' => `example.o example_wrap.o' # Object files ); @@ -232,7 +242,7 @@ the preferred approach to compilation. More information about MakeMaker can be found in "Programming Perl, 2nd ed." by Larry Wall, Tom Christiansen, and Randal Schwartz.

      -

      31.2.4 Building a static version of Perl

      +

      33.2.4 Building a static version of Perl

      @@ -291,7 +301,7 @@ for a dynamic module, but change the link line to something like this:

       $ gcc example.o example_wrap.o -L/usr/lib/perl/5.14/CORE \
      -	-lperl -lsocket -lnsl -lm -o myperl
      +        -lperl -lsocket -lnsl -lm -o myperl
       

      @@ -301,7 +311,7 @@ added to it. Depending on your machine, you may need to link with additional libraries such as -lsocket, -lnsl, -ldl, etc.

      -

      31.2.5 Using the module

      +

      33.2.5 Using the module

      @@ -454,7 +464,7 @@ system configuration (this requires root access and you will need to read the man pages).

      -

      31.2.6 Compilation problems and compiling with C++

      +

      33.2.6 Compilation problems and compiling with C++

      @@ -484,8 +494,8 @@ Solaris, you often need to add an extra library -lCrun like this:

       $ swig -c++ -perl example.i
      -$ CC -c example.cxx
      -$ CC -c example_wrap.cxx -I/usr/lib/perl/5.14/i386-linux/CORE
      +$ CC -Kpic -c example.cxx
      +$ CC -Kpic -c example_wrap.cxx -I/usr/lib/perl/5.14/i386-linux/CORE
       $ CC -shared example.o example_wrap.o -o example.so -lCrun
       
      @@ -597,7 +607,7 @@ have to find the macro that conflicts and add an #undef into the .i file. Pleas any conflicting macros you find to swig-user mailing list.

      -

      31.2.7 Compiling for 64-bit platforms

      +

      33.2.7 Compiling for 64-bit platforms

      @@ -624,7 +634,7 @@ also introduce problems on platforms that support more than one linking standard (e.g., -o32 and -n32 on Irix).

      -

      31.3 Building Perl Extensions under Windows

      +

      33.3 Building Perl Extensions under Windows

      @@ -635,7 +645,7 @@ section assumes you are using SWIG with Microsoft Visual C++ although the procedure may be similar with other compilers.

      -

      31.3.1 Running SWIG from Developer Studio

      +

      33.3.1 Running SWIG from Developer Studio

      @@ -698,7 +708,7 @@ print "$a\n"; -

      31.3.2 Using other compilers

      +

      33.3.2 Using other compilers

      @@ -706,7 +716,7 @@ SWIG is known to work with Cygwin and may work with other compilers on Windows. For general hints and suggestions refer to the Windows chapter.

      -

      31.4 The low-level interface

      +

      33.4 The low-level interface

      @@ -716,7 +726,7 @@ can be used to control your application. However, it is also used to construct more user-friendly proxy classes as described in the next section.

      -

      31.4.1 Functions

      +

      33.4.1 Functions

      @@ -739,7 +749,7 @@ use example; $a = &example::fact(2); -

      31.4.2 Global variables

      +

      33.4.2 Global variables

      @@ -809,7 +819,7 @@ extern char *path; // Declared later in the input -

      31.4.3 Constants

      +

      33.4.3 Constants

      @@ -849,7 +859,7 @@ print example::FOO,"\n"; -

      31.4.4 Pointers

      +

      33.4.4 Pointers

      @@ -882,9 +892,9 @@ To check to see if a value is the NULL pointer, use the

       if (defined($ptr)) {
      -	print "Not a NULL pointer.";
      +  print "Not a NULL pointer.";
       } else {
      -	print "Is a NULL pointer.";
      +  print "Is a NULL pointer.";
       }
       
       
      @@ -907,9 +917,9 @@ dereference them as follows:
       if ($$a == $$b) {
      -	print "a and b point to the same thing in C";
      +  print "a and b point to the same thing in C";
       } else {
      -	print "a and b point to different objects.";
      +  print "a and b point to different objects.";
       }
       
       
      @@ -958,7 +968,7 @@ as XS and xsubpp. Given the advancement of the SWIG typesystem and the SWIG and XS, this is no longer supported.

      -

      31.4.5 Structures

      +

      33.4.5 Structures

      @@ -968,7 +978,7 @@ accessor functions as described in the "SWIG Basics" chapter. For example,

       struct Vector {
      -	double x,y,z;
      +  double x,y,z;
       };
       
      @@ -1092,7 +1102,7 @@ void Bar_f_set(Bar *b, Foo *val) { -

      31.4.6 C++ classes

      +

      33.4.6 C++ classes

      @@ -1157,7 +1167,7 @@ provides direct access to C++ objects. A higher level interface using Perl prox can be built using these low-level accessors. This is described shortly.

      -

      31.4.7 C++ classes and type-checking

      +

      33.4.7 C++ classes and type-checking

      @@ -1193,7 +1203,7 @@ If necessary, the type-checker also adjusts the value of the pointer (as is nece multiple inheritance is used).

      -

      31.4.8 C++ overloaded functions

      +

      33.4.8 C++ overloaded functions

      @@ -1237,7 +1247,7 @@ example::Spam_foo_d($s,3.14); Please refer to the "SWIG Basics" chapter for more information.

      -

      31.4.9 Operators

      +

      33.4.9 Operators

      @@ -1249,22 +1259,22 @@ The following C++ operators are currently supported by the Perl module:

        -
      • operator++
      • -
      • operator--
      • -
      • operator+
      • -
      • operator-
      • -
      • operator*
      • -
      • operator/
      • -
      • operator==
      • -
      • operator!=
      • -
      • operator%
      • -
      • operator>
      • -
      • operator<
      • +
      • operator++
      • +
      • operator--
      • +
      • operator+
      • +
      • operator-
      • +
      • operator*
      • +
      • operator/
      • +
      • operator==
      • +
      • operator!=
      • +
      • operator%
      • +
      • operator>
      • +
      • operator<
      • operator and
      • operator or
      -

      31.4.10 Modules and packages

      +

      33.4.10 Modules and packages

      @@ -1359,7 +1369,7 @@ print Foo::fact(4),"\n"; # Call a function in package FooBar --> -

      31.5 Input and output parameters

      +

      33.5 Input and output parameters

      @@ -1578,7 +1588,7 @@ print "$c\n"; Note: The REFERENCE feature is only currently supported for numeric types (integers and floating point).

      -

      31.6 Exception handling

      +

      33.6 Exception handling

      @@ -1743,7 +1753,7 @@ This is still supported, but it is deprecated. The newer %exception di functionality, but it has additional capabilities that make it more powerful.

      -

      31.7 Remapping datatypes with typemaps

      +

      33.7 Remapping datatypes with typemaps

      @@ -1760,7 +1770,7 @@ Typemaps are only used if you want to change some aspect of the primitive C-Perl interface.

      -

      31.7.1 A simple typemap example

      +

      33.7.1 A simple typemap example

      @@ -1773,8 +1783,8 @@ you might define a typemap like this: %module example %typemap(in) int { - $1 = (int) SvIV($input); - printf("Received an integer : %d\n", $1); + $1 = (int) SvIV($input); + printf("Received an integer : %d\n", $1); } ... %inline %{ @@ -1819,8 +1829,8 @@ the typemap system follows typedef declarations. For example:

       %typemap(in) int n {
      -	$1 = (int) SvIV($input);
      -	printf("n = %d\n",$1);
      +  $1 = (int) SvIV($input);
      +  printf("n = %d\n",$1);
       }
       %inline %{
       typedef int Integer;
      @@ -1864,7 +1874,7 @@ example::count("e","Hello World");
       
      -

      31.7.2 Perl5 typemaps

      +

      33.7.2 Perl5 typemaps

      @@ -1969,7 +1979,7 @@ Return of C++ member data (all languages). Check value of input parameter. -

      31.7.3 Typemap variables

      +

      33.7.3 Typemap variables

      @@ -2040,7 +2050,7 @@ properly assigned. The Perl name of the wrapper function being created. -

      31.7.4 Useful functions

      +

      33.7.4 Useful functions

      @@ -2109,7 +2119,7 @@ int sv_isa(SV *, char *0; -

      31.8 Typemap Examples

      +

      33.8 Typemap Examples

      @@ -2118,7 +2128,7 @@ might look at the files "perl5.swg" and "typemaps.i" in the SWIG library.

      -

      31.8.1 Converting a Perl5 array to a char **

      +

      33.8.1 Converting a Perl5 array to a char **

      @@ -2133,47 +2143,47 @@ reference to be used as a char ** datatype. // This tells SWIG to treat char ** as a special case %typemap(in) char ** { - AV *tempav; - I32 len; - int i; - SV **tv; - if (!SvROK($input)) - croak("Argument $argnum is not a reference."); - if (SvTYPE(SvRV($input)) != SVt_PVAV) - croak("Argument $argnum is not an array."); - tempav = (AV*)SvRV($input); - len = av_len(tempav); - $1 = (char **) malloc((len+2)*sizeof(char *)); - for (i = 0; i <= len; i++) { - tv = av_fetch(tempav, i, 0); - $1[i] = (char *) SvPV(*tv,PL_na); - } - $1[i] = NULL; + AV *tempav; + I32 len; + int i; + SV **tv; + if (!SvROK($input)) + croak("Argument $argnum is not a reference."); + if (SvTYPE(SvRV($input)) != SVt_PVAV) + croak("Argument $argnum is not an array."); + tempav = (AV*)SvRV($input); + len = av_len(tempav); + $1 = (char **) malloc((len+2)*sizeof(char *)); + for (i = 0; i <= len; i++) { + tv = av_fetch(tempav, i, 0); + $1[i] = (char *) SvPV(*tv,PL_na); + } + $1[i] = NULL; }; // This cleans up the char ** array after the function call %typemap(freearg) char ** { - free($1); + free($1); } // Creates a new Perl array and places a NULL-terminated char ** into it %typemap(out) char ** { - AV *myav; - SV **svs; - int i = 0,len = 0; - /* Figure out how many elements we have */ - while ($1[len]) - len++; - svs = (SV **) malloc(len*sizeof(SV *)); - for (i = 0; i < len ; i++) { - svs[i] = sv_newmortal(); - sv_setpv((SV*)svs[i],$1[i]); - }; - myav = av_make(len,svs); - free(svs); - $result = newRV_noinc((SV*)myav); - sv_2mortal($result); - argvi++; + AV *myav; + SV **svs; + int i = 0,len = 0; + /* Figure out how many elements we have */ + while ($1[len]) + len++; + svs = (SV **) malloc(len*sizeof(SV *)); + for (i = 0; i < len ; i++) { + svs[i] = sv_newmortal(); + sv_setpv((SV*)svs[i],$1[i]); + }; + myav = av_make(len,svs); + free(svs); + $result = newRV_noinc((SV*)myav); + sv_2mortal($result); + argvi++; } // Now a few test functions @@ -2210,7 +2220,7 @@ print @$b,"\n"; # Print it out -

      31.8.2 Return values

      +

      33.8.2 Return values

      @@ -2230,16 +2240,16 @@ can be done using the EXTEND() macro as in:

       %typemap(argout) int *OUTPUT {
      -	if (argvi >= items) {            
      -		EXTEND(sp,1);              /* Extend the stack by 1 object */
      -	}
      -	$result = sv_newmortal();
      -	sv_setiv($target,(IV) *($1));
      -	argvi++;
      +  if (argvi >= items) {
      +    EXTEND(sp,1);              /* Extend the stack by 1 object */
      +  }
      +  $result = sv_newmortal();
      +  sv_setiv($target,(IV) *($1));
      +  argvi++;
       }
       
      -

      31.8.3 Returning values from arguments

      +

      33.8.3 Returning values from arguments

      @@ -2254,24 +2264,24 @@ its arguments. This example describes the implementation of the OUTPUT // an output value. %typemap(argout) double *OUTPUT { - $result = sv_newmortal(); - sv_setnv($result, *$input); - argvi++; /* Increment return count -- important! */ + $result = sv_newmortal(); + sv_setnv($result, *$input); + argvi++; /* Increment return count -- important! */ } // We don't care what the input value is. Ignore, but set to a temporary variable %typemap(in,numinputs=0) double *OUTPUT(double junk) { - $1 = &junk; + $1 = &junk; } // Now a function to test it %{ /* Returns the first two input arguments */ int multout(double a, double b, double *out1, double *out2) { - *out1 = a; - *out2 = b; - return 0; + *out1 = a; + *out2 = b; + return 0; }; %} @@ -2293,7 +2303,7 @@ print "multout(7,13) = @r\n"; ($x,$y) = multout(7,13); -

      31.8.4 Accessing array structure members

      +

      33.8.4 Accessing array structure members

      @@ -2356,7 +2366,7 @@ the "in" typemap in the previous section would be used to convert an to copy the converted array into a C data structure.

      -

      31.8.5 Turning Perl references into C pointers

      +

      33.8.5 Turning Perl references into C pointers

      @@ -2367,7 +2377,7 @@ have a C function that modifies its arguments like this:

       void add(double a, double b, double *c) {
      -	*c = a + b;
      +  *c = a + b;
       }
       
      @@ -2421,7 +2431,7 @@ print "$c\n"; -

      31.8.6 Pointer handling

      +

      33.8.6 Pointer handling

      @@ -2500,7 +2510,7 @@ For example: -

      31.9 Proxy classes

      +

      33.9 Proxy classes

      @@ -2516,7 +2526,7 @@ to the underlying code. This section describes the implementation details of the proxy interface.

      -

      31.9.1 Preliminaries

      +

      33.9.1 Preliminaries

      @@ -2538,7 +2548,7 @@ SWIG creates a collection of high-level Perl wrappers. In your scripts, you wil high level wrappers. The wrappers, in turn, interact with the low-level procedural module.

      -

      31.9.2 Structure and class wrappers

      +

      33.9.2 Structure and class wrappers

      @@ -2548,9 +2558,9 @@ Suppose you have the following SWIG interface file:

       %module example
       struct Vector {
      -	Vector(double x, double y, double z);
      -	~Vector();
      -	double x,y,z;
      +  Vector(double x, double y, double z);
      +  ~Vector();
      +  double x,y,z;
       };
       
       
      @@ -2600,8 +2610,9 @@ sub DESTROY { my $self = tied(%{$_[0]}); delete $ITERATORS{$self}; if (exists $OWNER{$self}) { - examplec::delete_Vector($self)); - delete $OWNER{$self}; + examplec::delete_Vector($self)); + delete $OWNER{$self}; + } } sub FETCH { @@ -2653,8 +2664,8 @@ $v->{x} = 7.5; # Assignment of all members %$v = ( x=>3, - y=>9, - z=>-2); + y=>9, + z=>-2); # Reading members $x = $v->{x}; @@ -2664,7 +2675,7 @@ $v->DESTROY(); -

      31.9.3 Object Ownership

      +

      33.9.3 Object Ownership

      @@ -2675,7 +2686,7 @@ problem---suppose you had a function like this:

       Vector *Vector_get(Vector *v, int index) {
      -	return &v[i];
      +  return &v[i];
       }
       
      @@ -2688,9 +2699,9 @@ Vector object:
       Vector *new_Vector(double x, double y, double z) {
      -	Vector *v;
      -	v = new Vector(x,y,z);        // Call C++ constructor
      -	return v;
      +  Vector *v;
      +  v = new Vector(x,y,z);        // Call C++ constructor
      +  return v;
       }
       
      @@ -2751,7 +2762,7 @@ counting, garbage collection, or advanced features one might find in sophisticated languages.

      -

      31.9.4 Nested Objects

      +

      33.9.4 Nested Objects

      @@ -2760,10 +2771,10 @@ Suppose that we have a new object that looks like this:

       struct Particle {
      -	Vector r;
      -	Vector v;
      -	Vector f;
      -	int	type;
      +  Vector r;
      +  Vector v;
      +  Vector f;
      +  int type;
       }
       
       
      @@ -2779,9 +2790,9 @@ look like this (along with some supporting code): package Particle; ... %BLESSEDMEMBERS = ( - r => `Vector', - v => `Vector', - f => `Vector', + r => `Vector', + v => `Vector', + f => `Vector', ); @@ -2804,7 +2815,7 @@ $p->{f}->{x} = 0.0; %${$p->{v}} = ( x=>0, y=>0, z=>0); -

      31.9.5 Proxy Functions

      +

      33.9.5 Proxy Functions

      @@ -2838,7 +2849,7 @@ This function replaces the original function, but operates in an identical manner.

      -

      31.9.6 Inheritance

      +

      33.9.6 Inheritance

      @@ -2857,23 +2868,23 @@ interface file: class Shape { public: - virtual double area() = 0; - virtual double perimeter() = 0; - void set_location(double x, double y); + virtual double area() = 0; + virtual double perimeter() = 0; + void set_location(double x, double y); }; class Circle : public Shape { public: - Circle(double radius); - ~Circle(); - double area(); - double perimeter(); + Circle(double radius); + ~Circle(); + double area(); + double perimeter(); }; class Square : public Shape { public: - Square(double size); - ~Square(); - double area(); - double perimeter(); + Square(double size); + ~Square(); + double area(); + double perimeter(); } @@ -2914,7 +2925,7 @@ particular, inheritance of data members is extremely tricky (and I'm not even sure if it really works).

      -

      31.9.7 Modifying the proxy methods

      +

      33.9.7 Modifying the proxy methods

      @@ -2942,7 +2953,7 @@ public: }; -

      31.10 Adding additional Perl code

      +

      33.10 Adding additional Perl code

      @@ -2993,6 +3004,363 @@ set_transform($im, $a); +

      33.11 Cross language polymorphism

      + + +

      +Proxy classes provide a more natural, object-oriented way to access +extension classes. As described above, each proxy instance has an +associated C++ instance, and method calls to the proxy are passed to the +C++ instance transparently via C wrapper functions. +

      + +

      +This arrangement is asymmetric in the sense that no corresponding +mechanism exists to pass method calls down the inheritance chain from +C++ to Perl. In particular, if a C++ class has been extended in Perl +(by extending the proxy class), these extensions will not be visible +from C++ code. Virtual method calls from C++ are thus not able access +the lowest implementation in the inheritance chain. +

      + +

      +Changes have been made to SWIG to address this problem and +make the relationship between C++ classes and proxy classes more +symmetric. To achieve this goal, new classes called directors are +introduced at the bottom of the C++ inheritance chain. The job of the +directors is to route method calls correctly, either to C++ +implementations higher in the inheritance chain or to Perl +implementations lower in the inheritance chain. The upshot is that C++ +classes can be extended in Perl and from C++ these extensions look +exactly like native C++ classes. Neither C++ code nor Perl code needs +to know where a particular method is implemented: the combination of +proxy classes, director classes, and C wrapper functions takes care of +all the cross-language method routing transparently. +

      + +

      33.11.1 Enabling directors

      + + +

      +The director feature is disabled by default. To use directors you +must make two changes to the interface file. First, add the "directors" +option to the %module directive, like this: +

      + +
      +
      +%module(directors="1") modulename
      +
      +
      + +

      +Without this option no director code will be generated. Second, you +must use the %feature("director") directive to tell SWIG which classes +and methods should get directors. The %feature directive can be applied +globally, to specific classes, and to specific methods, like this: +

      + +
      +
      +// generate directors for all classes that have virtual methods
      +%feature("director");         
      +
      +// generate directors for all virtual methods in class Foo
      +%feature("director") Foo;      
      +
      +
      + +

      +You can use the %feature("nodirector") directive to turn off +directors for specific classes or methods. So for example, +

      + +
      +
      +%feature("director") Foo;
      +%feature("nodirector") Foo::bar;
      +
      +
      + +

      +will generate directors for all virtual methods of class Foo except +bar(). +

      + +

      +Directors can also be generated implicitly through inheritance. +In the following, class Bar will get a director class that handles +the methods one() and two() (but not three()): +

      + +
      +
      +%feature("director") Foo;
      +class Foo {
      +public:
      +    Foo(int foo);
      +    virtual void one();
      +    virtual void two();
      +};
      +
      +class Bar: public Foo {
      +public:
      +    virtual void three();
      +};
      +
      +
      + +

      +then at the Perl side you can define +

      + +
      +
      +use mymodule;
      +
      +package MyFoo;
      +use base 'mymodule::Foo';
      +
      +sub one {
      +  print "one from Perl\n";
      +}
      +
      +
      + + +

      33.11.2 Director classes

      + + + + + +

      +For each class that has directors enabled, SWIG generates a new class +that derives from both the class in question and a special +Swig::Director class. These new classes, referred to as director +classes, can be loosely thought of as the C++ equivalent of the Perl +proxy classes. The director classes store a pointer to their underlying +Perl object and handle various issues related to object ownership. +

      + +

      +For simplicity let's ignore the Swig::Director class and refer to the +original C++ class as the director's base class. By default, a director +class extends all virtual methods in the inheritance chain of its base +class (see the preceding section for how to modify this behavior). +Thus all virtual method calls, whether they originate in C++ or in +Perl via proxy classes, eventually end up in at the implementation in +the director class. The job of the director methods is to route these +method calls to the appropriate place in the inheritance chain. By +"appropriate place" we mean the method that would have been called if +the C++ base class and its extensions in Perl were seamlessly +integrated. That seamless integration is exactly what the director +classes provide, transparently skipping over all the messy extension API +glue that binds the two languages together. +

      + +

      +In reality, the "appropriate place" is one of only two possibilities: +C++ or Perl. Once this decision is made, the rest is fairly easy. If +the correct implementation is in C++, then the lowest implementation of +the method in the C++ inheritance chain is called explicitly. If the +correct implementation is in Perl, the Perl API is used to call the +method of the underlying Perl object (after which the usual virtual +method resolution in Perl automatically finds the right +implementation). +

      + +

      +Now how does the director decide which language should handle the method call? +The basic rule is to handle the method in Perl, unless there's a good +reason not to. The reason for this is simple: Perl has the most +"extended" implementation of the method. This assertion is guaranteed, +since at a minimum the Perl proxy class implements the method. If the +method in question has been extended by a class derived from the proxy +class, that extended implementation will execute exactly as it should. +If not, the proxy class will route the method call into a C wrapper +function, expecting that the method will be resolved in C++. The wrapper +will call the virtual method of the C++ instance, and since the director +extends this the call will end up right back in the director method. Now +comes the "good reason not to" part. If the director method were to blindly +call the Perl method again, it would get stuck in an infinite loop. We avoid this +situation by adding special code to the C wrapper function that tells +the director method to not do this. The C wrapper function compares the +pointer to the Perl object that called the wrapper function to the +pointer stored by the director. If these are the same, then the C +wrapper function tells the director to resolve the method by calling up +the C++ inheritance chain, preventing an infinite loop. +

      + +

      +One more point needs to be made about the relationship between director +classes and proxy classes. When a proxy class instance is created in +Perl, SWIG creates an instance of the original C++ class. +This is exactly what happens without directors and +is true even if directors are enabled for the particular class in +question. When a class derived from a proxy class is created, +however, SWIG then creates an instance of the corresponding C++ director +class. The reason for this difference is that user-defined subclasses +may override or extend methods of the original class, so the director +class is needed to route calls to these methods correctly. For +unmodified proxy classes, all methods are ultimately implemented in C++ +so there is no need for the extra overhead involved with routing the +calls through Perl. +

      + +

      33.11.3 Ownership and object destruction

      + + +

      +Memory management issues are slightly more complicated with directors +than for proxy classes alone. Perl instances hold a pointer to the +associated C++ director object, and the director in turn holds a pointer +back to a Perl object. By default, proxy classes own their C++ +director object and take care of deleting it when they are garbage +collected. +

      + +

      +This relationship can be reversed by calling the special +DISOWN() method of the proxy class. After calling this +method the director +class increments the reference count of the Perl object. When the +director class is deleted it decrements the reference count. Assuming no +outstanding references to the Perl object remain, the Perl object +will be destroyed at the same time. This is a good thing, since +directors and proxies refer to each other and so must be created and +destroyed together. Destroying one without destroying the other will +likely cause your program to segfault. +

      + +

      +Also note that due to the proxy implementation, the DESTROY() +method on directors can be called for several reasons, many of which +have little to do with the teardown of an object instance. To help +disambiguate this, a second argument is added to the DESTROY() +call when a C++ director object is being released. So, to avoid running +your clean-up code when an object is not really going away, or after it +has already been reclaimed, it is suggested that custom destructors in +Perl subclasses looks something like: +

      + +
      +
      +sub DESTROY {
      +  my($self, $final) = @_;
      +  if($final) {
      +    # real teardown code
      +  }
      +  shift->SUPER::DESTROY(@_);
      +}
      +
      +
      + + +

      33.11.4 Exception unrolling

      + + +

      +With directors routing method calls to Perl, and proxies routing them +to C++, the handling of exceptions is an important concern. By default, the +directors ignore exceptions that occur during method calls that are +resolved in Perl. To handle such exceptions correctly, it is necessary +to temporarily translate them into C++ exceptions. This can be done with +the %feature("director:except") directive. The following code should +suffice in most cases: +

      + +
      +
      +%feature("director:except") {
      +    if ($error != NULL) {
      +        throw Swig::DirectorMethodException();
      +    }
      +}
      +
      +
      + +

      +This code will check the Perl error state after each method call from +a director into Perl, and throw a C++ exception if an error occurred. +This exception can be caught in C++ to implement an error handler. +

      + +

      +It may be the case that a method call originates in Perl, travels up +to C++ through a proxy class, and then back into Perl via a director +method. If an exception occurs in Perl at this point, it would be nice +for that exception to find its way back to the original caller. This can +be done by combining a normal %exception directive with the +director:except handler shown above. Here is an example of a +suitable exception handler: +

      + +
      +
      +%exception {
      +    try { $action }
      +    catch (Swig::DirectorException &e) { SWIG_fail; }
      +}
      +
      +
      + +

      +The class Swig::DirectorException used in this example is actually a +base class of Swig::DirectorMethodException, so it will trap this +exception. Because the Perl error state is still set when +Swig::DirectorMethodException is thrown, Perl will register the +exception as soon as the C wrapper function returns. +

      + +

      33.11.5 Overhead and code bloat

      + + +

      +Enabling directors for a class will generate a new director method for +every virtual method in the class' inheritance chain. This alone can +generate a lot of code bloat for large hierarchies. Method arguments +that require complex conversions to and from target language types can +result in large director methods. For this reason it is recommended that +you selectively enable directors only for specific classes that are +likely to be extended in Perl and used in C++. +

      + +

      +Compared to classes that do not use directors, the call routing in the +director methods does add some overhead. In particular, at least one +dynamic cast and one extra function call occurs per method call from +Perl. Relative to the speed of Perl execution this is probably +completely negligible. For worst case routing, a method call that +ultimately resolves in C++ may take one extra detour through Perl in +order to ensure that the method does not have an extended Perl +implementation. This could result in a noticeable overhead in some cases. +

      + +

      +Although directors make it natural to mix native C++ objects with Perl +objects (as director objects) via a common base class pointer, one +should be aware of the obvious fact that method calls to Perl objects +will be much slower than calls to C++ objects. This situation can be +optimized by selectively enabling director methods (using the %feature +directive) for only those methods that are likely to be extended in +Perl. +

      + +

      33.11.6 Typemaps

      + + +

      +Typemaps for input and output of most of the basic types from director +classes have been written. These are roughly the reverse of the usual +input and output typemaps used by the wrapper code. The typemap +operation names are 'directorin', 'directorout', and 'directorargout'. +The director code does not currently use any of the other kinds of typemaps. +It is not clear at this point which kinds are appropriate and +need to be supported. +

      + + diff --git a/Doc/Manual/Php.html b/Doc/Manual/Php.html index 78ee6ea..8c483b7 100644 --- a/Doc/Manual/Php.html +++ b/Doc/Manual/Php.html @@ -1,13 +1,13 @@ - - +SWIG and PHP + -

      32 SWIG and PHP

      +

      34 SWIG and PHP

      @@ -79,7 +80,7 @@ your extension into php directly, you will need the complete PHP source tree available.

      -

      32.1 Generating PHP Extensions

      +

      34.1 Generating PHP Extensions

      @@ -113,9 +114,7 @@ more detail in section 27.2.6.

      The usual (and recommended) way is to build the extension as a separate dynamically loaded module (which is supported by all modern operating -systems). You can then specify that this be loaded -automatically in php.ini or load it explicitly for any script which -needs it. +systems).

      @@ -126,7 +125,7 @@ and it doesn't play nicely with package system. We don't recommend this approach, or provide explicit support for it.

      -

      32.1.1 Building a loadable extension

      +

      34.1.1 Building a loadable extension

      @@ -137,42 +136,59 @@ least work for Linux though):

      -	gcc `php-config --includes` -fpic -c example_wrap.c
      -	gcc -shared example_wrap.o -o example.so
      +        gcc `php-config --includes` -fpic -c example_wrap.c example.c
      +        gcc -shared example_wrap.o example.o -o example.so
       
      -

      32.1.2 Using PHP Extensions

      +

      34.1.2 Using PHP Extensions

      -To test the extension from a PHP script, you need to load it first. You -can load it for every script by adding this line to the [PHP] section of +To test the extension from a PHP script, you first need to tell PHP to +load it. To do this, add a line like this to the [PHP] section of php.ini:

      -	extension=/path/to/modulename.so
      +        extension=/path/to/modulename.so
       

      -Alternatively, you can load it explicitly only for scripts which need it -by adding this line to the start of each such PHP script:: +If the module is in PHP's default extension directory, you can omit the path. +

      + +

      +For some SAPIs (for example, the CLI SAPI) you can instead use the +dl() function to load +an extension at run time, by adding a like like this to the start of each +PHP script which uses your extension:

      -	dl("/path/to/modulename.so");	// Load the module
      +        dl("/path/to/modulename.so"); // Load the module
       

      -SWIG also generates a php module, which -attempts to do the dl() call for you: +But note that this doesn't work when running PHP through a webserver in PHP5.3 +and later - you'll need to use extension in php.ini as +described above. +

      + +

      +The PHP module which SWIG generates will also attempt to do the dl() +call for you if the extension isn't already loaded:

      -	include("example.php");
      +        include("example.php");
       
      -

      32.2 Basic PHP interface

      +

      +This PHP module also defines the PHP classes for the wrapped API, so you'll +almost certainly want to include it anyway. +

      + +

      34.2 Basic PHP interface

      @@ -183,7 +199,7 @@ other symbols unless care is taken to %rename them. At present SWIG doesn't have support for the namespace feature added in PHP 5.3.

      -

      32.2.1 Constants

      +

      34.2.1 Constants

      @@ -220,9 +236,9 @@ echo "E = " . E . "\n";

      There's one peculiarity of how constants work in PHP which it is useful to note (this is not specific to SWIG though) - if you try to use an undeclared -constant, PHP will issue a warning and then expand the constant to a string -version of the constant's name. The warning will often be missed though as -if you're using PHP in a webserver, it will probably end up in error.log or +constant, PHP will emit a notice and then expand the constant to a string +version of the constant's name. Unfortunately it is easy to miss the notice +if you're using PHP in a webserver, as it will probably end up in error.log or similar.

      @@ -233,7 +249,7 @@ For example,
       %module example
       
      -#define EASY_TO_MISPELL	0
      +#define EASY_TO_MISPELL 0
       
      @@ -246,9 +262,9 @@ accessed incorrectly in PHP, include("example.php"); if(EASY_TO_MISPEL) { - .... + ... } else { - .... + ... } @@ -260,7 +276,7 @@ is treated as true by the if test, when the value of the intended constant would be treated as false!

      -

      32.2.2 Global Variables

      +

      34.2.2 Global Variables

      @@ -287,7 +303,7 @@ is accessed as follows:

       include("example.php");
       print seki_get();
      -seki_set( seki_get() * 2);	# The C variable is now 4.
      +seki_set( seki_get() * 2); # The C variable is now 4.
       print seki_get();
       
      @@ -309,7 +325,7 @@ undefined. At this time SWIG does not support custom accessor methods.

      -

      32.2.3 Functions

      +

      34.2.3 Functions

      @@ -332,7 +348,7 @@ Will be accessed in PHP like this : include("example.php"); $a = foo(2); $b = bar(3.5, -1.5); -$c = bar(3.5); # Use default argument for 2nd parameter +$c = bar(3.5); # Use default argument for 2nd parameter

      @@ -362,7 +378,7 @@ print $s; # The value of $s was not changed. --> -

      32.2.4 Overloading

      +

      34.2.4 Overloading

      @@ -418,7 +434,7 @@ taking the integer argument.

      --> -

      32.2.5 Pointers and References

      +

      34.2.5 Pointers and References

      @@ -503,13 +519,20 @@ echo "The sum $in1 + $in2 = $result\n"; Because PHP has a native concept of reference, it may seem more natural to the PHP developer to use references to pass pointers. To enable this, one needs to include phppointers.i which defines the -named typemap REFERENCE. +named typemap REF. +

      + +

      +Prior to SWIG 3.0, the REF typemaps relied on PHP's call-time +pass-by-reference, which was deprecated in PHP 5.3 and removed in PHP 5.4. +So if you use these REF typemaps, you should ensure that SWIG≥3.0 is +used to generate wrappers from your interface file.

      -However, this relies on call-time pass-by-reference, which has been -deprecated in PHP for some time, and was finally removed in PHP 5.4. -So you should avoid creating new wrappers which rely on this approach. +In case you write your own typemaps, SWIG supports an attribute called +byref: if you set that, then SWIG will make sure that the generated +wrapper function will want the input parameter as a reference.

      @@ -532,7 +555,7 @@ include("example.php");
       $in1 = 3;
       $in2 = 5;
       $result = 0;
      -add(&$in1,&$in2,&$result);
      +add($in1,$in2,$result);
       
       echo "The sum $in1 + $in2 = $result\n";
       ?>
      @@ -556,7 +579,7 @@ PHP in a number of ways: by using unset on an existing
       variable, or assigning NULL to a variable.
       

      -

      32.2.6 Structures and C++ classes

      +

      34.2.6 Structures and C++ classes

      @@ -576,10 +599,10 @@ This interface file class Vector { public: - double x,y,z; - Vector(); - ~Vector(); - double magnitude(); + double x,y,z; + Vector(); + ~Vector(); + double magnitude(); }; struct Complex { @@ -617,7 +640,7 @@ Would be used in the following way from PHP5: Member variables and methods are accessed using the -> operator.

      -

      32.2.6.1 Using -noproxy

      +

      34.2.6.1 Using -noproxy

      @@ -643,7 +666,7 @@ Complex_im_set($obj,$d); Complex_im_get($obj);

      -

      32.2.6.2 Constructors and Destructors

      +

      34.2.6.2 Constructors and Destructors

      @@ -684,7 +707,7 @@ the programmer can either reassign the variable or call unset($v)

      -

      32.2.6.3 Static Member Variables

      +

      34.2.6.3 Static Member Variables

      @@ -699,7 +722,7 @@ returns the current value of the class variable. For example %module example class Ko { - static int threats; + static int threats; }; @@ -727,7 +750,7 @@ Ko::threats(10); echo "There have now been " . Ko::threats() . " threats\n"; -

      32.2.6.4 Static Member Functions

      +

      34.2.6.4 Static Member Functions

      @@ -749,7 +772,25 @@ Ko::threats(); -

      32.2.7 PHP Pragmas, Startup and Shutdown code

      +

      34.2.6.5 Specifying Implemented Interfaces

      + + +

      +PHP supports the concept of abstract interfaces which a class can implement. +Since SWIG 3.0.3, you can tell SWIG that a wrapped class (for example +MyIterator) implements the Iterator interface like +so: +

      + +
      +%typemap("phpinterfaces") MyIterator "Iterator";
      +
      + +

      +If there are multiple interfaces, just list them separated by commas. +

      + +

      34.2.7 PHP Pragmas, Startup and Shutdown code

      @@ -837,7 +878,7 @@ The %rinit and %rshutdown statements are very similar but inse into the request init (PHP_RINIT_FUNCTION) and request shutdown (PHP_RSHUTDOWN_FUNCTION) code respectively.

      -

      32.3 Cross language polymorphism

      +

      34.3 Cross language polymorphism

      @@ -872,7 +913,7 @@ wrapper functions takes care of all the cross-language method routing transparently.

      -

      32.3.1 Enabling directors

      +

      34.3.1 Enabling directors

      @@ -961,7 +1002,7 @@ class MyFoo extends Foo { -

      32.3.2 Director classes

      +

      34.3.2 Director classes

      @@ -1041,7 +1082,7 @@ so there is no need for the extra overhead involved with routing the calls through PHP.

      -

      32.3.3 Ownership and object destruction

      +

      34.3.3 Ownership and object destruction

      @@ -1097,7 +1138,7 @@ In this example, we are assuming that FooContainer will take care of deleting all the Foo pointers it contains at some point.

      -

      32.3.4 Exception unrolling

      +

      34.3.4 Exception unrolling

      @@ -1156,7 +1197,7 @@ Swig::DirectorMethodException is thrown, PHP will register the exception as soon as the C wrapper function returns.

      -

      32.3.5 Overhead and code bloat

      +

      34.3.5 Overhead and code bloat

      @@ -1189,7 +1230,7 @@ optimized by selectively enabling director methods (using the %feature directive) for only those methods that are likely to be extended in PHP.

      -

      32.3.6 Typemaps

      +

      34.3.6 Typemaps

      @@ -1203,7 +1244,7 @@ need to be supported.

      -

      32.3.7 Miscellaneous

      +

      34.3.7 Miscellaneous

      Director typemaps for STL classes are mostly in place, and hence you diff --git a/Doc/Manual/Pike.html b/Doc/Manual/Pike.html index 8c1eb2d..22ab4e2 100644 --- a/Doc/Manual/Pike.html +++ b/Doc/Manual/Pike.html @@ -1,12 +1,13 @@ - + SWIG and Pike + -

      33 SWIG and Pike

      +

      35 SWIG and Pike

        @@ -46,10 +47,10 @@ least, make sure you read the "SWIG Basics" chapter.

        -

        33.1 Preliminaries

        +

        35.1 Preliminaries

        -

        33.1.1 Running SWIG

        +

        35.1.1 Running SWIG

        @@ -94,7 +95,7 @@ can use the -o option:

        $ swig -pike -o pseudonym.c example.i
        -

        33.1.2 Getting the right header files

        +

        35.1.2 Getting the right header files

        @@ -114,7 +115,7 @@ You're looking for files with the names global.h, program.h and so on.

        -

        33.1.3 Using your module

        +

        35.1.3 Using your module

        @@ -129,10 +130,10 @@ Pike v7.4 release 10 running Hilfe v3.5 (Incremental Pike Frontend) (1) Result: 24

      -

      33.2 Basic C/C++ Mapping

      +

      35.2 Basic C/C++ Mapping

      -

      33.2.1 Modules

      +

      35.2.1 Modules

      @@ -143,7 +144,7 @@ concerned), SWIG's %module directive doesn't really have any significance.

      -

      33.2.2 Functions

      +

      35.2.2 Functions

      @@ -168,7 +169,7 @@ exactly as you'd expect it to: (1) Result: 24 -

      33.2.3 Global variables

      +

      35.2.3 Global variables

      @@ -197,7 +198,7 @@ will result in two functions, Foo_get() and Foo_set(): (3) Result: 3.141590 -

      33.2.4 Constants and enumerated types

      +

      35.2.4 Constants and enumerated types

      @@ -205,7 +206,7 @@ Enumerated types in C/C++ declarations are wrapped as Pike constants, not as Pike enums.

      -

      33.2.5 Constructors and Destructors

      +

      35.2.5 Constructors and Destructors

      @@ -213,7 +214,7 @@ Constructors are wrapped as create() methods, and destructors are wrapped as destroy() methods, for Pike classes.

      -

      33.2.6 Static Members

      +

      35.2.6 Static Members

      diff --git a/Doc/Manual/Preface.html b/Doc/Manual/Preface.html index d17dc22..3b654a6 100644 --- a/Doc/Manual/Preface.html +++ b/Doc/Manual/Preface.html @@ -1,12 +1,13 @@ - + Preface + -

      1 Preface

      +

      1 Preface

        @@ -35,7 +36,7 @@ -

        1.1 Introduction

        +

        1.1 Introduction

        @@ -58,7 +59,7 @@ has since evolved into a general purpose tool that is used in a wide variety of applications--in fact almost anything where C/C++ programming is involved. -

        1.2 SWIG Versions

        +

        1.2 SWIG Versions

        @@ -70,7 +71,7 @@ An official stable version was released along with the decision to make SWIG license changes and this gave rise to version 2.0.0 in 2010.

        -

        1.3 SWIG License

        +

        1.3 SWIG License

        @@ -86,7 +87,7 @@ under license terms of the user's choice/requirements and at the same time the S source was placed under the GNU General Public License version 3.

        -

        1.4 SWIG resources

        +

        1.4 SWIG resources

        @@ -126,7 +127,7 @@ about this can be obtained at: -

        1.5 Prerequisites

        +

        1.5 Prerequisites

        @@ -151,7 +152,7 @@ However, this isn't meant to be a tutorial on C++ programming. For many of the gory details, you will almost certainly want to consult a good C++ reference. If you don't program in C++, you may just want to skip those parts of the manual. -

        1.6 Organization of this manual

        +

        1.6 Organization of this manual

        @@ -163,7 +164,7 @@ can probably skip to that chapter and find almost everything you need to know.

        -

        1.7 How to avoid reading the manual

        +

        1.7 How to avoid reading the manual

        @@ -175,7 +176,7 @@ The SWIG distribution also comes with a large directory of examples that illustrate different topics.

        -

        1.8 Backwards compatibility

        +

        1.8 Backwards compatibility

        @@ -211,7 +212,7 @@ Note: The version symbol is not defined in the generated SWIG wrapper file. The SWIG preprocessor has defined SWIG_VERSION since SWIG-1.3.11.

        -

        1.9 Release notes

        +

        1.9 Release notes

        @@ -220,7 +221,7 @@ contain, respectively, detailed release notes for the current version, detailed release notes for previous releases and summary release notes from SWIG-1.3.22 onwards.

        -

        1.10 Credits

        +

        1.10 Credits

        @@ -233,7 +234,7 @@ who have made contributions at all levels over time. Contributors are mentioned either in the COPYRIGHT file or CHANGES files shipped with SWIG or in submitted bugs.

        -

        1.11 Bug reports

        +

        1.11 Bug reports

        @@ -248,24 +249,31 @@ used, and any important pieces of the SWIG generated wrapper code. We can only fix bugs if we know about them.

        -

        1.12 Installation

        +

        1.12 Installation

        -

        1.12.1 Windows installation

        +

        1.12.1 Windows installation

        -Please see the dedicated Windows chapter for instructions on installing +Please see the dedicated Windows chapter for instructions on installing SWIG on Windows and running the examples. The Windows distribution is called swigwin and includes a prebuilt SWIG executable, swig.exe, included in the top level directory. Otherwise it is exactly the same as the main SWIG distribution. There is no need to download anything else.

        -

        1.12.2 Unix installation

        +

        1.12.2 Unix installation

        +These installation instructions are for using the distributed tarball, +for example, swig-3.0.8.tar.gz. +If you wish to build and install from source on Github, extra steps are required. +Please see the Bleeding Edge page on the SWIG website. +

        + +

        You must use GNU make to build and install SWIG.

        @@ -332,7 +340,7 @@ be configured with a subset of target languages. SWIG used to include a set of runtime libraries for some languages for working with multiple modules. These are no longer built during the installation stage. However, users can build them just like any wrapper module as described in -the Modules chapter. +the Modules chapter. The CHANGES file shipped with SWIG in the top level directory also lists some examples which build the runtime library.

        @@ -350,7 +358,7 @@ a number of packages to be installed. Full instructions at
      -

      1.12.3 Macintosh OS X installation

      +

      1.12.3 Macintosh OS X installation

      @@ -370,7 +378,7 @@ installation of software you might have. However, this is generally not the rec technique for building larger extension modules. Instead, you should utilize Darwin's two-level namespaces. Some details about this can be found here -http://developer.apple.com/documentation/ReleaseNotes/DeveloperTools/TwoLevelNamespaces.html. +Understanding Two-Level Namespaces.

      @@ -378,7 +386,7 @@ Darwin's two-level namespaces. Some details about this can be found here Needless to say, you might have to experiment a bit to get things working at first.

      -

      1.12.4 Testing

      +

      1.12.4 Testing

      @@ -432,7 +440,7 @@ have many different target languages installed and a slow machine, it might take more than an hour to run the test-suite.

      -

      1.12.5 Examples

      +

      1.12.5 Examples

      diff --git a/Doc/Manual/Preprocessor.html b/Doc/Manual/Preprocessor.html index 8fcbe92..2538f8f 100644 --- a/Doc/Manual/Preprocessor.html +++ b/Doc/Manual/Preprocessor.html @@ -1,12 +1,13 @@ - + SWIG Preprocessor + -

      7 Preprocessing

      +

      8 Preprocessing

        @@ -37,7 +38,7 @@ However, a number of modifications and enhancements have been made. This chapter describes some of these modifications.

        -

        7.1 File inclusion

        +

        8.1 File inclusion

        @@ -63,7 +64,7 @@ By default, the #include is ignored unless you run SWIG with the is that you often don't want SWIG to try and wrap everything included in standard header system headers and auxiliary files. -

        7.2 File imports

        +

        8.2 File imports

        @@ -92,7 +93,7 @@ The -importall directive tells SWIG to follow all #include sta as imports. This might be useful if you want to extract type definitions from system header files without generating any wrappers. -

        7.3 Conditional Compilation

        +

        8.3 Conditional Compilation

        @@ -115,9 +116,12 @@ SWIGCLISP Defined when using CLISP SWIGCSHARP Defined when using C# SWIGGUILE Defined when using Guile SWIGJAVA Defined when using Java +SWIGJAVASCRIPT Defined when using Javascript +SWIG_JAVASCRIPT_JSC Defined when using Javascript for JavascriptCore +SWIG_JAVASCRIPT_V8 Defined when using Javascript for v8 or node.js SWIGLUA Defined when using Lua SWIGMODULA3 Defined when using Modula-3 -SWIGMZSCHEME Defined when using Mzscheme +SWIGMZSCHEME Defined when using Mzscheme SWIGOCAML Defined when using Ocaml SWIGOCTAVE Defined when using Octave SWIGPERL Defined when using Perl @@ -126,6 +130,7 @@ SWIGPIKE Defined when using Pike SWIGPYTHON Defined when using Python SWIGR Defined when using R SWIGRUBY Defined when using Ruby +SWIGSCILAB Defined when using Scilab SWIGSEXP Defined when using S-expressions SWIGTCL Defined when using Tcl SWIGXML Defined when using XML @@ -152,7 +157,7 @@ SWIG (except for the symbol `SWIG' which is only defined within the SWIG compiler).

        -

        7.4 Macro Expansion

        +

        8.4 Macro Expansion

        @@ -207,7 +212,7 @@ like #x. This is a non-standard SWIG extension.

      -

      7.5 SWIG Macros

      +

      8.5 SWIG Macros

      @@ -253,7 +258,7 @@ many of SWIG's advanced features and libraries are built using this mechanism (s support).

      -

      7.6 C99 and GNU Extensions

      +

      8.6 C99 and GNU Extensions

      @@ -309,14 +314,14 @@ interface building. However, they are used internally to implement a number of SWIG directives and are provided to make SWIG more compatible with C99 code.

      -

      7.7 Preprocessing and delimiters

      +

      8.7 Preprocessing and delimiters

      The preprocessor handles { }, " " and %{ %} delimiters differently.

      -

      7.7.1 Preprocessing and %{ ... %} & " ... " delimiters

      +

      8.7.1 Preprocessing and %{ ... %} & " ... " delimiters

      @@ -341,7 +346,7 @@ the contents of the %{ ... %} block are copied without modification to the output (including all preprocessor directives).

      -

      7.7.2 Preprocessing and { ... } delimiters

      +

      8.7.2 Preprocessing and { ... } delimiters

      @@ -383,7 +388,7 @@ to actually go into the wrapper file, prefix the preprocessor directives with % and leave the preprocessor directive in the code.

      -

      7.8 Preprocessor and Typemaps

      +

      8.8 Preprocessor and Typemaps

      @@ -454,7 +459,7 @@ would generate

      -

      7.9 Viewing preprocessor output

      +

      8.9 Viewing preprocessor output

      @@ -464,7 +469,7 @@ Instead the results after the preprocessor has run are displayed. This might be useful as an aid to debugging and viewing the results of macro expansions.

      -

      7.10 The #error and #warning directives

      +

      8.10 The #error and #warning directives

      diff --git a/Doc/Manual/Python.html b/Doc/Manual/Python.html index 6a22738..ce7f9fe 100644 --- a/Doc/Manual/Python.html +++ b/Doc/Manual/Python.html @@ -1,12 +1,13 @@ - + SWIG and Python + -

      34 SWIG and Python

      +

      36 SWIG and Python

      @@ -135,7 +157,7 @@ very least, make sure you read the "SWIG Basics" chapter.

      -

      34.1 Overview

      +

      36.1 Overview

      @@ -162,10 +184,10 @@ described followed by a discussion of low-level implementation details.

      -

      34.2 Preliminaries

      +

      36.2 Preliminaries

      -

      34.2.1 Running SWIG

      +

      36.2.1 Running SWIG

      @@ -187,7 +209,7 @@ int fact(int n);

      -The #define SWIG_FILE_WITH_INIT line inserts a macro that specifies that the +The #define SWIG_FILE_WITH_INIT line inserts a macro that specifies that the resulting C file should be built as a python extension, inserting the module init code. This .i file wraps the following simple C file:

      @@ -263,13 +285,13 @@ The following sections have further practical examples and details on how you might go about compiling and using the generated files.

      -

      34.2.2 Using distutils

      +

      36.2.2 Using distutils

      The preferred approach to building an extension module for python is to compile it with distutils, which comes with all recent versions of python -(Distutils Docs). +(Distutils Docs).

      @@ -355,7 +377,7 @@ This same approach works on all platforms if the appropriate compiler is install can even build extensions to the standard Windows Python using MingGW)

      -

      34.2.3 Hand compiling a dynamic module

      +

      36.2.3 Hand compiling a dynamic module

      @@ -388,7 +410,7 @@ of the module prefixed by an underscore. If the name of your module is "_example.so" or "_examplemodule.so". The name of the module is specified using the %module directive or the - -module command line option. +-module command line option.

      @@ -403,7 +425,7 @@ module actually consists of two files; socket.py and

      -

      34.2.4 Static linking

      +

      36.2.4 Static linking

      @@ -448,14 +470,14 @@ you simply do something like this:

      -$ swig -python example.i
      +$ swig -python -lembed.i example.i
       $ gcc example.c example_wrap.c \
               -Xlinker -export-dynamic \
      -        -DHAVE_CONFIG_H -I/usr/local/include/python2.1 \
      -	-I/usr/local/lib/python2.1/config \
      -	-L/usr/local/lib/python2.1/config -lpython2.1 -lm -ldl \
      -	-o mypython
      -
      +        -DHAVE_CONFIG_H -I/usr/include/python2.7 \
      +        -I/usr/lib/python2.7/config-x86_64-linux-gnu \
      +        -I/usr/lib/python2.7/config \
      +        -L/usr/lib/python2.7/config -lpython2.7 -lm -ldl \
      +        -o mypython
       

      You will need to supply the same libraries that were used to build Python the first @@ -476,13 +498,13 @@ hassle in the opinion of this author).

      Compatibility note: The embed.i library file is -deprecated and has not been maintained for several years. Even though it -appears to "work" with Python 2.1, no future support is guaranteed. +deprecated and has not been actively maintained for many years. Even though it +appears to "work" with Python 2.7, no future support is guaranteed. If using static linking, you might want to rely on a different approach (perhaps using distutils).

      -

      34.2.5 Using your module

      +

      36.2.5 Using your module

      @@ -639,7 +661,7 @@ system configuration (this requires root access and you will need to read the man pages).

      -

      34.2.6 Compilation of C++ extensions

      +

      36.2.6 Compilation of C++ extensions

      @@ -731,7 +753,7 @@ erratic program behavior. If working with lots of software components, you might want to investigate using a more formal standard such as COM.

      -

      34.2.7 Compiling for 64-bit platforms

      +

      36.2.7 Compiling for 64-bit platforms

      @@ -768,7 +790,7 @@ and -m64 allow you to choose the desired binary format for your python extension.

      -

      34.2.8 Building Python Extensions under Windows

      +

      36.2.8 Building Python Extensions under Windows

      @@ -776,8 +798,8 @@ Building a SWIG extension to Python under Windows is roughly similar to the process used with Unix. Using the distutils, it is essentially identical. If you have the same version of the MS compiler that Python was built with (the python2.4 and python2.5 distributed by python.org -are built with Visual Studio 2003), the standard python setup.py -build should just work. +are built with Visual Studio 2003), the standard python setup.py +build should just work.

      @@ -897,7 +919,7 @@ SWIG Wiki.

      -

      34.3 A tour of basic C/C++ wrapping

      +

      36.3 A tour of basic C/C++ wrapping

      @@ -906,7 +928,7 @@ to your C/C++ code. Functions are wrapped as functions, classes are wrapped as This section briefly covers the essential aspects of this wrapping.

      -

      34.3.1 Modules

      +

      36.3.1 Modules

      @@ -919,7 +941,7 @@ module name, make sure you don't use the same name as a built-in Python command or standard module name.

      -

      34.3.2 Functions

      +

      36.3.2 Functions

      @@ -943,7 +965,7 @@ like you think it does: >>> -

      34.3.3 Global variables

      +

      36.3.3 Global variables

      @@ -1081,7 +1103,7 @@ that starts with a leading underscore. SWIG does not create cvar if there are no global variables in a module.

      -

      34.3.4 Constants and enums

      +

      36.3.4 Constants and enums

      @@ -1121,7 +1143,7 @@ other object. Unfortunately, there is no easy way for SWIG to generate code that prevents this. You will just have to be careful.

      -

      34.3.5 Pointers

      +

      36.3.5 Pointers

      @@ -1147,7 +1169,7 @@ When wrapped, you will be able to use the functions in a natural way from Python

       >>> import example
      ->>> f = example.fopen("junk","w")
      +>>> f = example.fopen("junk", "w")
       >>> example.fputs("Hello World\n", f)
       >>> example.fclose(f)
       
      @@ -1262,7 +1284,7 @@ C-style cast may return a bogus result whereas as the C++-style cast will return None if the conversion can't be performed.

      -

      34.3.6 Structures

      +

      36.3.6 Structures

      @@ -1272,7 +1294,7 @@ a very natural interface. For example,

       struct Vector {
      -	double x,y,z;
      +  double x,y,z;
       };
       
       
      @@ -1451,7 +1473,7 @@ everything works just like you would expect. For example:
      -

      34.3.7 C++ classes

      +

      36.3.7 C++ classes

      @@ -1540,7 +1562,7 @@ they are accessed through cvar like this: -

      34.3.8 C++ inheritance

      +

      36.3.8 C++ inheritance

      @@ -1595,7 +1617,7 @@ then the function spam() accepts Foo * or a pointer to any cla It is safe to use multiple inheritance with SWIG.

      -

      34.3.9 Pointers, references, values, and arrays

      +

      36.3.9 Pointers, references, values, and arrays

      @@ -1656,7 +1678,7 @@ treated as a returning value, and it will follow the same allocation/deallocation process.

      -

      34.3.10 C++ overloaded functions

      +

      36.3.10 C++ overloaded functions

      @@ -1779,7 +1801,7 @@ first declaration takes precedence. Please refer to the "SWIG and C++" chapter for more information about overloading.

      -

      34.3.11 C++ operators

      +

      36.3.11 C++ operators

      @@ -1868,7 +1890,7 @@ Also, be aware that certain operators don't map cleanly to Python. For instance overloaded assignment operators don't map to Python semantics and will be ignored.

      -

      34.3.12 C++ namespaces

      +

      36.3.12 C++ namespaces

      @@ -1935,7 +1957,7 @@ utilizes thousands of small deeply nested namespaces each with identical symbol names, well, then you get what you deserve.

      -

      34.3.13 C++ templates

      +

      36.3.13 C++ templates

      @@ -1989,7 +2011,21 @@ Some more complicated examples will appear later.

      -

      34.3.14 C++ Smart Pointers

      +

      36.3.14 C++ Smart Pointers

      + + +

      36.3.14.1 The shared_ptr Smart Pointer

      + + +

      +The C++11 standard provides std::shared_ptr which was derived from the Boost +implementation, boost::shared_ptr. +Both of these are available for Python in the SWIG library and usage is outlined +in the shared_ptr smart pointer library section. +

      + + +

      36.3.14.2 Generic Smart Pointers

      @@ -2073,7 +2109,7 @@ simply use the __deref__() method. For example: -

      34.3.15 C++ reference counted objects

      +

      36.3.15 C++ reference counted objects

      @@ -2082,7 +2118,7 @@ Python examples of memory management using referencing counting.

      -

      34.4 Further details on the Python class interface

      +

      36.4 Further details on the Python class interface

      @@ -2105,7 +2141,7 @@ the -builtin option are in the Built-in section.

      -

      34.4.1 Proxy classes

      +

      36.4.1 Proxy classes

      @@ -2162,15 +2198,15 @@ for Python 2.2): import _example class Foo(object): - def __init__(self): - self.this = _example.new_Foo() - self.thisown = 1 - def __del__(self): - if self.thisown: - _example.delete_Foo(self.this) - def spam(self,arg1): - return _example.Foo_spam(self.this,arg1) - x = property(_example.Foo_x_get, _example.Foo_x_set) + def __init__(self): + self.this = _example.new_Foo() + self.thisown = 1 + def __del__(self): + if self.thisown: + _example.delete_Foo(self.this) + def spam(self,arg1): + return _example.Foo_spam(self.this,arg1) + x = property(_example.Foo_x_get, _example.Foo_x_set) @@ -2194,7 +2230,7 @@ you can attach new Python methods to the class and you can even inherit from it by Python built-in types until Python 2.2).

      -

      34.4.2 Built-in Types

      +

      36.4.2 Built-in Types

      @@ -2212,9 +2248,9 @@ like in a proxy class:

       class Foo(object):
      -     def __init__(self):
      -         self.this = _example.new_Foo()
      -         self.thisown = 1
      +    def __init__(self):
      +        self.this = _example.new_Foo()
      +        self.thisown = 1
       
      @@ -2238,7 +2274,7 @@ please refer to the python documentation:

      http://docs.python.org/extending/newtypes.html

      -

      34.4.2.1 Limitations

      +

      36.4.2.1 Limitations

      Use of the -builtin option implies a couple of limitations: @@ -2306,11 +2342,11 @@ private:

      -class MyPyException (Exception) :
      -    def __init__(self, msg, *args) :
      +class MyPyException(Exception):
      +    def __init__(self, msg, *args):
               Exception.__init__(self, *args)
               self.myexc = MyException(msg)
      -    def what (self) :
      +    def what(self):
               return self.myexc.what()
       
      @@ -2406,7 +2442,7 @@ assert(issubclass(B.Derived, A.Base)) -

      34.4.2.2 Operator overloads -- use them!

      +

      36.4.2.2 Operator overloads -- use them!

      The entire justification for the -builtin option is improved @@ -2507,7 +2543,7 @@ structs.

      -

      34.4.3 Memory management

      +

      36.4.3 Memory management

      NOTE: Although this section refers to proxy objects, everything here also applies @@ -2702,7 +2738,7 @@ It is also possible to deal with situations like this using typemaps--an advanced topic discussed later.

      -

      34.4.4 Python 2.2 and classic classes

      +

      36.4.4 Python 2.2 and classic classes

      @@ -2712,7 +2748,7 @@ in Python-2.2, an entirely new type of class system was introduced. This new-style class system offers many enhancements including static member functions, properties (managed attributes), and class methods. Details about all of these changes can be found on www.python.org and is not repeated here. +href="https://www.python.org">www.python.org and is not repeated here.

      @@ -2727,7 +2763,7 @@ old-style classes are used instead.

      This dual-nature of the wrapper code means that you can create extension modules with SWIG and those modules will work with all versions of Python -ranging from Python-1.4 to the very latest release. Moreover, the wrappers take +ranging from Python-2.0 to the very latest release. Moreover, the wrappers take advantage of Python-2.2 features when available.

      @@ -2739,7 +2775,7 @@ class itself. In Python-2.1 and earlier, they have to be accessed as a global function or through an instance (see the earlier section).

      -

      34.5 Cross language polymorphism

      +

      36.5 Cross language polymorphism

      @@ -2773,7 +2809,7 @@ proxy classes, director classes, and C wrapper functions takes care of all the cross-language method routing transparently.

      -

      34.5.1 Enabling directors

      +

      36.5.1 Enabling directors

      @@ -2834,6 +2870,7 @@ the methods one() and two() (but not three()): class Foo { public: Foo(int foo); + virtual ~Foo(); virtual void one(); virtual void two(); }; @@ -2854,16 +2891,17 @@ then at the python side you can define import mymodule class MyFoo(mymodule.Foo): - def __init__(self, foo): - mymodule.Foo(self, foo) + def __init__(self, foo): + mymodule.Foo.__init__(self, foo) +# super().__init__(foo) # Alternative construction for Python3 - def one(self): - print "one from python" + def one(self): + print "one from python" -

      34.5.2 Director classes

      +

      36.5.2 Director classes

      @@ -2945,7 +2983,7 @@ so there is no need for the extra overhead involved with routing the calls through Python.

      -

      34.5.3 Ownership and object destruction

      +

      36.5.3 Ownership and object destruction

      @@ -3012,7 +3050,7 @@ deleting all the Foo pointers it contains at some point. Note that no hard references to the Foo objects remain in Python.

      -

      34.5.4 Exception unrolling

      +

      36.5.4 Exception unrolling

      @@ -3071,7 +3109,7 @@ Swig::DirectorMethodException is thrown, Python will register the exception as soon as the C wrapper function returns.

      -

      34.5.5 Overhead and code bloat

      +

      36.5.5 Overhead and code bloat

      @@ -3105,7 +3143,7 @@ directive) for only those methods that are likely to be extended in Python.

      -

      34.5.6 Typemaps

      +

      36.5.6 Typemaps

      @@ -3119,7 +3157,7 @@ need to be supported.

      -

      34.5.7 Miscellaneous

      +

      36.5.7 Miscellaneous

      @@ -3166,7 +3204,7 @@ methods that return const references.

      -

      34.6 Common customization features

      +

      36.6 Common customization features

      @@ -3179,7 +3217,7 @@ This section describes some common SWIG features that are used to improve your the interface to an extension module.

      -

      34.6.1 C/C++ helper functions

      +

      36.6.1 C/C++ helper functions

      @@ -3260,7 +3298,7 @@ hard to implement. It is possible to clean this up using Python code, typemaps, customization features as covered in later sections.

      -

      34.6.2 Adding additional Python code

      +

      36.6.2 Adding additional Python code

      @@ -3361,6 +3399,30 @@ print("Loading", "Whizz", "Bang", sep=' ... ') +

      When using %pythoncode and %pythonbegin you generally +want to make sure that the block is delimited by %{ and %}. +If you delimit it with { and } then any lines with a +leading # will be handled by SWIG as preprocessor directives, when +you probably meant them as Python comments. Prior to SWIG 3.0.3, invalid +preprocessor directives were silently ignored, so generally using the wrong +delimiters resulted in such comments not appearing in the generated output +(though a comment starting with a valid preprocessor directive could cause +problems, for example: # error handling). SWIG 3.0.3 and later report +an error for invalid preprocessor directives, so you may have to update +existing interface files to delimit blocks of Python code correctly.

      + +

      As an alternative to providing a block containing Python code, you can +include python code from a file. The code is inserted exactly as in the +file, so this avoids any issues with the SWIG preprocessor. It's a good +approach if you have a non-trivial chunk of Python code to insert. To +use this feature you specify a filename in double quotes, for example:

      + +
      +
      +%pythoncode "somecode.py"
      +
      +
      +

      Sometimes you may want to replace or modify the wrapper function that SWIG creates in the proxy .py file. The Python module in SWIG provides some features that enable you to do this. First, to @@ -3383,7 +3445,7 @@ def bar(*args): class Foo { public: int bar(int x); -} +}; @@ -3420,7 +3482,7 @@ proxy, just before the return statement. class Foo { public: int bar(int x); -} +}; @@ -3449,7 +3511,7 @@ SWIG version 1.3.28 you can use the directive forms class Foo { public: int bar(int x); -} +}; @@ -3479,7 +3541,7 @@ class Foo { public: int bar(int x); int bar(); -} +}; @@ -3488,7 +3550,7 @@ The same applies for overloaded constructors.

      -

      34.6.3 Class extension with %extend

      +

      36.6.3 Class extension with %extend

      @@ -3577,7 +3639,7 @@ Vector(12,14,16) in any way---the extensions only show up in the Python interface.

      -

      34.6.4 Exception handling with %exception

      +

      36.6.4 Exception handling with %exception

      @@ -3703,7 +3765,7 @@ The language-independent exception.i library file can also be used to raise exceptions. See the SWIG Library chapter.

      -

      34.7 Tips and techniques

      +

      36.7 Tips and techniques

      @@ -3713,7 +3775,7 @@ strings, binary data, and arrays. This chapter discusses the common techniques solving these problems.

      -

      34.7.1 Input and output parameters

      +

      36.7.1 Input and output parameters

      @@ -3926,7 +3988,7 @@ void foo(Bar *OUTPUT); may not have the intended effect since typemaps.i does not define an OUTPUT rule for Bar.

      -

      34.7.2 Simple pointers

      +

      36.7.2 Simple pointers

      @@ -3995,7 +4057,7 @@ If you replace %pointer_functions() by %pointer_class(type,name)SWIG Library chapter for further details.

      -

      34.7.3 Unbounded C Arrays

      +

      36.7.3 Unbounded C Arrays

      @@ -4057,7 +4119,7 @@ well suited for applications in which you need to create buffers, package binary data, etc.

      -

      34.7.4 String handling

      +

      36.7.4 String handling

      @@ -4126,7 +4188,107 @@ If you need to return binary data, you might use the also be used to extra binary data from arbitrary pointers.

      -

      34.8 Typemaps

      + +

      36.7.5 Default arguments

      + + +

      +C++ default argument code generation is documented in the main +Default arguments section. +There is also an optional Python specific feature that can be used called the python:cdefaultargs +feature flag. +By default, SWIG attempts to convert C++ default argument values +into Python values and generates code into the Python layer containing these values. +For example: +

      + +
      +
      +struct CDA {
      +  int fff(int a = 1, bool b = false);
      +};
      +
      +
      + +

      +From Python this can be called as follows: +

      + +
      +
      +>>> CDA().fff()        # C++ layer receives a=1 and b=false
      +>>> CDA().fff(2)       # C++ layer receives a=2 and b=false
      +>>> CDA().fff(3, True) # C++ layer receives a=3 and b=true
      +
      +
      + +

      +The default code generation in the Python layer is: +

      + +
      +
      +class CDA(object):
      +    ...
      +    def fff(self, a=1, b=False):
      +        return _default_args.CDA_fff(self, a, b)
      +
      +
      + +

      +Adding the feature: +

      + +
      +
      +%feature("python:cdefaultargs") CDA::fff;
      +struct CDA {
      +  int fff(int a = 1, bool b = false);
      +
      +
      + +

      +results in identical behaviour when called from Python, however, it results in different code generation: +

      + +
      +
      +class CDA(object):
      +    ...
      +    def fff(self, *args):
      +        return _default_args.CDA_fff(self, *args)
      +
      +
      + +

      +The default arguments are obtained in the C++ wrapper layer instead of the Python layer. +Some code generation modes are quite different, eg -builtin and -fastproxy, +and are unaffected by python:cdefaultargs as the default values are always obtained from the C++ layer. +

      + +

      +Note that not all default arguments can be converted into a Python equivalent. +When SWIG does not convert them, it will generate code to obtain them from the C++ layer as if +python:cdefaultargs was specified. +This will happen if just one argument cannot be converted into a Python equivalent. +This occurs typically when the argument is not fully numeric, such as int(1): +

      + +
      +
      +struct CDA {
      +  int fff(int a = int(1), bool b = false);
      +};
      +
      +
      + +

      +Compatibility Note: SWIG-3.0.6 introduced the python:cdefaultargs feature. +Versions of SWIG prior to this varied in their ability to convert C++ default values into +equivalent Python default argument values. +

      + +

      36.8 Typemaps

      @@ -4143,7 +4305,7 @@ Typemaps are only used if you want to change some aspect of the primitive C-Python interface or if you want to elevate your guru status.

      -

      34.8.1 What is a typemap?

      +

      36.8.1 What is a typemap?

      @@ -4156,8 +4318,8 @@ you might define a typemap like this: %module example %typemap(in) int { - $1 = (int) PyLong_AsLong($input); - printf("Received an integer : %d\n",$1); + $1 = (int) PyLong_AsLong($input); + printf("Received an integer : %d\n",$1); } %inline %{ extern int fact(int n); @@ -4194,11 +4356,11 @@ You can refine this by supplying an optional parameter name. For example: %module example %typemap(in) int nonnegative { - $1 = (int) PyLong_AsLong($input); - if ($1 < 0) { - PyErr_SetString(PyExc_ValueError,"Expected a nonnegative value."); - return NULL; - } + $1 = (int) PyLong_AsLong($input); + if ($1 < 0) { + PyErr_SetString(PyExc_ValueError,"Expected a nonnegative value."); + return NULL; + } } %inline %{ extern int fact(int nonnegative); @@ -4220,8 +4382,8 @@ the typemap system follows typedef declarations. For example:

       %typemap(in) int n {
      -	$1 = (int) PyLong_AsLong($input);
      -	printf("n = %d\n",$1);
      +  $1 = (int) PyLong_AsLong($input);
      +  printf("n = %d\n",$1);
       }
       %inline %{
       typedef int Integer;
      @@ -4259,7 +4421,7 @@ parameter is omitted):
       
      -

      34.8.2 Python typemaps

      +

      36.8.2 Python typemaps

      @@ -4300,7 +4462,7 @@ a look at the SWIG library version 1.3.20 or so.

      -

      34.8.3 Typemap variables

      +

      36.8.3 Typemap variables

      @@ -4371,7 +4533,7 @@ properly assigned. The Python name of the wrapper function being created. -

      34.8.4 Useful Python Functions

      +

      36.8.4 Useful Python Functions

      @@ -4499,7 +4661,7 @@ write me -

      34.9 Typemap Examples

      +

      36.9 Typemap Examples

      @@ -4508,7 +4670,7 @@ might look at the files "python.swg" and "typemaps.i" in the SWIG library.

      -

      34.9.1 Converting Python list to a char **

      +

      36.9.1 Converting Python list to a char **

      @@ -4531,11 +4693,11 @@ object to be used as a char ** object. for (i = 0; i < size; i++) { PyObject *o = PyList_GetItem($input,i); if (PyString_Check(o)) - $1[i] = PyString_AsString(PyList_GetItem($input,i)); + $1[i] = PyString_AsString(PyList_GetItem($input,i)); else { - PyErr_SetString(PyExc_TypeError,"list must contain strings"); - free($1); - return NULL; + PyErr_SetString(PyExc_TypeError,"list must contain strings"); + free($1); + return NULL; } } $1[i] = 0; @@ -4571,7 +4733,7 @@ follows :

       >>> from argv import *
      ->>> print_args(["Dave","Mike","Mary","Jane","John"])
      +>>> print_args(["Dave", "Mike", "Mary", "Jane", "John"])
       argv[0] = Dave
       argv[1] = Mike
       argv[2] = Mary
      @@ -4588,7 +4750,7 @@ memory allocation is used to allocate memory for the array, the
       the C function. 
       

      -

      34.9.2 Expanding a Python object into multiple arguments

      +

      36.9.2 Expanding a Python object into multiple arguments

      @@ -4609,7 +4771,7 @@ allows the function to be used from Python as follows:

      ->>> foo(4, ["foo","bar","spam","1"])
      +>>> foo(4, ["foo", "bar", "spam", "1"])
       
      @@ -4630,11 +4792,11 @@ previous example: for (i = 0; i < $1; i++) { PyObject *o = PyList_GetItem($input,i); if (PyString_Check(o)) - $2[i] = PyString_AsString(PyList_GetItem($input,i)); + $2[i] = PyString_AsString(PyList_GetItem($input,i)); else { - PyErr_SetString(PyExc_TypeError,"list must contain strings"); - free($2); - return NULL; + PyErr_SetString(PyExc_TypeError,"list must contain strings"); + free($2); + return NULL; } } $2[i] = 0; @@ -4663,11 +4825,51 @@ to supply the argument count. This is automatically set by the typemap code. F
      ->>> foo(["foo","bar","spam","1"])
      +>>> foo(["foo", "bar", "spam", "1"])
      +
      +
      + +

      +If your function is overloaded in C++, for example: +

      + +
      +
      +int foo(int argc, char **argv);
      +int foo();
      +
      +
      + +

      +don't forget to also provide a suitable typecheck typemap for overloading +such as: +

      + +
      +
      +%typecheck(SWIG_TYPECHECK_STRING_ARRAY) (int argc, char **argv) {
      +  $1 = PyList_Check($input) ? 1 : 0;
      +}
      +
      +
      + +

      +If you don't you'll get an error message along the lines of: +

      + +
      +
      +Traceback (most recent call last):
      +  File "runme.py", line 3, in >module<
      +    example.foo(["foo", "bar", "spam", "1"])
      +NotImplementedError: Wrong number or type of arguments for overloaded function 'foo'.
      +  Possible C/C++ prototypes are:
      +    foo(int,char **)
      +    foo()
       
      -

      34.9.3 Using typemaps to return arguments

      +

      36.9.3 Using typemaps to return arguments

      @@ -4678,12 +4880,11 @@ arguments rather than in the return value of a function. For example:

       /* Returns a status value and two values in out1 and out2 */
       int spam(double a, double b, double *out1, double *out2) {
      -	... Do a bunch of stuff ...
      -	*out1 = result1;
      -	*out2 = result2;
      -	return status;
      -};
      -
      +  ... Do a bunch of stuff ...
      +  *out1 = result1;
      +  *out2 = result2;
      +  return status;
      +}
       

      @@ -4698,23 +4899,23 @@ A typemap can be used to handle this case as follows : // is guaranteed to be a List object by SWIG. %typemap(argout) double *OutValue { - PyObject *o, *o2, *o3; - o = PyFloat_FromDouble(*$1); - if ((!$result) || ($result == Py_None)) { - $result = o; - } else { - if (!PyTuple_Check($result)) { - PyObject *o2 = $result; - $result = PyTuple_New(1); - PyTuple_SetItem(target,0,o2); - } - o3 = PyTuple_New(1); - PyTuple_SetItem(o3,0,o); - o2 = $result; - $result = PySequence_Concat(o2,o3); - Py_DECREF(o2); - Py_DECREF(o3); + PyObject *o, *o2, *o3; + o = PyFloat_FromDouble(*$1); + if ((!$result) || ($result == Py_None)) { + $result = o; + } else { + if (!PyTuple_Check($result)) { + PyObject *o2 = $result; + $result = PyTuple_New(1); + PyTuple_SetItem($result,0,o2); } + o3 = PyTuple_New(1); + PyTuple_SetItem(o3,0,o); + o2 = $result; + $result = PySequence_Concat(o2,o3); + Py_DECREF(o2); + Py_DECREF(o3); + } } int spam(double a, double b, double *OutValue, double *OutValue); @@ -4756,7 +4957,7 @@ function can now be used as follows: >>>

      -

      34.9.4 Mapping Python tuples into small arrays

      +

      36.9.4 Mapping Python tuples into small arrays

      @@ -4805,7 +5006,7 @@ array, such an approach would not be recommended for huge arrays, but for small structures, this approach works fine.

      -

      34.9.5 Mapping sequences to C arrays

      +

      36.9.5 Mapping sequences to C arrays

      @@ -4894,7 +5095,7 @@ static int convert_darray(PyObject *input, double *ptr, int size) { -

      34.9.6 Pointer handling

      +

      36.9.6 Pointer handling

      @@ -4991,7 +5192,7 @@ class object (if applicable). -

      34.10 Docstring Features

      +

      36.10 Docstring Features

      @@ -5019,7 +5220,7 @@ of your users much simpler.

      -

      34.10.1 Module docstring

      +

      36.10.1 Module docstring

      @@ -5053,7 +5254,7 @@ layout of controls on a panel, etc. to be loaded from an XML file." -

      34.10.2 %feature("autodoc")

      +

      36.10.2 %feature("autodoc")

      @@ -5081,7 +5282,7 @@ four levels for autodoc controlled by the value given to the feature, %feature("autodoc", "level"). The four values for level are covered in the following sub-sections. -

      34.10.2.1 %feature("autodoc", "0")

      +

      36.10.2.1 %feature("autodoc", "0")

      @@ -5110,7 +5311,7 @@ def function_name(*args, **kwargs): -

      34.10.2.2 %feature("autodoc", "1")

      +

      36.10.2.2 %feature("autodoc", "1")

      @@ -5135,13 +5336,13 @@ def function_name(*args, **kwargs): -

      34.10.2.3 %feature("autodoc", "2")

      +

      36.10.2.3 %feature("autodoc", "2")

      Level "2" results in the function prototype as per level "0". In addition, a line of -documentation is generated for each parameter. Using the previous example, the generated -code will be: +documentation is generated for each parameter using numpydoc style. +Using the previous example, the generated code will be:

      @@ -5150,11 +5351,12 @@ def function_name(*args, **kwargs): """ function_name(x, y, foo=None, bar=None) -> bool - Parameters: - x: int - y: int - foo: Foo * - bar: Bar * + Parameters + ---------- + x: int + y: int + foo: Foo * + bar: Bar * """ ... @@ -5185,17 +5387,18 @@ def function_name(*args, **kwargs): """ function_name(x, y, foo=None, bar=None) -> bool - Parameters: - x (C++ type: int) -- Input x dimension - y: int - foo: Foo * - bar: Bar * + Parameters + ---------- + x (C++ type: int) -- Input x dimension + y: int + foo: Foo * + bar: Bar * """
      -

      34.10.2.4 %feature("autodoc", "3")

      +

      36.10.2.4 %feature("autodoc", "3")

      @@ -5208,11 +5411,12 @@ def function_name(*args, **kwargs): """ function_name(int x, int y, Foo foo=None, Bar bar=None) -> bool - Parameters: - x: int - y: int - foo: Foo * - bar: Bar * + Parameters + ---------- + x: int + y: int + foo: Foo * + bar: Bar * """ ... @@ -5220,7 +5424,7 @@ def function_name(*args, **kwargs): -

      34.10.2.5 %feature("autodoc", "docstring")

      +

      36.10.2.5 %feature("autodoc", "docstring")

      @@ -5239,7 +5443,7 @@ void GetPosition(int* OUTPUT, int* OUTPUT); -

      34.10.3 %feature("docstring")

      +

      36.10.3 %feature("docstring")

      @@ -5271,150 +5475,786 @@ with more than one line. -

      34.11 Python Packages

      +

      36.11 Python Packages

      -

      -Using the package option of the %module directive -allows you to specify what Python package that the module will be -living in when installed. -

      +

      Python has concepts of modules and packages. Modules are separate units of +code and may be grouped together to form a package. Packages may be nested, +that is they may contain subpackages. This leads to tree-like hierarchy, with +packages as intermediate nodes and modules as leaf nodes.

      -
      +

      The hierarchy of Python packages/modules follows the hierarchy of +*.py files found in a source tree (or, more generally, in the Python path). +Normally, the developer creates new module by placing a *.py file +somewhere under Python path; the module is then named after that *.py +file. A package is created by placing an __init__.py file within a +directory; the package is then named after that directory. For example, the +following source tree:

      + +
      -%module(package="wx") xrc
      +mod1.py
      +pkg1/__init__.py
      +pkg1/mod2.py
      +pkg1/pkg2/__init__.py
      +pkg1/pkg2/mod3.py
       

      -This is useful when the .i file is %imported by -another .i file. By default SWIG will assume that the -importer is able to find the importee with just the module name, but -if they live in separate Python packages then that won't work. -However if the importee specifies what its package is with the -%module option then the Python code generated for the -importer will use that package name when importing the other module -and also in base class declarations, etc. if the package name is -different than its own. +defines the following Python packages and modules:

      -

      34.12 Python 3 Support

      - +
      +
      +pkg1            # package
      +pkg1.pkg2       # package
      +mod1            # module
      +pkg1.mod2       # module
      +pkg1.pkg2.mod3  # module
      +
      +

      -SWIG is able to support Python 3.0. The wrapper code generated by -SWIG can be compiled with both Python 2.x or 3.0. Further more, by -passing the -py3 command line option to SWIG, wrapper code -with some Python 3 specific features can be generated (see below -subsections for details of these features). The -py3 option also -disables some incompatible features for Python 3, such as --classic. +The purpose of an __init__.py file is two-fold. First, the existence of +__init__.py in a directory informs the Python interpreter that this +directory contains a Python package. Second, the code in __init__.py is +loaded/executed automatically when the package is initialized (when it or its +submodule/subpackage gets import'ed). By default, SWIG generates +proxy Python code – one *.py file for each *.i +interface. The __init__.py files, however, are not generated by SWIG. +They should be created by other means. Both files (module *.py and +__init__.py) should be installed in appropriate destination +directories in order to obtain a desirable package/module hierarchy. +

      -There is a list of known-to-be-broken features in Python 3: +Python3 adds another option for packages with +PEP 0420 (implicit +namespace packages). Implicit namespace packages no longer use +__init__.py files. SWIG generated Python modules support implicit +namespace packages. See +36.11.5 Implicit Namespace +Packages for more information.

      -
        -
      • No more support for FILE* typemaps, because PyFile_AsFile has been dropped - in Python 3.
      • -
      • The -apply command line option is removed and generating - code using apply() is no longer supported.
      • -

      -The following are Python 3.0 new features that are currently supported by -SWIG. +If you place a SWIG generated module into a Python package then there +are details concerning the way SWIG +searches for the wrapper module +that you may want to familiarize yourself with.

      -

      34.12.1 Function annotation

      - +

      The way Python defines its modules and packages impacts SWIG users. Some +users may need to use special features such as the package option in the +%module directive or import related command line options. These are +explained in the following sections.

      -

      -The -py3 option will enable function annotation support. When used -SWIG is able to generate proxy method definitions like this: -

      +

      36.11.1 Setting the Python package

      -
      -  def foo(self, bar : "int"=0) -> "void" : ...
      -

      -Also, even if without passing SWIG the -py3 option, the parameter list -still could be generated: +Using the package option in the %module directive allows you +to specify a Python package that the module will be in when installed.

      -
      -  def foo(self, bar=0): ...
      -
      +
      +
      +%module(package="wx") xrc
      +
      +

      -But for overloaded function or method, the parameter list would fallback to -*args or self, *args, and **kwargs may be append -depend on whether you enabled the keyword argument. This fallback is due to -all overloaded functions share the same function in SWIG generated proxy class. +This is useful when the .i file is %imported by +another .i file. By default SWIG will assume that the +importer is able to find the importee with just the module name, but +if they live in separate Python packages then this won't work. +However if the importee specifies what its package is with the +%module option then the Python code generated for the +importer will use that package name when importing the other module +and in base class declarations, etc..

      -

      -For detailed usage of function annotation, see -PEP 3107. +

      SWIG assumes that the package option provided to %module +together with the module name (that is, wx.xrc in the above +example) forms a fully qualified (absolute) name of a module (in Python terms). +This is important especially for Python 3, where absolute imports are used by +default. It's up to you to place the generated module files (.py, +.so) in appropriate subdirectories. For example, if you have an +interface file foo.i with:

      -

      34.12.2 Buffer interface

      - +
      +
      +%module(package="pkg1.pkg2") foo
      +
      +

      -Buffer protocols were revised in Python 3. SWIG also gains a series of -new typemaps to support buffer interfaces. These typemap macros are -defined in pybuffer.i, which must be included in order to use them. -By using these typemaps, your wrapped function will be able to -accept any Python object that exposes a suitable buffer interface. +then the resulting directory layout should be

      -

      -For example, the get_path() function puts the path string -into the memory pointed to by its argument: -

      +
      +
      +pkg1/
      +pkg1/__init__.py
      +pkg1/pkg2/__init__.py
      +pkg1/pkg2/foo.py        # (generated by SWIG)
      +pkg1/pkg2/_foo.so       # (shared library built from C/C++ code generated by SWIG)
      +
      +
      -
      -void get_path(char *s);
      -
      +

      36.11.2 Absolute and relative imports

      -

      -Then you can write a typemap like this: (the following example is -applied to both Python 3.0 and 2.6, since the bytearray type -is backported to 2.6. -

      +

      Suppose, we have the following hierarchy of files:

      -
      -%include <pybuffer.i>
      -%pybuffer_mutable_string(char *str);
      -void get_path(char *s);
      -
      +
      +
      +pkg1/
      +pkg1/__init__.py
      +pkg1/mod2.py
      +pkg1/pkg2/__init__.py
      +pkg1/pkg2/mod3.py
      +
      +
      + +

      Let the contents of pkg1/pkg2/mod3.py be

      +
      +
      +class M3: pass
      +
      +

      -And then on the Python side the wrapped get_path could be used in this -way: +We edit pkg1/mod2.py and want to import module +pkg1/pkg2/mod3.py in order to derive from class M3. We can +write appropriate Python code in several ways, for example:

      -
      ->>> p = bytearray(10)
      ->>> get_path(p)
      ->>> print(p)
      -bytearray(b'/Foo/Bar/\x00')
      -
      +
        +
      1. Using "import <>" syntax with absolute package name:

        +
        +
        +# pkg1/mod2.py
        +import pkg1.pkg2.mod3
        +class M2(pkg1.pkg2.mod3.M3): pass
        +
        +
        +
      2. -

        -The macros defined in pybuffer.i are similar to those in -cstring.i: -

        +
      3. Using "import <>" syntax with package name relative to + pkg1 (only in Python 2.7 and earlier):

        +
        +
        +# pkg1/mod2.py
        +import pkg2.mod3
        +class M2(pkg2.mod3.M3): pass
        +
        +
        +
      4. -

        -%pybuffer_mutable_binary(parm, size_parm) -

        +
      5. Using "from <> import <>" syntax (relative import + syntax, only in Python 2.5 and later):

        +
        +
        +# pkg1/mod2.py
        +from .pkg2 import mod3
        +class M2(mod3.M3): pass
        +
        +
        +
      6. -
        +
      7. Other variants, for example the following construction in order to + have the pkg2.mod3.M3 symbol available in mod2 as + in point 2 above (but now under Python 3):

        +
        +
        +# pkg1/mod2.py
        +from . import pkg2
        +from .pkg2 import mod3
        +class M2(pkg2.mod3.M3): pass
        +
        +
        +
      8. -

        +

      + +

      Now suppose we have mod2.i with

      + +
      +
      +// mod2.i
      +%module (package="pkg1") mod2
      +%import "mod3.i"
      +// ...
      +
      +
      + +

      and mod3.i with

      + +
      +
      +// mod3.i
      +%module (package="pkg1.pkg2") mod3
      +// ...
      +
      +
      + +

      By default, SWIG would generate mod2.py proxy file with +import directive as in point 1. This can be changed with the +-relativeimport command line option. The -relativeimport instructs +SWIG to organize imports as in point 2 (for Python < 2.7.0) or as in point 4 +for Python 2.7.0 and newer. This is a check done at the time the module is +imported. In short, if you have +mod2.i and mod3.i as above, then without +-relativeimport SWIG will write

      + +
      +
      +import pkg1.pkg2.mod3
      +
      +
      + +

      to mod2.py proxy file, and with -relativeimport it will +write

      + +
      +
      +from sys import version_info
      +if version_info >= (2, 7, 0):
      +    from . import pkg2
      +    import pkg1.pkg2.mod3
      +else:
      +    import pkg2.mod3
      +del version_info
      +
      +
      + +

      You should avoid using relative imports and use absolute ones whenever +possible. There are some cases, however, when relative imports may be +necessary. The first example is, when some (legacy) Python code refers entities +imported by proxy files generated by SWIG, and it assumes that the proxy file +uses relative imports. Second case is, when one puts import directives in +__init__.py to import symbols from submodules or subpackages and the +submodule depends on other submodules (discussed later).

      + +

      36.11.3 Enforcing absolute import semantics

      + + +

      As you may know, there is an incompatibility in import semantics (for the +import <> syntax) between Python 2 and 3. In Python 2.4 and +earlier it is not clear whether

      + +
      +
      +import foo
      +
      +
      +

      refers to a top-level module or to another module inside the current +package. In Python 3 it always refers to a top-level module +(see PEP 328). +To instruct Python 2.5 through 2.7 to use new semantics (that is import +foo is interpreted as absolute import), one has to put the following +line +

      + +
      +
      +from __future__ import absolute_import
      +
      +
      + +

      at the very beginning of his proxy *.py file. In SWIG, it may be +accomplished with %pythonbegin directive as follows:

      + +
      +
      +%pythonbegin %{
      +from __future__ import absolute_import
      +%}
      +
      +
      + +

      36.11.4 Importing from __init__.py

      + + +

      Imports in __init__.py are handy when you want to populate a +package's namespace with names imported from other modules. In SWIG based +projects this approach may also be used to split large pieces of code into +smaller modules, compile them in parallel and then re-assemble everything at +runtime by importing submodules' contents in __init__.py, for +example.

      + +

      Unfortunately import directives in __init__.py may cause problems, +especially if they refer to a package's submodules. This is caused by the way +Python initializes packages. If you spot problems with imports from +__init__.py try using -relativeimport option. Below we +explain in detail one issue, for which the -relativeimport workaround +may be helpful.

      + +

      Consider the following example (Python 3):

      + +
      +
      +pkg1/__init__.py        # (empty)
      +pkg1/pkg2/__init__.py   # (imports something from bar.py)
      +pkg1/pkg2/foo.py
      +pkg1/pkg2/bar.py        # (imports foo.py)
      +
      +
      + +

      If the file contents are:

      + +
        +
      • pkg1/pkg2/__init__.py:

        +
        +
        +# pkg1/pkg2/__init__.py
        +from .bar import Bar
        +
        +
        +
      • + +
      • pkg1/pkg2/foo.py:

        +
        +
        +# pkg1/pkg2/foo.py
        +class Foo: pass
        +
        +
        +
      • + +
      • pkg1/pkg2/bar.py:

        +
        +
        +# pkg1/pkg2/bar.py
        +import pkg1.pkg2.foo
        +class Bar(pkg1.pkg2.foo.Foo): pass
        +
        +
        +
      • +
      + +

      Now if one simply used import pkg1.pkg2, it will usually fail:

      + +
      +
      +>>> import pkg1.pkg2
      +Traceback (most recent call last):
      +  File "<stdin>", line 1, in <module>
      +  File "./pkg1/pkg2/__init__.py", line 2, in <module>
      +    from .bar import Bar
      +  File "./pkg1/pkg2/bar.py", line 3, in <module>
      +    class Bar(pkg1.pkg2.foo.Foo): pass
      +AttributeError: 'module' object has no attribute 'pkg2'
      +
      +
      + +

      Surprisingly, if we execute the import pkg1.pkg2 directive for the +second time, it succeeds. The reason seems to be following: when Python spots +the from .bar import Bar directive in pkg1/pkg2/__init__.py +it starts loading pkg1/pkg2/bar.py. This module imports +pkg1.pkg2.foo in turn and tries to use pkg1.pkg2.foo.Foo, but +the package pkg1 is not fully initialized yet (the initialization +procedure is actually in progress) and it seems like the effect of the already seen +import pkg1.pkg2.pkg3.foo is "delayed" or ignored. Exactly the +same may happen to a proxy module generated by SWIG.

      + +

      One workaround for this case is to use a relative +import in pkg1/pkg2/bar.py. If we change bar.py to be:

      + +
      +
      +from .pkg3 import foo
      +class Bar(foo.Foo): pass
      +
      +
      + +

      or

      + +
      +
      +from . import pkg3
      +from .pkg3 import foo
      +class Bar(pkg3.foo.Foo): pass
      +
      +
      + +

      then the example works again. With SWIG, you need to enable the +-relativeimport option in order to have the above workaround in +effect (note, that the Python 2 case also needs the -relativeimport +workaround).

      + +

      36.11.5 Implicit Namespace Packages

      + + +

      Python 3.3 introduced +PEP 0420 which +implements implicit namespace packages. In a nutshell, implicit namespace +packages remove the requirement of an __init__.py file and allow packages +to be split across multiple PATH elements. For example: +

      + +
      +
      +/fragment1/pkg1/mod1.py
      +/fragment2/pkg1/mod2.py
      +/fragment3/pkg1/mod3.py
      +
      +
      + +

      If PYTHONPATH is set to "/fragment1:/fragment2:/fragment3", then mod1, mod2 +and mod3 will be part of pkg1. This allows for splitting of packages into +separate pieces. This can be useful for SWIG generated wrappers in the +following way. +

      + +

      Suppose you create a SWIG wrapper for a module called robin. The SWIG +generated code consists of two files robin.py and _robin.so. You wish to +make these modules part of a subpackage (brave.sir). With implicit namespace +packages you can place these files in the following configurations: +

      + +

      Using PYTHONPATH="/some/path"

      +
      +
      +/some/path/brave/sir/robin.py
      +/some/path/brave/sir/_robin.so
      +
      +
      + +

      Using PYTHONPATH="/some/path:/some/other/path" + +

      +
      +/some/path/brave/sir/robin.py
      +/some/other/path/brave/sir/_robin.so
      +
      +
      + +

      Finally suppose that your pure python code is stored in a .zip file or +some other way (database, web service connection, etc). Python can load the +robin.py module using a custom importer. But the _robin.so module will need +to be located on a file system. Implicit namespace packages make this +possible. For example, using PYTHONPATH="/some/path/foo.zip:/some/other/path" + +

      Contents of foo.zip

      +
      +
      +brave/
      +brave/sir/
      +brave/sir/robin.py
      +
      +
      + +

      File system contents

      +
      +
      +/some/other/path/brave/sir/_robin.so
      +
      +
      + +

      Support for implicit namespace packages was added to python-3.3. The +zipimporter requires python-3.5.1 or newer to work with subpackages. +

      + +

      +Compatibility Note: Support for implicit namespace packages was added in SWIG-3.0.9. +

      + + +

      36.11.6 Searching for the wrapper module

      + + +

      +When SWIG creates wrappers from an interface file, say foo.i, two Python modules are +created. There is a pure Python module module (foo.py) and C/C++ code which is +built and linked into a dynamically (or statically) loaded module _foo +(see the Preliminaries section for details). So, the interface +file really defines two Python modules. How these two modules are loaded is +covered next. +

      + +

      +The pure Python module needs to load the C/C++ module in order to link +to the wrapped C/C++ methods. To do this it must make some assumptions +about what package the C/C++ module may be located in. The approach the +pure Python module uses to find the C/C++ module is as follows: +

      + +
        +
      1. The pure Python module, foo.py, tries to load the C/C++ module, _foo, from the same package foo.py is + located in. The package name is determined from the __name__ + attribute given to foo.py by the Python loader that imported + foo.py. If foo.py is not in a package then _foo is loaded + as a global module.

        +
      2. +
      3. If the above import of _foo results in an ImportError + being thrown, then foo.py makes a final attempt to load _foo + as a global module.

        +
      4. +
      + +

      +As an example suppose foo.i is compiled into foo.py and _foo.so. Assuming +/dir is on PYTHONPATH, then the two modules can be installed and used in the +following ways: +

      + + +

      36.11.6.1 Both modules in the same package

      + + +

      Both modules are in one package:

      +
      +
      +/dir/package/foo.py
      +/dir/package/__init__.py
      +/dir/package/_foo.so
      +
      +
      +

      And imported with

      +
      +
      +from package import foo
      +
      +
      + + +

      36.11.6.2 Split modules

      + + +

      The pure python module is in a package and the C/C++ module is global:

      +
      +
      +/dir/package/foo.py
      +/dir/package/__init__.py
      +/dir/_foo.so
      +
      +
      +

      And imported with

      +
      +
      +from package import foo
      +
      +
      + + +

      36.11.6.3 Both modules are global

      + + +

      Both modules are global:

      +
      +
      +/dir/foo.py
      +/dir/_foo.so
      +
      +
      +

      And imported with

      +
      +
      +import foo
      +
      +
      + +

      +If _foo is statically linked into an embedded Python interpreter, then it may or +may not be in a Python package. This depends in the exact way the module was +loaded statically. The above search order will still be used for statically +loaded modules. So, one may place the module either globally or in a package +as desired. +

      + +

      36.11.6.4 Statically linked C modules

      + + +

      It is strongly recommended to use dynamically linked modules for the C +portion of your pair of Python modules. +If for some reason you still need +to link the C module of the pair of Python modules generated by SWIG into +your interpreter, then this section provides some details on how this impacts +the pure Python modules ability to locate the other part of the pair. +Please also see the Static Linking section. +

      + +

      When Python is extended with C code the Python interpreter needs to be +informed about details of the new C functions that have been linked into +the executable. The code to do this is created by SWIG and is automatically +called in the correct way when the module is dynamically loaded. However +when the code is not dynamically loaded (because it is statically linked) +Then the initialization method for the module created by SWIG is not +called automatically and the Python interpreter has no idea that the +new SWIG C module exists. +

      + +

      Before Python 3, one could simply call the init method created by SWIG +which would have normally been called when the shared object was dynamically +loaded. The specific name of this method is not given here because statically +linked modules are not encouraged with SWIG +(Static Linking). However one can find this +init function in the C file generated by SWIG. +

      + +

      If you are really keen on static linking there are two ways +to initialize the SWIG generated C module with the init method. Which way +you use depends on what version of Python your module is being linked with. +Python 2 and Python 3 treat this init function differently. And the way +they treat it affects how the pure Python module will be able to +locate the C module. +

      + +

      The details concerning this are covered completly in the documentation +for Python itself. Links to the relavent sections follow: +

      + + + +

      There are two keys things to understand. The first is that in +Python 2 the init() function returns void. In Python 3 the init() function +returns a PyObject * which points to the new module. Secondly, when +you call the init() method manually, you are the Python importer. So, you +determine which package the C module will be located in. +

      + +

      So, if you are using Python 3 it is important that you follow what is +described in the Python documentation linked above. In particular, you can't +simply call the init() function generated by SWIG and cast the PyObject +pointer it returns over the side. If you do then Python 3 will have no +idea that your C module exists and the pure Python half of your wrapper will +not be able to find it. You need to register your module with the Python +interpreter as described in the Python docs. +

      + +

      With Python 2 things are somewhat more simple. In this case the init function +returns void. Calling it will register your new C module as a global +module. The pure Python part of the SWIG wrapper will be able to find it +because it tries both the pure Python module it is part of and the global +module. If you wish not to have the statically linked module be a global +module then you will either need to refer to the Python documentation on how +to do this (remember you are now the Python importer) or use dynamic linking. +

      + +

      36.12 Python 3 Support

      + + +

      +SWIG is able to support Python 3.0. The wrapper code generated by +SWIG can be compiled with both Python 2.x or 3.0. Further more, by +passing the -py3 command line option to SWIG, wrapper code +with some Python 3 specific features can be generated (see below +subsections for details of these features). The -py3 option also +disables some incompatible features for Python 3, such as +-classic. + +

      +There is a list of known-to-be-broken features in Python 3: +

      +
        +
      • No more support for FILE* typemaps, because PyFile_AsFile has been dropped + in Python 3.
      • +
      • The -apply command line option is removed and generating + code using apply() is no longer supported.
      • +
      + +

      +The following are Python 3.0 new features that are currently supported by +SWIG. +

      + +

      36.12.1 Function annotation

      + + +

      +The -py3 option will enable function annotation support. When used +SWIG is able to generate proxy method definitions like this: +

      + +
      +  def foo(self, bar : "int"=0) -> "void" : ...
      +
      + +

      +Also, even if without passing SWIG the -py3 option, the parameter list +still could be generated: +

      + +
      +  def foo(self, bar=0): ...
      +
      + +

      +But for overloaded function or method, the parameter list would fallback to +*args or self, *args, and **kwargs may be append +depend on whether you enabled the keyword argument. This fallback is due to +all overloaded functions share the same function in SWIG generated proxy class. +

      + +

      +For detailed usage of function annotation, see +PEP 3107. +

      + +

      36.12.2 Buffer interface

      + + +

      +Buffer protocols were revised in Python 3. SWIG also gains a series of +new typemaps to support buffer interfaces. These typemap macros are +defined in pybuffer.i, which must be included in order to use them. +By using these typemaps, your wrapped function will be able to +accept any Python object that exposes a suitable buffer interface. +

      + +

      +For example, the get_path() function puts the path string +into the memory pointed to by its argument: +

      + +
      +void get_path(char *s);
      +
      + +

      +Then you can write a typemap like this: (the following example is +applied to both Python 3.0 and 2.6, since the bytearray type +is backported to 2.6. +

      + + +
      +%include <pybuffer.i>
      +%pybuffer_mutable_string(char *str);
      +void get_path(char *s);
      +
      + +

      +And then on the Python side the wrapped get_path could be used in this +way: +

      + +
      +>>> p = bytearray(10)
      +>>> get_path(p)
      +>>> print(p)
      +bytearray(b'/Foo/Bar/\x00')
      +
      + +

      +The macros defined in pybuffer.i are similar to those in +cstring.i: +

      + +

      +%pybuffer_mutable_binary(parm, size_parm) +

      + +
      + +

      The macro can be used to generate a typemap which maps a buffer of an object to a pointer provided by parm and a size argument provided by size_parm. For example: @@ -5510,7 +6350,7 @@ modify the buffer.

      -

      34.12.3 Abstract base classes

      +

      36.12.3 Abstract base classes

      @@ -5548,7 +6388,243 @@ used to define an abstract base class for your own C++ class:

      For details of abstract base class, please see -PEP 3119. +PEP 3119. +

      + +

      36.12.4 Byte string output conversion

      + + +

      +By default, any byte string (char* or std::string) returned +from C or C++ code is decoded to text as UTF-8. This decoding uses the +surrogateescape error handler under Python 3.1 or higher -- this +error handler decodes invalid byte sequences to high surrogate characters +in the range U+DC80 to U+DCFF. + +As an example, consider the following SWIG interface, which exposes a byte +string that cannot be completely decoded as UTF-8: +

      + +
      +%module example
      +
      +%include <std_string.i>
      +
      +%inline %{
      +
      +const char* non_utf8_c_str(void) {
      +        return "h\xe9llo w\xc3\xb6rld";
      +}
      +
      +%}
      +
      + +

      +When this method is called from Python 3, the return value is the following +text string: +

      + +
      +>>> s = example.non_utf8_c_str()
      +>>> s
      +'h\udce9llo wörld'
      +
      + +

      +Since the C string contains bytes that cannot be decoded as UTF-8, those raw +bytes are represented as high surrogate characters that can be used to obtain +the original byte sequence: +

      + +
      +>>> b = s.encode('utf-8', errors='surrogateescape')
      +>>> b
      +b'h\xe9llo w\xc3\xb6rld'
      +
      + +

      +One can then attempt a different encoding, if desired (or simply leave the +byte string as a raw sequence of bytes for use in binary protocols): +

      + +
      +>>> b.decode('latin-1')
      +'héllo wörld'
      +
      + +

      +Note, however, that text strings containing surrogate characters are rejected +with the default strict codec error handler. For example: +

      + +
      +>>> with open('test', 'w') as f:
      +...     print(s, file=f)
      +...
      +Traceback (most recent call last):
      +  File "<stdin>", line 2, in <module>
      +UnicodeEncodeError: 'utf-8' codec can't encode character '\udce9' in position 1: surrogates not allowed
      +
      + +

      +This requires the user to check most strings returned by SWIG bindings, but +the alternative is for a non-UTF8 byte string to be completely inaccessible +in Python 3 code. +

      + +

      +For more details about the surrogateescape error handler, please see +PEP 383. +

      + +

      +In some cases, users may wish to instead handle all byte strings as bytes +objects in Python 3. This can be accomplished by adding +SWIG_PYTHON_STRICT_BYTE_CHAR to the generated code: +

      + +
      +%module char_to_bytes
      +%begin %{
      +#define SWIG_PYTHON_STRICT_BYTE_CHAR
      +%}
      +
      +char *charstring(char *s) {
      +  return s;
      +}
      +
      + +

      +This will modify the behavior so that only Python 3 bytes objects will be +accepted and converted to a C/C++ string, and any string returned from C/C++ +will be converted to a bytes object in Python 3: +

      + +
      +>>> from char_to_bytes import *
      +>>> charstring(b"hi") # Byte string
      +b'hi'
      +>>> charstring("hi")  # Unicode string
      +Traceback (most recent call last):
      +  File "<stdin>", line 1, in ?
      +TypeError: in method 'charstring', argument 1 of type 'char *'
      +
      + +

      +Note that in Python 2, defining SWIG_PYTHON_STRICT_BYTE_CHAR has no +effect, since strings in Python 2 are equivalent to Python 3 bytes objects. +However, there is a similar capability to force unicode-only handling for +wide characters C/C++ strings (wchar_t * or std::wstring +types) in Python 2. By default, in Python 2 both strings and unicode strings +are converted to C/C++ wide strings, and returned wide strings are converted +to a Python unicode string. To instead only convert unicode strings to wide +strings, users can add SWIG_PYTHON_STRICT_UNICODE_WCHAR to the +generated code: +

      + +
      +%module wchar_to_unicode
      +%begin %{
      +#define SWIG_PYTHON_STRICT_UNICODE_WCHAR
      +%}
      +
      +wchar_t *wcharstring(wchar_t *s) {
      +  return s;
      +}
      +
      + +

      +This ensures that only unicode strings are accepted by wcharstring in both +Python 2 and Python 3: +

      + +
      +>>> from wchar_to_unicode import *
      +>>> wcharstring(u"hi") # Unicode string
      +u'hi'
      +>>> wcharstring(b"hi") # Byte string
      +Traceback (most recent call last):
      +  File "<stdin>", line 1, in ?
      +TypeError: in method 'charstring', argument 1 of type 'wchar_t *'
      +
      + +

      +By defining both SWIG_PYTHON_STRICT_BYTE_CHAR and +SWIG_PYTHON_STRICT_UNICODE_WCHAR, Python wrapper code can support +overloads taking both std::string (as Python bytes) and std::wstring +(as Python unicode). +

      + +

      36.12.5 Python 2 Unicode

      + + +

      +A Python 3 string is a Unicode string so by default a Python 3 string that contains Unicode +characters passed to C/C++ will be accepted and converted to a C/C++ string +(char * or std::string types). +A Python 2 string is not a unicode string by default and should a Unicode string be +passed to C/C++ it will fail to convert to a C/C++ string +(char * or std::string types). +The Python 2 behavior can be made more like Python 3 by defining +SWIG_PYTHON_2_UNICODE when compiling the generated C/C++ code. +By default when the following is wrapped: +

      + +
      +%module unicode_strings
      +char *charstring(char *s) {
      +  return s;
      +}
      +
      + +

      +An error will occur when using Unicode strings in Python 2: +

      + +
      +>>> from unicode_strings import *
      +>>> charstring("hi")
      +'hi'
      +>>> charstring(u"hi")
      +Traceback (most recent call last):
      +  File "<stdin>", line 1, in ?
      +TypeError: in method 'charstring', argument 1 of type 'char *'
      +
      + +

      +When the SWIG_PYTHON_2_UNICODE macro is added to the generated code: +

      + +
      +%module unicode_strings
      +%begin %{
      +#define SWIG_PYTHON_2_UNICODE
      +%}
      +
      +char *charstring(char *s) {
      +  return s;
      +}
      +
      + +

      +Unicode strings will be successfully accepted and converted from UTF-8, +but note that they are returned as a normal Python 2 string: +

      + +
      +>>> from unicode_strings import *
      +>>> charstring("hi")
      +'hi'
      +>>> charstring(u"hi")
      +'hi'
      +>>>
      +
      + +

      +Note that defining both SWIG_PYTHON_2_UNICODE and +SWIG_PYTHON_STRICT_BYTE_CHAR at the same time is not allowed, since +the first is allowing unicode conversion and the second is explicitly +prohibiting it.

      diff --git a/Doc/Manual/R.html b/Doc/Manual/R.html index ceea321..9b5993b 100644 --- a/Doc/Manual/R.html +++ b/Doc/Manual/R.html @@ -1,12 +1,13 @@ - + SWIG and R + -

      35 SWIG and R

      +

      37 SWIG and R

        @@ -33,7 +34,7 @@ compile and run an R interface to QuantLib running on Mandriva Linux with gcc. The R bindings also work on Microsoft Windows using Visual C++.

        -

        35.1 Bugs

        +

        37.1 Bugs

        @@ -45,7 +46,7 @@ Currently the following features are not implemented or broken:

      • C Array wrappings
      -

      35.2 Using R and SWIG

      +

      37.2 Using R and SWIG

      @@ -119,7 +120,24 @@ Without it, inheritance of wrapped objects may fail. These two files can be loaded in any order

      -

      35.3 Precompiling large R files

      +

      + If you are compiling code yourself (not using R itself), there are a few things to watch out for: +

      + +
        +
      • The output shared library name (to the left of the file extension) MUST match the module name, or alternatively, you can also set the -package NAME command line argument. See swig -r -help for more information +
      • If you do not set the output file name appropriately, you might see errors like +
        +
        +> fact(4)
        +Error in .Call("R_swig_fact", s_arg1, as.logical(.copy), PACKAGE = "example") :
        +  "R_swig_fact" not available for .Call() for package "example"
        +
        +
        +
      • Make sure the architecture of the shared library(x64 for instance), matches the architecture of the R program you want to load your shared library into +
      + +

      37.3 Precompiling large R files

      In cases where the R file is large, one make save a lot of loading @@ -137,7 +155,7 @@ will save a large amount of loading time. -

      35.4 General policy

      +

      37.4 General policy

      @@ -146,7 +164,7 @@ wrapping over the underlying functions and rely on the R type system to provide R syntax.

      -

      35.5 Language conventions

      +

      37.5 Language conventions

      @@ -155,7 +173,7 @@ and [ are overloaded to allow for R syntax (one based indices and slices)

      -

      35.6 C++ classes

      +

      37.6 C++ classes

      @@ -167,7 +185,7 @@ keep track of the pointer object which removes the necessity for a lot of the proxy class baggage you see in other languages.

      -

      35.7 Enumerations

      +

      37.7 Enumerations

      diff --git a/Doc/Manual/Ruby.html b/Doc/Manual/Ruby.html index 301631a..cfb99e7 100644 --- a/Doc/Manual/Ruby.html +++ b/Doc/Manual/Ruby.html @@ -1,13 +1,14 @@ - + - SWIG and Ruby - +SWIG and Ruby + + -

      36 SWIG and Ruby

      +

      38 SWIG and Ruby

        @@ -42,6 +43,10 @@
      • C++ STL Functors
      • C++ STL Iterators
      • C++ Smart Pointers +
      • Cross-Language Polymorphism
        • Exception Unrolling @@ -144,10 +149,10 @@

          This chapter describes SWIG's support of Ruby.

          -

          36.1 Preliminaries

          +

          38.1 Preliminaries

          -

          SWIG 1.3 is known to work with Ruby versions 1.6 and later. +

          SWIG 3.0 is known to work with Ruby versions 1.8 and later. Given the choice, you should use the latest stable version of Ruby. You should also determine if your system supports shared libraries and dynamic loading. SWIG will work with or without dynamic loading, but @@ -159,7 +164,7 @@ read the "SWIG Basics" chapter. It is also assumed that the reader has a basic understanding of Ruby.

          -

          36.1.1 Running SWIG

          +

          38.1.1 Running SWIG

          To build a Ruby module, run SWIG using the -ruby @@ -183,7 +188,7 @@ if compiling a C++ extension) that contains all of the code needed to build a Ruby extension module. To finish building the module, you need to compile this file and link it with the rest of your program.

          -

          36.1.2 Getting the right header files

          +

          38.1.2 Getting the right header files

          In order to compile the wrapper code, the compiler needs the ruby.h @@ -191,7 +196,7 @@ header file. This file is usually contained in a directory such as

          /usr/lib/ruby/1.8/x86_64-linux-gnu/ruby.h
          -/usr/local/lib/ruby/1.6/i686-linux/ruby.h
          +/usr/include/ruby-2.1.0/ruby.h
           
          @@ -201,12 +206,18 @@ installed, you can run Ruby to find out. For example:

          $ ruby -e 'puts $:.join("\n")'
          -/usr/local/lib/ruby/site_ruby/1.6 /usr/local/lib/ruby/site_ruby/1.6/i686-linux
          -/usr/local/lib/ruby/site_ruby /usr/local/lib/ruby/1.6 /usr/local/lib/ruby/1.6/i686-linux .
          +/usr/local/lib/site_ruby/2.1.0
          +/usr/local/lib/x86_64-linux-gnu/site_ruby
          +/usr/local/lib/site_ruby
          +/usr/lib/ruby/vendor_ruby/2.1.0
          +/usr/lib/x86_64-linux-gnu/ruby/vendor_ruby/2.1.0
          +/usr/lib/ruby/vendor_ruby
          +/usr/lib/ruby/2.1.0
          +/usr/lib/x86_64-linux-gnu/ruby/2.1.0
           
          -

          36.1.3 Compiling a dynamic module

          +

          38.1.3 Compiling a dynamic module

          Ruby extension modules are typically compiled into shared @@ -259,19 +270,27 @@ operating system would look something like this:

          $ swig -ruby example.i
          -$ gcc -c example.c
          -$ gcc -c example_wrap.c -I/usr/local/lib/ruby/1.6/i686-linux
          +$ gcc -O2 -fPIC -c example.c
          +$ gcc -O2 -fPIC -c example_wrap.c -I/usr/include/ruby-2.1.0
           $ gcc -shared example.o example_wrap.o -o example.so
           
          -

          For other platforms it may be necessary to compile with the -fPIC -option to generate position-independent code. If in doubt, consult the +

          +The -fPIC option tells GCC to generate position-independent code (PIC) +which is required for most architectures (it's not vital on x86, but +still a good idea as it allows code pages from the library to be shared between +processes). Other compilers may need a different option specified instead of +-fPIC. +

          + +

          +If in doubt, consult the manual pages for your compiler and linker to determine the correct set of options. You might also check the SWIG Wiki for additional information.

          -

          36.1.4 Using your module

          +

          38.1.4 Using your module

          Ruby module names must be capitalized, @@ -301,7 +320,7 @@ begins with:

          will result in an extension module using the feature name "example" and Ruby module name "Example".

          -

          36.1.5 Static linking

          +

          38.1.5 Static linking

          An alternative approach to dynamic linking is to rebuild the @@ -316,7 +335,7 @@ finding the Ruby source, adding an entry to the ext/Setup file, adding your directory to the list of extensions in the file, and finally rebuilding Ruby.

          -

          36.1.6 Compilation of C++ extensions

          +

          38.1.6 Compilation of C++ extensions

          On most machines, C++ extension modules should be linked @@ -325,8 +344,8 @@ using the C++ compiler. For example:

           $ swig -c++ -ruby example.i
          -$ g++ -c example.cxx
          -$ g++ -c example_wrap.cxx -I/usr/local/lib/ruby/1.6/i686-linux
          +$ g++ -fPIC -c example.cxx
          +$ g++ -fPIC -c example_wrap.cxx -I/usr/include/ruby-2.1.0
           $ g++ -shared example.o example_wrap.o -o example.so
           
          @@ -348,7 +367,7 @@ $libs = append_library($libs, "supc++") create_makefile('example')
      -

      36.2 Building Ruby Extensions under Windows 95/NT

      +

      38.2 Building Ruby Extensions under Windows 95/NT

      Building a SWIG extension to Ruby under Windows 95/NT is @@ -373,7 +392,7 @@ order to build extensions, you may need to download the source distribution to the Ruby package, as you will need the Ruby header files.

      -

      36.2.1 Running SWIG from Developer Studio

      +

      38.2.1 Running SWIG from Developer Studio

      If you are developing your application within Microsoft @@ -437,13 +456,13 @@ Foo = 3.0

      -

      36.3 The Ruby-to-C/C++ Mapping

      +

      38.3 The Ruby-to-C/C++ Mapping

      This section describes the basics of how SWIG maps C or C++ declarations in your SWIG interface files to Ruby constructs.

      -

      36.3.1 Modules

      +

      38.3.1 Modules

      The SWIG %module directive specifies @@ -515,7 +534,7 @@ option to wrap everything into the global module, take care that the names of your constants, classes and methods don't conflict with any of Ruby's built-in names.

      -

      36.3.2 Functions

      +

      38.3.2 Functions

      Global functions are wrapped as Ruby module methods. For @@ -549,7 +568,7 @@ irb(main):002:0> Example.fact(4) 24

      -

      36.3.3 Variable Linking

      +

      38.3.3 Variable Linking

      C/C++ global variables are wrapped as a pair of singleton @@ -611,7 +630,7 @@ directive. For example:

      effect until it is explicitly disabled using %mutable.

      -

      36.3.4 Constants

      +

      38.3.4 Constants

      C/C++ constants are wrapped as module constants initialized @@ -639,7 +658,7 @@ irb(main):002:0> Example::PI 3.14159 -

      36.3.5 Pointers

      +

      38.3.5 Pointers

      "Opaque" pointers to arbitrary C/C++ types (i.e. types that @@ -663,7 +682,7 @@ returns an instance of an internally generated Ruby class:

      A NULL pointer is always represented by the Ruby nil object.

      -

      36.3.6 Structures

      +

      38.3.6 Structures

      C/C++ structs are wrapped as Ruby classes, with accessor @@ -677,7 +696,7 @@ For example, this struct declaration:

      gets wrapped as a Vector class, with -Ruby instance methods x, x=, +Ruby instance methods x, x=, y and y=. These methods can be used to access structure data from Ruby as follows:

      @@ -768,7 +787,7 @@ void Bar_f_set(Bar *b, Foo *val) { } -

      36.3.7 C++ classes

      +

      38.3.7 C++ classes

      Like structs, C++ classes are wrapped by creating a new Ruby @@ -823,7 +842,7 @@ Ale 3 -

      36.3.8 C++ Inheritance

      +

      38.3.8 C++ Inheritance

      The SWIG type-checker is fully aware of C++ inheritance. @@ -976,7 +995,7 @@ inherit from both Base1 and Base2 (i.e. they exhibit "Duck Typing").

      -

      36.3.9 C++ Overloaded Functions

      +

      38.3.9 C++ Overloaded Functions

      C++ overloaded functions, methods, and constructors are @@ -1066,7 +1085,7 @@ arises--in this case, the first declaration takes precedence.

      Please refer to the "SWIG and C++" chapter for more information about overloading.

      -

      36.3.10 C++ Operators

      +

      38.3.10 C++ Operators

      For the most part, overloaded operators are handled @@ -1108,7 +1127,7 @@ c = Example.add_complex(a, b) is discussed in the section on operator overloading.

      -

      36.3.11 C++ namespaces

      +

      38.3.11 C++ namespaces

      SWIG is aware of C++ namespaces, but namespace names do not @@ -1165,7 +1184,7 @@ and create extension modules for each namespace separately. If your program utilizes thousands of small deeply nested namespaces each with identical symbol names, well, then you get what you deserve.

      -

      36.3.12 C++ templates

      +

      38.3.12 C++ templates

      C++ templates don't present a huge problem for SWIG. However, @@ -1207,7 +1226,7 @@ irb(main):004:0> p.second 4 -

      36.3.13 C++ Standard Template Library (STL)

      +

      38.3.13 C++ Standard Template Library (STL)

      On a related note, the standard SWIG library contains a @@ -1300,12 +1319,12 @@ puts v shown in these examples. More details can be found in the SWIG and C++ chapter.

      -

      36.3.14 C++ STL Functors

      +

      38.3.14 C++ STL Functors

      Some containers in the STL allow you to modify their default behavior by using so called functors or function objects. -Functors are often just a very simple struct with operator() +Functors are often just a very simple struct with operator() redefined or an actual C/C++ function. This allows you, for example, to always keep the sort order of a STL container to your liking.

      @@ -1319,7 +1338,7 @@ this includes std::set, std::multiset and std::multimap.

      -

      The functors in swig are called swig::UnaryFunction +

      The functors in swig are called swig::UnaryFunction and swig::BinaryFunction. For C++ predicates (ie. functors that must return bool as a result) swig::UnaryPredicate @@ -1333,7 +1352,7 @@ are provided.

      %include <std_set.i> -%typemap(IntSet) std::set< int, swig::BinaryPredicate >; +%template(IntSet) std::set< int, swig::BinaryPredicate >;

      You can then use the set from Ruby with or without a proc @@ -1361,7 +1380,7 @@ b -

      36.3.15 C++ STL Iterators

      +

      38.3.15 C++ STL Iterators

      The STL is well known for the use of iterators. There @@ -1372,8 +1391,8 @@ values they point at, while the non-const iterators can both read and modify the values.

      The Ruby STL wrappings support both type of iterators by using -a proxy class in-between. This proxy class is swig::Iterator or -swig::ConstIterator. Derived from them are template +a proxy class in-between. This proxy class is swig::Iterator or +swig::ConstIterator. Derived from them are template classes that need to be initialized with the actual iterator for the container you are wrapping and often times with the beginning and ending points of the iteration range.

      @@ -1442,9 +1461,23 @@ i -

      If you'd rather have STL classes without any iterators, you should define -DSWIG_NO_EXPORT_ITERATOR_METHODS when running swig.

      +

      If you'd rather have STL classes without any iterators, you should define -DSWIG_NO_EXPORT_ITERATOR_METHODS when running swig.

      + +

      38.3.16 C++ Smart Pointers

      + + +

      38.3.16.1 The shared_ptr Smart Pointer

      + + +

      +The C++11 standard provides std::shared_ptr which was derived from the Boost +implementation, boost::shared_ptr. +Both of these are available for Ruby in the SWIG library and usage is outlined +in the shared_ptr smart pointer library section. +

      + -

      36.3.16 C++ Smart Pointers

      +

      38.3.16.2 Generic Smart Pointers

      In certain C++ programs, it is common to use classes that @@ -1509,7 +1542,7 @@ method. For example:

      irb(main):004:0> f = p.__deref__() # Returns underlying Foo *
      -

      36.3.17 Cross-Language Polymorphism

      +

      38.3.17 Cross-Language Polymorphism

      SWIG's Ruby module supports cross-language polymorphism @@ -1518,7 +1551,7 @@ module. Rather than duplicate the information presented in the 36.3.17.1 Exception Unrolling +

      38.3.17.1 Exception Unrolling

      Whenever a C++ director class routes one of its virtual @@ -1541,7 +1574,7 @@ method is "wrapped" using the rb_rescue2() function from Ruby's C API. If any Ruby exception is raised, it will be caught here and a C++ exception is raised in its place.

      -

      36.4 Naming

      +

      38.4 Naming

      Ruby has several common naming conventions. Constants are @@ -1579,7 +1612,7 @@ generated by SWIG, it is turned off by default in SWIG 1.3.28. However, it is planned to become the default option in future releases.

      -

      36.4.1 Defining Aliases

      +

      38.4.1 Defining Aliases

      It's a fairly common practice in the Ruby built-ins and @@ -1649,7 +1682,7 @@ matching rules used for other kinds of features apply (see the chapter on "Customization Features") for more details).

      -

      36.4.2 Predicate Methods

      +

      38.4.2 Predicate Methods

      Ruby methods that return a boolean value and end in a @@ -1698,7 +1731,7 @@ using SWIG's "features" mechanism and so the same name matching rules used for other kinds of features apply (see the chapter on "Customization Features") for more details).

      -

      36.4.3 Bang Methods

      +

      38.4.3 Bang Methods

      Ruby methods that modify an object in-place and end in an @@ -1730,7 +1763,7 @@ using SWIG's "features" mechanism and so the same name matching rules used for other kinds of features apply (see the chapter on "Customization Features") for more details).

      -

      36.4.4 Getters and Setters

      +

      38.4.4 Getters and Setters

      Often times a C++ library will expose properties through @@ -1765,7 +1798,7 @@ irb(main):003:0> puts foo.value %rename("value=") Foo::setValue(int value); -

      36.5 Input and output parameters

      +

      38.5 Input and output parameters

      A common problem in some C programs is handling parameters @@ -1904,10 +1937,10 @@ void get_dimensions(Matrix *m, int *rows, int*columns);

      r, c = Example.get_dimensions(m)
      -

      36.6 Exception handling

      +

      38.6 Exception handling

      -

      36.6.1 Using the %exception directive

      +

      38.6.1 Using the %exception directive

      The SWIG %exception directive can be @@ -2016,7 +2049,7 @@ methods and functions named getitem and setitem. limited to C++ exception handling. See the chapter on Customization Features for more examples.

      -

      36.6.2 Handling Ruby Blocks

      +

      38.6.2 Handling Ruby Blocks

      One of the highlights of Ruby and most of its standard library @@ -2083,7 +2116,7 @@ a special in typemap, like:

      For more information on typemaps, see Typemaps.

      -

      36.6.3 Raising exceptions

      +

      38.6.3 Raising exceptions

      There are three ways to raise exceptions from C++ code to @@ -2240,7 +2273,7 @@ function. The first argument passed to rb_raise() is the exception type. You can raise a custom exception type or one of the built-in Ruby exception types.

      -

      36.6.4 Exception classes

      +

      38.6.4 Exception classes

      Starting with SWIG 1.3.28, the Ruby module supports the %exceptionclass @@ -2277,7 +2310,7 @@ end

      For another example look at swig/Examples/ruby/exception_class.

      -

      36.7 Typemaps

      +

      38.7 Typemaps

      This section describes how you can modify SWIG's default @@ -2292,7 +2325,7 @@ a required part of using SWIG---the default wrapping behavior is enough in most cases. Typemaps are only used if you want to change some aspect of the primitive C-Ruby interface.

      -

      36.7.1 What is a typemap?

      +

      38.7.1 What is a typemap?

      A typemap is nothing more than a code generation rule that is @@ -2449,7 +2482,7 @@ to be used as follows (notice how the length parameter is omitted):

      2 -

      36.7.2 Typemap scope

      +

      38.7.2 Typemap scope

      Once defined, a typemap remains in effect for all of the @@ -2495,7 +2528,7 @@ where the class itself is defined. For example:

      }; -

      36.7.3 Copying a typemap

      +

      38.7.3 Copying a typemap

      A typemap is copied by using assignment. For example:

      @@ -2537,7 +2570,7 @@ rules as for %apply (char *buf, int len) { (char *buffer, int size) }; // Multiple arguments -

      36.7.4 Deleting a typemap

      +

      38.7.4 Deleting a typemap

      A typemap can be deleted by simply defining no code. For @@ -2562,7 +2595,7 @@ defined by typemaps, clearing a fundamental type like int will make that type unusable unless you also define a new set of typemaps immediately after the clear operation.

      -

      36.7.5 Placement of typemaps

      +

      38.7.5 Placement of typemaps

      Typemap declarations can be declared in the global scope, @@ -2633,13 +2666,13 @@ In this example, this is done using the class declaration class string .

      -

      36.7.6 Ruby typemaps

      +

      38.7.6 Ruby typemaps

      The following list details all of the typemap methods that can be used by the Ruby module:

      -

      36.7.6.1 "in" typemap

      +

      38.7.6.1 "in" typemap

      Converts Ruby objects to input @@ -2706,7 +2739,7 @@ arguments to be specified. For example:

      At this time, only zero or one arguments may be converted.

      -

      36.7.6.2 "typecheck" typemap

      +

      38.7.6.2 "typecheck" typemap

      The "typecheck" typemap is used to support overloaded @@ -2728,7 +2761,7 @@ program uses overloaded methods, you should also define a collection of "typecheck" typemaps. More details about this follow in a later section on "Typemaps and Overloading."

      -

      36.7.6.3 "out" typemap

      +

      38.7.6.3 "out" typemap

      Converts return value of a C function @@ -2779,7 +2812,7 @@ version of the C datatype matched by the typemap.

      -

      36.7.6.4 "arginit" typemap

      +

      38.7.6.4 "arginit" typemap

      The "arginit" typemap is used to set the initial value of a @@ -2794,7 +2827,7 @@ applications. For example:

      } -

      36.7.6.5 "default" typemap

      +

      38.7.6.5 "default" typemap

      The "default" typemap is used to turn an argument into a @@ -2815,11 +2848,11 @@ not support optional arguments, such as Java and C#, effectively ignore the value specified by this typemap as all arguments must be given.

      Once a default typemap has been applied to an argument, all -arguments that follow must have default values. See the +arguments that follow must have default values. See the Default/optional arguments section for further information on default argument wrapping.

      -

      36.7.6.6 "check" typemap

      +

      38.7.6.6 "check" typemap

      The "check" typemap is used to supply value checking code @@ -2834,7 +2867,7 @@ arguments have been converted. For example:

      } -

      36.7.6.7 "argout" typemap

      +

      38.7.6.7 "argout" typemap

      The "argout" typemap is used to return values from arguments. @@ -2888,7 +2921,7 @@ some function like SWIG_Ruby_AppendOutput.

      See the typemaps.i library for examples.

      -

      36.7.6.8 "freearg" typemap

      +

      38.7.6.8 "freearg" typemap

      The "freearg" typemap is used to cleanup argument data. It is @@ -2915,7 +2948,7 @@ This code is also placed into a special variable $cleanup that may be used in other typemaps whenever a wrapper function needs to abort prematurely.

      -

      36.7.6.9 "newfree" typemap

      +

      38.7.6.9 "newfree" typemap

      The "newfree" typemap is used in conjunction with the %newobject @@ -2939,7 +2972,7 @@ string *foo();

      See Object ownership and %newobject for further details.

      -

      36.7.6.10 "memberin" typemap

      +

      38.7.6.10 "memberin" typemap

      The "memberin" typemap is used to copy data from an @@ -2957,21 +2990,21 @@ example:

      already provides a default implementation for arrays, strings, and other objects.

      -

      36.7.6.11 "varin" typemap

      +

      38.7.6.11 "varin" typemap

      The "varin" typemap is used to convert objects in the target language to C for the purposes of assigning to a C/C++ global variable. This is implementation specific.

      -

      36.7.6.12 "varout" typemap

      +

      38.7.6.12 "varout" typemap

      The "varout" typemap is used to convert a C/C++ object to an object in the target language when reading a C/C++ global variable. This is implementation specific.

      -

      36.7.6.13 "throws" typemap

      +

      38.7.6.13 "throws" typemap

      The "throws" typemap is only used when SWIG parses a C++ @@ -3009,10 +3042,10 @@ catch(char const *_e) {

      Note that if your methods do not have an exception specification yet they do throw exceptions, SWIG cannot know how to -deal with them. For a neat way to handle these, see the Exception +deal with them. For a neat way to handle these, see the Exception handling with %exception section.

      -

      36.7.6.14 directorin typemap

      +

      38.7.6.14 directorin typemap

      Converts C++ objects in director @@ -3071,7 +3104,7 @@ referring to the class itself. -

      36.7.6.15 directorout typemap

      +

      38.7.6.15 directorout typemap

      Converts Ruby objects in director @@ -3144,7 +3177,7 @@ exception.

      -

      36.7.6.16 directorargout typemap

      +

      38.7.6.16 directorargout typemap

      Output argument processing in director @@ -3202,19 +3235,19 @@ referring to the instance of the class itself -

      36.7.6.17 ret typemap

      +

      38.7.6.17 ret typemap

      Cleanup of function return values

      -

      36.7.6.18 globalin typemap

      +

      38.7.6.18 globalin typemap

      Setting of C global variables

      -

      36.7.7 Typemap variables

      +

      38.7.7 Typemap variables

      @@ -3264,7 +3297,7 @@ so that their values can be properly assigned.

      The Ruby name of the wrapper function being created.
      -

      36.7.8 Useful Functions

      +

      38.7.8 Useful Functions

      When you write a typemap, you usually have to work directly @@ -3279,7 +3312,7 @@ stick to the swig functions instead of the native Ruby functions. That should help you avoid having to rewrite a lot of typemaps across multiple languages.

      -

      36.7.8.1 C Datatypes to Ruby Objects

      +

      38.7.8.1 C Datatypes to Ruby Objects

      @@ -3321,7 +3354,7 @@ SWIG_From_float(float)
      -

      36.7.8.2 Ruby Objects to C Datatypes

      +

      38.7.8.2 Ruby Objects to C Datatypes

      Here, while the Ruby versions return the value directly, the SWIG @@ -3389,7 +3422,7 @@ versions do not, but return a status value to indicate success (SWIG_OK -

      36.7.8.3 Macros for VALUE

      +

      38.7.8.3 Macros for VALUE

      RSTRING_LEN(str)

      @@ -3412,7 +3445,7 @@ versions do not, but return a status value to indicate success (SWIG_OK
      pointer to array storage
      -

      36.7.8.4 Exceptions

      +

      38.7.8.4 Exceptions

      void rb_raise(VALUE exception, const char *fmt, @@ -3491,7 +3524,7 @@ message to standard error if Ruby was invoked with the -w flag. The given format string fmt and remaining arguments are interpreted as with printf(). -

      36.7.8.5 Iterators

      +

      38.7.8.5 Iterators

      void rb_iter_break()

      @@ -3537,14 +3570,14 @@ VALUE), VALUE value)

      Equivalent to Ruby's throw.
      -

      36.7.9 Typemap Examples

      +

      38.7.9 Typemap Examples

      This section includes a few examples of typemaps. For more examples, you might look at the examples in the Example/ruby directory.

      -

      36.7.10 Converting a Ruby array to a char **

      +

      38.7.10 Converting a Ruby array to a char **

      A common problem in many C programs is the processing of @@ -3609,7 +3642,7 @@ array. Since dynamic memory allocation is used to allocate memory for the array, the "freearg" typemap is used to later release this memory after the execution of the C function.

      -

      36.7.11 Collecting arguments in a hash

      +

      38.7.11 Collecting arguments in a hash

      Ruby's solution to the "keyword arguments" capability of some @@ -3823,7 +3856,7 @@ memory leak. Fortunately, this typemap is a lot easier to write:

      program that uses the extension, can be found in the Examples/ruby/hashargs directory of the SWIG distribution.

      -

      36.7.12 Pointer handling

      +

      38.7.12 Pointer handling

      Occasionally, it might be necessary to convert pointer values @@ -3882,7 +3915,7 @@ For example:

      } -

      36.7.12.1 Ruby Datatype Wrapping

      +

      38.7.12.1 Ruby Datatype Wrapping

      VALUE Data_Wrap_Struct(VALUE class, void @@ -3909,7 +3942,7 @@ as above. type c-type from the data object obj and assigns that pointer to ptr. -

      36.7.13 Example: STL Vector to Ruby Array

      +

      38.7.13 Example: STL Vector to Ruby Array

      Another use for macros and type maps is to create a Ruby array @@ -4001,7 +4034,7 @@ STL with ruby, you are advised to use the standard swig STL library, which does much more than this. Refer to the section called the C++ Standard Template Library. -

      36.8 Docstring Features

      +

      38.8 Docstring Features

      @@ -4035,7 +4068,7 @@ generate ri documentation from a c wrap file, you could do:

      $ rdoc -r file_wrap.c -

      36.8.1 Module docstring

      +

      38.8.1 Module docstring

      @@ -4065,7 +4098,7 @@ layout of controls on a panel, etc. to be loaded from an XML file." %module(docstring=DOCSTRING) xrc -

      36.8.2 %feature("autodoc")

      +

      38.8.2 %feature("autodoc")

      Since SWIG does know everything about the function it wraps, @@ -4086,7 +4119,7 @@ several options for autodoc controlled by the value given to the feature, described below.

      -

      36.8.2.1 %feature("autodoc", "0")

      +

      38.8.2.1 %feature("autodoc", "0")

      @@ -4110,7 +4143,7 @@ Then Ruby code like this will be generated: ... -

      36.8.2.2 %feature("autodoc", "1")

      +

      38.8.2.2 %feature("autodoc", "1")

      @@ -4130,7 +4163,7 @@ this: ... -

      36.8.2.3 %feature("autodoc", "2")

      +

      38.8.2.3 %feature("autodoc", "2")

      @@ -4142,7 +4175,7 @@ parameter types with the "2" option will result in Ruby code like this:

      -

      36.8.2.4 %feature("autodoc", "3")

      +

      38.8.2.4 %feature("autodoc", "3")

      @@ -4157,13 +4190,13 @@ this:

      function_name(int x, int y, Foo foo=nil, Bar bar=nil) -> bool
       
       Parameters:
      -	x - int
      -	y - int
      -	foo - Foo
      -	bar - Bar
      + x - int + y - int + foo - Foo + bar - Bar -

      36.8.2.5 %feature("autodoc", "docstring")

      +

      38.8.2.5 %feature("autodoc", "docstring")

      @@ -4179,7 +4212,7 @@ generated string. For example: void GetPosition(int* OUTPUT, int* OUTPUT); -

      36.8.3 %feature("docstring")

      +

      38.8.3 %feature("docstring")

      @@ -4190,10 +4223,10 @@ docstring associated with classes, function or methods are output. If an item already has an autodoc string then it is combined with the docstring and they are output together.

      -

      36.9 Advanced Topics

      +

      38.9 Advanced Topics

      -

      36.9.1 Operator overloading

      +

      38.9.1 Operator overloading

      SWIG allows operator overloading with, by using the %extend @@ -4374,7 +4407,7 @@ separate method for handling inequality since Ruby parses the expression a != b as !(a == b).

      -

      36.9.2 Creating Multi-Module Packages

      +

      38.9.2 Creating Multi-Module Packages

      The chapter on Working @@ -4458,7 +4491,7 @@ and then type make to build the shared library:

      $ ruby extconf.rb
       creating Makefile
       $ make
      -g++ -fPIC -g -O2 -I. -I/usr/local/lib/ruby/1.7/i686-linux \
      +g++ -fPIC -g -O2 -I. -I/usr/include/ruby-2.1.0 \
       -I. -c shape_wrap.cxx
       gcc -shared -L/usr/local/lib -o shape.so shape_wrap.o -L. \
       -lruby -lruby -lc
      @@ -4500,7 +4533,7 @@ irb(main):005:0> c.getX() 5.0 -

      36.9.3 Specifying Mixin Modules

      +

      38.9.3 Specifying Mixin Modules

      The Ruby language doesn't support multiple inheritance, but @@ -4567,7 +4600,7 @@ matching rules used for other kinds of features apply (see the chapter on "Customization Features") for more details).

      -

      36.10 Memory Management

      +

      38.10 Memory Management

      One of the most common issues in generating SWIG bindings for @@ -4590,7 +4623,7 @@ to C++ (or vice versa) depending on what function or methods are invoked. Clearly, developing a SWIG wrapper requires a thorough understanding of how the underlying library manages memory.

      -

      36.10.1 Mark and Sweep Garbage Collector

      +

      38.10.1 Mark and Sweep Garbage Collector

      Ruby uses a mark and sweep garbage collector. When the garbage @@ -4604,8 +4637,7 @@ objects that have already been marked). Those objects, in turn, may reference other objects. This process will continue until all active objects have been "marked." After the mark phase comes the sweep phase. In the sweep phase, all objects that have not been marked will be -garbage collected. For more information about the Ruby garbage -collector please refer to http://rubygarden.org/ruby/ruby?GCAndExtensions.

      +garbage collected.

      The Ruby C/API provides extension developers two hooks into the garbage collector - a "mark" function and a "sweep" function. By @@ -4622,7 +4654,7 @@ any memory has been allocated in creating the underlying C struct or C++ struct, then a "free" function must be defined that deallocates this memory.

      -

      36.10.2 Object Ownership

      +

      38.10.2 Object Ownership

      As described above, memory management depends on clearly @@ -4682,7 +4714,7 @@ public: C++ constructor, thus creating a new foo object. By default, SWIG will assign the new Ruby object a "free" function. When the Ruby object is garbage collected, the "free" function will be -called. It in turn will call Foo's destructor.

      +called. It in turn will call Foo's destructor.

      Next, consider this code:

      @@ -4767,7 +4799,7 @@ public:

      This code can be seen in swig/examples/ruby/tracking.

      -

      36.10.3 Object Tracking

      +

      38.10.3 Object Tracking

      The remaining parts of this section will use the class library @@ -4804,7 +4836,7 @@ public: class Zoo { protected: - std::vector<animal *=""> animals; + std::vector<Animal *> animals; public: // Construct an empty zoo @@ -4927,7 +4959,8 @@ class-by-class basis if needed. To fix the example above:

      /* Tell SWIG that create_animal creates a new object */ %newobject Zoo::create_animal; -/* Tell SWIG to keep track of mappings between C/C++ structs/classes. */%trackobjects; +/* Tell SWIG to keep track of mappings between C/C++ structs/classes. */ +%trackobjects; %include "example.h" @@ -4989,10 +5022,10 @@ object from its underlying C++ object.

      In general, you will only need to use the SWIG_RubyInstanceFor, which is required for implementing mark functions as shown below. However, if you implement your own free functions (see below) you may -also have to call the SWIG_RubyRemoveTracking and RubyUnlinkObjects +also have to call the SWIG_RubyRemoveTracking and RubyUnlinkObjects methods.

      -

      36.10.4 Mark Functions

      +

      38.10.4 Mark Functions

      With a bit more testing, we see that our class library still @@ -5087,7 +5120,7 @@ static void mark_Zoo(void* ptr) {

      Note the mark function is dependent on the SWIG_RUBY_InstanceFor method, and thus requires that %trackobjects is enabled. For more -information, please refer to the track_object.i test case in the SWIG +information, please refer to the ruby_track_objects.i test case in the SWIG test suite.

      When this code is compiled we now see:

      @@ -5121,7 +5154,7 @@ irb(main):016:0>

      This code can be seen in swig/examples/ruby/mark_function.

      -

      36.10.5 Free Functions

      +

      38.10.5 Free Functions

      By default, SWIG creates a "free" function that is called when @@ -5154,21 +5187,23 @@ above.

      To show how to use the %freefunc directive, let's slightly change our example. Assume that the zoo -object is responsible for freeing animal that it contains. This means +object is responsible for freeing any animal that it contains. This means that the Zoo::add_animal function should be marked with a DISOWN typemap and the destructor should be updated as below:

      -
      Zoo::~Zoo() {
      - IterType iter = this->animals.begin();
      - IterType end = this->animals.end();
      -
      - for(iter; iter != end; ++iter) {
      - Animal* animal = *iter;
      - delete animal;
      - }
      -}
      +
      +Zoo::~Zoo() {
      +  IterType iter = this->animals.begin();
      +  IterType end = this->animals.end();
      + 
      +  for(iter; iter != end; ++iter) {
      +    Animal* animal = *iter;
      +    delete animal;
      +  }
      +}
      +

      When we use these objects in IRB we see:

      @@ -5216,8 +5251,7 @@ existing Ruby object to the destroyed C++ object and raise an exception. #include "example.h" %} -/* Specify that ownership is transferred to the zoo - when calling add_animal */ +/* Specify that ownership is transferred to the zoo when calling add_animal */ %apply SWIGTYPE *DISOWN { Animal* animal }; /* Track objects */ @@ -5288,7 +5322,7 @@ been freed, and thus raises a runtime exception.

      This code can be seen in swig/examples/ruby/free_function.

      -

      36.10.6 Embedded Ruby and the C++ Stack

      +

      38.10.6 Embedded Ruby and the C++ Stack

      As has been said, the Ruby GC runs and marks objects before @@ -5343,7 +5377,7 @@ used for callbacks, for example.

      To solve the problem, SWIG can now generate code with director functions containing the optional macros SWIG_INIT_STACK and SWIG_RELEASE_STACK. These macros will try to force Ruby to -reinitiliaze the beginning of the stack the first time a +reinitialize the beginning of the stack the first time a director function is called. This will lead Ruby to measure and not collect any VALUE objects defined from that point on.

      diff --git a/Doc/Manual/SWIG.html b/Doc/Manual/SWIG.html index 25dc899..bf1705d 100644 --- a/Doc/Manual/SWIG.html +++ b/Doc/Manual/SWIG.html @@ -1,12 +1,13 @@ - + SWIG Basics + -

      5 SWIG Basics

      +

      5 SWIG Basics

    • Pointers and complex objects
        @@ -40,7 +41,7 @@
      • Passing structures by value
      • Return by value
      • Linking to structure variables -
      • Linking to char * +
      • Linking to char *
      • Arrays
      • Creating read-only variables
      • Renaming and ignoring declarations @@ -94,7 +95,7 @@ Specific details about each target language are described in later chapters.

        -

        5.1 Running SWIG

        +

        5.1 Running SWIG

        @@ -110,7 +111,7 @@ where filename is a SWIG interface file or a C/C++ header file. Below is a subset of options that can be used. Additional options are also defined for each target language. A full list can be obtained by typing swig -help or swig --lang -help. +-<lang> -help for language <lang> specific options.

        @@ -119,25 +120,31 @@ can be obtained by typing swig -help or swig
         -clisp                Generate CLISP wrappers
         -cffi                 Generate CFFI wrappers
         -csharp               Generate C# wrappers
        +-d                    Generate D wrappers
         -go                   Generate Go wrappers
         -guile                Generate Guile wrappers
         -java                 Generate Java wrappers
        +-javascript           Generate Javascript wrappers
         -lua                  Generate Lua wrappers
         -modula3              Generate Modula 3 wrappers
         -mzscheme             Generate Mzscheme wrappers
         -ocaml                Generate Ocaml wrappers
        +-octave               Generate Octave wrappers
         -perl                 Generate Perl wrappers
         -php                  Generate PHP wrappers
         -pike                 Generate Pike wrappers
         -python               Generate Python wrappers
         -r                    Generate R (aka GNU S) wrappers
         -ruby                 Generate Ruby wrappers
        +-scilab               Generate Scilab wrappers
         -sexp                 Generate Lisp S-Expressions wrappers
         -tcl                  Generate Tcl wrappers
         -uffi                 Generate Common Lisp / UFFI wrappers
         -xml                  Generate XML wrappers
         
         -c++                  Enable C++ parsing
        +-cppext ext           Change file extension of C++ generated files to ext
        +                      (default is cxx, except for PHP which uses cpp)
         -Dsymbol              Define a preprocessor symbol
         -Fstandard            Display error/warning messages in commonly used format
         -Fmicrosoft           Display error/warning messages in Microsoft format
        @@ -145,8 +152,9 @@ can be obtained by typing swig -help or swig
         -Idir                 Add a directory to the file include path
         -lfile                Include a SWIG library file.
         -module name          Set the name of the SWIG module
        --o outfile            Name of output file
        --outcurrentdir	      Set default output dir to current dir instead of input file's path
        +-o outfile            Set name of C/C++ output file to <outfile>
        +-oh headfile          Set name of C++ output header file for directors to <headfile>
        +-outcurrentdir        Set default output dir to current dir instead of input file's path
         -outdir dir           Set language specific files output directory
         -pcreversion          Display PCRE version information
         -swiglib              Show location of SWIG library
        @@ -154,7 +162,7 @@ can be obtained by typing swig -help or swig
         
         
        -

        5.1.1 Input format

        +

        5.1.1 Input format

        @@ -201,7 +209,7 @@ semantics in SWIG is analogous to that of the declarations section used in input files to parser generation tools such as yacc or bison.

        -

        5.1.2 SWIG Output

        +

        5.1.2 SWIG Output

        @@ -211,7 +219,7 @@ additional files depending on the target language. By default, an input file with the name file.i is transformed into a file file_wrap.c or file_wrap.cxx (depending on whether or not the -c++ option has been used). The name of the -output file can be changed using the -o option. In certain +output C/C++ file can be changed using the -o option. In certain cases, file suffixes are used by the compiler to determine the source language (C, C++, etc.). Therefore, you have to use the -o option to change the suffix of the SWIG-generated wrapper @@ -224,7 +232,7 @@ $ swig -c++ -python -o example_wrap.cpp example.i

        The C/C++ output file created by SWIG often -contains everything that is needed to construct a extension module +contains everything that is needed to construct an extension module for the target scripting language. SWIG is not a stub compiler nor is it usually necessary to edit the output file (and if you look at the output, you probably won't want to). To build the final extension module, the @@ -233,7 +241,7 @@ program to create a shared library.

        -Many target languages will also generate proxy class files in the +For many target languages SWIG will also generate proxy class files in the target language. The default output directory for these language specific files is the same directory as the generated C/C++ file. This can be modified using the -outdir option. For example: @@ -258,10 +266,10 @@ this option the default output directory is the path to the input file. If -o and -outcurrentdir are used together, -outcurrentdir is effectively ignored as the output directory for the language files is the same directory as the -generated C/C++ file if not overidden with -outdir. +generated C/C++ file if not overridden with -outdir.

        -

        5.1.3 Comments

        +

        5.1.3 Comments

        @@ -271,7 +279,7 @@ documentation files. However, this feature is currently under repair and will reappear in a later SWIG release.

        -

        5.1.4 C Preprocessor

        +

        5.1.4 C Preprocessor

        @@ -295,7 +303,7 @@ make it more powerful than the normal C preprocessor. These extensions are described in the "Preprocessor" chapter.

        -

        5.1.5 SWIG Directives

        +

        5.1.5 SWIG Directives

        @@ -326,7 +334,7 @@ included in C header files using conditional compilation like this: it is parsing an input file.

        -

        5.1.6 Parser Limitations

        +

        5.1.6 Parser Limitations

        @@ -424,7 +432,7 @@ does not utilize a separate typedef-name terminal symbol as described on p. 234 of K&R).

        -

        5.2 Wrapping Simple C Declarations

        +

        5.2 Wrapping Simple C Declarations

        @@ -484,10 +492,10 @@ Or in Python: Whenever possible, SWIG creates an interface that closely matches the underlying C/C++ code. However, due to subtle differences between languages, run-time environments, and semantics, it is not always possible to do so. The -next few sections describes various aspects of this mapping. +next few sections describe various aspects of this mapping.

        -

        5.2.1 Basic Type Handling

        +

        5.2.1 Basic Type Handling

        @@ -612,7 +620,7 @@ will use the same internal representation (e.g., UCS-2 vs. UCS-4). You may need to write some special conversion functions.

        -

        5.2.2 Global Variables

        +

        5.2.2 Global Variables

        @@ -667,7 +675,7 @@ Earlier versions of SWIG incorrectly handled const and created constants instead.

        -

        5.2.3 Constants

        +

        5.2.3 Constants

        @@ -728,7 +736,7 @@ However, for the same conservative reasons even a constant with a simple cast wi

        -#define F_CONST (double) 5            // A floating pointer constant with cast
        +#define F_CONST (double) 5            // A floating point constant with cast
         
        @@ -750,13 +758,13 @@ enum values as assigned by the C compiler.

        The %constant directive is used to more precisely create constants corresponding to different C datatypes. Although it is not -usually not needed for simple values, it is more useful when working +usually needed for simple values, it is more useful when working with pointers and other more complex datatypes. Typically, %constant is only used when you want to add constants to the scripting language interface that are not defined in the original header file.

        -

        5.2.4 A brief word about const

        +

        5.2.4 A brief word about const

        @@ -858,7 +866,7 @@ const int spam = 42;

    • -

      5.2.5 A cautionary tale of char *

      +

      5.2.5 A cautionary tale of char *

      @@ -868,7 +876,7 @@ from a scripting language to a C char *, the pointer usually points to string data stored inside the interpreter. It is almost always a really bad idea to modify this data. Furthermore, some languages may explicitly disallow it. For instance, in Python, -strings are supposed be immutable. If you violate this, you will probably +strings are supposed to be immutable. If you violate this, you will probably receive a vast amount of wrath when you unleash your module on the world.

      @@ -897,7 +905,7 @@ input values. However, it must be noted that you could change the behavior of using typemaps.

      -

      5.3 Pointers and complex objects

      +

      5.3 Pointers and complex objects

      @@ -905,7 +913,7 @@ Most C programs manipulate arrays, structures, and other types of objects. This discusses the handling of these datatypes.

      -

      5.3.1 Simple pointers

      +

      5.3.1 Simple pointers

      @@ -971,7 +979,7 @@ simplified and less prone to error.

    -

    5.3.2 Run time pointer type checking

    +

    5.3.2 Run time pointer type checking

    @@ -993,7 +1001,7 @@ as sentinel values or to denote a missing/empty value. Therefore, SWIG leaves NULL pointer checking up to the application.

    -

    5.3.3 Derived types, structs, and classes

    +

    5.3.3 Derived types, structs, and classes

    @@ -1034,23 +1042,22 @@ expect :

     # Copy a file 
     def filecopy(source,target):
    -	f1 = fopen(source,"r")
    -	f2 = fopen(target,"w")
    -	buffer = malloc(8192)
    -	nbytes = fread(buffer,8192,1,f1)
    -	while (nbytes > 0):
    -		fwrite(buffer,8192,1,f2)
    -		nbytes = fread(buffer,8192,1,f1)
    -	free(buffer)
    -
    +  f1 = fopen(source,"r")
    +  f2 = fopen(target,"w")
    +  buffer = malloc(8192)
    +  nbytes = fread(buffer,8192,1,f1)
    +  while (nbytes > 0):
    +    fwrite(buffer,8192,1,f2)
    +          nbytes = fread(buffer,8192,1,f1)
    +  free(buffer)
     

    -In this case f1, f2, and buffer are all +In this case f1, f2, and buffer are all opaque objects containing C pointers. It doesn't matter what value they contain--our program works just fine without this knowledge.

    -

    5.3.4 Undefined datatypes

    +

    5.3.4 Undefined datatypes

    @@ -1110,7 +1117,7 @@ The only way to fix this problem is to make sure you properly declare type names -

    5.3.5 Typedef

    +

    5.3.5 Typedef

    @@ -1199,7 +1206,7 @@ The corresponding wrapper function will accept arguments of type unsigned int * or size_t *.

    -

    5.4 Other Practicalities

    +

    5.4 Other Practicalities

    @@ -1209,7 +1216,7 @@ more difficult to map to a scripting language interface. This section describes some of these issues.

    -

    5.4.1 Passing structures by value

    +

    5.4.1 Passing structures by value

    @@ -1240,7 +1247,7 @@ to Vectors instead of Vectors. For the most part, this transformation is transparent so you might not notice.

    -

    5.4.2 Return by value

    +

    5.4.2 Return by value

    @@ -1295,7 +1302,7 @@ don't work correctly if Vector doesn't define a default constructor. The section on SWIG and C++ has more information about this case.

    -

    5.4.3 Linking to structure variables

    +

    5.4.3 Linking to structure variables

    @@ -1312,10 +1319,10 @@ gets mapped to an underlying pair of set/get functions like this :

     Vector *unit_i_get() {
    -	return &unit_i;
    +  return &unit_i;
     }
     void unit_i_set(Vector *value) {
    -	unit_i = *value;
    +  unit_i = *value;
     }
     
    @@ -1327,7 +1334,7 @@ C++ classes must supply a properly defined copy constructor in order for assignment to work correctly.

    -

    5.4.4 Linking to char *

    +

    5.4.4 Linking to char *

    @@ -1456,7 +1463,7 @@ value is not released. -

    5.4.5 Arrays

    +

    5.4.5 Arrays

    @@ -1483,7 +1490,7 @@ void transpose(double (*a)[20]);

    Like C, SWIG does not perform array bounds checking. It is up to the -user to make sure the pointer points a suitably allocated region of memory. +user to make sure the pointer points to a suitably allocated region of memory.

    @@ -1592,7 +1599,7 @@ void pathname_set(char *value) { In the target language, the value can be set like a normal variable.

    -

    5.4.6 Creating read-only variables

    +

    5.4.6 Creating read-only variables

    @@ -1602,11 +1609,11 @@ directive as shown :

     // File : interface.i
     
    -int 	a; 			// Can read/write
    +int a;       // Can read/write
     %immutable;
    -int	b,c,d			// Read only variables
    +int b,c,d;   // Read only variables
     %mutable;
    -double	x,y			// read/write
    +double x,y;  // read/write
     

    @@ -1666,10 +1673,10 @@ generate a warning message. Simply change the directives to %immutable;%mutable; to silence the warning. Don't forget the extra semicolon!

    -

    5.4.7 Renaming and ignoring declarations

    +

    5.4.7 Renaming and ignoring declarations

    -

    5.4.7.1 Simple renaming of specific identifiers

    +

    5.4.7.1 Simple renaming of specific identifiers

    @@ -1711,7 +1718,7 @@ wrapping a header file like this:

    -%rename applies a renaming operation to all future +%rename applies a renaming operation to all future occurrences of a name. The renaming applies to functions, variables, class and structure names, member functions, and member data. For example, if you had two-dozen C++ classes, all with a member function @@ -1767,7 +1774,7 @@ This directive is still supported, but it is deprecated and should probably be a directive is more powerful and better supports wrapping of raw header file information.

    -

    5.4.7.2 Advanced renaming support

    +

    5.4.7.2 Advanced renaming support

    @@ -1882,17 +1889,35 @@ and a more descriptive one, but the two functions are otherwise equivalent: wxPrintPrint + rstrip:[suffix] + String without the given suffix or the original string if it doesn't + end with this suffix. Note that square brackets should be used + literally, e.g. %rename("rstrip:[Cls]") + PrintClsPrint + + regex:/pattern/subst/ String after (Perl-like) regex substitution operation. This function allows to apply arbitrary regular expressions to the identifier names. The pattern part is a regular expression in Perl syntax (as supported by the Perl Compatible Regular Expressions (PCRE)) library and the subst string - can contain back-references introduced by '\' or, as backslashes need - to be escaped in C strings, rather by "\\". For example, to remove - any alphabetic prefix before an underscore you could use the following directive: - %rename("regex:/(\\w+)_(.*)/\\2/") - Prefix_PrintPrint + can contain back-references of the form \N where N is a digit + from 0 to 9, or one of the following escape sequences: \l, \L, + \u, \U or \E. The back-references are replaced with the + contents of the corresponding capture group while the escape sequences perform the + case conversion in the substitution string: \l and \L convert to + the lower case, while \u and \U convert to the upper case. The + difference between the elements of each pair is that \l and \u + change the case of the next character only, while \L and \U do + it for all the remaining characters or until \E is encountered. + + Finally please notice that backslashes need to be escaped in C strings, so in + practice "\\" must be used in all these escape sequences. For example, + to remove any alphabetic prefix before an underscore and capitalize the remaining + part you could use the following directive: + %rename("regex:/(\\w+)_(.*)/\\u\\2/") + prefix_printPrint command:cmd @@ -1958,7 +1983,7 @@ are exactly equivalent and %rename can be used to selectively ignore multiple declarations using the previously described matching possibilities.

    -

    5.4.7.3 Limiting global renaming rules

    +

    5.4.7.3 Limiting global renaming rules

    @@ -2056,7 +2081,7 @@ wrap C++ overloaded functions and methods or C++ methods which use default argum

    -

    5.4.7.4 Ignoring everything then wrapping a few selected symbols

    +

    5.4.7.4 Ignoring everything then wrapping a few selected symbols

    @@ -2098,7 +2123,7 @@ members of the class, so when the chosen class is unignored, all of its methods -

    5.4.8 Default/optional arguments

    +

    5.4.8 Default/optional arguments

    @@ -2115,8 +2140,8 @@ default arguments are optional in the target language. For example, this functio used in Tcl as follows :

    -% plot -3.4 7.5 				# Use default value
    -% plot -3.4 7.5 10				# set color to 10 instead
    +% plot -3.4 7.5    # Use default value
    +% plot -3.4 7.5 10 # set color to 10 instead
     
     
    @@ -2135,7 +2160,7 @@ Please refer to the section on def in the C++ chapter for further details.

    -

    5.4.9 Pointers to functions and callbacks

    +

    5.4.9 Pointers to functions and callbacks

    @@ -2254,7 +2279,7 @@ disabled using %nocallback. When you do this, the interface now works

    Notice that when the function is used as a callback, special names -such as add_cb is used instead. To call the function +such as add_cb are used instead. To call the function normally, just use the original function name such as add().

    @@ -2288,7 +2313,7 @@ See the Typemaps chapter for more about typ and individual target language chapters for more on callbacks and the 'director' feature.

    -

    5.5 Structures and unions

    +

    5.5 Structures and unions

    @@ -2300,13 +2325,13 @@ handle C++ are described in the next section. If SWIG encounters the definition of a structure or union, it creates a set of accessor functions. Although SWIG does not need structure definitions to build an interface, providing definitions -make it possible to access structure members. The accessor functions +makes it possible to access structure members. The accessor functions generated by SWIG simply take a pointer to an object and allow access to an individual member. For example, the declaration :

     struct Vector {
    -	double x,y,z;
    +  double x,y,z;
     }
     
     
    @@ -2316,22 +2341,22 @@ gets transformed into the following set of accessor functions :

     double Vector_x_get(struct Vector *obj) {
    -	return obj->x;
    +  return obj->x;
     }
     double Vector_y_get(struct Vector *obj) { 
    -	return obj->y;
    +  return obj->y;
     }
     double Vector_z_get(struct Vector *obj) { 
    -	return obj->z;
    +  return obj->z;
     }
     void Vector_x_set(struct Vector *obj, double value) {
    -	obj->x = value;
    +  obj->x = value;
     }
     void Vector_y_set(struct Vector *obj, double value) {
    -	obj->y = value;
    +  obj->y = value;
     }
     void Vector_z_set(struct Vector *obj, double value) {
    -	obj->z = value;
    +  obj->z = value;
     }
     
    @@ -2370,7 +2395,7 @@ delete_Vector(v) However, most of SWIG's language modules also provide a high-level interface that is more convenient. Keep reading.

    -

    5.5.1 Typedef and structures

    +

    5.5.1 Typedef and structures

    @@ -2379,7 +2404,7 @@ programs :

     typedef struct {
    -	double x,y,z;
    +  double x,y,z;
     } Vector;
     
     
    @@ -2394,7 +2419,7 @@ that the use of typedef allows SWIG to drop the
     double Vector_x_get(Vector *obj) {
    -	return obj->x;
    +  return obj->x;
     }
     
    @@ -2404,7 +2429,7 @@ If two different names are used like this :

     typedef struct vector_struct {
    -	double x,y,z;
    +  double x,y,z;
     } Vector;
     
     
    @@ -2416,22 +2441,22 @@ vector_struct
    , SWIG knows that this is the same as Vector and it generates the appropriate type-checking code.

    -

    5.5.2 Character strings and structures

    +

    5.5.2 Character strings and structures

    Structures involving character strings require some care. SWIG assumes that all members of type char * have been dynamically allocated using malloc() and that they are NULL-terminated -ASCII strings. When such a member is modified, the previously contents +ASCII strings. When such a member is modified, the previous contents will be released, and the new contents allocated. For example :

     %module mymodule
     ...
     struct Foo {
    -	char *name;
    -	...
    +  char *name;
    +  ...
     }
     
     
    @@ -2441,14 +2466,15 @@ This results in the following accessor functions :

     char *Foo_name_get(Foo *obj) {
    -	return Foo->name;
    +  return Foo->name;
     }
     
     char *Foo_name_set(Foo *obj, char *c) {
    -	if (obj->name) free(obj->name);
    -	obj->name = (char *) malloc(strlen(c)+1);
    -	strcpy(obj->name,c);
    -	return obj->name;
    +  if (obj->name)
    +    free(obj->name);
    +  obj->name = (char *) malloc(strlen(c)+1);
    +  strcpy(obj->name,c);
    +  return obj->name;
     }
     
    @@ -2463,7 +2489,7 @@ Note: If the -c++ option is used, new and delete are perform memory allocation.

    -

    5.5.3 Array members

    +

    5.5.3 Array members

    @@ -2485,7 +2511,7 @@ discussed in a later chapter. In many cases, the warning message is harmless.

    -

    5.5.4 Structure data members

    +

    5.5.4 Structure data members

    @@ -2508,7 +2534,7 @@ typedef struct Bar {

    When a structure member is wrapped, it is handled as a pointer, unless the %naturalvar directive is used where it is handled more like a C++ reference (see C++ Member data). -The accessors to the member variable as a pointer is effectively wrapped as follows: +The accessors to the member variable as a pointer are effectively wrapped as follows:

    @@ -2591,7 +2617,7 @@ class, or union. This is unlikely to break existing code. However, if you need datatype is really a struct, simply use a forward struct declaration such as "struct Foo;".

    -

    5.5.5 C constructors and destructors

    +

    5.5.5 C constructors and destructors

    @@ -2645,8 +2671,8 @@ struct Bar { // Default constructor generated.

    -Since ignoring the implicit or default destructors most of the times -produce memory leaks, SWIG will always try to generate them. If +Since ignoring the implicit or default destructors most of the time +produces memory leaks, SWIG will always try to generate them. If needed, however, you can selectively disable the generation of the default/implicit destructor by using %nodefaultdtor

    @@ -2676,11 +2702,11 @@ has now been enabled as the default behavior. Note: There are also the -nodefault option and %nodefault directive, which disable both the default or implicit destructor generation. This could lead to memory leaks across -the target languages, and is highly recommended you don't use them. +the target languages, and it is highly recommended you don't use them.

    -

    5.5.6 Adding member functions to C structures

    +

    5.5.6 Adding member functions to C structures

    @@ -2700,7 +2726,7 @@ the following declaration :

    /* file : vector.h */ ... typedef struct Vector { - double x,y,z; + double x,y,z; } Vector;
    @@ -2718,23 +2744,23 @@ You can make a Vector look a lot like a class by writing a SWIG interfa %include "vector.h" // Just grab original C header file %extend Vector { // Attach these functions to struct Vector - Vector(double x, double y, double z) { - Vector *v; - v = (Vector *) malloc(sizeof(Vector)); - v->x = x; - v->y = y; - v->z = z; - return v; - } - ~Vector() { - free($self); - } - double magnitude() { - return sqrt($self->x*$self->x+$self->y*$self->y+$self->z*$self->z); - } - void print() { - printf("Vector [%g, %g, %g]\n", $self->x,$self->y,$self->z); - } + Vector(double x, double y, double z) { + Vector *v; + v = (Vector *) malloc(sizeof(Vector)); + v->x = x; + v->y = y; + v->z = z; + return v; + } + ~Vector() { + free($self); + } + double magnitude() { + return sqrt($self->x*$self->x+$self->y*$self->y+$self->z*$self->z); + } + void print() { + printf("Vector [%g, %g, %g]\n", $self->x,$self->y,$self->z); + } }; @@ -2773,12 +2799,12 @@ of the Vector structure. For example:

    %} typedef struct Vector { - double x,y,z; - %extend { - Vector(double x, double y, double z) { ... } - ~Vector() { ... } - ... - } + double x,y,z; + %extend { + Vector(double x, double y, double z) { ... } + ~Vector() { ... } + ... + } } Vector; @@ -2792,19 +2818,19 @@ example :

    /* Vector methods */ #include "vector.h" Vector *new_Vector(double x, double y, double z) { - Vector *v; - v = (Vector *) malloc(sizeof(Vector)); - v->x = x; - v->y = y; - v->z = z; - return v; + Vector *v; + v = (Vector *) malloc(sizeof(Vector)); + v->x = x; + v->y = y; + v->z = z; + return v; } void delete_Vector(Vector *v) { - free(v); + free(v); } double Vector_magnitude(Vector *v) { - return sqrt(v->x*v->x+v->y*v->y+v->z*v->z); + return sqrt(v->x*v->x+v->y*v->y+v->z*v->z); } // File : vector.i @@ -2815,13 +2841,13 @@ double Vector_magnitude(Vector *v) { %} typedef struct Vector { - double x,y,z; - %extend { - Vector(int,int,int); // This calls new_Vector() - ~Vector(); // This calls delete_Vector() - double magnitude(); // This will call Vector_magnitude() - ... - } + double x,y,z; + %extend { + Vector(int,int,int); // This calls new_Vector() + ~Vector(); // This calls delete_Vector() + double magnitude(); // This will call Vector_magnitude() + ... + } } Vector; @@ -2833,13 +2859,13 @@ For example:
     typedef struct Integer {
    -	int value;
    +  int value;
     } Int;
     %extend Integer { ...  } /* Correct name */
     %extend Int { ...  } /* Incorrect name */
     
     struct Float {
    -	float value;
    +  float value;
     };
     typedef struct Float FloatValue;
     %extend Float { ...  } /* Correct name */
    @@ -2852,7 +2878,7 @@ There is one exception to this rule and that is when the struct is anonymously n
     
     
     typedef struct {
    -	double value;
    +  double value;
     } Double;
     %extend Double { ...  } /* Okay */
     
    @@ -2953,7 +2979,7 @@ be used to extend a structure with more than just methods, a more suitable directive name has been chosen.

    -

    5.5.7 Nested structures

    +

    5.5.7 Nested structures

    @@ -2961,13 +2987,13 @@ Occasionally, a C program will involve structures like this :

     typedef struct Object {
    -	int objtype;
    -	union {
    -		int 	ivalue;
    -		double	dvalue;
    -		char	*strvalue;
    -		void	*ptrvalue;
    -	} intRep;
    +  int objtype;
    +  union {
    +    int ivalue;
    +    double dvalue;
    +    char *strvalue;
    +    void *ptrvalue;
    +  } intRep;
     } Object;
     
     
    @@ -2979,15 +3005,15 @@ following:

     typedef union {
    -	int 		ivalue;
    -	double		dvalue;
    -	char		*strvalue;
    -	void		*ptrvalue;
    +  int ivalue;
    +  double dvalue;
    +  char *strvalue;
    +  void *ptrvalue;
     } Object_intRep;
     
     typedef struct Object {
    -	int objType;
    -	Object_intRep intRep;
    +  int objType;
    +  Object_intRep intRep;
     } Object;
     
     
    @@ -2999,16 +3025,16 @@ structures. In this case, functions like this would be created :

     Object_intRep *Object_intRep_get(Object *o) {
    -	return (Object_intRep *) &o->intRep;
    +  return (Object_intRep *) &o->intRep;
     }
     int Object_intRep_ivalue_get(Object_intRep *o) {
    -	return o->ivalue;
    +  return o->ivalue;
     }
     int Object_intRep_ivalue_set(Object_intRep *o, int value) {
    -	return (o->ivalue = value);
    +  return (o->ivalue = value);
     }
     double Object_intRep_dvalue_get(Object_intRep *o) {
    -	return o->dvalue;
    +  return o->dvalue;
     }
     ... etc ...
     
    @@ -3037,7 +3063,7 @@ Finally, note that nesting is handled differently in C++ mode,
     see Nested classes.
     

    -

    5.5.8 Other things to note about structure wrapping

    +

    5.5.8 Other things to note about structure wrapping

    @@ -3099,7 +3125,7 @@ interface described here, most of SWIG's language modules use it in some way or another.

    -

    5.6 Code Insertion

    +

    5.6 Code Insertion

    @@ -3109,7 +3135,7 @@ additional C code to perform initialization or other operations. There are four common ways to insert code, but it's useful to know how the output of SWIG is structured first.

    -

    5.6.1 The output of SWIG

    +

    5.6.1 The output of SWIG

    @@ -3145,7 +3171,7 @@ the module upon loading. -

    5.6.2 Code insertion blocks

    +

    5.6.2 Code insertion blocks

    @@ -3215,7 +3241,7 @@ program. For example :

    %{ /* Create a new vector */ static Vector *new_Vector() { - return (Vector *) malloc(sizeof(Vector)); + return (Vector *) malloc(sizeof(Vector)); } %} @@ -3223,7 +3249,7 @@ static Vector *new_Vector() { Vector *new_Vector();
    -

    5.6.3 Inlined code blocks

    +

    5.6.3 Inlined code blocks

    @@ -3235,7 +3261,7 @@ there is a special inlined form of code block that is used as follows %inline %{ /* Create a new vector */ Vector *new_Vector() { - return (Vector *) malloc(sizeof(Vector)); + return (Vector *) malloc(sizeof(Vector)); } %} @@ -3250,7 +3276,7 @@ declaration. Since the code inside an %inline %{ ... %} block is given to both the C compiler and SWIG, it is illegal to include any SWIG directives inside a %{ ... %} block.

    -

    5.6.4 Initialization blocks

    +

    5.6.4 Initialization blocks

    @@ -3261,19 +3287,19 @@ initialization on module loading, you could write this:

     %init %{
    -	init_variables();
    +  init_variables();
     %}
     
    -

    5.7 An Interface Building Strategy

    +

    5.7 An Interface Building Strategy

    -This section describes the general approach for building interface +This section describes the general approach for building interfaces with SWIG. The specifics related to a particular scripting language are found in later chapters.

    -

    5.7.1 Preparing a C program for SWIG

    +

    5.7.1 Preparing a C program for SWIG

    @@ -3284,9 +3310,9 @@ of steps you can follow to make an interface for a C program :

    • Identify the functions that you want to wrap. It's probably not -necessary to access every single function in a C program--thus, a +necessary to access every single function of a C program--thus, a little forethought can dramatically simplify the resulting scripting -language interface. C header files are particularly good source for +language interface. C header files are a particularly good source for finding things to wrap.
    • Create a new interface file to describe the scripting language @@ -3305,7 +3331,7 @@ Most importantly, define a type before it is used! A C compiler will tell you if the full type information is not available if it is needed, whereas SWIG will usually not warn or error out as it is designed to work without full type information. However, if type information is not specified -correctly, the wrappers can be sub-optimal and even result in uncompileable C/C++ code. +correctly, the wrappers can be sub-optimal and even result in uncompilable C/C++ code.
    • If your program has a main() function, you may need to rename it (read on). @@ -3327,11 +3353,11 @@ to the swig-devel mailing list or to SWIG bug tracker.

      -

      5.7.2 The SWIG interface file

      +

      5.7.2 The SWIG interface file

      -The preferred method of using SWIG is to generate separate interface +The preferred method of using SWIG is to generate a separate interface file. Suppose you have the following C header file :

      @@ -3380,7 +3406,7 @@ The main advantage of this approach is minimal maintenance of an interface file
       In more complex projects, an interface file containing numerous %include and #include statements like this is one of the most common approaches to interface file design due to lower maintenance overhead.
       

      -

      5.7.3 Why use separate interface files?

      +

      5.7.3 Why use separate interface files?

      @@ -3409,7 +3435,7 @@ and immediately see what is available without having to dig it out of header files.

    -

    5.7.4 Getting the right header files

    +

    5.7.4 Getting the right header files

    @@ -3425,11 +3451,11 @@ include certain header files by using a %{,%} block like this: #include <GL/glu.h> %} -// Put rest of declarations here +// Put the rest of the declarations here ...

    -

    5.7.5 What to do with main()

    +

    5.7.5 What to do with main()

    @@ -3467,7 +3493,7 @@ program that is more interactive. In many cases, the old or Tcl script.

    -Note: If some cases, you might be inclined to create a +Note: In some cases, you might be inclined to create a scripting language wrapper for main(). If you do this, the compilation will probably work and your module might even load correctly. The only trouble is that when you call your diff --git a/Doc/Manual/SWIGDocumentation.html b/Doc/Manual/SWIGDocumentation.html index 369663d..597581c 100644 --- a/Doc/Manual/SWIGDocumentation.html +++ b/Doc/Manual/SWIGDocumentation.html @@ -1,9 +1,10 @@ -SWIG-2.0 Documentation +SWIG-3.0 Documentation -

    SWIG-2.0 Documentation
    -

    SWIG-2.0 Documentation


    +
    SWIG-3.0 Documentation
    +

    SWIG-3.0 Documentation



    Table of Contents


    -
    SWIG-2.0 Documentation +
    SWIG-3.0 Documentation @@ -390,1603 +390,1936 @@ PRE { font-family: monospace }
  • 6.29 Where to go for more information
  • -7 Preprocessing - -

    2.1 What is SWIG?

    +

    2.1 What is SWIG?

    SWIG is a software development tool that simplifies the task of interfacing different languages to C and C++ programs. In a nutshell, SWIG is a compiler that takes C/C++ declarations and creates the wrappers needed to access those declarations from other languages - including including Perl, Python, Tcl, Ruby, Guile, and Java. SWIG - normally requires no modifications to existing code and can often be - used to build a usable interface in only a few minutes. Possible - applications of SWIG include:

    + including Perl, Python, Tcl, Ruby, Guile, and Java. SWIG normally + requires no modifications to existing code and can often be used to + build a usable interface in only a few minutes. Possible applications + of SWIG include:

    • Building interpreted interfaces to existing C programs.
    • Rapid prototyping and application development.
    • Interactive debugging.
    • -
    • Reengineering or refactoring of legacy software into a scripting +
    • Reengineering or refactoring of legacy software into scripting language components.
    • Making a graphical user interface (using Tk for example).
    • Testing of C libraries and programs (using scripts).
    • @@ -2402,7 +2743,7 @@ http://developer.apple.com/documentation/ReleaseNotes/DeveloperTools/TwoLevelNam research and development work that is commonly found in scientific and engineering projects. However, nowadays SWIG is known to be used in many large open source and commercial projects.

      -

      2.2 Why use SWIG?

      +

      2.2 Why use SWIG?

      As stated in the previous section, the primary purpose of SWIG is to simplify the task of integrating C/C++ with other programming languages. However, why would anyone want to do that? To answer that @@ -2421,7 +2762,7 @@ http://developer.apple.com/documentation/ReleaseNotes/DeveloperTools/TwoLevelNam

    • Testing is time consuming (the compile/debug cycle).
    • Not easy to reconfigure or customize without recompilation.
    • Modularization can be tricky.
    • -
    • Security concerns (buffer overflow for instance).
    • +
    • Security concerns (buffer overflows for instance).

    To address these limitations, many programmers have arrived at the conclusion that it is much easier to use different programming @@ -2457,7 +2798,7 @@ http://developer.apple.com/documentation/ReleaseNotes/DeveloperTools/TwoLevelNam Therefore, it provides a wide variety of customization features that let you change almost every aspect of the language bindings. This is the main reason why SWIG has such a large user manual ;-).

    -

    2.3 A SWIG example

    +

    2.3 A SWIG example

    The best way to illustrate SWIG is with a simple example. Consider the following C code:

    @@ -2467,14 +2808,16 @@ http://developer.apple.com/documentation/ReleaseNotes/DeveloperTools/TwoLevelNam double My_variable = 3.0; /* Compute factorial of n */ -int fact(int n) { - if (n <= 1) return 1; - else return n*fact(n-1); +int fact(int n) { + if (n <= 1) + return 1; + else + return n*fact(n-1); } /* Compute n mod m */ int my_mod(int n, int m) { - return(n % m); + return(n % m); }
    @@ -2482,7 +2825,7 @@ int my_mod(int n, int m) { variable My_variable from Tcl. You start by making a SWIG interface file as shown below (by convention, these files carry a .i suffix) :

    -

    2.3.1 SWIG interface file

    +

    2.3.1 SWIG interface file

     /* File : example.i */
    @@ -2504,7 +2847,7 @@ extern int    my_mod(int n, int m);
      module that will be created by SWIG. The %{ %} block provides
      a location for inserting additional code, such as C header files or
      additional C declarations, into the generated C wrapper code.

    -

    2.3.2 The swig command

    +

    2.3.2 The swig command

    SWIG is invoked using the swig command. We can use this to build a Tcl module (under Linux) as follows :

    @@ -2531,15 +2874,15 @@ example_wrap.c that should be compiled along with the example.c loaded, Tcl can now access the functions and variables declared in the SWIG interface. A look at the file example_wrap.c reveals a hideous mess. However, you almost never need to worry about it.

    -

    2.3.3 Building a Perl5 module

    +

    2.3.3 Building a Perl5 module

    Now, let's turn these functions into a Perl5 module. Without making any changes type the following (shown for Solaris):

     unix > swig -perl5 example.i
     unix > gcc -c example.c example_wrap.c \
    -	-I/usr/local/lib/perl5/sun4-solaris/5.003/CORE
    -unix > ld -G example.o example_wrap.o -o example.so		# This is for Solaris
    +        -I/usr/local/lib/perl5/sun4-solaris/5.003/CORE
    +unix > ld -G example.o example_wrap.o -o example.so # This is for Solaris
     unix > perl5.003
     use example;
     print example::fact(4), "\n";
    @@ -2552,7 +2895,7 @@ print $example::My_variable + 4.5, "\n";
     unix >
     
    -

    2.3.4 Building a Python module

    +

    2.3.4 Building a Python module

    Finally, let's build a module for Python (shown for Irix).

    @@ -2572,7 +2915,7 @@ Type "copyright", "credits" or "license" for more
     7.5
     
    -

    2.3.5 Shortcuts

    +

    2.3.5 Shortcuts

    To the truly lazy programmer, one may wonder why we needed the extra interface file at all. As it turns out, you can often do without it. For example, you could also build a Perl5 module by just running SWIG @@ -2581,7 +2924,7 @@ Type "copyright", "credits" or "license" for more

     unix > swig -perl5 -module example example.h
     unix > gcc -c example.c example_wrap.c \
    -	-I/usr/local/lib/perl5/sun4-solaris/5.003/CORE
    +        -I/usr/local/lib/perl5/sun4-solaris/5.003/CORE
     unix > ld -G example.o example_wrap.o -o example.so
     unix > perl5.003
     use example;
    @@ -2594,8 +2937,8 @@ print $example::My_variable + 4.5, "\n";
     7.5
     
    -

    2.4 Supported C/C++ language - features

    +

    2.4 Supported C/C++ language features +

    A primary goal of the SWIG project is to make the language binding process extremely easy. Although a few simple examples have been shown, SWIG is quite capable in supporting most of C++. Some of the major @@ -2614,18 +2957,17 @@ print $example::My_variable + 4.5, "\n";

  • Variable length arguments.
  • C++ smart pointers.
  • -

    Currently, the only major C++ feature not supported is nested - classes--a limitation that should be removed in a future release, but - has some workarounds for the moment.

    +

    Most of C++11 is also supported. Details are in the +C++11 section.

    It is important to stress that SWIG is not a simplistic C++ lexing tool like several apparently similar wrapper generation tools. SWIG not only parses C++, it implements the full C++ type system and it is able to understand C++ semantics. SWIG generates its wrappers with full knowledge of this information. As a result, you will find SWIG to be just as capable of dealing with nasty corner cases as it is in wrapping - simple C++ code. In fact, SWIG is able handle C++ code that stresses + simple C++ code. In fact, SWIG is able to handle C++ code that stresses the very limits of many C++ compilers.

    -

    2.5 Non-intrusive interface building

    +

    2.5 Non-intrusive interface building

    When used as intended, SWIG requires minimal (if any) modification to existing C or C++ code. This makes SWIG extremely easy to use with existing packages and promotes software reuse and modularity. By making @@ -2633,8 +2975,8 @@ print $example::My_variable + 4.5, "\n"; the interface and reuse the code in other applications. It is also possible to support different types of interfaces depending on the application.

    -

    2.6 Incorporating SWIG into - a build system

    +

    2.6 Incorporating SWIG into a + build system

    SWIG is a command line tool and as such can be incorporated into any build system that supports invoking external tools/compilers. SWIG is most commonly invoked from within a Makefile, but is also known to be @@ -2650,13 +2992,13 @@ http://www.gnu.org/software/autoconf-archive/ax_pkg_swig.html#ax_pkg_swig Autoconf Archive for further information on this and other Autoconf macros.

    There is growing support for SWIG in some build tools, for example CMake is a cross-platform, open-source - build manager with built in support for SWIG. CMake can detect the SWIG +href="http://cmake.org">CMake is a cross-platform, open-source build + manager with built in support for SWIG. CMake can detect the SWIG executable and many of the target language libraries for linking against. CMake knows how to build shared libraries and loadable modules on many different operating systems. This allows easy cross platform - SWIG development. It also can generate the custom commands necessary - for driving SWIG from IDE's and makefiles. All of this can be done from + SWIG development. It can also generate the custom commands necessary + for driving SWIG from IDEs and makefiles. All of this can be done from a single cross platform input file. The following example is a CMake input file for creating a python wrapper for the SWIG interface file, example.i:

    @@ -2687,7 +3029,7 @@ SWIG_LINK_LIBRARIES(example ${PYTHON_LIBRARIES}) SWIG and compile the generated C++ files into _example.so (UNIX) or _example.pyd (Windows). For other target languages on Windows a dll, instead of a .pyd file, is usually generated.

    -

    2.7 Hands off code generation

    +

    2.7 Hands off code generation

    SWIG is designed to produce working code that needs no hand-modification (in fact, if you look at the output, you probably won't want to modify it). You should think of your target language @@ -2695,7 +3037,7 @@ SWIG_LINK_LIBRARIES(example ${PYTHON_LIBRARIES}) resulting output file. While this approach may limit flexibility for hard-core hackers, it allows others to forget about the low-level implementation details.

    -

    2.8 SWIG and freedom

    +

    2.8 SWIG and freedom

    No, this isn't a special section on the sorry state of world politics. However, it may be useful to know that SWIG was written with a certain "philosophy" about programming---namely that programmers are @@ -2706,7 +3048,7 @@ SWIG_LINK_LIBRARIES(example ${PYTHON_LIBRARIES}) On the other hand, this kind of freedom may be exactly what is needed to work with complicated and unusual C/C++ applications.

    Ironically, the freedom that SWIG provides is countered by an - extremely conservative approach to code generation. At it's core, SWIG + extremely conservative approach to code generation. At its core, SWIG tries to distill even the most advanced C++ code down to a small well-defined set of interface building techniques based on ANSI C programming. Because of this, you will find that SWIG interfaces can be @@ -2714,9 +3056,14 @@ SWIG_LINK_LIBRARIES(example ${PYTHON_LIBRARIES}) used on any platform. Again, this is an important part of staying out of the programmer's way----the last thing any developer wants to do is to spend their time debugging the output of a tool that relies on - non-portable or unreliable programming features.

    + non-portable or unreliable programming features. Dependencies are often + a source of incompatibilities and problems and so additional third + party libraries are not used in the generated code. SWIG will also + generally avoid generating code that introduces a dependency on the C++ + Standard Template Library (STL). SWIG will generate code that depends + on the C libraries though.


    -

    3 Getting started on Windows

    +

    3 Getting started on Windows

    @@ -2768,7 +3115,7 @@ SWIG_LINK_LIBRARIES(example ${PYTHON_LIBRARIES}) SWIG and running the examples is covered as well as building the SWIG executable. Usage within the Unix like environments MinGW and Cygwin is also detailed.

    -

    3.1 Installation on Windows

    +

    3.1 Installation on Windows

    SWIG does not come with the usual Windows type installation program, however it is quite easy to get started. The main steps are:

      @@ -2779,25 +3126,25 @@ SWIG website and unzip into a directory. This is all that needs SWIG Windows Examples section in order to run examples using Visual C++.
    -

    3.1.1 Windows Executable

    +

    3.1.1 Windows Executable

    The swigwin distribution contains the SWIG Windows executable, swig.exe, which will run on 32 bit versions of Windows, ie Windows 95 and later. If you want to build your own swig.exe have a look at Building swig.exe on Windows.

    -

    3.2 SWIG Windows Examples

    +

    3.2 SWIG Windows Examples

    Using Microsoft Visual C++ is the most common approach to compiling and linking SWIG's output. The Examples directory has a few Visual C++ - project files (.dsp files). These were produced by Visual C++ 6. Later - versions of Visual Studio should also be able to open and convert these - project files. The C# examples come with .NET 2003 solution (.sln) and - project files instead of Visual C++ 6 project files. The project files - have been set up to execute SWIG in a custom build rule for the SWIG - interface (.i) file. Alternatively run the + project files (.dsp files). These were produced by Visual C++ 6. Newer + versions of Visual Studio should be able to open and convert these + project files. Each C# example comes with a Visual Studio 2005 solution + and associated project files instead of Visual C++ 6 project files. The + project files have been set up to execute SWIG in a custom build rule + for the SWIG interface (.i) file. Alternatively run the examples using Cygwin.

    More information on each of the examples is available with the examples distributed with SWIG (Examples/index.html).

    -

    3.2.1 Instructions for using the - Examples with Visual Studio

    +

    3.2.1 Instructions for using the + Examples with Visual Studio

    Ensure the SWIG executable is as supplied in the SWIG root directory in order for the examples to work. Most languages require some environment variables to be set before running Visual C++. Note @@ -2814,13 +3161,13 @@ examples using Cygwin.

    coded values. If you are interested in how the project files are set up there is explanatory information in some of the language module's documentation.

    -

    3.2.1.1 C#

    +

    3.2.1.1 C#

    The C# examples do not require any environment variables to be set as a C# project file is included. Just open up the .sln solution file in Visual Studio .NET 2003 or later, select Release Build, and do a Rebuild All from the Build menu. The accompanying C# and C++ project files are automatically used by the solution file.

    -

    3.2.1.2 Java

    +

    3.2.1.2 Java

    JAVA_INCLUDE : Set this to the directory containing jni.h
    JAVA_BIN : Set this to the bin directory containing @@ -2829,7 +3176,7 @@ examples using Cygwin.


    JAVA_INCLUDE: D:\jdk1.3\include
    JAVA_BIN: D:\jdk1.3\bin

    -

    3.2.1.3 Perl

    +

    3.2.1.3 Perl

    PERL5_INCLUDE : Set this to the directory containing perl.h
    PERL5_LIB : Set this to the Perl library including @@ -2838,7 +3185,7 @@ examples using Cygwin.

    PERL5_INCLUDE: D:\nsPerl5.004_04\lib\CORE
    PERL5_LIB: D:\nsPerl5.004_04\lib\CORE\perl.lib

    -

    3.2.1.4 Python

    +

    3.2.1.4 Python

    PYTHON_INCLUDE : Set this to the directory that contains Python.h
    PYTHON_LIB : Set this to the python library @@ -2847,7 +3194,7 @@ examples using Cygwin.


    PYTHON_INCLUDE: D:\python21\include
    PYTHON_LIB: D:\python21\libs\python21.lib

    -

    3.2.1.5 TCL

    +

    3.2.1.5 TCL

    TCL_INCLUDE : Set this to the directory containing tcl.h
    TCL_LIB : Set this to the TCL library including @@ -2856,7 +3203,7 @@ examples using Cygwin.


    TCL_INCLUDE: D:\tcl\include
    TCL_LIB: D:\tcl\lib\tcl83.lib

    -

    3.2.1.6 R

    +

    3.2.1.6 R

    R_INCLUDE : Set this to the directory containing R.h
    R_LIB : Set this to the R library (Rdll.lib) including path for linking. The library needs to be built as described @@ -2866,7 +3213,7 @@ examples using Cygwin.


    R_INCLUDE: C:\Program Files\R\R-2.5.1\include
    R_LIB: C:\Program Files\R\R-2.5.1\bin\Rdll.lib

    -

    3.2.1.7 Ruby

    +

    3.2.1.7 Ruby

    RUBY_INCLUDE : Set this to the directory containing ruby.h
    RUBY_LIB : Set this to the ruby library including @@ -2875,27 +3222,27 @@ examples using Cygwin.


    RUBY_INCLUDE: D:\ruby\lib\ruby\1.6\i586-mswin32
    RUBY_LIB: D:\ruby\lib\mswin32-ruby16.lib

    -

    3.2.2 Instructions for using - the Examples with other compilers

    +

    3.2.2 Instructions for using the + Examples with other compilers

    If you do not have access to Visual C++ you will have to set up project files / Makefiles for your chosen compiler. There is a section in each of the language modules detailing what needs setting up using Visual C++ which may be of some guidance. Alternatively you may want to use Cygwin as described in the following section.

    -

    3.3 SWIG on Cygwin and MinGW

    +

    3.3 SWIG on Cygwin and MinGW

    SWIG can also be compiled and run using Cygwin or MinGW which provides a Unix like front end to Windows and comes free with gcc, an ANSI C/C++ compiler. However, this is not a recommended approach as the prebuilt executable is supplied.

    -

    3.3.1 Building swig.exe on Windows

    +

    3.3.1 Building swig.exe on Windows

    If you want to replicate the build of swig.exe that comes with the download, follow the MinGW instructions below. This is not necessary to use the supplied swig.exe. This information is provided for those that want to modify the SWIG source code in a Windows environment. Normally this is not needed, so most people will want to ignore this section.

    -

    3.3.1.1 Building swig.exe using - MinGW and MSYS

    +

    3.3.1.1 Building swig.exe using MinGW + and MSYS

    The short abbreviated instructions follow...

    • Install MinGW and MSYS from the MinGW @@ -2950,9 +3297,9 @@ MinGW SourceForge download page. Note that at the time of writing,
    • Start the MSYS command prompt and execute:
       cd /
      -tar -jxf msys-automake-1.8.2.tar.bz2 
      +tar -jxf msys-automake-1.8.2.tar.bz2
       tar -jxf msys-autoconf-2.59.tar.bz2
      -tar -zxf bison-2.0-MSYS.tar.gz   
      +tar -zxf bison-2.0-MSYS.tar.gz
       
    • The very latest development version of SWIG is available from @@ -2988,7 +3335,7 @@ make
    -

    3.3.1.2 Building swig.exe using Cygwin

    +

    3.3.1.2 Building swig.exe using Cygwin

    Note that SWIG can also be built using Cygwin. However, SWIG will then require the Cygwin DLL when executing. Follow the Unix instructions in the README file in the SWIG root directory. Note that @@ -2996,20 +3343,20 @@ make generated files which are supplied with the release distribution. These files are generated using the autogen.sh script and will only need regenerating in circumstances such as changing the build system.

    -

    3.3.1.3 Building - swig.exe alternatives

    +

    3.3.1.3 Building swig.exe + alternatives

    If you don't want to install Cygwin or MinGW, use a different compiler to build SWIG. For example, all the source code files can be added to a Visual C++ project file in order to build swig.exe from the Visual C++ IDE.

    -

    3.3.2 Running the examples on - Windows using Cygwin

    +

    3.3.2 Running the examples on + Windows using Cygwin

    The examples and test-suite work as successfully on Cygwin as on any other Unix operating system. The modules which are known to work are Python, Tcl, Perl, Ruby, Java and C#. Follow the Unix instructions in the README file in the SWIG root directory to build the examples.

    -

    3.4 Microsoft extensions and - other Windows quirks

    +

    3.4 Microsoft extensions and other + Windows quirks

    A common problem when using SWIG on Windows are the Microsoft function calling conventions which are not in the C++ standard. SWIG parses ISO C/C++ so cannot deal with proprietary conventions such as @@ -3025,8 +3372,52 @@ __declspec(dllimport), __stdcall etc. There is a Windows __declspec(dllexport) ULONG __stdcall foo(DWORD, __int32); + +

    Note that if you follow Microsoft's recommendation of wrapping the +__declspec calls in a preprocessor definition, you will need to + make sure that the definition is included by SWIG as well, by either + defining it manually or via a header. For example, if you have + specified the preprocessor definition in a header named +export_lib.h and include other headers which depend on it, you + should use the %include directive to include the definition + explicitly. For example, if you had a header file, bar.h, + which depended on export_lib.h, your SWIG definition file + might look like:

    +
    +
    +// bar.i
    +%module bar
    +%include <windows.i>
    +%include "export_lib.h"
    +%include "bar.h"
    +
    +
    +

    where export_lib.h may contain:

    +
    +
    +// export_lib.h
    +#define BAR_API __declspec(dllexport)
    +
    +
    +

    and bar.h may look like:

    +
    +
    +// bar.h
    +#include "export_lib.h"
    +BAR_API void bar_function(int, double);
    +
    +
    +

    Using the preprocessor to remove BAR_API is a popular simpler + solution:

    +
    +
    +// bar.i
    +%module bar
    +#define BAR_API
    +%include "bar.h"
    +

    -

    4 Scripting Languages

    +

    4 Scripting Languages

    @@ -3054,7 +3445,7 @@ __declspec(dllexport) ULONG __stdcall foo(DWORD, __int32);

    This chapter provides a brief overview of scripting language extension programming and the mechanisms by which scripting language interpreters access C and C++ code.

    -

    4.1 The two language view of the world

    +

    4.1 The two language view of the world

    When a scripting language is used to control a C program, the resulting system tends to look as follows:

    Scripting language input - C/C++ functions output
    languages can be used for rapid prototyping, interactive debugging, scripting, and access to high-level data structures such associative arrays.

    -

    4.2 How does a scripting language talk - to C?

    +

    4.2 How does a scripting language talk to C? +

    Scripting languages are built around a parser that knows how to execute commands and scripts. Within this parser, there is a mechanism for executing commands and accessing variables. Normally, this is used @@ -3093,13 +3484,15 @@ src="ch2.1.png" WIDTH="377">

    information about the wrapper by providing details about the name of the function, arguments, and so forth. The next few sections illustrate the process.

    -

    4.2.1 Wrapper functions

    +

    4.2.1 Wrapper functions

    Suppose you have an ordinary C function like this :

     int fact(int n) {
    -	if (n <= 1) return 1;
    -	else return n*fact(n-1);
    +  if (n <= 1)
    +    return 1;
    +  else
    +    return n*fact(n-1);
     }
     
    @@ -3117,18 +3510,17 @@ int fact(int n) { function above example might look like the following :

    -int wrap_fact(ClientData clientData, Tcl_Interp *interp,
    -		int argc, char *argv[]) {
    -	int result;
    -	int arg0;
    -	if (argc != 2) {
    -		interp->result = "wrong # args";
    -		return TCL_ERROR;
    -	}
    -	arg0 = atoi(argv[1]);
    -	result = fact(arg0);
    -	sprintf(interp->result,"%d", result);
    -	return TCL_OK;
    +int wrap_fact(ClientData clientData, Tcl_Interp *interp, int argc, char *argv[]) {
    +  int result;
    +  int arg0;
    +  if (argc != 2) {
    +    interp->result = "wrong # args";
    +    return TCL_ERROR;
    +  }
    +  arg0 = atoi(argv[1]);
    +  result = fact(arg0);
    +  sprintf(interp->result,"%d", result);
    +  return TCL_OK;
     }
     
     
    @@ -3141,9 +3533,9 @@ int wrap_fact(ClientData clientData, Tcl_Interp *interp,
     int Wrap_Init(Tcl_Interp *interp) {
    -	Tcl_CreateCommand(interp, "fact", wrap_fact, (ClientData) NULL,
    -				(Tcl_CmdDeleteProc *) NULL);
    -	return TCL_OK;
    +  Tcl_CreateCommand(interp, "fact", wrap_fact, (ClientData) NULL,
    +                    (Tcl_CmdDeleteProc *) NULL);
    +  return TCL_OK;
     }
     
    @@ -3153,7 +3545,7 @@ int Wrap_Init(Tcl_Interp *interp) { illustrated, the procedure is almost identical for Perl and Python. Both require special wrappers to be written and both need additional initialization code. Only the specific details are different.

    -

    4.2.2 Variable linking

    +

    4.2.2 Variable linking

    Variable linking refers to the problem of mapping a C/C++ global variable to a variable in the scripting language interpreter. For example, suppose you had the following variable:

    @@ -3179,7 +3571,7 @@ $Foo = $a + 2.0; # Assignment such as $Foo might implicitly call the get function. Similarly, typing $Foo = 4 would call the underlying set function to change the value.

    -

    4.2.3 Constants

    +

    4.2.3 Constants

    In many cases, a C program or library may define a large collection of constants. For example:

    @@ -3194,7 +3586,7 @@ $Foo = $a + 2.0; # Assignment $GREEN. Virtually all scripting languages provide C functions for creating variables so installing constants is usually a trivial exercise.

    -

    4.2.4 Structures and classes

    +

    4.2.4 Structures and classes

    Although scripting languages have no trouble accessing simple functions and variables, accessing C/C++ structures and classes present a different problem. This is because the implementation of structures @@ -3208,9 +3600,9 @@ $GREEN. Virtually all scripting languages provide C functions for

     struct Vector {
    -	Vector();
    -	~Vector();
    -	double x,y,z;
    +  Vector();
    +  ~Vector();
    +  double x,y,z;
     };
     
     
    @@ -3242,20 +3634,20 @@ void Vector_z_set(Vector *v, double z);

    Since accessor functions provide a mechanism for accessing the internals of an object, the interpreter does not need to know anything about the actual representation of a Vector.

    -

    4.2.5 Proxy classes

    +

    4.2.5 Proxy classes

    In certain cases, it is possible to use the low-level accessor functions to create a proxy class, also known as a shadow class. A proxy class is a special kind of object that gets created in a scripting language to access a C/C++ class (or struct) in a way that looks like the original structure (that is, it proxies the real C++ - class). For example, if you have the following C definition :

    + class). For example, if you have the following C++ definition :

     class Vector {
     public:
    -	Vector();
    -	~Vector();
    -	double x,y,z;
    +  Vector();
    +  ~Vector();
    +  double x,y,z;
     };
     
    @@ -3286,41 +3678,36 @@ $v->{z} = -13;
     Vector v
    -v configure -x 3 -y 4 -z 13
    +v configure -x 3 -y 4 -z -13
     
     
    -

    When proxy classes are used, two objects are at really work--one in +

    When proxy classes are used, two objects are really at work--one in the scripting language, and an underlying C/C++ object. Operations affect both objects equally and for all practical purposes, it appears as if you are simply manipulating a C/C++ object.

    -

    4.3 Building scripting language - extensions

    +

    4.3 Building scripting language extensions +

    The final step in using a scripting language with your C/C++ application is adding your extensions to the scripting language itself. There are two primary approaches for doing this. The preferred - technique is to build a dynamically loadable extension in the form a + technique is to build a dynamically loadable extension in the form of a shared library. Alternatively, you can recompile the scripting language interpreter with your extensions added to it.

    -

    4.3.1 Shared libraries and dynamic - loading

    +

    4.3.1 Shared libraries and dynamic loading +

    To create a shared library or DLL, you often need to look at the manual pages for your compiler and linker. However, the procedure for a - few common machines is shown below:

    + few common platforms is shown below:

     # Build a shared library for Solaris
    -gcc -c example.c example_wrap.c -I/usr/local/include
    +gcc -fpic -c example.c example_wrap.c -I/usr/local/include
     ld -G example.o example_wrap.o -o example.so
     
     # Build a shared library for Linux
     gcc -fpic -c example.c example_wrap.c -I/usr/local/include
     gcc -shared example.o example_wrap.o -o example.so
    -
    -# Build a shared library for Irix
    -gcc -c example.c example_wrap.c -I/usr/local/include
    -ld -shared example.o example_wrap.o -o example.so
    -
     

    To use your shared library, you simply use the corresponding command @@ -3344,7 +3731,7 @@ ld -shared example.o example_wrap.o -o example.so c++ -shared example.o example_wrap.o -o example.so

    -

    4.3.2 Linking with shared libraries

    +

    4.3.2 Linking with shared libraries

    When building extensions as shared libraries, it is not uncommon for your extension to rely upon other shared libraries on your machine. In order for the extension to work, it needs to be able to find all of @@ -3382,7 +3769,7 @@ lib/libgraph.so:/lib/cmplrs/cc/libgraph.so:/usr/lib/cmplrs/cc/libgraph.so: Although this is an easy solution, it is not recommended. Consider setting the path using linker options instead. -

    4.3.3 Static linking

    +

    4.3.3 Static linking

    With static linking, you rebuild the scripting language interpreter with extensions. The process usually involves compiling a short main program that adds your customized commands to the language and starts @@ -3393,7 +3780,7 @@ lib/libgraph.so:/lib/cmplrs/cc/libgraph.so:/usr/lib/cmplrs/cc/libgraph.so: fact, there are very few practical reasons for doing this--consider using shared libraries instead.


    -

    5 SWIG Basics

    +

    5 SWIG Basics

    @@ -3413,8 +3800,8 @@ lib/libgraph.so:/lib/cmplrs/cc/libgraph.so:/usr/lib/cmplrs/cc/libgraph.so:
  • Basic Type Handling
  • Global Variables
  • Constants
  • -
  • A brief word about const
  • -
  • A cautionary tale of char *
  • +
  • A brief word about const
  • +
  • A cautionary tale of char *
  • Pointers and complex objects @@ -3431,7 +3818,7 @@ lib/libgraph.so:/lib/cmplrs/cc/libgraph.so:/usr/lib/cmplrs/cc/libgraph.so:
  • Passing structures by value
  • Return by value
  • Linking to structure variables
  • -
  • Linking to char *
  • +
  • Linking to char *
  • Arrays
  • Creating read-only variables
  • Renaming and ignoring declarations @@ -3486,7 +3873,7 @@ lib/libgraph.so:/lib/cmplrs/cc/libgraph.so:/usr/lib/cmplrs/cc/libgraph.so: support is described in the next chapter. However, C++ programmers should still read this chapter to understand the basics. Specific details about each target language are described in later chapters.

    -

    5.1 Running SWIG

    +

    5.1 Running SWIG

    To run SWIG, use the swig command with options and a filename like this:

    @@ -3497,8 +3884,8 @@ swig [ options ] filename

    where filename is a SWIG interface file or a C/C++ header file. Below is a subset of options that can be used. Additional options are also defined for each target language. A full - list can be obtained by typing swig -help or swig - -lang -help.

    + list can be obtained by typing swig -help or swig + -<lang> -help for language <lang> specific options.

     -allegrocl            Generate ALLEGROCL wrappers
    @@ -3506,25 +3893,31 @@ lang -help.

    -clisp Generate CLISP wrappers -cffi Generate CFFI wrappers -csharp Generate C# wrappers +-d Generate D wrappers -go Generate Go wrappers -guile Generate Guile wrappers -java Generate Java wrappers +-javascript Generate Javascript wrappers -lua Generate Lua wrappers -modula3 Generate Modula 3 wrappers -mzscheme Generate Mzscheme wrappers -ocaml Generate Ocaml wrappers +-octave Generate Octave wrappers -perl Generate Perl wrappers -php Generate PHP wrappers -pike Generate Pike wrappers -python Generate Python wrappers -r Generate R (aka GNU S) wrappers -ruby Generate Ruby wrappers +-scilab Generate Scilab wrappers -sexp Generate Lisp S-Expressions wrappers -tcl Generate Tcl wrappers -uffi Generate Common Lisp / UFFI wrappers -xml Generate XML wrappers -c++ Enable C++ parsing +-cppext ext Change file extension of C++ generated files to ext + (default is cxx, except for PHP which uses cpp) -Dsymbol Define a preprocessor symbol -Fstandard Display error/warning messages in commonly used format -Fmicrosoft Display error/warning messages in Microsoft format @@ -3532,8 +3925,9 @@ lang -help.

    -Idir Add a directory to the file include path -lfile Include a SWIG library file. -module name Set the name of the SWIG module --o outfile Name of output file --outcurrentdir Set default output dir to current dir instead of input file's path +-o outfile Set name of C/C++ output file to <outfile> +-oh headfile Set name of C++ output header file for directors to <headfile> +-outcurrentdir Set default output dir to current dir instead of input file's path -outdir dir Set language specific files output directory -pcreversion Display PCRE version information -swiglib Show location of SWIG library @@ -3541,7 +3935,7 @@ lang -help.

    -

    5.1.1 Input format

    +

    5.1.1 Input format

    As input, SWIG expects a file containing ANSI C/C++ declarations and special SWIG directives. More often than not, this is a special SWIG interface file which is usually denoted with a special .i or @@ -3577,32 +3971,32 @@ Modules Introduction section.

    interpreted by SWIG. The %{...%} syntax and semantics in SWIG is analogous to that of the declarations section used in input files to parser generation tools such as yacc or bison.

    -

    5.1.2 SWIG Output

    +

    5.1.2 SWIG Output

    The output of SWIG is a C/C++ file that contains all of the wrapper code needed to build an extension module. SWIG may generate some additional files depending on the target language. By default, an input file with the name file.i is transformed into a file file_wrap.c or file_wrap.cxx (depending on whether or not - the -c++ option has been used). The name of the output file - can be changed using the -o option. In certain cases, file - suffixes are used by the compiler to determine the source language (C, - C++, etc.). Therefore, you have to use the -o option to change - the suffix of the SWIG-generated wrapper file if you want something - different than the default. For example:

    + the -c++ option has been used). The name of the output C/C++ + file can be changed using the -o option. In certain cases, + file suffixes are used by the compiler to determine the source language + (C, C++, etc.). Therefore, you have to use the -o option to + change the suffix of the SWIG-generated wrapper file if you want + something different than the default. For example:

     $ swig -c++ -python -o example_wrap.cpp example.i
     

    The C/C++ output file created by SWIG often contains everything that - is needed to construct a extension module for the target scripting + is needed to construct an extension module for the target scripting language. SWIG is not a stub compiler nor is it usually necessary to edit the output file (and if you look at the output, you probably won't want to). To build the final extension module, the SWIG output file is compiled and linked with the rest of your C/C++ program to create a shared library.

    -

    Many target languages will also generate proxy class files in the - target language. The default output directory for these language +

    For many target languages SWIG will also generate proxy class files + in the target language. The default output directory for these language specific files is the same directory as the generated C/C++ file. This can be modified using the -outdir option. For example:

    @@ -3624,14 +4018,14 @@ pyfiles/example.py default output directory is the path to the input file. If -o and -outcurrentdir are used together, -outcurrentdir is effectively ignored as the output directory for the language files - is the same directory as the generated C/C++ file if not overidden with - -outdir.

    -

    5.1.3 Comments

    + is the same directory as the generated C/C++ file if not overridden + with -outdir.

    +

    5.1.3 Comments

    C and C++ style comments may appear anywhere in interface files. In previous versions of SWIG, comments were used to generate documentation files. However, this feature is currently under repair and will reappear in a later SWIG release.

    -

    5.1.4 C Preprocessor

    +

    5.1.4 C Preprocessor

    Like C, SWIG preprocesses all input files through an enhanced version of the C preprocessor. All standard preprocessor features are supported including file inclusion, conditional compilation and macros. @@ -3647,7 +4041,7 @@ pyfiles/example.py includes a number of macro handling enhancements that make it more powerful than the normal C preprocessor. These extensions are described in the "Preprocessor" chapter.

    -

    5.1.5 SWIG Directives

    +

    5.1.5 SWIG Directives

    Most of SWIG's operation is controlled by special directives that are always preceded by a "%" to distinguish them from normal C declarations. These directives are used to give SWIG hints or to alter @@ -3667,7 +4061,7 @@ pyfiles/example.py

    SWIG is a special preprocessing symbol defined by SWIG when it is parsing an input file.

    -

    5.1.6 Parser Limitations

    +

    5.1.6 Parser Limitations

    Although SWIG can parse most C/C++ declarations, it does not provide a complete C/C++ parser implementation. Most of these limitations pertain to very complicated type declarations and certain advanced C++ @@ -3740,7 +4134,7 @@ Nested classes section for more information.

    primary complication in the implementation is that the SWIG parser does not utilize a separate typedef-name terminal symbol as described on p. 234 of K&R).

    -

    5.2 Wrapping Simple C Declarations

    +

    5.2 Wrapping Simple C Declarations

    SWIG wraps simple C declarations by creating an interface that closely matches the way in which the declarations would be used in a C program. For example, consider the following interface file:

    @@ -3794,9 +4188,9 @@ STATUS
    and VERSION. When SWIG creates an extension module,

    Whenever possible, SWIG creates an interface that closely matches the underlying C/C++ code. However, due to subtle differences between languages, run-time environments, and semantics, it is not always - possible to do so. The next few sections describes various aspects of + possible to do so. The next few sections describe various aspects of this mapping.

    -

    5.2.1 Basic Type Handling

    +

    5.2.1 Basic Type Handling

    In order to build an interface, SWIG has to convert C/C++ datatypes to equivalent types in the target language. Generally, scripting languages provide a more limited set of primitive types than C. @@ -3893,7 +4287,7 @@ Typemaps for details about this.

    Unicode characters in the target language will use the same internal representation (e.g., UCS-2 vs. UCS-4). You may need to write some special conversion functions.

    -

    5.2.2 Global Variables

    +

    5.2.2 Global Variables

    Whenever possible, SWIG maps C/C++ global variables into scripting language variables. For example,

    @@ -3937,7 +4331,7 @@ double get_foo() and set_foo(double val) that are used to it only supports read-only access. Note: this behavior is new to SWIG-1.3. Earlier versions of SWIG incorrectly handled const and created constants instead.

    -

    5.2.3 Constants

    +

    5.2.3 Constants

    Constants can be created using #define, enumerations, or a special %constant directive. The following interface file shows a few valid constant declarations :

    @@ -3985,7 +4379,7 @@ EXTERN (what would the value be?). In general, SWIG will not create reasons even a constant with a simple cast will be ignored, such as

    -#define F_CONST (double) 5            // A floating pointer constant with cast
    +#define F_CONST (double) 5            // A floating point constant with cast
     

    The use of constant expressions is allowed, but SWIG does not @@ -4000,12 +4394,11 @@ EXTERN (what would the value be?). In general, SWIG will not create values as assigned by the C compiler.

    The %constant directive is used to more precisely create constants corresponding to different C datatypes. Although it is not - usually not needed for simple values, it is more useful when working - with pointers and other more complex datatypes. Typically, -%constant is only used when you want to add constants to the - scripting language interface that are not defined in the original - header file.

    -

    5.2.4 A brief word about const

    + usually needed for simple values, it is more useful when working with + pointers and other more complex datatypes. Typically, %constant + is only used when you want to add constants to the scripting language + interface that are not defined in the original header file.

    +

    5.2.4 A brief word about const

    A common confusion with C programming is the semantic meaning of the const qualifier in declarations--especially when it is mixed with pointers and other type modifiers. In fact, previous versions of @@ -4080,14 +4473,14 @@ const int spam = 42;

    -

    5.2.5 A cautionary tale of char *

    +

    5.2.5 A cautionary tale of char *

    Before going any further, there is one bit of caution involving char * that must now be mentioned. When strings are passed from a scripting language to a C char *, the pointer usually points to string data stored inside the interpreter. It is almost always a really bad idea to modify this data. Furthermore, some languages may explicitly disallow it. For instance, in Python, strings are supposed - be immutable. If you violate this, you will probably receive a vast + to be immutable. If you violate this, you will probably receive a vast amount of wrath when you unleash your module on the world.

    The primary source of problems are functions that might modify string data in place. A classic example would be a function like this:

    @@ -4104,10 +4497,10 @@ char *strcat(char *s, const char *t)

    The bottom line: don't rely on char * for anything other than read-only input values. However, it must be noted that you could change the behavior of SWIG using typemaps.

    -

    5.3 Pointers and complex objects

    +

    5.3 Pointers and complex objects

    Most C programs manipulate arrays, structures, and other types of objects. This section discusses the handling of these datatypes.

    -

    5.3.1 Simple pointers

    +

    5.3.1 Simple pointers

    Pointers to primitive C datatypes such as

    @@ -4156,7 +4549,7 @@ _f8ac_pp_char
     
  • By handling all pointers in a consistent manner, the implementation of SWIG is greatly simplified and less prone to error.
  • -

    5.3.2 Run time pointer type checking

    +

    5.3.2 Run time pointer type checking

    By allowing pointers to be manipulated from a scripting language, extension modules effectively bypass compile-time type checking in the C/C++ compiler. To prevent errors, a type signature is encoded into all @@ -4170,7 +4563,7 @@ NULL pointers can be passed to any function that expects to receive pointers are also sometimes used as sentinel values or to denote a missing/empty value. Therefore, SWIG leaves NULL pointer checking up to the application.

    -

    5.3.3 Derived types, structs, and classes

    +

    5.3.3 Derived types, structs, and classes

    For everything else (structs, classes, arrays, etc...) SWIG applies a very simple rule :

    Everything else is a pointer
    @@ -4200,21 +4593,20 @@ void free(void *);
     # Copy a file 
     def filecopy(source,target):
    -	f1 = fopen(source,"r")
    -	f2 = fopen(target,"w")
    -	buffer = malloc(8192)
    -	nbytes = fread(buffer,8192,1,f1)
    -	while (nbytes > 0):
    -		fwrite(buffer,8192,1,f2)
    -		nbytes = fread(buffer,8192,1,f1)
    -	free(buffer)
    -
    +  f1 = fopen(source,"r")
    +  f2 = fopen(target,"w")
    +  buffer = malloc(8192)
    +  nbytes = fread(buffer,8192,1,f1)
    +  while (nbytes > 0):
    +    fwrite(buffer,8192,1,f2)
    +          nbytes = fread(buffer,8192,1,f1)
    +  free(buffer)
     

    In this case f1, f2, and buffer are all opaque objects containing C pointers. It doesn't matter what value they contain--our program works just fine without this knowledge.

    -

    5.3.4 Undefined datatypes

    +

    5.3.4 Undefined datatypes

    When SWIG encounters an undeclared datatype, it automatically assumes that it is a structure or class. For example, suppose the following function appeared in a SWIG input file:

    @@ -4256,7 +4648,7 @@ TypeError: expected a _p_size_t. declare type names using typedef.

    -

    5.3.5 Typedef

    +

    5.3.5 Typedef

    Like C, typedef can be used to define new type names in SWIG. For example:

    @@ -4316,12 +4708,12 @@ void foo(unsigned int *ptr);

    The corresponding wrapper function will accept arguments of type unsigned int * or size_t *.

    -

    5.4 Other Practicalities

    +

    5.4 Other Practicalities

    So far, this chapter has presented almost everything you need to know to use SWIG for simple interfaces. However, some C programs use idioms that are somewhat more difficult to map to a scripting language interface. This section describes some of these issues.

    -

    5.4.1 Passing structures by value

    +

    5.4.1 Passing structures by value

    Sometimes a C function takes structure parameters that are passed by value. For example, consider the following function:

    @@ -4343,7 +4735,7 @@ double wrap_dot_product(Vector *a, Vector *b) {

    In the target language, the dot_product() function now accepts pointers to Vectors instead of Vectors. For the most part, this transformation is transparent so you might not notice.

    -

    5.4.2 Return by value

    +

    5.4.2 Return by value

    C functions that return structures or classes datatypes by value are more difficult to handle. Consider the following function:

    @@ -4387,7 +4779,7 @@ Vector *wrap_cross(Vector *v1, Vector *v2) { C++ has some special cases. For example, the above code fragments don't work correctly if Vector doesn't define a default constructor. The section on SWIG and C++ has more information about this case.

    -

    5.4.3 Linking to structure variables

    +

    5.4.3 Linking to structure variables

    When global variables or class members involving structures are encountered, SWIG handles them as pointers. For example, a global variable like this

    @@ -4400,10 +4792,10 @@ Vector unit_i;
     Vector *unit_i_get() {
    -	return &unit_i;
    +  return &unit_i;
     }
     void unit_i_set(Vector *value) {
    -	unit_i = *value;
    +  unit_i = *value;
     }
     
    @@ -4412,7 +4804,7 @@ void unit_i_set(Vector *value) { would be an extremely bad idea to free or destroy such a pointer. Also, C++ classes must supply a properly defined copy constructor in order for assignment to work correctly.

    -

    5.4.4 Linking to char *

    +

    5.4.4 Linking to char *

    When a global variable of type char * appears, SWIG uses malloc() or new to allocate memory for the new value. Specifically, if you have a variable like this

    @@ -4505,7 +4897,7 @@ const char *foo = "Hello World\n"; pointer to point to the new value. However, repeated modifications of the value will result in a memory leak since the old value is not released.

    -

    5.4.5 Arrays

    +

    5.4.5 Arrays

    Arrays are fully supported by SWIG, but they are always handled as pointers instead of mapping them to a special array object or list in the target language. Thus, the following declarations :

    @@ -4525,7 +4917,7 @@ void transpose(double (*a)[20]);

    Like C, SWIG does not perform array bounds checking. It is up to the - user to make sure the pointer points a suitably allocated region of + user to make sure the pointer points to a suitably allocated region of memory.

    Multi-dimensional arrays are transformed into a pointer to an array of one less dimension. For example:

    @@ -4606,19 +4998,19 @@ void pathname_set(char *value) {

    In the target language, the value can be set like a normal variable.

    -

    5.4.6 Creating read-only - variables

    +

    5.4.6 Creating read-only variables +

    A read-only variable can be created by using the %immutable directive as shown :

     // File : interface.i
     
    -int 	a; 			// Can read/write
    +int a;       // Can read/write
     %immutable;
    -int	b,c,d			// Read only variables
    +int b,c,d;   // Read only variables
     %mutable;
    -double	x,y			// read/write
    +double x,y;  // read/write
     

    The %immutable directive enables read-only mode until it is @@ -4669,10 +5061,10 @@ char * const version="1.0"; /* Read only variable */ Although these directives still work, they generate a warning message. Simply change the directives to %immutable; and %mutable; to silence the warning. Don't forget the extra semicolon!

    -

    5.4.7 Renaming and ignoring - declarations

    -

    5.4.7.1 Simple renaming of specific - identifiers

    +

    5.4.7 Renaming and ignoring + declarations

    +

    5.4.7.1 Simple renaming of specific identifiers +

    Normally, the name of a C declaration is used when that declaration is wrapped into the target language. However, this may generate a conflict with a keyword or already existing function in the scripting @@ -4752,8 +5144,8 @@ void print(const char *);

    This directive is still supported, but it is deprecated and should probably be avoided. The %rename directive is more powerful and better supports wrapping of raw header file information.

    -

    5.4.7.2 Advanced renaming - support

    +

    5.4.7.2 Advanced renaming support +

    While writing %rename for specific declarations is simple enough, sometimes the same renaming rule needs to be applied to many, maybe all, identifiers in the SWIG input. For example, it may be @@ -4832,6 +5224,11 @@ print_itprint-it square brackets should be used literally, e.g. %rename("strip:[wx]")wxPrintPrint +rstrip:[suffix]String without the given suffix + or the original string if it doesn't end with this suffix. Note that + square brackets should be used literally, e.g. +%rename("rstrip:[Cls]")PrintClsPrint + regex:/pattern/subst/String after (Perl-like) regex @@ -4839,12 +5236,22 @@ print_itprint-it expressions to the identifier names. The pattern part is a regular expression in Perl syntax (as supported by the Perl Compatible Regular Expressions (PCRE)) library and the subst - string can contain back-references introduced by '\' or, as - backslashes need to be escaped in C strings, rather by "\\". - For example, to remove any alphabetic prefix before an underscore you - could use the following directive: -%rename("regex:/(\\w+)_(.*)/\\2/")Prefix_Print -Print + string can contain back-references of the form \N where N + is a digit from 0 to 9, or one of the following escape sequences: +\l, \L, \u, \U or \E. The + back-references are replaced with the contents of the corresponding + capture group while the escape sequences perform the case conversion in + the substitution string: \l and \L convert to the + lower case, while \u and \U convert to the upper + case. The difference between the elements of each pair is that \l + and \u change the case of the next character only, while +\L and \U do it for all the remaining characters or until +\E is encountered. Finally please notice that backslashes need to + be escaped in C strings, so in practice "\\" must be used in + all these escape sequences. For example, to remove any alphabetic + prefix before an underscore and capitalize the remaining part you could + use the following directive: %rename("regex:/(\\w+)_(.*)/\\u\\2/") +prefix_printPrint command:cmdOutput of an external command cmd with the string passed to it as input. Notice that this function is extremely slow compared to all the other ones as it @@ -4891,8 +5298,8 @@ regex one. Here are some more examples of its use:

    are exactly equivalent and %rename can be used to selectively ignore multiple declarations using the previously described matching possibilities.

    -

    5.4.7.3 Limiting global - renaming rules

    +

    5.4.7.3 Limiting global renaming + rules

    As explained in the previous sections, it is possible to either rename individual declarations or apply a rename rule to all of them at once. In practice, the latter is however rarely appropriate as there @@ -4969,8 +5376,8 @@ match="class" restricts the match to class declarations only (in methods or C++ methods which use default arguments. This is described in the Ambiguity resolution and renaming section in the C++ chapter.

    -

    5.4.7.4 Ignoring everything then - wrapping a few selected symbols

    +

    5.4.7.4 Ignoring everything then + wrapping a few selected symbols

    Using the techniques described above it is possible to ignore everything in a header and then selectively wrap a few chosen methods or classes. For example, consider a header, myheader.h which @@ -5004,7 +5411,7 @@ match="class" restricts the match to class declarations only (in %include "myheader.h"

    -

    5.4.8 Default/optional arguments

    +

    5.4.8 Default/optional arguments

    SWIG supports default arguments in both C and C++ code. For example:

    @@ -5016,8 +5423,8 @@ int plot(double x, double y, int color=WHITE);
      function could be used in Tcl as follows :

    -% plot -3.4 7.5 				# Use default value
    -% plot -3.4 7.5 10				# set color to 10 instead
    +% plot -3.4 7.5    # Use default value
    +% plot -3.4 7.5 10 # set color to 10 instead
     
     
    @@ -5032,7 +5439,7 @@ int plot(double x, double y, int color=WHITE); generated for each defaulted argument. Please refer to the section on default arguments in the C++ chapter for further details.

    -

    5.4.9 Pointers to functions and callbacks

    +

    5.4.9 Pointers to functions and callbacks

    Occasionally, a C library may include functions that expect to receive pointers to functions--possibly to serve as callbacks. SWIG provides full support for function pointers provided that the callback @@ -5131,8 +5538,8 @@ int mul(int,int);

    Notice that when the function is used as a callback, special names - such as add_cb is used instead. To call the function normally, - just use the original function name such as add().

    + such as add_cb are used instead. To call the function + normally, just use the original function name such as add().

    SWIG provides a number of extensions to standard C printf formatting that may be useful in this context. For instance, the following variation installs the callbacks as all upper case constants such as @@ -5156,20 +5563,20 @@ int mul(int,int); advanced SWIG features. See the Typemaps chapter for more about typemaps and individual target language chapters for more on callbacks and the 'director' feature.

    -

    5.5 Structures and unions

    +

    5.5 Structures and unions

    This section describes the behavior of SWIG when processing ANSI C structures and union declarations. Extensions to handle C++ are described in the next section.

    If SWIG encounters the definition of a structure or union, it creates a set of accessor functions. Although SWIG does not need - structure definitions to build an interface, providing definitions make - it possible to access structure members. The accessor functions + structure definitions to build an interface, providing definitions + makes it possible to access structure members. The accessor functions generated by SWIG simply take a pointer to an object and allow access to an individual member. For example, the declaration :

     struct Vector {
    -	double x,y,z;
    +  double x,y,z;
     }
     
     
    @@ -5178,22 +5585,22 @@ struct Vector {
     double Vector_x_get(struct Vector *obj) {
    -	return obj->x;
    +  return obj->x;
     }
     double Vector_y_get(struct Vector *obj) { 
    -	return obj->y;
    +  return obj->y;
     }
     double Vector_z_get(struct Vector *obj) { 
    -	return obj->z;
    +  return obj->z;
     }
     void Vector_x_set(struct Vector *obj, double value) {
    -	obj->x = value;
    +  obj->x = value;
     }
     void Vector_y_set(struct Vector *obj, double value) {
    -	obj->y = value;
    +  obj->y = value;
     }
     void Vector_z_set(struct Vector *obj, double value) {
    -	obj->z = value;
    +  obj->z = value;
     }
     
    @@ -5223,13 +5630,13 @@ delete_Vector(v)

    However, most of SWIG's language modules also provide a high-level interface that is more convenient. Keep reading.

    -

    5.5.1 Typedef and structures

    +

    5.5.1 Typedef and structures

    SWIG supports the following construct which is quite common in C programs :

     typedef struct {
    -	double x,y,z;
    +  double x,y,z;
     } Vector;
     
     
    @@ -5241,7 +5648,7 @@ struct
    keyword on its generated code. For example:

     double Vector_x_get(Vector *obj) {
    -	return obj->x;
    +  return obj->x;
     }
     
    @@ -5249,7 +5656,7 @@ double Vector_x_get(Vector *obj) {
     typedef struct vector_struct {
    -	double x,y,z;
    +  double x,y,z;
     } Vector;
     
     
    @@ -5259,19 +5666,19 @@ typedef struct vector_struct { later in the interface use the type struct vector_struct, SWIG knows that this is the same as Vector and it generates the appropriate type-checking code.

    -

    5.5.2 Character strings and structures

    +

    5.5.2 Character strings and structures

    Structures involving character strings require some care. SWIG assumes that all members of type char * have been dynamically allocated using malloc() and that they are NULL-terminated - ASCII strings. When such a member is modified, the previously contents + ASCII strings. When such a member is modified, the previous contents will be released, and the new contents allocated. For example :

     %module mymodule
     ...
     struct Foo {
    -	char *name;
    -	...
    +  char *name;
    +  ...
     }
     
     
    @@ -5280,14 +5687,15 @@ struct Foo {
     char *Foo_name_get(Foo *obj) {
    -	return Foo->name;
    +  return Foo->name;
     }
     
     char *Foo_name_set(Foo *obj, char *c) {
    -	if (obj->name) free(obj->name);
    -	obj->name = (char *) malloc(strlen(c)+1);
    -	strcpy(obj->name,c);
    -	return obj->name;
    +  if (obj->name)
    +    free(obj->name);
    +  obj->name = (char *) malloc(strlen(c)+1);
    +  strcpy(obj->name,c);
    +  return obj->name;
     }
     
    @@ -5296,7 +5704,7 @@ char *Foo_name_set(Foo *obj, char *c) { chapter for further details.

    Note: If the -c++ option is used, new and delete are used to perform memory allocation.

    -

    5.5.3 Array members

    +

    5.5.3 Array members

    Arrays may appear as the members of structures, but they will be read-only. SWIG will write an accessor function that returns the pointer to the first element of the array, but will not write a @@ -5311,8 +5719,8 @@ interface.i:116. Warning. Array member will be read-only

    To eliminate the warning message, typemaps can be used, but this is discussed in a later chapter. In many cases, the warning message is harmless.

    -

    5.5.4 Structure data - members

    +

    5.5.4 Structure data members +

    Occasionally, a structure will contain data members that are themselves structures. For example:

    @@ -5330,7 +5738,7 @@ typedef struct Bar {

    When a structure member is wrapped, it is handled as a pointer, unless the %naturalvar directive is used where it is handled more like a C++ reference (see C++ - Member data). The accessors to the member variable as a pointer is + Member data). The accessors to the member variable as a pointer are effectively wrapped as follows:

    @@ -5393,7 +5801,7 @@ void Foo_w_set(FOO *f, WORD value) {
      existing code. However, if you need to tell SWIG that an undeclared
      datatype is really a struct, simply use a forward struct declaration
      such as "struct Foo;".

    -

    5.5.5 C constructors and destructors

    +

    5.5.5 C constructors and destructors

    When wrapping structures, it is generally useful to have a mechanism for creating and destroying objects. If you don't do anything, SWIG will automatically generate functions for creating and destroying @@ -5432,9 +5840,9 @@ struct Bar { // Default constructor generated. };

    -

    Since ignoring the implicit or default destructors most of the times - produce memory leaks, SWIG will always try to generate them. If needed, - however, you can selectively disable the generation of the +

    Since ignoring the implicit or default destructors most of the time + produces memory leaks, SWIG will always try to generate them. If + needed, however, you can selectively disable the generation of the default/implicit destructor by using %nodefaultdtor

    @@ -5455,9 +5863,9 @@ struct Bar {              // Default destructor generated.
     

    Note: There are also the -nodefault option and %nodefault directive, which disable both the default or implicit destructor generation. This could lead to memory leaks across the - target languages, and is highly recommended you don't use them.

    -

    5.5.6 Adding member - functions to C structures

    + target languages, and it is highly recommended you don't use them.

    +

    5.5.6 Adding member functions + to C structures

    Most languages provide a mechanism for creating classes and supporting object oriented programming. From a C standpoint, object oriented programming really just boils down to the process of attaching @@ -5473,7 +5881,7 @@ struct Bar { // Default destructor generated. /* file : vector.h */ ... typedef struct Vector { - double x,y,z; + double x,y,z; } Vector;

    @@ -5490,23 +5898,23 @@ typedef struct Vector { %include "vector.h" // Just grab original C header file %extend Vector { // Attach these functions to struct Vector - Vector(double x, double y, double z) { - Vector *v; - v = (Vector *) malloc(sizeof(Vector)); - v->x = x; - v->y = y; - v->z = z; - return v; - } - ~Vector() { - free($self); - } - double magnitude() { - return sqrt($self->x*$self->x+$self->y*$self->y+$self->z*$self->z); - } - void print() { - printf("Vector [%g, %g, %g]\n", $self->x,$self->y,$self->z); - } + Vector(double x, double y, double z) { + Vector *v; + v = (Vector *) malloc(sizeof(Vector)); + v->x = x; + v->y = y; + v->z = z; + return v; + } + ~Vector() { + free($self); + } + double magnitude() { + return sqrt($self->x*$self->x+$self->y*$self->y+$self->z*$self->z); + } + void print() { + printf("Vector [%g, %g, %g]\n", $self->x,$self->y,$self->z); + } }; @@ -5543,12 +5951,12 @@ typedef struct Vector { %} typedef struct Vector { - double x,y,z; - %extend { - Vector(double x, double y, double z) { ... } - ~Vector() { ... } - ... - } + double x,y,z; + %extend { + Vector(double x, double y, double z) { ... } + ~Vector() { ... } + ... + } } Vector;
    @@ -5561,19 +5969,19 @@ typedef struct Vector { /* Vector methods */ #include "vector.h" Vector *new_Vector(double x, double y, double z) { - Vector *v; - v = (Vector *) malloc(sizeof(Vector)); - v->x = x; - v->y = y; - v->z = z; - return v; + Vector *v; + v = (Vector *) malloc(sizeof(Vector)); + v->x = x; + v->y = y; + v->z = z; + return v; } void delete_Vector(Vector *v) { - free(v); + free(v); } double Vector_magnitude(Vector *v) { - return sqrt(v->x*v->x+v->y*v->y+v->z*v->z); + return sqrt(v->x*v->x+v->y*v->y+v->z*v->z); } // File : vector.i @@ -5584,13 +5992,13 @@ double Vector_magnitude(Vector *v) { %} typedef struct Vector { - double x,y,z; - %extend { - Vector(int,int,int); // This calls new_Vector() - ~Vector(); // This calls delete_Vector() - double magnitude(); // This will call Vector_magnitude() - ... - } + double x,y,z; + %extend { + Vector(int,int,int); // This calls new_Vector() + ~Vector(); // This calls delete_Vector() + double magnitude(); // This will call Vector_magnitude() + ... + } } Vector;
    @@ -5599,13 +6007,13 @@ typedef struct Vector {
     typedef struct Integer {
    -	int value;
    +  int value;
     } Int;
     %extend Integer { ...  } /* Correct name */
     %extend Int { ...  } /* Incorrect name */
     
     struct Float {
    -	float value;
    +  float value;
     };
     typedef struct Float FloatValue;
     %extend Float { ...  } /* Correct name */
    @@ -5617,7 +6025,7 @@ typedef struct Float FloatValue;
     
     typedef struct {
    -	double value;
    +  double value;
     } Double;
     %extend Double { ...  } /* Okay */
     
    @@ -5699,18 +6107,18 @@ void Person_name_set(Person *p, char *val) { name for the %addmethods directive. Since %addmethods could be used to extend a structure with more than just methods, a more suitable directive name has been chosen.

    -

    5.5.7 Nested structures

    +

    5.5.7 Nested structures

    Occasionally, a C program will involve structures like this :

     typedef struct Object {
    -	int objtype;
    -	union {
    -		int 	ivalue;
    -		double	dvalue;
    -		char	*strvalue;
    -		void	*ptrvalue;
    -	} intRep;
    +  int objtype;
    +  union {
    +    int ivalue;
    +    double dvalue;
    +    char *strvalue;
    +    void *ptrvalue;
    +  } intRep;
     } Object;
     
     
    @@ -5721,15 +6129,15 @@ typedef struct Object {
     typedef union {
    -	int 		ivalue;
    -	double		dvalue;
    -	char		*strvalue;
    -	void		*ptrvalue;
    +  int ivalue;
    +  double dvalue;
    +  char *strvalue;
    +  void *ptrvalue;
     } Object_intRep;
     
     typedef struct Object {
    -	int objType;
    -	Object_intRep intRep;
    +  int objType;
    +  Object_intRep intRep;
     } Object;
     
     
    @@ -5740,16 +6148,16 @@ typedef struct Object {
     Object_intRep *Object_intRep_get(Object *o) {
    -	return (Object_intRep *) &o->intRep;
    +  return (Object_intRep *) &o->intRep;
     }
     int Object_intRep_ivalue_get(Object_intRep *o) {
    -	return o->ivalue;
    +  return o->ivalue;
     }
     int Object_intRep_ivalue_set(Object_intRep *o, int value) {
    -	return (o->ivalue = value);
    +  return (o->ivalue = value);
     }
     double Object_intRep_dvalue_get(Object_intRep *o) {
    -	return o->dvalue;
    +  return o->dvalue;
     }
     ... etc ...
     
    @@ -5771,8 +6179,8 @@ $o->{intRep}->{ivalue} = 7              # Change value of o.intRep.ivalue
      in certain cases.

    Finally, note that nesting is handled differently in C++ mode, see Nested classes.

    -

    5.5.8 Other things to note about structure - wrapping

    +

    5.5.8 Other things to note about structure + wrapping

    SWIG doesn't care if the declaration of a structure in a .i file exactly matches that used in the underlying C code (except in the case of nested structures). For this reason, there are no problems @@ -5816,13 +6224,13 @@ _wrap_Vector_x_get(ClientData clientData, Tcl_Interp *interp, choose to build a more advanced interface. Although you may never use the low-level interface described here, most of SWIG's language modules use it in some way or another.

    -

    5.6 Code Insertion

    +

    5.6 Code Insertion

    Sometimes it is necessary to insert special code into the resulting wrapper file generated by SWIG. For example, you may want to include additional C code to perform initialization or other operations. There are four common ways to insert code, but it's useful to know how the output of SWIG is structured first.

    -

    5.6.1 The output of SWIG

    +

    5.6.1 The output of SWIG

    When SWIG creates its output file, it is broken up into five sections corresponding to runtime code, headers, wrapper functions, and module initialization code (in that order).

    @@ -5844,7 +6252,7 @@ _wrap_Vector_x_get(ClientData clientData, Tcl_Interp *interp,
    The function generated by SWIG to initialize the module upon loading.
  • -

    5.6.2 Code insertion blocks

    +

    5.6.2 Code insertion blocks

    Code is inserted into the appropriate code section by using one of the code insertion directives listed below. The order of the sections in the wrapper file is as shown:

    @@ -5904,7 +6312,7 @@ void some_extra_function() { %{ /* Create a new vector */ static Vector *new_Vector() { - return (Vector *) malloc(sizeof(Vector)); + return (Vector *) malloc(sizeof(Vector)); } %} @@ -5912,7 +6320,7 @@ static Vector *new_Vector() { Vector *new_Vector();
    -

    5.6.3 Inlined code blocks

    +

    5.6.3 Inlined code blocks

    Since the process of writing helper functions is fairly common, there is a special inlined form of code block that is used as follows :

    @@ -5920,7 +6328,7 @@ Vector *new_Vector(); %inline %{ /* Create a new vector */ Vector *new_Vector() { - return (Vector *) malloc(sizeof(Vector)); + return (Vector *) malloc(sizeof(Vector)); } %} @@ -5933,7 +6341,7 @@ Vector *new_Vector() { declaration. Since the code inside an %inline %{ ... %} block is given to both the C compiler and SWIG, it is illegal to include any SWIG directives inside a %{ ... %} block.

    -

    5.6.4 Initialization blocks

    +

    5.6.4 Initialization blocks

    When code is included in the %init section, it is copied directly into the module initialization function. For example, if you needed to perform some extra initialization on module loading, you @@ -5941,24 +6349,24 @@ Vector *new_Vector() {

     %init %{
    -	init_variables();
    +  init_variables();
     %}
     
    -

    5.7 An Interface Building Strategy

    -

    This section describes the general approach for building interface +

    5.7 An Interface Building Strategy

    +

    This section describes the general approach for building interfaces with SWIG. The specifics related to a particular scripting language are found in later chapters.

    -

    5.7.1 Preparing a C program for SWIG

    +

    5.7.1 Preparing a C program for SWIG

    SWIG doesn't require modifications to your C code, but if you feed it a collection of raw C header files or source code, the results might not be what you expect---in fact, they might be awful. Here's a series of steps you can follow to make an interface for a C program :

    • Identify the functions that you want to wrap. It's probably not - necessary to access every single function in a C program--thus, a + necessary to access every single function of a C program--thus, a little forethought can dramatically simplify the resulting scripting - language interface. C header files are particularly good source for + language interface. C header files are a particularly good source for finding things to wrap.
    • Create a new interface file to describe the scripting language interface to your program.
    • @@ -5974,7 +6382,7 @@ Vector *new_Vector() { available if it is needed, whereas SWIG will usually not warn or error out as it is designed to work without full type information. However, if type information is not specified correctly, the wrappers can be - sub-optimal and even result in uncompileable C/C++ code. + sub-optimal and even result in uncompilable C/C++ code.
    • If your program has a main() function, you may need to rename it (read on).
    • Run SWIG and compile.
    • @@ -5988,9 +6396,9 @@ Vector *new_Vector() { parser--you should report parsing errors to the swig-devel mailing list or to the SWIG bug tracker.

      -

      5.7.2 The SWIG interface file

      -

      The preferred method of using SWIG is to generate separate interface - file. Suppose you have the following C header file :

      +

      5.7.2 The SWIG interface file

      +

      The preferred method of using SWIG is to generate a separate + interface file. Suppose you have the following C header file :

       /* File : header.h */
      @@ -6036,7 +6444,7 @@ extern void dump(FILE *f);
        complex projects, an interface file containing numerous %include
        and #include statements like this is one of the most common
        approaches to interface file design due to lower maintenance overhead.

      -

      5.7.3 Why use separate interface files?

      +

      5.7.3 Why use separate interface files?

      Although SWIG can parse many header files, it is more common to write a special .i file defining the interface to a package. There are several reasons why you might want to do this:

      @@ -6055,7 +6463,7 @@ extern void dump(FILE *f); interface file and immediately see what is available without having to dig it out of header files.
    -

    5.7.4 Getting the right header files

    +

    5.7.4 Getting the right header files

    Sometimes, it is necessary to use certain header files in order for the code generated by SWIG to compile properly. Make sure you include certain header files by using a %{,%} block like this:

    @@ -6067,11 +6475,11 @@ extern void dump(FILE *f); #include <GL/glu.h> %} -// Put rest of declarations here +// Put the rest of the declarations here ...
    -

    5.7.5 What to do with main()

    +

    5.7.5 What to do with main()

    If your program defines a main() function, you may need to get rid of it or rename it in order to use a scripting language. Most scripting languages define their own main() procedure that is @@ -6096,7 +6504,7 @@ extern void dump(FILE *f); by using a scripting language, you are probably trying to create a program that is more interactive. In many cases, the old main() program can be completely replaced by a Perl, Python, or Tcl script.

    -

    Note: If some cases, you might be inclined to create a +

    Note: In some cases, you might be inclined to create a scripting language wrapper for main(). If you do this, the compilation will probably work and your module might even load correctly. The only trouble is that when you call your main() @@ -6105,7 +6513,7 @@ extern void dump(FILE *f); effect of the symbol binding mechanism used in the dynamic linker. The bottom line: don't do this.


    -

    6 SWIG and C++

    +

    6 SWIG and C++

    @@ -6182,7 +6590,7 @@ extern void dump(FILE *f); Basics to see how SWIG wraps ANSI C. Support for C++ builds upon ANSI C wrapping and that material will be useful in understanding this chapter.

    -

    6.1 Comments on C++ Wrapping

    +

    6.1 Comments on C++ Wrapping

    Because of its complexity and the fact that C++ can be difficult to integrate with itself let alone other languages, SWIG only provides support for a subset of C++ features. Fortunately, this is now a rather @@ -6213,7 +6621,7 @@ extern void dump(FILE *f); complicates the problem of crossing language boundaries and provides many opportunities to shoot yourself in the foot. You will just have to be careful.

    -

    6.2 Approach

    +

    6.2 Approach

    To wrap C++, SWIG uses a layered approach to code generation. At the lowest level, SWIG generates a collection of procedural ANSI-C style wrappers. These wrappers take care of basic type conversion, type @@ -6245,7 +6653,7 @@ extern void dump(FILE *f); mind that the target languages also provide the high-level OO interface via proxy classes. More detailed coverage can be found in the documentation for each target language.

    -

    6.3 Supported C++ features

    +

    6.3 Supported C++ features

    SWIG currently supports most C++ features including the following:

    • Classes
    • @@ -6265,8 +6673,6 @@ extern void dump(FILE *f);

      The following C++ features are not currently supported:

      • Overloaded versions of certain operators (new, delete, etc.)
      • -
      • Nested classes, see Nested - classes for workarounds.

      As a rule of thumb, SWIG should not be used on raw C++ source files, use header files only.

      @@ -6274,7 +6680,7 @@ extern void dump(FILE *f); limitations may be lifted in future releases. However, we make no promises. Also, submitting a bug report is a very good way to get problems fixed (wink).

      -

      6.4 Command line options and compilation

      +

      6.4 Command line options and compilation

      When wrapping C++ code, it is critical that SWIG be called with the `-c++' option. This changes the way a number of critical features such as memory management are handled. It also enables the @@ -6286,7 +6692,7 @@ extern void dump(FILE *f);

       $ swig -c++ -tcl example.i
      -$ c++ -c example_wrap.cxx 
      +$ c++ -fPIC -c example_wrap.cxx 
       $ c++ example_wrap.o $(OBJS) -o example.so
       
      @@ -6297,7 +6703,7 @@ $ c++ example_wrap.o $(OBJS) -o example.so flattened low-level C style API to C++ classes by default. The -noproxy commandline option is recognised by many target languages and will generate just this interface as in earlier versions. -

      6.5 Proxy classes

      +

      6.5 Proxy classes

      In order to provide a natural mapping from C++ classes to the target language classes, SWIG's target languages mostly wrap C++ classes with special proxy classes. These proxy classes are typically implemented in @@ -6305,7 +6711,7 @@ $ c++ example_wrap.o $(OBJS) -o example.so module, each C++ class is wrapped by a Python proxy class. Or if you're building a Java module, each C++ class is wrapped by a Java proxy class.

      -

      6.5.1 Construction of proxy classes

      +

      6.5.1 Construction of proxy classes

      Proxy classes are always constructed as an extra layer of wrapping that uses low-level accessor functions. To illustrate, suppose you had a C++ class like this:

      @@ -6372,7 +6778,7 @@ class Foo: proxies try to take advantage of language features that are similar to C++. This might include operator overloading, exception handling, and other features.

      -

      6.5.2 Resource management in proxies

      +

      6.5.2 Resource management in proxies

      A major issue with proxies concerns the memory management of wrapped objects. Consider the following C++ code:

      @@ -6494,11 +6900,11 @@ class SpamProxy { management problem. However, proxies do provide a mechanism for manual control that can be used (if necessary) to address some of the more tricky memory management problems.

      -

      6.5.3 Language specific details

      +

      6.5.3 Language specific details

      Language specific details on proxy classes are contained in the chapters describing each target language. This chapter has merely introduced the topic in a very general way.

      -

      6.6 Simple C++ wrapping

      +

      6.6 Simple C++ wrapping

      The following code shows a SWIG interface file for a simple C++ class.

      @@ -6526,22 +6932,22 @@ static void print(List *l);

      To generate wrappers for this class, SWIG first reduces the class to a collection of low-level C-style accessor functions which are then used by the proxy classes.

      -

      6.6.1 Constructors and destructors

      +

      6.6.1 Constructors and destructors

      C++ constructors and destructors are translated into accessor functions such as the following :

       List * new_List(void) {
      -	return new List;
      +  return new List;
       }
       void delete_List(List *l) {
      -	delete l;
      +  delete l;
       }
       
       
      -

      6.6.2 Default constructors, copy - constructors and implicit destructors

      +

      6.6.2 Default constructors, copy constructors + and implicit destructors

      Following the C++ rules for implicit constructor and destructors, SWIG will automatically assume there is one even when they are not explicitly declared in the class interface.

      @@ -6640,8 +7046,8 @@ class Foo { // No destructor is generated, unless one is declared options described above, which disable both the default constructor and the implicit destructors, could lead to memory leaks, and so it is strongly recommended to not use them.

      -

      6.6.3 When constructor wrappers aren't - created

      +

      6.6.3 When constructor wrappers aren't + created

      If a class defines a constructor, SWIG normally tries to generate a wrapper for it. However, SWIG will not generate a constructor wrapper if it thinks that it will result in illegal wrapper code. There are @@ -6699,7 +7105,7 @@ public:

      More information about %feature can be found in the Customization features chapter.

      -

      6.6.4 Copy constructors

      +

      6.6.4 Copy constructors

      If a class defines more than one constructor, its behavior depends on the capabilities of the target language. If overloading is supported, the copy constructor is accessible using the normal @@ -6770,13 +7176,13 @@ public: copy-constructor handling if the constructor has been manually renamed. For instance, in the above example, the name of the constructor is set to new_CopyFoo(). This is the same as in older versions.

      -

      6.6.5 Member functions

      +

      6.6.5 Member functions

      All member functions are roughly translated into accessor functions like this :

       int List_search(List *obj, char *value) {
      -	return obj->search(value);
      +  return obj->search(value);
       }
       
       
      @@ -6789,23 +7195,23 @@ int List_search(List *obj, char *value) { wrapper functions. However, the name and calling convention of the low-level procedural wrappers match the accessor function prototype described above.

      -

      6.6.6 Static members

      +

      6.6.6 Static members

      Static member functions are called directly without making any special transformations. For example, the static member function print(List *l) directly invokes List::print(List *l) in the generated wrapper code.

      -

      6.6.7 Member data

      +

      6.6.7 Member data

      Member data is handled in exactly the same manner as for C structures. A pair of accessor functions are effectively created. For example :

       int List_length_get(List *obj) {
      -	return obj->length;
      +  return obj->length;
       }
       int List_length_set(List *obj, int value) {
      -	obj->length = value;
      -	return value;
      +  obj->length = value;
      +  return value;
       }
       
       
      @@ -6821,7 +7227,7 @@ class List { public: ... %immutable; - int length; + int length; %mutable; ... }; @@ -6842,8 +7248,10 @@ class List {

      Similarly, all data attributes declared as const are wrapped as read-only members.

      -

      There are some subtle issues when wrapping data members that are - themselves classes. For instance, if you had another class like this,

      +

      By default, SWIG uses the const reference typemaps for members that + are primitive types. There are some subtle issues when wrapping data + members that are not primitive types, such as classes. For instance, if + you had another class like this,

       class Foo {
      @@ -6873,8 +7281,22 @@ void Foo_items_set(Foo *self, List *value) {
        variables to be wrapped as a string in the target language, rather than
        a pointer to this class. The const reference typemaps offer this type
        of marshalling, so there is a feature to tell SWIG to use the const
      - reference typemaps rather than the pointer typemaps. It is the 
      -%naturalvar directive and is used as follows:

      + reference typemaps rather than the pointer typemaps. It is the + naturalvar feature and can be used to effectively change the way + accessors are generated to the following:

      +
      +
      +const List &Foo_items_get(Foo *self) {
      +    return self->items;
      +}
      +void Foo_items_set(Foo *self, const List &value) {
      +    self->items = value;
      +}
      +
      +
      +

      The %naturalvar directive is a macro for, and hence + equivalent to, %feature("naturalvar"). It can be used as + follows:

       // All List variables will use const List& typemaps
      @@ -6886,37 +7308,31 @@ struct Foo {
         List myList;
       };
       
      -// All variables will use const reference typemaps
      +// All non-primitive types will use const reference typemaps
       %naturalvar;
       

      The observant reader will notice that %naturalvar works like any other feature flag - directive, except it can also be attached to class types. The first of - the example usages above show %naturalvar attaching to the -List class. Effectively this feature changes the way accessors are - generated to the following:

      -
      -
      -const List &Foo_items_get(Foo *self) {
      -    return self->items;
      -}
      -void Foo_items_set(Foo *self, const List &value) {
      -    self->items = value;
      -}
      -
      -
      -

      In fact it is generally a good idea to use this feature globally as - the reference typemaps have extra NULL checking compared to the pointer + directive but with some extra flexibility. The first of the example + usages above shows %naturalvar attaching to the myList +'s variable type, that is the List class. The second usage + shows %naturalvar attaching to the variable name. Hence the + naturalvar feature can be used on either the variable's name or type. + Note that using the naturalvar feature on a variable's name overrides + any naturalvar feature attached to the variable's type.

      +

      It is generally a good idea to use this feature globally as the + reference typemaps have extra NULL checking compared to the pointer typemaps. A pointer can be NULL, whereas a reference cannot, so the extra checking ensures that the target language user does not pass in a value that translates to a NULL pointer and thereby preventing any potential NULL pointer dereferences. The %naturalvar feature will apply to global variables in addition to member variables in some language modules, eg C# and Java.

      -

      Other alternatives for turning this feature on globally are to use - the swig -naturalvar commandline option or the module mode - option, %module(naturalvar=1)

      +

      The naturalvar behavior can also be turned on as a global setting + via the -naturalvar commandline option or the module mode + option, %module(naturalvar=1). However, any use of +%feature("naturalvar") will override the global setting.

      Compatibility note: The %naturalvar feature was introduced in SWIG-1.3.28, prior to which it was necessary to manually apply the const reference typemaps, eg %apply const std::string & { @@ -6945,7 +7361,7 @@ struct Foo { involving size_t. This change is subtle, but it smooths over a few problems related to structure wrapping and some of SWIG's customization features.

      -

      6.7 Default arguments

      +

      6.7 Default arguments

      SWIG will wrap all types of functions that have default arguments. For example member functions:

      @@ -7020,17 +7436,20 @@ public: };
      -

      This produces uncompileable wrapper code because default values in +

      This produces uncompilable wrapper code because default values in C++ are evaluated in the same scope as the member function whereas SWIG evaluates them in the scope of a wrapper function (meaning that the values have to be public).

      -

      This feature is automatically turned on when wrapping -C code with default arguments and whenever keyword arguments - (kwargs) are specified for either C or C++ code. Keyword arguments are - a language feature of some scripting languages, for example Ruby and - Python. SWIG is unable to support kwargs when wrapping overloaded - methods, so the default approach cannot be used.

      -

      6.8 Protection

      +

      The compactdefaultargs feature is automatically turned on + when wrapping C code with default + arguments. Some target languages will also automatically turn on + this feature if the keyword arguments feature (kwargs) is specified for + either C or C++ functions, and the target language supports kwargs, the + compactdefaultargs feature is also automatically turned on. + Keyword arguments are a language feature of some scripting languages, + for example Ruby and Python. SWIG is unable to support kwargs when + wrapping overloaded methods, so the default approach cannot be used.

      +

      6.8 Protection

      SWIG wraps class members that are public following the C++ conventions, i.e., by explicit public declaration or by the use of the using directive. In general, anything specified in a private or @@ -7042,7 +7461,7 @@ using directive. In general, anything specified in a private or

      By default, members of a class definition are assumed to be private until you explicitly give a `public:' declaration (This is the same convention used by C++).

      -

      6.9 Enums and constants

      +

      6.9 Enums and constants

      Enumerations and constants are handled differently by the different language modules and are described in detail in the appropriate language chapter. However, many languages map enums and constants in a @@ -7052,7 +7471,7 @@ using directive. In general, anything specified in a private or

       class Swig {
       public:
      -	enum {ALE, LAGER, PORTER, STOUT};
      +  enum {ALE, LAGER, PORTER, STOUT};
       };
       
       
      @@ -7070,7 +7489,7 @@ Swig_STOUT = Swig::STOUT

      Members declared as const are wrapped as read-only members and do not create constants.

      -

      6.10 Friends

      +

      6.10 Friends

      Friend declarations are recognised by SWIG. For example, if you have this code:

      @@ -7114,14 +7533,14 @@ namespace bar {

      and a wrapper for the method 'blah' will not be generated.

      -

      6.11 References and pointers

      +

      6.11 References and pointers

      C++ references are supported, but SWIG transforms them back into pointers. For example, a declaration like this :

       class Foo {
       public:
      -	double bar(double &a);
      +  double bar(double &a);
       }
       
      @@ -7129,7 +7548,7 @@ public:
       double Foo_bar(Foo *obj, double *a) {
      -	obj->bar(*a);
      +  obj->bar(*a);
       }
       
      @@ -7185,7 +7604,7 @@ const int &bar(); datatypes is necessary to provide more seamless integration with more advanced C++ wrapping applications---especially related to templates and the STL. This was first added in SWIG-1.3.12.

      -

      6.12 Pass and return by value

      +

      6.12 Pass and return by value

      Occasionally, a C++ program will pass and return class objects by value. For example, a function like this might appear:

      @@ -7260,7 +7679,7 @@ struct B {

      Note: The use of this template only occurs when objects are passed or returned by value. It is not used for C++ pointers or references.

      -

      6.13 Inheritance

      +

      6.13 Inheritance

      SWIG supports C++ inheritance of classes and allows both single and multiple inheritance, as limited or allowed by the target language. The SWIG type-checker knows about the relationship between base and derived @@ -7271,7 +7690,7 @@ struct B { spirit, and target language capabilities, as possible. In most cases, this means that SWIG will parse the non-public inheritance declarations, but that will have no effect in the generated code, - besides the implicit policies derived for constructor and destructors.

      + besides the implicit policies derived for constructors and destructors.

      The following example shows how SWIG handles inheritance. For clarity, the full C++ code has been omitted.

      @@ -7284,24 +7703,24 @@ struct B { class Shape { public: - double x,y; - virtual double area() = 0; - virtual double perimeter() = 0; - void set_location(double x, double y); + double x,y; + virtual double area() = 0; + virtual double perimeter() = 0; + void set_location(double x, double y); }; class Circle : public Shape { public: - Circle(double radius); - ~Circle(); - double area(); - double perimeter(); + Circle(double radius); + ~Circle(); + double area(); + double perimeter(); }; class Square : public Shape { public: - Square(double size); - ~Square(); - double area(); - double perimeter(); + Square(double size); + ~Square(); + double area(); + double perimeter(); }
      @@ -7406,8 +7825,8 @@ Square_set_location(). This behavior resulted in huge amounts of using the -fvirtual option, which avoids the regenerating of wrapper functions for virtual members that are already defined in a base class.

      -

      6.14 A brief discussion of multiple - inheritance, pointers, and type checking

      +

      6.14 A brief discussion of multiple + inheritance, pointers, and type checking

      When a target scripting language refers to a C++ object, it normally uses a tagged pointer object that contains both the value of the pointer and a type string. For example, in Tcl, a C++ pointer might be @@ -7507,8 +7926,8 @@ int y = B_function((B *) pB);

      In practice, the pointer is held as an integral number in the target language proxy class.

      -

      6.15 Wrapping Overloaded - Functions and Methods

      +

      6.15 Wrapping Overloaded + Functions and Methods

      In many language modules, SWIG provides partial support for overloaded functions, methods, and constructors. For example, if you supply SWIG with overloaded functions like this:

      @@ -7554,7 +7973,7 @@ public: >>> f.bar("hello",2)
      -

      6.15.1 Dispatch function generation

      +

      6.15.1 Dispatch function generation

      The implementation of overloaded functions and methods is somewhat complicated due to the dynamic nature of scripting languages. Unlike C++, which binds overloaded methods at compile time, SWIG must @@ -7651,7 +8070,7 @@ rank appear in this ranking.

      If you're still confused, don't worry about it---SWIG is probably doing the right thing.

      -

      6.15.2 Ambiguity in Overloading

      +

      6.15.2 Ambiguity in Overloading

      Regrettably, SWIG is not able to support every possible use of valid C++ overloading. Consider the following example:

      @@ -7706,18 +8125,19 @@ at example.i:3 used. they appear in the interface file. Therefore, earlier methods will shadow methods that appear later.

      When wrapping an overloaded function, there is a chance that you - will get an error message like this:

      + will get a warning message like this:

      -example.i:3: Warning 467: Overloaded foo(int) not supported (no type checking
      -rule for 'int').
      +example.i:3: Warning 467: Overloaded foo(int) not supported (incomplete type checking rule - 
      +no precedence level in typecheck typemap for 'int').
       

      This error means that the target language module supports overloading, but for some reason there is no type-checking rule that can be used to generate a working dispatch function. The resulting behavior is then undefined. You should report this as a bug to the -SWIG bug tracking database.

      +SWIG bug tracking database if this is due to one of the typemaps + supplied with SWIG.

      If you get an error message such as the following,

      @@ -7730,8 +8150,8 @@ foo.i:5. Previous declaration is Spam::foo(int )
       

      it means that the target language module has not yet implemented support for overloaded functions and methods. The only way to fix the problem is to read the next section.

      -

      6.15.3 - Ambiguity resolution and renaming

      +

      6.15.3 Ambiguity + resolution and renaming

      If an ambiguity in overload resolution occurs or if a module doesn't allow overloading, there are a few strategies for dealing with the problem. First, you can tell SWIG to ignore one of the methods. This is @@ -7998,7 +8418,8 @@ public:

      Currently no resolution is performed in order to match function parameters. This means function parameter types must match exactly. For example, namespace qualifiers and typedefs will not work. The following - usage of typedefs demonstrates this:

      + usage of typedefs demonstrates this:

      +
       typedef int Integer;
       
      @@ -8013,8 +8434,7 @@ public:
          void foo(int);      // Renamed to foo_i
       };
       
      -

      - +
    • The name matching rules also use default arguments for finer control when wrapping methods that have default arguments. Recall that methods @@ -8070,7 +8490,7 @@ newbar(2, 2.0), newbar(2) or newbar(). However, the changes to wrapping methods with default arguments was introduced.

    -

    6.15.4 Comments on overloading

    +

    6.15.4 Comments on overloading

    Support for overloaded methods was first added in SWIG-1.3.14. The implementation is somewhat unusual when compared to similar tools. For instance, the order in which declarations appear is largely irrelevant @@ -8081,7 +8501,7 @@ newbar(2, 2.0), newbar(2) or newbar(). However, support may vary from language to language. As a general rule, statically typed languages like Java are able to provide more support than dynamically typed languages like Perl, Python, Ruby, and Tcl.

    -

    6.16 Wrapping overloaded operators

    +

    6.16 Wrapping overloaded operators

    C++ overloaded operator declarations can be wrapped. For example, consider a class like this:

    @@ -8105,7 +8525,7 @@ public: } Complex operator*(const Complex &c) const { return Complex(rpart*c.rpart - ipart*c.ipart, - rpart*c.ipart + c.rpart*ipart); + rpart*c.ipart + c.rpart*ipart); } Complex operator-() const { return Complex(-rpart, -ipart); @@ -8218,7 +8638,7 @@ Complex operator+(Complex &, double);
  • The semantics of certain C++ operators may not match those in the target language.
  • -

    6.17 Class extension

    +

    6.17 Class extension

    New methods can be added to a class using the %extend directive. This directive is primarily used in conjunction with proxy classes to add additional functionality to an existing class. For @@ -8232,17 +8652,17 @@ Complex operator+(Complex &, double); class Vector { public: - double x,y,z; - Vector(); - ~Vector(); - ... bunch of C++ methods ... - %extend { - char *__str__() { - static char temp[256]; - sprintf(temp,"[ %g, %g, %g ]", $self->x,$self->y,$self->z); - return &temp[0]; - } - } + double x,y,z; + Vector(); + ~Vector(); + ... bunch of C++ methods ... + %extend { + char *__str__() { + static char temp[256]; + sprintf(temp,"[ %g, %g, %g ]", $self->x,$self->y,$self->z); + return &temp[0]; + } + } };

    @@ -8294,7 +8714,7 @@ struct Derived : Base {

    The following special variables are expanded if used within a %extend block: $name, $symname, $overname, $decl, $fulldecl, - $parentname and $parentsymname. The + $parentclassname and $parentclasssymname. The Special variables section provides more information each of these special variables.

    The %extend directive follows all of the same conventions @@ -8304,7 +8724,7 @@ Adding member functions to C structures section for further details.

    name for the %addmethods directive in SWIG1.1. Since %addmethods could be used to extend a structure with more than just methods, a more suitable directive name has been chosen.

    -

    6.18 Templates

    +

    6.18 Templates

    Template type names may appear anywhere a type is expected in an interface file. For example:

    @@ -8842,7 +9262,7 @@ public: template<class T> class List { ... public: - List() { }; + List() { } T get(int index); ... }; @@ -8883,10 +9303,42 @@ template<class T> void foo(T x, T y) { }; point is that SWIG does not perform extensive error checking of templates! Specifically, SWIG does not perform type checking nor does it check to see if the actual contents of the template declaration - make any sense. Since the C++ compiler will hopefully check this when - it compiles the resulting wrapper file, there is no practical reason - for SWIG to duplicate this functionality (besides, none of the SWIG - developers are masochistic enough to want to implement this right now).

    + make any sense. Since the C++ compiler checks this when it compiles the + resulting wrapper file, there is no practical reason for SWIG to + duplicate this functionality.

    + +

    As SWIG's template support does not perform type checking +%template can be used as early as after a template declaration. You + can, and rarely have to, use %template before the template + parameters have been declared. For example:

    +
    +
    +template <class T> class OuterTemplateClass {};
    +
    +// The nested class OuterClass::InnerClass inherits from the template class
    +// OuterTemplateClass<OuterClass::InnerStruct> and thus the template needs
    +// to be expanded with %template before the OuterClass declaration.
    +%template(OuterTemplateClass_OuterClass__InnerStruct)
    +    OuterTemplateClass<OuterClass::InnerStruct>
    +
    +
    +// Don't forget to use %feature("flatnested") for OuterClass::InnerStruct and
    +// OuterClass::InnerClass if the target language doesn't support nested classes.
    +class OuterClass {
    +    public:
    +        // Forward declarations:
    +        struct InnerStruct;
    +        class InnerClass;
    +};
    +
    +struct OuterClass::InnerStruct {};
    +
    +// Expanding the template at this point with %template is too late as the
    +// OuterClass::InnerClass declaration is processed inside OuterClass.
    +
    +class OuterClass::InnerClass : public OuterTemplateClass<InnerStruct> {};
    +
    +

    Compatibility Note: The first implementation of template support relied heavily on macro expansion in the preprocessor. Templates have been more tightly integrated into the parser and type @@ -8916,7 +9368,7 @@ template<class T> void foo(T x, T y) { };

    Similar changes apply to typemaps and other customization features.

    -

    6.19 Namespaces

    +

    6.19 Namespaces

    Support for C++ namespaces is comprehensive, but by default simple, however, some target languages can turn on more advanced namespace support via the nspace feature, @@ -9275,8 +9727,8 @@ namespace foo { modules are currently programmed with any namespace awareness. In the future, language modules may or may not provide more advanced namespace support.

    -

    6.19.1 The nspace feature for - namespaces

    +

    6.19.1 The nspace feature for namespaces +

    Some target languages provide support for the nspace feature. The feature can be applied to any class, struct, union or enum declared within a named namespace. The feature wraps the type @@ -9343,8 +9795,8 @@ namespace MyWorld {

    Compatibility Note: The nspace feature was first introduced in SWIG-2.0.0.

    -

    6.20 - Renaming templated types in namespaces

    +

    6.20 Renaming + templated types in namespaces

    As has been mentioned, when %rename includes parameters, the parameter types must match exactly (no typedef or namespace resolution is performed). SWIG treats templated types slightly differently and has @@ -9415,8 +9867,8 @@ namespace Space { %template(ABCXYZ) Space::ABC<Space::XYZ>;

    -

    6.21 Exception - specifications

    +

    6.21 Exception + specifications

    When C++ programs utilize exceptions, exceptional behavior is sometimes specified as part of a function or method declaration. For example:

    @@ -9456,7 +9908,7 @@ except Error,e: "Exception handling with %exception " section for details. The next section details a way of simulating an exception specification or replacing an existing one.

    -

    6.22 Exception handling with %catches

    +

    6.22 Exception handling with %catches

    Exceptions are automatically handled for methods with an exception specification. Similar handling can be achieved for methods without exception specifications through the %catches feature. It is @@ -9501,7 +9953,7 @@ Foo::blah(), SWIG will generate catch handlers for all of the types single catch handler for the base class, EBase will be generated to convert the C++ exception into a target language error/exception.

    -

    6.23 Pointers to Members

    +

    6.23 Pointers to Members

    Starting with SWIG-1.3.7, there is limited parsing support for pointers to C++ class members. For example:

    @@ -9532,8 +9984,8 @@ _ff0d54a800000000_m_Object__f_double_double__double with member pointers. Normally SWIG tries to keep track of inheritance when checking types. However, no such support is currently provided for member pointers.

    -

    6.24 Smart pointers and - operator->()

    +

    6.24 Smart pointers and + operator->()

    In some C++ programs, objects are often encapsulated by smart-pointers or proxy classes. This is sometimes done to implement automatic memory management (reference counting) or persistence. @@ -9698,10 +10150,11 @@ p = f.__deref__() # Raw pointer from operator->

    Note: Smart pointer support was first added in SWIG-1.3.14.

    -

    6.25 C++ reference counted objects - - ref/unref feature

    +

    6.25 C++ reference counted objects - + ref/unref feature

    Another similar idiom in C++ is the use of reference counted - objects. Consider for example:

    + objects. Consider for example:

    +
     class RCObj  {
       // implement the ref counting mechanism
    @@ -9716,11 +10169,11 @@ public:
         return add_ref();
       }
     
    -  int unref() const   {
    +  int unref() const {
         if (ref_count() == 0 || del_ref() == 0 ) {
    -	delete this;
    -	return 0;
    -      } 
    +      delete this;
    +      return 0;
    +    }
         return ref_count();
       }
     };
    @@ -9760,7 +10213,7 @@ int main() {
       a->unref();         // 'a' unref and deleted (count: 0)
     }
     
    -

    +

    In the example above, the 'A' class instance 'a' is a reference counted object, which can't be deleted arbitrarily since it is shared between the objects 'b1' and 'b2'. 'A' is derived from a Reference @@ -9836,7 +10289,7 @@ a = AFactory() # SWIG ref 'a' due to %newobject (count: 1) exit # 'a' is released, SWIG unref 'a' called in the destructor wrapper (count: 0) -

    6.26 Using declarations and inheritance

    +

    6.26 Using declarations and inheritance

    using declarations are sometimes used to adjust access to members of base classes. For example:

    @@ -9970,134 +10423,61 @@ public:
    -

    6.27 Nested classes

    -

    There is some support for nested structs and unions when wrapping C - code, see Nested structures for - further details. The added complexity of C++ compared to C means this - approach does not work well for C++ code (when using the -c++ command - line option). For C++, a nested class is treated much like an opaque - pointer, so anything useful within the nested class, such as its - methods and variables, are not accessible from the target language. - True nested class support may be added to SWIG in the future, however, - until then some of the following workarounds can be applied to improve - the situation.

    -

    It might be possible to use partial class information as often you - can accept that the nested class is not needed, especially if it is not - actually used in any methods you need from the target language. Imagine - you are wrapping the following Outer class which contains a - nested class Inner. The easiest thing to do is turn a blind - eye to the warning that SWIG generates, or simply suppress it:

    -
    -
    -%warnfilter(SWIGWARN_PARSE_NAMED_NESTED_CLASS) Outer::Inner;
    -
    -class Outer {
    -public:
    -  class Inner {
    -    public:
    -      ...
    -  };
    -  Inner getInner();
    -  void useInner(const Inner& inner);
    -  ...
    -};
    -
    -
    -

    Note that if Inner can be used as an opaque type, the - default wrapping approach suffices. For example, if the nested class - does not need to be created from the target language, but can be - obtained via a method call, such as the getInner() method - above, the returned value can then be passed around, such as passed - into the useInner() method.

    -

    With some more effort the above situation can be improved somewhat - and a nested class can be constructed and used from the target language - much like any other non-nested class. Assuming we have the Outer - class in a header file:

    -
    -
    -// File outer.h
    -class Outer {
    -public:
    -  class Inner {
    -    public:
    -      int var;
    -      Inner(int v = 0) : var(v) {}
    -  };
    -  Inner getInner();
    -  void useInner(const Inner& inner);
    -};
    -
    -
    -

    The following interface file works around the nested class - limitations by redefining the nested class as a global class. A typedef - for the compiler and the nestedworkaround -feature flag is also required in order for the generated wrappers to - compile. This flag simply removes all the type information from SWIG, - so SWIG treats the nested class as if it had not been parsed at all.

    -
    -
    -// File : example.i
    -%module example
    -
    -// Redefine nested class in global scope in order for SWIG to generate
    -// a proxy class. Only SWIG parses this definition.
    -class Inner {
    +

    6.27 Nested classes

    +

    If the target language supports the nested classes concept (like + Java), the nested C++ classes are wrapped as nested target language + proxy classes. (In case of Java - "static" nested classes.) Only public + nested classes are wrapped. Otherwise there is little difference + between nested and normal classes.

    +

    If the target language doesn't support nested classes directly, or + the support is not implemented in the language module (like for python + currently), then the visible nested classes are moved to the same name + space as the containing class (nesting hierarchy is "flattened"). The + same behaviour may be turned on for C# and Java by the %feature + ("flatnested"); If there is a class with the same name in the outer + namespace the inner class (or the global one) may be renamed or + ignored:

    +
    +
    +%rename (Bar_Foo) Bar::Foo;
    +class Foo {};
    +class Bar {
       public:
    -    int var;
    -    Inner(int v = 0) : var(v) {}
    -};
    -
    -%nestedworkaround Outer::Inner;
    -
    -%{
    -#include "outer.h"
    -%}
    -%include "outer.h"
    -
    -// We've fooled SWIG into thinking that Inner is a global class, so now we need
    -// to trick the C++ compiler into understanding this apparent global type.
    -%{
    -typedef Outer::Inner Inner;
    -%}
    -
    -
    -

    The downside to this approach is a more complex interface file and - having to maintain two definitions of Inner, the real one and - the one in the interface file that SWIG parses. However, the upside is - that all the methods/variables in the nested class are available from - the target language as a proxy class is generated instead of treating - the nested class as an opaque type. The proxy class can be constructed - from the target language and passed into any methods accepting the - nested class. Also note that the original header file is parsed - unmodified.

    -

    Finally, conditional compilation can be used as a workaround to - comment out nested class definitions in the actual headers, assuming - you are able to modify them.

    -
    + class Foo {}; +}; +
    +
    +

    If a nested class, within an outer class, has to be used as a + template parameter within the outer class, then the template will have + to be instantiated with %template before the beginning of the + outer class. An example can be found in the +Templates section.

    +

    Compatibility Note: Prior to SWIG-3.0.0, there was limited + nested class support. Nested classes were treated as opaque pointers. + However, there was a workaround for nested class support in these older + versions requiring the user to replicate the nested class in the global + scope, adding in a typedef for the nested class in the global scope and + using the "nestedworkaround" feature on the nested class. This resulted + in approximately the same behaviour as the "flatnested" feature. With + proper nested class support now available in SWIG-3.0.0, this feature + has been deprecated and no longer works requiring code changes. If you + see the following warning:

    +
    -// File outer.h
    -class Outer {
    -public:
    -#ifndef SWIG
    -  class Inner {
    -    public:
    -      ...
    -  };
    -#endif
    -  ...
    -};
    +example.i:8: Warning 126: The nestedworkaround feature is deprecated
     
    -

    This workaround used to be common when SWIG could not deal with - nested classes particulary well. This should just be a last resort for - unusual corner cases now as SWIG can parse nested classes and even - handle nested template classes fairly well.

    -

    Compatibility Note: SWIG-1.3.40 and earlier versions did not - have the nestedworkaround feature and the generated code - resulting from parsing nested classes did not always compile. Nested - class warnings could also not be suppressed using %warnfilter.

    -

    6.28 A brief rant about - const-correctness

    +

    consider using the "flatnested" feature discussed above which + generates a non-nested proxy class, like the "nestedworkaround" feature + did. Alternatively, use the default nested class code generation, which + may generate an equivalent to a nested proxy class in the target + language, depending on the target language support.

    +

    SWIG-1.3.40 and earlier versions did not have the +nestedworkaround feature and the generated code resulting from + parsing nested classes did not always compile. Nested class warnings + could also not be suppressed using %warnfilter.

    +

    6.28 A brief rant about const-correctness +

    A common issue when working with C++ programs is dealing with all possible ways in which the const qualifier (or lack thereof) will break your program, all programs linked against your program, and @@ -10136,7 +10516,7 @@ void blah() { a problem for most SWIG projects. Of course, you might want to consider using another tool if maintaining constness is the most important part of your project.

    -

    6.29 Where to go for more information

    +

    6.29 Where to go for more information

    If you're wrapping serious C++ code, you might want to pick up a copy of "The Annotated C++ Reference Manual" by Ellis and Stroustrup. This is the reference document we use to guide a lot of SWIG's C++ @@ -10151,8793 +10531,10035 @@ void blah() {


    -

    7 Preprocessing

    +

    7 SWIG and C++11

    -

    SWIG includes its own enhanced version of the C preprocessor. The - preprocessor supports the standard preprocessor directives and macro - expansion rules. However, a number of modifications and enhancements - have been made. This chapter describes some of these modifications.

    -

    7.1 File inclusion

    -

    To include another file into a SWIG interface, use the %include - directive like this:

    +

    7.1 Introduction

    +

    This chapter gives you a brief overview about the SWIG implementation + of the C++11 standard. This part of SWIG is still a work in progress.

    +

    SWIG supports the new C++ syntax changes with some minor limitations + in some areas such as decltype expressions and variadic templates. + Wrappers for the new STL types (unordered_ containers, result_of, + tuples) are incomplete. The wrappers for the new containers would work + much like the C++03 containers and users are welcome to help by + adapting the existing container interface files and submitting them as + a patch for inclusion in future versions of SWIG.

    +

    7.2 Core language + changes

    +

    7.2.1 + Rvalue reference and move semantics

    +

    SWIG correctly parses the rvalue reference syntax '&&', for example + the typical usage of it in the move constructor and move assignment + operator below:

    -%include "pointer.i"
    +class MyClass {
    +...
    +  std::vector<int> numbers;
    +public:
    +  MyClass(MyClass &&other) : numbers(std::move(other.numbers)) {}
    +  MyClass & operator=(MyClass &&other) {
    +    numbers = std::move(other.numbers);
    +    return *this;
    +  }
    +};
     
    -

    Unlike, #include, %include includes each file once - (and will not reload the file on subsequent %include - declarations). Therefore, it is not necessary to use include-guards in - SWIG interfaces.

    -

    By default, the #include is ignored unless you run SWIG - with the -includeall option. The reason for ignoring - traditional includes is that you often don't want SWIG to try and wrap - everything included in standard header system headers and auxiliary - files.

    -

    7.2 File imports

    -

    SWIG provides another file inclusion directive with the %import - directive. For example:

    +

    Rvalue references are designed for C++ temporaries and so are not + very useful when used from non-C++ target languages. Generally you + would just ignore them via %ignore before parsing the class. + For example, ignore the move constructor:

    -%import "foo.i"
    +%ignore MyClass::MyClass(MyClass &&);
     
    -

    The purpose of %import is to collect certain information - from another SWIG interface file or a header file without actually - generating any wrapper code. Such information generally includes type - declarations (e.g., typedef) as well as C++ classes that might - be used as base-classes for class declarations in the interface. The - use of %import is also important when SWIG is used to generate - extensions as a collection of related modules. This is an advanced - topic and is described in later in the Working with - Modules chapter.

    -

    The -importall directive tells SWIG to follow all -#include statements as imports. This might be useful if you want to - extract type definitions from system header files without generating - any wrappers.

    -

    7.3 Conditional - Compilation

    -

    SWIG fully supports the use of #if, #ifdef, -#ifndef, #else, #endif to conditionally include - parts of an interface. The following symbols are predefined by SWIG - when it is parsing the interface:

    -
    +

    The plan is to ignore move constructors by default in a future + version of SWIG. Note that both normal assignment operators as well as + move assignment operators are ignored by default in most target + languages with the following warning:

    +
    -SWIG                            Always defined when SWIG is processing a file
    -SWIGIMPORTED                    Defined when SWIG is importing a file with %import
    -SWIG_VERSION                    Hexadecimal (binary-coded decimal) number containing SWIG version,
    -                                such as 0x010311 (corresponding to SWIG-1.3.11).
    -
    -SWIGALLEGROCL                   Defined when using Allegro CL
    -SWIGCFFI                        Defined when using CFFI
    -SWIGCHICKEN                     Defined when using CHICKEN
    -SWIGCLISP                       Defined when using CLISP
    -SWIGCSHARP                      Defined when using C#
    -SWIGGUILE                       Defined when using Guile
    -SWIGJAVA                        Defined when using Java
    -SWIGLUA                         Defined when using Lua
    -SWIGMODULA3                     Defined when using Modula-3
    -SWIGMZSCHEME                    Defined when using Mzscheme        
    -SWIGOCAML                       Defined when using Ocaml
    -SWIGOCTAVE                      Defined when using Octave
    -SWIGPERL                        Defined when using Perl
    -SWIGPHP                         Defined when using PHP
    -SWIGPIKE                        Defined when using Pike
    -SWIGPYTHON                      Defined when using Python
    -SWIGR                           Defined when using R
    -SWIGRUBY                        Defined when using Ruby
    -SWIGSEXP                        Defined when using S-expressions
    -SWIGTCL                         Defined when using Tcl
    -SWIGXML                         Defined when using XML
    +example.i:18: Warning 503: Can't wrap 'operator =' unless renamed to a valid identifier.
     
    -

    In addition, SWIG defines the following set of standard C/C++ - macros:

    +

    7.2.2 + Generalized constant expressions

    +

    SWIG parses and identifies the keyword constexpr, but cannot + fully utilise it. These C++ compile time constants are usable as + runtime constants from the target languages. Below shows example usage + for assigning a C++ compile time constant from a compile time constant + function:

    -__LINE__                        Current line number
    -__FILE__                        Current file name
    -__STDC__                        Defined to indicate ANSI C
    -__cplusplus                     Defined when -c++ option used
    +constexpr int XXX() { return 10; }
    +constexpr int YYY = XXX() + 100;
     
    -

    Interface files can look at these symbols as necessary to change the - way in which an interface is generated or to mix SWIG directives with C - code. These symbols are also defined within the C code generated by - SWIG (except for the symbol `SWIG' which is only defined - within the SWIG compiler).

    -

    7.4 Macro Expansion

    -

    Traditional preprocessor macros can be used in SWIG interfaces. Be - aware that the #define statement is also used to try and - detect constants. Therefore, if you have something like this in your - file,

    +

    When either of these is used from a target language, a runtime call + is made to obtain the underlying constant.

    +

    7.2.3 Extern template

    +

    SWIG correctly parses the keywords extern template. However, + this template instantiation suppression in a translation unit has no + relevance outside of the C++ compiler and so is not used by SWIG. SWIG + only uses %template for instantiating and wrapping templates.

    -#ifndef _FOO_H 1
    -#define _FOO_H 1
    -...
    -#endif
    +template class std::vector<int>;        // C++03 explicit instantiation in C++
    +extern template class std::vector<int>; // C++11 explicit instantiation suppression in C++
    +%template(VectorInt) std::vector<int>;  // SWIG instantiation
     
    -

    you may get some extra constants such as _FOO_H showing up - in the scripting interface.

    -

    More complex macros can be defined in the standard way. For example:

    -
    +

    7.2.4 Initializer lists

    +

    Initializer lists are very much a C++ compiler construct and are not + very accessible from wrappers as they are intended for compile time + initialization of classes using the special std::initializer_list + type. SWIG detects usage of initializer lists and will emit a special + informative warning each time one is used:

    +
    -#define EXTERN extern
    -#ifdef __STDC__
    -#define _ANSI(args)   (args)
    -#else
    -#define _ANSI(args) ()
    -#endif
    +example.i:33: Warning 476: Initialization using std::initializer_list.
     
    -

    The following operators can appear in macro definitions:

    -
      -
    • #x -
      Converts macro argument x to a string surrounded by double - quotes ("x").
    • -
    • x ## y -
      Concatenates x and y together to form xy.
    • -
    • `x` -
      If x is a string surrounded by double quotes, do nothing. - Otherwise, turn into a string like #x. This is a non-standard - SWIG extension.
    • -
    -

    7.5 SWIG Macros

    -

    SWIG provides an enhanced macro capability with the %define - and %enddef directives. For example:

    +

    Initializer lists usually appear in constructors but can appear in + any function or method. They often appear in constructors which are + overloaded with alternative approaches to initializing a class, such as + the std container's push_back method for adding elements to a + container. The recommended approach then is to simply ignore the + initializer-list constructor, for example:

    -%define ARRAYHELPER(type,name)
    -%inline %{
    -type *new_ ## name (int nitems) {
    -   return (type *) malloc(sizeof(type)*nitems);
    -}
    -void delete_ ## name(type *t) {
    -   free(t);
    -}
    -type name ## _get(type *t, int index) {
    -   return t[index];
    -}
    -void name ## _set(type *t, int index, type val) {
    -   t[index] = val;
    -}
    -%}
    -%enddef
    -
    -ARRAYHELPER(int, IntArray)
    -ARRAYHELPER(double, DoubleArray)
    +%ignore Container::Container(std::initializer_list<int>);
    +class Container {
    +public:
    +  Container(std::initializer_list<int>); // initializer-list constructor
    +  Container();
    +  void push_back(const int &);
    +  ...
    +};
     
    -

    The primary purpose of %define is to define large macros of - code. Unlike normal C preprocessor macros, it is not necessary to - terminate each line with a continuation character (\)--the macro - definition extends to the first occurrence of %enddef. - Furthermore, when such macros are expanded, they are reparsed through - the C preprocessor. Thus, SWIG macros can contain all other - preprocessor directives except for nested %define statements.

    -

    The SWIG macro capability is a very quick and easy way to generate - large amounts of code. In fact, many of SWIG's advanced features and - libraries are built using this mechanism (such as C++ template - support).

    -

    7.6 C99 and GNU Extensions

    -

    SWIG-1.3.12 and newer releases support variadic preprocessor macros. - For example:

    +

    Alternatively you could modify the class and add another constructor + for initialization by some other means, for example by a +std::vector:

    -#define DEBUGF(fmt,...)   fprintf(stderr,fmt,__VA_ARGS__)
    +%include <std_vector.i>
    +class Container {
    +public:
    +  Container(const std::vector<int> &);
    +  Container(std::initializer_list<int>); // initializer-list constructor
    +  Container();
    +  void push_back(const int &);
    +  ...
    +};
     
    -

    When used, any extra arguments to ... are placed into the - special variable __VA_ARGS__. This also works with special - SWIG macros defined using %define.

    -

    SWIG allows a variable number of arguments to be empty. However, - this often results in an extra comma (,) and syntax error in the - resulting expansion. For example:

    -
    +

    And then call this constructor from your target language, for + example, in Python, the following will call the constructor taking the +std::vector:

    +
    -DEBUGF("hello");   --> fprintf(stderr,"hello",);
    +>>> c = Container( [1,2,3,4] )
     
    -

    To get rid of the extra comma, use ## like this:

    +

    If you are unable to modify the class being wrapped, consider + ignoring the initializer-list constructor and using %extend to add in + an alternative constructor:

    -#define DEBUGF(fmt,...)   fprintf(stderr,fmt, ##__VA_ARGS__)
    +%include <std_vector.i>
    +%extend Container {
    +  Container(const std::vector<int> &elements) {
    +    Container *c = new Container();
    +    for (int element : elements)
    +      c->push_back(element);
    +    return c;
    +  }
    +}
    +
    +%ignore Container::Container(std::initializer_list<int>);
    +
    +class Container {
    +public:
    +  Container(std::initializer_list<int>); // initializer-list constructor
    +  Container();
    +  void push_back(const int &);
    +  ...
    +};
     
    -

    SWIG also supports GNU-style variadic macros. For example:

    +

    The above makes the wrappers look is as if the class had been + declared as follows:

    -#define DEBUGF(fmt, args...)  fprintf(stdout,fmt,args)
    +%include <std_vector.i>
    +class Container {
    +public:
    +  Container(const std::vector<int> &);
    +//  Container(std::initializer_list<int>); // initializer-list constructor (ignored)
    +  Container();
    +  void push_back(const int &);
    +  ...
    +};
     
    -

    Comment: It's not entirely clear how variadic macros might be - useful to interface building. However, they are used internally to - implement a number of SWIG directives and are provided to make SWIG - more compatible with C99 code.

    -

    7.7 Preprocessing and - delimiters

    -

    The preprocessor handles { }, " " and %{ %} delimiters differently.

    -

    7.7.1 Preprocessing and %{ ... %} & " - ... " delimiters

    -

    The SWIG preprocessor does not process any text enclosed in a code - block %{ ... %}. Therefore, if you write code like this,

    +

    std::initializer_list is simply a container that can only + be initialized at compile time. As it is just a C++ type, it is + possible to write typemaps for a target language container to map onto +std::initializer_list. However, this can only be done for a fixed + number of elements as initializer lists are not designed to be + constructed with a variable number of arguments at runtime. The example + below is a very simple approach which ignores any parameters passed in + and merely initializes with a fixed list of fixed integer values chosen + at compile time:

    -%{
    -#ifdef NEED_BLAH
    -int blah() {
    -   ...
    +%typemap(in) std::initializer_list<int> {
    +  $1 = {10, 20, 30, 40, 50};
     }
    -#endif
    -%}
    +class Container {
    +public:
    +  Container(std::initializer_list<int>); // initializer-list constructor
    +  Container();
    +  void push_back(const int &);
    +  ...
    +};
     
    -

    the contents of the %{ ... %} block are copied without - modification to the output (including all preprocessor directives).

    -

    7.7.2 Preprocessing and { ... } - delimiters

    -

    SWIG always runs the preprocessor on text appearing inside { ... - }. However, sometimes it is desirable to make a preprocessor - directive pass through to the output file. For example:

    +

    Any attempt at passing in values from the target language will be + ignored and be replaced by {10, 20, 30, 40, 50}. 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 std::initializer_list, but with values + decided at runtime. The typemaps would be target language specific.

    +

    Note that the default typemap for std::initializer_list + does nothing but issue the warning and hence any user supplied typemaps + will override it and suppress the warning.

    +

    7.2.5 Uniform + initialization

    +

    The curly brackets {} for member initialization are fully supported + by SWIG:

    -%extend Foo {
    -   void bar() {
    -      #ifdef DEBUG
    -       printf("I'm in bar\n");
    -      #endif
    -   }
    -}
    +struct BasicStruct {
    + int x;
    + double y;
    +};
    + 
    +struct AltStruct {
    +  AltStruct(int x, double y) : x_{x}, y_{y} {}
    + 
    +  int x_;
    +  double y_;
    +};
    +
    +BasicStruct var1{5, 3.2}; // only fills the struct components
    +AltStruct var2{2, 4.3};   // calls the constructor
     
    -

    By default, SWIG will interpret the #ifdef DEBUG statement. - However, if you really wanted that code to actually go into the wrapper - file, prefix the preprocessor directives with % like this:

    -
    +

    Uniform initialization does not affect usage from the target + language, for example in Python:

    +
    -%extend Foo {
    -   void bar() {
    -      %#ifdef DEBUG
    -       printf("I'm in bar\n");
    -      %#endif
    -   }
    -}
    +>>> a = AltStruct(10, 142.15)
    +>>> a.x_
    +10
    +>>> a.y_
    +142.15
     
    -

    SWIG will strip the extra % and leave the preprocessor - directive in the code.

    -

    7.8 Preprocessor and - Typemaps

    -

    Typemaps support a special attribute called -noblock where the { ... } delimiters can be used, but the - delimiters are not actually generated into the code. The effect is then - similar to using "" or %{ %} delimiters but the code is run - through the preprocessor. For example:

    +

    7.2.6 Type inference

    +

    SWIG supports decltype() with some limitations. Single + variables are allowed, however, expressions are not supported yet. For + example, the following code will work:

    -#define SWIG_macro(CAST) (CAST)$input
    -%typemap(in) Int {$1= SWIG_macro(int);}
    +int i;
    +decltype(i) j;
     
    -

    might generate

    +

    However, using an expression inside the decltype results in syntax + error:

    -  {
    -    arg1=(int)jarg1;
    -  }
    +int i; int j;
    +decltype(i+j) k;  // syntax error
     
    -

    whereas

    +

    7.2.7 Range-based + for-loop

    +

    This feature is part of the implementation block only. SWIG ignores + it.

    +

    7.2.8 Lambda + functions and expressions

    +

    SWIG correctly parses most of the Lambda functions syntax. For + example:

    -#define SWIG_macro(CAST) (CAST)$input
    -%typemap(in,noblock=1) Int {$1= SWIG_macro(int);}
    +auto val = [] { return something; };
    +auto sum = [](int x, int y) { return x+y; };
    +auto sum = [](int x, int y) -> int { return x+y; };
     
    -

    might generate

    +

    The lambda functions are removed from the wrappers for now, because + of the lack of support for closures (scope of the lambda functions) in + the target languages.

    +

    Lambda functions used to create variables can also be parsed, but + due to limited support of auto when the type is deduced from + the expression, the variables are simply ignored.

    -  arg1=(int)jarg1;
    +auto six = [](int x, int y) { return x+y; }(4, 2);
     
    -

    and

    +

    Better support should be available in a later release.

    +

    7.2.9 Alternate + function syntax

    +

    SWIG fully supports the new definition of functions. For example:

    -#define SWIG_macro(CAST) (CAST)$input
    -%typemap(in) Int %{$1=SWIG_macro(int);%}
    +struct SomeStruct {
    +  int FuncName(int x, int y);
    +};
     
    -

    would generate

    +

    can now be written as in C++11:

    -  arg1=SWIG_macro(int);
    +struct SomeStruct {
    +  auto FuncName(int x, int y) -> int;
    +};
    + 
    +auto SomeStruct::FuncName(int x, int y) -> int {
    +  return x + y;
    +}
     
    -

    7.9 Viewing preprocessor output

    -

    Like many compilers, SWIG supports a -E command line option - to display the output from the preprocessor. When the -E - switch is used, SWIG will not generate any wrappers. Instead the - results after the preprocessor has run are displayed. This might be - useful as an aid to debugging and viewing the results of macro - expansions.

    -

    7.10 The #error and - #warning directives

    -

    SWIG supports the commonly used #warning and #error - preprocessor directives. The #warning directive will cause - SWIG to issue a warning then continue processing. The #error - directive will cause SWIG to exit with a fatal error. Example usage:

    -
    +

    The usage in the target languages remains the same, for example in + Python:

    +
    -#error "This is a fatal error message"
    -#warning "This is a warning message"
    +>>> a = SomeStruct()
    +>>> a.FuncName(10,5)
    +15
     
    -

    The #error behaviour can be made to work like #warning - if the -cpperraswarn commandline option is used. - Alternatively, the #pragma directive can be used to the same - effect, for example:

    +

    SWIG will also deal with type inference for the return type, as per + the limitations described earlier. For example:

    -  /* Modified behaviour: #error does not cause SWIG to exit with error */
    -  #pragma SWIG cpperraswarn=1
    -  /* Normal behaviour: #error does cause SWIG to exit with error */
    -  #pragma SWIG cpperraswarn=0
    +auto square(float a, float b) -> decltype(a);
     
    -

    -

    8 SWIG library

    - - - - -

    To help build extension modules, SWIG is packaged with a library of - support files that you can include in your own interfaces. These files - often define new SWIG directives or provide utility functions that can - be used to access parts of the standard C and C++ libraries. This - chapter provides a reference to the current set of supported library - files.

    -

    Compatibility note: Older versions of SWIG included a number - of library files for manipulating pointers, arrays, and other - structures. Most these files are now deprecated and have been removed - from the distribution. Alternative libraries provide similar - functionality. Please read this chapter carefully if you used the old - libraries.

    -

    8.1 The %include directive and library - search path

    -

    Library files are included using the %include directive. - When searching for files, directories are searched in the following - order:

    -
      -
    1. The current directory
    2. -
    3. Directories specified with the -I command line option
    4. -
    5. ./swig_lib
    6. -
    7. SWIG library install location as reported by swig -swiglib, - for example /usr/local/share/swig/1.3.30
    8. -
    9. On Windows, a directory Lib relative to the location of -swig.exe is also searched.
    10. -
    -

    Within directories mentioned in points 3-5, SWIG first looks for a - subdirectory corresponding to a target language (e.g., python, - tcl, etc.). If found, SWIG will search the language specific - directory first. This allows for language-specific implementations of - library files.

    -

    You can ignore the installed SWIG library by setting the -SWIG_LIB environment variable. Set the environment variable to hold - an alternative library directory.

    -

    The directories that are searched are displayed when using --verbose commandline option.

    -

    8.2 C Arrays and Pointers

    -

    This section describes library modules for manipulating low-level C - arrays and pointers. The primary use of these modules is in supporting - C declarations that manipulate bare pointers such as int *, -double *, or void *. The modules can be used to allocate - memory, manufacture pointers, dereference memory, and wrap pointers as - class-like objects. Since these functions provide direct access to - memory, their use is potentially unsafe and you should exercise - caution.

    -

    8.2.1 cpointer.i

    -

    The cpointer.i module defines macros that can be used to - used to generate wrappers around simple C pointers. The primary use of - this module is in generating pointers to primitive datatypes such as -int and double.

    -

    %pointer_functions(type,name)

    -
    -

    Generates a collection of four functions for manipulating a pointer -type *:

    -

    type *new_name()

    -
    -

    Creates a new object of type type and returns a pointer to - it. In C, the object is created using calloc(). In C++, -new is used.

    -
    -

    type *copy_name(type value)

    -
    -

    Creates a new object of type type and returns a pointer to - it. An initial value is set by copying it from value. In C, - the object is created using calloc(). In C++, new is - used.

    -
    -

    type *delete_name(type *obj)

    -
    -

    Deletes an object type type.

    -
    -

    void name_assign(type *obj, type value)

    -
    -

    Assigns *obj = value.

    -

    type name_value(type *obj)

    -
    -

    Returns the value of *obj.

    -
    -

    When using this macro, type may be any type and name - must be a legal identifier in the target language. name should - not correspond to any other name used in the interface file.

    -

    Here is a simple example of using %pointer_functions():

    +

    7.2.10 Object + construction improvement

    +

    There are three parts to object construction improvement. The first + improvement is constructor delegation such as the following:

    -%module example
    -%include "cpointer.i"
    +class A {
    +public:
    +  int a;
    +  int b;
    +  int c;
     
    -/* Create some functions for working with "int *" */
    -%pointer_functions(int, intp);
    +  A() : A(10) {}
    +  A(int aa) : A(aa, 20) {}
    +  A(int aa, int bb) : A(aa, bb, 30) {}
    +  A(int aa, int bb, int cc) { a=aa; b=bb; c=cc; }
    +};
    +
    +
    +

    where peer constructors can be called. SWIG handles this without any + issue.

    +

    The second improvement is constructor inheritance via a using + declaration. This is parsed correctly, but the additional constructors + are not currently added to the derived proxy class in the target + language. An example is shown below: + +

    +
    +
    +class BaseClass {
    +public:
    +  BaseClass(int iValue);
    +};
     
    -/* A function that uses an "int *" */
    -void add(int x, int y, int *result);
    +class DerivedClass: public BaseClass {
    +  public:
    +  using BaseClass::BaseClass; // Adds DerivedClass(int) constructor
    +};
     
    -

    Now, in Python:

    -
    +

    The final part is member initialization at the site of the + declaration. This kind of initialization is handled by SWIG.

    +
    ->>> import example
    ->>> c = example.new_intp()     # Create an "int" for storing result
    ->>> example.add(3,4,c)         # Call function
    ->>> example.intp_value(c)      # Dereference
    -7
    ->>> example.delete_intp(c)     # Delete
    +class SomeClass {
    +public:
    +    SomeClass() {}
    +    explicit SomeClass(int new_value) : value(new_value) {}
    +
    +    int value = 5;
    +};
     
    -
    -

    %pointer_class(type,name)

    -
    -

    Wraps a pointer of type * inside a class-based interface. - This interface is as follows:

    +
    +

    7.2.11 Explicit + overrides and final

    +

    The special identifiers final and override can be + used on methods and destructors, such as in the following example:

    -struct name {
    -   name();                            // Create pointer object
    -  ~name();                            // Delete pointer object
    -   void assign(type value);           // Assign value
    -   type value();                      // Get value
    -   type *cast();                      // Cast the pointer to original type
    -   static name *frompointer(type *);  // Create class wrapper from existing
    -                                      // pointer
    +struct BaseStruct {
    +  virtual void ab() const = 0;
    +  virtual void cd();
    +  virtual void ef();
    +  virtual ~BaseStruct();
    +};
    +struct DerivedStruct : BaseStruct {
    +  virtual void ab() const override;
    +  virtual void cd() final;
    +  virtual void ef() final override;
    +  virtual ~DerivedStruct() override;
     };
     
    -

    When using this macro, type is restricted to a simple type - name like int, float, or Foo. Pointers and - other complicated types are not allowed. name must be a valid - identifier not already in use. When a pointer is wrapped as a class, - the "class" may be transparently passed to any function that expects - the pointer.

    -

    If the target language does not support proxy classes, the use of - this macro will produce the example same functions as -%pointer_functions() macro.

    -

    It should be noted that the class interface does introduce a new - object or wrap a pointer inside a special structure. Instead, the raw - pointer is used directly.

    -

    Here is the same example using a class instead:

    +

    7.2.12 Null pointer + constant

    +

    The nullptr constant is mostly unimportant in wrappers. In + the few places it has an effect, it is treated like NULL.

    +

    7.2.13 Strongly + typed enumerations

    +

    SWIG supports strongly typed enumerations and parses the new enum + class syntax and forward declarator for the enums, such as:

    -%module example
    -%include "cpointer.i"
    -
    -/* Wrap a class interface around an "int *" */
    -%pointer_class(int, intp);
    +enum class MyEnum : unsigned int;
    +
    +
    +

    Strongly typed enums are often used to avoid name clashes such as + the following:

    +
    +
    +struct Color {
    +  enum class RainbowColors : unsigned int {
    +    Red, Orange, Yellow, Green, Blue, Indigo, Violet
    +  };
    +  
    +  enum class WarmColors {
    +    Yellow, Orange, Red
    +  };
     
    -/* A function that uses an "int *" */
    -void add(int x, int y, int *result);
    +  // Note normal enum
    +  enum PrimeColors {
    +    Red=100, Green, Blue
    +  };
    +};
     
    -

    Now, in Python (using proxy classes)

    +

    There are various ways that the target languages handle enums, so it + is not possible to precisely state how they are handled in this + section. However, generally, most scripting languages mangle in the + strongly typed enumeration's class name, but do not use any additional + mangling for normal enumerations. For example, in Python, the following + code

    ->>> import example
    ->>> c = example.intp()         # Create an "int" for storing result
    ->>> example.add(3,4,c)         # Call function
    ->>> c.value()                  # Dereference
    -7
    +print Color.RainbowColors_Red, Color.WarmColors_Red, Color.Red
     
    -

    Of the two macros, %pointer_class is probably the most - convenient when working with simple pointers. This is because the - pointers are access like objects and they can be easily garbage - collected (destruction of the pointer object destroys the underlying - object).

    +

    results in

    +
    +
    +0 2 100
    +
    -

    %pointer_cast(type1, type2, name)

    -
    -

    Creates a casting function that converts type1 to type2 -. The name of the function is name. For example:

    -
    +

    The strongly typed languages often wrap normal enums into an enum + class and so treat normal enums and strongly typed enums the same. The + equivalent in Java is:

    +
    -%pointer_cast(int *, unsigned int *, int_to_uint);
    +System.out.println(Color.RainbowColors.Red.swigValue() + " " + Color.WarmColors.Red.swigValue() + " " + Color.PrimeColors.Red.swigValue());
     
    -

    In this example, the function int_to_uint() would be used - to cast types in the target language.

    +

    7.2.14 Double angle + brackets

    +

    SWIG correctly parses the symbols >> as closing the template block, + if found inside it at the top level, or as the right shift operator >> + otherwise.

    +
    +
    +std::vector<std::vector<int>> myIntTable;
    +
    -

    Note: None of these macros can be used to safely work with - strings (char * or char **).

    -

    Note: When working with simple pointers, typemaps can often - be used to provide more seamless operation.

    -

    8.2.2 carrays.i

    -

    This module defines macros that assist in wrapping ordinary C - pointers as arrays. The module does not provide any safety or an extra - layer of wrapping--it merely provides functionality for creating, - destroying, and modifying the contents of raw C array data.

    -

    %array_functions(type,name)

    -
    -

    Creates four functions.

    -

    type *new_name(int nelements)

    -
    -

    Creates a new array of objects of type type. In C, the - array is allocated using calloc(). In C++, new [] is - used.

    +

    7.2.15 Explicit + conversion operators

    +

    SWIG correctly parses the keyword explicit for operators in + addition to constructors now. For example:

    +
    +
    +class U {
    +public:
    +  int u;
    +};
    +
    +class V {
    +public:
    +  int v;
    +};
    +
    +class TestClass {
    +public:
    +  //implicit converting constructor
    +  TestClass(U const &val) { t=val.u; }
    +
    +  // explicit constructor
    +  explicit TestClass(V const &val) { t=val.v; }
    +
    +  int t;
    +};
    +
    +struct Testable {
    +  // explicit conversion operator
    +  explicit operator bool() const {
    +    return false;
    +  }
    +};
    +
    -

    type *delete_name(type *ary)

    -
    -

    Deletes an array. In C, free() is used. In C++, delete - [] is used.

    +

    The effect of explicit constructors and operators has little + relevance for the proxy classes as target languages don't have the same + concepts of implicit conversions as C++. Conversion operators either + with or without explicit need renaming to a valid identifier + name in order to make them available as a normal proxy method.

    +

    7.2.16 Alias templates

    +

    The following is an example of an alias template:

    +
    +template< typename T1, typename T2, int >
    +class SomeType {
    +public:
    +  T1 a;
    +  T2 b;
    +  int c;
    +};
    +
    +template< typename T2 >
    +using TypedefName = SomeType<char*, T2, 5>;
    +
    +

    +

    These are partially supported as SWIG will parse these and identify + them, however, they are ignored as they are not added to the type + system. A warning such as the following is issued:

    +
    +
    +example.i:13: Warning 342: The 'using' keyword in template aliasing is not fully supported yet.
    +
    -

    type name_getitem(type *ary, int index)

    -
    -

    Returns the value ary[index].

    +

    Similarly for non-template type aliasing:

    +
    +
    +using PFD = void (*)(double); // New introduced syntax
    +
    -

    void name_setitem(type *ary, int index, type value)

    -
    -

    Assigns ary[index] = value.

    +

    A warning will be issued:

    +
    +
    +example.i:17: Warning 341: The 'using' keyword in type aliasing is not fully supported yet.
    +
    -

    When using this macro, type may be any type and name - must be a legal identifier in the target language. name should - not correspond to any other name used in the interface file.

    -

    Here is an example of %array_functions(). Suppose you had a - function like this:

    +

    The equivalent old style typedefs can be used as a workaround:

    -void print_array(double x[10]) {
    -   int i;
    -   for (i = 0; i < 10; i++) {
    -      printf("[%d] = %g\n", i, x[i]);
    -   }
    -}
    +typedef void (*PFD)(double);  // The old style
     
    -

    To wrap it, you might write this:

    +

    7.2.17 Unrestricted unions +

    +

    SWIG fully supports any type inside a union even if it does not + define a trivial constructor. For example, the wrapper for the + following code correctly provides access to all members in the union:

    -%module example
    -
    -%include "carrays.i"
    -%array_functions(double, doubleArray);
    +struct point {
    +  point() {}
    +  point(int x, int y) : x_(x), y_(y) {}
    +  int x_, y_;
    +};
     
    -void print_array(double x[10]);
    +#include <new> // For placement 'new' in the constructor below
    +union P {
    +  int z;
    +  double w;
    +  point p; // Illegal in C++03; legal in C++11.
    +  // Due to the point member, a constructor definition is required.
    +  P() {
    +    new(&p) point();
    +  }
    +} p1;
     
    -

    Now, in a scripting language, you might write this:

    +

    7.2.18 Variadic templates +

    +

    SWIG supports the variadic templates syntax (inside the <> block, + variadic class inheritance and variadic constructor and initializers) + with some limitations. The following code is correctly parsed:

    -a = new_doubleArray(10)           # Create an array
    -for i in range(0,10):
    -    doubleArray_setitem(a,i,2*i)  # Set a value
    -print_array(a)                    # Pass to C
    -delete_doubleArray(a)             # Destroy array
    +template <typename... BaseClasses> class ClassName : public BaseClasses... {
    +public:
    +   ClassName (BaseClasses &&... baseClasses) : BaseClasses(baseClasses)... {}
    +}
     
    -
    -

    %array_class(type,name)

    -
    -

    Wraps a pointer of type * inside a class-based interface. - This interface is as follows:

    +
    +

    For now however, the %template directive only accepts one + parameter substitution for the variable template parameters.

    -struct name {
    -   name(int nelements);                  // Create an array
    -  ~name();                               // Delete array
    -   type getitem(int index);              // Return item
    -   void setitem(int index, type value);  // Set item
    -   type *cast();                         // Cast to original type
    -   static name *frompointer(type *);     // Create class wrapper from
    -                                         // existing pointer
    -};
    +%template(MyVariant1) ClassName<>         // zero argument not supported yet
    +%template(MyVariant2) ClassName<int>      // ok
    +%template(MyVariant3) ClassName<int, int> // too many arguments not supported yet
     
    -

    When using this macro, type is restricted to a simple type - name like int or float. Pointers and other - complicated types are not allowed. name must be a valid - identifier not already in use. When a pointer is wrapped as a class, it - can be transparently passed to any function that expects the pointer.

    -

    When combined with proxy classes, the %array_class() macro - can be especially useful. For example:

    +

    Support for the variadic sizeof() function is correctly + parsed:

    -%module example
    -%include "carrays.i"
    -%array_class(double, doubleArray);
    -
    -void print_array(double x[10]);
    +const int SIZE = sizeof...(ClassName<int, int>);
     
    -

    Allows you to do this:

    +

    In the above example SIZE is of course wrapped as a + constant.

    +

    7.2.19 New string literals +

    +

    SWIG supports wide string and Unicode string constants and raw string + literals.

    -import example
    -c = example.doubleArray(10)  # Create double[10]
    -for i in range(0,10):
    -    c[i] = 2*i               # Assign values
    -example.print_array(c)       # Pass to C
    +// New string literals
    +wstring         aa =  L"Wide string";
    +const char     *bb = u8"UTF-8 string";
    +const char16_t *cc =  u"UTF-16 string";
    +const char32_t *dd =  U"UTF-32 string";
    +
    +// Raw string literals
    +const char      *xx =        ")I'm an \"ascii\" \\ string.";
    +const char      *ee =   R"XXX()I'm an "ascii" \ string.)XXX"; // same as xx
    +wstring          ff =  LR"XXX(I'm a "raw wide" \ string.)XXX";
    +const char      *gg = u8R"XXX(I'm a "raw UTF-8" \ string.)XXX";
    +const char16_t  *hh =  uR"XXX(I'm a "raw UTF-16" \ string.)XXX";
    +const char32_t  *ii =  UR"XXX(I'm a "raw UTF-32" \ string.)XXX";
     
    -
    -

    Note: These macros do not encapsulate C arrays inside a - special data structure or proxy. There is no bounds checking or safety - of any kind. If you want this, you should consider using a special - array object rather than a bare pointer.

    -

    Note: %array_functions() and %array_class() - should not be used with types of char or char *.

    -

    8.2.3 cmalloc.i

    -

    This module defines macros for wrapping the low-level C memory - allocation functions malloc(), calloc(), -realloc(), and free().

    -

    %malloc(type [,name=type])

    -
    -

    Creates a wrapper around malloc() with the following - prototype:

    +
    +

    Non-ASCII string support varies quite a bit among the various target + languages though.

    +

    Note: There is a bug currently where SWIG's preprocessor incorrectly + parses an odd number of double quotes inside raw string literals.

    +

    7.2.20 User-defined + literals

    +

    SWIG parses the declaration of user-defined literals, that is, the +operator "" _mysuffix() function syntax.

    +

    Some examples are the raw literal:

    -type *malloc_name(int nbytes = sizeof(type));
    +OutputType operator "" _myRawLiteral(const char * value);
     
    -

    If type is void, then the size parameter -nbytes is required. The name parameter only needs to be - specified when wrapping a type that is not a valid identifier (e.g., " -int *", "double **", etc.).

    +

    numeric cooked literals:

    +
    +
    +OutputType operator "" _mySuffixIntegral(unsigned long long);
    +OutputType operator "" _mySuffixFloat(long double);
    +
    -

    %calloc(type [,name=type])

    -
    -

    Creates a wrapper around calloc() with the following - prototype:

    +

    and cooked string literals:

    -type *calloc_name(int nobj =1, int sz = sizeof(type));
    +OutputType operator "" _mySuffix(const char * string_values, size_t num_chars);
    +OutputType operator "" _mySuffix(const wchar_t * string_values, size_t num_chars);
    +OutputType operator "" _mySuffix(const char16_t * string_values, size_t num_chars);
    +OutputType operator "" _mySuffix(const char32_t * string_values, size_t num_chars);
     
    -

    If type is void, then the size parameter sz - is required.

    +

    Like other operators that SWIG parses, a warning is given about + renaming the operator in order for it to be wrapped:

    +
    +
    +example.i:27: Warning 503: Can't wrap 'operator "" _myRawLiteral' unless renamed to a valid identifier.
    +
    -

    %realloc(type [,name=type])

    -
    -

    Creates a wrapper around realloc() with the following - prototype:

    +

    If %rename is used, then it can be called like any other wrapped + method. Currently you need to specify the full declaration including + parameters for %rename:

    -type *realloc_name(type *ptr, int nitems);
    +%rename(MyRawLiteral)  operator"" _myRawLiteral(const char * value);
     
    -

    Note: unlike the C realloc(), the wrapper generated by this - macro implicitly includes the size of the corresponding type. For - example, realloc_int(p, 100) reallocates p so that it - holds 100 integers.

    -
    -

    %free(type [,name=type])

    -
    -

    Creates a wrapper around free() with the following - prototype:

    +

    Or if you just wish to ignore it altogether:

    -void free_name(type *ptr);
    +%ignore operator "" _myRawLiteral(const char * value);
     
    -
    -

    %sizeof(type [,name=type])

    -
    -

    Creates the constant:

    +
    +

    Note that use of user-defined literals such as the following still + give a syntax error:

    -%constant int sizeof_name = sizeof(type);
    +OutputType var1 = "1234"_suffix;
    +OutputType var2 = 1234_suffix;
    +OutputType var3 = 3.1416_suffix;
     
    -
    -

    %allocators(type [,name=type])

    -
    -

    Generates wrappers for all five of the above operations.

    -

    Here is a simple example that illustrates the use of these macros:

    +

    7.2.21 Thread-local + storage

    +

    SWIG correctly parses the thread_local keyword. For example, + variables reachable by the current thread can be defined as:

    -// SWIG interface
    -%module example
    -%include "cmalloc.i"
    -
    -%malloc(int);
    -%free(int);
    -
    -%malloc(int *, intp);
    -%free(int *, intp);
    -
    -%allocators(double);
    +struct A {
    +   static thread_local int val;
    +};
    +thread_local int global_val;
     
    -

    Now, in a script:

    -
    +

    The use of the thread_local storage specifier does not + affect the wrapping process; it does not modify the wrapper code + compared to when it is not specified. A variable will be thread local + if accessed from different threads from the target language in the same + way that it will be thread local if accessed from C++ code.

    +

    7.2.22 Explicitly defaulted + functions and deleted functions

    +

    SWIG handles explicitly defaulted functions, that is, = default + added to a function declaration. Deleted definitions, which are also + called deleted functions, have = delete added to the function + declaration. For example:

    +
    ->>> from example import *
    ->>> a = malloc_int()
    ->>> a
    -'_000efa70_p_int'
    ->>> free_int(a)
    ->>> b = malloc_intp()
    ->>> b
    -'_000efb20_p_p_int'
    ->>> free_intp(b)
    ->>> c = calloc_double(50)
    ->>> c
    -'_000fab98_p_double'
    ->>> c = realloc_double(100000)
    ->>> free_double(c)
    ->>> print sizeof_double
    -8
    ->>>
    +struct NonCopyable {
    +  NonCopyable & operator=(const NonCopyable &) = delete; /* Removes operator= */
    +  NonCopyable(const NonCopyable &) = delete;             /* Removes copy constructor */
    +  NonCopyable() = default;                               /* Explicitly allows the empty constructor */
    +};
     
    -

    8.2.4 cdata.i

    -

    The cdata.i module defines functions for converting raw C - data to and from strings in the target language. The primary - applications of this module would be packing/unpacking of binary data - structures---for instance, if you needed to extract data from a buffer. - The target language must support strings with embedded binary data in - order for this to work.

    -

    const char *cdata(void *ptr, size_t nbytes)

    -
    -

    Converts nbytes of data at ptr into a string. -ptr can be any pointer.

    +

    Wrappers for deleted functions will not be available in the target + language. Wrappers for defaulted functions will of course be available + in the target language. Explicitly defaulted functions have no direct + effect for SWIG wrapping as the declaration is handled much like any + other method declaration parsed by SWIG.

    +

    Deleted functions are also designed to prevent implicit conversions + when calling the function. For example, the C++ compiler will not + compile any code which attempts to use an int as the type of the + parameter passed to f below:

    +
    +
    +struct NoInt {
    +    void f(double i);
    +    void f(int) = delete;
    +};
    +
    -

    void memmove(void *ptr, const char *s)

    -
    -

    Copies all of the string data in s into the memory pointed - to by ptr. The string may contain embedded NULL bytes. This is - actually a wrapper to the standard C library memmove function, - which is declared as void memmove(void *ptr, const void *src, - size_t n). The src and length n parameters - are extracted from the language specific string s in the - underlying wrapper code.

    +

    This is a C++ compile time check and SWIG does not make any attempt + to detect if the target language is using an int instead of a double + though, so in this case it is entirely possible to pass an int instead + of a double to f from Java, Python etc.

    +

    7.2.23 Type long long int +

    +

    SWIG correctly parses and uses the new long long type + already introduced in C99 some time ago.

    +

    7.2.24 Static assertions

    +

    SWIG correctly parses the new static_assert declarations. + This is a C++ compile time directive so there isn't anything useful + that SWIG can do with it.

    +
    +
    +template <typename T>
    +struct Check {
    +  static_assert(sizeof(int) <= sizeof(T), "not big enough");
    +};
    +
    -

    One use of these functions is packing and unpacking data from - memory. Here is a short example:

    +

    7.2.25 Allow sizeof to work on members + of classes without an explicit object

    +

    SWIG can parse the new sizeof() on types as well as on objects. For + example:

    -// SWIG interface
    -%module example
    -%include "carrays.i"
    -%include "cdata.i"
    +struct A {
    +  int member;
    +};
     
    -%array_class(int, intArray);
    +const int SIZE = sizeof(A::member); // does not work with C++03. Okay with C++11
     
    -

    Python example:

    +

    In Python:

    ->>> a = intArray(10)
    ->>> for i in range(0,10):
    -...    a[i] = i
    ->>> b = cdata(a,40)
    ->>> b
    -'\x00\x00\x00\x00\x00\x00\x00\x01\x00\x00\x00\x02\x00\x00\x00\x03\x00\x00\x00\x04
    -\x00\x00\x00\x05\x00\x00\x00\x06\x00\x00\x00\x07\x00\x00\x00\x08\x00\x00\x00\t'
    ->>> c = intArray(10)
    ->>> memmove(c,b)
    ->>> print c[4]
    -4
    ->>>
    +>>> SIZE
    +8
     
    -

    Since the size of data is not always known, the following macro is - also defined:

    -

    %cdata(type [,name=type])

    -
    -

    Generates the following function for extracting C data for a given - type.

    +

    7.2.26 Exception specifications and + noexcept

    +

    C++11 added in the noexcept specification to exception + specifications to indicate that a function simply may or may not throw + an exception, without actually naming any exception. SWIG understands + these, although there isn't any useful way that this information can be + taken advantage of by target languages, so it is as good as ignored + during the wrapping process. Below are some examples of noexcept in + function declarations:

    -char *cdata_name(type* ptr, int nitems)
    +static void noex1() noexcept;
    +int noex2(int) noexcept(true);
    +int noex3(int, bool) noexcept(false);
     
    -

    nitems is the number of items of the given type to extract.

    -
    -

    Note: These functions provide direct access to memory and can - be used to overwrite data. Clearly they are unsafe.

    -

    8.3 C String Handling

    -

    A common problem when working with C programs is dealing with - functions that manipulate raw character data using char *. In - part, problems arise because there are different interpretations of -char *---it could be a NULL-terminated string or it could point to - binary data. Moreover, functions that manipulate raw strings may mutate - data, perform implicit memory allocations, or utilize fixed-sized - buffers.

    -

    The problems (and perils) of using char * are well-known. - However, SWIG is not in the business of enforcing morality. The modules - in this section provide basic functionality for manipulating raw C - strings.

    -

    8.3.1 Default string handling

    -

    Suppose you have a C function with this prototype:

    -
    +

    7.2.27 Control and query object + alignment

    +

    An alignof operator is used mostly within C++ to return + alignment in number of bytes, but could be used to initialize a + variable as shown below. The variable's value will be available for + access by the target language as any other variable's compile time + initialised value.

    -char *foo(char *s);
    +const int align1 = alignof(A::member);
    +
    +

    +

    The alignas specifier for variable alignment is not yet + supported. Example usage:

    +
    +
    +struct alignas(16) S {
    +  int num;
    +};
    +alignas(double) unsigned char c[sizeof(double)];
    +
    +
    +

    Use the preprocessor to work around this for now:

    +
    +
    +#define alignas(T)
    +
    +
    +

    7.2.28 Attributes

    +

    Attributes such as those shown below, are not yet supported and will + give a syntax error.

    +
    +
    +int [[attr1]] i [[attr2, attr3]];
    +
    +[[noreturn, nothrow]] void f [[noreturn]] ();
    +
    +
    +

    7.3 Standard library + changes

    +

    7.3.1 Threading + facilities

    +

    SWIG does not currently wrap or use any of the new threading classes + introduced (thread, mutex, locks, condition variables, task). The main + reason is that SWIG target languages offer their own threading + facilities so there is limited use for them.

    +

    7.3.2 Tuple types

    +

    SWIG does not provide library files for the new tuple types yet. + Variadic template support requires further work to provide substantial + tuple wrappers.

    +

    7.3.3 Hash tables

    +

    The new hash tables in the STL are unordered_set, +unordered_multiset, unordered_map, unordered_multimap +. These are not available in SWIG, but in principle should be easily + implemented by adapting the current STL containers.

    +

    7.3.4 Regular expressions +

    +

    While SWIG could provide wrappers for the new C++11 regular + expressions classes, there is little need as the target languages have + their own regular expression facilities.

    +

    7.3.5 + General-purpose smart pointers

    +

    SWIG provides special smart pointer handling for std::shared_ptr + in the same way it has support for boost::shared_ptr. Please + see the shared_ptr smart pointer + library section. There is no special smart pointer handling available + for std::weak_ptr and std::unique_ptr yet.

    +

    7.3.6 + Extensible random number facility

    +

    This feature extends and standardizes the standard library only and + does not effect the C++ language nor SWIG.

    +

    7.3.7 Wrapper reference

    +

    Wrapper references are similar to normal C++ references but are + copy-constructible and copy-assignable. They could conceivably be used + in public APIs. There is no special support for +std::reference_wrapper in SWIG though. Users would need to write + their own typemaps if wrapper references are being used and these would + be similar to the plain C++ reference typemaps.

    +

    +7.3.8 Polymorphous wrappers for function objects

    +

    SWIG supports functor classes in a few languages in a very natural + way. However nothing is provided yet for the new std::function + template. SWIG will parse usage of the template like any other + template.

    +
    +
    +%rename(__call__) Test::operator(); // Default renaming used for Python
    +
    +struct Test {
    +  bool operator()(int x, int y); // function object
    +};
    +
    +#include <functional>
    +std::function<void (int, int)> pF = Test;   // function template wrapper
    +
     
    -

    The default wrapping behavior for this function is to set s - to a raw char * that refers to the internal string data in the - target language. In other words, if you were using a language like Tcl, - and you wrote this,

    -
    +

    Example of supported usage of the plain functor from Python is shown + below. It does not involve std::function.

    +
    -% foo Hello
    +t = Test()
    +b = t(1,2) # invoke C++ function object
     
    -

    then s would point to the representation of "Hello" inside - the Tcl interpreter. When returning a char *, SWIG assumes - that it is a NULL-terminated string and makes a copy of it. This gives - the target language its own copy of the result.

    -

    There are obvious problems with the default behavior. First, since a - char * argument points to data inside the target language, it - is NOT safe for a function to modify this data (doing so may - corrupt the interpreter and lead to a crash). Furthermore, the default - behavior does not work well with binary data. Instead, strings are - assumed to be NULL-terminated.

    -

    8.3.2 Passing binary data

    -

    If you have a function that expects binary data,

    +

    7.3.9 Type + traits for metaprogramming

    +

    The type_traits functions to support C++ metaprogramming is useful at + compile time and is aimed specifically at C++ development:

    -size_t parity(char *str, size_t len, size_t initial);
    +#include <type_traits>
    +
    +// First way of operating.
    +template< bool B > struct algorithm {
    +  template< class T1, class T2 > static int do_it(T1 &, T2 &)  { /*...*/ return 1; }
    +};
    +
    +// Second way of operating.
    +template<> struct algorithm<true> {
    +  template< class T1, class T2 > static int do_it(T1, T2)  { /*...*/ return 2; }
    +};
    +
    +// Instantiating 'elaborate' will automatically instantiate the correct way to operate, depending on the types used.
    +template< class T1, class T2 > int elaborate(T1 A, T2 B) {
    +  // Use the second way only if 'T1' is an integer and if 'T2' is a floating point,
    +  // otherwise use the first way.
    +  return algorithm< std::is_integral<T1>::value && std::is_floating_point<T2>::value >::do_it(A, B);
    +}
     
    -

    you can wrap the parameters (char *str, size_t len) as a - single argument using a typemap. Just do this:

    +

    SWIG correctly parses the template specialization, template types + etc. However, metaprogramming and the additional support in the + type_traits header is really for compile time and is not much use at + runtime for the target languages. For example, as SWIG requires + explicit instantiation of templates via %template, there isn't + much that std::is_integral<int> is going to provide by itself. + However, template functions using such metaprogramming techniques might + be useful to wrap. For example, the following instantiations could be + made:

    -%apply (char *STRING, size_t LENGTH) { (char *str, size_t len) };
    -...
    -size_t parity(char *str, size_t len, size_t initial);
    +%template(Elaborate) elaborate<int, int>;
    +%template(Elaborate) elaborate<int, double>;
     
    -

    Now, in the target language, you can use binary string data like - this:

    -
    +

    Then the appropriate algorithm can be called for the subset of types + given by the above %template instantiations from a target + language, such as Python:

    +
    ->>> s = "H\x00\x15eg\x09\x20"
    ->>> parity(s,0)
    +>>> Elaborate(0, 0)
    +1
    +>>> Elaborate(0, 0.0)
    +2
     
    -

    In the wrapper function, the passed string will be expanded to a - pointer and length parameter. The (char *STRING, int LENGTH) - multi-argument typemap is also available in addition to (char - *STRING, size_t LENGTH).

    -

    8.3.3 Using %newobject to release memory

    -

    If you have a function that allocates memory like this,

    +

    +7.3.10 Uniform method for computing return type of function objects

    +

    The new std::result_of class introduced in the <functional> + header provides a generic way to obtain the return type of a function + type via std::result_of::type. There isn't any library + interface file to support this type. With a bit of work, SWIG will + deduce the return type of functions when used in std::result_of + using the approach shown below. The technique basically forward + declares the std::result_of template class, then partially + specializes it for the function types of interest. SWIG will use the + partial specialization and hence correctly use the +std::result_of::type provided in the partial specialization.

    -char *foo() {
    -   char *result = (char *) malloc(...);
    -   ...
    -   return result;
    +%inline %{
    +#include <functional>
    +typedef double(*fn_ptr)(double);
    +%}
    +
    +namespace std {
    +  // Forward declaration of result_of
    +  template<typename Func> struct result_of;
    +  // Add in a partial specialization of result_of
    +  template<> struct result_of< fn_ptr(double) > {
    +    typedef double type;
    +  };
    +}
    +
    +%template() std::result_of< fn_ptr(double) >;
    +
    +%inline %{
    +
    +double square(double x) {
    +  return (x * x);
    +}
    +
    +template<class Fun, class Arg>
    +typename std::result_of<Fun(Arg)>::type test_result_impl(Fun fun, Arg arg) {
    +  return fun(arg);
     }
    +%}
    +
    +%template(test_result) test_result_impl< fn_ptr, double >;
    +%constant double (*SQUARE)(double) = square;
     
    -

    then the SWIG generated wrappers will have a memory leak--the - returned data will be copied into a string object and the old contents - ignored.

    -

    To fix the memory leak, use the %newobject directive.

    -
    +

    Note the first use of %template which SWIG requires to + instantiate the template. The empty template instantiation suffices as + no proxy class is required for std::result_of<Fun(Arg)>::type + as this type is really just a double. The second %template + instantiates the template function which is being wrapped for use as a + callback. The %constant can then be used for any callback + function as described in Pointers to functions and + callbacks.

    +

    Example usage from Python should give the not too surprising result:

    +
    -%newobject foo;
    -...
    -char *foo();
    +>>> test_result(SQUARE, 5.0)
    +25.0
     
    -

    This will release the result if the appropriate target language - support is available. SWIG provides the appropriate "newfree" typemap - for char * so that the memory is released, however, you may - need to provide your own "newfree" typemap for other types. See -Object ownership and %newobject for more details.

    -

    8.3.4 cstring.i

    -

    The cstring.i library file provides a collection of macros - for dealing with functions that either mutate string arguments or which - try to output string data through their arguments. An example of such a - function might be this rather questionable implementation:

    -
    -
    -void get_path(char *s) {
    -    // Potential buffer overflow---uh, oh.
    -    sprintf(s,"%s/%s", base_directory, sub_directory);
    -}
    -...
    -// Somewhere else in the C program
    -{
    -    char path[1024];
    -    ...
    -    get_path(path);
    -    ...
    -}
    -
    +

    Phew, that is a lot of hard work to get a callback working. You + could just go with the more attractive option of just using double + as the return type in the function declaration instead of result_of +!

    +
    +

    8 Preprocessing

    + + + -

    (Off topic rant: If your program really has functions like this, you - would be well-advised to replace them with safer alternatives involving - bounds checking).

    -

    The macros defined in this module all expand to various combinations - of typemaps. Therefore, the same pattern matching rules and ideas - apply.

    -

    %cstring_bounded_output(parm, maxsize)

    -
    -

    Turns parameter parm into an output value. The - output string is assumed to be NULL-terminated and smaller than -maxsize characters. Here is an example:

    + +

    SWIG includes its own enhanced version of the C preprocessor. The + preprocessor supports the standard preprocessor directives and macro + expansion rules. However, a number of modifications and enhancements + have been made. This chapter describes some of these modifications.

    +

    8.1 File inclusion

    +

    To include another file into a SWIG interface, use the %include + directive like this:

    -%cstring_bounded_output(char *path, 1024);
    -...
    -void get_path(char *path);
    +%include "pointer.i"
     
    -

    In the target language:

    -
    +

    Unlike, #include, %include includes each file once + (and will not reload the file on subsequent %include + declarations). Therefore, it is not necessary to use include-guards in + SWIG interfaces.

    +

    By default, the #include is ignored unless you run SWIG + with the -includeall option. The reason for ignoring + traditional includes is that you often don't want SWIG to try and wrap + everything included in standard header system headers and auxiliary + files.

    +

    8.2 File imports

    +

    SWIG provides another file inclusion directive with the %import + directive. For example:

    +
    ->>> get_path()
    -/home/beazley/packages/Foo/Bar
    ->>>
    +%import "foo.i"
     
    -

    Internally, the wrapper function allocates a small buffer (on the - stack) of the requested size and passes it as the pointer value. Data - stored in the buffer is then returned as a function return value. If - the function already returns a value, then the return value and the - output string are returned together (multiple return values). If - more than maxsize bytes are written, your program - will crash with a buffer overflow!

    -
    -

    %cstring_chunk_output(parm, chunksize)

    -
    -

    Turns parameter parm into an output value. The - output string is always chunksize and may contain - binary data. Here is an example:

    +

    The purpose of %import is to collect certain information + from another SWIG interface file or a header file without actually + generating any wrapper code. Such information generally includes type + declarations (e.g., typedef) as well as C++ classes that might + be used as base-classes for class declarations in the interface. The + use of %import is also important when SWIG is used to generate + extensions as a collection of related modules. This is an advanced + topic and is described in later in the Working with + Modules chapter.

    +

    The -importall directive tells SWIG to follow all +#include statements as imports. This might be useful if you want to + extract type definitions from system header files without generating + any wrappers.

    +

    8.3 Conditional + Compilation

    +

    SWIG fully supports the use of #if, #ifdef, +#ifndef, #else, #endif to conditionally include + parts of an interface. The following symbols are predefined by SWIG + when it is parsing the interface:

    -%cstring_chunk_output(char *packet, PACKETSIZE);
    -...
    -void get_packet(char *packet);
    +SWIG                            Always defined when SWIG is processing a file
    +SWIGIMPORTED                    Defined when SWIG is importing a file with %import
    +SWIG_VERSION                    Hexadecimal (binary-coded decimal) number containing SWIG version,
    +                                such as 0x010311 (corresponding to SWIG-1.3.11).
    +
    +SWIGALLEGROCL                   Defined when using Allegro CL
    +SWIGCFFI                        Defined when using CFFI
    +SWIGCHICKEN                     Defined when using CHICKEN
    +SWIGCLISP                       Defined when using CLISP
    +SWIGCSHARP                      Defined when using C#
    +SWIGGUILE                       Defined when using Guile
    +SWIGJAVA                        Defined when using Java
    +SWIGJAVASCRIPT                  Defined when using Javascript
    +SWIG_JAVASCRIPT_JSC             Defined when using Javascript for JavascriptCore
    +SWIG_JAVASCRIPT_V8              Defined when using Javascript for v8 or node.js 
    +SWIGLUA                         Defined when using Lua
    +SWIGMODULA3                     Defined when using Modula-3
    +SWIGMZSCHEME                    Defined when using Mzscheme
    +SWIGOCAML                       Defined when using Ocaml
    +SWIGOCTAVE                      Defined when using Octave
    +SWIGPERL                        Defined when using Perl
    +SWIGPHP                         Defined when using PHP
    +SWIGPIKE                        Defined when using Pike
    +SWIGPYTHON                      Defined when using Python
    +SWIGR                           Defined when using R
    +SWIGRUBY                        Defined when using Ruby
    +SWIGSCILAB                      Defined when using Scilab
    +SWIGSEXP                        Defined when using S-expressions
    +SWIGTCL                         Defined when using Tcl
    +SWIGXML                         Defined when using XML
     
    -

    In the target language:

    -
    +

    In addition, SWIG defines the following set of standard C/C++ + macros:

    +
    ->>> get_packet()
    -'\xa9Y:\xf6\xd7\xe1\x87\xdbH;y\x97\x7f\xd3\x99\x14V\xec\x06\xea\xa2\x88'
    ->>>
    +__LINE__                        Current line number
    +__FILE__                        Current file name
    +__STDC__                        Defined to indicate ANSI C
    +__cplusplus                     Defined when -c++ option used
     
    -

    This macro is essentially identical to %cstring_bounded_output -. The only difference is that the result is always chunksize - characters. Furthermore, the result can contain binary data. If - more than maxsize bytes are written, your program - will crash with a buffer overflow!

    -
    -

    %cstring_bounded_mutable(parm, maxsize)

    -
    -

    Turns parameter parm into a mutable string - argument. The input string is assumed to be NULL-terminated and smaller - than maxsize characters. The output string is also - assumed to be NULL-terminated and less than maxsize - characters.

    +

    Interface files can look at these symbols as necessary to change the + way in which an interface is generated or to mix SWIG directives with C + code. These symbols are also defined within the C code generated by + SWIG (except for the symbol `SWIG' which is only defined + within the SWIG compiler).

    +

    8.4 Macro Expansion

    +

    Traditional preprocessor macros can be used in SWIG interfaces. Be + aware that the #define statement is also used to try and + detect constants. Therefore, if you have something like this in your + file,

    -%cstring_bounded_mutable(char *ustr, 1024);
    +#ifndef _FOO_H 1
    +#define _FOO_H 1
     ...
    -void make_upper(char *ustr);
    +#endif
     
    -

    In the target language:

    -
    +

    you may get some extra constants such as _FOO_H showing up + in the scripting interface.

    +

    More complex macros can be defined in the standard way. For example:

    +
    ->>> make_upper("hello world")
    -'HELLO WORLD'
    ->>>
    +#define EXTERN extern
    +#ifdef __STDC__
    +#define _ANSI(args)   (args)
    +#else
    +#define _ANSI(args) ()
    +#endif
     
    -

    Internally, this macro is almost exactly the same as -%cstring_bounded_output. The only difference is that the parameter - accepts an input value that is used to initialize the internal buffer. - It is important to emphasize that this function does not mutate the - string value passed---instead it makes a copy of the input value, - mutates it, and returns it as a result. If more than maxsize - bytes are written, your program will crash with a buffer overflow! -

    -
    -

    %cstring_mutable(parm [, expansion])

    -
    -

    Turns parameter parm into a mutable string - argument. The input string is assumed to be NULL-terminated. An - optional parameter expansion specifies the number of - extra characters by which the string might grow when it is modified. - The output string is assumed to be NULL-terminated and less than the - size of the input string plus any expansion characters.

    +

    The following operators can appear in macro definitions:

    +
      +
    • #x +
      Converts macro argument x to a string surrounded by double + quotes ("x").
    • +
    • x ## y +
      Concatenates x and y together to form xy.
    • +
    • `x` +
      If x is a string surrounded by double quotes, do nothing. + Otherwise, turn into a string like #x. This is a non-standard + SWIG extension.
    • +
    +

    8.5 SWIG Macros

    +

    SWIG provides an enhanced macro capability with the %define + and %enddef directives. For example:

    -%cstring_mutable(char *ustr);
    -...
    -void make_upper(char *ustr);
    +%define ARRAYHELPER(type,name)
    +%inline %{
    +type *new_ ## name (int nitems) {
    +   return (type *) malloc(sizeof(type)*nitems);
    +}
    +void delete_ ## name(type *t) {
    +   free(t);
    +}
    +type name ## _get(type *t, int index) {
    +   return t[index];
    +}
    +void name ## _set(type *t, int index, type val) {
    +   t[index] = val;
    +}
    +%}
    +%enddef
     
    -%cstring_mutable(char *hstr, HEADER_SIZE);
    -...
    -void attach_header(char *hstr);
    +ARRAYHELPER(int, IntArray)
    +ARRAYHELPER(double, DoubleArray)
     
    -

    In the target language:

    -
    +

    The primary purpose of %define is to define large macros of + code. Unlike normal C preprocessor macros, it is not necessary to + terminate each line with a continuation character (\)--the macro + definition extends to the first occurrence of %enddef. + Furthermore, when such macros are expanded, they are reparsed through + the C preprocessor. Thus, SWIG macros can contain all other + preprocessor directives except for nested %define statements.

    +

    The SWIG macro capability is a very quick and easy way to generate + large amounts of code. In fact, many of SWIG's advanced features and + libraries are built using this mechanism (such as C++ template + support).

    +

    8.6 C99 and GNU Extensions

    +

    SWIG-1.3.12 and newer releases support variadic preprocessor macros. + For example:

    +
    ->>> make_upper("hello world")
    -'HELLO WORLD'
    ->>> attach_header("Hello world")
    -'header: Hello world'
    ->>>
    +#define DEBUGF(fmt,...)   fprintf(stderr,fmt,__VA_ARGS__)
     
    -

    This macro differs from %cstring_bounded_mutable() in that - a buffer is dynamically allocated (on the heap using malloc/new -). This buffer is always large enough to store a copy of the input value - plus any expansion bytes that might have been requested. It is - important to emphasize that this function does not directly mutate the - string value passed---instead it makes a copy of the input value, - mutates it, and returns it as a result. If the function expands the - result by more than expansion extra bytes, then the - program will crash with a buffer overflow!

    -
    -

    %cstring_output_maxsize(parm, maxparm)

    -
    -

    This macro is used to handle bounded character output functions - where both a char * and a maximum length parameter are - provided. As input, a user simply supplies the maximum length. The - return value is assumed to be a NULL-terminated string.

    +

    When used, any extra arguments to ... are placed into the + special variable __VA_ARGS__. This also works with special + SWIG macros defined using %define.

    +

    SWIG allows a variable number of arguments to be empty. However, + this often results in an extra comma (,) and syntax error in the + resulting expansion. For example:

    -%cstring_output_maxsize(char *path, int maxpath);
    -...
    -void get_path(char *path, int maxpath);
    +DEBUGF("hello");   --> fprintf(stderr,"hello",);
     
    -

    In the target language:

    -
    +

    To get rid of the extra comma, use ## like this:

    +
    ->>> get_path(1024)
    -'/home/beazley/Packages/Foo/Bar'
    ->>>
    +#define DEBUGF(fmt,...)   fprintf(stderr,fmt, ##__VA_ARGS__)
     
    -

    This macro provides a safer alternative for functions that need to - write string data into a buffer. User supplied buffer size is used to - dynamically allocate memory on heap. Results are placed into that - buffer and returned as a string object.

    -
    -

    %cstring_output_withsize(parm, maxparm)

    -
    -

    This macro is used to handle bounded character output functions - where both a char * and a pointer int * are passed. - Initially, the int * parameter points to a value containing - the maximum size. On return, this value is assumed to contain the - actual number of bytes. As input, a user simply supplies the maximum - length. The output value is a string that may contain binary data.

    +

    SWIG also supports GNU-style variadic macros. For example:

    -%cstring_output_withsize(char *data, int *maxdata);
    -...
    -void get_data(char *data, int *maxdata);
    +#define DEBUGF(fmt, args...)  fprintf(stdout,fmt,args)
     
    -

    In the target language:

    -
    +

    Comment: It's not entirely clear how variadic macros might be + useful to interface building. However, they are used internally to + implement a number of SWIG directives and are provided to make SWIG + more compatible with C99 code.

    +

    8.7 Preprocessing and delimiters +

    +

    The preprocessor handles { }, " " and %{ %} delimiters differently.

    +

    8.7.1 Preprocessing and %{ ... %} & " ... + " delimiters

    +

    The SWIG preprocessor does not process any text enclosed in a code + block %{ ... %}. Therefore, if you write code like this,

    +
    ->>> get_data(1024)
    -'x627388912'
    ->>> get_data(1024)
    -'xyzzy'
    ->>>
    +%{
    +#ifdef NEED_BLAH
    +int blah() {
    +   ...
    +}
    +#endif
    +%}
     
    -

    This macro is a somewhat more powerful version of -%cstring_output_chunk(). Memory is dynamically allocated and can be - arbitrary large. Furthermore, a function can control how much data is - actually returned by changing the value of the maxparm - argument.

    -
    -

    %cstring_output_allocate(parm, release)

    -
    -

    This macro is used to return strings that are allocated within the - program and returned in a parameter of type char **. For - example:

    +

    the contents of the %{ ... %} block are copied without + modification to the output (including all preprocessor directives).

    +

    8.7.2 Preprocessing and { ... } + delimiters

    +

    SWIG always runs the preprocessor on text appearing inside { ... + }. However, sometimes it is desirable to make a preprocessor + directive pass through to the output file. For example:

    -void foo(char **s) {
    -    *s = (char *) malloc(64);
    -    sprintf(*s, "Hello world\n");
    +%extend Foo {
    +   void bar() {
    +      #ifdef DEBUG
    +       printf("I'm in bar\n");
    +      #endif
    +   }
     }
     
    -

    The returned string is assumed to be NULL-terminated. -release specifies how the allocated memory is to be released - (if applicable). Here is an example:

    +

    By default, SWIG will interpret the #ifdef DEBUG statement. + However, if you really wanted that code to actually go into the wrapper + file, prefix the preprocessor directives with % like this:

    -%cstring_output_allocate(char **s, free(*$1));
    -...
    -void foo(char **s);
    +%extend Foo {
    +   void bar() {
    +      %#ifdef DEBUG
    +       printf("I'm in bar\n");
    +      %#endif
    +   }
    +}
     
    -

    In the target language:

    -
    +

    SWIG will strip the extra % and leave the preprocessor + directive in the code.

    +

    8.8 Preprocessor and + Typemaps

    +

    Typemaps support a special attribute called +noblock where the { ... } delimiters can be used, but the + delimiters are not actually generated into the code. The effect is then + similar to using "" or %{ %} delimiters but the code is run + through the preprocessor. For example:

    +
    ->>> foo()
    -'Hello world\n'
    ->>>
    +#define SWIG_macro(CAST) (CAST)$input
    +%typemap(in) Int {$1= SWIG_macro(int);}
     
    -
    -

    %cstring_output_allocate_size(parm, szparm, release)

    -
    -

    This macro is used to return strings that are allocated within the - program and returned in two parameters of type char ** and -int *. For example:

    +
    +

    might generate

    -void foo(char **s, int *sz) {
    -    *s = (char *) malloc(64);
    -    *sz = 64;
    -    // Write some binary data
    -    ...
    -}
    +  {
    +    arg1=(int)jarg1;
    +  }
     
    -

    The returned string may contain binary data. release - specifies how the allocated memory is to be released (if applicable). - Here is an example:

    +

    whereas

    -%cstring_output_allocate_size(char **s, int *slen, free(*$1));
    -...
    -void foo(char **s, int *slen);
    +#define SWIG_macro(CAST) (CAST)$input
    +%typemap(in,noblock=1) Int {$1= SWIG_macro(int);}
     
    -

    In the target language:

    -
    +

    might generate

    +
    ->>> foo()
    -'\xa9Y:\xf6\xd7\xe1\x87\xdbH;y\x97\x7f\xd3\x99\x14V\xec\x06\xea\xa2\x88'
    ->>>
    +  arg1=(int)jarg1;
     
    -

    This is the safest and most reliable way to return binary string - data in SWIG. If you have functions that conform to another prototype, - you might consider wrapping them with a helper function. For example, - if you had this:

    +

    and

    -char  *get_data(int *len);
    +#define SWIG_macro(CAST) (CAST)$input
    +%typemap(in) Int %{$1=SWIG_macro(int);%}
     
    -

    You could wrap it with a function like this:

    +

    would generate

    -void my_get_data(char **result, int *len) {
    -   *result = get_data(len);
    -}
    +  arg1=SWIG_macro(int);
     
    -
    -

    Comments:

    -
      -
    • Support for the cstring.i module depends on the target - language. Not all SWIG modules currently support this library.
    • -
    • Reliable handling of raw C strings is a delicate topic. There are - many ways to accomplish this in SWIG. This library provides support for - a few common techniques.
    • -
    • If used in C++, this library uses new and delete [] - for memory allocation. If using ANSI C, the library uses malloc() - and free().
    • -
    • Rather than manipulating char * directly, you might - consider using a special string structure or class instead.
    • -
    -

    8.4 STL/C++ Library

    -

    The library modules in this section provide access to parts of the - standard C++ library including the STL. SWIG support for the STL is an - ongoing effort. Support is quite comprehensive for some language - modules but some of the lesser used modules do not have quite as much - library code written.

    -

    The following table shows which C++ classes are supported and the - equivalent SWIG interface library file for the C++ library.

    - - - - - - - - - - -
    C++ classC++ Library file -SWIG Interface library file
    std::dequedequestd_deque.i
    std::listliststd_list.i
    std::mapmapstd_map.i
    std::pairutilitystd_pair.i
    std::setsetstd_set.i
    std::stringstringstd_string.i
    std::vectorvectorstd_vector.i
    std::shared_ptrshared_ptrstd_shared_ptr.i
    -

    The list is by no means complete; some language modules support a - subset of the above and some support additional STL classes. Please - look for the library files in the appropriate language library - directory.

    -

    8.4.1 std::string

    -

    The std_string.i library provides typemaps for converting - C++ std::string objects to and from strings in the target - scripting language. For example:

    +
    +

    8.9 Viewing preprocessor output

    +

    Like many compilers, SWIG supports a -E command line option + to display the output from the preprocessor. When the -E + switch is used, SWIG will not generate any wrappers. Instead the + results after the preprocessor has run are displayed. This might be + useful as an aid to debugging and viewing the results of macro + expansions.

    +

    8.10 The #error and #warning + directives

    +

    SWIG supports the commonly used #warning and #error + preprocessor directives. The #warning directive will cause + SWIG to issue a warning then continue processing. The #error + directive will cause SWIG to exit with a fatal error. Example usage:

    -%module example
    -%include "std_string.i"
    -
    -std::string foo();
    -void        bar(const std::string &x);
    +#error "This is a fatal error message"
    +#warning "This is a warning message"
     
    -

    In the target language:

    -
    +

    The #error behaviour can be made to work like #warning + if the -cpperraswarn commandline option is used. + Alternatively, the #pragma directive can be used to the same + effect, for example:

    +
    -x = foo();                # Returns a string object
    -bar("Hello World");       # Pass string as std::string
    +  /* Modified behaviour: #error does not cause SWIG to exit with error */
    +  #pragma SWIG cpperraswarn=1
    +  /* Normal behaviour: #error does cause SWIG to exit with error */
    +  #pragma SWIG cpperraswarn=0
     
    +

    +

    9 SWIG library

    + + + -

    A common problem that people encounter is that of classes/structures - containing a std::string. This can be overcome by defining a - typemap. For example:

    + +

    To help build extension modules, SWIG is packaged with a library of + support files that you can include in your own interfaces. These files + often define new SWIG directives or provide utility functions that can + be used to access parts of the standard C and C++ libraries. This + chapter provides a reference to the current set of supported library + files.

    +

    Compatibility note: Older versions of SWIG included a number + of library files for manipulating pointers, arrays, and other + structures. Most these files are now deprecated and have been removed + from the distribution. Alternative libraries provide similar + functionality. Please read this chapter carefully if you used the old + libraries.

    +

    9.1 The %include directive and library search + path

    +

    Library files are included using the %include directive. + When searching for files, directories are searched in the following + order:

    +
      +
    1. The current directory
    2. +
    3. Directories specified with the -I command line option
    4. +
    5. ./swig_lib
    6. +
    7. SWIG library install location as reported by swig -swiglib, + for example /usr/local/share/swig/1.3.30
    8. +
    9. On Windows, a directory Lib relative to the location of +swig.exe is also searched.
    10. +
    +

    Within directories mentioned in points 3-5, SWIG first looks for a + subdirectory corresponding to a target language (e.g., python, + tcl, etc.). If found, SWIG will search the language specific + directory first. This allows for language-specific implementations of + library files.

    +

    You can ignore the installed SWIG library by setting the +SWIG_LIB environment variable. Set the environment variable to hold + an alternative library directory.

    +

    The directories that are searched are displayed when using +-verbose commandline option.

    +

    9.2 C Arrays and Pointers

    +

    This section describes library modules for manipulating low-level C + arrays and pointers. The primary use of these modules is in supporting + C declarations that manipulate bare pointers such as int *, +double *, or void *. The modules can be used to allocate + memory, manufacture pointers, dereference memory, and wrap pointers as + class-like objects. Since these functions provide direct access to + memory, their use is potentially unsafe and you should exercise + caution.

    +

    9.2.1 cpointer.i

    +

    The cpointer.i module defines macros that can be used to + used to generate wrappers around simple C pointers. The primary use of + this module is in generating pointers to primitive datatypes such as +int and double.

    +

    %pointer_functions(type,name)

    +
    +

    Generates a collection of four functions for manipulating a pointer +type *:

    +

    type *new_name()

    +
    +

    Creates a new object of type type and returns a pointer to + it. In C, the object is created using calloc(). In C++, +new is used.

    +
    +

    type *copy_name(type value)

    +
    +

    Creates a new object of type type and returns a pointer to + it. An initial value is set by copying it from value. In C, + the object is created using calloc(). In C++, new is + used.

    +
    +

    type *delete_name(type *obj)

    +
    +

    Deletes an object type type.

    +
    +

    void name_assign(type *obj, type value)

    +
    +

    Assigns *obj = value.

    +
    +

    type name_value(type *obj)

    +
    +

    Returns the value of *obj.

    +
    +

    When using this macro, type may be any type and name + must be a legal identifier in the target language. name should + not correspond to any other name used in the interface file.

    +

    Here is a simple example of using %pointer_functions():

     %module example
    -%include "std_string.i"
    +%include "cpointer.i"
     
    -%apply const std::string& {std::string* foo};
    +/* Create some functions for working with "int *" */
    +%pointer_functions(int, intp);
     
    -struct my_struct
    -{
    -  std::string foo;
    -};
    +/* A function that uses an "int *" */
    +void add(int x, int y, int *result);
     
    -

    In the target language:

    +

    Now, in Python:

    -x = my_struct();
    -x.foo="Hello World";      # assign with string
    -print x.foo;              # print as string
    +>>> import example
    +>>> c = example.new_intp()     # Create an "int" for storing result
    +>>> example.add(3,4,c)         # Call function
    +>>> example.intp_value(c)      # Dereference
    +7
    +>>> example.delete_intp(c)     # Delete
    +
    +
    +

    %pointer_class(type,name)

    +
    +

    Wraps a pointer of type * inside a class-based interface. + This interface is as follows:

    +
    +
    +struct name {
    +   name();                            // Create pointer object
    +  ~name();                            // Delete pointer object
    +   void assign(type value);           // Assign value
    +   type value();                      // Get value
    +   type *cast();                      // Cast the pointer to original type
    +   static name *frompointer(type *);  // Create class wrapper from existing
    +                                      // pointer
    +};
     
    -

    This module only supports types std::string and const - std::string &. Pointers and non-const references are left - unmodified and returned as SWIG pointers.

    -

    This library file is fully aware of C++ namespaces. If you export -std::string or rename it with a typedef, make sure you include - those declarations in your interface. For example:

    +

    When using this macro, type is restricted to a simple type + name like int, float, or Foo. Pointers and + other complicated types are not allowed. name must be a valid + identifier not already in use. When a pointer is wrapped as a class, + the "class" may be transparently passed to any function that expects + the pointer.

    +

    If the target language does not support proxy classes, the use of + this macro will produce the example same functions as +%pointer_functions() macro.

    +

    It should be noted that the class interface does introduce a new + object or wrap a pointer inside a special structure. Instead, the raw + pointer is used directly.

    +

    Here is the same example using a class instead:

     %module example
    -%include "std_string.i"
    +%include "cpointer.i"
     
    -using namespace std;
    -typedef std::string String;
    -...
    -void foo(string s, const String &t);     // std_string typemaps still applied
    +/* Wrap a class interface around an "int *" */
    +%pointer_class(int, intp);
    +
    +/* A function that uses an "int *" */
    +void add(int x, int y, int *result);
     
    -

    8.4.2 std::vector

    -

    The std_vector.i library provides support for the C++ -std::vector class in the STL. Using this library involves the use - of the %template directive. All you need to do is to - instantiate different versions of vector for the types that - you want to use. For example:

    +

    Now, in Python (using proxy classes)

    +
    +
    +>>> import example
    +>>> c = example.intp()         # Create an "int" for storing result
    +>>> example.add(3,4,c)         # Call function
    +>>> c.value()                  # Dereference
    +7
    +
    +
    +

    Of the two macros, %pointer_class is probably the most + convenient when working with simple pointers. This is because the + pointers are access like objects and they can be easily garbage + collected (destruction of the pointer object destroys the underlying + object).

    +
    +

    %pointer_cast(type1, type2, name)

    +
    +

    Creates a casting function that converts type1 to type2 +. The name of the function is name. For example:

    -%module example
    -%include "std_vector.i"
    -
    -namespace std {
    -   %template(vectori) vector<int>;
    -   %template(vectord) vector<double>;
    -};
    +%pointer_cast(int *, unsigned int *, int_to_uint);
     
    -

    When a template vector<X> is instantiated a number of - things happen:

    -
      -
    • A class that exposes the C++ API is created in the target language . - This can be used to create objects, invoke methods, etc. This class is - currently a subset of the real STL vector class.
    • -
    • Input typemaps are defined for vector<X>, const - vector<X> &, and const vector<X> *. For each of these, a - pointer vector<X> * may be passed or a native list object in - the target language.
    • -
    • An output typemap is defined for vector<X>. In this case, - the values in the vector are expanded into a list object in the target - language.
    • -
    • For all other variations of the type, the wrappers expect to receive - a vector<X> * object in the usual manner.
    • -
    • An exception handler for std::out_of_range is defined.
    • -
    • Optionally, special methods for indexing, item retrieval, slicing, - and element assignment may be defined. This depends on the target - language.
    • -
    -

    To illustrate the use of this library, consider the following - functions:

    +

    In this example, the function int_to_uint() would be used + to cast types in the target language.

    +
    +

    Note: None of these macros can be used to safely work with + strings (char * or char **).

    +

    Note: When working with simple pointers, typemaps can often + be used to provide more seamless operation.

    +

    9.2.2 carrays.i

    +

    This module defines macros that assist in wrapping ordinary C + pointers as arrays. The module does not provide any safety or an extra + layer of wrapping--it merely provides functionality for creating, + destroying, and modifying the contents of raw C array data.

    +

    %array_functions(type,name)

    +
    +

    Creates four functions.

    +

    type *new_name(int nelements)

    +
    +

    Creates a new array of objects of type type. In C, the + array is allocated using calloc(). In C++, new [] is + used.

    +
    +

    type *delete_name(type *ary)

    +
    +

    Deletes an array. In C, free() is used. In C++, delete + [] is used.

    +
    +

    type name_getitem(type *ary, int index)

    +
    +

    Returns the value ary[index].

    +
    +

    void name_setitem(type *ary, int index, type value)

    +
    +

    Assigns ary[index] = value.

    +
    +

    When using this macro, type may be any type and name + must be a legal identifier in the target language. name should + not correspond to any other name used in the interface file.

    +

    Here is an example of %array_functions(). Suppose you had a + function like this:

    -/* File : example.h */
    -
    -#include <vector>
    -#include <algorithm>
    -#include <functional>
    -#include <numeric>
    -
    -double average(std::vector<int> v) {
    -    return std::accumulate(v.begin(),v.end(),0.0)/v.size();
    -}
    -
    -std::vector<double> half(const std::vector<double>& v) {
    -    std::vector<double> w(v);
    -    for (unsigned int i=0; i<w.size(); i++)
    -        w[i] /= 2.0;
    -    return w;
    -}
    -
    -void halve_in_place(std::vector<double>& v) {
    -    std::transform(v.begin(),v.end(),v.begin(),
    -                   std::bind2nd(std::divides<double>(),2.0));
    +void print_array(double x[10]) {
    +   int i;
    +   for (i = 0; i < 10; i++) {
    +      printf("[%d] = %g\n", i, x[i]);
    +   }
     }
     
    -

    To wrap with SWIG, you might write the following:

    +

    To wrap it, you might write this:

     %module example
    -%{
    -#include "example.h"
    -%}
     
    -%include "std_vector.i"
    -// Instantiate templates used by example
    -namespace std {
    -   %template(IntVector) vector<int>;
    -   %template(DoubleVector) vector<double>;
    -}
    +%include "carrays.i"
    +%array_functions(double, doubleArray);
     
    -// Include the header file with above prototypes
    -%include "example.h"
    +void print_array(double x[10]);
     
    -

    Now, to illustrate the behavior in the scripting interpreter, - consider this Python example:

    -
    +

    Now, in a scripting language, you might write this:

    +
    ->>> from example import *
    ->>> iv = IntVector(4)         # Create an vector<int>
    ->>> for i in range(0,4):
    -...      iv[i] = i
    ->>> average(iv)               # Call method
    -1.5
    ->>> average([0,1,2,3])        # Call with list
    -1.5
    ->>> half([1,2,3])             # Half a list
    -(0.5,1.0,1.5)
    ->>> halve_in_place([1,2,3])   # Oops
    -Traceback (most recent call last):
    -  File "<stdin>", line 1, in ?
    -TypeError: Type error. Expected _p_std__vectorTdouble_t
    ->>> dv = DoubleVector(4)
    ->>> for i in range(0,4):
    -...       dv[i] = i
    ->>> halve_in_place(dv)       # Ok
    ->>> for i in dv:
    -...       print i
    -...
    -0.0
    -0.5
    -1.0
    -1.5
    ->>> dv[20] = 4.5
    -Traceback (most recent call last):
    -  File "<stdin>", line 1, in ?
    -  File "example.py", line 81, in __setitem__
    -    def __setitem__(*args): return apply(examplec.DoubleVector___setitem__,args)
    -IndexError: vector index out of range
    ->>>
    +a = new_doubleArray(10)           # Create an array
    +for i in range(0,10):
    +    doubleArray_setitem(a,i,2*i)  # Set a value
    +print_array(a)                    # Pass to C
    +delete_doubleArray(a)             # Destroy array
    +
    +
    +

    %array_class(type,name)

    +
    +

    Wraps a pointer of type * inside a class-based interface. + This interface is as follows:

    +
    +
    +struct name {
    +   name(int nelements);                  // Create an array
    +  ~name();                               // Delete array
    +   type getitem(int index);              // Return item
    +   void setitem(int index, type value);  // Set item
    +   type *cast();                         // Cast to original type
    +   static name *frompointer(type *);     // Create class wrapper from
    +                                         // existing pointer
    +};
     
    -

    This library module is fully aware of C++ namespaces. If you use - vectors with other names, make sure you include the appropriate -using or typedef directives. For example:

    +

    When using this macro, type is restricted to a simple type + name like int or float. Pointers and other + complicated types are not allowed. name must be a valid + identifier not already in use. When a pointer is wrapped as a class, it + can be transparently passed to any function that expects the pointer.

    +

    When combined with proxy classes, the %array_class() macro + can be especially useful. For example:

    -%include "std_vector.i"
    -
    -namespace std {
    -    %template(IntVector) vector<int>;
    -}
    -
    -using namespace std;
    -typedef std::vector Vector;
    +%module example
    +%include "carrays.i"
    +%array_class(double, doubleArray);
     
    -void foo(vector<int> *x, const Vector &x);
    +void print_array(double x[10]);
     
    -

    Note: This module makes use of several advanced SWIG features - including templatized typemaps and template partial specialization. If - you are trying to wrap other C++ code with templates, you might look at - the code contained in std_vector.i. Alternatively, you can - show them the code if you want to make their head explode.

    -

    Note: This module is defined for all SWIG target languages. - However argument conversion details and the public API exposed to the - interpreter vary.

    -

    8.4.3 STL exceptions

    -

    Many of the STL wrapper functions add parameter checking and will - throw a language dependent error/exception should the values not be - valid. The classic example is array bounds checking. The library - wrappers are written to throw a C++ exception in the case of error. The - C++ exception in turn gets converted into an appropriate - error/exception for the target language. By and large this handling - should not need customising, however, customisation can easily be - achieved by supplying appropriate "throws" typemaps. For example:

    +

    Allows you to do this:

    -%module example
    -%include "std_vector.i"
    -%typemap(throws) std::out_of_range {
    -  // custom exception handler
    -}
    -%template(VectInt) std::vector<int>;
    +import example
    +c = example.doubleArray(10)  # Create double[10]
    +for i in range(0,10):
    +    c[i] = 2*i               # Assign values
    +example.print_array(c)       # Pass to C
     
    -
    -

    The custom exception handler might, for example, log the exception - then convert it into a specific error/exception for the target - language.

    -

    When using the STL it is advisable to add in an exception handler to - catch all STL exceptions. The %exception directive can be used - by placing the following code before any other methods or libraries to - be wrapped:

    +
    +

    Note: These macros do not encapsulate C arrays inside a + special data structure or proxy. There is no bounds checking or safety + of any kind. If you want this, you should consider using a special + array object rather than a bare pointer.

    +

    Note: %array_functions() and %array_class() + should not be used with types of char or char *.

    +

    9.2.3 cmalloc.i

    +

    This module defines macros for wrapping the low-level C memory + allocation functions malloc(), calloc(), +realloc(), and free().

    +

    %malloc(type [,name=type])

    +
    +

    Creates a wrapper around malloc() with the following + prototype:

    -%include "exception.i"
    -
    -%exception {
    -  try {
    -    $action
    -  } catch (const std::exception& e) {
    -    SWIG_exception(SWIG_RuntimeError, e.what());
    -  }
    -}
    +type *malloc_name(int nbytes = sizeof(type));
     
    -

    Any thrown STL exceptions will then be gracefully handled instead of - causing a crash.

    -

    8.4.4 shared_ptr smart pointer

    -

    Some target languages have support for handling the widely used -boost::shared_ptr smart pointer. This smart pointer is also - available as std::tr1::shared_ptr before it becomes fully - standardized as std::shared_ptr. The boost_shared_ptr.i - library provides support for boost::shared_ptr and -std_shared_ptr.i provides support for std::shared_ptr, but - if the following macro is defined as shown, it can be used for -std::tr1::shared_ptr:

    +

    If type is void, then the size parameter +nbytes is required. The name parameter only needs to be + specified when wrapping a type that is not a valid identifier (e.g., " +int *", "double **", etc.).

    +
    +

    %calloc(type [,name=type])

    +
    +

    Creates a wrapper around calloc() with the following + prototype:

    -#define SWIG_SHARED_PTR_SUBNAMESPACE tr1
    -%include <std_shared_ptr.i>
    +type *calloc_name(int nobj =1, int sz = sizeof(type));
     
    -

    You can only use one of these variants of shared_ptr in your - interface file at a time. and all three variants must be used in - conjunction with the %shared_ptr(T) macro, where T is - the underlying pointer type equating to usage shared_ptr<T>. - The type T must be non-primitive. A simple example - demonstrates usage:

    +

    If type is void, then the size parameter sz + is required.

    +
    +

    %realloc(type [,name=type])

    +
    +

    Creates a wrapper around realloc() with the following + prototype:

    -%module example
    -%include <boost_shared_ptr.i>
    -%shared_ptr(IntValue)
    -
    -%inline %{
    -#include <boost/shared_ptr.hpp>
    -
    -struct IntValue {
    -  int value;
    -  IntValue(int v) : value(v) {}
    -};
    -
    -static int extractValue(const IntValue &t) {
    -  return t.value;
    -}
    -
    -static int extractValueSmart(boost::shared_ptr<IntValue> t) {
    -  return t->value;
    -}
    -%}
    +type *realloc_name(type *ptr, int nitems);
     
    -

    Note that the %shared_ptr(IntValue) declaration occurs - after the inclusion of the boost_shared_ptr.i library which - provides the macro and, very importantly, before any usage or - declaration of the type, IntValue. The %shared_ptr - macro provides, a few things for handling this smart pointer, but - mostly a number of typemaps. These typemaps override the default - typemaps so that the underlying proxy class is stored and passed around - as a pointer to a shared_ptr instead of a plain pointer to the - underlying type. This approach means that any instantiation of the type - can be passed to methods taking the type by value, reference, pointer - or as a smart pointer. The interested reader might want to look at the - generated code, however, usage is simple and no different handling is - required from the target language. For example, a simple use case of - the above code from Java would be:

    -
    -
    -IntValue iv = new IntValue(1234);
    -int val1 = example.extractValue(iv);
    -int val2 = example.extractValueSmart(iv);
    -System.out.println(val1 + " " + val2);
    -
    +

    Note: unlike the C realloc(), the wrapper generated by this + macro implicitly includes the size of the corresponding type. For + example, realloc_int(p, 100) reallocates p so that it + holds 100 integers.

    -

    This shared_ptr library works quite differently to SWIG's normal, - but somewhat limited, smart pointer - handling. The shared_ptr library does not generate extra wrappers, - just for smart pointer handling, in addition to the proxy class. The - normal proxy class including inheritance relationships is generated as - usual. The only real change introduced by the %shared_ptr - macro is that the proxy class stores a pointer to the shared_ptr - instance instead of a raw pointer to the instance. A proxy class - derived from a base which is being wrapped with shared_ptr can and - must be wrapped as a shared_ptr too. In other words all classes in - an inheritance hierarchy must all be used with the %shared_ptr - macro. For example the following code can be used with the base class - shown earlier:

    +

    %free(type [,name=type])

    +
    +

    Creates a wrapper around free() with the following + prototype:

    -%shared_ptr(DerivedIntValue)
    -%inline %{
    -struct DerivedIntValue : IntValue {
    -  DerivedIntValue(int value) : IntValue(value) {}
    -  ...
    -};
    -%}
    +void free_name(type *ptr);
     
    -
    -

    A shared_ptr of the derived class can now be passed to a method - where the base is expected in the target language, just as it can in - C++:

    -
    +
    +

    %sizeof(type [,name=type])

    +
    +

    Creates the constant:

    +
    -DerivedIntValue div = new DerivedIntValue(5678);
    -int val3 = example.extractValue(div);
    -int val4 = example.extractValueSmart(div);
    +%constant int sizeof_name = sizeof(type);
     
    +
    +

    %allocators(type [,name=type])

    +
    +

    Generates wrappers for all five of the above operations.

    -

    If the %shared_ptr macro is omitted for any class in the - inheritance hierarchy, SWIG will warn about this and the generated code - may or may not result in a C++ compilation error. For example, the - following input:

    +

    Here is a simple example that illustrates the use of these macros:

    -%include "boost_shared_ptr.i"
    -%shared_ptr(Parent);
    +// SWIG interface
    +%module example
    +%include "cmalloc.i"
     
    -%inline %{
    -  #include <boost/shared_ptr.hpp>
    -  struct GrandParent {
    -    virtual ~GrandParent() {}
    -  };
    +%malloc(int);
    +%free(int);
     
    -  struct Parent : GrandParent {
    -    virtual ~Parent() {}
    -  };
    +%malloc(int *, intp);
    +%free(int *, intp);
     
    -  struct Child : Parent {
    -    virtual ~Child() {}
    -  };
    -%}
    +%allocators(double);
     
    -

    warns about the missing smart pointer information:

    -
    +

    Now, in a script:

    +
    -example.i:12: Warning 520: Base class 'GrandParent' of 'Parent' is not similarly marked as a smart pointer.
    -example.i:16: Warning 520: Derived class 'Child' of 'Parent' is not similarly marked as a smart pointer.
    +>>> from example import *
    +>>> a = malloc_int()
    +>>> a
    +'_000efa70_p_int'
    +>>> free_int(a)
    +>>> b = malloc_intp()
    +>>> b
    +'_000efb20_p_p_int'
    +>>> free_intp(b)
    +>>> c = calloc_double(50)
    +>>> c
    +'_000fab98_p_double'
    +>>> c = realloc_double(100000)
    +>>> free_double(c)
    +>>> print sizeof_double
    +8
    +>>>
     
    -

    Adding the missing %shared_ptr macros will fix this:

    -
    -
    -%include "boost_shared_ptr.i"
    -%shared_ptr(GrandParent);
    -%shared_ptr(Parent);
    -%shared_ptr(Child);
    -
    -... as before ...
    -
    -
    Note: There is currently no support for %shared_ptr - and the director feature. -

    8.5 Utility Libraries

    -

    8.5.1 exception.i

    -

    The exception.i library provides a language-independent - function for raising a run-time exception in the target language. This - library is largely used by the SWIG library writers. If possible, use - the error handling scheme available to your target language as there is - greater flexibility in what errors/exceptions can be thrown.

    -

    SWIG_exception(int code, const char *message)

    +

    9.2.4 cdata.i

    +

    The cdata.i module defines functions for converting raw C + data to and from strings in the target language. The primary + applications of this module would be packing/unpacking of binary data + structures---for instance, if you needed to extract data from a buffer. + The target language must support strings with embedded binary data in + order for this to work.

    +

    const char *cdata(void *ptr, size_t nbytes)

    -

    Raises an exception in the target language. code is one of - the following symbolic constants:

    -
    -
    -SWIG_MemoryError
    -SWIG_IOError
    -SWIG_RuntimeError
    -SWIG_IndexError
    -SWIG_TypeError
    -SWIG_DivisionByZero
    -SWIG_OverflowError
    -SWIG_SyntaxError
    -SWIG_ValueError
    -SWIG_SystemError
    -
    -
    -

    message is a string indicating more information about the - problem.

    -
    -

    The primary use of this module is in writing language-independent - exception handlers. For example:

    -
    -
    -%include "exception.i"
    -%exception std::vector::getitem {
    -    try {
    -        $action
    -    } catch (std::out_of_range& e) {
    -        SWIG_exception(SWIG_IndexError,const_cast<char*>(e.what()));
    -    }
    -}
    -
    -

    -

    9 Argument Handling

    - - - - -

    In Chapter 3, SWIG's treatment of basic datatypes and pointers was - described. In particular, primitive types such as int and -double are mapped to corresponding types in the target language. - For everything else, pointers are used to refer to structures, classes, - arrays, and other user-defined datatypes. However, in certain - applications it is desirable to change SWIG's handling of a specific - datatype. For example, you might want to return multiple values through - the arguments of a function. This chapter describes some of the - techniques for doing this.

    -

    9.1 The typemaps.i library

    -

    This section describes the typemaps.i library - file--commonly used to change certain properties of argument - conversion.

    -

    9.1.1 Introduction

    -

    Suppose you had a C function like this:

    -
    -
    -void add(double a, double b, double *result) {
    -	*result = a + b;
    -}
    -
    +

    void memmove(void *ptr, const char *s)

    +
    +

    Copies all of the string data in s into the memory pointed + to by ptr. The string may contain embedded NULL bytes. This is + actually a wrapper to the standard C library memmove function, + which is declared as void memmove(void *ptr, const void *src, + size_t n). The src and length n parameters + are extracted from the language specific string s in the + underlying wrapper code.

    -

    From reading the source code, it is clear that the function is - storing a value in the double *result parameter. However, - since SWIG does not examine function bodies, it has no way to know that - this is the underlying behavior.

    -

    One way to deal with this is to use the typemaps.i library - file and write interface code like this:

    +

    One use of these functions is packing and unpacking data from + memory. Here is a short example:

    -// Simple example using typemaps
    +// SWIG interface
     %module example
    -%include "typemaps.i"
    +%include "carrays.i"
    +%include "cdata.i"
     
    -%apply double *OUTPUT { double *result };
    -%inline %{
    -extern void add(double a, double b, double *result);
    -%}
    +%array_class(int, intArray);
     
    -

    The %apply directive tells SWIG that you are going to apply - a special type handling rule to a type. The "double *OUTPUT" - specification is the name of a rule that defines how to return an - output value from an argument of type double *. This rule gets - applied to all of the datatypes listed in curly braces-- in this case " -double *result".

    -

    When the resulting module is created, you can now use the function - like this (shown for Python):

    +

    Python example:

    ->>> a = add(3,4)
    ->>> print a
    -7
    +>>> a = intArray(10)
    +>>> for i in range(0,10):
    +...    a[i] = i
    +>>> b = cdata(a,40)
    +>>> b
    +'\x00\x00\x00\x00\x00\x00\x00\x01\x00\x00\x00\x02\x00\x00\x00\x03\x00\x00\x00\x04
    +\x00\x00\x00\x05\x00\x00\x00\x06\x00\x00\x00\x07\x00\x00\x00\x08\x00\x00\x00\t'
    +>>> c = intArray(10)
    +>>> memmove(c,b)
    +>>> print c[4]
    +4
     >>>
     
    -

    In this case, you can see how the output value normally returned in - the third argument has magically been transformed into a function - return value. Clearly this makes the function much easier to use since - it is no longer necessary to manufacture a special double * - object and pass it to the function somehow.

    -

    Once a typemap has been applied to a type, it stays in effect for - all future occurrences of the type and name. For example, you could - write the following:

    +

    Since the size of data is not always known, the following macro is + also defined:

    +

    %cdata(type [,name=type])

    +
    +

    Generates the following function for extracting C data for a given + type.

    -%module example
    -%include "typemaps.i"
    -
    -%apply double *OUTPUT { double *result };
    -
    -%inline %{
    -extern void add(double a, double b, double *result);
    -extern void sub(double a, double b, double *result);
    -extern void mul(double a, double b, double *result);
    -extern void div(double a, double b, double *result);
    -%}
    -...
    +char *cdata_name(type* ptr, int nitems)
     
    -

    In this case, the double *OUTPUT rule is applied to all of - the functions that follow.

    -

    Typemap transformations can even be extended to multiple return - values. For example, consider this code:

    +

    nitems is the number of items of the given type to extract.

    +
    +

    Note: These functions provide direct access to memory and can + be used to overwrite data. Clearly they are unsafe.

    +

    9.3 C String Handling

    +

    A common problem when working with C programs is dealing with + functions that manipulate raw character data using char *. In + part, problems arise because there are different interpretations of +char *---it could be a NULL-terminated string or it could point to + binary data. Moreover, functions that manipulate raw strings may mutate + data, perform implicit memory allocations, or utilize fixed-sized + buffers.

    +

    The problems (and perils) of using char * are well-known. + However, SWIG is not in the business of enforcing morality. The modules + in this section provide basic functionality for manipulating raw C + strings.

    +

    9.3.1 Default string handling

    +

    Suppose you have a C function with this prototype:

    -%include "typemaps.i"
    -%apply int *OUTPUT { int *width, int *height };
    -
    -// Returns a pair (width,height)
    -void getwinsize(int winid, int *width, int *height);
    +char *foo(char *s);
     
    -

    In this case, the function returns multiple values, allowing it to - be used like this:

    -
    +

    The default wrapping behavior for this function is to set s + to a raw char * that refers to the internal string data in the + target language. In other words, if you were using a language like Tcl, + and you wrote this,

    +
    ->>> w,h = genwinsize(wid)
    ->>> print w
    -400
    ->>> print h
    -300
    ->>>
    +% foo Hello
     
    -

    It should also be noted that although the %apply directive - is used to associate typemap rules to datatypes, you can also use the - rule names directly in arguments. For example, you could write this:

    +

    then s would point to the representation of "Hello" inside + the Tcl interpreter. When returning a char *, SWIG assumes + that it is a NULL-terminated string and makes a copy of it. This gives + the target language its own copy of the result.

    +

    There are obvious problems with the default behavior. First, since a + char * argument points to data inside the target language, it + is NOT safe for a function to modify this data (doing so may + corrupt the interpreter and lead to a crash). Furthermore, the default + behavior does not work well with binary data. Instead, strings are + assumed to be NULL-terminated.

    +

    9.3.2 Passing binary data

    +

    If you have a function that expects binary data,

    -// Simple example using typemaps
    -%module example
    -%include "typemaps.i"
    -
    -%{
    -extern void add(double a, double b, double *OUTPUT);
    -%}
    -extern void add(double a, double b, double *OUTPUT);
    +size_t parity(char *str, size_t len, size_t initial);
     
    -

    Typemaps stay in effect until they are explicitly deleted or - redefined to something else. To clear a typemap, the %clear - directive should be used. For example:

    +

    you can wrap the parameters (char *str, size_t len) as a + single argument using a typemap. Just do this:

    -%clear double *result;      // Remove all typemaps for double *result
    +%apply (char *STRING, size_t LENGTH) { (char *str, size_t len) };
    +...
    +size_t parity(char *str, size_t len, size_t initial);
     
    -

    9.1.2 Input parameters

    -

    The following typemaps instruct SWIG that a pointer really only - holds a single input value:

    +

    Now, in the target language, you can use binary string data like + this:

    -int *INPUT		
    -short *INPUT
    -long *INPUT
    -unsigned int *INPUT
    -unsigned short *INPUT
    -unsigned long *INPUT
    -double *INPUT
    -float *INPUT
    +>>> s = "H\x00\x15eg\x09\x20"
    +>>> parity(s,0)
     
    -

    When used, it allows values to be passed instead of pointers. For - example, consider this function:

    +

    In the wrapper function, the passed string will be expanded to a + pointer and length parameter. The (char *STRING, int LENGTH) + multi-argument typemap is also available in addition to (char + *STRING, size_t LENGTH).

    +

    9.3.3 Using %newobject to release memory

    +

    If you have a function that allocates memory like this,

    -double add(double *a, double *b) {
    -	return *a+*b;
    +char *foo() {
    +   char *result = (char *) malloc(...);
    +   ...
    +   return result;
     }
     
    -

    Now, consider this SWIG interface:

    +

    then the SWIG generated wrappers will have a memory leak--the + returned data will be copied into a string object and the old contents + ignored.

    +

    To fix the memory leak, use the %newobject directive.

    -%module example
    -%include "typemaps.i"
    +%newobject foo;
     ...
    -%{
    -extern double add(double *, double *);
    -%}
    -extern double add(double *INPUT, double *INPUT);
    -
    -
    -
    -

    When the function is used in the scripting language interpreter, it - will work like this:

    -
    -
    -result = add(3,4)
    +char *foo();
     
    -

    9.1.3 Output parameters

    -

    The following typemap rules tell SWIG that pointer is the output - value of a function. When used, you do not need to supply the argument - when calling the function. Instead, one or more output values are - returned.

    +

    This will release the result if the appropriate target language + support is available. SWIG provides the appropriate "newfree" typemap + for char * so that the memory is released, however, you may + need to provide your own "newfree" typemap for other types. See +Object ownership and %newobject for more details.

    +

    9.3.4 cstring.i

    +

    The cstring.i library file provides a collection of macros + for dealing with functions that either mutate string arguments or which + try to output string data through their arguments. An example of such a + function might be this rather questionable implementation:

    -int *OUTPUT
    -short *OUTPUT
    -long *OUTPUT
    -unsigned int *OUTPUT
    -unsigned short *OUTPUT
    -unsigned long *OUTPUT
    -double *OUTPUT
    -float *OUTPUT
    -
    +void get_path(char *s) {
    +    // Potential buffer overflow---uh, oh.
    +    sprintf(s,"%s/%s", base_directory, sub_directory);
    +}
    +...
    +// Somewhere else in the C program
    +{
    +    char path[1024];
    +    ...
    +    get_path(path);
    +    ...
    +}
     
    -

    These methods can be used as shown in an earlier example. For - example, if you have this C function :

    +

    (Off topic rant: If your program really has functions like this, you + would be well-advised to replace them with safer alternatives involving + bounds checking).

    +

    The macros defined in this module all expand to various combinations + of typemaps. Therefore, the same pattern matching rules and ideas + apply.

    +

    %cstring_bounded_output(parm, maxsize)

    +
    +

    Turns parameter parm into an output value. The + output string is assumed to be NULL-terminated and smaller than +maxsize characters. Here is an example:

    -void add(double a, double b, double *c) {
    -	*c = a+b;
    -}
    +%cstring_bounded_output(char *path, 1024);
    +...
    +void get_path(char *path);
     
    -

    A SWIG interface file might look like this :

    -
    +

    In the target language:

    +
    -%module example
    -%include "typemaps.i"
    -...
    -%inline %{
    -extern void add(double a, double b, double *OUTPUT);
    -%}
    -
    +>>> get_path()
    +/home/beazley/packages/Foo/Bar
    +>>>
     
    -

    In this case, only a single output value is returned, but this is - not a restriction. An arbitrary number of output values can be returned - by applying the output rules to more than one argument (as shown - previously).

    -

    If the function also returns a value, it is returned along with the - argument. For example, if you had this:

    +

    Internally, the wrapper function allocates a small buffer (on the + stack) of the requested size and passes it as the pointer value. Data + stored in the buffer is then returned as a function return value. If + the function already returns a value, then the return value and the + output string are returned together (multiple return values). If + more than maxsize bytes are written, your program + will crash with a buffer overflow!

    +
    +

    %cstring_chunk_output(parm, chunksize)

    +
    +

    Turns parameter parm into an output value. The + output string is always chunksize and may contain + binary data. Here is an example:

    -extern int foo(double a, double b, double *OUTPUT);
    +%cstring_chunk_output(char *packet, PACKETSIZE);
    +...
    +void get_packet(char *packet);
     
    -

    The function will return two values like this:

    +

    In the target language:

    -iresult, dresult = foo(3.5, 2)
    +>>> get_packet()
    +'\xa9Y:\xf6\xd7\xe1\x87\xdbH;y\x97\x7f\xd3\x99\x14V\xec\x06\xea\xa2\x88'
    +>>>
     
    -

    9.1.4 Input/Output parameters

    -

    When a pointer serves as both an input and output value you can use - the following typemaps :

    +

    This macro is essentially identical to %cstring_bounded_output +. The only difference is that the result is always chunksize + characters. Furthermore, the result can contain binary data. If + more than maxsize bytes are written, your program + will crash with a buffer overflow!

    +
    +

    %cstring_bounded_mutable(parm, maxsize)

    +
    +

    Turns parameter parm into a mutable string + argument. The input string is assumed to be NULL-terminated and smaller + than maxsize characters. The output string is also + assumed to be NULL-terminated and less than maxsize + characters.

    -int *INOUT
    -short *INOUT
    -long *INOUT
    -unsigned int *INOUT
    -unsigned short *INOUT
    -unsigned long *INOUT
    -double *INOUT
    -float *INOUT
    -
    +%cstring_bounded_mutable(char *ustr, 1024);
    +...
    +void make_upper(char *ustr);
     
    -

    A C function that uses this might be something like this:

    -
    +

    In the target language:

    +
    -void negate(double *x) {
    -	*x = -(*x);
    -}
    -
    +>>> make_upper("hello world")
    +'HELLO WORLD'
    +>>>
     
    -

    To make x function as both and input and output value, declare the - function like this in an interface file :

    +

    Internally, this macro is almost exactly the same as +%cstring_bounded_output. The only difference is that the parameter + accepts an input value that is used to initialize the internal buffer. + It is important to emphasize that this function does not mutate the + string value passed---instead it makes a copy of the input value, + mutates it, and returns it as a result. If more than maxsize + bytes are written, your program will crash with a buffer overflow! +

    +
    +

    %cstring_mutable(parm [, expansion])

    +
    +

    Turns parameter parm into a mutable string + argument. The input string is assumed to be NULL-terminated. An + optional parameter expansion specifies the number of + extra characters by which the string might grow when it is modified. + The output string is assumed to be NULL-terminated and less than the + size of the input string plus any expansion characters.

    -%module example
    -%include "typemaps.i"
    +%cstring_mutable(char *ustr);
     ...
    -%{
    -extern void negate(double *);
    -%}
    -extern void negate(double *INOUT);
    +void make_upper(char *ustr);
     
    +%cstring_mutable(char *hstr, HEADER_SIZE);
    +...
    +void attach_header(char *hstr);
     
    -

    Now within a script, you can simply call the function normally :

    +

    In the target language:

    -a = negate(3);         # a = -3 after calling this
    +>>> make_upper("hello world")
    +'HELLO WORLD'
    +>>> attach_header("Hello world")
    +'header: Hello world'
    +>>>
     
    -

    One subtle point of the INOUT rule is that many scripting - languages enforce mutability constraints on primitive objects (meaning - that simple objects like integers and strings aren't supposed to - change). Because of this, you can't just modify the object's value in - place as the underlying C function does in this example. Therefore, the - INOUT rule returns the modified value as a new object rather - than directly overwriting the value of the original input object.

    -

    Compatibility note : The INOUT rule used to be known - as BOTH in earlier versions of SWIG. Backwards compatibility - is preserved, but deprecated.

    -

    9.1.5 Using different names

    -

    As previously shown, the %apply directive can be used to - apply the INPUT, OUTPUT, and INOUT typemaps - to different argument names. For example:

    +

    This macro differs from %cstring_bounded_mutable() in that + a buffer is dynamically allocated (on the heap using malloc/new +). This buffer is always large enough to store a copy of the input value + plus any expansion bytes that might have been requested. It is + important to emphasize that this function does not directly mutate the + string value passed---instead it makes a copy of the input value, + mutates it, and returns it as a result. If the function expands the + result by more than expansion extra bytes, then the + program will crash with a buffer overflow!

    +
    +

    %cstring_output_maxsize(parm, maxparm)

    +
    +

    This macro is used to handle bounded character output functions + where both a char * and a maximum length parameter are + provided. As input, a user simply supplies the maximum length. The + return value is assumed to be a NULL-terminated string.

    -// Make double *result an output value
    -%apply double *OUTPUT { double *result };
    -
    -// Make Int32 *in an input value
    -%apply int *INPUT { Int32 *in };
    -
    -// Make long *x inout
    -%apply long *INOUT {long *x};
    -
    +%cstring_output_maxsize(char *path, int maxpath);
    +...
    +void get_path(char *path, int maxpath);
     
    -

    To clear a rule, the %clear directive is used:

    -
    +

    In the target language:

    +
    -%clear double *result;
    -%clear Int32 *in, long *x;
    +>>> get_path(1024)
    +'/home/beazley/Packages/Foo/Bar'
    +>>>
     
    -

    Typemap declarations are lexically scoped so a typemap takes effect - from the point of definition to the end of the file or a matching -%clear declaration.

    -

    9.2 Applying constraints to input values

    -

    In addition to changing the handling of various input values, it is - also possible to use typemaps to apply constraints. For example, maybe - you want to insure that a value is positive, or that a pointer is - non-NULL. This can be accomplished including the constraints.i - library file.

    -

    9.2.1 Simple constraint example

    -

    The constraints library is best illustrated by the following - interface file :

    +

    This macro provides a safer alternative for functions that need to + write string data into a buffer. User supplied buffer size is used to + dynamically allocate memory on heap. Results are placed into that + buffer and returned as a string object.

    +
    +

    %cstring_output_withsize(parm, maxparm)

    +
    +

    This macro is used to handle bounded character output functions + where both a char * and a pointer int * are passed. + Initially, the int * parameter points to a value containing + the maximum size. On return, this value is assumed to contain the + actual number of bytes. As input, a user simply supplies the maximum + length. The output value is a string that may contain binary data.

    -// Interface file with constraints
    -%module example
    -%include "constraints.i"
    -
    -double exp(double x);
    -double log(double POSITIVE);         // Allow only positive values
    -double sqrt(double NONNEGATIVE);     // Non-negative values only
    -double inv(double NONZERO);          // Non-zero values
    -void   free(void *NONNULL);          // Non-NULL pointers only
    -
    +%cstring_output_withsize(char *data, int *maxdata);
    +...
    +void get_data(char *data, int *maxdata);
     
    -

    The behavior of this file is exactly as you would expect. If any of - the arguments violate the constraint condition, a scripting language - exception will be raised. As a result, it is possible to catch bad - values, prevent mysterious program crashes and so on.

    -

    9.2.2 Constraint methods

    -

    The following constraints are currently available

    -
    +

    In the target language:

    +
    -POSITIVE                     Any number > 0 (not zero)
    -NEGATIVE                     Any number < 0 (not zero)
    -NONNEGATIVE                  Any number >= 0
    -NONPOSITIVE                  Any number <= 0
    -NONZERO                      Nonzero number
    -NONNULL                      Non-NULL pointer (pointers only).
    -
    +>>> get_data(1024)
    +'x627388912'
    +>>> get_data(1024)
    +'xyzzy'
    +>>>
     
    -

    9.2.3 Applying constraints to new - datatypes

    -

    The constraints library only supports the primitive C datatypes, but - it is easy to apply it to new datatypes using %apply. For - example :

    +

    This macro is a somewhat more powerful version of +%cstring_output_chunk(). Memory is dynamically allocated and can be + arbitrary large. Furthermore, a function can control how much data is + actually returned by changing the value of the maxparm + argument.

    +
    +

    %cstring_output_allocate(parm, release)

    +
    +

    This macro is used to return strings that are allocated within the + program and returned in a parameter of type char **. For + example:

    -// Apply a constraint to a Real variable
    -%apply Number POSITIVE { Real in };
    -
    -// Apply a constraint to a pointer type
    -%apply Pointer NONNULL { Vector * };
    -
    +void foo(char **s) {
    +    *s = (char *) malloc(64);
    +    sprintf(*s, "Hello world\n");
    +}
     
    -

    The special types of "Number" and "Pointer" can be applied to any - numeric and pointer variable type respectively. To later remove a - constraint, the %clear directive can be used :

    +

    The returned string is assumed to be NULL-terminated. +release specifies how the allocated memory is to be released + (if applicable). Here is an example:

    -%clear Real in;
    -%clear Vector *;
    +%cstring_output_allocate(char **s, free(*$1));
    +...
    +void foo(char **s);
     
    -

    -

    10 Typemaps

    - - -
    -
    - -

    10.1 Introduction

    -

    Chances are, you are reading this chapter for one of two reasons; - you either want to customize SWIG's behavior or you overheard someone - mumbling some incomprehensible drivel about "typemaps" and you asked - yourself "typemaps, what are those?" That said, let's start with a - short disclaimer that "typemaps" are an advanced customization feature - that provide direct access to SWIG's low-level code generator. Not only - that, they are an integral part of the SWIG C++ type system (a - non-trivial topic of its own). Typemaps are generally not a - required part of using SWIG. Therefore, you might want to re-read the - earlier chapters if you have found your way to this chapter with only a - vague idea of what SWIG already does by default.

    -

    10.1.1 Type conversion

    -

    One of the most important problems in wrapper code generation is the - conversion or marshalling of datatypes between programming languages. - Specifically, for every C/C++ declaration, SWIG must somehow generate - wrapper code that allows values to be passed back and forth between - languages. Since every programming language represents data - differently, this is not a simple of matter of simply linking code - together with the C linker. Instead, SWIG has to know something about - how data is represented in each language and how it can be manipulated.

    -

    To illustrate, suppose you had a simple C function like this:

    +

    In the target language:

    +
    +
    +>>> foo()
    +'Hello world\n'
    +>>>
    +
    +
    +

    %cstring_output_allocate_size(parm, szparm, release)

    +
    +

    This macro is used to return strings that are allocated within the + program and returned in two parameters of type char ** and +int *. For example:

    -int factorial(int n);
    +void foo(char **s, int *sz) {
    +    *s = (char *) malloc(64);
    +    *sz = 64;
    +    // Write some binary data
    +    ...
    +}
     
    -

    To access this function from Python, a pair of Python API functions - are used to convert integer values. For example:

    +

    The returned string may contain binary data. release + specifies how the allocated memory is to be released (if applicable). + Here is an example:

    -long PyInt_AsLong(PyObject *obj);      /* Python --> C */
    -PyObject *PyInt_FromLong(long x);      /* C --> Python */
    +%cstring_output_allocate_size(char **s, int *slen, free(*$1));
    +...
    +void foo(char **s, int *slen);
     
    -

    The first function is used to convert the input argument from a - Python integer object to C long. The second function is used - to convert a value from C back into a Python integer object.

    -

    Inside the wrapper function, you might see these functions used like - this:

    -
    +

    In the target language:

    +
    -PyObject *wrap_factorial(PyObject *self, PyObject *args) {
    -    int       arg1;
    -    int       result;
    -    PyObject *obj1;
    -    PyObject *resultobj;
    -
    -    if (!PyArg_ParseTuple("O:factorial", &obj1)) return NULL;
    -    arg1 = PyInt_AsLong(obj1);
    -    result = factorial(arg1);
    -    resultobj = PyInt_FromLong(result);
    -    return resultobj;
    -}
    +>>> foo()
    +'\xa9Y:\xf6\xd7\xe1\x87\xdbH;y\x97\x7f\xd3\x99\x14V\xec\x06\xea\xa2\x88'
    +>>>
     
    -

    Every target language supported by SWIG has functions that work in a - similar manner. For example, in Perl, the following functions are used:

    +

    This is the safest and most reliable way to return binary string + data in SWIG. If you have functions that conform to another prototype, + you might consider wrapping them with a helper function. For example, + if you had this:

    -IV SvIV(SV *sv);                     /* Perl --> C */
    -void sv_setiv(SV *sv, IV val);       /* C --> Perl */
    +char  *get_data(int *len);
     
    -

    In Tcl:

    +

    You could wrap it with a function like this:

    -int Tcl_GetLongFromObj(Tcl_Interp *interp, Tcl_Obj *obj, long *value);
    -Tcl_Obj *Tcl_NewIntObj(long value);
    +void my_get_data(char **result, int *len) {
    +   *result = get_data(len);
    +}
     
    -
    -

    The precise details are not so important. What is important is that - all of the underlying type conversion is handled by collections of - utility functions and short bits of C code like this---you simply have - to read the extension documentation for your favorite language to know - how it works (an exercise left to the reader).

    -

    10.1.2 Typemaps

    -

    Since type handling is so central to wrapper code generation, SWIG - allows it to be completely defined (or redefined) by the user. To do - this, a special %typemap directive is used. For example:

    +
    +

    Comments:

    +
      +
    • Support for the cstring.i module depends on the target + language. Not all SWIG modules currently support this library.
    • +
    • Reliable handling of raw C strings is a delicate topic. There are + many ways to accomplish this in SWIG. This library provides support for + a few common techniques.
    • +
    • If used in C++, this library uses new and delete [] + for memory allocation. If using ANSI C, the library uses malloc() + and free().
    • +
    • Rather than manipulating char * directly, you might + consider using a special string structure or class instead.
    • +
    +

    9.4 STL/C++ Library

    +

    The library modules in this section provide access to parts of the + standard C++ library including the STL. SWIG support for the STL is an + ongoing effort. Support is quite comprehensive for some language + modules but some of the lesser used modules do not have quite as much + library code written.

    +

    The following table shows which C++ classes are supported and the + equivalent SWIG interface library file for the C++ library.

    + + + + + + + + + + + + +
    C++ classC++ Library file +SWIG Interface library file
    std::auto_ptrmemorystd_auto_ptr.i
    std::dequedequestd_deque.i
    std::listliststd_list.i
    std::mapmapstd_map.i
    std::pairutilitystd_pair.i
    std::setsetstd_set.i
    std::stringstringstd_string.i
    std::vectorvectorstd_vector.i
    std::arrayarray (C++11)std_array.i
    std::shared_ptrshared_ptr (C++11) +std_shared_ptr.i
    +

    The list is by no means complete; some language modules support a + subset of the above and some support additional STL classes. Please + look for the library files in the appropriate language library + directory.

    +

    9.4.1 std::string

    +

    The std_string.i library provides typemaps for converting + C++ std::string objects to and from strings in the target + scripting language. For example:

    -/* Convert from Python --> C */
    -%typemap(in) int {
    -    $1 = PyInt_AsLong($input);
    -}
    +%module example
    +%include "std_string.i"
     
    -/* Convert from C --> Python */
    -%typemap(out) int {
    -    $result = PyInt_FromLong($1);
    -}
    +std::string foo();
    +void        bar(const std::string &x);
     
    -

    At first glance, this code will look a little confusing. However, - there is really not much to it. The first typemap (the "in" typemap) is - used to convert a value from the target language to C. The second - typemap (the "out" typemap) is used to convert in the other direction. - The content of each typemap is a small fragment of code that is - inserted directly into the SWIG generated wrapper functions. The code - is usually C or C++ code which will be generated into the C/C++ wrapper - functions. Note that this isn't always the case as some target language - modules allow target language code within the typemaps which gets - generated into target language specific files. Within this code, a - number of special variables prefixed with a $ are expanded. These are - really just placeholders for C/C++ variables that are generated in the - course of creating the wrapper function. In this case, $input - refers to an input object that needs to be converted to C/C++ and -$result refers to an object that is going to be returned by a - wrapper function. $1 refers to a C/C++ variable that has the - same type as specified in the typemap declaration (an int in - this example).

    -

    A short example might make this a little more clear. If you were - wrapping a function like this:

    -
    +

    In the target language:

    +
    -int gcd(int x, int y);
    +x = foo();                # Returns a string object
    +bar("Hello World");       # Pass string as std::string
     
    -

    A wrapper function would look approximately like this:

    +

    A common problem that people encounter is that of classes/structures + containing a std::string. This can be overcome by defining a + typemap. For example:

    -PyObject *wrap_gcd(PyObject *self, PyObject *args) {
    -   int arg1;
    -   int arg2;
    -   int result;
    -   PyObject *obj1;
    -   PyObject *obj2;
    -   PyObject *resultobj;
    -
    -   if (!PyArg_ParseTuple("OO:gcd", &obj1, &obj2)) return NULL;
    +%module example
    +%include "std_string.i"
     
    -   /* "in" typemap, argument 1 */   
    -   {
    -      arg1 = PyInt_AsLong(obj1);
    -   }
    -
    -   /* "in" typemap, argument 2 */
    -   {
    -      arg2 = PyInt_AsLong(obj2);
    -   }
    -
    -   result = gcd(arg1,arg2);
    +%apply const std::string& {std::string* foo};
     
    -   /* "out" typemap, return value */
    -   {
    -      resultobj = PyInt_FromLong(result);
    -   }
    -
    -   return resultobj;
    -}
    +struct my_struct
    +{
    +  std::string foo;
    +};
     
    -

    In this code, you can see how the typemap code has been inserted - into the function. You can also see how the special $ variables have - been expanded to match certain variable names inside the wrapper - function. This is really the whole idea behind typemaps--they simply - let you insert arbitrary code into different parts of the generated - wrapper functions. Because arbitrary code can be inserted, it possible - to completely change the way in which values are converted.

    -

    10.1.3 Pattern matching

    -

    As the name implies, the purpose of a typemap is to "map" C - datatypes to types in the target language. Once a typemap is defined - for a C datatype, it is applied to all future occurrences of that type - in the input file. For example:

    +

    In the target language:

    +
    +
    +x = my_struct();
    +x.foo="Hello World";      # assign with string
    +print x.foo;              # print as string
    +
    +
    +

    This module only supports types std::string and const + std::string &. Pointers and non-const references are left + unmodified and returned as SWIG pointers.

    +

    This library file is fully aware of C++ namespaces. If you export +std::string or rename it with a typedef, make sure you include + those declarations in your interface. For example:

    -/* Convert from Perl --> C */
    -%typemap(in) int {
    -   $1 = SvIV($input);
    -}
    +%module example
    +%include "std_string.i"
     
    +using namespace std;
    +typedef std::string String;
     ...
    -int factorial(int n);
    -int gcd(int x, int y);
    -int count(char *s, char *t, int max);
    +void foo(string s, const String &t);     // std_string typemaps still applied
     
    -

    The matching of typemaps to C datatypes is more than a simple - textual match. In fact, typemaps are fully built into the underlying - type system. Therefore, typemaps are unaffected by typedef, - namespaces, and other declarations that might hide the underlying type. - For example, you could have code like this:

    +

    9.4.2 std::vector

    +

    The std_vector.i library provides support for the C++ +std::vector class in the STL. Using this library involves the use + of the %template directive. All you need to do is to + instantiate different versions of vector for the types that + you want to use. For example:

    -/* Convert from Ruby--> C */
    -%typemap(in) int {
    -   $1 = NUM2INT($input);
    -}
    -...
    -typedef int Integer;
    -namespace foo {
    -    typedef Integer Number;
    -};
    +%module example
    +%include "std_vector.i"
     
    -int foo(int x);
    -int bar(Integer y);
    -int spam(foo::Number a, foo::Number b);
    +namespace std {
    +   %template(vectori) vector<int>;
    +   %template(vectord) vector<double>;
    +};
     
    -

    In this case, the typemap is still applied to the proper arguments - even though typenames don't always match the text "int". This ability - to track types is a critical part of SWIG--in fact, all of the target - language modules work merely define a set of typemaps for the basic - types. Yet, it is never necessary to write new typemaps for typenames - introduced by typedef.

    -

    In addition to tracking typenames, typemaps may also be specialized - to match against a specific argument name. For example, you could write - a typemap like this:

    +

    When a template vector<X> is instantiated a number of + things happen:

    +
      +
    • A class that exposes the C++ API is created in the target language . + This can be used to create objects, invoke methods, etc. This class is + currently a subset of the real STL vector class.
    • +
    • Input typemaps are defined for vector<X>, const + vector<X> &, and const vector<X> *. For each of these, a + pointer vector<X> * may be passed or a native list object in + the target language.
    • +
    • An output typemap is defined for vector<X>. In this case, + the values in the vector are expanded into a list object in the target + language.
    • +
    • For all other variations of the type, the wrappers expect to receive + a vector<X> * object in the usual manner.
    • +
    • An exception handler for std::out_of_range is defined.
    • +
    • Optionally, special methods for indexing, item retrieval, slicing, + and element assignment may be defined. This depends on the target + language.
    • +
    +

    To illustrate the use of this library, consider the following + functions:

    -%typemap(in) double nonnegative {
    -   $1 = PyFloat_AsDouble($input);
    -   if ($1 < 0) {
    -        PyErr_SetString(PyExc_ValueError,"argument must be nonnegative.");
    -        return NULL;
    -   }
    +/* File : example.h */
    +
    +#include <vector>
    +#include <algorithm>
    +#include <functional>
    +#include <numeric>
    +
    +double average(std::vector<int> v) {
    +    return std::accumulate(v.begin(),v.end(),0.0)/v.size();
     }
     
    -...
    -double sin(double x);
    -double cos(double x);
    -double sqrt(double nonnegative);
    +std::vector<double> half(const std::vector<double>& v) {
    +    std::vector<double> w(v);
    +    for (unsigned int i=0; i<w.size(); i++)
    +        w[i] /= 2.0;
    +    return w;
    +}
     
    -typedef double Real;
    -double log(Real nonnegative);
    -...
    +void halve_in_place(std::vector<double>& v) {
    +    std::transform(v.begin(),v.end(),v.begin(),
    +                   std::bind2nd(std::divides<double>(),2.0));
    +}
     
    -

    For certain tasks such as input argument conversion, typemaps can be - defined for sequences of consecutive arguments. For example:

    +

    To wrap with SWIG, you might write the following:

    -%typemap(in) (char *str, int len) {
    -    $1 = PyString_AsString($input);   /* char *str */
    -    $2 = PyString_Size($input);       /* int len   */
    +%module example
    +%{
    +#include "example.h"
    +%}
    +
    +%include "std_vector.i"
    +// Instantiate templates used by example
    +namespace std {
    +   %template(IntVector) vector<int>;
    +   %template(DoubleVector) vector<double>;
     }
    -...
    -int count(char *str, int len, char c);
    +
    +// Include the header file with above prototypes
    +%include "example.h"
     
    -

    In this case, a single input object is expanded into a pair of C - arguments. This example also provides a hint to the unusual variable - naming scheme involving $1, $2, and so forth.

    -

    10.1.4 Reusing typemaps

    -

    Typemaps are normally defined for specific type and argument name - patterns. However, typemaps can also be copied and reused. One way to - do this is to use assignment like this:

    -
    +

    Now, to illustrate the behavior in the scripting interpreter, + consider this Python example:

    +
    -%typemap(in) Integer = int;   
    -%typemap(in) (char *buffer, int size) = (char *str, int len);
    +>>> from example import *
    +>>> iv = IntVector(4)         # Create an vector<int>
    +>>> for i in range(0,4):
    +...      iv[i] = i
    +>>> average(iv)               # Call method
    +1.5
    +>>> average([0,1,2,3])        # Call with list
    +1.5
    +>>> half([1,2,3])             # Half a list
    +(0.5,1.0,1.5)
    +>>> halve_in_place([1,2,3])   # Oops
    +Traceback (most recent call last):
    +  File "<stdin>", line 1, in ?
    +TypeError: Type error. Expected _p_std__vectorTdouble_t
    +>>> dv = DoubleVector(4)
    +>>> for i in range(0,4):
    +...       dv[i] = i
    +>>> halve_in_place(dv)       # Ok
    +>>> for i in dv:
    +...       print i
    +...
    +0.0
    +0.5
    +1.0
    +1.5
    +>>> dv[20] = 4.5
    +Traceback (most recent call last):
    +  File "<stdin>", line 1, in ?
    +  File "example.py", line 81, in __setitem__
    +    def __setitem__(*args): return apply(examplec.DoubleVector___setitem__,args)
    +IndexError: vector index out of range
    +>>>
     
    -

    A more general form of copying is found in the %apply - directive like this:

    +

    This library module is fully aware of C++ namespaces. If you use + vectors with other names, make sure you include the appropriate +using or typedef directives. For example:

    -%typemap(in) int {
    -   /* Convert an integer argument */
    -   ...
    -}
    -%typemap(out) int {
    -   /* Return an integer value */
    -   ...
    +%include "std_vector.i"
    +
    +namespace std {
    +    %template(IntVector) vector<int>;
     }
     
    -/* Apply all of the integer typemaps to size_t */
    -%apply int { size_t };    
    +using namespace std;
    +typedef std::vector Vector;
    +
    +void foo(vector<int> *x, const Vector &x);
     
    -

    %apply merely takes all of the typemaps that are - defined for one type and applies them to other types. Note: you can - include a comma separated set of types in the { ... } part of -%apply.

    -

    It should be noted that it is not necessary to copy typemaps for - types that are related by typedef. For example, if you have - this,

    +

    Note: This module makes use of several advanced SWIG features + including templatized typemaps and template partial specialization. If + you are trying to wrap other C++ code with templates, you might look at + the code contained in std_vector.i. Alternatively, you can + show them the code if you want to make their head explode.

    +

    Note: This module is defined for all SWIG target languages. + However argument conversion details and the public API exposed to the + interpreter vary.

    +

    9.4.3 STL exceptions

    +

    Many of the STL wrapper functions add parameter checking and will + throw a language dependent error/exception should the values not be + valid. The classic example is array bounds checking. The library + wrappers are written to throw a C++ exception in the case of error. The + C++ exception in turn gets converted into an appropriate + error/exception for the target language. By and large this handling + should not need customising, however, customisation can easily be + achieved by supplying appropriate "throws" typemaps. For example:

    -typedef int size_t;
    +%module example
    +%include "std_vector.i"
    +%typemap(throws) std::out_of_range {
    +  // custom exception handler
    +}
    +%template(VectInt) std::vector<int>;
     
    -

    then SWIG already knows that the int typemaps apply. You - don't have to do anything.

    -

    10.1.5 What can be done with typemaps?

    -

    The primary use of typemaps is for defining wrapper generation - behavior at the level of individual C/C++ datatypes. There are - currently six general categories of problems that typemaps address:

    -

    Argument handling

    +

    The custom exception handler might, for example, log the exception + then convert it into a specific error/exception for the target + language.

    +

    When using the STL it is advisable to add in an exception handler to + catch all STL exceptions. The %exception directive can be used + by placing the following code before any other methods or libraries to + be wrapped:

    -int foo(int x, double y, char *s);
    +%include "exception.i"
    +
    +%exception {
    +  try {
    +    $action
    +  } catch (const std::exception& e) {
    +    SWIG_exception(SWIG_RuntimeError, e.what());
    +  }
    +}
     
    -
      -
    • Input argument conversion ("in" typemap).
    • -
    • Input argument type checking ("typecheck" typemap).
    • -
    • Output argument handling ("argout" typemap).
    • -
    • Input argument value checking ("check" typemap).
    • -
    • Input argument initialization ("arginit" typemap).
    • -
    • Default arguments ("default" typemap).
    • -
    • Input argument resource management ("freearg" typemap).
    • -
    -

    Return value handling

    +

    Any thrown STL exceptions will then be gracefully handled instead of + causing a crash.

    +

    9.4.4 shared_ptr smart pointer

    +

    Some target languages have support for handling the shared_ptr + reference counted smart pointer. This smart pointer is available in the + standard C++11 library as std::shared_ptr. It was also in TR1 + as std::tr1::shared_ptr before it was fully standardized. + Support for the widely used boost::shared_ptr is also + available.

    +

    In order to use std::shared_ptr, the std_shared_ptr.i + library file should be included:

    -int foo(int x, double y, char *s);
    +%include <std_shared_ptr.i>
     
    -
      -
    • Function return value conversion ("out" typemap).
    • -
    • Return value resource management ("ret" typemap).
    • -
    • Resource management for newly allocated objects ("newfree" typemap).
    • -
    -

    Exception handling

    +

    The pre-standard std::tr1::shared_ptr can be used by + including the following macro before including the std_shared_ptr.i + library file:

    -int foo(int x, double y, char *s) throw(MemoryError, IndexError);
    +#define SWIG_SHARED_PTR_SUBNAMESPACE tr1
    +%include <std_shared_ptr.i>
     
    -
      -
    • Handling of C++ exception specifications. ("throw" typemap).
    • -
    -

    Global variables

    +

    In order to use boost::shared_ptr, the +boost_shared_ptr.i library file should be included:

    -int foo;
    +%include <boost_shared_ptr.i>
     
    -
      -
    • Assignment of a global variable. ("varin" typemap).
    • -
    • Reading a global variable. ("varout" typemap).
    • -
    -

    Member variables

    +

    You can only use one of these variants of shared_ptr in your + interface file at a time. and all three variants must be used in + conjunction with the %shared_ptr(T) macro, where T is + the underlying pointer type equating to usage shared_ptr<T>. + The type T must be non-primitive. A simple example + demonstrates usage:

    -struct Foo {
    -    int x[20];
    +%module example
    +%include <boost_shared_ptr.i>
    +%shared_ptr(IntValue)
    +
    +%inline %{
    +#include <boost/shared_ptr.hpp>
    +
    +struct IntValue {
    +  int value;
    +  IntValue(int v) : value(v) {}
     };
    +
    +static int extractValue(const IntValue &t) {
    +  return t.value;
    +}
    +
    +static int extractValueSmart(boost::shared_ptr<IntValue> t) {
    +  return t->value;
    +}
    +%}
     
    -
      -
    • Assignment of data to a class/structure member. ("memberin" - typemap).
    • -
    -

    Constant creation

    -
    +

    Note that the %shared_ptr(IntValue) declaration occurs + after the inclusion of the boost_shared_ptr.i library which + provides the macro and, very importantly, before any usage or + declaration of the type, IntValue. The %shared_ptr + macro provides, a few things for handling this smart pointer, but + mostly a number of typemaps. These typemaps override the default + typemaps so that the underlying proxy class is stored and passed around + as a pointer to a shared_ptr instead of a plain pointer to the + underlying type. This approach means that any instantiation of the type + can be passed to methods taking the type by value, reference, pointer + or as a smart pointer. The interested reader might want to look at the + generated code, however, usage is simple and no different handling is + required from the target language. For example, a simple use case of + the above code from Java would be:

    +
    -#define FOO 3
    -%constant int BAR = 42;
    -enum { ALE, LAGER, STOUT };
    +IntValue iv = new IntValue(1234);
    +int val1 = example.extractValue(iv);
    +int val2 = example.extractValueSmart(iv);
    +System.out.println(val1 + " " + val2);
     
    -
      -
    • Creation of constant values. ("consttab" or "constcode" typemap).
    • -
    -

    Details of each of these typemaps will be covered shortly. Also, - certain language modules may define additional typemaps that expand - upon this list. For example, the Java module defines a variety of - typemaps for controlling additional aspects of the Java bindings. - Consult language specific documentation for further details.

    -

    10.1.6 What can't be done with typemaps?

    -

    Typemaps can't be used to define properties that apply to C/C++ - declarations as a whole. For example, suppose you had a declaration - like this,

    +

    This shared_ptr library works quite differently to SWIG's normal, + but somewhat limited, smart pointer + handling. The shared_ptr library does not generate extra wrappers, + just for smart pointer handling, in addition to the proxy class. The + normal proxy class including inheritance relationships is generated as + usual. The only real change introduced by the %shared_ptr + macro is that the proxy class stores a pointer to the shared_ptr + instance instead of a raw pointer to the instance. A proxy class + derived from a base which is being wrapped with shared_ptr can and + must be wrapped as a shared_ptr too. In other words all classes in + an inheritance hierarchy must all be used with the %shared_ptr + macro. For example the following code can be used with the base class + shown earlier:

    -Foo *make_Foo(int n);
    -
    -
    -

    and you wanted to tell SWIG that make_Foo(int n) returned a - newly allocated object (for the purposes of providing better memory - management). Clearly, this property of make_Foo(int n) is - not a property that would be associated with the datatype Foo - * by itself. Therefore, a completely different SWIG customization - mechanism (%feature) is used for this purpose. Consult the -Customization Features chapter for more information about that.

    -

    Typemaps also can't be used to rearrange or transform the order of - arguments. For example, if you had a function like this:

    -
    -
    -void foo(int, char *);
    +%shared_ptr(DerivedIntValue)
    +%inline %{
    +struct DerivedIntValue : IntValue {
    +  DerivedIntValue(int value) : IntValue(value) {}
    +  ...
    +};
    +%}
     
    -

    you can't use typemaps to interchange the arguments, allowing you to - call the function like this:

    +

    A shared_ptr of the derived class can now be passed to a method + where the base is expected in the target language, just as it can in + C++:

    -foo("hello",3)          # Reversed arguments
    +DerivedIntValue div = new DerivedIntValue(5678);
    +int val3 = example.extractValue(div);
    +int val4 = example.extractValueSmart(div);
     
    -

    If you want to change the calling conventions of a function, write a - helper function instead. For example:

    +

    If the %shared_ptr macro is omitted for any class in the + inheritance hierarchy, SWIG will warn about this and the generated code + may or may not result in a C++ compilation error. For example, the + following input:

    -%rename(foo) wrap_foo;
    +%include "boost_shared_ptr.i"
    +%shared_ptr(Parent);
    +
     %inline %{
    -void wrap_foo(char *s, int x) {
    -   foo(x,s);
    -}
    +  #include <boost/shared_ptr.hpp>
    +  struct GrandParent {
    +    virtual ~GrandParent() {}
    +  };
    +
    +  struct Parent : GrandParent {
    +    virtual ~Parent() {}
    +  };
    +
    +  struct Child : Parent {
    +    virtual ~Child() {}
    +  };
     %}
     
    -

    10.1.7 Similarities to Aspect - Oriented Programming

    -

    SWIG has parallels to -Aspect Oriented Software Development (AOP). The -AOP terminology with respect to SWIG typemaps can be viewed as - follows:

    -
      -
    • Cross-cutting concerns: The cross-cutting concerns are the - modularization of the functionality that the typemaps implement, which - is primarily marshalling of types from/to the target language and - C/C++.
    • -
    • Advice: The typemap body contains code which is executed - whenever the marshalling is required.
    • -
    • Pointcut: The pointcuts are the positions in the wrapper - code that the typemap code is generated into.
    • -
    • Aspect: Aspects are the combination of the pointcut and the - advice, hence each typemap is an aspect.
    • -
    -

    SWIG can also be viewed as has having a second set of aspects based - around %feature. Features such as -%exception are also cross-cutting concerns as they encapsulate code - that can be used to add logging or exception handling to any function.

    -

    10.1.8 The rest of this chapter

    -

    The rest of this chapter provides detailed information for people - who want to write new typemaps. This information is of particular - importance to anyone who intends to write a new SWIG target language - module. Power users can also use this information to write application - specific type conversion rules.

    -

    Since typemaps are strongly tied to the underlying C++ type system, - subsequent sections assume that you are reasonably familiar with the - basic details of values, pointers, references, arrays, type qualifiers - (e.g., const), structures, namespaces, templates, and memory - management in C/C++. If not, you would be well-advised to consult a - copy of "The C Programming Language" by Kernighan and Ritchie or "The - C++ Programming Language" by Stroustrup before going any further.

    -

    10.2 Typemap specifications

    -

    This section describes the behavior of the %typemap - directive itself.

    -

    10.2.1 Defining a typemap

    -

    New typemaps are defined using the %typemap declaration. - The general form of this declaration is as follows (parts enclosed in [ - ... ] are optional):

    +

    warns about the missing smart pointer information:

    +
    +
    +example.i:12: Warning 520: Base class 'GrandParent' of 'Parent' is not similarly marked as a smart pointer.
    +example.i:16: Warning 520: Derived class 'Child' of 'Parent' is not similarly marked as a smart pointer.
    +
    +
    +

    Adding the missing %shared_ptr macros will fix this:

    -%typemap(method [, modifiers]) typelist code ;
    +%include "boost_shared_ptr.i"
    +%shared_ptr(GrandParent);
    +%shared_ptr(Parent);
    +%shared_ptr(Child);
    +
    +... as before ...
     
    -

    method is a simply a name that specifies what kind of - typemap is being defined. It is usually a name like "in", -"out", or "argout". The purpose of these methods is - described later.

    -

    modifiers is an optional comma separated list of -name="value" values. These are sometimes to attach extra - information to a typemap and is often target-language dependent. They - are also known as typemap attributes.

    -

    typelist is a list of the C++ type patterns that the - typemap will match. The general form of this list is as follows:

    -
    +

    Note: There is somewhat limited support for %shared_ptr + and the director feature and the degress of success varies among the + different target languages. Please help to improve this support by + providing patches with improvements.

    +

    9.4.5 auto_ptr smart pointer

    +

    While std::auto_ptr is deprecated in C++11, some existing + code may still be using it, so SWIG provides limited support for this + class: std_auto_ptr.i defines the typemaps which apply to the + functions returning objects of this type. Any other use of +std_auto_ptr.i is not directly supported.

    +

    A typical example of use would be

    +
    -typelist    :  typepattern [, typepattern, typepattern, ... ] ;
    +%include <std_auto_ptr.i>
     
    -typepattern :  type [ (parms) ]
    -            |  type name [ (parms) ]
    -            |  ( typelist ) [ (parms) ]
    +%auto_ptr(Klass)
    +%inline %{
    +class Klass {
    +public:
    +  // Factory function creating objects of this class:
    +  static std::auto_ptr<Klass> Create(int value) {
    +    return std::auto_ptr<Klass>(new Klass(value));
    +  }
     
    +  int getValue() const { return m_value; }
    +
    +private:
    +  DerivedIntValue(int value) : m_value(value) {}
    +  int m_value;
    +};
    +%}
     
    -

    Each type pattern is either a simple type, a simple type and - argument name, or a list of types in the case of multi-argument - typemaps. In addition, each type pattern can be parameterized with a - list of temporary variables (parms). The purpose of these variables - will be explained shortly.

    -

    code specifies the code used in the typemap. Usually this is - C/C++ code, but in the statically typed target languages, such as Java - and C#, this can contain target language code for certain typemaps. It - can take any one of the following forms:

    -
    +

    The returned objects can be used naturally from the target language, + e.g. from C#:

    +
    -code       : { ... }
    -           | " ... "
    -           | %{ ... %}
    +Klass k = Klass.Create(17);
    +int value = k.getValue();
     
    -

    Note that the preprocessor will expand code within the {} - delimiters, but not in the last two styles of delimiters, see -Preprocessor and Typemaps. Here are some examples of valid typemap - specifications:

    +

    9.5 Utility Libraries

    +

    9.5.1 exception.i

    +

    The exception.i library provides a language-independent + function for raising a run-time exception in the target language. This + library is largely used by the SWIG library writers. If possible, use + the error handling scheme available to your target language as there is + greater flexibility in what errors/exceptions can be thrown.

    +

    SWIG_exception(int code, const char *message)

    +
    +

    Raises an exception in the target language. code is one of + the following symbolic constants:

    -/* Simple typemap declarations */
    -%typemap(in) int {
    -   $1 = PyInt_AsLong($input);
    -}
    -%typemap(in) int "$1 = PyInt_AsLong($input);";
    -%typemap(in) int %{ 
    -   $1 = PyInt_AsLong($input);
    -%}
    -
    -/* Typemap with extra argument name */
    -%typemap(in) int nonnegative {
    -   ...
    -}
    -
    -/* Multiple types in one typemap */
    -%typemap(in) int, short, long { 
    -   $1 = SvIV($input);
    +SWIG_MemoryError
    +SWIG_IOError
    +SWIG_RuntimeError
    +SWIG_IndexError
    +SWIG_TypeError
    +SWIG_DivisionByZero
    +SWIG_OverflowError
    +SWIG_SyntaxError
    +SWIG_ValueError
    +SWIG_SystemError
    +
    +
    +

    message is a string indicating more information about the + problem.

    +
    +

    The primary use of this module is in writing language-independent + exception handlers. For example:

    +
    +
    +%include "exception.i"
    +%exception std::vector::getitem {
    +    try {
    +        $action
    +    } catch (std::out_of_range& e) {
    +        SWIG_exception(SWIG_IndexError,const_cast<char*>(e.what()));
    +    }
     }
    +
    +

    +

    10 Argument Handling

    -/* Typemap with modifiers */ -%typemap(in,doc="integer") int "$1 = scm_to_int($input);"; - -/* Typemap applied to patterns of multiple arguments */ -%typemap(in) (char *str, int len), - (char *buffer, int size) -{ - $1 = PyString_AsString($input); - $2 = PyString_Size($input); + + + +

    In Chapter 3, SWIG's treatment of basic datatypes and pointers was + described. In particular, primitive types such as int and +double are mapped to corresponding types in the target language. + For everything else, pointers are used to refer to structures, classes, + arrays, and other user-defined datatypes. However, in certain + applications it is desirable to change SWIG's handling of a specific + datatype. For example, you might want to return multiple values through + the arguments of a function. This chapter describes some of the + techniques for doing this.

    +

    10.1 The typemaps.i library

    +

    This section describes the typemaps.i library + file--commonly used to change certain properties of argument + conversion.

    +

    10.1.1 Introduction

    +

    Suppose you had a C function like this:

    +
    +
    +void add(double a, double b, double *result) {
    +  *result = a + b;
     }
    +
    +
    +

    From reading the source code, it is clear that the function is + storing a value in the double *result parameter. However, + since SWIG does not examine function bodies, it has no way to know that + this is the underlying behavior.

    +

    One way to deal with this is to use the typemaps.i library + file and write interface code like this:

    +
    +
    +// Simple example using typemaps
    +%module example
    +%include "typemaps.i"
     
    -/* Typemap with extra pattern parameters */
    -%typemap(in, numinputs=0) int *output (int temp),
    -                          long *output (long temp)
    -{
    -   $1 = &temp;
    -}
    +%apply double *OUTPUT { double *result };
    +%inline %{
    +extern void add(double a, double b, double *result);
    +%}
     
    -

    Admittedly, it's not the most readable syntax at first glance. - However, the purpose of the individual pieces will become clear.

    -

    10.2.2 Typemap scope

    -

    Once defined, a typemap remains in effect for all of the - declarations that follow. A typemap may be redefined for different - sections of an input file. For example:

    +

    The %apply directive tells SWIG that you are going to apply + a special type handling rule to a type. The "double *OUTPUT" + specification is the name of a rule that defines how to return an + output value from an argument of type double *. This rule gets + applied to all of the datatypes listed in curly braces-- in this case " +double *result".

    +

    When the resulting module is created, you can now use the function + like this (shown for Python):

    +
    +
    +>>> a = add(3,4)
    +>>> print a
    +7
    +>>>
    +
    +
    +

    In this case, you can see how the output value normally returned in + the third argument has magically been transformed into a function + return value. Clearly this makes the function much easier to use since + it is no longer necessary to manufacture a special double * + object and pass it to the function somehow.

    +

    Once a typemap has been applied to a type, it stays in effect for + all future occurrences of the type and name. For example, you could + write the following:

    -// typemap1
    -%typemap(in) int {
    -...
    -}
    +%module example
    +%include "typemaps.i"
     
    -int fact(int);                    // typemap1
    -int gcd(int x, int y);            // typemap1
    +%apply double *OUTPUT { double *result };
     
    -// typemap2
    -%typemap(in) int {
    +%inline %{
    +extern void add(double a, double b, double *result);
    +extern void sub(double a, double b, double *result);
    +extern void mul(double a, double b, double *result);
    +extern void div(double a, double b, double *result);
    +%}
     ...
    -}
    -
    -int isprime(int);                 // typemap2
     
    -

    One exception to the typemap scoping rules pertains to the -%extend declaration. %extend is used to attach new - declarations to a class or structure definition. Because of this, all - of the declarations in an %extend block are subject to the - typemap rules that are in effect at the point where the class itself is - defined. For example:

    +

    In this case, the double *OUTPUT rule is applied to all of + the functions that follow.

    +

    Typemap transformations can even be extended to multiple return + values. For example, consider this code:

    -class Foo {
    -   ...
    -};
    -
    -%typemap(in) int {
    - ...
    -}
    +%include "typemaps.i"
    +%apply int *OUTPUT { int *width, int *height };
     
    -%extend Foo {
    -   int blah(int x);    // typemap has no effect.  Declaration is attached to Foo which 
    -                       // appears before the %typemap declaration.
    -};
    +// Returns a pair (width,height)
    +void getwinsize(int winid, int *width, int *height);
     
    -

    10.2.3 Copying a typemap

    -

    A typemap is copied by using assignment. For example:

    -
    +

    In this case, the function returns multiple values, allowing it to + be used like this:

    +
    -%typemap(in) Integer = int;
    +>>> w,h = genwinsize(wid)
    +>>> print w
    +400
    +>>> print h
    +300
    +>>>
     
    -

    or this:

    +

    It should also be noted that although the %apply directive + is used to associate typemap rules to datatypes, you can also use the + rule names directly in arguments. For example, you could write this:

    -%typemap(in) Integer, Number, int32_t = int;
    +// Simple example using typemaps
    +%module example
    +%include "typemaps.i"
    +
    +%{
    +extern void add(double a, double b, double *OUTPUT);
    +%}
    +extern void add(double a, double b, double *OUTPUT);
     
    -

    Types are often managed by a collection of different typemaps. For - example:

    +

    Typemaps stay in effect until they are explicitly deleted or + redefined to something else. To clear a typemap, the %clear + directive should be used. For example:

    -%typemap(in)     int { ... }
    -%typemap(out)    int { ... }
    -%typemap(varin)  int { ... }
    -%typemap(varout) int { ... }
    +%clear double *result;      // Remove all typemaps for double *result
     
    -

    To copy all of these typemaps to a new type, use %apply. - For example:

    +

    10.1.2 Input parameters

    +

    The following typemaps instruct SWIG that a pointer really only + holds a single input value:

    -%apply int { Integer };            // Copy all int typemaps to Integer
    -%apply int { Integer, Number };    // Copy all int typemaps to both Integer and Number
    +int *INPUT
    +short *INPUT
    +long *INPUT
    +unsigned int *INPUT
    +unsigned short *INPUT
    +unsigned long *INPUT
    +double *INPUT
    +float *INPUT
     
    -

    The patterns for %apply follow the same rules as for -%typemap. For example:

    +

    When used, it allows values to be passed instead of pointers. For + example, consider this function:

    -%apply int *output { Integer *output };                    // Typemap with name
    -%apply (char *buf, int len) { (char *buffer, int size) };  // Multiple arguments
    +double add(double *a, double *b) {
    +  return *a+*b;
    +}
     
    -

    10.2.4 Deleting a typemap

    -

    A typemap can be deleted by simply defining no code. For example:

    +

    Now, consider this SWIG interface:

    -%typemap(in) int;               // Clears typemap for int
    -%typemap(in) int, long, short;  // Clears typemap for int, long, short
    -%typemap(in) int *output;       
    +%module example
    +%include "typemaps.i"
    +...
    +%{
    +extern double add(double *, double *);
    +%}
    +extern double add(double *INPUT, double *INPUT);
    +
     
    -

    The %clear directive clears all typemaps for a given type. - For example:

    -
    +

    When the function is used in the scripting language interpreter, it + will work like this:

    +
    -%clear int;                     // Removes all types for int
    -%clear int *output, long *output;
    +result = add(3,4)
     
    -

    Note: Since SWIG's default behavior is defined by typemaps, - clearing a fundamental type like int will make that type - unusable unless you also define a new set of typemaps immediately after - the clear operation.

    -

    10.2.5 Placement of typemaps

    -

    Typemap declarations can be declared in the global scope, within a - C++ namespace, and within a C++ class. For example:

    +

    10.1.3 Output parameters

    +

    The following typemap rules tell SWIG that pointer is the output + value of a function. When used, you do not need to supply the argument + when calling the function. Instead, one or more output values are + returned.

    -%typemap(in) int {
    -   ...
    -}
    -
    -namespace std {
    -    class string;
    -    %typemap(in) string {
    -        ...
    -    }
    -}
    +int *OUTPUT
    +short *OUTPUT
    +long *OUTPUT
    +unsigned int *OUTPUT
    +unsigned short *OUTPUT
    +unsigned long *OUTPUT
    +double *OUTPUT
    +float *OUTPUT
     
    -class Bar {
    -public:
    -    typedef const int & const_reference;
    -    %typemap(out) const_reference {
    -         ...
    -    }
    -};
     
    -

    When a typemap appears inside a namespace or class, it stays in - effect until the end of the SWIG input (just like before). However, the - typemap takes the local scope into account. Therefore, this code

    +

    These methods can be used as shown in an earlier example. For + example, if you have this C function :

    -namespace std {
    -    class string;
    -    %typemap(in) string {
    -       ...
    -    }
    +void add(double a, double b, double *c) {
    +  *c = a+b;
     }
     
    -

    is really defining a typemap for the type std::string. You - could have code like this:

    +

    A SWIG interface file might look like this :

    -namespace std {
    -    class string;
    -    %typemap(in) string {          /* std::string */
    -       ...
    -    }
    -}
    +%module example
    +%include "typemaps.i"
    +...
    +%inline %{
    +extern void add(double a, double b, double *OUTPUT);
    +%}
     
    -namespace Foo {
    -    class string;
    -    %typemap(in) string {          /* Foo::string */
    -       ...
    -    }
    -}
     
    -

    In this case, there are two completely distinct typemaps that apply - to two completely different types (std::string and -Foo::string).

    -

    It should be noted that for scoping to work, SWIG has to know that -string is a typename defined within a particular namespace. In this - example, this is done using the forward class declaration class - string.

    -

    10.3 Pattern matching rules

    -

    The section describes the pattern matching rules by which C/C++ - datatypes are associated with typemaps. The matching rules can be - observed in practice by using the debugging options also described.

    -

    10.3.1 Basic matching rules

    -

    Typemaps are matched using both a type and a name (typically the - name of a argument). For a given TYPE NAME pair, the following - rules are applied, in order, to find a match. The first typemap found - is used.

    -
      -
    • Typemaps that exactly match TYPE and NAME.
    • -
    • Typemaps that exactly match TYPE only.
    • -
    • If TYPE is a C++ template of type T< TPARMS >, - where TPARMS are the template parameters, the type is stripped - of the template parameters and the following checks are then made: -
        -
      • Typemaps that exactly match T and NAME.
      • -
      • Typemaps that exactly match T only.
      • -
      -
    • -
    -

    If TYPE includes qualifiers (const, volatile, etc.), each - qualifier is stripped one at a time to form a new stripped type and the - matching rules above are repeated on the stripped type. The left-most - qualifier is stripped first, resulting in the right-most (or top-level) - qualifier being stripped last. For example int const*const is - first stripped to int *const then int *.

    -

    If TYPE is an array. The following transformation is made:

    -
      -
    • Replace all dimensions to [ANY] and look for a generic - array typemap.
    • -
    -

    To illustrate, suppose that you had a function like this:

    +

    In this case, only a single output value is returned, but this is + not a restriction. An arbitrary number of output values can be returned + by applying the output rules to more than one argument (as shown + previously).

    +

    If the function also returns a value, it is returned along with the + argument. For example, if you had this:

    -int foo(const char *s);
    +extern int foo(double a, double b, double *OUTPUT);
     
    -

    To find a typemap for the argument const char *s, SWIG will - search for the following typemaps:

    -
    +

    The function will return two values like this:

    +
    -const char *s           Exact type and name match
    -const char *            Exact type match
    -char *s                 Type and name match (qualifier stripped)
    -char *                  Type match (qualifier stripped)
    +iresult, dresult = foo(3.5, 2)
     
    -

    When more than one typemap rule might be defined, only the first - match found is actually used. Here is an example that shows how some of - the basic rules are applied:

    +

    10.1.4 Input/Output parameters

    +

    When a pointer serves as both an input and output value you can use + the following typemaps :

    -%typemap(in) int *x {
    -   ... typemap 1
    -}
    -
    -%typemap(in) int * {
    -   ... typemap 2
    -}
    -
    -%typemap(in) const int *z {
    -   ... typemap 3
    -}
    -
    -%typemap(in) int [4] {
    -   ... typemap 4
    -}
    -
    -%typemap(in) int [ANY] {
    -   ... typemap 5
    -}
    +int *INOUT
    +short *INOUT
    +long *INOUT
    +unsigned int *INOUT
    +unsigned short *INOUT
    +unsigned long *INOUT
    +double *INOUT
    +float *INOUT
     
    -void A(int *x);        // int *x rule       (typemap 1)
    -void B(int *y);        // int * rule        (typemap 2)
    -void C(const int *x);  // int *x rule       (typemap 1)
    -void D(const int *z);  // const int *z rule (typemap 3)
    -void E(int x[4]);      // int [4] rule      (typemap 4)
    -void F(int x[1000]);   // int [ANY] rule    (typemap 5)
     
    -

    Compatibility note: SWIG-2.0.0 introduced stripping the - qualifiers one step at a time. Prior versions stripped all qualifiers - in one step.

    -

    10.3.2 Typedef reductions - matching

    -

    If no match is found using the rules in the previous section, SWIG - applies a typedef reduction to the type and repeats the typemap search - for the reduced type. To illustrate, suppose you had code like this:

    +

    A C function that uses this might be something like this:

    -%typemap(in) int {
    -   ... typemap 1
    +void negate(double *x) {
    +  *x = -(*x);
     }
     
    -typedef int Integer;
    -void blah(Integer x);
     
    -

    To find the typemap for Integer x, SWIG will first search - for the following typemaps:

    -
    +

    To make x function as both and input and output value, declare the + function like this in an interface file :

    +
    -Integer x
    -Integer
    +%module example
    +%include "typemaps.i"
    +...
    +%{
    +extern void negate(double *);
    +%}
    +extern void negate(double *INOUT);
    +
     
    -

    Finding no match, it then applies a reduction Integer -> int - to the type and repeats the search.

    -
    +

    Now within a script, you can simply call the function normally :

    +
    -int x
    -int      --> match: typemap 1
    +a = negate(3);         # a = -3 after calling this
     
    -

    Even though two types might be the same via typedef, SWIG allows - typemaps to be defined for each typename independently. This allows for - interesting customization possibilities based solely on the typename - itself. For example, you could write code like this:

    +

    One subtle point of the INOUT rule is that many scripting + languages enforce mutability constraints on primitive objects (meaning + that simple objects like integers and strings aren't supposed to + change). Because of this, you can't just modify the object's value in + place as the underlying C function does in this example. Therefore, the + INOUT rule returns the modified value as a new object rather + than directly overwriting the value of the original input object.

    +

    Compatibility note : The INOUT rule used to be known + as BOTH in earlier versions of SWIG. Backwards compatibility + is preserved, but deprecated.

    +

    10.1.5 Using different names

    +

    As previously shown, the %apply directive can be used to + apply the INPUT, OUTPUT, and INOUT typemaps + to different argument names. For example:

    -typedef double  pdouble;     // Positive double
    +// Make double *result an output value
    +%apply double *OUTPUT { double *result };
    +
    +// Make Int32 *in an input value
    +%apply int *INPUT { Int32 *in };
    +
    +// Make long *x inout
    +%apply long *INOUT {long *x};
     
    -// typemap 1
    -%typemap(in) double {
    -   ... get a double ...
    -}
    -// typemap 2
    -%typemap(in) pdouble {
    -   ... get a positive double ...
    -}
    -double sin(double x);           // typemap 1
    -pdouble sqrt(pdouble x);        // typemap 2
     
    -

    When reducing the type, only one typedef reduction is applied at a - time. The search process continues to apply reductions until a match is - found or until no more reductions can be made.

    -

    For complicated types, the reduction process can generate a long - list of patterns. Consider the following:

    +

    To clear a rule, the %clear directive is used:

    -typedef int Integer;
    -typedef Integer Row4[4];
    -void foo(Row4 rows[10]);
    +%clear double *result;
    +%clear Int32 *in, long *x;
     
    -

    To find a match for the Row4 rows[10] argument, SWIG would - check the following patterns, stopping only when it found a match:

    +

    Typemap declarations are lexically scoped so a typemap takes effect + from the point of definition to the end of the file or a matching +%clear declaration.

    +

    10.2 Applying constraints to input values +

    +

    In addition to changing the handling of various input values, it is + also possible to use typemaps to apply constraints. For example, maybe + you want to insure that a value is positive, or that a pointer is + non-NULL. This can be accomplished including the constraints.i + library file.

    +

    10.2.1 Simple constraint example

    +

    The constraints library is best illustrated by the following + interface file :

    -Row4 rows[10]
    -Row4 [10]
    -Row4 rows[ANY]
    -Row4 [ANY]
    +// Interface file with constraints
    +%module example
    +%include "constraints.i"
     
    -# Reduce Row4 --> Integer[4]
    -Integer rows[10][4]
    -Integer [10][4]
    -Integer rows[ANY][ANY]
    -Integer [ANY][ANY]
    +double exp(double x);
    +double log(double POSITIVE);         // Allow only positive values
    +double sqrt(double NONNEGATIVE);     // Non-negative values only
    +double inv(double NONZERO);          // Non-zero values
    +void   free(void *NONNULL);          // Non-NULL pointers only
     
    -# Reduce Integer --> int
    -int rows[10][4]
    -int [10][4]
    -int rows[ANY][ANY]
    -int [ANY][ANY]
     
    -

    For parameterized types like templates, the situation is even more - complicated. Suppose you had some declarations like this:

    +

    The behavior of this file is exactly as you would expect. If any of + the arguments violate the constraint condition, a scripting language + exception will be raised. As a result, it is possible to catch bad + values, prevent mysterious program crashes and so on.

    +

    10.2.2 Constraint methods

    +

    The following constraints are currently available

    -typedef int Integer;
    -typedef foo<Integer,Integer> fooii;
    -void blah(fooii *x);
    +POSITIVE                     Any number > 0 (not zero)
    +NEGATIVE                     Any number < 0 (not zero)
    +NONNEGATIVE                  Any number >= 0
    +NONPOSITIVE                  Any number <= 0
    +NONZERO                      Nonzero number
    +NONNULL                      Non-NULL pointer (pointers only).
    +
     
    -

    In this case, the following typemap patterns are searched for the - argument fooii *x:

    +

    10.2.3 Applying constraints to new + datatypes

    +

    The constraints library only supports the primitive C datatypes, but + it is easy to apply it to new datatypes using %apply. For + example :

    -fooii *x
    -fooii *
    -
    -# Reduce fooii --> foo<Integer,Integer>
    -foo<Integer,Integer> *x
    -foo<Integer,Integer> *
    +// Apply a constraint to a Real variable
    +%apply Number POSITIVE { Real in };
     
    -# Reduce Integer -> int
    -foo<int, Integer> *x
    -foo<int, Integer> *
    +// Apply a constraint to a pointer type
    +%apply Pointer NONNULL { Vector * };
     
    -# Reduce Integer -> int
    -foo<int, int> *x
    -foo<int, int> *
     
    -

    Typemap reductions are always applied to the left-most type that - appears. Only when no reductions can be made to the left-most type are - reductions made to other parts of the type. This behavior means that - you could define a typemap for foo<int,Integer>, but a typemap - for foo<Integer,int> would never be matched. Admittedly, this - is rather esoteric--there's little practical reason to write a typemap - quite like that. Of course, you could rely on this to confuse your - coworkers even more.

    -

    As a point of clarification, it is worth emphasizing that typedef - matching is a typedef reduction process only, that is, SWIG does - not search for every single possible typedef. Given a type in a - declaration, it will only reduce the type, it won't build it up looking - for typedefs. For example, given the type Struct, the typemap - below will not be used for the aStruct parameter, because -Struct is fully reduced:

    +

    The special types of "Number" and "Pointer" can be applied to any + numeric and pointer variable type respectively. To later remove a + constraint, the %clear directive can be used :

    -struct Struct {...};
    -typedef Struct StructTypedef;
    -
    -%typemap(in) StructTypedef { 
    -  ...
    -}
    -
    -void go(Struct aStruct);
    +%clear Real in;
    +%clear Vector *;
     
    +

    +

    11 Typemaps

    + + +
    +
    -

    10.3.3 Default typemap matching rules

    -

    If the basic pattern matching rules result in no match being made, - even after typedef reductions, the default typemap matching rules are - used to look for a suitable typemap match. These rules match a generic - typemap based on the reserved SWIGTYPE base type. For example - pointers will use SWIGTYPE * and references will use -SWIGTYPE &. More precisely, the rules are based on the C++ class - template partial specialization matching rules used by C++ compilers - when looking for an appropriate partial template specialization. This - means that a match is chosen from the most specialized set of generic - typemap types available. For example, when looking for a match to -int const *, the rules will prefer to match SWIGTYPE const * - if available before matching SWIGTYPE *, before matching -SWIGTYPE.

    -

    Most SWIG language modules use typemaps to define the default - behavior of the C primitive types. This is entirely straightforward. - For example, a set of typemaps for primitives marshalled by value or - const reference are written like this:

    + +

    11.1 Introduction

    +

    Chances are, you are reading this chapter for one of two reasons; + you either want to customize SWIG's behavior or you overheard someone + mumbling some incomprehensible drivel about "typemaps" and you asked + yourself "typemaps, what are those?" That said, let's start with a + short disclaimer that "typemaps" are an advanced customization feature + that provide direct access to SWIG's low-level code generator. Not only + that, they are an integral part of the SWIG C++ type system (a + non-trivial topic of its own). Typemaps are generally not a + required part of using SWIG. Therefore, you might want to re-read the + earlier chapters if you have found your way to this chapter with only a + vague idea of what SWIG already does by default.

    +

    11.1.1 Type conversion

    +

    One of the most important problems in wrapper code generation is the + conversion or marshalling of datatypes between programming languages. + Specifically, for every C/C++ declaration, SWIG must somehow generate + wrapper code that allows values to be passed back and forth between + languages. Since every programming language represents data + differently, this is not a simple of matter of simply linking code + together with the C linker. Instead, SWIG has to know something about + how data is represented in each language and how it can be manipulated.

    +

    To illustrate, suppose you had a simple C function like this:

    -%typemap(in) int           "... convert to int ...";
    -%typemap(in) short         "... convert to short ...";
    -%typemap(in) float         "... convert to float ...";
    -...
    -%typemap(in) const int &   "... convert ...";
    -%typemap(in) const short & "... convert ...";
    -%typemap(in) const float & "... convert ...";
    -...
    +int factorial(int n);
     
    -

    Since typemap matching follows all typedef declarations, - any sort of type that is mapped to a primitive type by value or const - reference through typedef will be picked up by one of these - primitive typemaps. Most language modules also define typemaps for char - pointers and char arrays to handle strings, so these non-default types - will also be used in preference as the basic typemap matching rules - provide a better match than the default typemap matching rules.

    -

    Below is a list of the typical default types supplied by language - modules, showing what the "in" typemap would look like:

    +

    To access this function from Python, a pair of Python API functions + are used to convert integer values. For example:

    -%typemap(in) SWIGTYPE &            { ... default reference handling ...                       };
    -%typemap(in) SWIGTYPE *            { ... default pointer handling ...                         };
    -%typemap(in) SWIGTYPE *const       { ... default pointer const handling ...                   };
    -%typemap(in) SWIGTYPE *const&      { ... default pointer const reference handling ...         };
    -%typemap(in) SWIGTYPE[ANY]         { ... 1D fixed size arrays handlling ...                   };
    -%typemap(in) SWIGTYPE []           { ... unknown sized array handling ...                     };
    -%typemap(in) enum SWIGTYPE         { ... default handling for enum values ...                 };
    -%typemap(in) const enum SWIGTYPE & { ... default handling for const enum reference values ... };
    -%typemap(in) SWIGTYPE (CLASS::*)   { ... default pointer member handling ...                  };
    -%typemap(in) SWIGTYPE              { ... simple default handling ...                          };
    +long PyInt_AsLong(PyObject *obj);      /* Python --> C */
    +PyObject *PyInt_FromLong(long x);      /* C --> Python */
     
    -

    If you wanted to change SWIG's default handling for simple pointers, - you would simply redefine the rule for SWIGTYPE *. Note, the - simple default typemap rule is used to match against simple types that - don't match any other rules:

    +

    The first function is used to convert the input argument from a + Python integer object to C long. The second function is used + to convert a value from C back into a Python integer object.

    +

    Inside the wrapper function, you might see these functions used like + this:

    -%typemap(in) SWIGTYPE              { ... simple default handling ...                          } 
    +PyObject *wrap_factorial(PyObject *self, PyObject *args) {
    +    int       arg1;
    +    int       result;
    +    PyObject *obj1;
    +    PyObject *resultobj;
    +
    +    if (!PyArg_ParseTuple("O:factorial", &obj1)) return NULL;
    +    arg1 = PyInt_AsLong(obj1);
    +    result = factorial(arg1);
    +    resultobj = PyInt_FromLong(result);
    +    return resultobj;
    +}
     
    -

    This typemap is important because it is the rule that gets triggered - when call or return by value is used. For instance, if you have a - declaration like this:

    +

    Every target language supported by SWIG has functions that work in a + similar manner. For example, in Perl, the following functions are used:

    -double dot_product(Vector a, Vector b);
    +IV SvIV(SV *sv);                     /* Perl --> C */
    +void sv_setiv(SV *sv, IV val);       /* C --> Perl */
     
    -

    The Vector type will usually just get matched against -SWIGTYPE. The default implementation of SWIGTYPE is to - convert the value into pointers (as described in - this earlier section).

    -

    By redefining SWIGTYPE it may be possible to implement - other behavior. For example, if you cleared all typemaps for -SWIGTYPE, SWIG simply won't wrap any unknown datatype (which might - be useful for debugging). Alternatively, you might modify SWIGTYPE to - marshal objects into strings instead of converting them to pointers.

    -

    Let's consider an example where the following typemaps are defined - and SWIG is looking for the best match for the enum shown below:

    +

    In Tcl:

    -%typemap(in) const Hello &          { ... }
    -%typemap(in) const enum SWIGTYPE &  { ... }
    -%typemap(in) enum SWIGTYPE &        { ... }
    -%typemap(in) SWIGTYPE &             { ... }
    -%typemap(in) SWIGTYPE               { ... }
    -
    -enum Hello {};
    -const Hello &hi;
    +int Tcl_GetLongFromObj(Tcl_Interp *interp, Tcl_Obj *obj, long *value);
    +Tcl_Obj *Tcl_NewIntObj(long value);
     
    -

    The typemap at the top of the list will be chosen, not because it is - defined first, but because it is the closest match for the type being - wrapped. If any of the typemaps in the above list were not defined, - then the next one on the list would have precedence.

    -

    The best way to explore the default typemaps is to look at the ones - already defined for a particular language module. Typemap definitions - are usually found in the SWIG library in a file such as java.swg -, csharp.swg etc. However, for many of the target languages the - typemaps are hidden behind complicated macros, so the best way to view - the default typemaps, or any typemaps for that matter, is to look at - the preprocessed output by running swig -E on any interface - file. Finally the best way to view the typemap matching rules in action - is via the debugging typemap - pattern matching options covered later on.

    -

    Compatibility note: The default typemap matching rules were - modified in SWIG-2.0.0 from a slightly simpler scheme to match the - current C++ class template partial specialization matching rules.

    -

    10.3.4 - Multi-arguments typemaps

    -

    When multi-argument typemaps are specified, they take precedence - over any typemaps specified for a single type. For example:

    +

    The precise details are not so important. What is important is that + all of the underlying type conversion is handled by collections of + utility functions and short bits of C code like this---you simply have + to read the extension documentation for your favorite language to know + how it works (an exercise left to the reader).

    +

    11.1.2 Typemaps

    +

    Since type handling is so central to wrapper code generation, SWIG + allows it to be completely defined (or redefined) by the user. To do + this, a special %typemap directive is used. For example:

    -%typemap(in) (char *buffer, int len) {
    -   // typemap 1
    +/* Convert from Python --> C */
    +%typemap(in) int {
    +    $1 = PyInt_AsLong($input);
     }
     
    -%typemap(in) char *buffer {
    -   // typemap 2
    +/* Convert from C --> Python */
    +%typemap(out) int {
    +    $result = PyInt_FromLong($1);
     }
    -
    -void foo(char *buffer, int len, int count); // (char *buffer, int len)
    -void bar(char *buffer, int blah);           // char *buffer
     
    -

    Multi-argument typemaps are also more restrictive in the way that - they are matched. Currently, the first argument follows the matching - rules described in the previous section, but all subsequent arguments - must match exactly.

    -

    10.3.5 Matching - rules compared to C++ templates

    -

    For those intimately familiar with C++ templates, a comparison of - the typemap matching rules and template type deduction is interesting. - The two areas considered are firstly the default typemaps and their - similarities to partial template specialization and secondly, - non-default typemaps and their similarities to full template - specialization.

    -

    For default (SWIGTYPE) typemaps the rules are inspired by C++ class - template partial specialization. For example, given partial - specialization for T const& :

    +

    At first glance, this code will look a little confusing. However, + there is really not much to it. The first typemap (the "in" typemap) is + used to convert a value from the target language to C. The second + typemap (the "out" typemap) is used to convert in the other direction. + The content of each typemap is a small fragment of code that is + inserted directly into the SWIG generated wrapper functions. The code + is usually C or C++ code which will be generated into the C/C++ wrapper + functions. Note that this isn't always the case as some target language + modules allow target language code within the typemaps which gets + generated into target language specific files. Within this code, a + number of special variables prefixed with a $ are expanded. These are + really just placeholders for C/C++ variables that are generated in the + course of creating the wrapper function. In this case, $input + refers to an input object that needs to be converted to C/C++ and +$result refers to an object that is going to be returned by a + wrapper function. $1 refers to a C/C++ variable that has the + same type as specified in the typemap declaration (an int in + this example).

    +

    A short example might make this a little more clear. If you were + wrapping a function like this:

    -template <typename T> struct X             { void a(); };
    -template <typename T> struct X< T const& > { void b(); };
    +int gcd(int x, int y);
     
    -

    The full (unspecialized) template is matched with most types, such - as:

    +

    A wrapper function would look approximately like this:

    -X< int & >            x1;  x1.a();
    +PyObject *wrap_gcd(PyObject *self, PyObject *args) {
    +   int arg1;
    +   int arg2;
    +   int result;
    +   PyObject *obj1;
    +   PyObject *obj2;
    +   PyObject *resultobj;
    +
    +   if (!PyArg_ParseTuple("OO:gcd", &obj1, &obj2)) return NULL;
    +
    +   /* "in" typemap, argument 1 */   
    +   {
    +      arg1 = PyInt_AsLong(obj1);
    +   }
    +
    +   /* "in" typemap, argument 2 */
    +   {
    +      arg2 = PyInt_AsLong(obj2);
    +   }
    +
    +   result = gcd(arg1,arg2);
    +
    +   /* "out" typemap, return value */
    +   {
    +      resultobj = PyInt_FromLong(result);
    +   }
    +
    +   return resultobj;
    +}
     
    -

    and the following all match the T const& partial - specialization:

    +

    In this code, you can see how the typemap code has been inserted + into the function. You can also see how the special $ variables have + been expanded to match certain variable names inside the wrapper + function. This is really the whole idea behind typemaps--they simply + let you insert arbitrary code into different parts of the generated + wrapper functions. Because arbitrary code can be inserted, it possible + to completely change the way in which values are converted.

    +

    11.1.3 Pattern matching

    +

    As the name implies, the purpose of a typemap is to "map" C + datatypes to types in the target language. Once a typemap is defined + for a C datatype, it is applied to all future occurrences of that type + in the input file. For example:

    -X< int *const& >      x2;  x2.b();
    -X< int const*const& > x3;  x3.b();
    -X< int const& >       x4;  x4.b();
    +/* Convert from Perl --> C */
    +%typemap(in) int {
    +   $1 = SvIV($input);
    +}
    +
    +...
    +int factorial(int n);
    +int gcd(int x, int y);
    +int count(char *s, char *t, int max);
     
    -

    Now, given just these two default typemaps, where T is analogous to - SWIGTYPE:

    +

    The matching of typemaps to C datatypes is more than a simple + textual match. In fact, typemaps are fully built into the underlying + type system. Therefore, typemaps are unaffected by typedef, + namespaces, and other declarations that might hide the underlying type. + For example, you could have code like this:

    -%typemap(...) SWIGTYPE        { ... }
    -%typemap(...) SWIGTYPE const& { ... }
    +/* Convert from Ruby--> C */
    +%typemap(in) int {
    +   $1 = NUM2INT($input);
    +}
    +...
    +typedef int Integer;
    +namespace foo {
    +    typedef Integer Number;
    +};
    +
    +int foo(int x);
    +int bar(Integer y);
    +int spam(foo::Number a, foo::Number b);
     
    -

    The generic default typemap SWIGTYPE is used with most - types, such as

    +

    In this case, the typemap is still applied to the proper arguments + even though typenames don't always match the text "int". This ability + to track types is a critical part of SWIG--in fact, all of the target + language modules work merely define a set of typemaps for the basic + types. Yet, it is never necessary to write new typemaps for typenames + introduced by typedef.

    +

    In addition to tracking typenames, typemaps may also be specialized + to match against a specific argument name. For example, you could write + a typemap like this:

    -int &
    +%typemap(in) double nonnegative {
    +   $1 = PyFloat_AsDouble($input);
    +   if ($1 < 0) {
    +        PyErr_SetString(PyExc_ValueError,"argument must be nonnegative.");
    +        return NULL;
    +   }
    +}
    +
    +...
    +double sin(double x);
    +double cos(double x);
    +double sqrt(double nonnegative);
    +
    +typedef double Real;
    +double log(Real nonnegative);
    +...
     
    -

    and the following all match the SWIGTYPE const& typemap, - just like the partial template matching:

    +

    For certain tasks such as input argument conversion, typemaps can be + defined for sequences of consecutive arguments. For example:

    -int *const&
    -int const*const&
    -int const&
    +%typemap(in) (char *str, int len) {
    +    $1 = PyString_AsString($input);   /* char *str */
    +    $2 = PyString_Size($input);       /* int len   */
    +}
    +...
    +int count(char *str, int len, char c);
     
    -

    Note that the template and typemap matching rules are not identical - for all default typemaps though, for example, with arrays.

    -

    For non-default typemaps, one might expect SWIG to follow the fully - specialized template rules. This is nearly the case, but not quite. - Consider a very similar example to the earlier partially specialized - template but this time there is a fully specialized template:

    +

    In this case, a single input object is expanded into a pair of C + arguments. This example also provides a hint to the unusual variable + naming scheme involving $1, $2, and so forth.

    +

    11.1.4 Reusing typemaps

    +

    Typemaps are normally defined for specific type and argument name + patterns. However, typemaps can also be copied and reused. One way to + do this is to use assignment like this:

    -template <typename T> struct Y       { void a(); };
    -template <> struct Y< int const & >  { void b(); };
    +%typemap(in) Integer = int;   
    +%typemap(in) (char *buffer, int size) = (char *str, int len);
     
    -

    Only the one type matches the specialized template exactly:

    +

    A more general form of copying is found in the %apply + directive like this:

    -Y< int & >             y1;  y1.a();
    -Y< int *const& >       y2;  y2.a();
    -Y< int const *const& > y3;  y3.a();
    -Y< int const& >        y4;  y4.b(); // fully specialized match
    +%typemap(in) int {
    +   /* Convert an integer argument */
    +   ...
    +}
    +%typemap(out) int {
    +   /* Return an integer value */
    +   ...
    +}
    +
    +/* Apply all of the integer typemaps to size_t */
    +%apply int { size_t };    
     
    -

    Given typemaps with the same types used for the template declared - above, where T is again analogous to SWIGTYPE:

    +

    %apply merely takes all of the typemaps that are + defined for one type and applies them to other types. Note: you can + include a comma separated set of types in the { ... } part of +%apply.

    +

    It should be noted that it is not necessary to copy typemaps for + types that are related by typedef. For example, if you have + this,

    -%typemap(...) SWIGTYPE        { ... }
    -%typemap(...) int const&      { ... }
    +typedef int size_t;
     
    -

    The comparison between non-default typemaps and fully specialized - single parameter templates turns out to be the same, as just the one - type will match the non-default typemap:

    +

    then SWIG already knows that the int typemaps apply. You + don't have to do anything.

    +

    11.1.5 What can be done with typemaps?

    +

    The primary use of typemaps is for defining wrapper generation + behavior at the level of individual C/C++ datatypes. There are + currently six general categories of problems that typemaps address:

    +

    Argument handling

    -int &
    -int *const&
    -int const*const&
    -int const&        // matches non-default typemap int const&
    +int foo(int x, double y, char *s);
     
    -

    However, if a non-const type is used instead:

    +
      +
    • Input argument conversion ("in" typemap).
    • +
    • Input argument type checking ("typecheck" typemap).
    • +
    • Output argument handling ("argout" typemap).
    • +
    • Input argument value checking ("check" typemap).
    • +
    • Input argument initialization ("arginit" typemap).
    • +
    • Default arguments ("default" typemap).
    • +
    • Input argument resource management ("freearg" typemap).
    • +
    +

    Return value handling

    -%typemap(...) SWIGTYPE        { ... }
    -%typemap(...) int &           { ... }
    +int foo(int x, double y, char *s);
     
    -

    then there is a clear difference to template matching as both the - const and non-const types match the typemap:

    +
      +
    • Function return value conversion ("out" typemap).
    • +
    • Return value resource management ("ret" typemap).
    • +
    • Resource management for newly allocated objects ("newfree" typemap).
    • +
    +

    Exception handling

    -int &             // matches non-default typemap int &
    -int *const&
    -int const*const&
    -int const&        // matches non-default typemap int &
    +int foo(int x, double y, char *s) throw(MemoryError, IndexError);
     
    -

    There are other subtle differences such as typedef handling, but at - least it should be clear that the typemap matching rules are similar to - those for specialized template handling.

    -

    10.3.6 Debugging typemap - pattern matching

    -

    There are two useful debug command line options available for - debugging typemaps, -debug-tmsearch and -debug-tmused -.

    -

    The -debug-tmsearch option is a verbose option for - debugging typemap searches. This can be very useful for watching the - pattern matching process in action and for debugging which typemaps are - used. The option displays all the typemaps and types that are looked - for until a successful pattern match is made. As the display includes - searches for each and every type needed for wrapping, the amount of - information displayed can be large. Normally you would manually search - through the displayed information for the particular type that you are - interested in.

    -

    For example, consider some of the code used in the -Typedef reductions section already covered:

    +
      +
    • Handling of C++ exception specifications. ("throw" typemap).
    • +
    +

    Global variables

    -typedef int Integer;
    -typedef Integer Row4[4];
    -void foo(Row4 rows[10]);
    +int foo;
     
    -

    A sample of the debugging output is shown below for the "in" - typemap:

    -
    +
      +
    • Assignment of a global variable. ("varin" typemap).
    • +
    • Reading a global variable. ("varout" typemap).
    • +
    +

    Member variables

    +
    -swig -perl -debug-tmsearch example.i
    -...
    -example.h:3: Searching for a suitable 'in' typemap for: Row4 rows[10]
    -  Looking for: Row4 rows[10]
    -  Looking for: Row4 [10]
    -  Looking for: Row4 rows[ANY]
    -  Looking for: Row4 [ANY]
    -  Looking for: Integer rows[10][4]
    -  Looking for: Integer [10][4]
    -  Looking for: Integer rows[ANY][ANY]
    -  Looking for: Integer [ANY][ANY]
    -  Looking for: int rows[10][4]
    -  Looking for: int [10][4]
    -  Looking for: int rows[ANY][ANY]
    -  Looking for: int [ANY][ANY]
    -  Looking for: SWIGTYPE rows[ANY][ANY]
    -  Looking for: SWIGTYPE [ANY][ANY]
    -  Looking for: SWIGTYPE rows[ANY][]
    -  Looking for: SWIGTYPE [ANY][]
    -  Looking for: SWIGTYPE *rows[ANY]
    -  Looking for: SWIGTYPE *[ANY]
    -  Looking for: SWIGTYPE rows[ANY]
    -  Looking for: SWIGTYPE [ANY]
    -  Looking for: SWIGTYPE rows[]
    -  Looking for: SWIGTYPE []
    -  Using: %typemap(in) SWIGTYPE []
    -...
    +struct Foo {
    +    int x[20];
    +};
     
    -

    showing that the best default match supplied by SWIG is the -SWIGTYPE [] typemap. As the example shows, the successful match - displays the used typemap source including typemap method, type and - optional name in one of these simplified formats:

      -
    • Using: %typemap(method) type name
    • -
    • Using: %typemap(method) type name = type2 name2
    • -
    • Using: %apply type2 name2 { type name }
    • +
    • Assignment of data to a class/structure member. ("memberin" + typemap).
    -

    This information might meet your debugging needs, however, you might - want to analyze further. If you next invoke SWIG with the -E - option to display the preprocessed output, and search for the - particular typemap used, you'll find the full typemap contents (example - shown below for Python):

    +

    Constant creation

    -%typemap(in, noblock=1) SWIGTYPE [] (void *argp = 0, int res = 0) {
    -  res = SWIG_ConvertPtr($input, &argp,$descriptor, $disown |  0 );
    -  if (!SWIG_IsOK(res)) { 
    -    SWIG_exception_fail(SWIG_ArgError(res), "in method '" "$symname" "', argument "
    -                       "$argnum"" of type '" "$type""'"); 
    -  } 
    -  $1 = ($ltype)(argp);
    -}
    +#define FOO 3
    +%constant int BAR = 42;
    +enum { ALE, LAGER, STOUT };
     
    -

    The generated code for the foo wrapper will then contain - the snippets of the typemap with the special variables expanded. The - rest of this chapter will need reading though to fully understand all - of this, however, the relevant parts of the generated code for the - above typemap can be seen below:

    +
      +
    • Creation of constant values. ("consttab" or "constcode" typemap).
    • +
    +

    Details of each of these typemaps will be covered shortly. Also, + certain language modules may define additional typemaps that expand + upon this list. For example, the Java module defines a variety of + typemaps for controlling additional aspects of the Java bindings. + Consult language specific documentation for further details.

    +

    11.1.6 What can't be done with typemaps?

    +

    Typemaps can't be used to define properties that apply to C/C++ + declarations as a whole. For example, suppose you had a declaration + like this,

    -SWIGINTERN PyObject *_wrap_foo(PyObject *SWIGUNUSEDPARM(self), PyObject *args) {
    -...
    -  void *argp1 = 0 ;
    -  int res1 = 0 ;
    -...
    -  res1 = SWIG_ConvertPtr(obj0, &argp1,SWIGTYPE_p_a_4__int, 0 |  0 );
    -  if (!SWIG_IsOK(res1)) {
    -    SWIG_exception_fail(SWIG_ArgError(res1), "in method '" "foo" "', argument "
    -                       "1"" of type '" "int [10][4]""'"); 
    -  } 
    -  arg1 = (int (*)[4])(argp1);
    -...
    -}
    +Foo *make_Foo(int n);
     
    -

    Searches for multi-argument typemaps are not mentioned unless a - matching multi-argument typemap does actually exist. For example, the - output for the code in the -earlier multi-arguments section is as follows:

    -
    +

    and you wanted to tell SWIG that make_Foo(int n) returned a + newly allocated object (for the purposes of providing better memory + management). Clearly, this property of make_Foo(int n) is + not a property that would be associated with the datatype Foo + * by itself. Therefore, a completely different SWIG customization + mechanism (%feature) is used for this purpose. Consult the +Customization Features chapter for more information about that.

    +

    Typemaps also can't be used to rearrange or transform the order of + arguments. For example, if you had a function like this:

    +
    -...
    -example.h:39: Searching for a suitable 'in' typemap for: char *buffer
    -  Looking for: char *buffer
    -  Multi-argument typemap found...
    -  Using: %typemap(in) (char *buffer,int len)
    -...
    +void foo(int, char *);
     
    -

    The second option for debugging is -debug-tmused and this - displays the typemaps used. This option is a less verbose version of - the -debug-tmsearch option as it only displays each - successfully found typemap on a separate single line. The output - displays the type, and name if present, the typemap method in brackets - and then the actual typemap used in the same simplified format output - by the -debug-tmsearch option. Below is the output for the - example code at the start of this section on debugging.

    -
    +

    you can't use typemaps to interchange the arguments, allowing you to + call the function like this:

    +
    -$ swig -perl -debug-tmused example.i
    -example.h:3: Typemap for Row4 rows[10] (in) : %typemap(in) SWIGTYPE []
    -example.h:3: Typemap for Row4 rows[10] (typecheck) : %typemap(typecheck) SWIGTYPE *
    -example.h:3: Typemap for Row4 rows[10] (freearg) : %typemap(freearg) SWIGTYPE []
    -example.h:3: Typemap for void foo (out) : %typemap(out) void
    +foo("hello",3)          # Reversed arguments
     
    -

    Now, consider the following interface file:

    +

    If you want to change the calling conventions of a function, write a + helper function instead. For example:

    -%module example
    -
    -%{
    -void set_value(const char* val) {}
    -%}
    -
    -%typemap(check) char *NON_NULL {
    -  if (!$1) {
    -    /* ... error handling ... */
    -  }
    -}
    -
    -// use default pointer handling instead of strings
    -%apply SWIGTYPE * { const char* val, const char* another_value }
    -
    -%typemap(check) const char* val = char* NON_NULL;
    -
    -%typemap(arginit, noblock=1) const char* val {
    -   $1 = "";
    +%rename(foo) wrap_foo;
    +%inline %{
    +void wrap_foo(char *s, int x) {
    +   foo(x,s);
     }
    -
    -void set_value(const char* val);
    -
    -
    -
    -

    and the output debug:

    -
    -
    -swig -perl5 -debug-tmused example.i
    -example.i:21: Typemap for char const *val (arginit) : %typemap(arginit) char const *val
    -example.i:21: Typemap for char const *val (in) : %apply SWIGTYPE * { char const *val }
    -example.i:21: Typemap for char const *val (typecheck) : %apply SWIGTYPE * { char const *val }
    -example.i:21: Typemap for char const *val (check) : %typemap(check) char const *val = char *NON_NULL
    -example.i:21: Typemap for char const *val (freearg) : %apply SWIGTYPE * { char const *val }
    -example.i:21: Typemap for void set_value (out) : %typemap(out) void
    +%}
     
    -

    The following observations about what is displayed can be noted (the - same applies for -debug-tmsearch):

    +

    11.1.7 Similarities to Aspect Oriented + Programming

    +

    SWIG has parallels to +Aspect Oriented Software Development (AOP). The +AOP terminology with respect to SWIG typemaps can be viewed as + follows:

      -
    • The relevant typemap is shown, but for typemap copying, the - appropriate %typemap or %apply is displayed, for - example, the "check" and "in" typemaps.
    • -
    • The typemap modifiers are not shown, eg the noblock=1 - modifier in the "arginit" typemap.
    • -
    • The exact %apply statement might look different to what is - in the actual code. For example, the const char* another_value - is not shown as it is not relevant here. Also the types may be - displayed slightly differently - char const * and not -const char*.
    • +
    • Cross-cutting concerns: The cross-cutting concerns are the + modularization of the functionality that the typemaps implement, which + is primarily marshalling of types from/to the target language and + C/C++.
    • +
    • Advice: The typemap body contains code which is executed + whenever the marshalling is required.
    • +
    • Pointcut: The pointcuts are the positions in the wrapper + code that the typemap code is generated into.
    • +
    • Aspect: Aspects are the combination of the pointcut and the + advice, hence each typemap is an aspect.
    -

    10.4 Code generation rules

    -

    This section describes rules by which typemap code is inserted into - the generated wrapper code.

    -

    10.4.1 Scope

    -

    When a typemap is defined like this:

    +

    SWIG can also be viewed as has having a second set of aspects based + around %feature. Features such as +%exception are also cross-cutting concerns as they encapsulate code + that can be used to add logging or exception handling to any function.

    +

    11.1.8 The rest of this chapter

    +

    The rest of this chapter provides detailed information for people + who want to write new typemaps. This information is of particular + importance to anyone who intends to write a new SWIG target language + module. Power users can also use this information to write application + specific type conversion rules.

    +

    Since typemaps are strongly tied to the underlying C++ type system, + subsequent sections assume that you are reasonably familiar with the + basic details of values, pointers, references, arrays, type qualifiers + (e.g., const), structures, namespaces, templates, and memory + management in C/C++. If not, you would be well-advised to consult a + copy of "The C Programming Language" by Kernighan and Ritchie or "The + C++ Programming Language" by Stroustrup before going any further.

    +

    11.2 Typemap specifications

    +

    This section describes the behavior of the %typemap + directive itself.

    +

    11.2.1 Defining a typemap

    +

    New typemaps are defined using the %typemap declaration. + The general form of this declaration is as follows (parts enclosed in [ + ... ] are optional):

    -%typemap(in) int {
    -   $1 = PyInt_AsLong($input);
    -}
    +%typemap(method [, modifiers]) typelist code ;
     
    -

    the typemap code is inserted into the wrapper function using a new - block scope. In other words, the wrapper code will look like this:

    -
    -
    -wrap_whatever() {
    -    ...
    -    // Typemap code
    -    {                    
    -       arg1 = PyInt_AsLong(obj1);
    -    }
    -    ...
    +

    method is a simply a name that specifies what kind of + typemap is being defined. It is usually a name like "in", +"out", or "argout". The purpose of these methods is + described later.

    +

    modifiers is an optional comma separated list of +name="value" values. These are sometimes to attach extra + information to a typemap and is often target-language dependent. They + are also known as typemap attributes.

    +

    typelist is a list of the C++ type patterns that the + typemap will match. The general form of this list is as follows:

    +
    +
    +typelist    :  typepattern [, typepattern, typepattern, ... ] ;
    +
    +typepattern :  type [ (parms) ]
    +            |  type name [ (parms) ]
    +            |  ( typelist ) [ (parms) ]
    +
    +
    +
    +

    Each type pattern is either a simple type, a simple type and + argument name, or a list of types in the case of multi-argument + typemaps. In addition, each type pattern can be parameterized with a + list of temporary variables (parms). The purpose of these variables + will be explained shortly.

    +

    code specifies the code used in the typemap. Usually this is + C/C++ code, but in the statically typed target languages, such as Java + and C#, this can contain target language code for certain typemaps. It + can take any one of the following forms:

    +
    +
    +code       : { ... }
    +           | " ... "
    +           | %{ ... %}
    +
    +
    +

    Note that the preprocessor will expand code within the {} + delimiters, but not in the last two styles of delimiters, see +Preprocessor and Typemaps. Here are some examples of valid typemap + specifications:

    +
    +
    +/* Simple typemap declarations */
    +%typemap(in) int {
    +   $1 = PyInt_AsLong($input);
    +}
    +%typemap(in) int "$1 = PyInt_AsLong($input);";
    +%typemap(in) int %{ 
    +   $1 = PyInt_AsLong($input);
    +%}
    +
    +/* Typemap with extra argument name */
    +%typemap(in) int nonnegative {
    +   ...
    +}
    +
    +/* Multiple types in one typemap */
    +%typemap(in) int, short, long { 
    +   $1 = SvIV($input);
    +}
    +
    +/* Typemap with modifiers */
    +%typemap(in,doc="integer") int "$1 = scm_to_int($input);";
    +
    +/* Typemap applied to patterns of multiple arguments */
    +%typemap(in) (char *str, int len),
    +             (char *buffer, int size)
    +{
    +   $1 = PyString_AsString($input);
    +   $2 = PyString_Size($input);
    +}
    +
    +/* Typemap with extra pattern parameters */
    +%typemap(in, numinputs=0) int *output (int temp),
    +                          long *output (long temp)
    +{
    +   $1 = &temp;
     }
     
    -

    Because the typemap code is enclosed in its own block, it is legal - to declare temporary variables for use during typemap execution. For - example:

    +

    Admittedly, it's not the most readable syntax at first glance. + However, the purpose of the individual pieces will become clear.

    +

    11.2.2 Typemap scope

    +

    Once defined, a typemap remains in effect for all of the + declarations that follow. A typemap may be redefined for different + sections of an input file. For example:

    -%typemap(in) short {
    -   long temp;          /* Temporary value */
    -   if (Tcl_GetLongFromObj(interp, $input, &temp) != TCL_OK) {
    -      return TCL_ERROR;
    -   }
    -   $1 = (short) temp;
    +// typemap1
    +%typemap(in) int {
    +...
    +}
    +
    +int fact(int);                    // typemap1
    +int gcd(int x, int y);            // typemap1
    +
    +// typemap2
    +%typemap(in) int {
    +...
     }
    +
    +int isprime(int);                 // typemap2
     
    -

    Of course, any variables that you declare inside a typemap are - destroyed as soon as the typemap code has executed (they are not - visible to other parts of the wrapper function or other typemaps that - might use the same variable names).

    -

    Occasionally, typemap code will be specified using a few alternative - forms. For example:

    +

    One exception to the typemap scoping rules pertains to the +%extend declaration. %extend is used to attach new + declarations to a class or structure definition. Because of this, all + of the declarations in an %extend block are subject to the + typemap rules that are in effect at the point where the class itself is + defined. For example:

    -%typemap(in) int "$1 = PyInt_AsLong($input);";
    -%typemap(in) int %{
    -$1 = PyInt_AsLong($input);
    -%}
    -%typemap(in, noblock=1) int {
    -$1 = PyInt_AsLong($input);
    +class Foo {
    +   ...
    +};
    +
    +%typemap(in) int {
    + ...
     }
    +
    +%extend Foo {
    +   int blah(int x);    // typemap has no effect.  Declaration is attached to Foo which 
    +                       // appears before the %typemap declaration.
    +};
     
    -

    These three forms are mainly used for cosmetics--the specified code - is not enclosed inside a block scope when it is emitted. This sometimes - results in a less complicated looking wrapper function. Note that only - the third of the three typemaps have the typemap code passed through - the SWIG preprocessor.

    -

    10.4.2 Declaring new local variables

    -

    Sometimes it is useful to declare a new local variable that exists - within the scope of the entire wrapper function. A good example of this - might be an application in which you wanted to marshal strings. Suppose - you had a C++ function like this

    +

    11.2.3 Copying a typemap

    +

    A typemap is copied by using assignment. For example:

    -int foo(std::string *s);
    +%typemap(in) Integer = int;
     
    -

    and you wanted to pass a native string in the target language as an - argument. For instance, in Perl, you wanted the function to work like - this:

    -
    +

    or this:

    +
    -$x = foo("Hello World");
    +%typemap(in) Integer, Number, int32_t = int;
     
    -

    To do this, you can't just pass a raw Perl string as the -std::string * argument. Instead, you have to create a temporary -std::string object, copy the Perl string data into it, and then - pass a pointer to the object. To do this, simply specify the typemap - with an extra parameter like this:

    +

    Types are often managed by a collection of different typemaps. For + example:

    -%typemap(in) std::string * (std::string temp) {
    -    unsigned int len;
    -    char        *s;
    -    s = SvPV($input,len);         /* Extract string data */
    -    temp.assign(s,len);           /* Assign to temp */
    -    $1 = &temp;                   /* Set argument to point to temp */
    -}
    +%typemap(in)     int { ... }
    +%typemap(out)    int { ... }
    +%typemap(varin)  int { ... }
    +%typemap(varout) int { ... }
     
    -

    In this case, temp becomes a local variable in the scope of - the entire wrapper function. For example:

    +

    To copy all of these typemaps to a new type, use %apply. + For example:

    -wrap_foo() {
    -   std::string temp;    <--- Declaration of temp goes here
    -   ...
    -
    -   /* Typemap code */
    -   {
    -      ...
    -      temp.assign(s,len);
    -      ...
    -   } 
    -   ...
    -}
    +%apply int { Integer };            // Copy all int typemaps to Integer
    +%apply int { Integer, Number };    // Copy all int typemaps to both Integer and Number
     
    -

    When you set temp to a value, it persists for the duration - of the wrapper function and gets cleaned up automatically on exit.

    -

    It is perfectly safe to use more than one typemap involving local - variables in the same declaration. For example, you could declare a - function as :

    +

    The patterns for %apply follow the same rules as for +%typemap. For example:

    -void foo(std::string *x, std::string *y, std::string *z);
    +%apply int *output { Integer *output };                    // Typemap with name
    +%apply (char *buf, int len) { (char *buffer, int size) };  // Multiple arguments
     
    -

    This is safely handled because SWIG actually renames all local - variable references by appending an argument number suffix. Therefore, - the generated code would actually look like this:

    +

    11.2.4 Deleting a typemap

    +

    A typemap can be deleted by simply defining no code. For example:

    -wrap_foo() {
    -   int *arg1;    /* Actual arguments */
    -   int *arg2;
    -   int *arg3;
    -   std::string temp1;    /* Locals declared in the typemap */
    -   std::string temp2;
    -   std::string temp3;
    -   ...
    -   {
    -       char *s;
    -       unsigned int len;
    -       ...
    -       temp1.assign(s,len);
    -       arg1 = *temp1;
    -   }
    -   {
    -       char *s;
    -       unsigned int len;
    -       ...
    -       temp2.assign(s,len);
    -       arg2 = &temp2;
    -   }
    -   {
    -       char *s;
    -       unsigned int len;
    -       ...
    -       temp3.assign(s,len);
    -       arg3 = &temp3;
    -   }
    -   ...
    -}
    +%typemap(in) int;               // Clears typemap for int
    +%typemap(in) int, long, short;  // Clears typemap for int, long, short
    +%typemap(in) int *output;       
     
    -

    Some typemaps do not recognize local variables (or they may simply - not apply). At this time, only typemaps that apply to argument - conversion support this (input typemaps such as the "in" typemap).

    -

    Note:

    -

    When declaring a typemap for multiple types, each type must have its - own local variable declaration.

    +

    The %clear directive clears all typemaps for a given type. + For example:

    -%typemap(in) const std::string *, std::string * (std::string temp) // NO!
    -// only std::string * has a local variable
    -// const std::string * does not (oops)
    -....
    -
    -%typemap(in) const std::string * (std::string temp), std::string * (std::string temp) // Correct
    -....
    +%clear int;                     // Removes all types for int
    +%clear int *output, long *output;
     
    -

    10.4.3 Special variables

    -

    Within all typemaps, the following special variables are expanded. - This is by no means a complete list as some target languages have - additional special variables which are documented in the language - specific chapters.

    -
    - - - - - - - - - - - - - - - - - - - - -
    VariableMeaning
    $n A C local variable corresponding to type - n in the typemap pattern.
    $argnumArgument number. Only available in typemaps - related to argument conversion
    $n_nameArgument name
    $n_typeReal C datatype of type n.
    $n_ltypeltype of type n
    $n_mangleMangled form of type n. For - example _p_Foo
    $n_descriptorType descriptor structure for - type n. For example SWIGTYPE_p_Foo. This is primarily - used when interacting with the run-time type checker (described later).
    $*n_typeReal C datatype of type n - with one pointer removed.
    $*n_ltypeltype of type n with one - pointer removed.
    $*n_mangleMangled form of type n with - one pointer removed.
    $*n_descriptorType descriptor structure for - type n with one pointer removed.
    $&n_typeReal C datatype of type n - with one pointer added.
    $&n_ltypeltype of type n with one - pointer added.
    $&n_mangleMangled form of type n with - one pointer added.
    $&n_descriptorType descriptor structure for - type n with one pointer added.
    $n_basetypeBase typename with all pointers and - qualifiers stripped.
    -
    -

    Within the table, $n refers to a specific type within the - typemap specification. For example, if you write this

    +

    Note: Since SWIG's default behavior is defined by typemaps, + clearing a fundamental type like int will make that type + unusable unless you also define a new set of typemaps immediately after + the clear operation.

    +

    11.2.5 Placement of typemaps

    +

    Typemap declarations can be declared in the global scope, within a + C++ namespace, and within a C++ class. For example:

    -%typemap(in) int *INPUT {
    +%typemap(in) int {
    +   ...
    +}
     
    +namespace std {
    +    class string;
    +    %typemap(in) string {
    +        ...
    +    }
     }
    +
    +class Bar {
    +public:
    +    typedef const int & const_reference;
    +    %typemap(out) const_reference {
    +         ...
    +    }
    +};
     
    -

    then $1 refers to int *INPUT. If you have a typemap like - this,

    +

    When a typemap appears inside a namespace or class, it stays in + effect until the end of the SWIG input (just like before). However, the + typemap takes the local scope into account. Therefore, this code

    -%typemap(in) (int argc, char *argv[]) {
    -  ...
    +namespace std {
    +    class string;
    +    %typemap(in) string {
    +       ...
    +    }
     }
     
    -

    then $1 refers to int argc and $2 refers to char - *argv[].

    -

    Substitutions related to types and names always fill in values from - the actual code that was matched. This is useful when a typemap might - match multiple C datatype. For example:

    +

    is really defining a typemap for the type std::string. You + could have code like this:

    -%typemap(in)  int, short, long {
    -   $1 = ($1_ltype) PyInt_AsLong($input);
    +namespace std {
    +    class string;
    +    %typemap(in) string {          /* std::string */
    +       ...
    +    }
    +}
    +
    +namespace Foo {
    +    class string;
    +    %typemap(in) string {          /* Foo::string */
    +       ...
    +    }
     }
     
    -

    In this case, $1_ltype is replaced with the datatype that - is actually matched.

    -

    When typemap code is emitted, the C/C++ datatype of the special - variables $1 and $2 is always an "ltype." An "ltype" - is simply a type that can legally appear on the left-hand side of a C - assignment operation. Here are a few examples of types and ltypes:

    +

    In this case, there are two completely distinct typemaps that apply + to two completely different types (std::string and +Foo::string).

    +

    It should be noted that for scoping to work, SWIG has to know that +string is a typename defined within a particular namespace. In this + example, this is done using the forward class declaration class + string.

    +

    11.3 Pattern matching rules

    +

    The section describes the pattern matching rules by which C/C++ + datatypes are associated with typemaps. The matching rules can be + observed in practice by using the debugging options also described.

    +

    11.3.1 Basic matching rules

    +

    Typemaps are matched using both a type and a name (typically the + name of a argument). For a given TYPE NAME pair, the following + rules are applied, in order, to find a match. The first typemap found + is used.

    +
      +
    • Typemaps that exactly match TYPE and NAME.
    • +
    • Typemaps that exactly match TYPE only.
    • +
    • If TYPE is a C++ template of type T< TPARMS >, + where TPARMS are the template parameters, the type is stripped + of the template parameters and the following checks are then made: +
        +
      • Typemaps that exactly match T and NAME.
      • +
      • Typemaps that exactly match T only.
      • +
      +
    • +
    +

    If TYPE includes qualifiers (const, volatile, etc.), each + qualifier is stripped one at a time to form a new stripped type and the + matching rules above are repeated on the stripped type. The left-most + qualifier is stripped first, resulting in the right-most (or top-level) + qualifier being stripped last. For example int const*const is + first stripped to int *const then int *.

    +

    If TYPE is an array. The following transformation is made:

    +
      +
    • Replace all dimensions to [ANY] and look for a generic + array typemap.
    • +
    +

    To illustrate, suppose that you had a function like this:

    +
    +
    +int foo(const char *s);
    +
    +
    +

    To find a typemap for the argument const char *s, SWIG will + search for the following typemaps:

    -type              ltype
    -------            ----------------
    -int               int
    -const int         int
    -const int *       int *
    -int [4]           int *
    -int [4][5]        int (*)[5]
    +const char *s           Exact type and name match
    +const char *            Exact type match
    +char *s                 Type and name match (qualifier stripped)
    +char *                  Type match (qualifier stripped)
     
    -

    In most cases a ltype is simply the C datatype with qualifiers - stripped off. In addition, arrays are converted into pointers.

    -

    Variables such as $&1_type and $*1_type are used - to safely modify the type by removing or adding pointers. Although not - needed in most typemaps, these substitutions are sometimes needed to - properly work with typemaps that convert values between pointers and - values.

    -

    If necessary, type related substitutions can also be used when - declaring locals. For example:

    +

    When more than one typemap rule might be defined, only the first + match found is actually used. Here is an example that shows how some of + the basic rules are applied:

    -%typemap(in) int * ($*1_type temp) {
    -    temp = PyInt_AsLong($input);
    -    $1 = &temp;
    +%typemap(in) int *x {
    +   ... typemap 1
    +}
    +
    +%typemap(in) int * {
    +   ... typemap 2
    +}
    +
    +%typemap(in) const int *z {
    +   ... typemap 3
    +}
    +
    +%typemap(in) int [4] {
    +   ... typemap 4
    +}
    +
    +%typemap(in) int [ANY] {
    +   ... typemap 5
     }
    +
    +void A(int *x);        // int *x rule       (typemap 1)
    +void B(int *y);        // int * rule        (typemap 2)
    +void C(const int *x);  // int *x rule       (typemap 1)
    +void D(const int *z);  // const int *z rule (typemap 3)
    +void E(int x[4]);      // int [4] rule      (typemap 4)
    +void F(int x[1000]);   // int [ANY] rule    (typemap 5)
     
    -

    There is one word of caution about declaring local variables in this - manner. If you declare a local variable using a type substitution such - as $1_ltype temp, it won't work like you expect for arrays and - certain kinds of pointers. For example, if you wrote this,

    +

    Compatibility note: SWIG-2.0.0 introduced stripping the + qualifiers one step at a time. Prior versions stripped all qualifiers + in one step.

    +

    11.3.2 Typedef reductions + matching

    +

    If no match is found using the rules in the previous section, SWIG + applies a typedef reduction to the type and repeats the typemap search + for the reduced type. To illustrate, suppose you had code like this:

    -%typemap(in) int [10][20] {
    -   $1_ltype temp;
    +%typemap(in) int {
    +   ... typemap 1
     }
    +
    +typedef int Integer;
    +void blah(Integer x);
     
    -

    then the declaration of temp will be expanded as

    -
    +

    To find the typemap for Integer x, SWIG will first search + for the following typemaps:

    +
    -int (*)[20] temp;
    +Integer x
    +Integer
     
    -

    This is illegal C syntax and won't compile. There is currently no - straightforward way to work around this problem in SWIG due to the way - that typemap code is expanded and processed. However, one possible - workaround is to simply pick an alternative type such as void * - and use casts to get the correct type when needed. For example:

    -
    +

    Finding no match, it then applies a reduction Integer -> int + to the type and repeats the search.

    +
    -%typemap(in) int [10][20] {
    -   void *temp;
    -   ...
    -   (($1_ltype) temp)[i][j] = x;    /* set a value */
    -   ...
    -}
    +int x
    +int      --> match: typemap 1
     
    -

    Another approach, which only works for arrays is to use the -$1_basetype substitution. For example:

    +

    Even though two types might be the same via typedef, SWIG allows + typemaps to be defined for each typename independently. This allows for + interesting customization possibilities based solely on the typename + itself. For example, you could write code like this:

    -%typemap(in) int [10][20] {
    -   $1_basetype temp[10][20];
    -   ...
    -   temp[i][j] = x;    /* set a value */
    -   ...
    +typedef double  pdouble;     // Positive double
    +
    +// typemap 1
    +%typemap(in) double {
    +   ... get a double ...
     }
    +// typemap 2
    +%typemap(in) pdouble {
    +   ... get a positive double ...
    +}
    +double sin(double x);           // typemap 1
    +pdouble sqrt(pdouble x);        // typemap 2
     
    -

    10.4.4 Special - variable macros

    -

    Special variable macros are like macro functions in that they take - one or more input arguments which are used for the macro expansion. - They look like macro/function calls but use the special variable $ - prefix to the macro name. Note that unlike normal macros, the expansion - is not done by the preprocessor, it is done during the SWIG - parsing/compilation stages. The following special variable macros are - available across all language modules.

    -

    10.4.4.1 - $descriptor(type)

    -

    This macro expands into the type descriptor structure for any C/C++ - type specified in type. It behaves like the $1_descriptor - special variable described above except that the type to expand is - taken from the macro argument rather than inferred from the typemap - type. For example, $descriptor(std::vector<int> *) will expand - into SWIGTYPE_p_std__vectorT_int_t. This macro is mostly used - in the scripting target languages and is demonstrated later in the -Run-time type checker usage section.

    -

    10.4.4.2 - $typemap(method, typepattern)

    -

    This macro uses the pattern - matching rules described earlier to lookup and then substitute the - special variable macro with the code in the matched typemap. The - typemap to search for is specified by the arguments, where method - is the typemap method name and typepattern is a type pattern - as per the %typemap specification in the -Defining a typemap section.

    -

    The special variables within the matched typemap are expanded into - those for the matched typemap type, not the typemap within which the - macro is called. In practice, there is little use for this macro in the - scripting target languages. It is mostly used in the target languages - that are statically typed as a way to obtain the target language type - given the C/C++ type and more commonly only when the C++ type is a - template parameter.

    -

    The example below is for C# only and uses some typemap method names - documented in the C# chapter, but it shows some of the possible syntax - variations.

    -
    -
    -%typemap(cstype) unsigned long    "uint"
    -%typemap(cstype) unsigned long bb "bool"
    -%typemap(cscode) BarClass %{
    -  void foo($typemap(cstype, unsigned long aa) var1,
    -           $typemap(cstype, unsigned long bb) var2,
    -           $typemap(cstype, (unsigned long bb)) var3,
    -           $typemap(cstype, unsigned long) var4)
    -  {
    -    // do something
    -  }
    -%}
    -
    -
    -

    The result is the following expansion

    +

    When reducing the type, only one typedef reduction is applied at a + time. The search process continues to apply reductions until a match is + found or until no more reductions can be made.

    +

    For complicated types, the reduction process can generate a long + list of patterns. Consider the following:

    -%typemap(cstype) unsigned long    "uint"
    -%typemap(cstype) unsigned long bb "bool"
    -%typemap(cscode) BarClass %{
    -  void foo(uint var1,
    -           bool var2,
    -           bool var3,
    -           uint var4)
    -  {
    -    // do something
    -  }
    -%}
    +typedef int Integer;
    +typedef Integer Row4[4];
    +void foo(Row4 rows[10]);
     
    -

    10.5 Common typemap methods

    -

    The set of typemaps recognized by a language module may vary. - However, the following typemap methods are nearly universal:

    -

    10.5.1 "in" typemap

    -

    The "in" typemap is used to convert function arguments from the - target language to C. For example:

    +

    To find a match for the Row4 rows[10] argument, SWIG would + check the following patterns, stopping only when it found a match:

    -%typemap(in) int {
    -   $1 = PyInt_AsLong($input);
    -}
    +Row4 rows[10]
    +Row4 [10]
    +Row4 rows[ANY]
    +Row4 [ANY]
    +
    +# Reduce Row4 --> Integer[4]
    +Integer rows[10][4]
    +Integer [10][4]
    +Integer rows[ANY][ANY]
    +Integer [ANY][ANY]
    +
    +# Reduce Integer --> int
    +int rows[10][4]
    +int [10][4]
    +int rows[ANY][ANY]
    +int [ANY][ANY]
     
    -

    The following special variables are available:

    +

    For parameterized types like templates, the situation is even more + complicated. Suppose you had some declarations like this:

    -$input            - Input object holding value to be converted.
    -$symname          - Name of function/method being wrapped
    +typedef int Integer;
    +typedef foo<Integer,Integer> fooii;
    +void blah(fooii *x);
     
    -

    This is probably the most commonly redefined typemap because it can - be used to implement customized conversions.

    -

    In addition, the "in" typemap allows the number of converted - arguments to be specified. The numinputs attributes - facilitates this. For example:

    +

    In this case, the following typemap patterns are searched for the + argument fooii *x:

    -// Ignored argument.
    -%typemap(in, numinputs=0) int *out (int temp) {
    -    $1 = &temp;
    -}
    +fooii *x
    +fooii *
    +
    +# Reduce fooii --> foo<Integer,Integer>
    +foo<Integer,Integer> *x
    +foo<Integer,Integer> *
    +
    +# Reduce Integer -> int
    +foo<int, Integer> *x
    +foo<int, Integer> *
    +
    +# Reduce Integer -> int
    +foo<int, int> *x
    +foo<int, int> *
     
    -

    At this time, only zero or one arguments may be converted. When -numinputs is set to 0, the argument is effectively ignored and - cannot be supplied from the target language. The argument is still - required when making the C/C++ call and the above typemap shows the - value used is instead obtained from a locally declared variable called -temp. Usually numinputs is not specified, whereupon the - default value is 1, that is, there is a one to one mapping of the - number of arguments when used from the target language to the C/C++ - call. Multi-argument - typemaps provide a similar concept where the number of arguments - mapped from the target language to C/C++ can be changed for multiple - adjacent C/C++ arguments.

    -

    Compatibility note: Specifying numinputs=0 is the - same as the old "ignore" typemap.

    -

    10.5.2 "typecheck" typemap

    -

    The "typecheck" typemap is used to support overloaded functions and - methods. It merely checks an argument to see whether or not it matches - a specific type. For example:

    +

    Typemap reductions are always applied to the left-most type that + appears. Only when no reductions can be made to the left-most type are + reductions made to other parts of the type. This behavior means that + you could define a typemap for foo<int,Integer>, but a typemap + for foo<Integer,int> would never be matched. Admittedly, this + is rather esoteric--there's little practical reason to write a typemap + quite like that. Of course, you could rely on this to confuse your + coworkers even more.

    +

    As a point of clarification, it is worth emphasizing that typedef + matching is a typedef reduction process only, that is, SWIG does + not search for every single possible typedef. Given a type in a + declaration, it will only reduce the type, it won't build it up looking + for typedefs. For example, given the type Struct, the typemap + below will not be used for the aStruct parameter, because +Struct is fully reduced:

    -%typemap(typecheck,precedence=SWIG_TYPECHECK_INTEGER) int {
    -   $1 = PyInt_Check($input) ? 1 : 0;
    +struct Struct {...};
    +typedef Struct StructTypedef;
    +
    +%typemap(in) StructTypedef { 
    +  ...
     }
    +
    +void go(Struct aStruct);
     
    -

    For typechecking, the $1 variable is always a simple integer that is - set to 1 or 0 depending on whether or not the input argument is the - correct type.

    -

    If you define new "in" typemaps and your program uses - overloaded methods, you should also define a collection of "typecheck" - typemaps. More details about this follow in the -Typemaps and overloading section.

    -

    10.5.3 "out" typemap

    -

    The "out" typemap is used to convert function/method return values - from C into the target language. For example:

    +

    11.3.3 Default typemap matching rules

    +

    If the basic pattern matching rules result in no match being made, + even after typedef reductions, the default typemap matching rules are + used to look for a suitable typemap match. These rules match a generic + typemap based on the reserved SWIGTYPE base type. For example + pointers will use SWIGTYPE * and references will use +SWIGTYPE &. More precisely, the rules are based on the C++ class + template partial specialization matching rules used by C++ compilers + when looking for an appropriate partial template specialization. This + means that a match is chosen from the most specialized set of generic + typemap types available. For example, when looking for a match to +int const *, the rules will prefer to match SWIGTYPE const * + if available before matching SWIGTYPE *, before matching +SWIGTYPE.

    +

    Most SWIG language modules use typemaps to define the default + behavior of the C primitive types. This is entirely straightforward. + For example, a set of typemaps for primitives marshalled by value or + const reference are written like this:

    -%typemap(out) int {
    -   $result = PyInt_FromLong($1);
    -}
    +%typemap(in) int           "... convert to int ...";
    +%typemap(in) short         "... convert to short ...";
    +%typemap(in) float         "... convert to float ...";
    +...
    +%typemap(in) const int &   "... convert ...";
    +%typemap(in) const short & "... convert ...";
    +%typemap(in) const float & "... convert ...";
    +...
     
    -

    The following special variables are available.

    +

    Since typemap matching follows all typedef declarations, + any sort of type that is mapped to a primitive type by value or const + reference through typedef will be picked up by one of these + primitive typemaps. Most language modules also define typemaps for char + pointers and char arrays to handle strings, so these non-default types + will also be used in preference as the basic typemap matching rules + provide a better match than the default typemap matching rules.

    +

    Below is a list of the typical default types supplied by language + modules, showing what the "in" typemap would look like:

    -$result           - Result object returned to target language.
    -$symname          - Name of function/method being wrapped
    +%typemap(in) SWIGTYPE &            { ... default reference handling ...                       };
    +%typemap(in) SWIGTYPE *            { ... default pointer handling ...                         };
    +%typemap(in) SWIGTYPE *const       { ... default pointer const handling ...                   };
    +%typemap(in) SWIGTYPE *const&      { ... default pointer const reference handling ...         };
    +%typemap(in) SWIGTYPE[ANY]         { ... 1D fixed size arrays handlling ...                   };
    +%typemap(in) SWIGTYPE []           { ... unknown sized array handling ...                     };
    +%typemap(in) enum SWIGTYPE         { ... default handling for enum values ...                 };
    +%typemap(in) const enum SWIGTYPE & { ... default handling for const enum reference values ... };
    +%typemap(in) SWIGTYPE (CLASS::*)   { ... default pointer member handling ...                  };
    +%typemap(in) SWIGTYPE              { ... simple default handling ...                          };
     
    -

    The "out" typemap supports an optional attribute flag called - "optimal". This is for code optimisation and is detailed in the -Optimal code generation when returning by value section.

    -

    10.5.4 "arginit" typemap

    -

    The "arginit" typemap is used to set the initial value of a function - argument--before any conversion has occurred. This is not normally - necessary, but might be useful in highly specialized applications. For - example:

    +

    If you wanted to change SWIG's default handling for simple pointers, + you would simply redefine the rule for SWIGTYPE *. Note, the + simple default typemap rule is used to match against simple types that + don't match any other rules:

    -// Set argument to NULL before any conversion occurs
    -%typemap(arginit) int *data {
    -   $1 = NULL;
    -}
    +%typemap(in) SWIGTYPE              { ... simple default handling ...                          } 
     
    -

    10.5.5 "default" typemap

    -

    The "default" typemap is used to turn an argument into a default - argument. For example:

    +

    This typemap is important because it is the rule that gets triggered + when call or return by value is used. For instance, if you have a + declaration like this:

    -%typemap(default) int flags {
    -   $1 = DEFAULT_FLAGS;
    -}
    -...
    -int foo(int x, int y, int flags);
    +double dot_product(Vector a, Vector b);
     
    -

    The primary use of this typemap is to either change the wrapping of - default arguments or specify a default argument in a language where - they aren't supported (like C). Target languages that do not support - optional arguments, such as Java and C#, effectively ignore the value - specified by this typemap as all arguments must be given.

    -

    Once a default typemap has been applied to an argument, all - arguments that follow must have default values. See the -Default/optional arguments section for further information on - default argument wrapping.

    -

    10.5.6 "check" typemap

    -

    The "check" typemap is used to supply value checking code during - argument conversion. The typemap is applied after arguments - have been converted. For example:

    +

    The Vector type will usually just get matched against +SWIGTYPE. The default implementation of SWIGTYPE is to + convert the value into pointers (as described in + this earlier section).

    +

    By redefining SWIGTYPE it may be possible to implement + other behavior. For example, if you cleared all typemaps for +SWIGTYPE, SWIG simply won't wrap any unknown datatype (which might + be useful for debugging). Alternatively, you might modify SWIGTYPE to + marshal objects into strings instead of converting them to pointers.

    +

    Let's consider an example where the following typemaps are defined + and SWIG is looking for the best match for the enum shown below:

    -%typemap(check) int positive {
    -   if ($1 <= 0) {
    -       SWIG_exception(SWIG_ValueError,"Expected positive value.");
    -   }
    -}
    +%typemap(in) const Hello &          { ... }
    +%typemap(in) const enum SWIGTYPE &  { ... }
    +%typemap(in) enum SWIGTYPE &        { ... }
    +%typemap(in) SWIGTYPE &             { ... }
    +%typemap(in) SWIGTYPE               { ... }
    +
    +enum Hello {};
    +const Hello &hi;
     
    -

    10.5.7 "argout" typemap

    -

    The "argout" typemap is used to return values from arguments. This - is most commonly used to write wrappers for C/C++ functions that need - to return multiple values. The "argout" typemap is almost always - combined with an "in" typemap---possibly to ignore the input value. For - example:

    +

    The typemap at the top of the list will be chosen, not because it is + defined first, but because it is the closest match for the type being + wrapped. If any of the typemaps in the above list were not defined, + then the next one on the list would have precedence.

    +

    The best way to explore the default typemaps is to look at the ones + already defined for a particular language module. Typemap definitions + are usually found in the SWIG library in a file such as java.swg +, csharp.swg etc. However, for many of the target languages the + typemaps are hidden behind complicated macros, so the best way to view + the default typemaps, or any typemaps for that matter, is to look at + the preprocessed output by running swig -E on any interface + file. Finally the best way to view the typemap matching rules in action + is via the debugging typemap + pattern matching options covered later on.

    +

    Compatibility note: The default typemap matching rules were + modified in SWIG-2.0.0 from a slightly simpler scheme to match the + current C++ class template partial specialization matching rules.

    +

    11.3.4 + Multi-arguments typemaps

    +

    When multi-argument typemaps are specified, they take precedence + over any typemaps specified for a single type. For example:

    -/* Set the input argument to point to a temporary variable */
    -%typemap(in, numinputs=0) int *out (int temp) {
    -   $1 = &temp;
    +%typemap(in) (char *buffer, int len) {
    +   // typemap 1
     }
     
    -%typemap(argout) int *out {
    -   // Append output value $1 to $result
    -   ...
    +%typemap(in) char *buffer {
    +   // typemap 2
     }
    +
    +void foo(char *buffer, int len, int count); // (char *buffer, int len)
    +void bar(char *buffer, int blah);           // char *buffer
     
    -

    The following special variables are available.

    -
    +

    Multi-argument typemaps are also more restrictive in the way that + they are matched. Currently, the first argument follows the matching + rules described in the previous section, but all subsequent arguments + must match exactly.

    +

    11.3.5 Matching + rules compared to C++ templates

    +

    For those intimately familiar with C++ templates, a comparison of + the typemap matching rules and template type deduction is interesting. + The two areas considered are firstly the default typemaps and their + similarities to partial template specialization and secondly, + non-default typemaps and their similarities to full template + specialization.

    +

    For default (SWIGTYPE) typemaps the rules are inspired by C++ class + template partial specialization. For example, given partial + specialization for T const& :

    +
    -$result           - Result object returned to target language.
    -$input            - The original input object passed.
    -$symname          - Name of function/method being wrapped
    +template <typename T> struct X             { void a(); };
    +template <typename T> struct X< T const& > { void b(); };
     
    -

    The code supplied to the "argout" typemap is always placed after the - "out" typemap. If multiple return values are used, the extra return - values are often appended to return value of the function.

    -

    See the typemaps.i library file for examples.

    -

    10.5.8 "freearg" typemap

    -

    The "freearg" typemap is used to cleanup argument data. It is only - used when an argument might have allocated resources that need to be - cleaned up when the wrapper function exits. The "freearg" typemap - usually cleans up argument resources allocated by the "in" typemap. For - example:

    +

    The full (unspecialized) template is matched with most types, such + as:

    -// Get a list of integers
    -%typemap(in) int *items {
    -   int nitems = Length($input);    
    -   $1 = (int *) malloc(sizeof(int)*nitems);
    -}
    -// Free the list 
    -%typemap(freearg) int *items {
    -   free($1);
    -}
    +X< int & >            x1;  x1.a();
     
    -

    The "freearg" typemap inserted at the end of the wrapper function, - just before control is returned back to the target language. This code - is also placed into a special variable $cleanup that may be - used in other typemaps whenever a wrapper function needs to abort - prematurely.

    -

    10.5.9 "newfree" typemap

    -

    The "newfree" typemap is used in conjunction with the %newobject - directive and is used to deallocate memory used by the return result of - a function. For example:

    +

    and the following all match the T const& partial + specialization:

    -%typemap(newfree) string * {
    -   delete $1;
    -}
    -%typemap(out) string * {
    -   $result = PyString_FromString($1->c_str());
    -}
    -...
    -
    -%newobject foo;
    -...
    -string *foo();
    +X< int *const& >      x2;  x2.b();
    +X< int const*const& > x3;  x3.b();
    +X< int const& >       x4;  x4.b();
     
    -

    See Object ownership and - %newobject for further details.

    -

    10.5.10 "memberin" typemap

    -

    The "memberin" typemap is used to copy data from an already - converted input value into a structure member. It is typically - used to handle array members and other special cases. For example:

    +

    Now, given just these two default typemaps, where T is analogous to + SWIGTYPE:

    -%typemap(memberin) int [4] {
    -   memmove($1, $input, 4*sizeof(int));
    -}
    +%typemap(...) SWIGTYPE        { ... }
    +%typemap(...) SWIGTYPE const& { ... }
     
    -

    It is rarely necessary to write "memberin" typemaps---SWIG already - provides a default implementation for arrays, strings, and other - objects.

    -

    10.5.11 "varin" typemap

    -

    The "varin" typemap is used to convert objects in the target - language to C for the purposes of assigning to a C/C++ global variable. - This is implementation specific.

    -

    10.5.12 "varout" typemap

    -

    The "varout" typemap is used to convert a C/C++ object to an object - in the target language when reading a C/C++ global variable. This is - implementation specific.

    -

    10.5.13 "throws" typemap

    -

    The "throws" typemap is only used when SWIG parses a C++ method with - an exception specification or has the %catches feature - attached to the method. It provides a default mechanism for handling - C++ methods that have declared the exceptions they will throw. The - purpose of this typemap is to convert a C++ exception into an error or - exception in the target language. It is slightly different to the other - typemaps as it is based around the exception type rather than the type - of a parameter or variable. For example:

    +

    The generic default typemap SWIGTYPE is used with most + types, such as

    -%typemap(throws) const char * %{
    -  PyErr_SetString(PyExc_RuntimeError, $1);
    -  SWIG_fail;
    -%}
    -void bar() throw (const char *);
    +int &
     
    -

    As can be seen from the generated code below, SWIG generates an - exception handler with the catch block comprising the "throws" typemap - content.

    +

    and the following all match the SWIGTYPE const& typemap, + just like the partial template matching:

    -...
    -try {
    -    bar();
    -}
    -catch(char const *_e) {
    -    PyErr_SetString(PyExc_RuntimeError, _e);
    -    SWIG_fail;
    -    
    -}
    -...
    +int *const&
    +int const*const&
    +int const&
     
    -

    Note that if your methods do not have an exception specification yet - they do throw exceptions, SWIG cannot know how to deal with them. For a - neat way to handle these, see the -Exception handling with %exception section.

    -

    10.6 Some typemap examples

    -

    This section contains a few examples. Consult language module - documentation for more examples.

    -

    10.6.1 Typemaps for arrays

    -

    A common use of typemaps is to provide support for C arrays - appearing both as arguments to functions and as structure members.

    -

    For example, suppose you had a function like this:

    +

    Note that the template and typemap matching rules are not identical + for all default typemaps though, for example, with arrays.

    +

    For non-default typemaps, one might expect SWIG to follow the fully + specialized template rules. This is nearly the case, but not quite. + Consider a very similar example to the earlier partially specialized + template but this time there is a fully specialized template:

    -void set_vector(int type, float value[4]);
    +template <typename T> struct Y       { void a(); };
    +template <> struct Y< int const & >  { void b(); };
     
    -

    If you wanted to handle float value[4] as a list of floats, - you might write a typemap similar to this:

    +

    Only the one type matches the specialized template exactly:

    -
    -%typemap(in) float value[4] (float temp[4]) {
    -  int i;
    -  if (!PySequence_Check($input)) {
    -    PyErr_SetString(PyExc_ValueError,"Expected a sequence");
    -    return NULL;
    -  }
    -  if (PySequence_Length($input) != 4) {
    -    PyErr_SetString(PyExc_ValueError,"Size mismatch. Expected 4 elements");
    -    return NULL;
    -  }
    -  for (i = 0; i < 4; i++) {
    -    PyObject *o = PySequence_GetItem($input,i);
    -    if (PyNumber_Check(o)) {
    -      temp[i] = (float) PyFloat_AsDouble(o);
    -    } else {
    -      PyErr_SetString(PyExc_ValueError,"Sequence elements must be numbers");      
    -      return NULL;
    -    }
    -  }
    -  $1 = temp;
    -}
    +Y< int & >             y1;  y1.a();
    +Y< int *const& >       y2;  y2.a();
    +Y< int const *const& > y3;  y3.a();
    +Y< int const& >        y4;  y4.b(); // fully specialized match
     
    -

    In this example, the variable temp allocates a small array - on the C stack. The typemap then populates this array and passes it to - the underlying C function.

    -

    When used from Python, the typemap allows the following type of - function call:

    -
    +

    Given typemaps with the same types used for the template declared + above, where T is again analogous to SWIGTYPE:

    +
    ->>> set_vector(type, [ 1, 2.5, 5, 20 ])
    +%typemap(...) SWIGTYPE        { ... }
    +%typemap(...) int const&      { ... }
     
    -

    If you wanted to generalize the typemap to apply to arrays of all - dimensions you might write this:

    +

    The comparison between non-default typemaps and fully specialized + single parameter templates turns out to be the same, as just the one + type will match the non-default typemap:

    -%typemap(in) float value[ANY] (float temp[$1_dim0]) {
    -  int i;
    -  if (!PySequence_Check($input)) {
    -    PyErr_SetString(PyExc_ValueError,"Expected a sequence");
    -    return NULL;
    -  }
    -  if (PySequence_Length($input) != $1_dim0) {
    -    PyErr_SetString(PyExc_ValueError,"Size mismatch. Expected $1_dim0 elements");
    -    return NULL;
    -  }
    -  for (i = 0; i < $1_dim0; i++) {
    -    PyObject *o = PySequence_GetItem($input,i);
    -    if (PyNumber_Check(o)) {
    -      temp[i] = (float) PyFloat_AsDouble(o);
    -    } else {
    -      PyErr_SetString(PyExc_ValueError,"Sequence elements must be numbers");      
    -      return NULL;
    -    }
    -  }
    -  $1 = temp;
    -}
    +int &
    +int *const&
    +int const*const&
    +int const&        // matches non-default typemap int const&
     
    -

    In this example, the special variable $1_dim0 is expanded - with the actual array dimensions. Multidimensional arrays can be - matched in a similar manner. For example:

    +

    However, if a non-const type is used instead:

    -%typemap(in) float matrix[ANY][ANY] (float temp[$1_dim0][$1_dim1]) {
    -   ... convert a 2d array ...
    -}
    +%typemap(...) SWIGTYPE        { ... }
    +%typemap(...) int &           { ... }
     
    -

    For large arrays, it may be impractical to allocate storage on the - stack using a temporary variable as shown. To work with heap allocated - data, the following technique can be used.

    +

    then there is a clear difference to template matching as both the + const and non-const types match the typemap:

    -%typemap(in) float value[ANY] {
    -  int i;
    -  if (!PySequence_Check($input)) {
    -    PyErr_SetString(PyExc_ValueError,"Expected a sequence");
    -    return NULL;
    -  }
    -  if (PySequence_Length($input) != $1_dim0) {
    -    PyErr_SetString(PyExc_ValueError,"Size mismatch. Expected $1_dim0 elements");
    -    return NULL;
    -  }
    -  $1 = (float *) malloc($1_dim0*sizeof(float));
    -  for (i = 0; i < $1_dim0; i++) {
    -    PyObject *o = PySequence_GetItem($input,i);
    -    if (PyNumber_Check(o)) {
    -      $1[i] = (float) PyFloat_AsDouble(o);
    -    } else {
    -      PyErr_SetString(PyExc_ValueError,"Sequence elements must be numbers");      
    -      free($1);
    -      return NULL;
    -    }
    -  }
    -}
    -%typemap(freearg) float value[ANY] {
    -   if ($1) free($1);
    -}
    +int &             // matches non-default typemap int &
    +int *const&
    +int const*const&
    +int const&        // matches non-default typemap int &
     
    -

    In this case, an array is allocated using malloc. The -freearg typemap is then used to release the argument after the - function has been called.

    -

    Another common use of array typemaps is to provide support for array - structure members. Due to subtle differences between pointers and - arrays in C, you can't just "assign" to a array structure member. - Instead, you have to explicitly copy elements into the array. For - example, suppose you had a structure like this:

    +

    There are other subtle differences such as typedef handling, but at + least it should be clear that the typemap matching rules are similar to + those for specialized template handling.

    +

    11.3.6 Debugging typemap pattern + matching

    +

    There are two useful debug command line options available for + debugging typemaps, -debug-tmsearch and -debug-tmused +.

    +

    The -debug-tmsearch option is a verbose option for + debugging typemap searches. This can be very useful for watching the + pattern matching process in action and for debugging which typemaps are + used. The option displays all the typemaps and types that are looked + for until a successful pattern match is made. As the display includes + searches for each and every type needed for wrapping, the amount of + information displayed can be large. Normally you would manually search + through the displayed information for the particular type that you are + interested in.

    +

    For example, consider some of the code used in the +Typedef reductions section already covered:

    -struct SomeObject {
    -	float  value[4];
    -        ...
    -};
    +typedef int Integer;
    +typedef Integer Row4[4];
    +void foo(Row4 rows[10]);
     
    -

    When SWIG runs, it won't produce any code to set the vec - member. You may even get a warning message like this:

    +

    A sample of the debugging output is shown below for the "in" + typemap:

    -$ swig -python  example.i
    -example.i:10: Warning 462: Unable to set variable of type float [4].
    +swig -perl -debug-tmsearch example.i
    +...
    +example.h:3: Searching for a suitable 'in' typemap for: Row4 rows[10]
    +  Looking for: Row4 rows[10]
    +  Looking for: Row4 [10]
    +  Looking for: Row4 rows[ANY]
    +  Looking for: Row4 [ANY]
    +  Looking for: Integer rows[10][4]
    +  Looking for: Integer [10][4]
    +  Looking for: Integer rows[ANY][ANY]
    +  Looking for: Integer [ANY][ANY]
    +  Looking for: int rows[10][4]
    +  Looking for: int [10][4]
    +  Looking for: int rows[ANY][ANY]
    +  Looking for: int [ANY][ANY]
    +  Looking for: SWIGTYPE rows[ANY][ANY]
    +  Looking for: SWIGTYPE [ANY][ANY]
    +  Looking for: SWIGTYPE rows[ANY][]
    +  Looking for: SWIGTYPE [ANY][]
    +  Looking for: SWIGTYPE *rows[ANY]
    +  Looking for: SWIGTYPE *[ANY]
    +  Looking for: SWIGTYPE rows[ANY]
    +  Looking for: SWIGTYPE [ANY]
    +  Looking for: SWIGTYPE rows[]
    +  Looking for: SWIGTYPE []
    +  Using: %typemap(in) SWIGTYPE []
    +...
     
    -

    These warning messages indicate that SWIG does not know how you want - to set the vec field.

    -

    To fix this, you can supply a special "memberin" typemap like this:

    +

    showing that the best default match supplied by SWIG is the +SWIGTYPE [] typemap. As the example shows, the successful match + displays the used typemap source including typemap method, type and + optional name in one of these simplified formats:

    +
      +
    • Using: %typemap(method) type name
    • +
    • Using: %typemap(method) type name = type2 name2
    • +
    • Using: %apply type2 name2 { type name }
    • +
    +

    This information might meet your debugging needs, however, you might + want to analyze further. If you next invoke SWIG with the -E + option to display the preprocessed output, and search for the + particular typemap used, you'll find the full typemap contents (example + shown below for Python):

    -%typemap(memberin) float [ANY] {
    -  int i;
    -  for (i = 0; i < $1_dim0; i++) {
    -      $1[i] = $input[i];
    -  }
    +%typemap(in, noblock=1) SWIGTYPE [] (void *argp = 0, int res = 0) {
    +  res = SWIG_ConvertPtr($input, &argp,$descriptor, $disown |  0 );
    +  if (!SWIG_IsOK(res)) { 
    +    SWIG_exception_fail(SWIG_ArgError(res), "in method '" "$symname" "', argument "
    +                       "$argnum"" of type '" "$type""'"); 
    +  } 
    +  $1 = ($ltype)(argp);
     }
     
    -

    The memberin typemap is used to set a structure member from data - that has already been converted from the target language to C. In this - case, $input is the local variable in which converted input - data is stored. This typemap then copies this data into the structure.

    -

    When combined with the earlier typemaps for arrays, the combination - of the "in" and "memberin" typemap allows the following usage:

    -
    +

    The generated code for the foo wrapper will then contain + the snippets of the typemap with the special variables expanded. The + rest of this chapter will need reading though to fully understand all + of this, however, the relevant parts of the generated code for the + above typemap can be seen below:

    +
    ->>> s = SomeObject()
    ->>> s.x = [1, 2.5, 5, 10]
    +SWIGINTERN PyObject *_wrap_foo(PyObject *SWIGUNUSEDPARM(self), PyObject *args) {
    +...
    +  void *argp1 = 0 ;
    +  int res1 = 0 ;
    +...
    +  res1 = SWIG_ConvertPtr(obj0, &argp1,SWIGTYPE_p_a_4__int, 0 |  0 );
    +  if (!SWIG_IsOK(res1)) {
    +    SWIG_exception_fail(SWIG_ArgError(res1), "in method '" "foo" "', argument "
    +                       "1"" of type '" "int [10][4]""'"); 
    +  } 
    +  arg1 = (int (*)[4])(argp1);
    +...
    +}
     
    -

    Related to structure member input, it may be desirable to return - structure members as a new kind of object. For example, in this - example, you will get very odd program behavior where the structure - member can be set nicely, but reading the member simply returns a - pointer:

    -
    +

    Searches for multi-argument typemaps are not mentioned unless a + matching multi-argument typemap does actually exist. For example, the + output for the code in the +earlier multi-arguments section is as follows:

    +
    ->>> s = SomeObject()
    ->>> s.x = [1, 2.5, 5, 10]
    ->>> print s.x
    -_1008fea8_p_float
    ->>> 
    +...
    +example.h:39: Searching for a suitable 'in' typemap for: char *buffer
    +  Looking for: char *buffer
    +  Multi-argument typemap found...
    +  Using: %typemap(in) (char *buffer,int len)
    +...
     
    -

    To fix this, you can write an "out" typemap. For example:

    +

    The second option for debugging is -debug-tmused and this + displays the typemaps used. This option is a less verbose version of + the -debug-tmsearch option as it only displays each + successfully found typemap on a separate single line. The output + displays the type, and name if present, the typemap method in brackets + and then the actual typemap used in the same simplified format output + by the -debug-tmsearch option. Below is the output for the + example code at the start of this section on debugging.

    +
    +
    +$ swig -perl -debug-tmused example.i
    +example.h:3: Typemap for Row4 rows[10] (in) : %typemap(in) SWIGTYPE []
    +example.h:3: Typemap for Row4 rows[10] (typecheck) : %typemap(typecheck) SWIGTYPE *
    +example.h:3: Typemap for Row4 rows[10] (freearg) : %typemap(freearg) SWIGTYPE []
    +example.h:3: Typemap for void foo (out) : %typemap(out) void
    +
    +
    +

    Now, consider the following interface file:

    -%typemap(out) float [ANY] {
    -  int i;
    -  $result = PyList_New($1_dim0);
    -  for (i = 0; i < $1_dim0; i++) {
    -    PyObject *o = PyFloat_FromDouble((double) $1[i]);
    -    PyList_SetItem($result,i,o);
    +%module example
    +
    +%{
    +void set_value(const char* val) {}
    +%}
    +
    +%typemap(check) char *NON_NULL {
    +  if (!$1) {
    +    /* ... error handling ... */
       }
     }
    +
    +// use default pointer handling instead of strings
    +%apply SWIGTYPE * { const char* val, const char* another_value }
    +
    +%typemap(check) const char* val = char* NON_NULL;
    +
    +%typemap(arginit, noblock=1) const char* val {
    +   $1 = "";
    +}
    +
    +void set_value(const char* val);
    +
     
    -

    Now, you will find that member access is quite nice:

    -
    +

    and the output debug:

    +
    ->>> s = SomeObject()
    ->>> s.x = [1, 2.5, 5, 10]
    ->>> print s.x
    -[ 1, 2.5, 5, 10]
    +swig -perl5 -debug-tmused example.i
    +example.i:21: Typemap for char const *val (arginit) : %typemap(arginit) char const *val
    +example.i:21: Typemap for char const *val (in) : %apply SWIGTYPE * { char const *val }
    +example.i:21: Typemap for char const *val (typecheck) : %apply SWIGTYPE * { char const *val }
    +example.i:21: Typemap for char const *val (check) : %typemap(check) char const *val = char *NON_NULL
    +example.i:21: Typemap for char const *val (freearg) : %apply SWIGTYPE * { char const *val }
    +example.i:21: Typemap for void set_value (out) : %typemap(out) void
     
    -

    Compatibility Note: SWIG1.1 used to provide a special - "memberout" typemap. However, it was mostly useless and has since been - eliminated. To return structure members, simply use the "out" typemap.

    -

    10.6.2 Implementing constraints with - typemaps

    -

    One particularly interesting application of typemaps is the - implementation of argument constraints. This can be done with the - "check" typemap. When used, this allows you to provide code for - checking the values of function arguments. For example:

    +

    The following observations about what is displayed can be noted (the + same applies for -debug-tmsearch):

    +
      +
    • The relevant typemap is shown, but for typemap copying, the + appropriate %typemap or %apply is displayed, for + example, the "check" and "in" typemaps.
    • +
    • The typemap modifiers are not shown, eg the noblock=1 + modifier in the "arginit" typemap.
    • +
    • The exact %apply statement might look different to what is + in the actual code. For example, the const char* another_value + is not shown as it is not relevant here. Also the types may be + displayed slightly differently - char const * and not +const char*.
    • +
    +

    11.4 Code generation rules

    +

    This section describes rules by which typemap code is inserted into + the generated wrapper code.

    +

    11.4.1 Scope

    +

    When a typemap is defined like this:

    -%module math
    -
    -%typemap(check) double posdouble {
    -	if ($1 < 0) {
    -		croak("Expecting a positive number");
    -	}
    +%typemap(in) int {
    +   $1 = PyInt_AsLong($input);
     }
    -
    -...
    -double sqrt(double posdouble);
    -
     
    -

    This provides a sanity check to your wrapper function. If a negative - number is passed to this function, a Perl exception will be raised and - your program terminated with an error message.

    -

    This kind of checking can be particularly useful when working with - pointers. For example:

    +

    the typemap code is inserted into the wrapper function using a new + block scope. In other words, the wrapper code will look like this:

    -%typemap(check) Vector * {
    -    if ($1 == 0) {
    -        PyErr_SetString(PyExc_TypeError,"NULL Pointer not allowed");
    -        return NULL;
    -   }
    +wrap_whatever() {
    +    ...
    +    // Typemap code
    +    {                    
    +       arg1 = PyInt_AsLong(obj1);
    +    }
    +    ...
     }
    -
     
    -

    will prevent any function involving a Vector * from - accepting a NULL pointer. As a result, SWIG can often prevent a - potential segmentation faults or other run-time problems by raising an - exception rather than blindly passing values to the underlying C/C++ - program.

    -

    10.7 Typemaps for multiple target - languages

    -

    The code within typemaps is usually language dependent, however, - many target languages support the same typemaps. In order to - distinguish typemaps across different languages, the preprocessor - should be used. For example, the "in" typemap for Perl and Ruby could - be written as:

    +

    Because the typemap code is enclosed in its own block, it is legal + to declare temporary variables for use during typemap execution. For + example:

    -#if defined(SWIGPERL)
    -  %typemap(in) int "$1 = ($1_ltype) SvIV($input);"
    -#elif defined(SWIGRUBY)
    -  %typemap(in) int "$1 = NUM2INT($input);"
    -#else
    -  #warning no "in" typemap defined
    -#endif
    +%typemap(in) short {
    +   long temp;          /* Temporary value */
    +   if (Tcl_GetLongFromObj(interp, $input, &temp) != TCL_OK) {
    +      return TCL_ERROR;
    +   }
    +   $1 = (short) temp;
    +}
     
    -

    The full set of language specific macros is defined in the -Conditional Compilation section. The example above also shows a - common approach of issuing a warning for an as yet unsupported - language.

    -

    Compatibility note: In SWIG-1.1 different languages could be - distinguished with the language name being put within the %typemap - directive, for example, -
    %typemap(ruby,in) int "$1 = NUM2INT($input);".

    -

    10.8 Optimal code generation when - returning by value

    -

    The "out" typemap is the main typemap for return types. This typemap - supports an optional attribute flag called "optimal", which is for - reducing temporary variables and the amount of generated code, thereby - giving the compiler the opportunity to use return value optimization - for generating faster executing code. It only really makes a difference - when returning objects by value and has some limitations on usage, as - explained later on.

    -

    When a function returns an object by value, SWIG generates code that - instantiates the default type on the stack then assigns the value - returned by the function call to it. A copy of this object is then made - on the heap and this is what is ultimately stored and used from the - target language. This will be clearer considering an example. Consider - running the following code through SWIG:

    +

    Of course, any variables that you declare inside a typemap are + destroyed as soon as the typemap code has executed (they are not + visible to other parts of the wrapper function or other typemaps that + might use the same variable names).

    +

    Occasionally, typemap code will be specified using a few alternative + forms. For example:

    -%typemap(out) SWIGTYPE %{
    -  $result = new $1_ltype((const $1_ltype &)$1);
    -%}
    -
    -%inline %{
    -#include <iostream>
    -using namespace std;
    -
    -struct XX {
    -  XX() { cout << "XX()" << endl; }
    -  XX(int i) { cout << "XX(" << i << ")" << endl; }
    -  XX(const XX &other) { cout << "XX(const XX &)" << endl; }
    -  XX & operator =(const XX &other) { cout << "operator=(const XX &)" << endl; return *this; }
    -  ~XX() { cout << "~XX()" << endl; }
    -  static XX create() { 
    -    return XX(0);
    -  }
    -};
    +%typemap(in) int "$1 = PyInt_AsLong($input);";
    +%typemap(in) int %{
    +$1 = PyInt_AsLong($input);
     %}
    +%typemap(in, noblock=1) int {
    +$1 = PyInt_AsLong($input);
    +}
     
    -

    The "out" typemap shown is the default typemap for C# when returning - objects by value. When making a call to XX::create() from C#, - the output is as follows:

    -
    -
    -XX()
    -XX(0)
    -operator=(const XX &)
    -~XX()
    -XX(const XX &)
    -~XX()
    -~XX()
    -
    -
    -

    Note that three objects are being created as well as an assignment. - Wouldn't it be great if the XX::create() method was the only - time a constructor was called? As the method returns by value, this is - asking a lot and the code that SWIG generates by default makes it - impossible for the compiler to use return value optimisation (RVO) -. However, this is where the "optimal" attribute in the "out" typemap - can help out. If the typemap code is kept the same and just the - "optimal" attribute specified like this:

    +

    These three forms are mainly used for cosmetics--the specified code + is not enclosed inside a block scope when it is emitted. This sometimes + results in a less complicated looking wrapper function. Note that only + the third of the three typemaps have the typemap code passed through + the SWIG preprocessor.

    +

    11.4.2 Declaring new local variables

    +

    Sometimes it is useful to declare a new local variable that exists + within the scope of the entire wrapper function. A good example of this + might be an application in which you wanted to marshal strings. Suppose + you had a C++ function like this

    -%typemap(out, optimal="1") SWIGTYPE %{
    -  $result = new $1_ltype((const $1_ltype &)$1);
    -%}
    +int foo(std::string *s);
     
    -

    then when the code is run again, the output is simply:

    +

    and you wanted to pass a native string in the target language as an + argument. For instance, in Perl, you wanted the function to work like + this:

    -XX(0)
    -~XX()
    +$x = foo("Hello World");
     
    -

    How the "optimal" attribute works is best explained using the - generated code. Without "optimal", the generated code is:

    +

    To do this, you can't just pass a raw Perl string as the +std::string * argument. Instead, you have to create a temporary +std::string object, copy the Perl string data into it, and then + pass a pointer to the object. To do this, simply specify the typemap + with an extra parameter like this:

    -SWIGEXPORT void * SWIGSTDCALL CSharp_XX_create() {
    -  void * jresult ;
    -  XX result;
    -  result = XX::create();
    -  jresult = new XX((const XX &)result);
    -  return jresult;
    +%typemap(in) std::string * (std::string temp) {
    +    unsigned int len;
    +    char        *s;
    +    s = SvPV($input,len);         /* Extract string data */
    +    temp.assign(s,len);           /* Assign to temp */
    +    $1 = &temp;                   /* Set argument to point to temp */
     }
    -
     
    -

    With the "optimal" attribute, the code is:

    +

    In this case, temp becomes a local variable in the scope of + the entire wrapper function. For example:

    -SWIGEXPORT void * SWIGSTDCALL CSharp_XX_create() {
    -  void * jresult ;
    -  jresult = new XX((const XX &)XX::create());
    -  return jresult;
    +wrap_foo() {
    +   std::string temp;    <--- Declaration of temp goes here
    +   ...
    +
    +   /* Typemap code */
    +   {
    +      ...
    +      temp.assign(s,len);
    +      ...
    +   } 
    +   ...
     }
     
    -

    The major difference is the result temporary variable - holding the value returned from XX::create() is no longer - generated and instead the copy constructor call is made directly from - the value returned by XX::create(). With modern compilers - implementing RVO, the copy is not actually done, in fact the object is - never created on the stack in XX::create() at all, it is - simply created directly on the heap. In the first instance, the $1 - special variable in the typemap is expanded into result. In - the second instance, $1 is expanded into XX::create() - and this is essentially what the "optimal" attribute is telling SWIG to - do.

    -

    The "optimal" attribute optimisation is not turned on by default as - it has a number of restrictions. Firstly, some code cannot be condensed - into a simple call for passing into the copy constructor. One common - occurrence is when %exception is - used. Consider adding the following %exception to the example:

    +

    When you set temp to a value, it persists for the duration + of the wrapper function and gets cleaned up automatically on exit.

    +

    It is perfectly safe to use more than one typemap involving local + variables in the same declaration. For example, you could declare a + function as :

    -%exception XX::create() %{
    -try {
    -  $action
    -} catch(const std::exception &e) {
    -  cout << e.what() << endl;
    -}
    -%}
    +void foo(std::string *x, std::string *y, std::string *z);
     
    -

    SWIG can detect when the "optimal" attribute cannot be used and will - ignore it and in this case will issue the following warning:

    -
    +

    This is safely handled because SWIG actually renames all local + variable references by appending an argument number suffix. Therefore, + the generated code would actually look like this:

    +
    -example.i:28: Warning 474: Method XX::create() usage of the optimal attribute ignored
    -example.i:14: Warning 474: in the out typemap as the following cannot be used to generate
    -optimal code: 
    -try {
    -  result = XX::create();
    -} catch(const std::exception &e) {
    -  cout << e.what() << endl;
    +wrap_foo() {
    +   int *arg1;    /* Actual arguments */
    +   int *arg2;
    +   int *arg3;
    +   std::string temp1;    /* Locals declared in the typemap */
    +   std::string temp2;
    +   std::string temp3;
    +   ...
    +   {
    +       char *s;
    +       unsigned int len;
    +       ...
    +       temp1.assign(s,len);
    +       arg1 = *temp1;
    +   }
    +   {
    +       char *s;
    +       unsigned int len;
    +       ...
    +       temp2.assign(s,len);
    +       arg2 = &temp2;
    +   }
    +   {
    +       char *s;
    +       unsigned int len;
    +       ...
    +       temp3.assign(s,len);
    +       arg3 = &temp3;
    +   }
    +   ...
     }
     
    -

    It should be clear that the above code cannot be used as the - argument to the copy constructor call, that is, for the $1 - substitution.

    -

    Secondly, if the typemaps uses $1 more than once, then - multiple calls to the wrapped function will be made. Obviously that is - not very optimal. In fact SWIG attempts to detect this and will issue a - warning something like:

    -
    +

    There is an exception: if the variable name starts with the +_global_ prefix, the argument number is not appended. Such + variables can be used throughout the generated wrapper function. For + example, the above typemap could be rewritten to use _global_temp + instead of temp and the generated code would then contain a + single _global_temp variable instead of temp1, +temp2 and temp3:

    +
    -example.i:21: Warning 475: Multiple calls to XX::create() might be generated due to
    -example.i:7: Warning 475: optimal attribute usage in the out typemap.
    +%typemap(in) std::string * (std::string _global_temp) {
    + ... as above ...
    +}
     
    -

    However, it doesn't always get it right, for example when $1 - is within some commented out code.

    -

    10.9 Multi-argument - typemaps

    -

    So far, the typemaps presented have focused on the problem of - dealing with single values. For example, converting a single input - object to a single argument in a function call. However, certain - conversion problems are difficult to handle in this manner. As an - example, consider the example at the very beginning of this chapter:

    +

    Some typemaps do not recognize local variables (or they may simply + not apply). At this time, only typemaps that apply to argument + conversion support this (input typemaps such as the "in" typemap).

    +

    Note:

    +

    When declaring a typemap for multiple types, each type must have its + own local variable declaration.

    -int foo(int argc, char *argv[]);
    +%typemap(in) const std::string *, std::string * (std::string temp) // NO!
    +// only std::string * has a local variable
    +// const std::string * does not (oops)
    +....
    +
    +%typemap(in) const std::string * (std::string temp), std::string * (std::string temp) // Correct
    +....
     
    -

    Suppose that you wanted to wrap this function so that it accepted a - single list of strings like this:

    -
    +

    11.4.3 Special variables

    +

    Within all typemaps, the following special variables are expanded. + This is by no means a complete list as some target languages have + additional special variables which are documented in the language + specific chapters.

    +
    + + + + + + + + + + + + + + + + + + + + +
    VariableMeaning
    $n A C local variable corresponding to type + n in the typemap pattern.
    $argnumArgument number. Only available in typemaps + related to argument conversion
    $n_nameArgument name
    $n_typeReal C datatype of type n.
    $n_ltypeltype of type n
    $n_mangleMangled form of type n. For + example _p_Foo
    $n_descriptorType descriptor structure for + type n. For example SWIGTYPE_p_Foo. This is primarily + used when interacting with the run-time type checker (described later).
    $*n_typeReal C datatype of type n + with one pointer removed.
    $*n_ltypeltype of type n with one + pointer removed.
    $*n_mangleMangled form of type n with + one pointer removed.
    $*n_descriptorType descriptor structure for + type n with one pointer removed.
    $&n_typeReal C datatype of type n + with one pointer added.
    $&n_ltypeltype of type n with one + pointer added.
    $&n_mangleMangled form of type n with + one pointer added.
    $&n_descriptorType descriptor structure for + type n with one pointer added.
    $n_basetypeBase typename with all pointers and + qualifiers stripped.
    +
    +

    Within the table, $n refers to a specific type within the + typemap specification. For example, if you write this

    +
    ->>> foo(["ale","lager","stout"])
    +%typemap(in) int *INPUT {
    +
    +}
     
    -

    To do this, you not only need to map a list of strings to char - *argv[], but the value of int argc is implicitly - determined by the length of the list. Using only simple typemaps, this - type of conversion is possible, but extremely painful. Multi-argument - typemaps help in this situation.

    -

    A multi-argument typemap is a conversion rule that specifies how to - convert a single object in the target language to a set of - consecutive function arguments in C/C++. For example, the following - multi-argument maps perform the conversion described for the above - example:

    +

    then $1 refers to int *INPUT. If you have a typemap like + this,

     %typemap(in) (int argc, char *argv[]) {
    -  int i;
    -  if (!PyList_Check($input)) {
    -    PyErr_SetString(PyExc_ValueError, "Expecting a list");
    -    return NULL;
    -  }
    -  $1 = PyList_Size($input);
    -  $2 = (char **) malloc(($1+1)*sizeof(char *));
    -  for (i = 0; i < $1; i++) {
    -    PyObject *s = PyList_GetItem($input,i);
    -    if (!PyString_Check(s)) {
    -        free($2);
    -        PyErr_SetString(PyExc_ValueError, "List items must be strings");
    -        return NULL;
    -    }
    -    $2[i] = PyString_AsString(s);
    -  }
    -  $2[i] = 0;
    -}
    -
    -%typemap(freearg) (int argc, char *argv[]) {
    -   if ($2) free($2);
    +  ...
     }
     
    -

    A multi-argument map is always specified by surrounding the - arguments with parentheses as shown. For example:

    +

    then $1 refers to int argc and $2 refers to char + *argv[].

    +

    Substitutions related to types and names always fill in values from + the actual code that was matched. This is useful when a typemap might + match multiple C datatype. For example:

    -%typemap(in) (int argc, char *argv[]) { ... }
    +%typemap(in)  int, short, long {
    +   $1 = ($1_ltype) PyInt_AsLong($input);
    +}
     
    -

    Within the typemap code, the variables $1, $2, and - so forth refer to each type in the map. All of the usual substitutions - apply--just use the appropriate $1 or $2 prefix on - the variable name (e.g., $2_type, $1_ltype, etc.)

    -

    Multi-argument typemaps always have precedence over simple typemaps - and SWIG always performs longest-match searching. Therefore, you will - get the following behavior:

    -
    +

    In this case, $1_ltype is replaced with the datatype that + is actually matched.

    +

    When typemap code is emitted, the C/C++ datatype of the special + variables $1 and $2 is always an "ltype." An "ltype" + is simply a type that can legally appear on the left-hand side of a C + assignment operation. Here are a few examples of types and ltypes:

    +
    -%typemap(in) int argc                              { ... typemap 1 ... }
    -%typemap(in) (int argc, char *argv[])              { ... typemap 2 ... }
    -%typemap(in) (int argc, char *argv[], char *env[]) { ... typemap 3 ... }
    -
    -int foo(int argc, char *argv[]);                   // Uses typemap 2
    -int bar(int argc, int x);                          // Uses typemap 1
    -int spam(int argc, char *argv[], char *env[]);     // Uses typemap 3
    +type              ltype
    +------            ----------------
    +int               int
    +const int         int
    +const int *       int *
    +int [4]           int *
    +int [4][5]        int (*)[5]
     
    -

    It should be stressed that multi-argument typemaps can appear - anywhere in a function declaration and can appear more than once. For - example, you could write this:

    +

    In most cases a ltype is simply the C datatype with qualifiers + stripped off. In addition, arrays are converted into pointers.

    +

    Variables such as $&1_type and $*1_type are used + to safely modify the type by removing or adding pointers. Although not + needed in most typemaps, these substitutions are sometimes needed to + properly work with typemaps that convert values between pointers and + values.

    +

    If necessary, type related substitutions can also be used when + declaring locals. For example:

    -%typemap(in) (int scount, char *swords[]) { ... }
    -%typemap(in) (int wcount, char *words[]) { ... }
    -
    -void search_words(int scount, char *swords[], int wcount, char *words[], int maxcount);
    +%typemap(in) int * ($*1_type temp) {
    +    temp = PyInt_AsLong($input);
    +    $1 = &temp;
    +}
     
    -

    Other directives such as %apply and %clear also - work with multi-argument maps. For example:

    +

    There is one word of caution about declaring local variables in this + manner. If you declare a local variable using a type substitution such + as $1_ltype temp, it won't work like you expect for arrays and + certain kinds of pointers. For example, if you wrote this,

    -%apply (int argc, char *argv[]) {
    -    (int scount, char *swords[]),
    -    (int wcount, char *words[])
    -};
    -...
    -%clear (int scount, char *swords[]), (int wcount, char *words[]);
    -...
    +%typemap(in) int [10][20] {
    +   $1_ltype temp;
    +}
     
    -

    Although multi-argument typemaps may seem like an exotic, little - used feature, there are several situations where they make sense. - First, suppose you wanted to wrap functions similar to the low-level -read() and write() system calls. For example:

    +

    then the declaration of temp will be expanded as

    -typedef unsigned int size_t;
    -
    -int read(int fd, void *rbuffer, size_t len);
    -int write(int fd, void *wbuffer, size_t len);
    +int (*)[20] temp;
     
    -

    As is, the only way to use the functions would be to allocate memory - and pass some kind of pointer as the second argument---a process that - might require the use of a helper function. However, using - multi-argument maps, the functions can be transformed into something - more natural. For example, you might write typemaps like this:

    +

    This is illegal C syntax and won't compile. There is currently no + straightforward way to work around this problem in SWIG due to the way + that typemap code is expanded and processed. However, one possible + workaround is to simply pick an alternative type such as void * + and use casts to get the correct type when needed. For example:

    -// typemap for an outgoing buffer
    -%typemap(in) (void *wbuffer, size_t len) {
    -   if (!PyString_Check($input)) {
    -       PyErr_SetString(PyExc_ValueError, "Expecting a string");
    -       return NULL;
    -   }
    -   $1 = (void *) PyString_AsString($input);
    -   $2 = PyString_Size($input);
    -}
    -
    -// typemap for an incoming buffer
    -%typemap(in) (void *rbuffer, size_t len) {
    -   if (!PyInt_Check($input)) {
    -       PyErr_SetString(PyExc_ValueError, "Expecting an integer");
    -       return NULL;
    -   }
    -   $2 = PyInt_AsLong($input);
    -   if ($2 < 0) {
    -       PyErr_SetString(PyExc_ValueError, "Positive integer expected");
    -       return NULL;
    -   }
    -   $1 = (void *) malloc($2);
    +%typemap(in) int [10][20] {
    +   void *temp;
    +   ...
    +   (($1_ltype) temp)[i][j] = x;    /* set a value */
    +   ...
     }
    -
    -// Return the buffer.  Discarding any previous return result
    -%typemap(argout) (void *rbuffer, size_t len) {
    -   Py_XDECREF($result);   /* Blow away any previous result */
    -   if (result < 0) {      /* Check for I/O error */
    -       free($1);
    -       PyErr_SetFromErrno(PyExc_IOError);
    -       return NULL;
    -   }
    -   $result = PyString_FromStringAndSize($1,result);
    -   free($1);
    +
    +
    +

    Another approach, which only works for arrays is to use the +$1_basetype substitution. For example:

    +
    +
    +%typemap(in) int [10][20] {
    +   $1_basetype temp[10][20];
    +   ...
    +   temp[i][j] = x;    /* set a value */
    +   ...
     }
     
    -

    (note: In the above example, $result and result - are two different variables. result is the real C datatype - that was returned by the function. $result is the scripting - language object being returned to the interpreter.).

    -

    Now, in a script, you can write code that simply passes buffers as - strings like this:

    -
    +

    11.4.4 Special variable + macros

    +

    Special variable macros are like macro functions in that they take + one or more input arguments which are used for the macro expansion. + They look like macro/function calls but use the special variable $ + prefix to the macro name. Note that unlike normal macros, the expansion + is not done by the preprocessor, it is done during the SWIG + parsing/compilation stages. The following special variable macros are + available across all language modules.

    +

    11.4.4.1 + $descriptor(type)

    +

    This macro expands into the type descriptor structure for any C/C++ + type specified in type. It behaves like the $1_descriptor + special variable described above except that the type to expand is + taken from the macro argument rather than inferred from the typemap + type. For example, $descriptor(std::vector<int> *) will expand + into SWIGTYPE_p_std__vectorT_int_t. This macro is mostly used + in the scripting target languages and is demonstrated later in the +Run-time type checker usage section.

    +

    11.4.4.2 $typemap(method, + typepattern)

    +

    This macro uses the pattern + matching rules described earlier to lookup and then substitute the + special variable macro with the code in the matched typemap. The + typemap to search for is specified by the arguments, where method + is the typemap method name and typepattern is a type pattern + as per the %typemap specification in the +Defining a typemap section.

    +

    The special variables within the matched typemap are expanded into + those for the matched typemap type, not the typemap within which the + macro is called. In practice, there is little use for this macro in the + scripting target languages. It is mostly used in the target languages + that are statically typed as a way to obtain the target language type + given the C/C++ type and more commonly only when the C++ type is a + template parameter.

    +

    The example below is for C# only and uses some typemap method names + documented in the C# chapter, but it shows some of the possible syntax + variations.

    +
    ->>> f = example.open("Makefile")
    ->>> example.read(f,40)
    -'TOP        = ../..\nSWIG       = $(TOP)/.'
    ->>> example.read(f,40)
    -'./swig\nSRCS       = example.c\nTARGET    '
    ->>> example.close(f)
    -0
    ->>> g = example.open("foo", example.O_WRONLY | example.O_CREAT, 0644)
    ->>> example.write(g,"Hello world\n")
    -12
    ->>> example.write(g,"This is a test\n")
    -15
    ->>> example.close(g)
    -0
    ->>>
    +%typemap(cstype) unsigned long    "uint"
    +%typemap(cstype) unsigned long bb "bool"
    +%typemap(cscode) BarClass %{
    +  void foo($typemap(cstype, unsigned long aa) var1,
    +           $typemap(cstype, unsigned long bb) var2,
    +           $typemap(cstype, (unsigned long bb)) var3,
    +           $typemap(cstype, unsigned long) var4)
    +  {
    +    // do something
    +  }
    +%}
     
    -

    A number of multi-argument typemap problems also arise in libraries - that perform matrix-calculations--especially if they are mapped onto - low-level Fortran or C code. For example, you might have a function - like this:

    +

    The result is the following expansion

    -int is_symmetric(double *mat, int rows, int columns);
    +%typemap(cstype) unsigned long    "uint"
    +%typemap(cstype) unsigned long bb "bool"
    +%typemap(cscode) BarClass %{
    +  void foo(uint var1,
    +           bool var2,
    +           bool var3,
    +           uint var4)
    +  {
    +    // do something
    +  }
    +%}
     
    -

    In this case, you might want to pass some kind of higher-level - object as an matrix. To do this, you could write a multi-argument - typemap like this:

    +

    11.4.5 Special + variables and typemap attributes

    +

    As of SWIG-3.0.7 typemap attributes will also expand special + variables and special variable macros.

    +

    Example usage showing the expansion in the 'out' attribute (C# + specific) as well as the main typemap body:

    -%typemap(in) (double *mat, int rows, int columns) {
    -    MatrixObject *a;
    -    a = GetMatrixFromObject($input);     /* Get matrix somehow */
    -
    -    /* Get matrix properties */
    -    $1 = GetPointer(a);
    -    $2 = GetRows(a);
    -    $3 = GetColumns(a);
    -}
    +%typemap(ctype, out="$*1_ltype") unsigned int& "$*1_ltype"
     
    -

    This kind of technique can be used to hook into scripting-language - matrix packages such as Numeric Python. However, it should also be - stressed that some care is in order. For example, when crossing - languages you may need to worry about issues such as row-major vs. - column-major ordering (and perform conversions if needed). Note that - multi-argument typemaps cannot deal with non-consecutive C/C++ - arguments; a workaround such as a helper function re-ordering the - arguments to make them consecutive will need to be written.

    -

    10.10 Typemap warnings

    -

    Warnings can be added to typemaps so that SWIG generates a warning - message whenever the typemap is used. See the information in the -issuing warnings section.

    -

    10.11 Typemap fragments

    -

    The primary purpose of fragments is to reduce code bloat that - repeated use of typemap code can lead to. Fragments are snippets of - code that can be thought of as code dependencies of a typemap. If a - fragment is used by more than one typemap, then the snippet of code - within the fragment is only generated once. Code bloat is typically - reduced by moving typemap code into a support function and then placing - the support function into a fragment.

    -

    For example, if you have a very long typemap

    +

    is equivalent to the following as $*1_ltype expands to +unsigned int:

    -%typemap(in) MyClass * {
    -  MyClass *value = 0;
    -
    -  ... many lines of marshalling code  ...
    -
    -  $result = value;
    -}
    +%typemap(ctype, out="unsigned int") unsigned int& "unsigned int"
     
    -

    the same marshalling code is often repeated in several typemaps, - such as "in", "varin", "directorout", etc. SWIG copies the code for - each argument that requires the typemap code, easily leading to code - bloat in the generated code. To eliminate this, define a fragment that - includes the common marshalling code:

    +

    11.4.6 Special + variables combined with special variable macros

    +

    Special variables can also be used within special variable macros. + The special variables are expanded before they are used in the special + variable macros.

    +

    Consider the following C# typemaps:

    -%fragment("AsMyClass", "header") {
    -  MyClass *AsMyClass(PyObject *obj) {
    -    MyClass *value = 0;
    -
    -    ... many lines of marshalling code  ...
    -
    -    return value;
    -  }
    -}
    -
    -%typemap(in, fragment="AsMyClass") MyClass * {
    -  $result = AsMyClass($input);
    -}
    -
    -%typemap(varin, fragment="AsMyClass") MyClass * {
    -  $result = AsMyClass($input);
    -}
    +%typemap(cstype) unsigned int "uint"
    +%typemap(cstype, out="$typemap(cstype, $*1_ltype)") unsigned int& "$typemap(cstype, $*1_ltype)"
     
    -

    When the "in" or "varin" typemaps for MyClass are required, the - contents of the fragment called "AsMyClass" is added to the "header" - section within the generated code, and then the typemap code is - emitted. Hence, the method AsMyClass will be generated into - the wrapper code before any typemap code that calls it.

    -

    To define a fragment you need a fragment name, a section name for - generating the fragment code into, and the code itself. See -Code insertion blocks for a full list of section names. Usually the - section name used is "header". Different delimiters can be used:

    +

    Special variables are expanded first and hence the above is + equivalent to:

    -%fragment("my_name", "header") %{ ... %}
    -%fragment("my_name", "header") { ... }
    -%fragment("my_name", "header") " ... "
    +%typemap(cstype) unsigned int "uint"
    +%typemap(cstype, out="$typemap(cstype, unsigned int)") unsigned int& "$typemap(cstype, unsigned int)"
     
    -

    and these follow the usual preprocessing rules mentioned in the -Preprocessing delimiters section. The following are some rules and - guidelines for using fragments:

    -
      -
    1. -

      A fragment is added to the wrapping code only once. When using the -MyClass * typemaps above and wrapping the method:

      +

      which then expands to:

      -void foo(MyClass *a, MyClass *b);
      +%typemap(cstype) unsigned int "uint"
      +%typemap(cstype, out="uint") unsigned int& "uint"
       
      -

      the generated code will look something like:

      +

      11.5 Common typemap methods

      +

      The set of typemaps recognized by a language module may vary. + However, the following typemap methods are nearly universal:

      +

      11.5.1 "in" typemap

      +

      The "in" typemap is used to convert function arguments from the + target language to C. For example:

      -MyClass *AsMyClass(PyObject *obj) {
      -  ...
      -}
      -
      -void _wrap_foo(...) {
      -  ....
      -  arg1 = AsMyClass(obj1);
      -  arg2 = AsMyClass(obj2);
      -  ...
      -  foo(arg1, arg2);
      +%typemap(in) int {
      +   $1 = PyInt_AsLong($input);
       }
       
      -

      even as there is duplicated typemap code to process both a - and b, the AsMyClass method will be defined only - once.

      -
    2. -
    3. -

      A fragment should only be defined once. If there is more than one - definition, the first definition is the one used. All other definitions - are silently ignored. For example, if you have

      +

      The following special variables are available:

      -%fragment("AsMyClass", "header") { ...definition 1... }
      -....
      -%fragment("AsMyClass", "header") { ...definition 2... }
      +$input            - Input object holding value to be converted.
      +$symname          - Name of function/method being wrapped
       
      -

      only the first definition is used. In this way you can override the - default fragments in a SWIG library by defining your fragment before - the library %include. Note that this behavior is the opposite - to typemaps, where the last typemap defined/applied prevails. Fragments - follow the first-in-first-out convention since they are intended to be - global, while typemaps are intended to be locally specialized.

      -
    4. -
    5. -

      Fragment names cannot contain commas.

      -
    6. -
    7. -

      A fragment can use one or more additional fragments, for example:

      +

      This is probably the most commonly redefined typemap because it can + be used to implement customized conversions.

      +

      In addition, the "in" typemap allows the number of converted + arguments to be specified. The numinputs attributes + facilitates this. For example:

      -%fragment("<limits.h>", "header") {
      -  %#include <limits.h>
      -}
      -
      -
      -%fragment("AsMyClass", "header", fragment="<limits.h>") {
      -  MyClass *AsMyClass(PyObject *obj) {
      -    MyClass *value = 0;
      -
      -    ... some marshalling code  ...
      -
      -    if  (ival < CHAR_MIN /*defined in <limits.h>*/) {
      -       ...
      -    } else {
      -       ...
      -    }
      -    ...
      -    return value;
      -  }
      +// Ignored argument.
      +%typemap(in, numinputs=0) int *out (int temp) {
      +    $1 = &temp;
       }
       
      -

      in this case, when the "AsMyClass" fragment is emitted, it also - triggers the inclusion of the "<limits.h>" fragment.

      -
    8. -
    9. -

      A fragment can have dependencies on a number of other fragments, for - example:

      +

      At this time, only zero or one arguments may be converted. When +numinputs is set to 0, the argument is effectively ignored and + cannot be supplied from the target language. The argument is still + required when making the C/C++ call and the above typemap shows the + value used is instead obtained from a locally declared variable called +temp. Usually numinputs is not specified, whereupon the + default value is 1, that is, there is a one to one mapping of the + number of arguments when used from the target language to the C/C++ + call. Multi-argument + typemaps provide a similar concept where the number of arguments + mapped from the target language to C/C++ can be changed for multiple + adjacent C/C++ arguments.

      +

      Compatibility note: Specifying numinputs=0 is the + same as the old "ignore" typemap.

      +

      11.5.2 "typecheck" typemap

      +

      The "typecheck" typemap is used to support overloaded functions and + methods. It merely checks an argument to see whether or not it matches + a specific type. For example:

      -%fragment("bigfragment", "header", fragment="frag1", fragment="frag2", fragment="frag3") "";
      +%typemap(typecheck,precedence=SWIG_TYPECHECK_INTEGER) int {
      +   $1 = PyInt_Check($input) ? 1 : 0;
      +}
       
      -

      When the "bigfragment" is used, the three dependent fragments - "frag1", "frag2" and "frag3" are also pulled in. Note that as - "bigframent" is empty (the empty string - ""), it does not add any code - itself, but merely triggers the inclusion of the other fragments.

      -
    10. -
    11. -

      A typemap can also use more than one fragment, but since the syntax - is different, you need to specify the dependent fragments in a comma - separated list. Consider:

      +

      For typechecking, the $1 variable is always a simple integer that is + set to 1 or 0 depending on whether or not the input argument is the + correct type.

      +

      If you define new "in" typemaps and your program uses + overloaded methods, you should also define a collection of "typecheck" + typemaps. More details about this follow in the +Typemaps and overloading section.

      +

      11.5.3 "out" typemap

      +

      The "out" typemap is used to convert function/method return values + from C into the target language. For example:

      -%typemap(in, fragment="frag1,frag2,frag3") {...}
      +%typemap(out) int {
      +   $result = PyInt_FromLong($1);
      +}
       
      -

      which is equivalent to:

      +

      The following special variables are available.

      -%typemap(in, fragment="bigfragment") {...}
      +$result           - Result object returned to target language.
      +$symname          - Name of function/method being wrapped
       
      -

      when used with the "bigfragment" defined above.

      -
    12. -
    13. -

      Finally, you can force the inclusion of a fragment at any point in - the generated code as follows:

      +

      The "out" typemap supports an optional attribute flag called + "optimal". This is for code optimisation and is detailed in the +Optimal code generation when returning by value section.

      +

      11.5.4 "arginit" typemap

      +

      The "arginit" typemap is used to set the initial value of a function + argument--before any conversion has occurred. This is not normally + necessary, but might be useful in highly specialized applications. For + example:

      -%fragment("bigfragment");
      +// Set argument to NULL before any conversion occurs
      +%typemap(arginit) int *data {
      +   $1 = NULL;
      +}
       
      -

      which is very useful inside a template class, for example.

      -
    14. -
    -

    Most readers will probably want to skip the next two sub-sections on - advanced fragment usage unless a desire to really get to grips with - some powerful but tricky macro and fragment usage that is used in parts - of the SWIG typemap library.

    -

    10.11.1 Fragment - type specialization

    -

    Fragments can be type specialized. The syntax is as follows:

    +

    11.5.5 "default" typemap

    +

    The "default" typemap is used to turn an argument into a default + argument. For example:

    -%fragment("name", "header") { ...a type independent fragment... }
    -%fragment("name"{type}, "header") { ...a type dependent fragment...  }
    +%typemap(default) int flags {
    +   $1 = DEFAULT_FLAGS;
    +}
    +...
    +int foo(int x, int y, int flags);
     
    -

    where type is a C/C++ type. Like typemaps, fragments can - also be used inside templates, for example:

    +

    The primary use of this typemap is to either change the wrapping of + default arguments or specify a default argument in a language where + they aren't supported (like C). Target languages that do not support + optional arguments, such as Java and C#, effectively ignore the value + specified by this typemap as all arguments must be given.

    +

    Once a default typemap has been applied to an argument, all + arguments that follow must have default values. See the +Default/optional arguments section for further information on + default argument wrapping.

    +

    11.5.6 "check" typemap

    +

    The "check" typemap is used to supply value checking code during + argument conversion. The typemap is applied after arguments + have been converted. For example:

    -template <class T>
    -struct A {
    -  %fragment("incode"{A<T>}, "header") {
    -    ... 'incode' specialized fragment ...
    -  }
    -
    -  %typemap(in, fragment="incode"{A<T>}) {
    -     ... here we use the 'type specialized' fragment "incode"{A<T>} ...
    -  }
    -};
    +%typemap(check) int positive {
    +   if ($1 <= 0) {
    +       SWIG_exception(SWIG_ValueError,"Expected positive value.");
    +   }
    +}
     
    -

    10.11.2 Fragments - and automatic typemap specialization

    -

    Since fragments can be type specialized, they can be elegantly used - to specialize typemaps. For example, if you have something like:

    +

    11.5.7 "argout" typemap

    +

    The "argout" typemap is used to return values from arguments. This + is most commonly used to write wrappers for C/C++ functions that need + to return multiple values. The "argout" typemap is almost always + combined with an "in" typemap---possibly to ignore the input value. For + example:

    -%fragment("incode"{float}, "header") {
    -  float in_method_float(PyObject *obj) {
    -    ...
    -  }
    -}
    -
    -%fragment("incode"{long}, "header") {
    -  float in_method_long(PyObject *obj) {
    -    ...
    -  }
    +/* Set the input argument to point to a temporary variable */
    +%typemap(in, numinputs=0) int *out (int temp) {
    +   $1 = &temp;
     }
     
    -// %my_typemaps macro definition
    -%define %my_typemaps(Type) 
    -%typemap(in, fragment="incode"{Type}) Type {
    -  value = in_method_##Type(obj);
    +%typemap(argout) int *out {
    +   // Append output value $1 to $result
    +   ...
     }
    -%enddef
    -
    -%my_typemaps(float);
    -%my_typemaps(long);
     
    -

    then the proper "incode"{float} or "incode"{long} - fragment will be used, and the in_method_float and -in_method_long methods will be called whenever the float - or long types are used as input parameters.

    -

    This feature is used a lot in the typemaps shipped in the SWIG - library for some scripting languages. The interested (or very brave) - reader can take a look at the fragments.swg file shipped with SWIG to - see this in action.

    -

    10.12 The run-time type - checker

    -

    Most scripting languages need type information at run-time. This - type information can include how to construct types, how to garbage - collect types, and the inheritance relationships between types. If the - language interface does not provide its own type information storage, - the generated SWIG code needs to provide it.

    -

    Requirements for the type system:

    -
      -
    • Store inheritance and type equivalence information and be able to - correctly re-create the type pointer.
    • -
    • Share type information between modules.
    • -
    • Modules can be loaded in any order, irregardless of actual type - dependency.
    • -
    • Avoid the use of dynamically allocated memory, and library/system - calls in general.
    • -
    • Provide a reasonably fast implementation, minimizing the lookup time - for all language modules.
    • -
    • Custom, language specific information can be attached to types.
    • -
    • Modules can be unloaded from the type system.
    • -
    -

    10.12.1 Implementation

    -

    The run-time type checker is used by many, but not all, of SWIG's - supported target languages. The run-time type checker features are not - required and are thus not used for statically typed languages such as - Java and C#. The scripting and scheme based languages rely on it and it - forms a critical part of SWIG's operation for these languages.

    -

    When pointers, arrays, and objects are wrapped by SWIG, they are - normally converted into typed pointer objects. For example, an instance - of Foo * might be a string encoded like this:

    +

    The following special variables are available.

    -_108e688_p_Foo
    +$result           - Result object returned to target language.
    +$input            - The original input object passed.
    +$symname          - Name of function/method being wrapped
     
    -

    At a basic level, the type checker simply restores some type-safety - to extension modules. However, the type checker is also responsible for - making sure that wrapped C++ classes are handled correctly---especially - when inheritance is used. This is especially important when an - extension module makes use of multiple inheritance. For example:

    +

    The code supplied to the "argout" typemap is always placed after the + "out" typemap. If multiple return values are used, the extra return + values are often appended to return value of the function.

    +

    See the typemaps.i library file for examples.

    +

    11.5.8 "freearg" typemap

    +

    The "freearg" typemap is used to cleanup argument data. It is only + used when an argument might have allocated resources that need to be + cleaned up when the wrapper function exits. The "freearg" typemap + usually cleans up argument resources allocated by the "in" typemap. For + example:

    -class Foo {
    -   int x;
    -};
    -
    -class Bar {
    -   int y;
    -};
    -
    -class FooBar : public Foo, public Bar {
    -   int z;
    -};
    +// Get a list of integers
    +%typemap(in) int *items {
    +   int nitems = Length($input);    
    +   $1 = (int *) malloc(sizeof(int)*nitems);
    +}
    +// Free the list 
    +%typemap(freearg) int *items {
    +   free($1);
    +}
     
    -

    When the class FooBar is organized in memory, it contains - the contents of the classes Foo and Bar as well as - its own data members. For example:

    -
    +

    The "freearg" typemap inserted at the end of the wrapper function, + just before control is returned back to the target language. This code + is also placed into a special variable $cleanup that may be + used in other typemaps whenever a wrapper function needs to abort + prematurely.

    +

    11.5.9 "newfree" typemap

    +

    The "newfree" typemap is used in conjunction with the %newobject + directive and is used to deallocate memory used by the return result of + a function. For example:

    +
    -FooBar --> | -----------|  <-- Foo
    -           |   int x    |
    -           |------------|  <-- Bar
    -           |   int y    |
    -           |------------|
    -           |   int z    |
    -           |------------|
    +%typemap(newfree) string * {
    +   delete $1;
    +}
    +%typemap(out) string * {
    +   $result = PyString_FromString($1->c_str());
    +}
    +...
    +
    +%newobject foo;
    +...
    +string *foo();
     
    -

    Because of the way that base class data is stacked together, the - casting of a Foobar * to either of the base classes may change - the actual value of the pointer. This means that it is generally not - safe to represent pointers using a simple integer or a bare void * ----type tags are needed to implement correct handling of pointer values - (and to make adjustments when needed).

    -

    In the wrapper code generated for each language, pointers are - handled through the use of special type descriptors and conversion - functions. For example, if you look at the wrapper code for Python, you - will see code like this:

    +

    See Object ownership and + %newobject for further details.

    +

    11.5.10 "memberin" typemap

    +

    The "memberin" typemap is used to copy data from an already + converted input value into a structure member. It is typically + used to handle array members and other special cases. For example:

    -if ((SWIG_ConvertPtr(obj0,(void **) &arg1, SWIGTYPE_p_Foo,1)) == -1) return NULL;
    +%typemap(memberin) int [4] {
    +   memmove($1, $input, 4*sizeof(int));
    +}
     
    -

    In this code, SWIGTYPE_p_Foo is the type descriptor that - describes Foo *. The type descriptor is actually a pointer to - a structure that contains information about the type name to use in the - target language, a list of equivalent typenames (via typedef or - inheritance), and pointer value handling information (if applicable). - The SWIG_ConvertPtr() function is simply a utility function - that takes a pointer object in the target language and a - type-descriptor objects and uses this information to generate a C++ - pointer. However, the exact name and calling conventions of the - conversion function depends on the target language (see language - specific chapters for details).

    -

    The actual type code is in swigrun.swg, and gets inserted near the - top of the generated swig wrapper file. The phrase "a type X that can - cast into a type Y" means that given a type X, it can be converted into - a type Y. In other words, X is a derived class of Y or X is a typedef - of Y. The structure to store type information looks like this:

    +

    It is rarely necessary to write "memberin" typemaps---SWIG already + provides a default implementation for arrays, strings, and other + objects.

    +

    11.5.11 "varin" typemap

    +

    The "varin" typemap is used to convert objects in the target + language to C for the purposes of assigning to a C/C++ global variable. + This is implementation specific.

    +

    11.5.12 "varout" typemap

    +

    The "varout" typemap is used to convert a C/C++ object to an object + in the target language when reading a C/C++ global variable. This is + implementation specific.

    +

    11.5.13 "throws" typemap

    +

    The "throws" typemap is only used when SWIG parses a C++ method with + an exception specification or has the %catches feature + attached to the method. It provides a default mechanism for handling + C++ methods that have declared the exceptions they will throw. The + purpose of this typemap is to convert a C++ exception into an error or + exception in the target language. It is slightly different to the other + typemaps as it is based around the exception type rather than the type + of a parameter or variable. For example:

    -/* Structure to store information on one type */
    -typedef struct swig_type_info {
    -  const char *name;             /* mangled name of this type */
    -  const char *str;              /* human readable name for this type */
    -  swig_dycast_func dcast;       /* dynamic cast function down a hierarchy */
    -  struct swig_cast_info *cast;  /* Linked list of types that can cast into this type */
    -  void *clientdata;             /* Language specific type data */
    -} swig_type_info;
    -
    -/* Structure to store a type and conversion function used for casting */
    -typedef struct swig_cast_info {
    -  swig_type_info *type;          /* pointer to type that is equivalent to this type */
    -  swig_converter_func converter; /* function to cast the void pointers */
    -  struct swig_cast_info *next;   /* pointer to next cast in linked list */
    -  struct swig_cast_info *prev;   /* pointer to the previous cast */
    -} swig_cast_info;
    +%typemap(throws) const char * %{
    +  PyErr_SetString(PyExc_RuntimeError, $1);
    +  SWIG_fail;
    +%}
    +void bar() throw (const char *);
     
    -

    Each swig_type_info stores a linked list of types that it - is equivalent to. Each entry in this doubly linked list stores a - pointer back to another swig_type_info structure, along with a pointer - to a conversion function. This conversion function is used to solve the - above problem of the FooBar class, correctly returning a pointer to the - type we want.

    -

    The basic problem we need to solve is verifying and building - arguments passed to functions. So going back to the -SWIG_ConvertPtr() function example from above, we are expecting a -Foo * and need to check if obj0 is in fact a Foo * -. From before, SWIGTYPE_p_Foo is just a pointer to the -swig_type_info structure describing Foo *. So we loop - through the linked list of swig_cast_info structures attached - to SWIGTYPE_p_Foo. If we see that the type of obj0 is - in the linked list, we pass the object through the associated - conversion function and then return a positive. If we reach the end of - the linked list without a match, then obj0 can not be - converted to a Foo * and an error is generated.

    -

    Another issue needing to be addressed is sharing type information - between multiple modules. More explicitly, we need to have ONE -swig_type_info for each type. If two modules both use the type, the - second module loaded must lookup and use the swig_type_info structure - from the module already loaded. Because no dynamic memory is used and - the circular dependencies of the casting information, loading the type - information is somewhat tricky, and not explained here. A complete - description is in the Lib/swiginit.swg file (and near the top - of any generated file).

    -

    Each module has one swig_module_info structure which looks like - this:

    +

    As can be seen from the generated code below, SWIG generates an + exception handler with the catch block comprising the "throws" typemap + content.

    -/* Structure used to store module information
    - * Each module generates one structure like this, and the runtime collects
    - * all of these structures and stores them in a circularly linked list.*/
    -typedef struct swig_module_info {
    -  swig_type_info **types;         /* Array of pointers to swig_type_info structs in this module */
    -  int size;                       /* Number of types in this module */
    -  struct swig_module_info *next;  /* Pointer to next element in circularly linked list */
    -  swig_type_info **type_initial;  /* Array of initially generated type structures */
    -  swig_cast_info **cast_initial;  /* Array of initially generated casting structures */
    -  void *clientdata;               /* Language specific module data */
    -} swig_module_info;
    +...
    +try {
    +    bar();
    +}
    +catch(char const *_e) {
    +    PyErr_SetString(PyExc_RuntimeError, _e);
    +    SWIG_fail;
    +    
    +}
    +...
     
    -

    Each module stores an array of pointers to swig_type_info - structures and the number of types in this module. So when a second - module is loaded, it finds the swig_module_info structure for - the first module and searches the array of types. If any of its own - types are in the first module and have already been loaded, it uses - those swig_type_info structures rather than creating new ones. - These swig_module_info structures are chained together in a - circularly linked list.

    -

    10.12.2 Usage

    -

    This section covers how to use these functions from typemaps. To - learn how to call these functions from external files (not the - generated _wrap.c file), see the -External access to the run-time system section.

    -

    When pointers are converted in a typemap, the typemap code often - looks similar to this:

    +

    Note that if your methods do not have an exception specification yet + they do throw exceptions, SWIG cannot know how to deal with them. For a + neat way to handle these, see the +Exception handling with %exception section.

    +

    11.6 Some typemap examples

    +

    This section contains a few examples. Consult language module + documentation for more examples.

    +

    11.6.1 Typemaps for arrays

    +

    A common use of typemaps is to provide support for C arrays + appearing both as arguments to functions and as structure members.

    +

    For example, suppose you had a function like this:

    -%typemap(in) Foo * {
    -  if ((SWIG_ConvertPtr($input, (void **) &$1, $1_descriptor)) == -1) return NULL;
    -}
    +void set_vector(int type, float value[4]);
     
    -

    The most critical part is the typemap is the use of the -$1_descriptor special variable. When placed in a typemap, this is - expanded into the SWIGTYPE_* type descriptor object above. As - a general rule, you should always use $1_descriptor instead of - trying to hard-code the type descriptor name directly.

    -

    There is another reason why you should always use the -$1_descriptor variable. When this special variable is expanded, - SWIG marks the corresponding type as "in use." When type-tables and - type information is emitted in the wrapper file, descriptor information - is only generated for those datatypes that were actually used in the - interface. This greatly reduces the size of the type tables and - improves efficiency.

    -

    Occasionally, you might need to write a typemap that needs to - convert pointers of other types. To handle this, the special variable - macro $descriptor(type) covered earlier can be used to - generate the SWIG type descriptor name for any C datatype. For example:

    +

    If you wanted to handle float value[4] as a list of floats, + you might write a typemap similar to this:

    -%typemap(in) Foo * {
    -  if ((SWIG_ConvertPtr($input, (void **) &$1, $1_descriptor)) == -1) {
    -     Bar *temp;
    -     if ((SWIG_ConvertPtr($input, (void **) &temp, $descriptor(Bar *)) == -1) {
    -         return NULL;
    -     }
    -     $1 = (Foo *) temp;
    +
    +%typemap(in) float value[4] (float temp[4]) {
    +  int i;
    +  if (!PySequence_Check($input)) {
    +    PyErr_SetString(PyExc_ValueError,"Expected a sequence");
    +    return NULL;
    +  }
    +  if (PySequence_Length($input) != 4) {
    +    PyErr_SetString(PyExc_ValueError,"Size mismatch. Expected 4 elements");
    +    return NULL;
    +  }
    +  for (i = 0; i < 4; i++) {
    +    PyObject *o = PySequence_GetItem($input,i);
    +    if (PyNumber_Check(o)) {
    +      temp[i] = (float) PyFloat_AsDouble(o);
    +    } else {
    +      PyErr_SetString(PyExc_ValueError,"Sequence elements must be numbers");      
    +      return NULL;
    +    }
       }
    +  $1 = temp;
     }
     
    -

    The primary use of $descriptor(type) is when writing - typemaps for container objects and other complex data structures. There - are some restrictions on the argument---namely it must be a fully - defined C datatype. It can not be any of the special typemap variables.

    -

    In certain cases, SWIG may not generate type-descriptors like you - expect. For example, if you are converting pointers in some - non-standard way or working with an unusual combination of interface - files and modules, you may find that SWIG omits information for a - specific type descriptor. To fix this, you may need to use the -%types directive. For example:

    -
    +

    In this example, the variable temp allocates a small array + on the C stack. The typemap then populates this array and passes it to + the underlying C function.

    +

    When used from Python, the typemap allows the following type of + function call:

    +
    -%types(int *, short *, long *, float *, double *);
    +>>> set_vector(type, [ 1, 2.5, 5, 20 ])
     
    -

    When %types is used, SWIG generates type-descriptor - information even if those datatypes never appear elsewhere in the - interface file.

    -

    Further details about the run-time type checking can be found in the - documentation for individual language modules. Reading the source code - may also help. The file Lib/swigrun.swg in the SWIG library - contains all of the source of the generated code for type-checking. - This code is also included in every generated wrapped file so you - probably just look at the output of SWIG to get a better sense for how - types are managed.

    -

    10.13 Typemaps and overloading

    -

    This section does not apply to the statically typed languages like - Java and C#, where overloading of the types is handled much like C++ by - generating overloaded methods in the target language. In many of the - other target languages, SWIG still fully supports C++ overloaded - methods and functions. For example, if you have a collection of - functions like this:

    +

    If you wanted to generalize the typemap to apply to arrays of all + dimensions you might write this:

    -int foo(int x);
    -int foo(double x);
    -int foo(char *s, int y);
    +%typemap(in) float value[ANY] (float temp[$1_dim0]) {
    +  int i;
    +  if (!PySequence_Check($input)) {
    +    PyErr_SetString(PyExc_ValueError,"Expected a sequence");
    +    return NULL;
    +  }
    +  if (PySequence_Length($input) != $1_dim0) {
    +    PyErr_SetString(PyExc_ValueError,"Size mismatch. Expected $1_dim0 elements");
    +    return NULL;
    +  }
    +  for (i = 0; i < $1_dim0; i++) {
    +    PyObject *o = PySequence_GetItem($input,i);
    +    if (PyNumber_Check(o)) {
    +      temp[i] = (float) PyFloat_AsDouble(o);
    +    } else {
    +      PyErr_SetString(PyExc_ValueError,"Sequence elements must be numbers");      
    +      return NULL;
    +    }
    +  }
    +  $1 = temp;
    +}
     
    -

    You can access the functions in a normal way from the scripting - interpreter:

    -
    +

    In this example, the special variable $1_dim0 is expanded + with the actual array dimensions. Multidimensional arrays can be + matched in a similar manner. For example:

    +
    -# Python
    -foo(3)           # foo(int)
    -foo(3.5)         # foo(double)
    -foo("hello",5)   # foo(char *, int)
    -
    -# Tcl
    -foo 3            # foo(int)
    -foo 3.5          # foo(double)
    -foo hello 5      # foo(char *, int)
    +%typemap(in) float matrix[ANY][ANY] (float temp[$1_dim0][$1_dim1]) {
    +   ... convert a 2d array ...
    +}
     
    -

    To implement overloading, SWIG generates a separate wrapper function - for each overloaded method. For example, the above functions would - produce something roughly like this:

    +

    For large arrays, it may be impractical to allocate storage on the + stack using a temporary variable as shown. To work with heap allocated + data, the following technique can be used.

    -// wrapper pseudocode
    -_wrap_foo_0(argc, args[]) {       // foo(int)
    -   int arg1;
    -   int result;
    -   ...
    -   arg1 = FromInteger(args[0]);
    -   result = foo(arg1);
    -   return ToInteger(result);
    -}
    -
    -_wrap_foo_1(argc, args[]) {       // foo(double)
    -   double arg1;
    -   int result;
    -   ...
    -   arg1 = FromDouble(args[0]);
    -   result = foo(arg1);
    -   return ToInteger(result);
    +%typemap(in) float value[ANY] {
    +  int i;
    +  if (!PySequence_Check($input)) {
    +    PyErr_SetString(PyExc_ValueError,"Expected a sequence");
    +    return NULL;
    +  }
    +  if (PySequence_Length($input) != $1_dim0) {
    +    PyErr_SetString(PyExc_ValueError,"Size mismatch. Expected $1_dim0 elements");
    +    return NULL;
    +  }
    +  $1 = (float *) malloc($1_dim0*sizeof(float));
    +  for (i = 0; i < $1_dim0; i++) {
    +    PyObject *o = PySequence_GetItem($input,i);
    +    if (PyNumber_Check(o)) {
    +      $1[i] = (float) PyFloat_AsDouble(o);
    +    } else {
    +      PyErr_SetString(PyExc_ValueError,"Sequence elements must be numbers");      
    +      free($1);
    +      return NULL;
    +    }
    +  }
     }
    -
    -_wrap_foo_2(argc, args[]) {       // foo(char *, int)
    -   char *arg1;
    -   int   arg2;
    -   int result;
    -   ...
    -   arg1 = FromString(args[0]);
    -   arg2 = FromInteger(args[1]);
    -   result = foo(arg1,arg2);
    -   return ToInteger(result);
    +%typemap(freearg) float value[ANY] {
    +   if ($1) free($1);
     }
    -
     
    -

    Next, a dynamic dispatch function is generated:

    +

    In this case, an array is allocated using malloc. The +freearg typemap is then used to release the argument after the + function has been called.

    +

    Another common use of array typemaps is to provide support for array + structure members. Due to subtle differences between pointers and + arrays in C, you can't just "assign" to a array structure member. + Instead, you have to explicitly copy elements into the array. For + example, suppose you had a structure like this:

    -_wrap_foo(argc, args[]) {
    -   if (argc == 1) {
    -       if (IsInteger(args[0])) {
    -           return _wrap_foo_0(argc,args);
    -       } 
    -       if (IsDouble(args[0])) {
    -           return _wrap_foo_1(argc,args);
    -       }
    -   }
    -   if (argc == 2) {
    -       if (IsString(args[0]) && IsInteger(args[1])) {
    -          return _wrap_foo_2(argc,args);
    -       }
    -   }
    -   error("No matching function!\n");
    -}
    +struct SomeObject {
    +  float  value[4];
    +  ...
    +};
     
    -

    The purpose of the dynamic dispatch function is to select the - appropriate C++ function based on argument types---a task that must be - performed at runtime in most of SWIG's target languages.

    -

    The generation of the dynamic dispatch function is a relatively - tricky affair. Not only must input typemaps be taken into account - (these typemaps can radically change the types of arguments accepted), - but overloaded methods must also be sorted and checked in a very - specific order to resolve potential ambiguity. A high-level overview of - this ranking process is found in the "SWIG and C++ -" chapter. What isn't mentioned in that chapter is the mechanism by - which it is implemented---as a collection of typemaps.

    -

    To support dynamic dispatch, SWIG first defines a general purpose - type hierarchy as follows:

    -
    +

    When SWIG runs, it won't produce any code to set the vec + member. You may even get a warning message like this:

    +
    -Symbolic Name                   Precedence Value
    -------------------------------  ------------------
    -SWIG_TYPECHECK_POINTER           0  
    -SWIG_TYPECHECK_VOIDPTR           10 
    -SWIG_TYPECHECK_BOOL              15 
    -SWIG_TYPECHECK_UINT8             20 
    -SWIG_TYPECHECK_INT8              25 
    -SWIG_TYPECHECK_UINT16            30 
    -SWIG_TYPECHECK_INT16             35 
    -SWIG_TYPECHECK_UINT32            40 
    -SWIG_TYPECHECK_INT32             45 
    -SWIG_TYPECHECK_UINT64            50 
    -SWIG_TYPECHECK_INT64             55 
    -SWIG_TYPECHECK_UINT128           60 
    -SWIG_TYPECHECK_INT128            65 
    -SWIG_TYPECHECK_INTEGER           70 
    -SWIG_TYPECHECK_FLOAT             80 
    -SWIG_TYPECHECK_DOUBLE            90 
    -SWIG_TYPECHECK_COMPLEX           100 
    -SWIG_TYPECHECK_UNICHAR           110 
    -SWIG_TYPECHECK_UNISTRING         120 
    -SWIG_TYPECHECK_CHAR              130 
    -SWIG_TYPECHECK_STRING            140 
    -SWIG_TYPECHECK_BOOL_ARRAY        1015 
    -SWIG_TYPECHECK_INT8_ARRAY        1025 
    -SWIG_TYPECHECK_INT16_ARRAY       1035 
    -SWIG_TYPECHECK_INT32_ARRAY       1045 
    -SWIG_TYPECHECK_INT64_ARRAY       1055 
    -SWIG_TYPECHECK_INT128_ARRAY      1065 
    -SWIG_TYPECHECK_FLOAT_ARRAY       1080 
    -SWIG_TYPECHECK_DOUBLE_ARRAY      1090 
    -SWIG_TYPECHECK_CHAR_ARRAY        1130 
    -SWIG_TYPECHECK_STRING_ARRAY      1140 
    +$ swig -python  example.i
    +example.i:10: Warning 462: Unable to set variable of type float [4].
     
    -

    (These precedence levels are defined in swig.swg, a library - file that's included by all target language modules.)

    -

    In this table, the precedence-level determines the order in which - types are going to be checked. Low values are always checked before - higher values. For example, integers are checked before floats, single - values are checked before arrays, and so forth.

    -

    Using the above table as a guide, each target language defines a - collection of "typecheck" typemaps. The follow excerpt from the Python - module illustrates this:

    +

    These warning messages indicate that SWIG does not know how you want + to set the vec field.

    +

    To fix this, you can supply a special "memberin" typemap like this:

    -/* Python type checking rules */
    -/* Note:  %typecheck(X) is a macro for %typemap(typecheck,precedence=X) */
    -
    -%typecheck(SWIG_TYPECHECK_INTEGER)
    -	 int, short, long,
    - 	 unsigned int, unsigned short, unsigned long,
    -	 signed char, unsigned char,
    -	 long long, unsigned long long,
    -	 const int &, const short &, const long &,
    - 	 const unsigned int &, const unsigned short &, const unsigned long &,
    -	 const long long &, const unsigned long long &,
    -	 enum SWIGTYPE,
    -         bool, const bool & 
    -{
    -  $1 = (PyInt_Check($input) || PyLong_Check($input)) ? 1 : 0;
    -}
    -
    -%typecheck(SWIG_TYPECHECK_DOUBLE)
    -	float, double,
    -	const float &, const double &
    -{
    -  $1 = (PyFloat_Check($input) || PyInt_Check($input) || PyLong_Check($input)) ? 1 : 0;
    -}
    -
    -%typecheck(SWIG_TYPECHECK_CHAR) char {
    -  $1 = (PyString_Check($input) && (PyString_Size($input) == 1)) ? 1 : 0;
    -}
    -
    -%typecheck(SWIG_TYPECHECK_STRING) char * {
    -  $1 = PyString_Check($input) ? 1 : 0;
    -}
    -
    -%typecheck(SWIG_TYPECHECK_POINTER) SWIGTYPE *, SWIGTYPE &, SWIGTYPE [] {
    -  void *ptr;
    -  if (SWIG_ConvertPtr($input, (void **) &ptr, $1_descriptor, 0) == -1) {
    -    $1 = 0;
    -    PyErr_Clear();
    -  } else {
    -    $1 = 1;
    -  }
    -}
    -
    -%typecheck(SWIG_TYPECHECK_POINTER) SWIGTYPE {
    -  void *ptr;
    -  if (SWIG_ConvertPtr($input, (void **) &ptr, $&1_descriptor, 0) == -1) {
    -    $1 = 0;
    -    PyErr_Clear();
    -  } else {
    -    $1 = 1;
    -  }
    -}
    -
    -%typecheck(SWIG_TYPECHECK_VOIDPTR) void * {
    -  void *ptr;
    -  if (SWIG_ConvertPtr($input, (void **) &ptr, 0, 0) == -1) {
    -    $1 = 0;
    -    PyErr_Clear();
    -  } else {
    -    $1 = 1;
    +%typemap(memberin) float [ANY] {
    +  int i;
    +  for (i = 0; i < $1_dim0; i++) {
    +      $1[i] = $input[i];
       }
     }
    -
    -%typecheck(SWIG_TYPECHECK_POINTER) PyObject *
    -{
    -  $1 = ($input != 0);
    -}
     
    -

    It might take a bit of contemplation, but this code has merely - organized all of the basic C++ types, provided some simple - type-checking code, and assigned each type a precedence value.

    -

    Finally, to generate the dynamic dispatch function, SWIG uses the - following algorithm:

    -
      -
    • Overloaded methods are first sorted by the number of required - arguments.
    • -
    • Methods with the same number of arguments are then sorted by - precedence values of argument types.
    • -
    • Typecheck typemaps are then emitted to produce a dispatch function - that checks arguments in the correct order.
    • -
    -

    If you haven't written any typemaps of your own, it is unnecessary - to worry about the typechecking rules. However, if you have written new - input typemaps, you might have to supply a typechecking rule as well. - An easy way to do this is to simply copy one of the existing - typechecking rules. Here is an example,

    -
    +

    The memberin typemap is used to set a structure member from data + that has already been converted from the target language to C. In this + case, $input is the local variable in which converted input + data is stored. This typemap then copies this data into the structure.

    +

    When combined with the earlier typemaps for arrays, the combination + of the "in" and "memberin" typemap allows the following usage:

    +
    -// Typemap for a C++ string
    -%typemap(in) std::string {
    -    if (PyString_Check($input)) {
    -         $1 = std::string(PyString_AsString($input));
    -     } else {
    -         SWIG_exception(SWIG_TypeError, "string expected");
    -     }
    -}
    -// Copy the typecheck code for "char *".  
    -%typemap(typecheck) std::string = char *;
    +>>> s = SomeObject()
    +>>> s.x = [1, 2.5, 5, 10]
     
    -

    The bottom line: If you are writing new typemaps and you are using - overloaded methods, you will probably have to write typecheck code or - copy existing code. Since this is a relatively new SWIG feature, there - are few examples to work with. However, you might look at some of the - existing library files likes 'typemaps.i' for a guide.

    -

    Notes:

    -
      -
    • Typecheck typemaps are not used for non-overloaded methods. Because - of this, it is still always necessary to check types in any "in" - typemaps.
    • -
    • The dynamic dispatch process is only meant to be a heuristic. There - are many corner cases where SWIG simply can't disambiguate types to the - same degree as C++. The only way to resolve this ambiguity is to use - the %rename directive to rename one of the overloaded methods - (effectively eliminating overloading).
    • -
    • Typechecking may be partial. For example, if working with arrays, - the typecheck code might simply check the type of the first array - element and use that to dispatch to the correct function. Subsequent - "in" typemaps would then perform more extensive type-checking.
    • -
    • Make sure you read the section on overloading in the " -SWIG and C++" chapter.
    • -
    -

    10.14 More about %apply and -%clear

    -

    In order to implement certain kinds of program behavior, it is - sometimes necessary to write sets of typemaps. For example, to support - output arguments, one often writes a set of typemaps like this:

    +

    Related to structure member input, it may be desirable to return + structure members as a new kind of object. For example, in this + example, you will get very odd program behavior where the structure + member can be set nicely, but reading the member simply returns a + pointer:

    +
    +
    +>>> s = SomeObject()
    +>>> s.x = [1, 2.5, 5, 10]
    +>>> print s.x
    +_1008fea8_p_float
    +>>> 
    +
    +
    +

    To fix this, you can write an "out" typemap. For example:

    -%typemap(in,numinputs=0) int *OUTPUT (int temp) {
    -   $1 = &temp;
    -}
    -%typemap(argout) int *OUTPUT {
    -   // return value somehow
    +%typemap(out) float [ANY] {
    +  int i;
    +  $result = PyList_New($1_dim0);
    +  for (i = 0; i < $1_dim0; i++) {
    +    PyObject *o = PyFloat_FromDouble((double) $1[i]);
    +    PyList_SetItem($result,i,o);
    +  }
     }
     
    -

    To make it easier to apply the typemap to different argument types - and names, the %apply directive performs a copy of all - typemaps from one type to another. For example, if you specify this,

    -
    +

    Now, you will find that member access is quite nice:

    +
    -%apply int *OUTPUT { int *retvalue, int32 *output };
    +>>> s = SomeObject()
    +>>> s.x = [1, 2.5, 5, 10]
    +>>> print s.x
    +[ 1, 2.5, 5, 10]
     
    -

    then all of the int *OUTPUT typemaps are copied to int - *retvalue and int32 *output.

    -

    However, there is a subtle aspect of %apply that needs more - description. Namely, %apply does not overwrite a typemap rule - if it is already defined for the target datatype. This behavior allows - you to do two things:

    -
      -
    • You can specialize parts of a complex typemap rule by first defining - a few typemaps and then using %apply to incorporate the - remaining pieces.
    • -
    • Sets of different typemaps can be applied to the same datatype using - repeated %apply directives.
    • -
    -

    For example:

    +

    Compatibility Note: SWIG1.1 used to provide a special + "memberout" typemap. However, it was mostly useless and has since been + eliminated. To return structure members, simply use the "out" typemap.

    +

    11.6.2 Implementing constraints with + typemaps

    +

    One particularly interesting application of typemaps is the + implementation of argument constraints. This can be done with the + "check" typemap. When used, this allows you to provide code for + checking the values of function arguments. For example:

    -%typemap(in) int *INPUT (int temp) {
    -   temp = ... get value from $input ...;
    -   $1 = &temp;
    -}
    +%module math
     
    -%typemap(check) int *POSITIVE {
    -   if (*$1 <= 0) {
    -      SWIG_exception(SWIG_ValueError,"Expected a positive number!\n");
    -      return NULL;
    -   }
    +%typemap(check) double posdouble {
    +  if ($1 < 0) {
    +    croak("Expecting a positive number");
    +  }
     }
     
     ...
    -%apply int *INPUT     { int *invalue };
    -%apply int *POSITIVE  { int *invalue };
    -
    -
    -

    Since %apply does not overwrite or replace any existing - rules, the only way to reset behavior is to use the %clear - directive. %clear removes all typemap rules defined for a - specific datatype. For example:

    -
    -
    -%clear int *invalue;
    +double sqrt(double posdouble);
    +
     
    -

    10.15 Passing data between typemaps

    -

    It is also important to note that the primary use of local variables - is to create stack-allocated objects for temporary use inside a wrapper - function (this is faster and less-prone to error than allocating data - on the heap). In general, the variables are not intended to pass - information between different types of typemaps. However, this can be - done if you realize that local names have the argument number appended - to them. For example, you could do this:

    +

    This provides a sanity check to your wrapper function. If a negative + number is passed to this function, a Perl exception will be raised and + your program terminated with an error message.

    +

    This kind of checking can be particularly useful when working with + pointers. For example:

    -%typemap(in) int *(int temp) {
    -   temp = (int) PyInt_AsLong($input);
    -   $1 = &temp;
    +%typemap(check) Vector * {
    +    if ($1 == 0) {
    +        PyErr_SetString(PyExc_TypeError,"NULL Pointer not allowed");
    +        return NULL;
    +   }
     }
     
    -%typemap(argout) int * {
    -   PyObject *o = PyInt_FromLong(temp$argnum);
    -   ...
    -}
     
    -

    In this case, the $argnum variable is expanded into the - argument number. Therefore, the code will reference the appropriate - local such as temp1 and temp2. It should be noted - that there are plenty of opportunities to break the universe here and - that accessing locals in this manner should probably be avoided. At the - very least, you should make sure that the typemaps sharing information - have exactly the same types and names.

    -

    10.16 C++ "this" pointer

    -

    All the rules discussed for typemaps apply to C++ as well as C. - However in addition C++ passes an extra parameter into every non-static - class method -- the this pointer. Occasionally it can be - useful to apply a typemap to this pointer (for example to check and - make sure this is non-null before deferencing). Actually, C - also has an the equivalent of the this pointer which is used - when accessing variables in a C struct.

    -

    In order to customise the this pointer handling, target a - variable named self in your typemaps. self is the - name SWIG uses to refer to the extra parameter in wrapped functions.

    -

    For example, if wrapping for Java generation:

    +

    will prevent any function involving a Vector * from + accepting a NULL pointer. As a result, SWIG can often prevent a + potential segmentation faults or other run-time problems by raising an + exception rather than blindly passing values to the underlying C/C++ + program.

    +

    11.7 Typemaps for multiple target languages +

    +

    The code within typemaps is usually language dependent, however, + many target languages support the same typemaps. In order to + distinguish typemaps across different languages, the preprocessor + should be used. For example, the "in" typemap for Perl and Ruby could + be written as:

    -%typemap(check) SWIGTYPE *self %{
    -if (!$1) {
    -  SWIG_JavaThrowException(jenv, SWIG_JavaNullPointerException,
    -    "invalid native object; delete() likely already called");
    -  return $null;
    -}
    -%}
    +#if defined(SWIGPERL)
    +  %typemap(in) int "$1 = ($1_ltype) SvIV($input);"
    +#elif defined(SWIGRUBY)
    +  %typemap(in) int "$1 = NUM2INT($input);"
    +#else
    +  #warning no "in" typemap defined
    +#endif
     
    -

    In the above case, the $1 variable is expanded into the - argument name that SWIG is using as the this pointer. SWIG - will then insert the check code before the actual C++ class method is - called, and will raise an exception rather than crash the Java virtual - machine. The generated code will look something like:

    +

    The full set of language specific macros is defined in the +Conditional Compilation section. The example above also shows a + common approach of issuing a warning for an as yet unsupported + language.

    +

    Compatibility note: In SWIG-1.1 different languages could be + distinguished with the language name being put within the %typemap + directive, for example, +
    %typemap(ruby,in) int "$1 = NUM2INT($input);".

    +

    11.8 Optimal code generation when + returning by value

    +

    The "out" typemap is the main typemap for return types. This typemap + supports an optional attribute flag called "optimal", which is for + reducing temporary variables and the amount of generated code, thereby + giving the compiler the opportunity to use return value optimization + for generating faster executing code. It only really makes a difference + when returning objects by value and has some limitations on usage, as + explained later on.

    +

    When a function returns an object by value, SWIG generates code that + instantiates the default type on the stack then assigns the value + returned by the function call to it. A copy of this object is then made + on the heap and this is what is ultimately stored and used from the + target language. This will be clearer considering an example. Consider + running the following code through SWIG:

    -  if (!arg1) {
    -    SWIG_JavaThrowException(jenv, SWIG_JavaNullPointerException,
    -      "invalid native object; delete() likely already called");
    -    return ;
    +%typemap(out) SWIGTYPE %{
    +  $result = new $1_ltype((const $1_ltype &)$1);
    +%}
    +
    +%inline %{
    +#include <iostream>
    +using namespace std;
    +
    +struct XX {
    +  XX() { cout << "XX()" << endl; }
    +  XX(int i) { cout << "XX(" << i << ")" << endl; }
    +  XX(const XX &other) { cout << "XX(const XX &)" << endl; }
    +  XX & operator =(const XX &other) { cout << "operator=(const XX &)" << endl; return *this; }
    +  ~XX() { cout << "~XX()" << endl; }
    +  static XX create() { 
    +    return XX(0);
       }
    -  (arg1)->wrappedFunction(...);
    +};
    +%}
     
    -

    Note that if you have a parameter named self then it will - also match the typemap. One work around is to create an interface file - that wraps the method, but gives the argument a name other than -self.

    -

    10.17 Where to go for more information?

    -

    The best place to find out more information about writing typemaps - is to look in the SWIG library. Most language modules define all of - their default behavior using typemaps. These are found in files such as - python.swg, perl5.swg, tcl8.swg and so - forth. The typemaps.i file in the library also contains - numerous examples. You should look at these files to get a feel for how - to define typemaps of your own. Some of the language modules support - additional typemaps and further information is available in the - individual chapters for each target language. There you may also find - more hands-on practical examples.

    -
    -

    11 Customization Features

    - - -
    - +

    The "out" typemap shown is the default typemap for C# when returning + objects by value. When making a call to XX::create() from C#, + the output is as follows:

    +
    +
    +XX()
    +XX(0)
    +operator=(const XX &)
    +~XX()
    +XX(const XX &)
    +~XX()
    +~XX()
    +
    - -

    In many cases, it is desirable to change the default wrapping of - particular declarations in an interface. For example, you might want to - provide hooks for catching C++ exceptions, add assertions, or provide - hints to the underlying code generator. This chapter describes some of - these customization techniques. First, a discussion of exception - handling is presented. Then, a more general-purpose customization - mechanism known as "features" is described.

    -

    11.1 Exception handling with - %exception

    -

    The %exception directive allows you to define a general - purpose exception handler. For example, you can specify the following:

    +

    Note that three objects are being created as well as an assignment. + Wouldn't it be great if the XX::create() method was the only + time a constructor was called? As the method returns by value, this is + asking a lot and the code that SWIG generates by default makes it + impossible for the compiler to use return value optimisation (RVO) +. However, this is where the "optimal" attribute in the "out" typemap + can help out. If the typemap code is kept the same and just the + "optimal" attribute specified like this:

    -%exception {
    -    try {
    -        $action
    -    }
    -    catch (RangeError) {
    -        ... handle error ...
    -    }
    -}
    +%typemap(out, optimal="1") SWIGTYPE %{
    +  $result = new $1_ltype((const $1_ltype &)$1);
    +%}
     
    -

    How the exception is handled depends on the target language, for - example, Python:

    +

    then when the code is run again, the output is simply:

    +
    +
    +XX(0)
    +~XX()
    +
    +
    +

    How the "optimal" attribute works is best explained using the + generated code. Without "optimal", the generated code is:

    -%exception {
    -    try {
    -        $action
    -    }
    -    catch (RangeError) {
    -        PyErr_SetString(PyExc_IndexError,"index out-of-bounds");
    -        SWIG_fail;
    -    }
    +SWIGEXPORT void * SWIGSTDCALL CSharp_XX_create() {
    +  void * jresult ;
    +  XX result;
    +  result = XX::create();
    +  jresult = new XX((const XX &)result);
    +  return jresult;
     }
    +
     
    -

    When defined, the code enclosed in braces is inserted directly into - the low-level wrapper functions. The special variable $action - is one of a few -%exception special variables supported and gets replaced with the - actual operation to be performed (a function call, method invocation, - attribute access, etc.). An exception handler remains in effect until - it is explicitly deleted. This is done by using either %exception - or %noexception with no code. For example:

    +

    With the "optimal" attribute, the code is:

    -%exception;   // Deletes any previously defined handler
    +SWIGEXPORT void * SWIGSTDCALL CSharp_XX_create() {
    +  void * jresult ;
    +  jresult = new XX((const XX &)XX::create());
    +  return jresult;
    +}
     
    -

    Compatibility note: Previous versions of SWIG used a special - directive %except for exception handling. That directive is - deprecated--%exception provides the same functionality, but is - substantially more flexible.

    -

    11.1.1 Handling exceptions in C code

    -

    C has no formal exception handling mechanism so there are several - approaches that might be used. A somewhat common technique is to simply - set a special error code. For example:

    +

    The major difference is the result temporary variable + holding the value returned from XX::create() is no longer + generated and instead the copy constructor call is made directly from + the value returned by XX::create(). With modern compilers + implementing RVO, the copy is not actually done, in fact the object is + never created on the stack in XX::create() at all, it is + simply created directly on the heap. In the first instance, the $1 + special variable in the typemap is expanded into result. In + the second instance, $1 is expanded into XX::create() + and this is essentially what the "optimal" attribute is telling SWIG to + do.

    +

    The "optimal" attribute optimisation is not turned on by default as + it has a number of restrictions. Firstly, some code cannot be condensed + into a simple call for passing into the copy constructor. One common + occurrence is when %exception is + used. Consider adding the following %exception to the example:

    -/* File : except.c */
    -
    -static char error_message[256];
    -static int error_status = 0;
    -
    -void throw_exception(char *msg) {
    -	strncpy(error_message,msg,256);
    -	error_status = 1;
    -}
    -
    -void clear_exception() {
    -	error_status = 0;
    -}
    -char *check_exception() {
    -	if (error_status) return error_message;
    -	else return NULL;
    +%exception XX::create() %{
    +try {
    +  $action
    +} catch(const std::exception &e) {
    +  cout << e.what() << endl;
     }
    -
    +%}
     
    -

    To use these functions, functions simply call throw_exception() - to indicate an error occurred. For example :

    -
    +

    SWIG can detect when the "optimal" attribute cannot be used and will + ignore it and in this case will issue the following warning:

    +
    -double inv(double x) {
    -	if (x != 0) return 1.0/x;
    -	else {
    -		throw_exception("Division by zero");
    -		return 0;
    -	}
    +example.i:28: Warning 474: Method XX::create() usage of the optimal attribute ignored
    +example.i:14: Warning 474: in the out typemap as the following cannot be used to generate
    +optimal code: 
    +try {
    +  result = XX::create();
    +} catch(const std::exception &e) {
    +  cout << e.what() << endl;
     }
    -
     
    -

    To catch the exception, you can write a simple exception handler - such as the following (shown for Perl5) :

    +

    It should be clear that the above code cannot be used as the + argument to the copy constructor call, that is, for the $1 + substitution.

    +

    Secondly, if the typemaps uses $1 more than once, then + multiple calls to the wrapped function will be made. Obviously that is + not very optimal. In fact SWIG attempts to detect this and will issue a + warning something like:

    +
    +
    +example.i:21: Warning 475: Multiple calls to XX::create() might be generated due to
    +example.i:7: Warning 475: optimal attribute usage in the out typemap.
    +
    +
    +

    However, it doesn't always get it right, for example when $1 + is within some commented out code.

    +

    11.9 Multi-argument + typemaps

    +

    So far, the typemaps presented have focused on the problem of + dealing with single values. For example, converting a single input + object to a single argument in a function call. However, certain + conversion problems are difficult to handle in this manner. As an + example, consider the example at the very beginning of this chapter:

    -%exception {
    -    char *err;
    -    clear_exception();
    -    $action
    -    if ((err = check_exception())) {
    -       croak(err);
    -    }
    -}
    +int foo(int argc, char *argv[]);
     
    -

    In this case, when an error occurs, it is translated into a Perl - error. Each target language has its own approach to creating a runtime - error/exception in and for Perl it is the croak method shown - above.

    -

    11.1.2 Exception handling with - longjmp()

    -

    Exception handling can also be added to C code using the -<setjmp.h> library. Here is a minimalistic implementation that - relies on the C preprocessor :

    +

    Suppose that you wanted to wrap this function so that it accepted a + single list of strings like this:

    +
    +
    +>>> foo(["ale", "lager", "stout"])
    +
    +
    +

    To do this, you not only need to map a list of strings to char + *argv[], but the value of int argc is implicitly + determined by the length of the list. Using only simple typemaps, this + type of conversion is possible, but extremely painful. Multi-argument + typemaps help in this situation.

    +

    A multi-argument typemap is a conversion rule that specifies how to + convert a single object in the target language to a set of + consecutive function arguments in C/C++. For example, the following + multi-argument maps perform the conversion described for the above + example:

    -/* File : except.c
    -   Just the declaration of a few global variables we're going to use */
    -
    -#include <setjmp.h>
    -jmp_buf exception_buffer;
    -int exception_status;
    -
    -/* File : except.h */
    -#include <setjmp.h>
    -extern jmp_buf exception_buffer;
    -extern int exception_status;
    -
    -#define try if ((exception_status = setjmp(exception_buffer)) == 0)
    -#define catch(val) else if (exception_status == val)
    -#define throw(val) longjmp(exception_buffer,val)
    -#define finally else
    -
    -/* Exception codes */
    +%typemap(in) (int argc, char *argv[]) {
    +  int i;
    +  if (!PyList_Check($input)) {
    +    PyErr_SetString(PyExc_ValueError, "Expecting a list");
    +    return NULL;
    +  }
    +  $1 = PyList_Size($input);
    +  $2 = (char **) malloc(($1+1)*sizeof(char *));
    +  for (i = 0; i < $1; i++) {
    +    PyObject *s = PyList_GetItem($input,i);
    +    if (!PyString_Check(s)) {
    +        free($2);
    +        PyErr_SetString(PyExc_ValueError, "List items must be strings");
    +        return NULL;
    +    }
    +    $2[i] = PyString_AsString(s);
    +  }
    +  $2[i] = 0;
    +}
     
    -#define RangeError     1
    -#define DivisionByZero 2
    -#define OutOfMemory    3
    +%typemap(freearg) (int argc, char *argv[]) {
    +   if ($2) free($2);
    +}
     
    +/* Required for C++ method overloading */
    +%typecheck(SWIG_TYPECHECK_STRING_ARRAY) (int argc, char *argv[]) {
    +  $1 = PyList_Check($input) ? 1 : 0;
    +}
     
    -

    Now, within a C program, you can do the following :

    +

    A multi-argument map is always specified by surrounding the + arguments with parentheses as shown. For example:

    -double inv(double x) {
    -	if (x) return 1.0/x;
    -	else throw(DivisionByZero);
    -}
    -
    +%typemap(in) (int argc, char *argv[]) { ... }
     
    -

    Finally, to create a SWIG exception handler, write the following :

    +

    Within the typemap code, the variables $1, $2, and + so forth refer to each type in the map. All of the usual substitutions + apply--just use the appropriate $1 or $2 prefix on + the variable name (e.g., $2_type, $1_ltype, etc.)

    +

    Multi-argument typemaps always have precedence over simple typemaps + and SWIG always performs longest-match searching. Therefore, you will + get the following behavior:

    -%{
    -#include "except.h"
    -%}
    +%typemap(in) int argc                              { ... typemap 1 ... }
    +%typemap(in) (int argc, char *argv[])              { ... typemap 2 ... }
    +%typemap(in) (int argc, char *argv[], char *env[]) { ... typemap 3 ... }
     
    -%exception {
    -	try {
    -		$action
    -	} catch(RangeError) {
    -		croak("Range Error");
    -	} catch(DivisionByZero) {
    -		croak("Division by zero");
    -	} catch(OutOfMemory) {
    -		croak("Out of memory");
    -	} finally {
    -		croak("Unknown exception");
    -	}
    -}
    +int foo(int argc, char *argv[]);                   // Uses typemap 2
    +int bar(int argc, int x);                          // Uses typemap 1
    +int spam(int argc, char *argv[], char *env[]);     // Uses typemap 3
     
    -

    Note: This implementation is only intended to illustrate the general - idea. To make it work better, you'll need to modify it to handle nested - try declarations.

    -

    11.1.3 Handling C++ exceptions

    -

    Handling C++ exceptions is also straightforward. For example:

    +

    It should be stressed that multi-argument typemaps can appear + anywhere in a function declaration and can appear more than once. For + example, you could write this:

    -%exception {
    -	try {
    -		$action
    -	} catch(RangeError) {
    -		croak("Range Error");
    -	} catch(DivisionByZero) {
    -		croak("Division by zero");
    -	} catch(OutOfMemory) {
    -		croak("Out of memory");
    -	} catch(...) {
    -		croak("Unknown exception");
    -	}
    -}
    +%typemap(in) (int scount, char *swords[]) { ... }
    +%typemap(in) (int wcount, char *words[]) { ... }
     
    +void search_words(int scount, char *swords[], int wcount, char *words[], int maxcount);
     
    -

    The exception types need to be declared as classes elsewhere, - possibly in a header file :

    +

    Other directives such as %apply and %clear also + work with multi-argument maps. For example:

    -class RangeError {};
    -class DivisionByZero {};
    -class OutOfMemory {};
    +%apply (int argc, char *argv[]) {
    +    (int scount, char *swords[]),
    +    (int wcount, char *words[])
    +};
    +...
    +%clear (int scount, char *swords[]), (int wcount, char *words[]);
    +...
     
    -

    11.1.4 Exception handlers - for variables

    -

    By default all variables will ignore %exception, so it is - effectively turned off for all variables wrappers. This applies to - global variables, member variables and static member variables. The - approach is certainly a logical one when wrapping variables in C. - However, in C++, it is quite possible for an exception to be thrown - while the variable is being assigned. To ensure %exception is - used when wrapping variables, it needs to be 'turned on' using the -%allowexception feature. Note that %allowexception is just - a macro for %feature("allowexcept"), that is, it is a feature - called "allowexcept". Any variable which has this feature attached to - it, will then use the %exception feature, but of course, only - if there is a %exception attached to the variable in the first - place. The %allowexception feature works like any other - feature and so can be used globally or for selective variables.

    +

    Don't forget to also provide a suitable +typemap for overloaded functions, such as %typecheck shown + for foo above. This is only required if the function is overloaded in + C++.

    +

    Although multi-argument typemaps may seem like an exotic, little + used feature, there are several situations where they make sense. + First, suppose you wanted to wrap functions similar to the low-level +read() and write() system calls. For example:

    -%allowexception;                // turn on globally
    -%allowexception Klass::MyVar;   // turn on for a specific variable
    +typedef unsigned int size_t;
     
    -%noallowexception Klass::MyVar; // turn off for a specific variable
    -%noallowexception;              // turn off globally
    +int read(int fd, void *rbuffer, size_t len);
    +int write(int fd, void *wbuffer, size_t len);
     
    -

    11.1.5 Defining different exception - handlers

    -

    By default, the %exception directive creates an exception - handler that is used for all wrapper functions that follow it. Unless - there is a well-defined (and simple) error handling mechanism in place, - defining one universal exception handler may be unwieldy and result in - excessive code bloat since the handler is inlined into each wrapper - function.

    -

    To fix this, you can be more selective about how you use the -%exception directive. One approach is to only place it around - critical pieces of code. For example:

    +

    As is, the only way to use the functions would be to allocate memory + and pass some kind of pointer as the second argument---a process that + might require the use of a helper function. However, using + multi-argument maps, the functions can be transformed into something + more natural. For example, you might write typemaps like this:

    -%exception {
    -	... your exception handler ...
    +// typemap for an outgoing buffer
    +%typemap(in) (void *wbuffer, size_t len) {
    +   if (!PyString_Check($input)) {
    +       PyErr_SetString(PyExc_ValueError, "Expecting a string");
    +       return NULL;
    +   }
    +   $1 = (void *) PyString_AsString($input);
    +   $2 = PyString_Size($input);
     }
    -/* Define critical operations that can throw exceptions here */
     
    -%exception;
    +// typemap for an incoming buffer
    +%typemap(in) (void *rbuffer, size_t len) {
    +   if (!PyInt_Check($input)) {
    +       PyErr_SetString(PyExc_ValueError, "Expecting an integer");
    +       return NULL;
    +   }
    +   $2 = PyInt_AsLong($input);
    +   if ($2 < 0) {
    +       PyErr_SetString(PyExc_ValueError, "Positive integer expected");
    +       return NULL;
    +   }
    +   $1 = (void *) malloc($2);
    +}
     
    -/* Define non-critical operations that don't throw exceptions */
    +// Return the buffer.  Discarding any previous return result
    +%typemap(argout) (void *rbuffer, size_t len) {
    +   Py_XDECREF($result);   /* Blow away any previous result */
    +   if (result < 0) {      /* Check for I/O error */
    +       free($1);
    +       PyErr_SetFromErrno(PyExc_IOError);
    +       return NULL;
    +   }
    +   $result = PyString_FromStringAndSize($1,result);
    +   free($1);
    +}
     
    -

    More precise control over exception handling can be obtained by - attaching an exception handler to specific declaration name. For - example:

    -
    +

    (note: In the above example, $result and result + are two different variables. result is the real C datatype + that was returned by the function. $result is the scripting + language object being returned to the interpreter.).

    +

    Now, in a script, you can write code that simply passes buffers as + strings like this:

    +
    -%exception allocate {
    -    try {
    -        $action
    -    } 
    -    catch (MemoryError) {
    -        croak("Out of memory");
    -    }
    -}
    +>>> f = example.open("Makefile")
    +>>> example.read(f,40)
    +'TOP        = ../..\nSWIG       = $(TOP)/.'
    +>>> example.read(f,40)
    +'./swig\nSRCS       = example.c\nTARGET    '
    +>>> example.close(f)
    +0
    +>>> g = example.open("foo", example.O_WRONLY | example.O_CREAT, 0644)
    +>>> example.write(g,"Hello world\n")
    +12
    +>>> example.write(g,"This is a test\n")
    +15
    +>>> example.close(g)
    +0
    +>>>
     
    -

    In this case, the exception handler is only attached to declarations - named "allocate". This would include both global and member functions. - The names supplied to %exception follow the same rules as for -%rename described in the section on -Ambiguity resolution and renaming. For example, if you wanted to - define an exception handler for a specific class, you might write this:

    +

    A number of multi-argument typemap problems also arise in libraries + that perform matrix-calculations--especially if they are mapped onto + low-level Fortran or C code. For example, you might have a function + like this:

    -%exception Object::allocate {
    -    try {
    -        $action
    -    } 
    -    catch (MemoryError) {
    -        croak("Out of memory");
    -    }
    -}
    +int is_symmetric(double *mat, int rows, int columns);
     
    -

    When a class prefix is supplied, the exception handler is applied to - the corresponding declaration in the specified class as well as for - identically named functions appearing in derived classes.

    -

    %exception can even be used to pinpoint a precise - declaration when overloading is used. For example:

    +

    In this case, you might want to pass some kind of higher-level + object as an matrix. To do this, you could write a multi-argument + typemap like this:

    -%exception Object::allocate(int) {
    -    try {
    -        $action
    -    } 
    -    catch (MemoryError) {
    -        croak("Out of memory");
    -    }
    +%typemap(in) (double *mat, int rows, int columns) {
    +    MatrixObject *a;
    +    a = GetMatrixFromObject($input);     /* Get matrix somehow */
    +
    +    /* Get matrix properties */
    +    $1 = GetPointer(a);
    +    $2 = GetRows(a);
    +    $3 = GetColumns(a);
     }
     
    -

    Attaching exceptions to specific declarations is a good way to - reduce code bloat. It can also be a useful way to attach exceptions to - specific parts of a header file. For example:

    +

    This kind of technique can be used to hook into scripting-language + matrix packages such as Numeric Python. However, it should also be + stressed that some care is in order. For example, when crossing + languages you may need to worry about issues such as row-major vs. + column-major ordering (and perform conversions if needed). Note that + multi-argument typemaps cannot deal with non-consecutive C/C++ + arguments; a workaround such as a helper function re-ordering the + arguments to make them consecutive will need to be written.

    +

    11.10 Typemap warnings

    +

    Warnings can be added to typemaps so that SWIG generates a warning + message whenever the typemap is used. See the information in the +issuing warnings section.

    +

    11.11 Typemap fragments

    +

    The primary purpose of fragments is to reduce code bloat that + repeated use of typemap code can lead to. Fragments are snippets of + code that can be thought of as code dependencies of a typemap. If a + fragment is used by more than one typemap, then the snippet of code + within the fragment is only generated once. Code bloat is typically + reduced by moving typemap code into a support function and then placing + the support function into a fragment.

    +

    For example, if you have a very long typemap

    -%module example
    -%{
    -#include "someheader.h"
    -%}
    +%typemap(in) MyClass * {
    +  MyClass *value = 0;
     
    -// Define a few exception handlers for specific declarations
    -%exception Object::allocate(int) {
    -    try {
    -        $action
    -    } 
    -    catch (MemoryError) {
    -        croak("Out of memory");
    -    }
    -}
    +  ... many lines of marshalling code  ...
     
    -%exception Object::getitem {
    -    try {
    -       $action
    -    }
    -    catch (RangeError) {
    -       croak("Index out of range");
    -    }
    +  $result = value;
     }
    -...
    -// Read a raw header file
    -%include "someheader.h"
     
    -

    Compatibility note: The %exception directive - replaces the functionality provided by the deprecated "except" typemap. - The typemap would allow exceptions to be thrown in the target language - based on the return type of a function and was intended to be a - mechanism for pinpointing specific declarations. However, it never - really worked that well and the new %exception directive is much - better.

    -

    11.1.6 - Special variables for %exception

    -

    The %exception directive supports a few special variables which are - placeholders for code substitution. The following table shows the - available special variables and details what the special variables are - replaced with.

    - - - - - - - - - - - -
    $actionThe actual operation to be performed (a function - call, method invocation, variable access, etc.)
    $nameThe C/C++ symbol name for the function.
    $symnameThe symbol name used internally by SWIG
    $overnameThe extra mangling used in the symbol name for - overloaded method. Expands to nothing if the wrapped method is not - overloaded.
    $wrapnameThe language specific wrapper name (usually a - C function name exported from the shared object/dll)
    $declThe fully qualified C/C++ declaration of the - method being wrapped without the return type
    $fulldeclThe fully qualified C/C++ declaration of the - method being wrapped including the return type
    $parentnameThe parent class name (if any) for a method.
    $parentsymnameThe target language parent class name (if - any) for a method.
    -

    The special variables are often used in situations where method - calls are logged. Exactly which form of the method call needs logging - is up to individual requirements, but the example code below shows all - the possible expansions, plus how an exception message could be - tailored to show the C++ method declaration:

    +

    the same marshalling code is often repeated in several typemaps, + such as "in", "varin", "directorout", etc. SWIG copies the code for + each argument that requires the typemap code, easily leading to code + bloat in the generated code. To eliminate this, define a fragment that + includes the common marshalling code:

    -%exception Special::something {
    -  log("symname: $symname");
    -  log("overname: $overname");
    -  log("wrapname: $wrapname");
    -  log("decl: $decl");
    -  log("fulldecl: $fulldecl");
    -  try {
    -    $action
    -  } 
    -  catch (MemoryError) {
    -      croak("Out of memory in $decl");
    +%fragment("AsMyClass", "header") {
    +  MyClass *AsMyClass(PyObject *obj) {
    +    MyClass *value = 0;
    +
    +    ... many lines of marshalling code  ...
    +
    +    return value;
       }
     }
    -void log(const char *message);
    -struct Special {
    -  void something(const char *c);
    -  void something(int i);
    -};
    +
    +%typemap(in, fragment="AsMyClass") MyClass * {
    +  $result = AsMyClass($input);
    +}
    +
    +%typemap(varin, fragment="AsMyClass") MyClass * {
    +  $result = AsMyClass($input);
    +}
     
    -

    Below shows the expansions for the 1st of the overloaded -something wrapper methods for Perl:

    +

    When the "in" or "varin" typemaps for MyClass are required, the + contents of the fragment called "AsMyClass" is added to the "header" + section within the generated code, and then the typemap code is + emitted. Hence, the method AsMyClass will be generated into + the wrapper code before any typemap code that calls it.

    +

    To define a fragment you need a fragment name, a section name for + generating the fragment code into, and the code itself. See +Code insertion blocks for a full list of section names. Usually the + section name used is "header". Different delimiters can be used:

    -  log("symname: Special_something");
    -  log("overname: __SWIG_0");
    -  log("wrapname: _wrap_Special_something__SWIG_0");
    -  log("decl: Special::something(char const *)");
    -  log("fulldecl: void Special::something(char const *)");
    -  try {
    -    (arg1)->something((char const *)arg2);
    -  } 
    -  catch (MemoryError) {
    -    croak("Out of memory in Special::something(char const *)");
    -  }
    +%fragment("my_name", "header") %{ ... %}
    +%fragment("my_name", "header") { ... }
    +%fragment("my_name", "header") " ... "
     
    -

    11.1.7 Using The SWIG exception - library

    -

    The exception.i library file provides support for creating - language independent exceptions in your interfaces. To use it, simply - put an "%include exception.i" in your interface file. This - creates a function SWIG_exception() that can be used to raise - common scripting language exceptions in a portable manner. For example - :

    +

    and these follow the usual preprocessing rules mentioned in the +Preprocessing delimiters section. The following are some rules and + guidelines for using fragments:

    +
      +
    1. +

      A fragment is added to the wrapping code only once. When using the +MyClass * typemaps above and wrapping the method:

      -// Language independent exception handler
      -%include exception.i       
      -
      -%exception {
      -    try {
      -        $action
      -    } catch(RangeError) {
      -        SWIG_exception(SWIG_ValueError, "Range Error");
      -    } catch(DivisionByZero) {
      -        SWIG_exception(SWIG_DivisionByZero, "Division by zero");
      -    } catch(OutOfMemory) {
      -        SWIG_exception(SWIG_MemoryError, "Out of memory");
      -    } catch(...) {
      -        SWIG_exception(SWIG_RuntimeError,"Unknown exception");
      -    }
      -}
      -
      +void foo(MyClass *a, MyClass *b);
       
      -

      As arguments, SWIG_exception() takes an error type code (an - integer) and an error message string. The currently supported error - types are :

      -
      +

      the generated code will look something like:

      +
      -SWIG_UnknownError
      -SWIG_IOError
      -SWIG_RuntimeError
      -SWIG_IndexError
      -SWIG_TypeError
      -SWIG_DivisionByZero
      -SWIG_OverflowError
      -SWIG_SyntaxError
      -SWIG_ValueError
      -SWIG_SystemError
      -SWIG_AttributeError
      -SWIG_MemoryError
      -SWIG_NullReferenceError
      +MyClass *AsMyClass(PyObject *obj) {
      +  ...
      +}
      +
      +void _wrap_foo(...) {
      +  ....
      +  arg1 = AsMyClass(obj1);
      +  arg2 = AsMyClass(obj2);
      +  ...
      +  foo(arg1, arg2);
      +}
       
      -

      The SWIG_exception() function can also be used in typemaps.

      -

      11.2 Object ownership and - %newobject

      -

      A common problem in some applications is managing proper ownership - of objects. For example, consider a function like this:

      +

      even as there is duplicated typemap code to process both a + and b, the AsMyClass method will be defined only + once.

      +
    2. +
    3. +

      A fragment should only be defined once. If there is more than one + definition, the first definition is the one used. All other definitions + are silently ignored. For example, if you have

      -Foo *blah() {
      -   Foo *f = new Foo();
      -   return f;
      -}
      +%fragment("AsMyClass", "header") { ...definition 1... }
      +....
      +%fragment("AsMyClass", "header") { ...definition 2... }
       
      -

      If you wrap the function blah(), SWIG has no idea that the - return value is a newly allocated object. As a result, the resulting - extension module may produce a memory leak (SWIG is conservative and - will never delete objects unless it knows for certain that the returned - object was newly created).

      -

      To fix this, you can provide an extra hint to the code generator - using the %newobject directive. For example:

      +

      only the first definition is used. In this way you can override the + default fragments in a SWIG library by defining your fragment before + the library %include. Note that this behavior is the opposite + to typemaps, where the last typemap defined/applied prevails. Fragments + follow the first-in-first-out convention since they are intended to be + global, while typemaps are intended to be locally specialized.

      +
    4. +
    5. +

      Fragment names cannot contain commas.

      +
    6. +
    7. +

      A fragment can use one or more additional fragments, for example:

      -%newobject blah;
      -Foo *blah();
      +%fragment("<limits.h>", "header") {
      +  %#include <limits.h>
      +}
      +
      +
      +%fragment("AsMyClass", "header", fragment="<limits.h>") {
      +  MyClass *AsMyClass(PyObject *obj) {
      +    MyClass *value = 0;
      +
      +    ... some marshalling code  ...
      +
      +    if  (ival < CHAR_MIN /*defined in <limits.h>*/) {
      +       ...
      +    } else {
      +       ...
      +    }
      +    ...
      +    return value;
      +  }
      +}
       
      -

      %newobject works exactly like %rename and -%exception. In other words, you can attach it to class members and - parameterized declarations as before. For example:

      +

      in this case, when the "AsMyClass" fragment is emitted, it also + triggers the inclusion of the "<limits.h>" fragment.

      +
    8. +
    9. +

      A fragment can have dependencies on a number of other fragments, for + example:

      -%newobject ::blah();                   // Only applies to global blah
      -%newobject Object::blah(int,double);   // Only blah(int,double) in Object
      -%newobject *::copy;                    // Copy method in all classes
      -...
      +%fragment("bigfragment", "header", fragment="frag1", fragment="frag2", fragment="frag3") "";
       
      -

      When %newobject is supplied, many language modules will - arrange to take ownership of the return value. This allows the value to - be automatically garbage-collected when it is no longer in use. - However, this depends entirely on the target language (a language - module may also choose to ignore the %newobject directive).

      -

      Closely related to %newobject is a special typemap. The - "newfree" typemap can be used to deallocate a newly allocated return - value. It is only available on methods for which %newobject - has been applied and is commonly used to clean-up string results. For - example:

      +

      When the "bigfragment" is used, the three dependent fragments + "frag1", "frag2" and "frag3" are also pulled in. Note that as + "bigframent" is empty (the empty string - ""), it does not add any code + itself, but merely triggers the inclusion of the other fragments.

      +
    10. +
    11. +

      A typemap can also use more than one fragment, but since the syntax + is different, you need to specify the dependent fragments in a comma + separated list. Consider:

      -%typemap(newfree) char * "free($1);";
      -...
      -%newobject strdup;
      -...
      -char *strdup(const char *s);
      +%typemap(in, fragment="frag1,frag2,frag3") {...}
       
      -

      In this case, the result of the function is a string in the target - language. Since this string is a copy of the original result, the data - returned by strdup() is no longer needed. The "newfree" - typemap in the example simply releases this memory.

      -

      As a complement to the %newobject, from SWIG 1.3.28, you - can use the %delobject directive. For example, if you have two - methods, one to create objects and one to destroy them, you can use:

      +

      which is equivalent to:

      -%newobject create_foo;
      -%delobject destroy_foo;
      -...
      -Foo *create_foo();
      -void destroy_foo(Foo *foo);
      +%typemap(in, fragment="bigfragment") {...}
       
      -

      or in a member method as:

      +

      when used with the "bigfragment" defined above.

      +
    12. +
    13. +

      Finally, you can force the inclusion of a fragment at any point in + the generated code as follows:

      -%delobject Foo::destroy;
      -
      -class Foo {
      -public:
      -  void destroy() { delete this;}
      -
      -private:
      -  ~Foo();
      -};
      +%fragment("bigfragment");
       
      -

      %delobject instructs SWIG that the first argument passed to - the method will be destroyed, and therefore, the target language should - not attempt to deallocate it twice. This is similar to use the DISOWN - typemap in the first method argument, and in fact, it also depends on - the target language on implementing the 'disown' mechanism properly.

      -

      The use of %newobject is also integrated with reference - counting and is covered in the C++ - reference counted objects section.

      -

      Compatibility note: Previous versions of SWIG had a special -%new directive. However, unlike %newobject, it only - applied to the next declaration. For example:

      +

      which is very useful inside a template class, for example.

      +
    14. +
    +

    Most readers will probably want to skip the next two sub-sections on + advanced fragment usage unless a desire to really get to grips with + some powerful but tricky macro and fragment usage that is used in parts + of the SWIG typemap library.

    +

    11.11.1 Fragment + type specialization

    +

    Fragments can be type specialized. The syntax is as follows:

    -%new char *strdup(const char *s);
    +%fragment("name", "header") { ...a type independent fragment... }
    +%fragment("name"{type}, "header") { ...a type dependent fragment...  }
     
    -

    For now this is still supported but is deprecated.

    -

    How to shoot yourself in the foot: The %newobject - directive is not a declaration modifier like the old %new - directive. Don't write code like this:

    +

    where type is a C/C++ type. Like typemaps, fragments can + also be used inside templates, for example:

    -%newobject
    -char *strdup(const char *s);
    +template <class T>
    +struct A {
    +  %fragment("incode"{A<T>}, "header") {
    +    ... 'incode' specialized fragment ...
    +  }
    +
    +  %typemap(in, fragment="incode"{A<T>}) {
    +     ... here we use the 'type specialized' fragment "incode"{A<T>} ...
    +  }
    +};
     
    -

    The results might not be what you expect.

    -

    11.3 Features and the %feature - directive

    -

    Both %exception and %newobject are examples of a - more general purpose customization mechanism known as "features." A - feature is simply a user-definable property that is attached to - specific declarations. Features are attached using the %feature - directive. For example:

    +

    11.11.2 Fragments and + automatic typemap specialization

    +

    Since fragments can be type specialized, they can be elegantly used + to specialize typemaps. For example, if you have something like:

    -%feature("except") Object::allocate {
    -    try {
    -        $action
    -    } 
    -    catch (MemoryError) {
    -        croak("Out of memory");
    -    }
    +%fragment("incode"{float}, "header") {
    +  float in_method_float(PyObject *obj) {
    +    ...
    +  }
     }
     
    -%feature("new","1") *::copy;
    +%fragment("incode"{long}, "header") {
    +  float in_method_long(PyObject *obj) {
    +    ...
    +  }
    +}
    +
    +// %my_typemaps macro definition
    +%define %my_typemaps(Type) 
    +%typemap(in, fragment="incode"{Type}) Type {
    +  value = in_method_##Type(obj);
    +}
    +%enddef
    +
    +%my_typemaps(float);
    +%my_typemaps(long);
     
    -

    In fact, the %exception and %newobject directives - are really nothing more than macros involving %feature:

    -
    +

    then the proper "incode"{float} or "incode"{long} + fragment will be used, and the in_method_float and +in_method_long methods will be called whenever the float + or long types are used as input parameters.

    +

    This feature is used a lot in the typemaps shipped in the SWIG + library for some scripting languages. The interested (or very brave) + reader can take a look at the fragments.swg file shipped with SWIG to + see this in action.

    +

    11.12 The run-time type + checker

    +

    Most scripting languages need type information at run-time. This + type information can include how to construct types, how to garbage + collect types, and the inheritance relationships between types. If the + language interface does not provide its own type information storage, + the generated SWIG code needs to provide it.

    +

    Requirements for the type system:

    +
      +
    • Store inheritance and type equivalence information and be able to + correctly re-create the type pointer.
    • +
    • Share type information between modules.
    • +
    • Modules can be loaded in any order, regardless of actual type + dependency.
    • +
    • Avoid the use of dynamically allocated memory, and library/system + calls in general.
    • +
    • Provide a reasonably fast implementation, minimizing the lookup time + for all language modules.
    • +
    • Custom, language specific information can be attached to types.
    • +
    • Modules can be unloaded from the type system.
    • +
    +

    11.12.1 Implementation

    +

    The run-time type checker is used by many, but not all, of SWIG's + supported target languages. The run-time type checker features are not + required and are thus not used for statically typed languages such as + Java and C#. The scripting and scheme based languages rely on it and it + forms a critical part of SWIG's operation for these languages.

    +

    When pointers, arrays, and objects are wrapped by SWIG, they are + normally converted into typed pointer objects. For example, an instance + of Foo * might be a string encoded like this:

    +
    -#define %exception %feature("except")
    -#define %newobject %feature("new","1")
    +_108e688_p_Foo
     
    -

    The name matching rules outlined in the -Ambiguity resolution and renaming section applies to all -%feature directives. In fact the %rename directive is just - a special form of %feature. The matching rules mean that - features are very flexible and can be applied with pinpoint accuracy to - specific declarations if needed. Additionally, if no declaration name - is given, a global feature is said to be defined. This feature is then - attached to every declaration that follows. This is how global - exception handlers are defined. For example:

    +

    At a basic level, the type checker simply restores some type-safety + to extension modules. However, the type checker is also responsible for + making sure that wrapped C++ classes are handled correctly---especially + when inheritance is used. This is especially important when an + extension module makes use of multiple inheritance. For example:

    -/* Define a global exception handler */
    -%feature("except") {
    -   try {
    -     $action
    -   }
    -   ...
    -}
    +class Foo {
    +   int x;
    +};
     
    -... bunch of declarations ...
    +class Bar {
    +   int y;
    +};
    +
    +class FooBar : public Foo, public Bar {
    +   int z;
    +};
     
    -

    The %feature directive can be used with different syntax. - The following are all equivalent:

    -
    +

    When the class FooBar is organized in memory, it contains + the contents of the classes Foo and Bar as well as + its own data members. For example:

    +
    -%feature("except") Object::method { $action };
    -%feature("except") Object::method %{ $action %};
    -%feature("except") Object::method " $action ";
    -%feature("except","$action") Object::method;
    +FooBar --> | -----------|  <-- Foo
    +           |   int x    |
    +           |------------|  <-- Bar
    +           |   int y    |
    +           |------------|
    +           |   int z    |
    +           |------------|
     
    -

    The syntax in the first variation will generate the { } - delimiters used whereas the other variations will not.

    -

    11.3.1 Feature - attributes

    -

    The %feature directive also accepts XML style attributes in - the same way that typemaps do. Any number of attributes can be - specified. The following is the generic syntax for features:

    +

    Because of the way that base class data is stacked together, the + casting of a Foobar * to either of the base classes may change + the actual value of the pointer. This means that it is generally not + safe to represent pointers using a simple integer or a bare void * +---type tags are needed to implement correct handling of pointer values + (and to make adjustments when needed).

    +

    In the wrapper code generated for each language, pointers are + handled through the use of special type descriptors and conversion + functions. For example, if you look at the wrapper code for Python, you + will see code like this:

    -%feature("name","value", attribute1="AttributeValue1") symbol;
    -%feature("name", attribute1="AttributeValue1") symbol {value};
    -%feature("name", attribute1="AttributeValue1") symbol %{value%};
    -%feature("name", attribute1="AttributeValue1") symbol "value";
    +if ((SWIG_ConvertPtr(obj0,(void **) &arg1, SWIGTYPE_p_Foo,1)) == -1) return NULL;
     
    -

    More than one attribute can be specified using a comma separated - list. The Java module is an example that uses attributes in -%feature("except"). The throws attribute specifies the - name of a Java class to add to a proxy method's throws clause. In the - following example, MyExceptionClass is the name of the Java - class for adding to the throws clause.

    +

    In this code, SWIGTYPE_p_Foo is the type descriptor that + describes Foo *. The type descriptor is actually a pointer to + a structure that contains information about the type name to use in the + target language, a list of equivalent typenames (via typedef or + inheritance), and pointer value handling information (if applicable). + The SWIG_ConvertPtr() function is simply a utility function + that takes a pointer object in the target language and a + type-descriptor objects and uses this information to generate a C++ + pointer. However, the exact name and calling conventions of the + conversion function depends on the target language (see language + specific chapters for details).

    +

    The actual type code is in swigrun.swg, and gets inserted near the + top of the generated swig wrapper file. The phrase "a type X that can + cast into a type Y" means that given a type X, it can be converted into + a type Y. In other words, X is a derived class of Y or X is a typedef + of Y. The structure to store type information looks like this:

    -%feature("except", throws="MyExceptionClass") Object::method { 
    -   try {
    -     $action
    -   } catch (...) {
    -     ... code to throw a MyExceptionClass Java exception ...
    -   }
    -};
    +/* Structure to store information on one type */
    +typedef struct swig_type_info {
    +  const char *name;             /* mangled name of this type */
    +  const char *str;              /* human readable name for this type */
    +  swig_dycast_func dcast;       /* dynamic cast function down a hierarchy */
    +  struct swig_cast_info *cast;  /* Linked list of types that can cast into this type */
    +  void *clientdata;             /* Language specific type data */
    +} swig_type_info;
    +
    +/* Structure to store a type and conversion function used for casting */
    +typedef struct swig_cast_info {
    +  swig_type_info *type;          /* pointer to type that is equivalent to this type */
    +  swig_converter_func converter; /* function to cast the void pointers */
    +  struct swig_cast_info *next;   /* pointer to next cast in linked list */
    +  struct swig_cast_info *prev;   /* pointer to the previous cast */
    +} swig_cast_info;
     
    -

    Further details can be obtained from the -Java exception handling section.

    -

    11.3.2 Feature flags

    -

    Feature flags are used to enable or disable a particular feature. - Feature flags are a common but simple usage of %feature and - the feature value should be either 1 to enable or 0 - to disable the feature.

    +

    Each swig_type_info stores a linked list of types that it + is equivalent to. Each entry in this doubly linked list stores a + pointer back to another swig_type_info structure, along with a pointer + to a conversion function. This conversion function is used to solve the + above problem of the FooBar class, correctly returning a pointer to the + type we want.

    +

    The basic problem we need to solve is verifying and building + arguments passed to functions. So going back to the +SWIG_ConvertPtr() function example from above, we are expecting a +Foo * and need to check if obj0 is in fact a Foo * +. From before, SWIGTYPE_p_Foo is just a pointer to the +swig_type_info structure describing Foo *. So we loop + through the linked list of swig_cast_info structures attached + to SWIGTYPE_p_Foo. If we see that the type of obj0 is + in the linked list, we pass the object through the associated + conversion function and then return a positive. If we reach the end of + the linked list without a match, then obj0 can not be + converted to a Foo * and an error is generated.

    +

    Another issue needing to be addressed is sharing type information + between multiple modules. More explicitly, we need to have ONE +swig_type_info for each type. If two modules both use the type, the + second module loaded must lookup and use the swig_type_info structure + from the module already loaded. Because no dynamic memory is used and + the circular dependencies of the casting information, loading the type + information is somewhat tricky, and not explained here. A complete + description is in the Lib/swiginit.swg file (and near the top + of any generated file).

    +

    Each module has one swig_module_info structure which looks like + this:

    -%feature("featurename")          // enables feature
    -%feature("featurename", "1")     // enables feature
    -%feature("featurename", "x")     // enables feature
    -%feature("featurename", "0")     // disables feature
    -%feature("featurename", "")      // clears feature
    +/* Structure used to store module information
    + * Each module generates one structure like this, and the runtime collects
    + * all of these structures and stores them in a circularly linked list.*/
    +typedef struct swig_module_info {
    +  swig_type_info **types;         /* Array of pointers to swig_type_info structs in this module */
    +  int size;                       /* Number of types in this module */
    +  struct swig_module_info *next;  /* Pointer to next element in circularly linked list */
    +  swig_type_info **type_initial;  /* Array of initially generated type structures */
    +  swig_cast_info **cast_initial;  /* Array of initially generated casting structures */
    +  void *clientdata;               /* Language specific module data */
    +} swig_module_info;
     
    -

    Actually any value other than zero will enable the feature. Note - that if the value is omitted completely, the default value becomes -1, thereby enabling the feature. A feature is cleared by specifying - no value, see Clearing - features. The %immutable directive described in the -Creating read-only variables section, is just a macro for -%feature("immutable"), and can be used to demonstrates feature - flags:

    +

    Each module stores an array of pointers to swig_type_info + structures and the number of types in this module. So when a second + module is loaded, it finds the swig_module_info structure for + the first module and searches the array of types. If any of its own + types are in the first module and have already been loaded, it uses + those swig_type_info structures rather than creating new ones. + These swig_module_info structures are chained together in a + circularly linked list.

    +

    11.12.2 Usage

    +

    This section covers how to use these functions from typemaps. To + learn how to call these functions from external files (not the + generated _wrap.c file), see the +External access to the run-time system section.

    +

    When pointers are converted in a typemap, the typemap code often + looks similar to this:

    -                                // features are disabled by default
    -int red;                        // mutable
    -
    -%feature("immutable");          // global enable
    -int orange;                     // immutable
    -
    -%feature("immutable","0");      // global disable
    -int yellow;                     // mutable
    -
    -%feature("immutable","1");      // another form of global enable
    -int green;                      // immutable
    -
    -%feature("immutable","");       // clears the global feature
    -int blue;                       // mutable
    +%typemap(in) Foo * {
    +  if ((SWIG_ConvertPtr($input, (void **) &$1, $1_descriptor)) == -1) return NULL;
    +}
     
    -

    Note that features are disabled by default and must be explicitly - enabled either globally or by specifying a targeted declaration. The - above intersperses SWIG directives with C code. Of course you can - target features explicitly, so the above could also be rewritten as:

    +

    The most critical part is the typemap is the use of the +$1_descriptor special variable. When placed in a typemap, this is + expanded into the SWIGTYPE_* type descriptor object above. As + a general rule, you should always use $1_descriptor instead of + trying to hard-code the type descriptor name directly.

    +

    There is another reason why you should always use the +$1_descriptor variable. When this special variable is expanded, + SWIG marks the corresponding type as "in use." When type-tables and + type information is emitted in the wrapper file, descriptor information + is only generated for those datatypes that were actually used in the + interface. This greatly reduces the size of the type tables and + improves efficiency.

    +

    Occasionally, you might need to write a typemap that needs to + convert pointers of other types. To handle this, the special variable + macro $descriptor(type) covered earlier can be used to + generate the SWIG type descriptor name for any C datatype. For example:

    -%feature("immutable","1") orange;
    -%feature("immutable","1") green;
    -int red;                        // mutable
    -int orange;                     // immutable
    -int yellow;                     // mutable
    -int green;                      // immutable
    -int blue;                       // mutable
    +%typemap(in) Foo * {
    +  if ((SWIG_ConvertPtr($input, (void **) &$1, $1_descriptor)) == -1) {
    +     Bar *temp;
    +     if ((SWIG_ConvertPtr($input, (void **) &temp, $descriptor(Bar *)) == -1) {
    +         return NULL;
    +     }
    +     $1 = (Foo *) temp;
    +  }
    +}
     
    -

    The above approach allows for the C declarations to be separated - from the SWIG directives for when the C declarations are parsed from a - C header file. The logic above can of course be inverted and rewritten - as:

    +

    The primary use of $descriptor(type) is when writing + typemaps for container objects and other complex data structures. There + are some restrictions on the argument---namely it must be a fully + defined C datatype. It can not be any of the special typemap variables.

    +

    In certain cases, SWIG may not generate type-descriptors like you + expect. For example, if you are converting pointers in some + non-standard way or working with an unusual combination of interface + files and modules, you may find that SWIG omits information for a + specific type descriptor. To fix this, you may need to use the +%types directive. For example:

    -%feature("immutable","1");
    -%feature("immutable","0") red;
    -%feature("immutable","0") yellow;
    -%feature("immutable","0") blue;
    -int red;                        // mutable
    -int orange;                     // immutable
    -int yellow;                     // mutable
    -int green;                      // immutable
    -int blue;                       // mutable
    +%types(int *, short *, long *, float *, double *);
     
    -

    As hinted above for %immutable, most feature flags can also - be specified via alternative syntax. The alternative syntax is just a - macro in the swig.swg Library file. The following shows the - alternative syntax for the imaginary featurename feature:

    +

    When %types is used, SWIG generates type-descriptor + information even if those datatypes never appear elsewhere in the + interface file.

    +

    Further details about the run-time type checking can be found in the + documentation for individual language modules. Reading the source code + may also help. The file Lib/swigrun.swg in the SWIG library + contains all of the source of the generated code for type-checking. + This code is also included in every generated wrapped file so you + probably just look at the output of SWIG to get a better sense for how + types are managed.

    +

    11.13 Typemaps and overloading

    +

    This section does not apply to the statically typed languages like + Java and C#, where overloading of the types is handled much like C++ by + generating overloaded methods in the target language. In many of the + other target languages, SWIG still fully supports C++ overloaded + methods and functions. For example, if you have a collection of + functions like this:

    -%featurename       // equivalent to %feature("featurename", "1") ie enables feature
    -%nofeaturename     // equivalent to %feature("featurename", "0") ie disables feature
    -%clearfeaturename  // equivalent to %feature("featurename", "")  ie clears feature
    +int foo(int x);
    +int foo(double x);
    +int foo(char *s, int y);
     
    -

    The concept of clearing features is discussed next.

    -

    11.3.3 Clearing - features

    -

    A feature stays in effect until it is explicitly cleared. A feature - is cleared by supplying a %feature directive with no value. - For example %feature("name",""). A cleared feature means that - any feature exactly matching any previously defined feature is no - longer used in the name matching rules. So if a feature is cleared, it - might mean that another name matching rule will apply. To clarify, - let's consider the except feature again (%exception):

    +

    You can access the functions in a normal way from the scripting + interpreter:

    +
    +
    +# Python
    +foo(3)           # foo(int)
    +foo(3.5)         # foo(double)
    +foo("hello",5)   # foo(char *, int)
    +
    +# Tcl
    +foo 3            # foo(int)
    +foo 3.5          # foo(double)
    +foo hello 5      # foo(char *, int)
    +
    +
    +

    To implement overloading, SWIG generates a separate wrapper function + for each overloaded method. For example, the above functions would + produce something roughly like this:

    -// Define global exception handler
    -%feature("except") {
    -    try {
    -        $action
    -    } catch (...) {
    -        croak("Unknown C++ exception");
    -    }
    +// wrapper pseudocode
    +_wrap_foo_0(argc, args[]) {       // foo(int)
    +   int arg1;
    +   int result;
    +   ...
    +   arg1 = FromInteger(args[0]);
    +   result = foo(arg1);
    +   return ToInteger(result);
     }
     
    -// Define exception handler for all clone methods to log the method calls
    -%feature("except") *::clone() {
    -    try {
    -        logger.info("$action");
    -        $action
    -    } catch (...) {
    -        croak("Unknown C++ exception");
    -    }
    +_wrap_foo_1(argc, args[]) {       // foo(double)
    +   double arg1;
    +   int result;
    +   ...
    +   arg1 = FromDouble(args[0]);
    +   result = foo(arg1);
    +   return ToInteger(result);
     }
     
    -... initial set of class declarations with clone methods ...
    -
    -// clear the previously defined feature
    -%feature("except","") *::clone();
    +_wrap_foo_2(argc, args[]) {       // foo(char *, int)
    +   char *arg1;
    +   int   arg2;
    +   int result;
    +   ...
    +   arg1 = FromString(args[0]);
    +   arg2 = FromInteger(args[1]);
    +   result = foo(arg1,arg2);
    +   return ToInteger(result);
    +}
     
    -... final set of class declarations with clone methods ...
     
    -

    In the above scenario, the initial set of clone methods will log all - method invocations from the target language. This specific feature is - cleared for the final set of clone methods. However, these clone - methods will still have an exception handler (without logging) as the - next best feature match for them is the global exception handler.

    -

    Note that clearing a feature is not always the same as disabling it. - Clearing the feature above with %feature("except","") *::clone() - is not the same as specifying %feature("except","0") *::clone() -. The former will disable the feature for clone methods - the feature is - still a better match than the global feature. If on the other hand, no - global exception handler had been defined at all, then clearing the - feature would be the same as disabling it as no other feature would - have matched.

    -

    Note that the feature must match exactly for it to be cleared by any - previously defined feature. For example the following attempt to clear - the initial feature will not work:

    +

    Next, a dynamic dispatch function is generated:

    -%feature("except") clone() { logger.info("$action"); $action }
    -%feature("except","") *::clone();
    +_wrap_foo(argc, args[]) {
    +   if (argc == 1) {
    +       if (IsInteger(args[0])) {
    +           return _wrap_foo_0(argc,args);
    +       } 
    +       if (IsDouble(args[0])) {
    +           return _wrap_foo_1(argc,args);
    +       }
    +   }
    +   if (argc == 2) {
    +       if (IsString(args[0]) && IsInteger(args[1])) {
    +          return _wrap_foo_2(argc,args);
    +       }
    +   }
    +   error("No matching function!\n");
    +}
     
    -

    but this will:

    -
    +

    The purpose of the dynamic dispatch function is to select the + appropriate C++ function based on argument types---a task that must be + performed at runtime in most of SWIG's target languages.

    +

    The generation of the dynamic dispatch function is a relatively + tricky affair. Not only must input typemaps be taken into account + (these typemaps can radically change the types of arguments accepted), + but overloaded methods must also be sorted and checked in a very + specific order to resolve potential ambiguity. A high-level overview of + this ranking process is found in the "SWIG and C++ +" chapter. What isn't mentioned in that chapter is the mechanism by + which it is implemented---as a collection of typemaps.

    +

    To support dynamic dispatch, SWIG first defines a general purpose + type hierarchy as follows:

    +
    -%feature("except") clone() { logger.info("$action"); $action }
    -%feature("except","") clone();
    +Symbolic Name                   Precedence Value
    +------------------------------  ------------------
    +SWIG_TYPECHECK_POINTER           0  
    +SWIG_TYPECHECK_VOIDPTR           10 
    +SWIG_TYPECHECK_BOOL              15 
    +SWIG_TYPECHECK_UINT8             20 
    +SWIG_TYPECHECK_INT8              25 
    +SWIG_TYPECHECK_UINT16            30 
    +SWIG_TYPECHECK_INT16             35 
    +SWIG_TYPECHECK_UINT32            40 
    +SWIG_TYPECHECK_INT32             45 
    +SWIG_TYPECHECK_UINT64            50 
    +SWIG_TYPECHECK_INT64             55 
    +SWIG_TYPECHECK_UINT128           60 
    +SWIG_TYPECHECK_INT128            65 
    +SWIG_TYPECHECK_INTEGER           70 
    +SWIG_TYPECHECK_FLOAT             80 
    +SWIG_TYPECHECK_DOUBLE            90 
    +SWIG_TYPECHECK_COMPLEX           100 
    +SWIG_TYPECHECK_UNICHAR           110 
    +SWIG_TYPECHECK_UNISTRING         120 
    +SWIG_TYPECHECK_CHAR              130 
    +SWIG_TYPECHECK_STRING            140 
    +SWIG_TYPECHECK_BOOL_ARRAY        1015 
    +SWIG_TYPECHECK_INT8_ARRAY        1025 
    +SWIG_TYPECHECK_INT16_ARRAY       1035 
    +SWIG_TYPECHECK_INT32_ARRAY       1045 
    +SWIG_TYPECHECK_INT64_ARRAY       1055 
    +SWIG_TYPECHECK_INT128_ARRAY      1065 
    +SWIG_TYPECHECK_FLOAT_ARRAY       1080 
    +SWIG_TYPECHECK_DOUBLE_ARRAY      1090 
    +SWIG_TYPECHECK_CHAR_ARRAY        1130 
    +SWIG_TYPECHECK_STRING_ARRAY      1140 
     
    -

    SWIG provides macros for disabling and clearing features. Many of - these can be found in the swig.swg library file. The typical - pattern is to define three macros; one to define the feature itself, - one to disable the feature and one to clear the feature. The three - macros below show this for the "except" feature:

    +

    (These precedence levels are defined in swig.swg, a library + file that's included by all target language modules.)

    +

    In this table, the precedence-level determines the order in which + types are going to be checked. Low values are always checked before + higher values. For example, integers are checked before floats, single + values are checked before arrays, and so forth.

    +

    Using the above table as a guide, each target language defines a + collection of "typecheck" typemaps. The following excerpt from the + Python module illustrates this:

    -#define %exception      %feature("except")
    -#define %noexception    %feature("except","0")
    -#define %clearexception %feature("except","")
    +/* Python type checking rules */
    +/* Note:  %typecheck(X) is a macro for %typemap(typecheck,precedence=X) */
    +
    +%typecheck(SWIG_TYPECHECK_INTEGER)
    +  int, short, long,
    +  unsigned int, unsigned short, unsigned long,
    +  signed char, unsigned char,
    +  long long, unsigned long long,
    +  const int &, const short &, const long &,
    +  const unsigned int &, const unsigned short &, const unsigned long &,
    +  const long long &, const unsigned long long &,
    +  enum SWIGTYPE,
    +  bool, const bool &
    +{
    +  $1 = (PyInt_Check($input) || PyLong_Check($input)) ? 1 : 0;
    +}
    +
    +%typecheck(SWIG_TYPECHECK_DOUBLE)
    +  float, double,
    +  const float &, const double &
    +{
    +  $1 = (PyFloat_Check($input) || PyInt_Check($input) || PyLong_Check($input)) ? 1 : 0;
    +}
    +
    +%typecheck(SWIG_TYPECHECK_CHAR) char {
    +  $1 = (PyString_Check($input) && (PyString_Size($input) == 1)) ? 1 : 0;
    +}
    +
    +%typecheck(SWIG_TYPECHECK_STRING) char * {
    +  $1 = PyString_Check($input) ? 1 : 0;
    +}
    +
    +%typecheck(SWIG_TYPECHECK_POINTER) SWIGTYPE *, SWIGTYPE &, SWIGTYPE [] {
    +  void *ptr;
    +  if (SWIG_ConvertPtr($input, (void **) &ptr, $1_descriptor, 0) == -1) {
    +    $1 = 0;
    +    PyErr_Clear();
    +  } else {
    +    $1 = 1;
    +  }
    +}
    +
    +%typecheck(SWIG_TYPECHECK_POINTER) SWIGTYPE {
    +  void *ptr;
    +  if (SWIG_ConvertPtr($input, (void **) &ptr, $&1_descriptor, 0) == -1) {
    +    $1 = 0;
    +    PyErr_Clear();
    +  } else {
    +    $1 = 1;
    +  }
    +}
    +
    +%typecheck(SWIG_TYPECHECK_VOIDPTR) void * {
    +  void *ptr;
    +  if (SWIG_ConvertPtr($input, (void **) &ptr, 0, 0) == -1) {
    +    $1 = 0;
    +    PyErr_Clear();
    +  } else {
    +    $1 = 1;
    +  }
    +}
    +
    +%typecheck(SWIG_TYPECHECK_POINTER) PyObject *
    +{
    +  $1 = ($input != 0);
    +}
     
    -

    11.3.4 Features - and default arguments

    -

    SWIG treats methods with default arguments as separate overloaded - methods as detailed in the default - arguments section. Any %feature targeting a method with - default arguments will apply to all the extra overloaded methods that - SWIG generates if the default arguments are specified in the feature. - If the default arguments are not specified in the feature, then the - feature will match that exact wrapper method only and not the extra - overloaded methods that SWIG generates. For example:

    +

    It might take a bit of contemplation, but this code has merely + organized all of the basic C++ types, provided some simple + type-checking code, and assigned each type a precedence value.

    +

    Finally, to generate the dynamic dispatch function, SWIG uses the + following algorithm:

    +
      +
    • Overloaded methods are first sorted by the number of required + arguments.
    • +
    • Methods with the same number of arguments are then sorted by + precedence values of argument types.
    • +
    • Typecheck typemaps are then emitted to produce a dispatch function + that checks arguments in the correct order.
    • +
    +

    If you haven't written any typemaps of your own, it is unnecessary + to worry about the typechecking rules. However, if you have written new + input typemaps, you might have to supply a typechecking rule as well. + An easy way to do this is to simply copy one of the existing + typechecking rules. Here is an example,

    -%feature("except") void hello(int i=0, double d=0.0) { ... }
    -void hello(int i=0, double d=0.0);
    +// Typemap for a C++ string
    +%typemap(in) std::string {
    +    if (PyString_Check($input)) {
    +         $1 = std::string(PyString_AsString($input));
    +     } else {
    +         SWIG_exception(SWIG_TypeError, "string expected");
    +     }
    +}
    +// Copy the typecheck code for "char *".  
    +%typemap(typecheck) std::string = char *;
     
    -

    will apply the feature to all three wrapper methods, that is:

    +

    The bottom line: If you are writing new typemaps and you are using + overloaded methods, you will probably have to write new typecheck code + or copy and modify existing typecheck code.

    +

    If you write a typecheck typemap and omit the precedence level, for + example commenting it out as shown below:

    -void hello(int i, double d);
    -void hello(int i);
    -void hello();
    +%typemap(typecheck /*,precedence=SWIG_TYPECHECK_INTEGER*/) int {
    +   $1 = PyInt_Check($input) ? 1 : 0;
    +}
     
    -

    If the default arguments are not specified in the feature:

    -
    +

    then the type is given a precedence higher than any other known + precedence level and a warning is issued:

    +
    -%feature("except") void hello(int i, double d) { ... }
    -void hello(int i=0, double d=0.0);
    +example.i:18: Warning 467: Overloaded method foo(int) not supported (incomplete type checking rule - no precedence level in typecheck typemap for 'int').
     
    -

    then the feature will only apply to this wrapper method:

    +

    Notes:

    +
      +
    • Typecheck typemaps are not used for non-overloaded methods. Because + of this, it is still always necessary to check types in any "in" + typemaps.
    • +
    • The dynamic dispatch process is only meant to be a heuristic. There + are many corner cases where SWIG simply can't disambiguate types to the + same degree as C++. The only way to resolve this ambiguity is to use + the %rename directive to rename one of the overloaded methods + (effectively eliminating overloading).
    • +
    • Typechecking may be partial. For example, if working with arrays, + the typecheck code might simply check the type of the first array + element and use that to dispatch to the correct function. Subsequent + "in" typemaps would then perform more extensive type-checking.
    • +
    • Make sure you read the section on overloading in the " +SWIG and C++" chapter.
    • +
    +

    11.14 More about %apply and %clear

    +

    In order to implement certain kinds of program behavior, it is + sometimes necessary to write sets of typemaps. For example, to support + output arguments, one often writes a set of typemaps like this:

    -void hello(int i, double d);
    +%typemap(in,numinputs=0) int *OUTPUT (int temp) {
    +   $1 = &temp;
    +}
    +%typemap(argout) int *OUTPUT {
    +   // return value somehow
    +}
     
    -

    and not these wrapper methods:

    +

    To make it easier to apply the typemap to different argument types + and names, the %apply directive performs a copy of all + typemaps from one type to another. For example, if you specify this,

    -void hello(int i);
    -void hello();
    +%apply int *OUTPUT { int *retvalue, int32 *output };
     
    -

    If compactdefaultargs are being - used, then the difference between specifying or not specifying default - arguments in a feature is not applicable as just one wrapper is - generated.

    -

    Compatibility note: The different behaviour of features - specified with or without default arguments was introduced in - SWIG-1.3.23 when the approach to wrapping methods with default - arguments was changed.

    -

    11.3.5 Feature example

    -

    As has been shown earlier, the intended use for the %feature - directive is as a highly flexible customization mechanism that can be - used to annotate declarations with additional information for use by - specific target language modules. Another example is in the Python - module. You might use %feature to rewrite proxy/shadow class - code as follows:

    +

    then all of the int *OUTPUT typemaps are copied to int + *retvalue and int32 *output.

    +

    However, there is a subtle aspect of %apply that needs more + description. Namely, %apply does not overwrite a typemap rule + if it is already defined for the target datatype. This behavior allows + you to do two things:

    +
      +
    • You can specialize parts of a complex typemap rule by first defining + a few typemaps and then using %apply to incorporate the + remaining pieces.
    • +
    • Sets of different typemaps can be applied to the same datatype using + repeated %apply directives.
    • +
    +

    For example:

    -%module example
    -%rename(bar_id) bar(int,double);
    +%typemap(in) int *INPUT (int temp) {
    +   temp = ... get value from $input ...;
    +   $1 = &temp;
    +}
     
    -// Rewrite bar() to allow some nice overloading
    +%typemap(check) int *POSITIVE {
    +   if (*$1 <= 0) {
    +      SWIG_exception(SWIG_ValueError,"Expected a positive number!\n");
    +      return NULL;
    +   }
    +}
     
    -%feature("shadow") Foo::bar(int) %{
    -def bar(*args):
    -    if len(args) == 3:
    -         return apply(examplec.Foo_bar_id,args)
    -    return apply(examplec.Foo_bar,args)
    -%}
    -    
    -class Foo {
    -public:
    -    int bar(int x);
    -    int bar(int x, double y);
    +...
    +%apply int *INPUT     { int *invalue };
    +%apply int *POSITIVE  { int *invalue };
    +
    +
    +

    Since %apply does not overwrite or replace any existing + rules, the only way to reset behavior is to use the %clear + directive. %clear removes all typemap rules defined for a + specific datatype. For example:

    +
    +
    +%clear int *invalue;
    +
    +
    +

    11.15 Passing data between typemaps

    +

    It is also important to note that the primary use of local variables + is to create stack-allocated objects for temporary use inside a wrapper + function (this is faster and less-prone to error than allocating data + on the heap). In general, the variables are not intended to pass + information between different types of typemaps. However, this can be + done if you realize that local names have the argument number appended + to them. For example, you could do this:

    +
    +
    +%typemap(in) int *(int temp) {
    +   temp = (int) PyInt_AsLong($input);
    +   $1 = &temp;
    +}
    +
    +%typemap(argout) int * {
    +   PyObject *o = PyInt_FromLong(temp$argnum);
    +   ...
     }
     
    -

    Further details of %feature usage is described in the - documentation for specific language modules.

    +

    In this case, the $argnum variable is expanded into the + argument number. Therefore, the code will reference the appropriate + local such as temp1 and temp2. It should be noted + that there are plenty of opportunities to break the universe here and + that accessing locals in this manner should probably be avoided. At the + very least, you should make sure that the typemaps sharing information + have exactly the same types and names.

    +

    11.16 C++ "this" pointer

    +

    All the rules discussed for typemaps apply to C++ as well as C. + However in addition C++ passes an extra parameter into every non-static + class method -- the this pointer. Occasionally it can be + useful to apply a typemap to this pointer (for example to check and + make sure this is non-null before deferencing). Actually, C + also has an the equivalent of the this pointer which is used + when accessing variables in a C struct.

    +

    In order to customise the this pointer handling, target a + variable named self in your typemaps. self is the + name SWIG uses to refer to the extra parameter in wrapped functions.

    +

    For example, if wrapping for Java generation:

    +
    +
    +%typemap(check) SWIGTYPE *self %{
    +if (!$1) {
    +  SWIG_JavaThrowException(jenv, SWIG_JavaNullPointerException,
    +    "invalid native object; delete() likely already called");
    +  return $null;
    +}
    +%}
    +
    +
    +

    In the above case, the $1 variable is expanded into the + argument name that SWIG is using as the this pointer. SWIG + will then insert the check code before the actual C++ class method is + called, and will raise an exception rather than crash the Java virtual + machine. The generated code will look something like:

    +
    +
    +  if (!arg1) {
    +    SWIG_JavaThrowException(jenv, SWIG_JavaNullPointerException,
    +      "invalid native object; delete() likely already called");
    +    return ;
    +  }
    +  (arg1)->wrappedFunction(...);
    +
    +
    +

    Note that if you have a parameter named self then it will + also match the typemap. One work around is to create an interface file + that wraps the method, but gives the argument a name other than +self.

    +

    11.17 Where to go for more information?

    +

    The best place to find out more information about writing typemaps + is to look in the SWIG library. Most language modules define all of + their default behavior using typemaps. These are found in files such as + python.swg, perl5.swg, tcl8.swg and so + forth. The typemaps.i file in the library also contains + numerous examples. You should look at these files to get a feel for how + to define typemaps of your own. Some of the language modules support + additional typemaps and further information is available in the + individual chapters for each target language. There you may also find + more hands-on practical examples.


    -

    12 Contracts

    +

    12 Customization Features

    -

    A common problem that arises when wrapping C libraries is that of - maintaining reliability and checking for errors. The fact of the matter - is that many C programs are notorious for not providing error checks. - Not only that, when you expose the internals of an application as a - library, it often becomes possible to crash it simply by providing bad - inputs or using it in a way that wasn't intended.

    -

    This chapter describes SWIG's support for software contracts. In the - context of SWIG, a contract can be viewed as a runtime constraint that - is attached to a declaration. For example, you can easily attach - argument checking rules, check the output values of a function and - more. When one of the rules is violated by a script, a runtime - exception is generated rather than having the program continue to - execute.

    -

    12.1 The %contract directive

    -

    Contracts are added to a declaration using the %contract directive. - Here is a simple example:

    +

    In many cases, it is desirable to change the default wrapping of + particular declarations in an interface. For example, you might want to + provide hooks for catching C++ exceptions, add assertions, or provide + hints to the underlying code generator. This chapter describes some of + these customization techniques. First, a discussion of exception + handling is presented. Then, a more general-purpose customization + mechanism known as "features" is described.

    +

    12.1 Exception handling with + %exception

    +

    The %exception directive allows you to define a general + purpose exception handler. For example, you can specify the following:

    -%contract sqrt(double x) {
    -require:
    -    x >= 0;
    -ensure:
    -    sqrt >= 0;
    +%exception {
    +    try {
    +        $action
    +    }
    +    catch (RangeError) {
    +        ... handle error ...
    +    }
     }
    -
    -...
    -double sqrt(double);
    -
    -
    -

    In this case, a contract is being added to the sqrt() - function. The %contract directive must always appear before - the declaration in question. Within the contract there are two - sections, both of which are optional. The require: section - specifies conditions that must hold before the function is called. - Typically, this is used to check argument values. The ensure: - section specifies conditions that must hold after the function is - called. This is often used to check return values or the state of the - program. In both cases, the conditions that must hold must be specified - as boolean expressions.

    -

    In the above example, we're simply making sure that sqrt() returns a - non-negative number (if it didn't, then it would be broken in some - way).

    -

    Once a contract has been specified, it modifies the behavior of the - resulting module. For example:

    -
    -
    ->>> example.sqrt(2)
    -1.4142135623730951
    ->>> example.sqrt(-2)
    -Traceback (most recent call last):
    -  File "<stdin>", line 1, in ?
    -RuntimeError: Contract violation: require: (arg1>=0)
    ->>>
     
    -

    12.2 %contract and classes

    -

    The %contract directive can also be applied to class - methods and constructors. For example:

    +

    How the exception is handled depends on the target language, for + example, Python:

    -%contract Foo::bar(int x, int y) {
    -require:
    -   x > 0;
    -ensure:
    -   bar > 0;
    -}
    -
    -%contract Foo::Foo(int a) {
    -require:
    -   a > 0;
    +%exception {
    +    try {
    +        $action
    +    }
    +    catch (RangeError) {
    +        PyErr_SetString(PyExc_IndexError,"index out-of-bounds");
    +        SWIG_fail;
    +    }
     }
    -
    -class Foo {
    -public:
    -    Foo(int);
    -    int bar(int, int);
    -};
     
    -

    The way in which %contract is applied is exactly the same - as the %feature directive. Thus, any contract that you - specified for a base class will also be attached to inherited methods. - For example:

    +

    When defined, the code enclosed in braces is inserted directly into + the low-level wrapper functions. The special variable $action + is one of a few +%exception special variables supported and gets replaced with the + actual operation to be performed (a function call, method invocation, + attribute access, etc.). An exception handler remains in effect until + it is explicitly deleted. This is done by using either %exception + or %noexception with no code. For example:

    -class Spam : public Foo {
    -public:
    -   int bar(int,int);    // Gets contract defined for Foo::bar(int,int)
    -};
    +%exception;   // Deletes any previously defined handler
     
    -

    In addition to this, separate contracts can be applied to both the - base class and a derived class. For example:

    +

    Compatibility note: Previous versions of SWIG used a special + directive %except for exception handling. That directive is + deprecated--%exception provides the same functionality, but is + substantially more flexible.

    +

    12.1.1 Handling exceptions in C code

    +

    C has no formal exception handling mechanism so there are several + approaches that might be used. A somewhat common technique is to simply + set a special error code. For example:

    -%contract Foo::bar(int x, int) {
    -require:
    -    x > 0;
    -}
    +/* File : except.c */
     
    -%contract Spam::bar(int, int y) {
    -require:
    -    y > 0;
    +static char error_message[256];
    +static int error_status = 0;
    +
    +void throw_exception(char *msg) {
    +  strncpy(error_message,msg,256);
    +  error_status = 1;
     }
     
    -class Foo {
    -public:
    -    int bar(int,int);   // Gets Foo::bar contract.
    -};
    +void clear_exception() {
    +  error_status = 0;
    +}
    +char *check_exception() {
    +  if (error_status)
    +    return error_message;
    +  else
    +    return NULL;
    +}
     
    -class Spam : public Foo {
    -public:
    -     int bar(int,int);   // Gets Foo::bar and Spam::bar contract
    -};
     
    -

    When more than one contract is applied, the conditions specified in - a "require:" section are combined together using a logical-AND - operation. In other words conditions specified for the base class and - conditions specified for the derived class all must hold. In the above - example, this means that both the arguments to Spam::bar must - be positive.

    -

    12.3 Constant aggregation and - %aggregate_check

    -

    Consider an interface file that contains the following code:

    +

    To use these functions, functions simply call throw_exception() + to indicate an error occurred. For example :

    -#define  UP     1
    -#define  DOWN   2
    -#define  RIGHT  3
    -#define  LEFT   4
    -
    -void move(SomeObject *, int direction, int distance);
    +double inv(double x) {
    +  if (x != 0)
    +    return 1.0/x;
    +  else {
    +    throw_exception("Division by zero");
    +    return 0;
    +  }
    +}
     
    -

    One thing you might want to do is impose a constraint on the - direction parameter to make sure it's one of a few accepted values. To - do that, SWIG provides an easy to use macro %aggregate_check() that - works like this:

    +

    To catch the exception, you can write a simple exception handler + such as the following (shown for Perl5) :

    -%aggregate_check(int, check_direction, UP, DOWN, LEFT, RIGHT);
    +%exception {
    +  char *err;
    +  clear_exception();
    +  $action
    +  if ((err = check_exception())) {
    +    croak(err);
    +  }
    +}
     
    -

    This merely defines a utility function of the form

    +

    In this case, when an error occurs, it is translated into a Perl + error. Each target language has its own approach to creating a runtime + error/exception in and for Perl it is the croak method shown + above.

    +

    12.1.2 Exception handling with longjmp() +

    +

    Exception handling can also be added to C code using the +<setjmp.h> library. Here is a minimalistic implementation that + relies on the C preprocessor :

    -int check_direction(int x);
    +/* File : except.c
    +   Just the declaration of a few global variables we're going to use */
    +
    +#include <setjmp.h>
    +jmp_buf exception_buffer;
    +int exception_status;
    +
    +/* File : except.h */
    +#include <setjmp.h>
    +extern jmp_buf exception_buffer;
    +extern int exception_status;
    +
    +#define try if ((exception_status = setjmp(exception_buffer)) == 0)
    +#define catch(val) else if (exception_status == val)
    +#define throw(val) longjmp(exception_buffer,val)
    +#define finally else
    +
    +/* Exception codes */
    +
    +#define RangeError     1
    +#define DivisionByZero 2
    +#define OutOfMemory    3
    +
     
    -

    That checks the argument x to see if it is one of the values listed. - This utility function can be used in contracts. For example:

    +

    Now, within a C program, you can do the following :

    -%aggregate_check(int, check_direction, UP, DOWN, RIGHT, LEFT);
    -
    -%contract move(SomeObject *, int direction, in) {
    -require:
    -     check_direction(direction);
    +double inv(double x) {
    +  if (x)
    +    return 1.0/x;
    +  else
    +    throw(DivisionByZero);
     }
     
    -#define  UP     1
    -#define  DOWN   2
    -#define  RIGHT  3
    -#define  LEFT   4
    -
    -void move(SomeObject *, int direction, int distance);
     
    -

    Alternatively, it can be used in typemaps and other directives. For - example:

    +

    Finally, to create a SWIG exception handler, write the following :

    -%aggregate_check(int, check_direction, UP, DOWN, RIGHT, LEFT);
    +%{
    +#include "except.h"
    +%}
     
    -%typemap(check) int direction {
    -    if (!check_direction($1)) SWIG_exception(SWIG_ValueError, "Bad direction");
    +%exception {
    +  try {
    +    $action
    +  } catch(RangeError) {
    +    croak("Range Error");
    +  } catch(DivisionByZero) {
    +    croak("Division by zero");
    +  } catch(OutOfMemory) {
    +    croak("Out of memory");
    +  } finally {
    +    croak("Unknown exception");
    +  }
     }
    -
    -#define  UP     1
    -#define  DOWN   2
    -#define  RIGHT  3
    -#define  LEFT   4
    -
    -void move(SomeObject *, int direction, int distance);
     
    -

    Regrettably, there is no automatic way to perform similar checks - with enums values. Maybe in a future release.

    -

    12.4 Notes

    -

    Contract support was implemented by Songyan (Tiger) Feng and first - appeared in SWIG-1.3.20.

    -
    -

    13 Variable Length Arguments

    - - - - -

    (a.k.a, "The horror. The horror.")

    -

    This chapter describes the problem of wrapping functions that take a - variable number of arguments. For instance, generating wrappers for the - C printf() family of functions.

    -

    This topic is sufficiently advanced to merit its own chapter. In - fact, support for varargs is an often requested feature that was first - added in SWIG-1.3.12. Most other wrapper generation tools have wisely - chosen to avoid this issue.

    -

    13.1 Introduction

    -

    Some C and C++ programs may include functions that accept a variable - number of arguments. For example, most programmers are familiar with - functions from the C library such as the following:

    +

    Note: This implementation is only intended to illustrate the general + idea. To make it work better, you'll need to modify it to handle nested + try declarations.

    +

    12.1.3 Handling C++ exceptions

    +

    Handling C++ exceptions is also straightforward. For example:

    -int printf(const char *fmt, ...)
    -int fprintf(FILE *, const char *fmt, ...);
    -int sprintf(char *s, const char *fmt, ...);
    +%exception {
    +  try {
    +    $action
    +  } catch(RangeError) {
    +    croak("Range Error");
    +  } catch(DivisionByZero) {
    +    croak("Division by zero");
    +  } catch(OutOfMemory) {
    +    croak("Out of memory");
    +  } catch(...) {
    +    croak("Unknown exception");
    +  }
    +}
    +
     
    -

    Although there is probably little practical purpose in wrapping - these specific C library functions in a scripting language (what would - be the point?), a library may include its own set of special functions - based on a similar API. For example:

    +

    The exception types need to be declared as classes elsewhere, + possibly in a header file :

    -int  traceprintf(const char *fmt, ...);
    +class RangeError {};
    +class DivisionByZero {};
    +class OutOfMemory {};
     
    -

    In this case, you may want to have some kind of access from the - target language.

    -

    Before describing the SWIG implementation, it is important to - discuss the common uses of varargs that you are likely to encounter in - real programs. Obviously, there are the printf() style output - functions as shown. Closely related to this would be scanf() - style input functions that accept a format string and a list of - pointers into which return values are placed. However, variable length - arguments are also sometimes used to write functions that accept a - NULL-terminated list of pointers. A good example of this would be a - function like this:

    +

    12.1.4 Exception handlers for + variables

    +

    By default all variables will ignore %exception, so it is + effectively turned off for all variables wrappers. This applies to + global variables, member variables and static member variables. The + approach is certainly a logical one when wrapping variables in C. + However, in C++, it is quite possible for an exception to be thrown + while the variable is being assigned. To ensure %exception is + used when wrapping variables, it needs to be 'turned on' using the +%allowexception feature. Note that %allowexception is just + a macro for %feature("allowexcept"), that is, it is a feature + called "allowexcept". Any variable which has this feature attached to + it, will then use the %exception feature, but of course, only + if there is a %exception attached to the variable in the first + place. The %allowexception feature works like any other + feature and so can be used globally or for selective variables.

    -int execlp(const char *path, const char *arg1, ...);
    -...
    +%allowexception;                // turn on globally
    +%allowexception Klass::MyVar;   // turn on for a specific variable
     
    -/* Example */
    -execlp("ls","ls","-l",NULL);
    +%noallowexception Klass::MyVar; // turn off for a specific variable
    +%noallowexception;              // turn off globally
     
    -

    In addition, varargs is sometimes used to fake default arguments in - older C libraries. For instance, the low level open() system - call is often declared as a varargs function so that it will accept two - or three arguments:

    +

    12.1.5 Defining different exception + handlers

    +

    By default, the %exception directive creates an exception + handler that is used for all wrapper functions that follow it. Unless + there is a well-defined (and simple) error handling mechanism in place, + defining one universal exception handler may be unwieldy and result in + excessive code bloat since the handler is inlined into each wrapper + function.

    +

    To fix this, you can be more selective about how you use the +%exception directive. One approach is to only place it around + critical pieces of code. For example:

    -int open(const char *path, int oflag, ...);
    -...
    +%exception {
    +  ... your exception handler ...
    +}
    +/* Define critical operations that can throw exceptions here */
     
    -/* Examples */
    -f = open("foo", O_RDONLY);
    -g = open("bar", O_WRONLY | O_CREAT, 0644);
    +%exception;
    +
    +/* Define non-critical operations that don't throw exceptions */
     
    -

    Finally, to implement a varargs function, recall that you have to - use the C library functions defined in <stdarg.h>. For +

    More precise control over exception handling can be obtained by + attaching an exception handler to specific declaration name. For example:

    -List make_list(const char *s, ...) {
    -    va_list ap;
    -    List    x;
    -    ...
    -    va_start(ap, s);
    -    while (s) {
    -       x.append(s);
    -       s = va_arg(ap, const char *);
    +%exception allocate {
    +    try {
    +        $action
    +    } 
    +    catch (MemoryError) {
    +        croak("Out of memory");
         }
    -    va_end(ap);
    -    return x;
     }
     
    -

    13.2 The Problem

    -

    Generating wrappers for a variable length argument function presents - a number of special challenges. Although C provides support for - implementing functions that receive variable length arguments, there - are no functions that can go in the other direction. Specifically, you - can't write a function that dynamically creates a list of arguments and - which invokes a varargs function on your behalf.

    -

    Although it is possible to write functions that accept the special - type va_list, this is something entirely different. You can't - take a va_list structure and pass it in place of the variable - length arguments to another varargs function. It just doesn't work.

    -

    The reason this doesn't work has to do with the way that function - calls get compiled. For example, suppose that your program has a - function call like this:

    +

    In this case, the exception handler is only attached to declarations + named "allocate". This would include both global and member functions. + The names supplied to %exception follow the same rules as for +%rename described in the section on +Ambiguity resolution and renaming. For example, if you wanted to + define an exception handler for a specific class, you might write this:

    -printf("Hello %s. Your number is %d\n", name, num);
    +%exception Object::allocate {
    +    try {
    +        $action
    +    } 
    +    catch (MemoryError) {
    +        croak("Out of memory");
    +    }
    +}
     
    -

    When the compiler looks at this, it knows that you are calling -printf() with exactly three arguments. Furthermore, it knows that - the number of arguments as well are their types and sizes is never - going to change during program execution. Therefore, this gets turned - to machine code that sets up a three-argument stack frame followed by a - call to printf().

    -

    In contrast, suppose you attempted to make some kind of wrapper - around printf() using code like this:

    +

    When a class prefix is supplied, the exception handler is applied to + the corresponding declaration in the specified class as well as for + identically named functions appearing in derived classes.

    +

    %exception can even be used to pinpoint a precise + declaration when overloading is used. For example:

    -int wrap_printf(const char *fmt, ...) {
    -   va_list ap;
    -   va_start(ap,fmt);
    -   ...
    -   printf(fmt,ap);
    -   ...
    -   va_end(ap);
    -};
    +%exception Object::allocate(int) {
    +    try {
    +        $action
    +    } 
    +    catch (MemoryError) {
    +        croak("Out of memory");
    +    }
    +}
     
    -

    Although this code might compile, it won't do what you expect. This - is because the call to printf() is compiled as a procedure - call involving only two arguments. However, clearly a two-argument - configuration of the call stack is completely wrong if your intent is - to pass an arbitrary number of arguments to the real printf(). - Needless to say, it won't work.

    -

    Unfortunately, the situation just described is exactly the problem - faced by wrapper generation tools. In general, the number of passed - arguments will not be known until run-time. To make matters even worse, - you won't know the types and sizes of arguments until run-time as well. - Needless to say, there is no obvious way to make the C compiler - generate code for a function call involving an unknown number of - arguments of unknown types.

    -

    In theory, it is possible to write a wrapper that does the - right thing. However, this involves knowing the underlying ABI for the - target platform and language as well as writing special purpose code - that manually constructed the call stack before making a procedure - call. Unfortunately, both of these tasks require the use of inline - assembly code. Clearly, that's the kind of solution you would much - rather avoid.

    -

    With this nastiness in mind, SWIG provides a number of solutions to - the varargs wrapping problem. Most of these solutions are compromises - that provide limited varargs support without having to resort to - assembly language. However, SWIG can also support real varargs wrapping - (with stack-frame manipulation) if you are willing to get hands dirty. - Keep reading.

    -

    13.3 Default varargs support

    -

    When variable length arguments appear in an interface, the default - behavior is to drop the variable argument list entirely, replacing them - with a single NULL pointer. For example, if you had this function,

    +

    Attaching exceptions to specific declarations is a good way to + reduce code bloat. It can also be a useful way to attach exceptions to + specific parts of a header file. For example:

    -void traceprintf(const char *fmt, ...);
    +%module example
    +%{
    +#include "someheader.h"
    +%}
    +
    +// Define a few exception handlers for specific declarations
    +%exception Object::allocate(int) {
    +    try {
    +        $action
    +    } 
    +    catch (MemoryError) {
    +        croak("Out of memory");
    +    }
    +}
    +
    +%exception Object::getitem {
    +    try {
    +       $action
    +    }
    +    catch (RangeError) {
    +       croak("Index out of range");
    +    }
    +}
    +...
    +// Read a raw header file
    +%include "someheader.h"
     
    -

    it would be wrapped as if it had been declared as follows:

    +

    Compatibility note: The %exception directive + replaces the functionality provided by the deprecated "except" typemap. + The typemap would allow exceptions to be thrown in the target language + based on the return type of a function and was intended to be a + mechanism for pinpointing specific declarations. However, it never + really worked that well and the new %exception directive is much + better.

    +

    12.1.6 Special + variables for %exception

    +

    The %exception directive supports a few special variables which are + placeholders for code substitution. The following table shows the + available special variables and details what the special variables are + replaced with.

    + + + + + + + + + + +
    $actionThe actual operation to be performed (a function + call, method invocation, variable access, etc.)
    $nameThe C/C++ symbol name for the function.
    $symnameThe symbol name used internally by SWIG
    $overnameThe extra mangling used in the symbol name for + overloaded method. Expands to nothing if the wrapped method is not + overloaded.
    $wrapnameThe language specific wrapper name (usually a + C function name exported from the shared object/dll)
    $declThe fully qualified C/C++ declaration of the + method being wrapped without the return type
    $fulldeclThe fully qualified C/C++ declaration of the + method being wrapped including the return type
    $parentclassnameThe parent class name (if any) for a + method.
    $parentclasssymnameThe target language parent class + name (if any) for a method.
    +

    The special variables are often used in situations where method + calls are logged. Exactly which form of the method call needs logging + is up to individual requirements, but the example code below shows all + the possible expansions, plus how an exception message could be + tailored to show the C++ method declaration:

    -void traceprintf(const char *fmt);
    +%exception Special::something {
    +  log("symname: $symname");
    +  log("overname: $overname");
    +  log("wrapname: $wrapname");
    +  log("decl: $decl");
    +  log("fulldecl: $fulldecl");
    +  try {
    +    $action
    +  } 
    +  catch (MemoryError) {
    +      croak("Out of memory in $decl");
    +  }
    +}
    +void log(const char *message);
    +struct Special {
    +  void something(const char *c);
    +  void something(int i);
    +};
     
    -

    When the function is called inside the wrappers, it is called as - follows:

    +

    Below shows the expansions for the 1st of the overloaded +something wrapper methods for Perl:

    -traceprintf(arg1, NULL);
    +  log("symname: Special_something");
    +  log("overname: __SWIG_0");
    +  log("wrapname: _wrap_Special_something__SWIG_0");
    +  log("decl: Special::something(char const *)");
    +  log("fulldecl: void Special::something(char const *)");
    +  try {
    +    (arg1)->something((char const *)arg2);
    +  } 
    +  catch (MemoryError) {
    +    croak("Out of memory in Special::something(char const *)");
    +  }
     
    -

    Arguably, this approach seems to defeat the whole point of variable - length arguments. However, this actually provides enough support for - many simple kinds of varargs functions to still be useful, however it - does come with a caveat. For instance, you could make function calls - like this (in Python):

    -
    +

    12.1.7 Using The SWIG exception library +

    +

    The exception.i library file provides support for creating + language independent exceptions in your interfaces. To use it, simply + put an "%include exception.i" in your interface file. This + provides a function SWIG_exception() that can be used to raise + common scripting language exceptions in a portable manner. For example + :

    +
    ->>> traceprintf("Hello World")
    ->>> traceprintf("Hello %s. Your number is %d\n" % (name, num))
    ->>> traceprintf("Your result is 90%%.")
    +// Language independent exception handler
    +%include exception.i       
    +
    +%exception {
    +    try {
    +        $action
    +    } catch(RangeError) {
    +        SWIG_exception(SWIG_ValueError, "Range Error");
    +    } catch(DivisionByZero) {
    +        SWIG_exception(SWIG_DivisionByZero, "Division by zero");
    +    } catch(OutOfMemory) {
    +        SWIG_exception(SWIG_MemoryError, "Out of memory");
    +    } catch(...) {
    +        SWIG_exception(SWIG_RuntimeError,"Unknown exception");
    +    }
    +}
    +
     
    -

    Notice how string formatting is being done in Python instead of C. - The caveat is the strings passed must be safe to use in C though. For - example if name was to contain a "%" it should be double escaped in - order to avoid unpredictable behaviour:

    -
    +

    As arguments, SWIG_exception() takes an error type code (an + integer) and an error message string. The currently supported error + types are :

    +
    ->>> traceprintf("Your result is 90%.\n")  # unpredictable behaviour
    ->>> traceprintf("Your result is 90%%.\n") # good
    +SWIG_UnknownError
    +SWIG_IOError
    +SWIG_RuntimeError
    +SWIG_IndexError
    +SWIG_TypeError
    +SWIG_DivisionByZero
    +SWIG_OverflowError
    +SWIG_SyntaxError
    +SWIG_ValueError
    +SWIG_SystemError
    +SWIG_AttributeError
    +SWIG_MemoryError
    +SWIG_NullReferenceError
     
    -

    Read on for further solutions.

    -

    13.4 Argument replacement using %varargs

    -

    Instead of dropping the variable length arguments, an alternative - approach is to replace (...) with a set of suitable arguments. - SWIG provides a special %varargs directive that can be used to - do this. For example,

    +

    The SWIG_exception() function can also be used in typemaps.

    +

    12.2 Object ownership and + %newobject

    +

    A common problem in some applications is managing proper ownership + of objects. For example, consider a function like this:

    -%varargs(int mode = 0) open;
    -...
    -int open(const char *path, int oflags, ...);
    +Foo *blah() {
    +   Foo *f = new Foo();
    +   return f;
    +}
     
    -

    is equivalent to this:

    +

    If you wrap the function blah(), SWIG has no idea that the + return value is a newly allocated object. As a result, the resulting + extension module may produce a memory leak (SWIG is conservative and + will never delete objects unless it knows for certain that the returned + object was newly created).

    +

    To fix this, you can provide an extra hint to the code generator + using the %newobject directive. For example:

    -int open(const char *path, int oflags, int mode = 0);
    +%newobject blah;
    +Foo *blah();
     
    -

    In this case, %varargs is simply providing more specific - information about the extra arguments that might be passed to a - function. If the arguments to a varargs function are of uniform type, -%varargs can also accept a numerical argument count as follows:

    +

    %newobject works exactly like %rename and +%exception. In other words, you can attach it to class members and + parameterized declarations as before. For example:

    -%varargs(3, char *str = NULL) execlp;
    +%newobject ::blah();                   // Only applies to global blah
    +%newobject Object::blah(int,double);   // Only blah(int,double) in Object
    +%newobject *::copy;                    // Copy method in all classes
     ...
    -int execlp(const char *path, const char *arg, ...);
     
    -

    and is effectively seen as:

    +

    When %newobject is supplied, many language modules will + arrange to take ownership of the return value. This allows the value to + be automatically garbage-collected when it is no longer in use. + However, this depends entirely on the target language (a language + module may also choose to ignore the %newobject directive).

    +

    Closely related to %newobject is a special typemap. The + "newfree" typemap can be used to deallocate a newly allocated return + value. It is only available on methods for which %newobject + has been applied and is commonly used to clean-up string results. For + example:

    -int execlp(const char *path, const char *arg, 
    -           char *str1 = NULL, 
    -           char *str2 = NULL, 
    -           char *str3 = NULL);
    +%typemap(newfree) char * "free($1);";
    +...
    +%newobject strdup;
    +...
    +char *strdup(const char *s);
     
    -

    This would wrap execlp() as a function that accepted up to - 3 optional arguments. Depending on the application, this may be more - than enough for practical purposes.

    -

    The handling of default arguments - can be changed via the compactdefaultargs feature. If this - feature is used, for example

    +

    In this case, the result of the function is a string in the target + language. Since this string is a copy of the original result, the data + returned by strdup() is no longer needed. The "newfree" + typemap in the example simply releases this memory.

    +

    As a complement to the %newobject, from SWIG 1.3.28, you + can use the %delobject directive. For example, if you have two + methods, one to create objects and one to destroy them, you can use:

    -%feature("compactdefaultargs") execlp;
    -%varargs(3, char *str = NULL) execlp;
    +%newobject create_foo;
    +%delobject destroy_foo;
     ...
    -int execlp(const char *path, const char *arg, ...);
    +Foo *create_foo();
    +void destroy_foo(Foo *foo);
     
    -

    a call from the target language which does not provide the maximum - number of arguments, such as, execlp("a", "b", "c") will - generate C code which includes the missing default values, that is, -execlp("a", "b", "c", NULL, NULL). If compactdefaultargs - is not used, then the generated code will be execlp("a", "b", "c") -. The former is useful for helping providing a sentinel to terminate the - argument list. However, this is not guaranteed, for example when a user - passes a non-NULL value for all the parameters. When using -compactdefaultargs it is possible to guarantee the NULL sentinel is - passed through the, numinputs=0 'in' - typemap attribute, naming the last parameter. For example,

    +

    or in a member method as:

    -%feature("compactdefaultargs") execlp;
    -%varargs(3, char *str = NULL) execlp;
    -%typemap(in, numinputs=0) char *str3 ""
    -...
    -int execlp(const char *path, const char *arg, ...);
    +%delobject Foo::destroy;
    +
    +class Foo {
    +public:
    +  void destroy() { delete this;}
    +
    +private:
    +  ~Foo();
    +};
     
    -

    Note that str3 is the name of the last argument, as we have - used %varargs with 3. Now execlp("a", "b", "c", "d", "e") - will result in an error as one too many arguments has been passed, as - now only 2 additional 'str' arguments can be passed with the 3rd one - always using the specified default NULL.

    -

    Argument replacement is most appropriate in cases where the types of - the extra arguments are uniform and the maximum number of arguments are - known. Argument replacement is not as useful when working with - functions that accept mixed argument types such as printf(). - Providing general purpose wrappers to such functions presents special - problems (covered shortly).

    -

    13.5 Varargs and typemaps

    -

    Variable length arguments may be used in typemap specifications. For - example:

    +

    %delobject instructs SWIG that the first argument passed to + the method will be destroyed, and therefore, the target language should + not attempt to deallocate it twice. This is similar to use the DISOWN + typemap in the first method argument, and in fact, it also depends on + the target language on implementing the 'disown' mechanism properly.

    +

    The use of %newobject is also integrated with reference + counting and is covered in the C++ + reference counted objects section.

    +

    Compatibility note: Previous versions of SWIG had a special +%new directive. However, unlike %newobject, it only + applied to the next declaration. For example:

    -%typemap(in) (...) {
    -    // Get variable length arguments (somehow)
    -    ...
    +%new char *strdup(const char *s);
    +
    +
    +

    For now this is still supported but is deprecated.

    +

    How to shoot yourself in the foot: The %newobject + directive is not a declaration modifier like the old %new + directive. Don't write code like this:

    +
    +
    +%newobject
    +char *strdup(const char *s);
    +
    +
    +

    The results might not be what you expect.

    +

    12.3 Features and the %feature + directive

    +

    Both %exception and %newobject are examples of a + more general purpose customization mechanism known as "features." A + feature is simply a user-definable property that is attached to + specific declarations. Features are attached using the %feature + directive. For example:

    +
    +
    +%feature("except") Object::allocate {
    +    try {
    +        $action
    +    } 
    +    catch (MemoryError) {
    +        croak("Out of memory");
    +    }
     }
     
    -%typemap(in) (const char *fmt, ...) {
    -    // Multi-argument typemap
    -}
    +%feature("new","1") *::copy;
     
    -

    However, this immediately raises the question of what "type" is - actually used to represent (...). For lack of a better - alternative, the type of (...) is set to void *. - Since there is no way to dynamically pass arguments to a varargs - function (as previously described), the void * argument value - is intended to serve as a place holder for storing some kind of - information about the extra arguments (if any). In addition, the - default behavior of SWIG is to pass the void * value as an - argument to the function. Therefore, you could use the pointer to hold - a valid argument value if you wanted.

    -

    To illustrate, here is a safer version of wrapping printf() - in Python:

    +

    In fact, the %exception and %newobject directives + are really nothing more than macros involving %feature:

    -%typemap(in) (const char *fmt, ...) {
    -    $1 = "%s";                                /* Fix format string to %s */
    -    $2 = (void *) PyString_AsString($input);  /* Get string argument */
    -};
    -...
    -int printf(const char *fmt, ...);
    +#define %exception %feature("except")
    +#define %newobject %feature("new","1")
     
    -

    In this example, the format string is implicitly set to "%s" -. This prevents a program from passing a bogus format string to the - extension. Then, the passed input object is decoded and placed in the -void * argument defined for the (...) argument. When the - actual function call is made, the underlying wrapper code will look - roughly like this:

    +

    The name matching rules outlined in the +Ambiguity resolution and renaming section applies to all +%feature directives. In fact the %rename directive is just + a special form of %feature. The matching rules mean that + features are very flexible and can be applied with pinpoint accuracy to + specific declarations if needed. Additionally, if no declaration name + is given, a global feature is said to be defined. This feature is then + attached to every declaration that follows. This is how global + exception handlers are defined. For example:

    -wrap_printf() {
    -   char *arg1;
    -   void *arg2;
    -   int   result;
    -
    -   arg1 = "%s";
    -   arg2 = (void *) PyString_AsString(arg2obj);
    -   ...
    -   result = printf(arg1,arg2);
    +/* Define a global exception handler */
    +%feature("except") {
    +   try {
    +     $action
    +   }
        ...
     }
    +
    +... bunch of declarations ...
     
    -

    Notice how both arguments are passed to the function and it does - what you would expect.

    -

    The next example illustrates a more advanced kind of varargs - typemap. Disclaimer: this requires special support in the target - language module and is not guaranteed to work with all SWIG modules at - this time. It also starts to illustrate some of the more fundamental - problems with supporting varargs in more generality.

    -

    If a typemap is defined for any form of (...), many SWIG - modules will generate wrappers that accept a variable number of - arguments as input and will make these arguments available in some - form. The precise details of this depends on the language module being - used (consult the appropriate chapter for more details). However, - suppose that you wanted to create a Python wrapper for the execlp() - function shown earlier. To do this using a typemap instead of using -%varargs, you might first write a typemap like this:

    +

    The %feature directive can be used with different syntax. + The following are all equivalent:

    -%typemap(in) (...)(char *vargs[10]) {
    -  int i;
    -  int argc;
    -  for (i = 0; i < 10; i++) vargs[i] = 0;
    -  argc = PyTuple_Size(varargs);
    -  if (argc > 10) {
    -    PyErr_SetString(PyExc_ValueError, "Too many arguments");
    -    return NULL;
    -  }
    -  for (i = 0; i < argc; i++) {
    -    PyObject *pyobj = PyTuple_GetItem(varargs, i);
    -    char *str = 0;
    -%#if PY_VERSION_HEX>=0x03000000
    -    PyObject *pystr;
    -    if (!PyUnicode_Check(pyobj)) {
    -       PyErr_SetString(PyExc_ValueError, "Expected a string");
    -       return NULL;
    -    }
    -    pystr = PyUnicode_AsUTF8String(pyobj);
    -    str = strdup(PyBytes_AsString(pystr));
    -    Py_XDECREF(pystr);
    -%#else  
    -    if (!PyString_Check(pyobj)) {
    -       PyErr_SetString(PyExc_ValueError, "Expected a string");
    -       return NULL;
    -    }
    -    str = PyString_AsString(pyobj);
    -%#endif
    -    vargs[i] = str;
    -  }
    -  $1 = (void *)vargs;
    -}
    -
    -%typemap(freearg) (...) {
    -%#if PY_VERSION_HEX>=0x03000000
    -  int i;
    -  for (i = 0; i < 10; i++) {
    -    free(vargs$argnum[i]);
    -  }
    -%#endif
    -}
    +%feature("except") Object::method { $action };
    +%feature("except") Object::method %{ $action %};
    +%feature("except") Object::method " $action ";
    +%feature("except","$action") Object::method;
     
    -

    In the 'in' typemap, the special variable varargs is a - tuple holding all of the extra arguments passed (this is specific to - the Python module). The typemap then pulls this apart and sticks the - values into the array of strings args. Then, the array is - assigned to $1 (recall that this is the void * - variable corresponding to (...)). However, this assignment is - only half of the picture----clearly this alone is not enough to make - the function work. The 'freearg' typemap cleans up memory allocated in - the 'in' typemap; this code is generated to be called after the -execlp function is called. To patch everything up, you have to - rewrite the underlying action code using the %feature - directive like this:

    +

    The syntax in the first variation will generate the { } + delimiters used whereas the other variations will not.

    +

    12.3.1 Feature attributes +

    +

    The %feature directive also accepts XML style attributes in + the same way that typemaps do. Any number of attributes can be + specified. The following is the generic syntax for features:

    -%feature("action") execlp {
    -  char **vargs = (char **) arg3;
    -  result = execlp(arg1, arg2, vargs[0], vargs[1], vargs[2], vargs[3], vargs[4],
    -                  vargs[5], vargs[6], vargs[7], vargs[8], vargs[9], NULL);
    -}
    -
    -int execlp(const char *path, const char *arg, ...);
    +%feature("name","value", attribute1="AttributeValue1") symbol;
    +%feature("name", attribute1="AttributeValue1") symbol {value};
    +%feature("name", attribute1="AttributeValue1") symbol %{value%};
    +%feature("name", attribute1="AttributeValue1") symbol "value";
     
    -

    This patches everything up and creates a function that more or less - works. However, don't try explaining this to your coworkers unless you - know for certain that they've had several cups of coffee. If you really - want to elevate your guru status and increase your job security, - continue to the next section.

    -

    13.6 Varargs wrapping with libffi

    -

    All of the previous examples have relied on features of SWIG that - are portable and which don't rely upon any low-level machine-level - details. In many ways, they have all dodged the real issue of variable - length arguments by recasting a varargs function into some weaker - variation with a fixed number of arguments of known types. In many - cases, this works perfectly fine. However, if you want more generality - than this, you need to bring out some bigger guns.

    -

    One way to do this is to use a special purpose library such as - libffi ( -http://sources.redhat.com/libffi). libffi is a library that allows - you to dynamically construct call-stacks and invoke procedures in a - relatively platform independent manner. Details about the library can - be found in the libffi distribution and are not repeated here.

    -

    To illustrate the use of libffi, suppose that you really - wanted to create a wrapper for execlp() that accepted any - number of arguments. To do this, you might make a few adjustments to - the previous example. For example:

    +

    More than one attribute can be specified using a comma separated + list. The Java module is an example that uses attributes in +%feature("except"). The throws attribute specifies the + name of a Java class to add to a proxy method's throws clause. In the + following example, MyExceptionClass is the name of the Java + class for adding to the throws clause.

    -/* Take an arbitrary number of extra arguments and place into an array
    -   of strings */
    -
    -%typemap(in) (...) {
    -   char **argv;
    -   int    argc;
    -   int    i;
    -
    -   argc = PyTuple_Size(varargs);
    -   argv = (char **) malloc(sizeof(char *)*(argc+1));
    -   for (i = 0; i < argc; i++) {
    -      PyObject *o = PyTuple_GetItem(varargs,i);
    -      if (!PyString_Check(o)) {
    -          PyErr_SetString(PyExc_ValueError,"Expected a string");
    -	  free(argv);
    -          return NULL;
    -      }
    -      argv[i] = PyString_AsString(o);
    +%feature("except", throws="MyExceptionClass") Object::method { 
    +   try {
    +     $action
    +   } catch (...) {
    +     ... code to throw a MyExceptionClass Java exception ...
        }
    -   argv[i] = NULL;
    -   $1 = (void *) argv;
    -}
    -
    -/* Rewrite the function call, using libffi */    
    -
    -%feature("action") execlp {
    -  int       i, vc;
    -  ffi_cif   cif;
    -  ffi_type  **types;
    -  void      **values;
    -  char      **args;
    -
    -  vc = PyTuple_Size(varargs);
    -  types  = (ffi_type **) malloc((vc+3)*sizeof(ffi_type *));
    -  values = (void **) malloc((vc+3)*sizeof(void *));
    -  args   = (char **) arg3;
    -
    -  /* Set up path parameter */
    -  types[0] = &ffi_type_pointer;
    -  values[0] = &arg1;
    -  
    -  /* Set up first argument */
    -  types[1] = &ffi_type_pointer;
    -  values[1] = &arg2;
    -
    -  /* Set up rest of parameters */
    -  for (i = 0; i <= vc; i++) {
    -    types[2+i] = &ffi_type_pointer;
    -    values[2+i] = &args[i];
    -  }
    -  if (ffi_prep_cif(&cif, FFI_DEFAULT_ABI, vc+3,
    -                   &ffi_type_uint, types) == FFI_OK) {
    -    ffi_call(&cif, (void (*)()) execlp, &result, values);
    -  } else {
    -    PyErr_SetString(PyExc_RuntimeError, "Whoa!!!!!");
    -    free(types);
    -    free(values);
    -    free(arg3);
    -    return NULL;
    -  }
    -  free(types);
    -  free(values);
    -  free(arg3);
    -}
    -
    -/* Declare the function. Whew! */
    -int execlp(const char *path, const char *arg1, ...);
    +};
     
    -

    Looking at this example, you may start to wonder if SWIG is making - life any easier. Given the amount of code involved, you might also - wonder why you didn't just write a hand-crafted wrapper! Either that or - you're wondering "why in the hell am I trying to wrap this varargs - function in the first place?!?" Obviously, those are questions you'll - have to answer for yourself.

    -

    As a more extreme example of libffi, here is some code that attempts - to wrap printf(),

    +

    Further details can be obtained from the +Java exception handling section.

    +

    12.3.2 Feature flags

    +

    Feature flags are used to enable or disable a particular feature. + Feature flags are a common but simple usage of %feature and + the feature value should be either 1 to enable or 0 + to disable the feature.

    -/* A wrapper for printf() using libffi */
    -
    -%{
    -/* Structure for holding passed arguments after conversion */
    -  typedef struct {
    -    int type;
    -    union {
    -      int    ivalue;
    -      double dvalue;
    -      void   *pvalue;
    -    } val;
    -  } vtype;
    -  enum { VT_INT, VT_DOUBLE, VT_POINTER };
    -%}
    -
    -%typemap(in) (const char *fmt, ...) {
    -  vtype *argv;
    -  int    argc;
    -  int    i;
    -
    -  /* Format string */
    -  $1 = PyString_AsString($input);
    -
    -  /* Variable length arguments */
    -  argc = PyTuple_Size(varargs);
    -  argv = (vtype *) malloc(argc*sizeof(vtype));
    -  for (i = 0; i < argc; i++) {
    -    PyObject *o = PyTuple_GetItem(varargs,i);
    -    if (PyInt_Check(o)) {
    -      argv[i].type = VT_INT;
    -      argv[i].val.ivalue = PyInt_AsLong(o);
    -    } else if (PyFloat_Check(o)) {
    -      argv[i].type = VT_DOUBLE;
    -      argv[i].val.dvalue = PyFloat_AsDouble(o);
    -    } else if (PyString_Check(o)) {
    -      argv[i].type = VT_POINTER;
    -      argv[i].val.pvalue = (void *) PyString_AsString(o);
    -    } else {
    -      PyErr_SetString(PyExc_ValueError,"Unsupported argument type");
    -      free(argv);
    -      return NULL;
    -    }
    -  }
    -  $2 = (void *) argv;
    -}
    -
    -/* Rewrite the function call using libffi */    
    -%feature("action") printf {
    -  int       i, vc;
    -  ffi_cif   cif;
    -  ffi_type  **types;
    -  void      **values;
    -  vtype     *args;
    +%feature("featurename")          // enables feature
    +%feature("featurename", "1")     // enables feature
    +%feature("featurename", "x")     // enables feature
    +%feature("featurename", "0")     // disables feature
    +%feature("featurename", "")      // clears feature
    +
    +
    +

    Actually any value other than zero will enable the feature. Note + that if the value is omitted completely, the default value becomes +1, thereby enabling the feature. A feature is cleared by specifying + no value, see Clearing + features. The %immutable directive described in the +Creating read-only variables section, is just a macro for +%feature("immutable"), and can be used to demonstrates feature + flags:

    +
    +
    +                                // features are disabled by default
    +int red;                        // mutable
     
    -  vc = PyTuple_Size(varargs);
    -  types  = (ffi_type **) malloc((vc+1)*sizeof(ffi_type *));
    -  values = (void **) malloc((vc+1)*sizeof(void *));
    -  args   = (vtype *) arg2;
    +%feature("immutable");          // global enable
    +int orange;                     // immutable
     
    -  /* Set up fmt parameter */
    -  types[0] = &ffi_type_pointer;
    -  values[0] = &arg1;
    +%feature("immutable","0");      // global disable
    +int yellow;                     // mutable
     
    -  /* Set up rest of parameters */
    -  for (i = 0; i < vc; i++) {
    -    switch(args[i].type) {
    -    case VT_INT:
    -      types[1+i] = &ffi_type_uint;
    -      values[1+i] = &args[i].val.ivalue;
    -      break;
    -    case VT_DOUBLE:
    -      types[1+i] = &ffi_type_double;
    -      values[1+i] = &args[i].val.dvalue;
    -      break;
    -    case VT_POINTER:
    -      types[1+i] = &ffi_type_pointer;
    -      values[1+i] = &args[i].val.pvalue;
    -      break;
    -    default:
    -      abort();    /* Whoa! We're seriously hosed */
    -      break;   
    -    }
    -  }
    -  if (ffi_prep_cif(&cif, FFI_DEFAULT_ABI, vc+1,
    -                   &ffi_type_uint, types) == FFI_OK) {
    -    ffi_call(&cif, (void (*)()) printf, &result, values);
    -  } else {
    -    PyErr_SetString(PyExc_RuntimeError, "Whoa!!!!!");
    -    free(types);
    -    free(values);
    -    free(args);
    -    return NULL;
    -  }
    -  free(types);
    -  free(values);
    -  free(args);
    -}
    +%feature("immutable","1");      // another form of global enable
    +int green;                      // immutable
     
    -/* The function */
    -int printf(const char *fmt, ...);
    +%feature("immutable","");       // clears the global feature
    +int blue;                       // mutable
     
    -

    Much to your amazement, it even seems to work if you try it:

    -
    +

    Note that features are disabled by default and must be explicitly + enabled either globally or by specifying a targeted declaration. The + above intersperses SWIG directives with C code. Of course you can + target features explicitly, so the above could also be rewritten as:

    +
    ->>> import example
    ->>> example.printf("Grade: %s   %d/60 = %0.2f%%\n", "Dave", 47, 47.0*100/60)
    -Grade: Dave   47/60 = 78.33%
    ->>>
    +%feature("immutable","1") orange;
    +%feature("immutable","1") green;
    +int red;                        // mutable
    +int orange;                     // immutable
    +int yellow;                     // mutable
    +int green;                      // immutable
    +int blue;                       // mutable
     
    -

    Of course, there are still some limitations to consider:

    -
    +

    The above approach allows for the C declarations to be separated + from the SWIG directives for when the C declarations are parsed from a + C header file. The logic above can of course be inverted and rewritten + as:

    +
    ->>> example.printf("la de da de da %s", 42)
    -Segmentation fault (core dumped)
    +%feature("immutable","1");
    +%feature("immutable","0") red;
    +%feature("immutable","0") yellow;
    +%feature("immutable","0") blue;
    +int red;                        // mutable
    +int orange;                     // immutable
    +int yellow;                     // mutable
    +int green;                      // immutable
    +int blue;                       // mutable
     
    -

    And, on this note, we leave further exploration of libffi to the - reader as an exercise. Although Python has been used as an example, - most of the techniques in this section can be extrapolated to other - language modules with a bit of work. The only details you need to know - is how the extra arguments are accessed in each target language. For - example, in the Python module, we used the special varargs - variable to get these arguments. Modules such as Tcl8 and Perl5 simply - provide an argument number for the first extra argument. This can be - used to index into an array of passed arguments to get values. Please - consult the chapter on each language module for more details.

    -

    13.7 Wrapping of va_list

    -

    Closely related to variable length argument wrapping, you may - encounter functions that accept a parameter of type va_list. - For example:

    +

    As hinted above for %immutable, most feature flags can also + be specified via alternative syntax. The alternative syntax is just a + macro in the swig.swg Library file. The following shows the + alternative syntax for the imaginary featurename feature:

    -int vprintf(const char *fmt, va_list ap);
    +%featurename       // equivalent to %feature("featurename", "1") ie enables feature
    +%nofeaturename     // equivalent to %feature("featurename", "0") ie disables feature
    +%clearfeaturename  // equivalent to %feature("featurename", "")  ie clears feature
     
    -

    As far as we know, there is no obvious way to wrap these functions - with SWIG. This is because there is no documented way to assemble the - proper va_list structure (there are no C library functions to do it and - the contents of va_list are opaque). Not only that, the contents of a -va_list structure are closely tied to the underlying call-stack. - It's not clear that exporting a va_list would have any use or - that it would work at all.

    -

    A workaround can be implemented by writing a simple varargs C - wrapper and then using the techniques discussed earlier in this chapter - for varargs. Below is a simple wrapper for vprintf renamed so - that it can still be called as vprintf from your target - language. The %varargs used in the example restricts the - function to taking one string argument.

    +

    The concept of clearing features is discussed next.

    +

    12.3.3 Clearing features +

    +

    A feature stays in effect until it is explicitly cleared. A feature + is cleared by supplying a %feature directive with no value. + For example %feature("name",""). A cleared feature means that + any feature exactly matching any previously defined feature is no + longer used in the name matching rules. So if a feature is cleared, it + might mean that another name matching rule will apply. To clarify, + let's consider the except feature again (%exception):

    -%{
    -int vprintf(const char *fmt, va_list ap);
    -%}
    +// Define global exception handler
    +%feature("except") {
    +    try {
    +        $action
    +    } catch (...) {
    +        croak("Unknown C++ exception");
    +    }
    +}
     
    -%varargs(const char *) my_vprintf;
    -%rename(vprintf) my_vprintf;
    +// Define exception handler for all clone methods to log the method calls
    +%feature("except") *::clone() {
    +    try {
    +        logger.info("$action");
    +        $action
    +    } catch (...) {
    +        croak("Unknown C++ exception");
    +    }
    +}
     
    -%inline %{
    -int my_vprintf(const char *fmt, ...) {
    -  va_list ap;
    -  int result;
    +... initial set of class declarations with clone methods ...
     
    -  va_start(ap, fmt);
    -  result = vprintf(fmt, ap);
    -  va_end(ap);
    -  return result;
    -}
    -%}
    +// clear the previously defined feature
    +%feature("except","") *::clone();
    +
    +... final set of class declarations with clone methods ...
     
    -

    13.8 C++ Issues

    -

    Wrapping of C++ member functions that accept a variable number of - arguments presents a number of challenges. By far, the easiest way to - handle this is to use the %varargs directive. This is portable - and it fully supports classes much like the %rename directive. - For example:

    +

    In the above scenario, the initial set of clone methods will log all + method invocations from the target language. This specific feature is + cleared for the final set of clone methods. However, these clone + methods will still have an exception handler (without logging) as the + next best feature match for them is the global exception handler.

    +

    Note that clearing a feature is not always the same as disabling it. + Clearing the feature above with %feature("except","") *::clone() + is not the same as specifying %feature("except","0") *::clone() +. The former will disable the feature for clone methods - the feature is + still a better match than the global feature. If on the other hand, no + global exception handler had been defined at all, then clearing the + feature would be the same as disabling it as no other feature would + have matched.

    +

    Note that the feature must match exactly for it to be cleared by any + previously defined feature. For example the following attempt to clear + the initial feature will not work:

    -%varargs (10, char * = NULL) Foo::bar;
    -
    -class Foo {
    -public:
    -     virtual void bar(char *arg, ...);   // gets varargs above
    -};
    -
    -class Spam: public Foo {
    -public:
    -     virtual void bar(char *arg, ...);   // gets varargs above
    -};
    +%feature("except") clone() { logger.info("$action"); $action }
    +%feature("except","") *::clone();
     
    -

    %varargs also works with constructors, operators, and any - other C++ programming construct that accepts variable arguments.

    -

    Doing anything more advanced than this is likely to involve a - serious world of pain. In order to use a library like libffi, you will - need to know the underlying calling conventions and details of the C++ - ABI. For instance, the details of how this is passed to member - functions as well as any hidden arguments that might be used to pass - additional information. These details are implementation specific and - may differ between compilers and even different versions of the same - compiler. Also, be aware that invoking a member function is further - complicated if it is a virtual method. In this case, invocation might - require a table lookup to obtain the proper function address (although - you might be able to obtain an address by casting a bound pointer to a - pointer to function as described in the C++ ARM section 18.3.4).

    -

    If you do decide to change the underlying action code, be aware that - SWIG always places the this pointer in arg1. Other - arguments are placed in arg2, arg3, and so forth. For - example:

    +

    but this will:

    -%feature("action") Foo::bar {
    -   ...
    -   result = arg1->bar(arg2, arg3, etc.);
    -   ...
    -}
    +%feature("except") clone() { logger.info("$action"); $action }
    +%feature("except","") clone();
     
    -

    Given the potential to shoot yourself in the foot, it is probably - easier to reconsider your design or to provide an alternative interface - using a helper function than it is to create a fully general wrapper to - a varargs C++ member function.

    -

    13.9 Discussion

    -

    This chapter has provided a number of techniques that can be used to - address the problem of variable length argument wrapping. If you care - about portability and ease of use, the %varargs directive is - probably the easiest way to tackle the problem. However, using - typemaps, it is possible to do some very advanced kinds of wrapping.

    -

    One point of discussion concerns the structure of the libffi - examples in the previous section. Looking at that code, it is not at - all clear that this is the easiest way to solve the problem. However, - there are a number of subtle aspects of the solution to - consider--mostly concerning the way in which the problem has been - decomposed. First, the example is structured in a way that tries to - maintain separation between wrapper-specific information and the - declaration of the function itself. The idea here is that you might - structure your interface like this:

    +

    SWIG provides macros for disabling and clearing features. Many of + these can be found in the swig.swg library file. The typical + pattern is to define three macros; one to define the feature itself, + one to disable the feature and one to clear the feature. The three + macros below show this for the "except" feature:

    -%typemap(const char *fmt, ...) {
    -   ...
    -}
    -%feature("action") traceprintf {
    -   ...
    -}
    -
    -/* Include some header file with traceprintf in it */
    -%include "someheader.h"
    +#define %exception      %feature("except")
    +#define %noexception    %feature("except","0")
    +#define %clearexception %feature("except","")
     
    -

    Second, careful scrutiny will reveal that the typemaps involving -(...) have nothing whatsoever to do with the libffi library. In - fact, they are generic with respect to the way in which the function is - actually called. This decoupling means that it will be much easier to - consider other library alternatives for making the function call. For - instance, if libffi wasn't supported on a certain platform, you might - be able to use something else instead. You could use conditional - compilation to control this:

    +

    12.3.4 Features and + default arguments

    +

    SWIG treats methods with default arguments as separate overloaded + methods as detailed in the default + arguments section. Any %feature targeting a method with + default arguments will apply to all the extra overloaded methods that + SWIG generates if the default arguments are specified in the feature. + If the default arguments are not specified in the feature, then the + feature will match that exact wrapper method only and not the extra + overloaded methods that SWIG generates. For example:

    -#ifdef USE_LIBFFI
    -%feature("action") printf {
    -   ...
    -}
    -#endif
    -#ifdef USE_OTHERFFI
    -%feature("action") printf {
    -...
    +%feature("except") hello(int i=0, double d=0.0) { ... }
    +void hello(int i=0, double d=0.0);
    +
    +
    +

    will apply the feature to all three wrapper methods, that is:

    +
    +
    +void hello(int i, double d);
    +void hello(int i);
    +void hello();
    +
    +
    +

    If the default arguments are not specified in the feature:

    +
    +
    +%feature("except") hello(int i, double d) { ... }
    +void hello(int i=0, double d=0.0);
    +
    +
    +

    then the feature will only apply to this wrapper method:

    +
    +
    +void hello(int i, double d);
    +
    +
    +

    and not these wrapper methods:

    +
    +
    +void hello(int i);
    +void hello();
    +
    +
    +

    If compactdefaultargs are being + used, then the difference between specifying or not specifying default + arguments in a feature is not applicable as just one wrapper is + generated.

    +

    Compatibility note: The different behaviour of features + specified with or without default arguments was introduced in + SWIG-1.3.23 when the approach to wrapping methods with default + arguments was changed.

    +

    12.3.5 Feature example

    +

    As has been shown earlier, the intended use for the %feature + directive is as a highly flexible customization mechanism that can be + used to annotate declarations with additional information for use by + specific target language modules. Another example is in the Python + module. You might use %feature to rewrite proxy/shadow class + code as follows:

    +
    +
    +%module example
    +%rename(bar_id) bar(int,double);
    +
    +// Rewrite bar() to allow some nice overloading
    +
    +%feature("shadow") Foo::bar(int) %{
    +def bar(*args):
    +    if len(args) == 3:
    +         return apply(examplec.Foo_bar_id,args)
    +    return apply(examplec.Foo_bar,args)
    +%}
    +    
    +class Foo {
    +public:
    +    int bar(int x);
    +    int bar(int x, double y);
     }
    -#endif
     
    -

    Finally, even though you might be inclined to just write a - hand-written wrapper for varargs functions, the techniques used in the - previous section have the advantage of being compatible with all other - features of SWIG such as exception handling.

    -

    As a final word, some C programmers seem to have the assumption that - the wrapping of variable length argument functions is an easily solved - problem. However, this section has hopefully dispelled some of these - myths. All things being equal, you are better off avoiding variable - length arguments if you can. If you can't avoid them, please consider - some of the simple solutions first. If you can't live with a simple - solution, proceed with caution. At the very least, make sure you - carefully read the section "A7.3.2 Function Calls" in Kernighan and - Ritchie and make sure you fully understand the parameter passing - conventions used for varargs. Also, be aware of the platform - dependencies and reliability issues that this will introduce. Good - luck.

    +

    Further details of %feature usage is described in the + documentation for specific language modules.


    -

    14 Warning Messages

    +

    13 Contracts

    -

    14.1 Introduction

    -

    During compilation, SWIG may generate a variety of warning messages. - For example:

    -
    +

    A common problem that arises when wrapping C libraries is that of + maintaining reliability and checking for errors. The fact of the matter + is that many C programs are notorious for not providing error checks. + Not only that, when you expose the internals of an application as a + library, it often becomes possible to crash it simply by providing bad + inputs or using it in a way that wasn't intended.

    +

    This chapter describes SWIG's support for software contracts. In the + context of SWIG, a contract can be viewed as a runtime constraint that + is attached to a declaration. For example, you can easily attach + argument checking rules, check the output values of a function and + more. When one of the rules is violated by a script, a runtime + exception is generated rather than having the program continue to + execute.

    +

    13.1 The %contract directive

    +

    Contracts are added to a declaration using the %contract directive. + Here is a simple example:

    +
    -example.i:16: Warning 501: Overloaded declaration ignored.  bar(double)
    -example.i:15: Warning 501: Previous declaration is bar(int)
    +%contract sqrt(double x) {
    +require:
    +    x >= 0;
    +ensure:
    +    sqrt >= 0;
    +}
    +
    +...
    +double sqrt(double);
     
    -

    Typically, warning messages indicate non-fatal problems with the - input where the generated wrapper code will probably compile, but it - may not work like you expect.

    -

    14.2 Warning message suppression

    -

    All warning messages have a numeric code that is shown in the - warning message itself. To suppress the printing of a warning message, - a number of techniques can be used. First, you can run SWIG with the --w command line option. For example:

    +

    In this case, a contract is being added to the sqrt() + function. The %contract directive must always appear before + the declaration in question. Within the contract there are two + sections, both of which are optional. The require: section + specifies conditions that must hold before the function is called. + Typically, this is used to check argument values. The ensure: + section specifies conditions that must hold after the function is + called. This is often used to check return values or the state of the + program. In both cases, the conditions that must hold must be specified + as boolean expressions.

    +

    In the above example, we're simply making sure that sqrt() returns a + non-negative number (if it didn't, then it would be broken in some + way).

    +

    Once a contract has been specified, it modifies the behavior of the + resulting module. For example:

    -% swig -python -w501 example.i
    -% swig -python -w501,505,401 example.i
    +>>> example.sqrt(2)
    +1.4142135623730951
    +>>> example.sqrt(-2)
    +Traceback (most recent call last):
    +  File "<stdin>", line 1, in ?
    +RuntimeError: Contract violation: require: (arg1>=0)
    +>>>
     
    -

    Alternatively, warnings can be suppressed by inserting a special - preprocessor pragma into the input file:

    +

    13.2 %contract and classes

    +

    The %contract directive can also be applied to class + methods and constructors. For example:

    -%module example
    -#pragma SWIG nowarn=501
    -#pragma SWIG nowarn=501,505,401
    +%contract Foo::bar(int x, int y) {
    +require:
    +   x > 0;
    +ensure:
    +   bar > 0;
    +}
    +
    +%contract Foo::Foo(int a) {
    +require:
    +   a > 0;
    +}
    +
    +class Foo {
    +public:
    +    Foo(int);
    +    int bar(int, int);
    +};
     
    -

    Finally, code-generation warnings can be disabled on a declaration - by declaration basis using the %warnfilter directive. For - example:

    +

    The way in which %contract is applied is exactly the same + as the %feature directive. Thus, any contract that you + specified for a base class will also be attached to inherited methods. + For example:

    -%module example
    -%warnfilter(501) foo;
    -...
    -int foo(int);
    -int foo(double);              // Silently ignored.
    +class Spam : public Foo {
    +public:
    +   int bar(int,int);    // Gets contract defined for Foo::bar(int,int)
    +};
     
    -

    The %warnfilter directive has the same semantics as other - declaration modifiers like %rename, %ignore and -%feature, see the %feature - directive section. For example, if you wanted to suppress a warning - for a method in a class hierarchy, you could do this:

    +

    In addition to this, separate contracts can be applied to both the + base class and a derived class. For example:

    -%warnfilter(501) Object::foo;
    -class Object {
    +%contract Foo::bar(int x, int) {
    +require:
    +    x > 0;
    +}
    +
    +%contract Spam::bar(int, int y) {
    +require:
    +    y > 0;
    +}
    +
    +class Foo {
     public:
    -   int foo(int);
    -   int foo(double);      // Silently ignored
    -   ...
    +    int bar(int,int);   // Gets Foo::bar contract.
     };
     
    -class Derived : public Object {
    +class Spam : public Foo {
     public:
    -   int foo(int);
    -   int foo(double);      // Silently ignored
    -   ...
    +     int bar(int,int);   // Gets Foo::bar and Spam::bar contract
     };
     
    -

    Warnings can be suppressed for an entire class by supplying a class - name. For example:

    +

    When more than one contract is applied, the conditions specified in + a "require:" section are combined together using a logical-AND + operation. In other words conditions specified for the base class and + conditions specified for the derived class all must hold. In the above + example, this means that both the arguments to Spam::bar must + be positive.

    +

    13.3 Constant aggregation and + %aggregate_check

    +

    Consider an interface file that contains the following code:

    -%warnfilter(501) Object;
    +#define  UP     1
    +#define  DOWN   2
    +#define  RIGHT  3
    +#define  LEFT   4
     
    -class Object {
    -public:
    -   ...                      // All 501 warnings ignored in class
    -};
    +void move(SomeObject *, int direction, int distance);
     
    -

    There is no option to suppress all SWIG warning messages. The - warning messages are there for a reason---to tell you that something - may be broken in your interface. Ignore the warning messages - at your own peril.

    -

    14.3 Enabling extra warnings

    -

    Some warning messages are disabled by default and are generated only - to provide additional diagnostics. These warnings can be turned on - using the -Wextra option. For example:

    -
    +

    One thing you might want to do is impose a constraint on the + direction parameter to make sure it's one of a few accepted values. To + do that, SWIG provides an easy to use macro %aggregate_check() that + works like this:

    +
    -% swig -Wextra -python example.i
    +%aggregate_check(int, check_direction, UP, DOWN, LEFT, RIGHT);
     
    -

    To selectively turn on extra warning messages, you can use the - directives and options in the previous section--simply add a "+" to all - warning numbers. For example:

    -
    +

    This merely defines a utility function of the form

    +
    -% swig -w+309,+452 example.i
    +int check_direction(int x);
     
    -

    or in your interface file use either

    +

    That checks the argument x to see if it is one of the values listed. + This utility function can be used in contracts. For example:

    -#pragma SWIG nowarn=+309,+452
    +%aggregate_check(int, check_direction, UP, DOWN, RIGHT, LEFT);
    +
    +%contract move(SomeObject *, int direction, in) {
    +require:
    +     check_direction(direction);
    +}
    +
    +#define  UP     1
    +#define  DOWN   2
    +#define  RIGHT  3
    +#define  LEFT   4
    +
    +void move(SomeObject *, int direction, int distance);
     
    -

    or

    +

    Alternatively, it can be used in typemaps and other directives. For + example:

    -%warnfilter(+309,+452) foo;
    +%aggregate_check(int, check_direction, UP, DOWN, RIGHT, LEFT);
    +
    +%typemap(check) int direction {
    +    if (!check_direction($1)) SWIG_exception(SWIG_ValueError, "Bad direction");
    +}
    +
    +#define  UP     1
    +#define  DOWN   2
    +#define  RIGHT  3
    +#define  LEFT   4
    +
    +void move(SomeObject *, int direction, int distance);
     
    -

    Note: selective enabling of warnings with %warnfilter - overrides any global settings you might have made using -w or -#pragma.

    -

    You can of course also enable all warnings and suppress a select - few, for example:

    -
    -
    -% swig -Wextra -w309,452 example.i
    -
    +

    Regrettably, there is no automatic way to perform similar checks + with enums values. Maybe in a future release.

    +

    13.4 Notes

    +

    Contract support was implemented by Songyan (Tiger) Feng and first + appeared in SWIG-1.3.20.

    +
    +

    14 Variable Length Arguments

    + + + -

    The warnings on the right take precedence over the warnings on the - left, so in the above example -Wextra adds numerous warnings - including 452, but then -w309,452 overrides this and so 452 is - suppressesed.

    -

    If you would like all warnings to appear, regardless of the warning - filters used, then use the -Wall option. The -Wall - option also turns on the extra warnings that -Wextra adds, - however, it is subtely different. When -Wall is used, it also - disables all other warning filters, that is, any warnings suppressed or - added in %warnfilter, #pragma SWIG nowarn or the --w option.

    -

    14.4 Issuing a warning message

    -

    Warning messages can be issued from an interface file using a number - of directives. The %warn directive is the most simple:

    + +

    (a.k.a, "The horror. The horror.")

    +

    This chapter describes the problem of wrapping functions that take a + variable number of arguments. For instance, generating wrappers for the + C printf() family of functions.

    +

    This topic is sufficiently advanced to merit its own chapter. In + fact, support for varargs is an often requested feature that was first + added in SWIG-1.3.12. Most other wrapper generation tools have wisely + chosen to avoid this issue.

    +

    14.1 Introduction

    +

    Some C and C++ programs may include functions that accept a variable + number of arguments. For example, most programmers are familiar with + functions from the C library such as the following:

    -%warn "900:This is your last warning!"
    +int printf(const char *fmt, ...)
    +int fprintf(FILE *, const char *fmt, ...);
    +int sprintf(char *s, const char *fmt, ...);
     
    -

    All warning messages are optionally prefixed by the warning number - to use. If you are generating your own warnings, make sure you don't - use numbers defined in the table at the end of this section.

    -

    The %ignorewarn directive is the same as %ignore - except that it issues a warning message whenever a matching declaration - is found. For example:

    +

    Although there is probably little practical purpose in wrapping + these specific C library functions in a scripting language (what would + be the point?), a library may include its own set of special functions + based on a similar API. For example:

    -%ignorewarn("362:operator= ignored") operator=;
    +int  traceprintf(const char *fmt, ...);
     
    -

    Warning messages can be associated with typemaps using the -warning attribute of a typemap declaration. For example:

    +

    In this case, you may want to have some kind of access from the + target language.

    +

    Before describing the SWIG implementation, it is important to + discuss the common uses of varargs that you are likely to encounter in + real programs. Obviously, there are the printf() style output + functions as shown. Closely related to this would be scanf() + style input functions that accept a format string and a list of + pointers into which return values are placed. However, variable length + arguments are also sometimes used to write functions that accept a + NULL-terminated list of pointers. A good example of this would be a + function like this:

    -%typemap(in, warning="901:You are really going to regret this usage of $1_type $1_name") blah * {
    -   ...
    -}
    +int execlp(const char *path, const char *arg1, ...);
    +...
    +
    +/* Example */
    +execlp("ls","ls","-l",NULL);
     
    -

    In this case, the warning message will be printed whenever the - typemap is actually used and the -special variables will be expanded as appropriate, for example:

    -
    +

    In addition, varargs is sometimes used to fake default arguments in + older C libraries. For instance, the low level open() system + call is often declared as a varargs function so that it will accept two + or three arguments:

    +
    -example.i:23: Warning 901: You are really going to regret this usage of blah * self
    -example.i:24: Warning 901: You are really going to regret this usage of blah * stuff
    +int open(const char *path, int oflag, ...);
    +...
    +
    +/* Examples */
    +f = open("foo", O_RDONLY);
    +g = open("bar", O_WRONLY | O_CREAT, 0644);
     
    -

    14.5 Symbolic symbols

    -

    The swigwarn.swg file that is installed with SWIG contains - symbol constants that could also be used in %warnfilter and -#pragma SWIG nowarn. For example this file contains the following - line:

    +

    Finally, to implement a varargs function, recall that you have to + use the C library functions defined in <stdarg.h>. For + example:

    -%define SWIGWARN_TYPE_UNDEFINED_CLASS 401 %enddef
    +List make_list(const char *s, ...) {
    +    va_list ap;
    +    List    x;
    +    ...
    +    va_start(ap, s);
    +    while (s) {
    +       x.append(s);
    +       s = va_arg(ap, const char *);
    +    }
    +    va_end(ap);
    +    return x;
    +}
     
    -

    so SWIGWARN_TYPE_UNDEFINED_CLASS could be used instead of - 401, for example:

    +

    14.2 The Problem

    +

    Generating wrappers for a variable length argument function presents + a number of special challenges. Although C provides support for + implementing functions that receive variable length arguments, there + are no functions that can go in the other direction. Specifically, you + can't write a function that dynamically creates a list of arguments and + which invokes a varargs function on your behalf.

    +

    Although it is possible to write functions that accept the special + type va_list, this is something entirely different. You can't + take a va_list structure and pass it in place of the variable + length arguments to another varargs function. It just doesn't work.

    +

    The reason this doesn't work has to do with the way that function + calls get compiled. For example, suppose that your program has a + function call like this:

    -#pragma SWIG nowarn=SWIGWARN_TYPE_UNDEFINED_CLASS
    +printf("Hello %s. Your number is %d\n", name, num);
     
    -

    or

    +

    When the compiler looks at this, it knows that you are calling +printf() with exactly three arguments. Furthermore, it knows that + the number of arguments as well are their types and sizes is never + going to change during program execution. Therefore, this gets turned + to machine code that sets up a three-argument stack frame followed by a + call to printf().

    +

    In contrast, suppose you attempted to make some kind of wrapper + around printf() using code like this:

    -%warnfilter(SWIGWARN_TYPE_UNDEFINED_CLASS) Foo;
    +int wrap_printf(const char *fmt, ...) {
    +   va_list ap;
    +   va_start(ap,fmt);
    +   ...
    +   printf(fmt,ap);
    +   ...
    +   va_end(ap);
    +};
     
    -

    14.6 Commentary

    -

    The ability to suppress warning messages is really only provided for - advanced users and is not recommended in normal use. You are advised to - modify your interface to fix the problems highlighted by the warnings - wherever possible instead of suppressing warnings.

    -

    Certain types of SWIG problems are errors. These usually arise due - to parsing errors (bad syntax) or semantic problems for which there is - no obvious recovery. There is no mechanism for suppressing error - messages.

    -

    14.7 Warnings as errors

    -

    Warnings can be handled as errors by using the -Werror - command line option. This will cause SWIG to exit with a non successful - exit code if a warning is encountered.

    -

    14.8 Message output format

    -

    The output format for both warnings and errors can be selected for - integration with your favourite IDE/editor. Editors and IDEs can - usually parse error messages and if in the appropriate format will - easily take you directly to the source of the error. The standard - format is used by default except on Windows where the Microsoft format - is used by default. These can be overridden using command line options, - for example:

    -
    -
    -$ swig -python -Fstandard example.i
    -example.i:4: Syntax error in input.
    -$ swig -python -Fmicrosoft example.i
    -example.i(4) : Syntax error in input.
    +

    Although this code might compile, it won't do what you expect. This + is because the call to printf() is compiled as a procedure + call involving only two arguments. However, clearly a two-argument + configuration of the call stack is completely wrong if your intent is + to pass an arbitrary number of arguments to the real printf(). + Needless to say, it won't work.

    +

    Unfortunately, the situation just described is exactly the problem + faced by wrapper generation tools. In general, the number of passed + arguments will not be known until run-time. To make matters even worse, + you won't know the types and sizes of arguments until run-time as well. + Needless to say, there is no obvious way to make the C compiler + generate code for a function call involving an unknown number of + arguments of unknown types.

    +

    In theory, it is possible to write a wrapper that does the + right thing. However, this involves knowing the underlying ABI for the + target platform and language as well as writing special purpose code + that manually constructed the call stack before making a procedure + call. Unfortunately, both of these tasks require the use of inline + assembly code. Clearly, that's the kind of solution you would much + rather avoid.

    +

    With this nastiness in mind, SWIG provides a number of solutions to + the varargs wrapping problem. Most of these solutions are compromises + that provide limited varargs support without having to resort to + assembly language. However, SWIG can also support real varargs wrapping + (with stack-frame manipulation) if you are willing to get hands dirty. + Keep reading.

    +

    14.3 Default varargs support

    +

    When variable length arguments appear in an interface, the default + behavior is to drop the variable argument list entirely, replacing them + with a single NULL pointer. For example, if you had this function,

    +
    +
    +void traceprintf(const char *fmt, ...);
     
    -

    14.9 Warning number reference

    -

    14.9.1 Deprecated features (100-199)

    -
      -
    • 101. Deprecated %extern directive.
    • -
    • 102. Deprecated %val directive.
    • -
    • 103. Deprecated %out directive.
    • -
    • 104. Deprecated %disabledoc directive.
    • -
    • 105. Deprecated %enabledoc directive.
    • -
    • 106. Deprecated %doconly directive.
    • -
    • 107. Deprecated %style directive.
    • -
    • 108. Deprecated %localstyle directive.
    • -
    • 109. Deprecated %title directive.
    • -
    • 110. Deprecated %section directive.
    • -
    • 111. Deprecated %subsection directive.
    • -
    • 112. Deprecated %subsubsection directive.
    • -
    • 113. Deprecated %addmethods directive.
    • -
    • 114. Deprecated %readonly directive.
    • -
    • 115. Deprecated %readwrite directive.
    • -
    • 116. Deprecated %except directive.
    • -
    • 117. Deprecated %new directive.
    • -
    • 118. Deprecated %typemap(except).
    • -
    • 119. Deprecated %typemap(ignore).
    • -
    • 120. Deprecated command line option (-runtime, -noruntime).
    • -
    • 121. Deprecated %name directive.
    • -
    -

    14.9.2 Preprocessor (200-299)

    -
      -
    • 201. Unable to find filename.
    • -
    • 202. Could not evaluate expression expr.
    • -
    • 203. Both includeall and importall are defined: using includeall.
    • -
    • 204. CPP #warning, "warning".
    • -
    • 205. CPP #error, "error".
    • -
    • 206. Unexpected tokens after #directive directive.
    • -
    -

    14.9.3 C/C++ Parser (300-399)

    -
      -
    • 301. class keyword used, but not in C++ mode.
    • -
    • 302. Identifier 'name' redefined (ignored).
    • -
    • 303. %extend defined for an undeclared class 'name -'.
    • -
    • 304. Unsupported constant value (ignored).
    • -
    • 305. Bad constant value (ignored).
    • -
    • 306. 'identifier' is private in this context.
    • -
    • 307. Can't set default argument value (ignored)
    • -
    • 308. Namespace alias 'name' not allowed here. Assuming ' -name'
    • -
    • 309. [private | protected] inheritance ignored.
    • -
    • 310. Template 'name' was already wrapped as 'name' - (ignored)
    • -
    • 312. Unnamed nested class not currently supported (ignored).
    • -
    • 313. Unrecognized extern type "name" (ignored).
    • -
    • 314. 'identifier' is a lang keyword.
    • -
    • 315. Nothing known about 'identifier'.
    • -
    • 316. Repeated %module directive.
    • -
    • 317. Specialization of non-template 'name'.
    • -
    • 318. Instantiation of template 'name' is ambiguous, - instantiation templ used, instantiation templ - ignored.
    • -
    • 319. No access specifier given for base class name - (ignored).
    • -
    • 320. Explicit template instantiation ignored.
    • -
    • 321. identifier conflicts with a built-in name.
    • -
    • 322. Redundant redeclaration of 'name'.
    • -
    • 323. Recursive scope inheritance of 'name'.
    • -
    • 324. Named nested template instantiations not supported. Processing - as if no name was given to %template().
    • -
    • 325. Nested kind not currently supported (name - ignored).
    • -
    • 326. Deprecated %extend name used - the kind name 'name -' should be used instead of the typedef name 'name'.
    • -
    • 350. operator new ignored.
    • -
    • 351. operator delete ignored.
    • -
    • 352. operator+ ignored.
    • -
    • 353. operator- ignored.
    • -
    • 354. operator* ignored.
    • -
    • 355. operator/ ignored.
    • -
    • 356. operator% ignored.
    • -
    • 357. operator^ ignored.
    • -
    • 358. operator& ignored.
    • -
    • 359. operator| ignored.
    • -
    • 360. operator~ ignored.
    • -
    • 361. operator! ignored.
    • -
    • 362. operator= ignored.
    • -
    • 363. operator< ignored.
    • -
    • 364. operator> ignored.
    • -
    • 365. operator+= ignored.
    • -
    • 366. operator-= ignored.
    • -
    • 367. operator*= ignored.
    • -
    • 368. operator/= ignored.
    • -
    • 369. operator%= ignored.
    • -
    • 370. operator^= ignored.
    • -
    • 371. operator&= ignored.
    • -
    • 372. operator|= ignored.
    • -
    • 373. operator<< ignored.
    • -
    • 374. operator>>ignored.
    • -
    • 375. operator<<= ignored.
    • -
    • 376. operator>>= ignored.
    • -
    • 377. operator== ignored.
    • -
    • 378. operator!= ignored.
    • -
    • 379. operator<= ignored.
    • -
    • 380. operator>= ignored.
    • -
    • 381. operator&& ignored.
    • -
    • 382. operator|| ignored.
    • -
    • 383. operator++ ignored.
    • -
    • 384. operator-- ignored.
    • -
    • 385. operator, ignored.
    • -
    • 386. operator-<* ignored.
    • -
    • 387. operator-< ignored.
    • -
    • 388. operator() ignored.
    • -
    • 389. operator[] ignored.
    • -
    • 390. operator+ ignored (unary).
    • -
    • 391. operator- ignored (unary).
    • -
    • 392. operator* ignored (unary).
    • -
    • 393. operator& ignored (unary).
    • -
    • 394. operator new[] ignored.
    • -
    • 395. operator delete[] ignored.
    • -
    -

    14.9.4 Types and typemaps (400-499)

    -
      -
    • 401. Nothing known about class 'name'. Ignored.
    • -
    • 402. Base class 'name' is incomplete.
    • -
    • 403. Class 'name' might be abstract.
    • -
    • 450. Deprecated typemap feature ($source/$target).
    • -
    • 451. Setting const char * variable may leak memory.
    • -
    • 452. Reserved
    • -
    • 453. Can't apply (pattern). No typemaps are defined.
    • -
    • 460. Unable to use type type as a function argument.
    • -
    • 461. Unable to use return type type in function name -.
    • -
    • 462. Unable to set variable of type type.
    • -
    • 463. Unable to read variable of type type.
    • -
    • 464. Unsupported constant value.
    • -
    • 465. Unable to handle type type.
    • -
    • 466. Unsupported variable type type.
    • -
    • 467. Overloaded declaration not supported (no type checking - rule for 'type')
    • -
    • 468. No 'throw' typemap defined for exception type type
    • -
    • 469. No or improper directorin typemap defined for type
    • -
    • 470. Thread/reentrant unsafe wrapping, consider returning by value - instead.
    • -
    • 471. Unable to use return type type in director method
    • -
    • 474. Method method usage of the optimal attribute ignored - in the out typemap as the following cannot be used to generate optimal - code: code
    • -
    • 475. Multiple calls to method might be generated due to - optimal attribute usage in the out typemap.
    • -
    -

    14.9.5 Code generation (500-599)

    -
      -
    • 501. Overloaded declaration ignored. decl. Previous - declaration is decl.
    • -
    • 502. Overloaded constructor ignored. decl. Previous - declaration is decl.
    • -
    • 503. Can't wrap 'identifier' unless renamed to a valid - identifier.
    • -
    • 504. Function name must have a return type. Ignored.
    • -
    • 505. Variable length arguments discarded.
    • -
    • 506. Can't wrap varargs with keyword arguments enabled.
    • -
    • 507. Adding native function name not supported (ignored).
    • -
    • 508. Declaration of 'name' shadows declaration accessible - via operator->(), previous declaration of'declaration'.
    • -
    • 509. Overloaded method declaration effectively ignored, as - it is shadowed by declaration.
    • -
    • 510. Friend function 'name' ignored.
    • -
    • 511. Can't use keyword arguments with overloaded functions.
    • -
    • 512. Overloaded method declaration ignored, using non-const - method declaration instead.
    • -
    • 513. Can't generate wrappers for unnamed struct/class.
    • -
    • 514.
    • -
    • 515.
    • -
    • 516. Overloaded method declaration ignored, using - declaration instead.
    • -
    • 517.
    • -
    • 518. Portability warning: File file1 will be overwritten by - file2 on case insensitive filesystems such as Windows' FAT32 and - NTFS unless the class/module name is renamed.
    • -
    • 519. %template() contains no name. Template method ignored: - declaration
    • -
    • 520. Base/Derived class 'classname1' of ' -classname2' is not similarly marked as a smart pointer.
    • -
    • 521. Illegal destructor name name. Ignored.
    • -
    • 522. Use of an illegal constructor name 'name' in %extend - is deprecated, the constructor name should be 'name'.
    • -
    • 523. Use of an illegal destructor name 'name' in %extend is - deprecated, the destructor name should be 'name'.
    • -
    -

    14.9.6 Language module specific - (700-899)

    -
      -
    • 801. Wrong name (corrected to 'name'). (Ruby).
    • -
    -
      -
    • 810. No jni typemap defined for type (Java).
    • -
    • 811. No jtype typemap defined for type (Java).
    • -
    • 812. No jstype typemap defined for type (Java).
    • -
    • 813. Warning for classname: Base baseclass - ignored. Multiple inheritance is not supported in Java. (Java).
    • -
    • 814.
    • -
    • 815. No javafinalize typemap defined for type (Java).
    • -
    • 816. No javabody typemap defined for type (Java).
    • -
    • 817. No javaout typemap defined for type (Java).
    • -
    • 818. No javain typemap defined for type (Java).
    • -
    • 819. No javadirectorin typemap defined for type (Java).
    • -
    • 820. No javadirectorout typemap defined for type (Java).
    • -
    • 821.
    • -
    • 822. Covariant return types not supported in Java. Proxy method will - return basetype (Java).
    • -
    • 823. No javaconstruct typemap defined for type (Java).
    • -
    • 824. Missing JNI descriptor in directorin typemap defined for - type (Java).
    • -
    • 825. "directorconnect" attribute missing in type - "javaconstruct" typemap. (Java).
    • -
    • 826. The nspace feature is used on 'type' without -package. - The generated code may not compile as Java does not support types - declared in a named package accessing types declared in an unnamed - package. (Java).
    • -
    -
      -
    • 830. No ctype typemap defined for type (C#).
    • -
    • 831. No cstype typemap defined for type (C#).
    • -
    • 832. No cswtype typemap defined for type (C#).
    • -
    • 833. Warning for classname: Base baseclass - ignored. Multiple inheritance is not supported in C#. (C#).
    • -
    • 834.
    • -
    • 835. No csfinalize typemap defined for type (C#).
    • -
    • 836. No csbody typemap defined for type (C#).
    • -
    • 837. No csout typemap defined for type (C#).
    • -
    • 838. No csin typemap defined for type (C#).
    • -
    • 839.
    • -
    • 840.
    • -
    • 841.
    • -
    • 842. Covariant return types not supported in C#. Proxy method will - return basetype (C#).
    • -
    • 843. No csconstruct typemap defined for type (C#).
    • -
    • 844. C# exception may not be thrown - no $excode or excode attribute - in typemap typemap. (C#).
    • -
    • 845. Unmanaged code contains a call to a - SWIG_CSharpSetPendingException method and C# code does not handle - pending exceptions via the canthrow attribute. (C#).
    • -
    -
      -
    • 870. Warning for classname: Base baseclass - ignored. Multiple inheritance is not supported in PHP.
    • -
    • 871. Unrecognized pragma pragma. (Php).
    • -
    -

    14.9.7 User defined (900-999)

    -

    These numbers can be used by your own application.

    -

    14.10 History

    -

    The ability to control warning messages was first added to - SWIG-1.3.12.

    -
    -

    15 Working with Modules

    - - -
    - +

    it would be wrapped as if it had been declared as follows:

    +
    +
    +void traceprintf(const char *fmt);
    +
    - -

    15.1 Modules Introduction

    -

    Each invocation of SWIG requires a module name to be specified. The - module name is used to name the resulting target language extension - module. Exactly what this means and what the name is used for depends - on the target language, for example the name can define a target - language namespace or merely be a useful name for naming files or - helper classes. Essentially, a module comprises target language - wrappers for a chosen collection of global variables/functions, - structs/classes and other C/C++ types.

    -

    The module name can be supplied in one of two ways. The first is to - specify it with the special %module directive. This directive - must appear at the beginning of the interface file. The general form of - this directive is:

    +

    When the function is called inside the wrappers, it is called as + follows:

    -%module(option1="value1",option2="value2",...) modulename
    +traceprintf(arg1, NULL);
     
    -

    where the modulename is mandatory and the options add one or more - optional additional features. Typically no options are specified, for - example:

    +

    Arguably, this approach seems to defeat the whole point of variable + length arguments. However, this actually provides enough support for + many simple kinds of varargs functions to still be useful, however it + does come with a caveat. For instance, you could make function calls + like this (in Python):

    +
    +
    +>>> traceprintf("Hello World")
    +>>> traceprintf("Hello %s. Your number is %d\n" % (name, num))
    +>>> traceprintf("Your result is 90%%.")
    +
    +
    +

    Notice how string formatting is being done in Python instead of C. + The caveat is the strings passed must be safe to use in C though. For + example if name was to contain a "%" it should be double escaped in + order to avoid unpredictable behaviour:

    +
    +
    +>>> traceprintf("Your result is 90%.\n")  # unpredictable behaviour
    +>>> traceprintf("Your result is 90%%.\n") # good
    +
    +
    +

    Read on for further solutions.

    +

    14.4 Argument replacement using %varargs

    +

    Instead of dropping the variable length arguments, an alternative + approach is to replace (...) with a set of suitable arguments. + SWIG provides a special %varargs directive that can be used to + do this. For example,

    -%module mymodule
    +%varargs(int mode = 0) open;
    +...
    +int open(const char *path, int oflags, ...);
     
    -

    The second way to specify the module name is with the -module - command line option, for example -module mymodule. If the - module name is supplied on the command line, it overrides the name - specified by the %module directive.

    -

    When first working with SWIG, users commonly start by creating a - single module. That is, you might define a single SWIG interface that - wraps some set of C/C++ code. You then compile all of the generated - wrapper code together and use it. For large applications, however, this - approach is problematic---the size of the generated wrapper code can be - rather large. Moreover, it is probably easier to manage the target - language interface when it is broken up into smaller pieces.

    -

    This chapter describes the problem of using SWIG in programs where - you want to create a collection of modules. Each module in the - collection is created via separate invocations of SWIG.

    -

    15.2 Basics

    -

    The basic usage case with multiple modules is when modules do not - have cross-references (ie. when wrapping multiple independent C APIs). - In that case, swig input files should just work out of the box - you - simply create multiple wrapper .cxx files, link them into your - application, and insert/load each in the scripting language runtime as - you would do for the single module case.

    -

    A bit more complex is the case in which modules need to share - information. For example, when one module extends the class of another - by deriving from it:

    +

    is equivalent to this:

    -// File: base.h
    -class base {
    -public:
    -  int foo();
    -};
    +int open(const char *path, int oflags, int mode = 0);
     
    -
     
    +
    +

    In this case, %varargs is simply providing more specific + information about the extra arguments that might be passed to a + function. If the arguments to a varargs function are of uniform type, +%varargs can also accept a numerical argument count as follows:

    +
    -// File: base_module.i
    -%module base_module
    -
    -%{
    -#include "base.h"
    -%}
    -%include "base.h"
    +%varargs(3, char *str = NULL) execlp;
    +...
    +int execlp(const char *path, const char *arg, ...);
     
    -
     
    +
    +

    and is effectively seen as:

    +
    -// File: derived_module.i
    -%module derived_module
    -
    -%import "base_module.i"
    -
    -%inline %{
    -class derived : public base {
    -public:
    -  int bar();
    -};
    -%}
    +int execlp(const char *path, const char *arg, 
    +           char *str1 = NULL, 
    +           char *str2 = NULL, 
    +           char *str3 = NULL);
     
    -

    To create the wrapper properly, module derived_module needs - to know about the base class and that its interface is covered - in another module. The line %import "base_module.i" lets SWIG - know exactly that. Oftentimes the .h file is passed to -%import instead of the .i, which unfortunately doesn't - work for all language modules. For example, Python requires the name of - module that the base class exists in so that the proxy classes can - fully inherit the base class's methods. Typically you will get a - warning when the module name is missing, eg:

    -
    +

    This would wrap execlp() as a function that accepted up to + 3 optional arguments. Depending on the application, this may be more + than enough for practical purposes.

    +

    The handling of default arguments + can be changed via the compactdefaultargs feature. If this + feature is used, for example

    +
    -derived_module.i:8: Warning 401: Base class 'base' ignored - unknown module name for base. Either
    -import
    -the appropriate module interface file or specify the name of the module in the %import directive.
    +%feature("compactdefaultargs") execlp;
    +%varargs(3, char *str = NULL) execlp;
    +...
    +int execlp(const char *path, const char *arg, ...);
     
    -

    It is sometimes desirable to import the header file rather than the - interface file and overcome the above warning. For example in the case - of the imported interface being quite large, it may be desirable to - simplify matters and just import a small header file of dependent - types. This can be done by specifying the optional module - attribute in the %import directive. The derived_module.i - file shown above could be replaced with the following:

    +

    a call from the target language which does not provide the maximum + number of arguments, such as, execlp("a", "b", "c") will + generate C code which includes the missing default values, that is, +execlp("a", "b", "c", NULL, NULL). If compactdefaultargs + is not used, then the generated code will be execlp("a", "b", "c") +. The former is useful for helping providing a sentinel to terminate the + argument list. However, this is not guaranteed, for example when a user + passes a non-NULL value for all the parameters. When using +compactdefaultargs it is possible to guarantee the NULL sentinel is + passed through the, numinputs=0 'in' + typemap attribute, naming the last parameter. For example,

    +
    -// File: derived_module.i
    -%module derived_module
    -
    -%import(module="base_module") "base.h"
    +%feature("compactdefaultargs") execlp;
    +%varargs(3, char *str = NULL) execlp;
    +%typemap(in, numinputs=0) char *str3 ""
    +...
    +int execlp(const char *path, const char *arg, ...);
    +
    +
    +

    Note that str3 is the name of the last argument, as we have + used %varargs with 3. Now execlp("a", "b", "c", "d", "e") + will result in an error as one too many arguments has been passed, as + now only 2 additional 'str' arguments can be passed with the 3rd one + always using the specified default NULL.

    +

    Argument replacement is most appropriate in cases where the types of + the extra arguments are uniform and the maximum number of arguments are + known. Argument replacement is not as useful when working with + functions that accept mixed argument types such as printf(). + Providing general purpose wrappers to such functions presents special + problems (covered shortly).

    +

    14.5 Varargs and typemaps

    +

    Variable length arguments may be used in typemap specifications. For + example:

    +
    +
    +%typemap(in) (...) {
    +    // Get variable length arguments (somehow)
    +    ...
    +}
     
    -%inline %{
    -class derived : public base {
    -public:
    -  int bar();
    +%typemap(in) (const char *fmt, ...) {
    +    // Multi-argument typemap
    +}
    +
    +
    +

    However, this immediately raises the question of what "type" is + actually used to represent (...). For lack of a better + alternative, the type of (...) is set to void *. + Since there is no way to dynamically pass arguments to a varargs + function (as previously described), the void * argument value + is intended to serve as a place holder for storing some kind of + information about the extra arguments (if any). In addition, the + default behavior of SWIG is to pass the void * value as an + argument to the function. Therefore, you could use the pointer to hold + a valid argument value if you wanted.

    +

    To illustrate, here is a safer version of wrapping printf() + in Python:

    +
    +
    +%typemap(in) (const char *fmt, ...) {
    +    $1 = "%s";                                /* Fix format string to %s */
    +    $2 = (void *) PyString_AsString($input);  /* Get string argument */
     };
    +...
    +int printf(const char *fmt, ...);
     
    -

    -

    Note that "base_module" is the module name and is the same as that - specified in %module in base_module.i as well as the -%import in derived_module.i.

    -

    Another issue to beware of is that multiple dependent wrappers - should not be linked/loaded in parallel from multiple threads as SWIG - provides no locking - for more on that issue, read on.

    -

    15.3 The SWIG runtime code

    -

    Many of SWIG's target languages generate a set of functions commonly - known as the "SWIG runtime." These functions are primarily related to - the runtime type system which checks pointer types and performs other - tasks such as proper casting of pointer values in C++. As a general - rule, the statically typed target languages, such as Java, use the - language's built in static type checking and have no need for a SWIG - runtime. All the dynamically typed / interpreted languages rely on the - SWIG runtime.

    -

    The runtime functions are private to each SWIG-generated module. - That is, the runtime functions are declared with "static" linkage and - are visible only to the wrapper functions defined in that module. The - only problem with this approach is that when more than one SWIG module - is used in the same application, those modules often need to share type - information. This is especially true for C++ programs where SWIG must - collect and share information about inheritance relationships that - cross module boundaries.

    -

    To solve the problem of sharing information across modules, a - pointer to the type information is stored in a global variable in the - target language namespace. During module initialization, type - information is loaded into the global data structure of type - information from all modules.

    -

    There are a few trade offs with this approach. This type information - is global across all SWIG modules loaded, and can cause type conflicts - between modules that were not designed to work together. To solve this - approach, the SWIG runtime code uses a define SWIG_TYPE_TABLE to - provide a unique type table. This behavior can be enabled when - compiling the generated _wrap.cxx or _wrap.c file by adding - -DSWIG_TYPE_TABLE=myprojectname to the command line argument.

    -

    Then, only modules compiled with SWIG_TYPE_TABLE set to - myprojectname will share type information. So if your project has three - modules, all three should be compiled with - -DSWIG_TYPE_TABLE=myprojectname, and then these three modules will - share type information. But any other project's types will not - interfere or clash with the types in your module.

    -

    Another issue relating to the global type table is thread safety. If - two modules try and load at the same time, the type information can - become corrupt. SWIG currently does not provide any locking, and if you - use threads, you must make sure that modules are loaded serially. Be - careful if you use threads and the automatic module loading that some - scripting languages provide. One solution is to load all modules before - spawning any threads, or use SWIG_TYPE_TABLE to separate type tables so - they do not clash with each other.

    -

    Lastly, SWIG uses a #define SWIG_RUNTIME_VERSION, located in - Lib/swigrun.swg and near the top of every generated module. This number - gets incremented when the data structures change, so that SWIG modules - generated with different versions can peacefully coexist. So the type - structures are separated by the (SWIG_TYPE_TABLE, SWIG_RUNTIME_VERSION) - pair, where by default SWIG_TYPE_TABLE is empty. Only modules compiled - with the same pair will share type information.

    -

    15.4 External access to the - runtime

    -

    As described in The run-time - type checker, the functions SWIG_TypeQuery, -SWIG_NewPointerObj, and others sometimes need to be called. Calling - these functions from a typemap is supported, since the typemap code is - embedded into the _wrap.c file, which has those declarations - available. If you need to call the SWIG run-time functions from another - C file, there is one header you need to include. To generate the header - that needs to be included, run the following command:

    +
    +

    In this example, the format string is implicitly set to "%s" +. This prevents a program from passing a bogus format string to the + extension. Then, the passed input object is decoded and placed in the +void * argument defined for the (...) argument. When the + actual function call is made, the underlying wrapper code will look + roughly like this:

    +
    -$ swig -python -external-runtime <filename>
    +wrap_printf() {
    +   char *arg1;
    +   void *arg2;
    +   int   result;
    +
    +   arg1 = "%s";
    +   arg2 = (void *) PyString_AsString(arg2obj);
    +   ...
    +   result = printf(arg1,arg2);
    +   ...
    +}
     
    -

    -

    The filename argument is optional and if it is not passed, then the - default filename will be something like swigpyrun.h, depending - on the language. This header file should be treated like any of the - other _wrap.c output files, and should be regenerated when the _wrap - files are. After including this header, your code will be able to call -SWIG_TypeQuery, SWIG_NewPointerObj, SWIG_ConvertPtr - and others. The exact argument parameters for these functions might - differ between language modules; please check the language module - chapters for more information.

    -

    Inside this header the functions are declared static and are included - inline into the file, and thus the file does not need to be linked - against any SWIG libraries or code (you might still need to link - against the language libraries like libpython-2.3). Data is shared - between this file and the _wrap.c files through a global variable in - the scripting language. It is also possible to copy this header file - along with the generated wrapper files into your own package, so that - you can distribute a package that can be compiled without SWIG - installed (this works because the header file is self-contained, and - does not need to link with anything).

    -

    This header will also use the -DSWIG_TYPE_TABLE described above, so - when compiling any code which includes the generated header file should - define the SWIG_TYPE_TABLE to be the same as the module whose types you - are trying to access.

    -

    15.5 A word of caution about static - libraries

    -

    When working with multiple SWIG modules, you should take care not to - use static libraries. For example, if you have a static library -libfoo.a and you link a collection of SWIG modules with that - library, each module will get its own private copy of the library code - inserted into it. This is very often NOT what you want and it - can lead to unexpected or bizarre program behavior. When working with - dynamically loadable modules, you should try to work exclusively with - shared libraries.

    -

    15.6 References

    -

    Due to the complexity of working with shared libraries and multiple - modules, it might be a good idea to consult an outside reference. John - Levine's "Linkers and Loaders" is highly recommended.

    -

    15.7 Reducing the wrapper file size

    -

    Using multiple modules with the %import directive is the - most common approach to modularising large projects. In this way a - number of different wrapper files can be generated, thereby avoiding - the generation of a single large wrapper file. There are a couple of - alternative solutions for reducing the size of a wrapper file through - the use of command line options and features.

    -

    -fcompact -
    This command line option will compact the size of the wrapper file - without changing the code generated into the wrapper file. It simply - removes blank lines and joins lines of code together. This is useful - for compilers that have a maximum file size that can be handled.

    -

    -fvirtual -
    This command line option will remove the generation of superfluous - virtual method wrappers. Consider the following inheritance hierarchy:

    +
    +

    Notice how both arguments are passed to the function and it does + what you would expect.

    +

    The next example illustrates a more advanced kind of varargs + typemap. Disclaimer: this requires special support in the target + language module and is not guaranteed to work with all SWIG modules at + this time. It also starts to illustrate some of the more fundamental + problems with supporting varargs in more generality.

    +

    If a typemap is defined for any form of (...), many SWIG + modules will generate wrappers that accept a variable number of + arguments as input and will make these arguments available in some + form. The precise details of this depends on the language module being + used (consult the appropriate chapter for more details). However, + suppose that you wanted to create a Python wrapper for the execlp() + function shown earlier. To do this using a typemap instead of using +%varargs, you might first write a typemap like this:

    -struct Base {
    -  virtual void method();
    -  ...
    -};
    +%typemap(in) (...)(char *vargs[10]) {
    +  int i;
    +  int argc;
    +  for (i = 0; i < 10; i++) vargs[i] = 0;
    +  argc = PyTuple_Size(varargs);
    +  if (argc > 10) {
    +    PyErr_SetString(PyExc_ValueError, "Too many arguments");
    +    return NULL;
    +  }
    +  for (i = 0; i < argc; i++) {
    +    PyObject *pyobj = PyTuple_GetItem(varargs, i);
    +    char *str = 0;
    +%#if PY_VERSION_HEX>=0x03000000
    +    PyObject *pystr;
    +    if (!PyUnicode_Check(pyobj)) {
    +       PyErr_SetString(PyExc_ValueError, "Expected a string");
    +       return NULL;
    +    }
    +    pystr = PyUnicode_AsUTF8String(pyobj);
    +    str = strdup(PyBytes_AsString(pystr));
    +    Py_XDECREF(pystr);
    +%#else  
    +    if (!PyString_Check(pyobj)) {
    +       PyErr_SetString(PyExc_ValueError, "Expected a string");
    +       return NULL;
    +    }
    +    str = PyString_AsString(pyobj);
    +%#endif
    +    vargs[i] = str;
    +  }
    +  $1 = (void *)vargs;
    +}
     
    -struct Derived : Base {
    -  virtual void method();
    -  ...
    -};
    +%typemap(freearg) (...) {
    +%#if PY_VERSION_HEX>=0x03000000
    +  int i;
    +  for (i = 0; i < 10; i++) {
    +    free(vargs$argnum[i]);
    +  }
    +%#endif
    +}
     
    -

    Normally wrappers are generated for both methods, whereas this - command line option will suppress the generation of a wrapper for -Derived::method. Normal polymorphic behaviour remains as -Derived::method will still be called should you have a Derived - instance and call the wrapper for Base::method.

    -

    %feature("compactdefaultargs") -
    This feature can reduce the number of wrapper methods when wrapping - methods with default arguments. The section on -default arguments discusses the feature and its limitations.

    -
    -

    16 Using SWIG with ccache - ccache-swig(1) - manpage

    +

    In the 'in' typemap, the special variable varargs is a + tuple holding all of the extra arguments passed (this is specific to + the Python module). The typemap then pulls this apart and sticks the + values into the array of strings args. Then, the array is + assigned to $1 (recall that this is the void * + variable corresponding to (...)). However, this assignment is + only half of the picture----clearly this alone is not enough to make + the function work. The 'freearg' typemap cleans up memory allocated in + the 'in' typemap; this code is generated to be called after the +execlp function is called. To patch everything up, you have to + rewrite the underlying action code using the %feature + directive like this:

    +
    +
    +%feature("action") execlp {
    +  char **vargs = (char **) arg3;
    +  result = execlp(arg1, arg2, vargs[0], vargs[1], vargs[2], vargs[3], vargs[4],
    +                  vargs[5], vargs[6], vargs[7], vargs[8], vargs[9], NULL);
    +}
     
    -
    -
    - -

    -

    16.1 NAME

    -

    ccache-swig - a fast compiler cache

    -

    -

    16.2 SYNOPSIS

    -

    ccache-swig [OPTION]

    -

    ccache-swig <compiler> [COMPILER OPTIONS]

    -

    <compiler> [COMPILER OPTIONS]

    -

    -

    16.3 DESCRIPTION

    -

    ccache-swig is a compiler cache. It speeds up re-compilation of - C/C++/SWIG code by caching previous compiles and detecting when the - same compile is being done again. ccache-swig is ccache plus support - for SWIG. ccache and ccache-swig are used interchangeably in this - document.

    -

    -

    16.4 OPTIONS SUMMARY

    -

    Here is a summary of the options to ccache-swig.

    -

    +

    This patches everything up and creates a function that more or less + works. However, don't try explaining this to your coworkers unless you + know for certain that they've had several cups of coffee. If you really + want to elevate your guru status and increase your job security, + continue to the next section.

    +

    14.6 Varargs wrapping with libffi

    +

    All of the previous examples have relied on features of SWIG that + are portable and which don't rely upon any low-level machine-level + details. In many ways, they have all dodged the real issue of variable + length arguments by recasting a varargs function into some weaker + variation with a fixed number of arguments of known types. In many + cases, this works perfectly fine. However, if you want more generality + than this, you need to bring out some bigger guns.

    +

    One way to do this is to use a special purpose library such as + libffi ( +http://www.sourceware.org/libffi/). libffi is a library that allows + you to dynamically construct call-stacks and invoke procedures in a + relatively platform independent manner. Details about the library can + be found in the libffi distribution and are not repeated here.

    +

    To illustrate the use of libffi, suppose that you really + wanted to create a wrapper for execlp() that accepted any + number of arguments. To do this, you might make a few adjustments to + the previous example. For example:

    +
    +/* Take an arbitrary number of extra arguments and place into an array
    +   of strings */
     
    --s                      show statistics summary
    --z                      zero statistics
    --c                      run a cache cleanup
    --C                      clear the cache completely
    --F <n>                  set maximum files in cache
    --M <n>                  set maximum size of cache (use G, M or K)
    --h                      this help page
    --V                      print version number
    +%typemap(in) (...) {
    +   char **argv;
    +   int    argc;
    +   int    i;
    +
    +   argc = PyTuple_Size(varargs);
    +   argv = (char **) malloc(sizeof(char *)*(argc+1));
    +   for (i = 0; i < argc; i++) {
    +      PyObject *o = PyTuple_GetItem(varargs,i);
    +      if (!PyString_Check(o)) {
    +          PyErr_SetString(PyExc_ValueError,"Expected a string");
    +          free(argv);
    +          return NULL;
    +      }
    +      argv[i] = PyString_AsString(o);
    +   }
    +   argv[i] = NULL;
    +   $1 = (void *) argv;
    +}
    +
    +/* Rewrite the function call, using libffi */    
    +
    +%feature("action") execlp {
    +  int       i, vc;
    +  ffi_cif   cif;
    +  ffi_type  **types;
    +  void      **values;
    +  char      **args;
    +
    +  vc = PyTuple_Size(varargs);
    +  types  = (ffi_type **) malloc((vc+3)*sizeof(ffi_type *));
    +  values = (void **) malloc((vc+3)*sizeof(void *));
    +  args   = (char **) arg3;
    +
    +  /* Set up path parameter */
    +  types[0] = &ffi_type_pointer;
    +  values[0] = &arg1;
    +  
    +  /* Set up first argument */
    +  types[1] = &ffi_type_pointer;
    +  values[1] = &arg2;
    +
    +  /* Set up rest of parameters */
    +  for (i = 0; i <= vc; i++) {
    +    types[2+i] = &ffi_type_pointer;
    +    values[2+i] = &args[i];
    +  }
    +  if (ffi_prep_cif(&cif, FFI_DEFAULT_ABI, vc+3,
    +                   &ffi_type_uint, types) == FFI_OK) {
    +    ffi_call(&cif, (void (*)()) execlp, &result, values);
    +  } else {
    +    PyErr_SetString(PyExc_RuntimeError, "Whoa!!!!!");
    +    free(types);
    +    free(values);
    +    free(arg3);
    +    return NULL;
    +  }
    +  free(types);
    +  free(values);
    +  free(arg3);
    +}
     
    +/* Declare the function. Whew! */
    +int execlp(const char *path, const char *arg1, ...);
     
    -

    -

    16.5 OPTIONS

    -

    These options only apply when you invoke ccache as "ccache-swig". - When invoked as a compiler none of these options apply. In that case - your normal compiler options apply and you should refer to your - compilers documentation.

    -

    -
    -

    -

    -h
    -
    Print a options summary page -

    -

    -
    -
    -s
    -
    Print the current statistics summary for the cache. The statistics - are stored spread across the subdirectories of the cache. Using - "ccache-swig -s" adds up the statistics across all subdirectories and - prints the totals. -

    -

    -
    -
    -z
    -
    Zero the cache statistics. -

    -

    -
    -
    -V
    -
    Print the ccache version number -

    -

    -
    -
    -c
    -
    Clean the cache and re-calculate the cache file count and size - totals. Normally the -c option should not be necessary as ccache keeps - the cache below the specified limits at runtime and keeps statistics up - to date on each compile. This option is mostly useful if you manually - modify the cache contents or believe that the cache size statistics may - be inaccurate. -

    -

    -
    -
    -C
    -
    Clear the entire cache, removing all cached files. -

    -

    -
    -
    -F <maxfiles>
    -
    This sets the maximum number of files allowed in the cache. The - value is stored inside the cache directory and applies to all future - compiles. Due to the way the value is stored the actual value used is - always rounded down to the nearest multiple of 16. -

    -

    -
    -
    -M <maxsize>
    -
    This sets the maximum cache size. You can specify a value in - gigabytes, megabytes or kilobytes by appending a G, M or K to the - value. The default is gigabytes. The actual value stored is rounded - down to the nearest multiple of 16 kilobytes. -

    -
    -

    -
    -

    -

    16.6 INSTALLATION

    -

    There are two ways to use ccache. You can either prefix your compile - commands with "ccache-swig" or you can create a symbolic link between - ccache-swig and the names of your compilers. The first method is most - convenient if you just want to try out ccache or wish to use it for - some specific projects. The second method is most useful for when you - wish to use ccache for all your compiles.

    -

    To install for usage by the first method just copy ccache-swig to - somewhere in your path.

    -

    To install for the second method do something like this:

    +
    +

    Looking at this example, you may start to wonder if SWIG is making + life any easier. Given the amount of code involved, you might also + wonder why you didn't just write a hand-crafted wrapper! Either that or + you're wondering "why in the hell am I trying to wrap this varargs + function in the first place?!?" Obviously, those are questions you'll + have to answer for yourself.

    +

    As a more extreme example of libffi, here is some code that attempts + to wrap printf(),

    +
    +/* A wrapper for printf() using libffi */
     
    -  cp ccache-swig /usr/local/bin/
    -  ln -s /usr/local/bin/ccache-swig /usr/local/bin/gcc
    -  ln -s /usr/local/bin/ccache-swig /usr/local/bin/g++
    -  ln -s /usr/local/bin/ccache-swig /usr/local/bin/cc
    -  ln -s /usr/local/bin/ccache-swig /usr/local/bin/swig
    +%{
    +/* Structure for holding passed arguments after conversion */
    +  typedef struct {
    +    int type;
    +    union {
    +      int    ivalue;
    +      double dvalue;
    +      void   *pvalue;
    +    } val;
    +  } vtype;
    +  enum { VT_INT, VT_DOUBLE, VT_POINTER };
    +%}
     
    -
    - This will work as long as /usr/local/bin comes before the path to gcc - (which is usually in /usr/bin). After installing you may wish to run - "which gcc" to make sure that the correct link is being used. -

    Note! Do not use a hard link, use a symbolic link. A hardlink will - cause "interesting" problems.

    -

    -

    16.7 EXTRA OPTIONS

    -

    When run as a compiler front end ccache usually just takes the same - command line options as the compiler you are using. The only exception - to this is the option '--ccache-skip'. That option can be used to tell - ccache that the next option is definitely not a input filename, and - should be passed along to the compiler as-is.

    -

    The reason this can be important is that ccache does need to parse - the command line and determine what is an input filename and what is a - compiler option, as it needs the input filename to determine the name - of the resulting object file (among other things). The heuristic ccache - uses in this parse is that any string on the command line that exists - as a file is treated as an input file name (usually a C file). By using - --ccache-skip you can force an option to not be treated as an input - file name and instead be passed along to the compiler as a command line - option.

    -

    -

    16.8 ENVIRONMENT VARIABLES

    -

    ccache uses a number of environment variables to control operation. - In most cases you won't need any of these as the defaults will be fine.

    -

    -
    -

    -

    -

    CCACHE_DIR
    -
    the CCACHE_DIR environment variable specifies where ccache will - keep its cached compiler output. The default is "$HOME/.ccache". -

    -

    -
    -
    CCACHE_TEMPDIR
    -
    the CCACHE_TEMPDIR environment variable specifies where ccache will - put temporary files. The default is the same as CCACHE_DIR. Note that - the CCACHE_TEMPDIR path must be on the same filesystem as the - CCACHE_DIR path, so that renames of files between the two directories - can work. -

    -

    -
    -
    CCACHE_LOGFILE
    -
    If you set the CCACHE_LOGFILE environment variable then ccache will - write some log information on cache hits and misses in that file. This - is useful for tracking down problems. -

    -

    -
    -
    CCACHE_VERBOSE
    -
    If you set the CCACHE_VERBOSE environment variable then ccache will - display on stdout all the compiler invocations that it makes. This can - useful for debugging unexpected problems. -

    -

    -
    -
    CCACHE_PATH
    -
    You can optionally set CCACHE_PATH to a colon separated path where - ccache will look for the real compilers. If you don't do this then - ccache will look for the first executable matching the compiler name in - the normal PATH that isn't a symbolic link to ccache itself. -

    -

    -
    -
    CCACHE_CC
    +%typemap(in) (const char *fmt, ...) { + vtype *argv; + int argc; + int i; + + /* Format string */ + $1 = PyString_AsString($input); + + /* Variable length arguments */ + argc = PyTuple_Size(varargs); + argv = (vtype *) malloc(argc*sizeof(vtype)); + for (i = 0; i < argc; i++) { + PyObject *o = PyTuple_GetItem(varargs,i); + if (PyInt_Check(o)) { + argv[i].type = VT_INT; + argv[i].val.ivalue = PyInt_AsLong(o); + } else if (PyFloat_Check(o)) { + argv[i].type = VT_DOUBLE; + argv[i].val.dvalue = PyFloat_AsDouble(o); + } else if (PyString_Check(o)) { + argv[i].type = VT_POINTER; + argv[i].val.pvalue = (void *) PyString_AsString(o); + } else { + PyErr_SetString(PyExc_ValueError,"Unsupported argument type"); + free(argv); + return NULL; + } + } + $2 = (void *) argv; +} + +/* Rewrite the function call using libffi */ +%feature("action") printf { + int i, vc; + ffi_cif cif; + ffi_type **types; + void **values; + vtype *args; + + vc = PyTuple_Size(varargs); + types = (ffi_type **) malloc((vc+1)*sizeof(ffi_type *)); + values = (void **) malloc((vc+1)*sizeof(void *)); + args = (vtype *) arg2; + + /* Set up fmt parameter */ + types[0] = &ffi_type_pointer; + values[0] = &arg1; + + /* Set up rest of parameters */ + for (i = 0; i < vc; i++) { + switch(args[i].type) { + case VT_INT: + types[1+i] = &ffi_type_uint; + values[1+i] = &args[i].val.ivalue; + break; + case VT_DOUBLE: + types[1+i] = &ffi_type_double; + values[1+i] = &args[i].val.dvalue; + break; + case VT_POINTER: + types[1+i] = &ffi_type_pointer; + values[1+i] = &args[i].val.pvalue; + break; + default: + abort(); /* Whoa! We're seriously hosed */ + break; + } + } + if (ffi_prep_cif(&cif, FFI_DEFAULT_ABI, vc+1, + &ffi_type_uint, types) == FFI_OK) { + ffi_call(&cif, (void (*)()) printf, &result, values); + } else { + PyErr_SetString(PyExc_RuntimeError, "Whoa!!!!!"); + free(types); + free(values); + free(args); + return NULL; + } + free(types); + free(values); + free(args); +} + +/* The function */ +int printf(const char *fmt, ...); +
    +
    +

    Much to your amazement, it even seems to work if you try it:

    +
    +
    +>>> import example
    +>>> example.printf("Grade: %s   %d/60 = %0.2f%%\n", "Dave", 47, 47.0*100/60)
    +Grade: Dave   47/60 = 78.33%
    +>>>
    +
    +
    +

    Of course, there are still some limitations to consider:

    +
    +
    +>>> example.printf("la de da de da %s", 42)
    +Segmentation fault (core dumped)
    +
    +
    +

    And, on this note, we leave further exploration of libffi to the + reader as an exercise. Although Python has been used as an example, + most of the techniques in this section can be extrapolated to other + language modules with a bit of work. The only details you need to know + is how the extra arguments are accessed in each target language. For + example, in the Python module, we used the special varargs + variable to get these arguments. Modules such as Tcl8 and Perl5 simply + provide an argument number for the first extra argument. This can be + used to index into an array of passed arguments to get values. Please + consult the chapter on each language module for more details.

    +

    14.7 Wrapping of va_list

    +

    Closely related to variable length argument wrapping, you may + encounter functions that accept a parameter of type va_list. + For example:

    +
    +
    +int vprintf(const char *fmt, va_list ap);
    +
    +
    +

    As far as we know, there is no obvious way to wrap these functions + with SWIG. This is because there is no documented way to assemble the + proper va_list structure (there are no C library functions to do it and + the contents of va_list are opaque). Not only that, the contents of a +va_list structure are closely tied to the underlying call-stack. + It's not clear that exporting a va_list would have any use or + that it would work at all.

    +

    A workaround can be implemented by writing a simple varargs C + wrapper and then using the techniques discussed earlier in this chapter + for varargs. Below is a simple wrapper for vprintf renamed so + that it can still be called as vprintf from your target + language. The %varargs used in the example restricts the + function to taking one string argument.

    +
    +
    +%{
    +int vprintf(const char *fmt, va_list ap);
    +%}
    +
    +%varargs(const char *) my_vprintf;
    +%rename(vprintf) my_vprintf;
    +
    +%inline %{
    +int my_vprintf(const char *fmt, ...) {
    +  va_list ap;
    +  int result;
    +
    +  va_start(ap, fmt);
    +  result = vprintf(fmt, ap);
    +  va_end(ap);
    +  return result;
    +}
    +%}
    +
    +
    +

    14.8 C++ Issues

    +

    Wrapping of C++ member functions that accept a variable number of + arguments presents a number of challenges. By far, the easiest way to + handle this is to use the %varargs directive. This is portable + and it fully supports classes much like the %rename directive. + For example:

    +
    +
    +%varargs (10, char * = NULL) Foo::bar;
    +
    +class Foo {
    +public:
    +     virtual void bar(char *arg, ...);   // gets varargs above
    +};
    +
    +class Spam: public Foo {
    +public:
    +     virtual void bar(char *arg, ...);   // gets varargs above
    +};
    +
    +
    +

    %varargs also works with constructors, operators, and any + other C++ programming construct that accepts variable arguments.

    +

    Doing anything more advanced than this is likely to involve a + serious world of pain. In order to use a library like libffi, you will + need to know the underlying calling conventions and details of the C++ + ABI. For instance, the details of how this is passed to member + functions as well as any hidden arguments that might be used to pass + additional information. These details are implementation specific and + may differ between compilers and even different versions of the same + compiler. Also, be aware that invoking a member function is further + complicated if it is a virtual method. In this case, invocation might + require a table lookup to obtain the proper function address (although + you might be able to obtain an address by casting a bound pointer to a + pointer to function as described in the C++ ARM section 18.3.4).

    +

    If you do decide to change the underlying action code, be aware that + SWIG always places the this pointer in arg1. Other + arguments are placed in arg2, arg3, and so forth. For + example:

    +
    +
    +%feature("action") Foo::bar {
    +   ...
    +   result = arg1->bar(arg2, arg3, etc.);
    +   ...
    +}
    +
    +
    +

    Given the potential to shoot yourself in the foot, it is probably + easier to reconsider your design or to provide an alternative interface + using a helper function than it is to create a fully general wrapper to + a varargs C++ member function.

    +

    14.9 Discussion

    +

    This chapter has provided a number of techniques that can be used to + address the problem of variable length argument wrapping. If you care + about portability and ease of use, the %varargs directive is + probably the easiest way to tackle the problem. However, using + typemaps, it is possible to do some very advanced kinds of wrapping.

    +

    One point of discussion concerns the structure of the libffi + examples in the previous section. Looking at that code, it is not at + all clear that this is the easiest way to solve the problem. However, + there are a number of subtle aspects of the solution to + consider--mostly concerning the way in which the problem has been + decomposed. First, the example is structured in a way that tries to + maintain separation between wrapper-specific information and the + declaration of the function itself. The idea here is that you might + structure your interface like this:

    +
    +
    +%typemap(const char *fmt, ...) {
    +   ...
    +}
    +%feature("action") traceprintf {
    +   ...
    +}
    +
    +/* Include some header file with traceprintf in it */
    +%include "someheader.h"
    +
    +
    +

    Second, careful scrutiny will reveal that the typemaps involving +(...) have nothing whatsoever to do with the libffi library. In + fact, they are generic with respect to the way in which the function is + actually called. This decoupling means that it will be much easier to + consider other library alternatives for making the function call. For + instance, if libffi wasn't supported on a certain platform, you might + be able to use something else instead. You could use conditional + compilation to control this:

    +
    +
    +#ifdef USE_LIBFFI
    +%feature("action") printf {
    +   ...
    +}
    +#endif
    +#ifdef USE_OTHERFFI
    +%feature("action") printf {
    +...
    +}
    +#endif
    +
    +
    +

    Finally, even though you might be inclined to just write a + hand-written wrapper for varargs functions, the techniques used in the + previous section have the advantage of being compatible with all other + features of SWIG such as exception handling.

    +

    As a final word, some C programmers seem to have the assumption that + the wrapping of variable length argument functions is an easily solved + problem. However, this section has hopefully dispelled some of these + myths. All things being equal, you are better off avoiding variable + length arguments if you can. If you can't avoid them, please consider + some of the simple solutions first. If you can't live with a simple + solution, proceed with caution. At the very least, make sure you + carefully read the section "A7.3.2 Function Calls" in Kernighan and + Ritchie and make sure you fully understand the parameter passing + conventions used for varargs. Also, be aware of the platform + dependencies and reliability issues that this will introduce. Good + luck.

    +
    +

    15 Warning Messages

    + + + + +

    15.1 Introduction

    +

    During compilation, SWIG may generate a variety of warning messages. + For example:

    +
    +
    +example.i:16: Warning 501: Overloaded declaration ignored.  bar(double)
    +example.i:15: Warning 501: Previous declaration is bar(int)
    +
    +
    +

    Typically, warning messages indicate non-fatal problems with the + input where the generated wrapper code will probably compile, but it + may not work like you expect.

    +

    15.2 Warning message suppression

    +

    All warning messages have a numeric code that is shown in the + warning message itself. To suppress the printing of a warning message, + a number of techniques can be used. First, you can run SWIG with the +-w command line option. For example:

    +
    +
    +% swig -python -w501 example.i
    +% swig -python -w501,505,401 example.i
    +
    +
    +

    Alternatively, warnings can be suppressed by inserting a special + preprocessor pragma into the input file:

    +
    +
    +%module example
    +#pragma SWIG nowarn=501
    +#pragma SWIG nowarn=501,505,401
    +
    +
    +

    Finally, code-generation warnings can be disabled on a declaration + by declaration basis using the %warnfilter directive. For + example:

    +
    +
    +%module example
    +%warnfilter(501) foo;
    +...
    +int foo(int);
    +int foo(double);              // Silently ignored.
    +
    +
    +

    The %warnfilter directive has the same semantics as other + declaration modifiers like %rename, %ignore and +%feature, see the %feature + directive section. For example, if you wanted to suppress a warning + for a method in a class hierarchy, you could do this:

    +
    +
    +%warnfilter(501) Object::foo;
    +class Object {
    +public:
    +   int foo(int);
    +   int foo(double);      // Silently ignored
    +   ...
    +};
    +
    +class Derived : public Object {
    +public:
    +   int foo(int);
    +   int foo(double);      // Silently ignored
    +   ...
    +};
    +
    +
    +

    Warnings can be suppressed for an entire class by supplying a class + name. For example:

    +
    +
    +%warnfilter(501) Object;
    +
    +class Object {
    +public:
    +   ...                      // All 501 warnings ignored in class
    +};
    +
    +
    +

    There is no option to suppress all SWIG warning messages. The + warning messages are there for a reason---to tell you that something + may be broken in your interface. Ignore the warning messages + at your own peril.

    +

    15.3 Enabling extra warnings

    +

    Some warning messages are disabled by default and are generated only + to provide additional diagnostics. These warnings can be turned on + using the -Wextra option. For example:

    +
    +
    +% swig -Wextra -python example.i
    +
    +
    +

    To selectively turn on extra warning messages, you can use the + directives and options in the previous section--simply add a "+" to all + warning numbers. For example:

    +
    +
    +% swig -w+309,+452 example.i
    +
    +
    +

    or in your interface file use either

    +
    +
    +#pragma SWIG nowarn=+309,+452
    +
    +
    +

    or

    +
    +
    +%warnfilter(+309,+452) foo;
    +
    +
    +

    Note: selective enabling of warnings with %warnfilter + overrides any global settings you might have made using -w or +#pragma.

    +

    You can of course also enable all warnings and suppress a select + few, for example:

    +
    +
    +% swig -Wextra -w309,452 example.i
    +
    +
    +

    The warnings on the right take precedence over the warnings on the + left, so in the above example -Wextra adds numerous warnings + including 452, but then -w309,452 overrides this and so 452 is + suppressesed.

    +

    If you would like all warnings to appear, regardless of the warning + filters used, then use the -Wall option. The -Wall + option also turns on the extra warnings that -Wextra adds, + however, it is subtely different. When -Wall is used, it also + disables all other warning filters, that is, any warnings suppressed or + added in %warnfilter, #pragma SWIG nowarn or the +-w option.

    +

    15.4 Issuing a warning message

    +

    Warning messages can be issued from an interface file using a number + of directives. The %warn directive is the most simple:

    +
    +
    +%warn "900:This is your last warning!"
    +
    +
    +

    All warning messages are optionally prefixed by the warning number + to use. If you are generating your own warnings, make sure you don't + use numbers defined in the table at the end of this section.

    +

    The %ignorewarn directive is the same as %ignore + except that it issues a warning message whenever a matching declaration + is found. For example:

    +
    +
    +%ignorewarn("362:operator= ignored") operator=;
    +
    +
    +

    Warning messages can be associated with typemaps using the +warning attribute of a typemap declaration. For example:

    +
    +
    +%typemap(in, warning="901:You are really going to regret this usage of $1_type $1_name") blah * {
    +   ...
    +}
    +
    +
    +

    In this case, the warning message will be printed whenever the + typemap is actually used and the +special variables will be expanded as appropriate, for example:

    +
    +
    +example.i:23: Warning 901: You are really going to regret this usage of blah * self
    +example.i:24: Warning 901: You are really going to regret this usage of blah * stuff
    +
    +
    +

    15.5 Symbolic symbols

    +

    The swigwarn.swg file that is installed with SWIG contains + symbol constants that could also be used in %warnfilter and +#pragma SWIG nowarn. For example this file contains the following + line:

    +
    +
    +%define SWIGWARN_TYPE_UNDEFINED_CLASS 401 %enddef
    +
    +
    +

    so SWIGWARN_TYPE_UNDEFINED_CLASS could be used instead of + 401, for example:

    +
    +
    +#pragma SWIG nowarn=SWIGWARN_TYPE_UNDEFINED_CLASS
    +
    +
    +

    or

    +
    +
    +%warnfilter(SWIGWARN_TYPE_UNDEFINED_CLASS) Foo;
    +
    +
    +

    15.6 Commentary

    +

    The ability to suppress warning messages is really only provided for + advanced users and is not recommended in normal use. You are advised to + modify your interface to fix the problems highlighted by the warnings + wherever possible instead of suppressing warnings.

    +

    Certain types of SWIG problems are errors. These usually arise due + to parsing errors (bad syntax) or semantic problems for which there is + no obvious recovery. There is no mechanism for suppressing error + messages.

    +

    15.7 Warnings as errors

    +

    Warnings can be handled as errors by using the -Werror + command line option. This will cause SWIG to exit with a non successful + exit code if a warning is encountered.

    +

    15.8 Message output format

    +

    The output format for both warnings and errors can be selected for + integration with your favourite IDE/editor. Editors and IDEs can + usually parse error messages and if in the appropriate format will + easily take you directly to the source of the error. The standard + format is used by default except on Windows where the Microsoft format + is used by default. These can be overridden using command line options, + for example:

    +
    +
    +$ swig -python -Fstandard example.i
    +example.i:4: Syntax error in input(1).
    +$ swig -python -Fmicrosoft example.i
    +example.i(4) : Syntax error in input(1).
    +
    +
    +

    15.9 Warning number reference

    +

    15.9.1 Deprecated features (100-199)

    +
      +
    • 101. Deprecated %extern directive.
    • +
    • 102. Deprecated %val directive.
    • +
    • 103. Deprecated %out directive.
    • +
    • 104. Deprecated %disabledoc directive.
    • +
    • 105. Deprecated %enabledoc directive.
    • +
    • 106. Deprecated %doconly directive.
    • +
    • 107. Deprecated %style directive.
    • +
    • 108. Deprecated %localstyle directive.
    • +
    • 109. Deprecated %title directive.
    • +
    • 110. Deprecated %section directive.
    • +
    • 111. Deprecated %subsection directive.
    • +
    • 112. Deprecated %subsubsection directive.
    • +
    • 113. Deprecated %addmethods directive.
    • +
    • 114. Deprecated %readonly directive.
    • +
    • 115. Deprecated %readwrite directive.
    • +
    • 116. Deprecated %except directive.
    • +
    • 117. Deprecated %new directive.
    • +
    • 118. Deprecated %typemap(except).
    • +
    • 119. Deprecated %typemap(ignore).
    • +
    • 120. Deprecated command line option (-runtime, -noruntime).
    • +
    • 121. Deprecated %name directive.
    • +
    • 126. The 'nestedworkaround' feature is deprecated.
    • +
    +

    15.9.2 Preprocessor (200-299)

    +
      +
    • 201. Unable to find filename.
    • +
    • 202. Could not evaluate expression expr.
    • +
    • 203. Both includeall and importall are defined: using includeall.
    • +
    • 204. CPP #warning, "warning".
    • +
    • 205. CPP #error, "error".
    • +
    • 206. Unexpected tokens after #directive directive.
    • +
    +

    15.9.3 C/C++ Parser (300-399)

    +
      +
    • 301. class keyword used, but not in C++ mode.
    • +
    • 302. Identifier 'name' redefined (ignored).
    • +
    • 303. %extend defined for an undeclared class 'name +'.
    • +
    • 304. Unsupported constant value (ignored).
    • +
    • 305. Bad constant value (ignored).
    • +
    • 306. 'identifier' is private in this context.
    • +
    • 307. Can't set default argument value (ignored)
    • +
    • 308. Namespace alias 'name' not allowed here. Assuming ' +name'
    • +
    • 309. [private | protected] inheritance ignored.
    • +
    • 310. Template 'name' was already wrapped as 'name' + (ignored)
    • +
    • 312. Unnamed nested class not currently supported (ignored).
    • +
    • 313. Unrecognized extern type "name" (ignored).
    • +
    • 314. 'identifier' is a lang keyword.
    • +
    • 315. Nothing known about 'identifier'.
    • +
    • 316. Repeated %module directive.
    • +
    • 317. Specialization of non-template 'name'.
    • +
    • 318. Instantiation of template 'name' is ambiguous, + instantiation templ used, instantiation templ + ignored.
    • +
    • 319. No access specifier given for base class name + (ignored).
    • +
    • 320. Explicit template instantiation ignored.
    • +
    • 321. identifier conflicts with a built-in name.
    • +
    • 322. Redundant redeclaration of 'name'.
    • +
    • 323. Recursive scope inheritance of 'name'.
    • +
    • 324. Named nested template instantiations not supported. Processing + as if no name was given to %template().
    • +
    • 325. Nested kind not currently supported (name + ignored).
    • +
    • 326. Deprecated %extend name used - the kind name 'name +' should be used instead of the typedef name 'name'.
    • +
    • 350. operator new ignored.
    • +
    • 351. operator delete ignored.
    • +
    • 352. operator+ ignored.
    • +
    • 353. operator- ignored.
    • +
    • 354. operator* ignored.
    • +
    • 355. operator/ ignored.
    • +
    • 356. operator% ignored.
    • +
    • 357. operator^ ignored.
    • +
    • 358. operator& ignored.
    • +
    • 359. operator| ignored.
    • +
    • 360. operator~ ignored.
    • +
    • 361. operator! ignored.
    • +
    • 362. operator= ignored.
    • +
    • 363. operator< ignored.
    • +
    • 364. operator> ignored.
    • +
    • 365. operator+= ignored.
    • +
    • 366. operator-= ignored.
    • +
    • 367. operator*= ignored.
    • +
    • 368. operator/= ignored.
    • +
    • 369. operator%= ignored.
    • +
    • 370. operator^= ignored.
    • +
    • 371. operator&= ignored.
    • +
    • 372. operator|= ignored.
    • +
    • 373. operator<< ignored.
    • +
    • 374. operator>>ignored.
    • +
    • 375. operator<<= ignored.
    • +
    • 376. operator>>= ignored.
    • +
    • 377. operator== ignored.
    • +
    • 378. operator!= ignored.
    • +
    • 379. operator<= ignored.
    • +
    • 380. operator>= ignored.
    • +
    • 381. operator&& ignored.
    • +
    • 382. operator|| ignored.
    • +
    • 383. operator++ ignored.
    • +
    • 384. operator-- ignored.
    • +
    • 385. operator, ignored.
    • +
    • 386. operator-<* ignored.
    • +
    • 387. operator-< ignored.
    • +
    • 388. operator() ignored.
    • +
    • 389. operator[] ignored.
    • +
    • 390. operator+ ignored (unary).
    • +
    • 391. operator- ignored (unary).
    • +
    • 392. operator* ignored (unary).
    • +
    • 393. operator& ignored (unary).
    • +
    • 394. operator new[] ignored.
    • +
    • 395. operator delete[] ignored.
    • +
    +

    15.9.4 Types and typemaps (400-499)

    +
      +
    • 401. Nothing known about class 'name'. Ignored.
    • +
    • 402. Base class 'name' is incomplete.
    • +
    • 403. Class 'name' might be abstract.
    • +
    • 450. Deprecated typemap feature ($source/$target).
    • +
    • 451. Setting const char * variable may leak memory.
    • +
    • 452. Reserved
    • +
    • 453. Can't apply (pattern). No typemaps are defined.
    • +
    • 460. Unable to use type type as a function argument.
    • +
    • 461. Unable to use return type type in function name +.
    • +
    • 462. Unable to set variable of type type.
    • +
    • 463. Unable to read variable of type type.
    • +
    • 464. Unsupported constant value.
    • +
    • 465. Unable to handle type type.
    • +
    • 466. Unsupported variable type type.
    • +
    • 467. Overloaded declaration not supported (incomplete type + checking rule - no precedence level in typecheck typemap for 'type +')
    • +
    • 468. No 'throw' typemap defined for exception type type
    • +
    • 469. No or improper directorin typemap defined for type
    • +
    • 470. Thread/reentrant unsafe wrapping, consider returning by value + instead.
    • +
    • 471. Unable to use return type type in director method
    • +
    • 474. Method method usage of the optimal attribute ignored + in the out typemap as the following cannot be used to generate optimal + code: code
    • +
    • 475. Multiple calls to method might be generated due to + optimal attribute usage in the out typemap.
    • +
    • 476. Initialization using std::initializer_list.
    • +
    • 477. No directorthrows typemap defined for type
    • +
    +

    15.9.5 Code generation (500-599)

    +
      +
    • 501. Overloaded declaration ignored. decl. Previous + declaration is decl.
    • +
    • 502. Overloaded constructor ignored. decl. Previous + declaration is decl.
    • +
    • 503. Can't wrap 'identifier' unless renamed to a valid + identifier.
    • +
    • 504. Function name must have a return type. Ignored.
    • +
    • 505. Variable length arguments discarded.
    • +
    • 506. Can't wrap varargs with keyword arguments enabled.
    • +
    • 507. Adding native function name not supported (ignored).
    • +
    • 508. Declaration of 'name' shadows declaration accessible + via operator->(), previous declaration of'declaration'.
    • +
    • 509. Overloaded method declaration effectively ignored, as + it is shadowed by declaration.
    • +
    • 510. Friend function 'name' ignored.
    • +
    • 511. Can't use keyword arguments with overloaded functions.
    • +
    • 512. Overloaded method declaration ignored, using non-const + method declaration instead.
    • +
    • 513. Can't generate wrappers for unnamed struct/class.
    • +
    • 514.
    • +
    • 515.
    • +
    • 516. Overloaded method declaration ignored, using + declaration instead.
    • +
    • 517.
    • +
    • 518. Portability warning: File file1 will be overwritten by + file2 on case insensitive filesystems such as Windows' FAT32 and + NTFS unless the class/module name is renamed.
    • +
    • 519. %template() contains no name. Template method ignored: + declaration
    • +
    • 520. Base/Derived class 'classname1' of ' +classname2' is not similarly marked as a smart pointer.
    • +
    • 521. Illegal destructor name name. Ignored.
    • +
    • 522. Use of an illegal constructor name 'name' in %extend + is deprecated, the constructor name should be 'name'.
    • +
    • 523. Use of an illegal destructor name 'name' in %extend is + deprecated, the destructor name should be 'name'.
    • +
    +

    15.9.6 Language module specific (700-899) +

    +
      +
    • 801. Wrong name (corrected to 'name'). (Ruby).
    • +
    +
      +
    • 810. No jni typemap defined for type (Java).
    • +
    • 811. No jtype typemap defined for type (Java).
    • +
    • 812. No jstype typemap defined for type (Java).
    • +
    • 813. Warning for classname, base baseclass + ignored. Multiple inheritance is not supported in Java. (Java).
    • +
    • 814.
    • +
    • 815. No javafinalize typemap defined for type (Java).
    • +
    • 816. No javabody typemap defined for type (Java).
    • +
    • 817. No javaout typemap defined for type (Java).
    • +
    • 818. No javain typemap defined for type (Java).
    • +
    • 819. No javadirectorin typemap defined for type (Java).
    • +
    • 820. No javadirectorout typemap defined for type (Java).
    • +
    • 821.
    • +
    • 822. Covariant return types not supported in Java. Proxy method will + return basetype (Java).
    • +
    • 823. No javaconstruct typemap defined for type (Java).
    • +
    • 824. Missing JNI descriptor in directorin typemap defined for + type (Java).
    • +
    • 825. "directorconnect" attribute missing in type + "javaconstruct" typemap. (Java).
    • +
    • 826. The nspace feature is used on 'type' without -package. + The generated code may not compile as Java does not support types + declared in a named package accessing types declared in an unnamed + package. (Java).
    • +
    +
      +
    • 830. No ctype typemap defined for type (C#).
    • +
    • 831. No cstype typemap defined for type (C#).
    • +
    • 832. No cswtype typemap defined for type (C#).
    • +
    • 833. Warning for classname, base baseclass + ignored. Multiple inheritance is not supported in C#. (C#).
    • +
    • 834.
    • +
    • 835. No csfinalize typemap defined for type (C#).
    • +
    • 836. No csbody typemap defined for type (C#).
    • +
    • 837. No csout typemap defined for type (C#).
    • +
    • 838. No csin typemap defined for type (C#).
    • +
    • 839.
    • +
    • 840.
    • +
    • 841.
    • +
    • 842. Covariant return types not supported in C#. Proxy method will + return basetype (C#).
    • +
    • 843. No csconstruct typemap defined for type (C#).
    • +
    • 844. C# exception may not be thrown - no $excode or excode attribute + in typemap typemap. (C#).
    • +
    • 845. Unmanaged code contains a call to a + SWIG_CSharpSetPendingException method and C# code does not handle + pending exceptions via the canthrow attribute. (C#).
    • +
    +
      +
    • 870. Warning for classname: Base baseclass + ignored. Multiple inheritance is not supported in PHP. (Php).
    • +
    • 871. Unrecognized pragma pragma. (Php).
    • +
    +

    15.9.7 User defined (900-999)

    +

    These numbers can be used by your own application.

    +

    15.10 History

    +

    The ability to control warning messages was first added to + SWIG-1.3.12.

    +
    +

    16 Working with Modules

    + + + + +

    16.1 Modules Introduction

    +

    Each invocation of SWIG requires a module name to be specified. The + module name is used to name the resulting target language extension + module. Exactly what this means and what the name is used for depends + on the target language, for example the name can define a target + language namespace or merely be a useful name for naming files or + helper classes. Essentially, a module comprises target language + wrappers for a chosen collection of global variables/functions, + structs/classes and other C/C++ types.

    +

    The module name can be supplied in one of two ways. The first is to + specify it with the special %module directive. This directive + must appear at the beginning of the interface file. The general form of + this directive is:

    +
    +
    +%module(option1="value1",option2="value2",...) modulename
    +
    +
    +

    where the modulename is mandatory and the options add one or more + optional additional features. Typically no options are specified, for + example:

    +
    +
    +%module mymodule
    +
    +
    +

    The second way to specify the module name is with the -module + command line option, for example -module mymodule. If the + module name is supplied on the command line, it overrides the name + specified by the %module directive.

    +

    When first working with SWIG, users commonly start by creating a + single module. That is, you might define a single SWIG interface that + wraps some set of C/C++ code. You then compile all of the generated + wrapper code together and use it. For large applications, however, this + approach is problematic---the size of the generated wrapper code can be + rather large. Moreover, it is probably easier to manage the target + language interface when it is broken up into smaller pieces.

    +

    This chapter describes the problem of using SWIG in programs where + you want to create a collection of modules. Each module in the + collection is created via separate invocations of SWIG.

    +

    16.2 Basics

    +

    The basic usage case with multiple modules is when modules do not + have cross-references (ie. when wrapping multiple independent C APIs). + In that case, swig input files should just work out of the box - you + simply create multiple wrapper .cxx files, link them into your + application, and insert/load each in the scripting language runtime as + you would do for the single module case.

    +

    A bit more complex is the case in which modules need to share + information. For example, when one module extends the class of another + by deriving from it:

    +
    +
    +// File: base.h
    +class base {
    +public:
    +  int foo();
    +};
    +
    +
     
    +
    +// File: base_module.i
    +%module base_module
    +
    +%{
    +#include "base.h"
    +%}
    +%include "base.h"
    +
    +
     
    +
    +// File: derived_module.i
    +%module derived_module
    +
    +%import "base_module.i"
    +
    +%inline %{
    +class derived : public base {
    +public:
    +  int bar();
    +};
    +%}
    +
    +
    +

    To create the wrapper properly, module derived_module needs + to know about the base class and that its interface is covered + in another module. The line %import "base_module.i" lets SWIG + know exactly that. Often the .h file is passed to %import + instead of the .i, which unfortunately doesn't work for all + language modules. For example, Python requires the name of module that + the base class exists in so that the proxy classes can fully inherit + the base class's methods. Typically you will get a warning when the + module name is missing, eg:

    +
    +
    +derived_module.i:8: Warning 401: Base class 'base' ignored - unknown module name for base. Either
    +import
    +the appropriate module interface file or specify the name of the module in the %import directive.
    +
    +
    +

    It is sometimes desirable to import the header file rather than the + interface file and overcome the above warning. For example in the case + of the imported interface being quite large, it may be desirable to + simplify matters and just import a small header file of dependent + types. This can be done by specifying the optional module + attribute in the %import directive. The derived_module.i + file shown above could be replaced with the following:

    +
    +// File: derived_module.i
    +%module derived_module
    +
    +%import(module="base_module") "base.h"
    +
    +%inline %{
    +class derived : public base {
    +public:
    +  int bar();
    +};
    +
    +

    +

    Note that "base_module" is the module name and is the same as that + specified in %module in base_module.i as well as the +%import in derived_module.i.

    +

    Another issue to beware of is that multiple dependent wrappers + should not be linked/loaded in parallel from multiple threads as SWIG + provides no locking - for more on that issue, read on.

    +

    16.3 The SWIG runtime code

    +

    Many of SWIG's target languages generate a set of functions commonly + known as the "SWIG runtime." These functions are primarily related to + the runtime type system which checks pointer types and performs other + tasks such as proper casting of pointer values in C++. As a general + rule, the statically typed target languages, such as Java, use the + language's built in static type checking and have no need for a SWIG + runtime. All the dynamically typed / interpreted languages rely on the + SWIG runtime.

    +

    The runtime functions are private to each SWIG-generated module. + That is, the runtime functions are declared with "static" linkage and + are visible only to the wrapper functions defined in that module. The + only problem with this approach is that when more than one SWIG module + is used in the same application, those modules often need to share type + information. This is especially true for C++ programs where SWIG must + collect and share information about inheritance relationships that + cross module boundaries.

    +

    To solve the problem of sharing information across modules, a + pointer to the type information is stored in a global variable in the + target language namespace. During module initialization, type + information is loaded into the global data structure of type + information from all modules.

    +

    There are a few trade offs with this approach. This type information + is global across all SWIG modules loaded, and can cause type conflicts + between modules that were not designed to work together. To solve this + approach, the SWIG runtime code uses a define SWIG_TYPE_TABLE to + provide a unique type table. This behavior can be enabled when + compiling the generated _wrap.cxx or _wrap.c file by adding + -DSWIG_TYPE_TABLE=myprojectname to the command line argument.

    +

    Then, only modules compiled with SWIG_TYPE_TABLE set to + myprojectname will share type information. So if your project has three + modules, all three should be compiled with + -DSWIG_TYPE_TABLE=myprojectname, and then these three modules will + share type information. But any other project's types will not + interfere or clash with the types in your module.

    +

    Another issue relating to the global type table is thread safety. If + two modules try and load at the same time, the type information can + become corrupt. SWIG currently does not provide any locking, and if you + use threads, you must make sure that modules are loaded serially. Be + careful if you use threads and the automatic module loading that some + scripting languages provide. One solution is to load all modules before + spawning any threads, or use SWIG_TYPE_TABLE to separate type tables so + they do not clash with each other.

    +

    Lastly, SWIG uses a #define SWIG_RUNTIME_VERSION, located in + Lib/swigrun.swg and near the top of every generated module. This number + gets incremented when the data structures change, so that SWIG modules + generated with different versions can peacefully coexist. So the type + structures are separated by the (SWIG_TYPE_TABLE, SWIG_RUNTIME_VERSION) + pair, where by default SWIG_TYPE_TABLE is empty. Only modules compiled + with the same pair will share type information.

    +

    16.4 External access to the + runtime

    +

    As described in The run-time + type checker, the functions SWIG_TypeQuery, +SWIG_NewPointerObj, and others sometimes need to be called. Calling + these functions from a typemap is supported, since the typemap code is + embedded into the _wrap.c file, which has those declarations + available. If you need to call the SWIG run-time functions from another + C file, there is one header you need to include. To generate the header + that needs to be included, SWIG can be run in a different mode via +-external-runtime to generate the run-time instead of the normal + mode of processing an input interface file. For example:

    +
    +$ swig -python -external-runtime <filename>
    +
    +

    +

    The filename argument is optional and if it is not passed, then the + default filename will be something like swigpyrun.h, depending + on the language. This header file should be treated like any of the + other _wrap.c output files, and should be regenerated when the _wrap + files are. After including this header, your code will be able to call +SWIG_TypeQuery, SWIG_NewPointerObj, SWIG_ConvertPtr + and others. The exact argument parameters for these functions might + differ between language modules; please check the language module + chapters for more information.

    +

    Inside this header the functions are declared static and are included + inline into the file, and thus the file does not need to be linked + against any SWIG libraries or code (you might still need to link + against the language libraries like libpython-2.3). Data is shared + between this file and the _wrap.c files through a global variable in + the scripting language. It is also possible to copy this header file + along with the generated wrapper files into your own package, so that + you can distribute a package that can be compiled without SWIG + installed (this works because the header file is self-contained, and + does not need to link with anything).

    +

    This header will also use the -DSWIG_TYPE_TABLE described above, so + when compiling any code which includes the generated header file should + define the SWIG_TYPE_TABLE to be the same as the module whose types you + are trying to access.

    +

    16.5 A word of caution about static libraries +

    +

    When working with multiple SWIG modules, you should take care not to + use static libraries. For example, if you have a static library +libfoo.a and you link a collection of SWIG modules with that + library, each module will get its own private copy of the library code + inserted into it. This is very often NOT what you want and it + can lead to unexpected or bizarre program behavior. When working with + dynamically loadable modules, you should try to work exclusively with + shared libraries.

    +

    16.6 References

    +

    Due to the complexity of working with shared libraries and multiple + modules, it might be a good idea to consult an outside reference. John + Levine's "Linkers and Loaders" is highly recommended.

    +

    16.7 Reducing the wrapper file size

    +

    Using multiple modules with the %import directive is the + most common approach to modularising large projects. In this way a + number of different wrapper files can be generated, thereby avoiding + the generation of a single large wrapper file. There are a couple of + alternative solutions for reducing the size of a wrapper file through + the use of command line options and features.

    +

    -fcompact +
    This command line option will compact the size of the wrapper file + without changing the code generated into the wrapper file. It simply + removes blank lines and joins lines of code together. This is useful + for compilers that have a maximum file size that can be handled.

    +

    -fvirtual +
    This command line option will remove the generation of superfluous + virtual method wrappers. Consider the following inheritance hierarchy:

    +
    +
    +struct Base {
    +  virtual void method();
    +  ...
    +};
    +
    +struct Derived : Base {
    +  virtual void method();
    +  ...
    +};
    +
    +
    +

    Normally wrappers are generated for both methods, whereas this + command line option will suppress the generation of a wrapper for +Derived::method. Normal polymorphic behaviour remains as +Derived::method will still be called should you have a Derived + instance and call the wrapper for Base::method.

    +

    %feature("compactdefaultargs") +
    This feature can reduce the number of wrapper methods when wrapping + methods with default arguments. The section on +default arguments discusses the feature and its limitations.

    +
    +

    17 Using SWIG with ccache - ccache-swig(1) manpage +

    + + + + +

    +

    17.1 NAME

    +

    ccache-swig - a fast compiler cache

    +

    +

    17.2 SYNOPSIS

    +

    ccache-swig [OPTION]

    +

    ccache-swig <compiler> [COMPILER OPTIONS]

    +

    <compiler> [COMPILER OPTIONS]

    +

    +

    17.3 DESCRIPTION

    +

    ccache-swig is a compiler cache. It speeds up re-compilation of + C/C++/SWIG code by caching previous compiles and detecting when the + same compile is being done again. ccache-swig is ccache plus support + for SWIG. ccache and ccache-swig are used interchangeably in this + document.

    +

    +

    17.4 OPTIONS SUMMARY

    +

    Here is a summary of the options to ccache-swig.

    +

    +
    +
    +-s                      show statistics summary
    +-z                      zero statistics
    +-c                      run a cache cleanup
    +-C                      clear the cache completely
    +-F <n>                  set maximum files in cache
    +-M <n>                  set maximum size of cache (use G, M or K)
    +-h                      this help page
    +-V                      print version number
    +
    +
    +

    +

    17.5 OPTIONS

    +

    These options only apply when you invoke ccache as "ccache-swig". + When invoked as a compiler none of these options apply. In that case + your normal compiler options apply and you should refer to your + compilers documentation.

    +

    +
    +

    +

    -h
    +
    Print a options summary page +

    +

    +
    +
    -s
    +
    Print the current statistics summary for the cache. The statistics + are stored spread across the subdirectories of the cache. Using + "ccache-swig -s" adds up the statistics across all subdirectories and + prints the totals. +

    +

    +
    +
    -z
    +
    Zero the cache statistics. +

    +

    +
    +
    -V
    +
    Print the ccache version number +

    +

    +
    +
    -c
    +
    Clean the cache and re-calculate the cache file count and size + totals. Normally the -c option should not be necessary as ccache keeps + the cache below the specified limits at runtime and keeps statistics up + to date on each compile. This option is mostly useful if you manually + modify the cache contents or believe that the cache size statistics may + be inaccurate. +

    +

    +
    +
    -C
    +
    Clear the entire cache, removing all cached files. +

    +

    +
    +
    -F <maxfiles>
    +
    This sets the maximum number of files allowed in the cache. The + value is stored inside the cache directory and applies to all future + compiles. Due to the way the value is stored the actual value used is + always rounded down to the nearest multiple of 16. +

    +

    +
    +
    -M <maxsize>
    +
    This sets the maximum cache size. You can specify a value in + gigabytes, megabytes or kilobytes by appending a G, M or K to the + value. The default is gigabytes. The actual value stored is rounded + down to the nearest multiple of 16 kilobytes. +

    +
    +

    +
    +

    +

    17.6 INSTALLATION

    +

    There are two ways to use ccache. You can either prefix your compile + commands with "ccache-swig" or you can create a symbolic link between + ccache-swig and the names of your compilers. The first method is most + convenient if you just want to try out ccache or wish to use it for + some specific projects. The second method is most useful for when you + wish to use ccache for all your compiles.

    +

    To install for usage by the first method just copy ccache-swig to + somewhere in your path.

    +

    To install for the second method do something like this:

    +
    +
    +  cp ccache-swig /usr/local/bin/
    +  ln -s /usr/local/bin/ccache-swig /usr/local/bin/gcc
    +  ln -s /usr/local/bin/ccache-swig /usr/local/bin/g++
    +  ln -s /usr/local/bin/ccache-swig /usr/local/bin/cc
    +  ln -s /usr/local/bin/ccache-swig /usr/local/bin/swig
    +
    +
    + This will work as long as /usr/local/bin comes before the path to gcc + (which is usually in /usr/bin). After installing you may wish to run + "which gcc" to make sure that the correct link is being used. +

    Note! Do not use a hard link, use a symbolic link. A hardlink will + cause "interesting" problems.

    +

    +

    17.7 EXTRA OPTIONS

    +

    When run as a compiler front end ccache usually just takes the same + command line options as the compiler you are using. The only exception + to this is the option '--ccache-skip'. That option can be used to tell + ccache that the next option is definitely not a input filename, and + should be passed along to the compiler as-is.

    +

    The reason this can be important is that ccache does need to parse + the command line and determine what is an input filename and what is a + compiler option, as it needs the input filename to determine the name + of the resulting object file (among other things). The heuristic ccache + uses in this parse is that any string on the command line that exists + as a file is treated as an input file name (usually a C file). By using + --ccache-skip you can force an option to not be treated as an input + file name and instead be passed along to the compiler as a command line + option.

    +

    +

    17.8 ENVIRONMENT VARIABLES

    +

    ccache uses a number of environment variables to control operation. + In most cases you won't need any of these as the defaults will be fine.

    +

    +
    +

    +

    +

    CCACHE_DIR
    +
    the CCACHE_DIR environment variable specifies where ccache will + keep its cached compiler output. The default is "$HOME/.ccache". +

    +

    +
    +
    CCACHE_TEMPDIR
    +
    the CCACHE_TEMPDIR environment variable specifies where ccache will + put temporary files. The default is the same as CCACHE_DIR. Note that + the CCACHE_TEMPDIR path must be on the same filesystem as the + CCACHE_DIR path, so that renames of files between the two directories + can work. +

    +

    +
    +
    CCACHE_LOGFILE
    +
    If you set the CCACHE_LOGFILE environment variable then ccache will + write some log information on cache hits and misses in that file. This + is useful for tracking down problems. +

    +

    +
    +
    CCACHE_VERBOSE
    +
    If you set the CCACHE_VERBOSE environment variable then ccache will + display on stdout all the compiler invocations that it makes. This can + useful for debugging unexpected problems. +

    +

    +
    +
    CCACHE_PATH
    +
    You can optionally set CCACHE_PATH to a colon separated path where + ccache will look for the real compilers. If you don't do this then + ccache will look for the first executable matching the compiler name in + the normal PATH that isn't a symbolic link to ccache itself. +

    +

    +
    +
    CCACHE_CC
    You can optionally set CCACHE_CC to force the name of the compiler to use. If you don't do this then ccache works it out from the command line. @@ -19081,7 +20703,7 @@ default arguments discusses the feature and its limitations.

    -

    16.9 CACHE SIZE MANAGEMENT

    +

    17.9 CACHE SIZE MANAGEMENT

    By default ccache has a one gigabyte limit on the cache size and no maximum number of files. You can set a different limit using the "ccache -M" and "ccache -F" options, which set the size and number of @@ -19090,14 +20712,14 @@ default arguments discusses the feature and its limitations.

    below the numbers you specified in order to avoid doing the cache clean operation too often.

    -

    16.10 CACHE COMPRESSION

    +

    17.10 CACHE COMPRESSION

    By default on most platforms ccache will compress all files it puts into the cache using the zlib compression. While this involves a negligible performance slowdown, it significantly increases the number of files that fit in the cache. You can turn off compression setting the CCACHE_NOCOMPRESS environment variable.

    -

    16.11 HOW IT WORKS

    +

    17.11 HOW IT WORKS

    The basic idea is to detect when you are compiling exactly the same code a 2nd time and use the previously compiled output. You detect that it is the same code by forming a hash of:

    @@ -19117,7 +20739,7 @@ default arguments discusses the feature and its limitations.

    discover a case where ccache changes the output of your compiler then please let me know.

    -

    16.12 USING CCACHE WITH DISTCC

    +

    17.12 USING CCACHE WITH DISTCC

    distcc is a very useful program for distributing compilation across a range of compiler servers. It is often useful to combine distcc with ccache, so that compiles that are done are sped up by distcc, but that @@ -19127,7 +20749,7 @@ default arguments discusses the feature and its limitations.

    'distcc' and ccache will prefix the command line used with the compiler with the command 'distcc'.

    -

    16.13 SHARING A CACHE

    +

    17.13 SHARING A CACHE

    A group of developers can increase the cache hit rate by sharing a cache directory. The hard links however cause unwanted side effects, as all links to a cached file share the file's modification timestamp. @@ -19154,7 +20776,7 @@ default arguments discusses the feature and its limitations.

    users with versions of ccache that do not support compression.

    -

    16.14 HISTORY

    +

    17.14 HISTORY

    ccache was inspired by the compilercache shell script script written by Erik Thiele and I would like to thank him for an excellent piece of work. See @@ -19165,7 +20787,7 @@ http://www.erikyyy.de/compilercache/ for the Erik's scripts. compiler cache and I wanted to remove some of the limitations of the shell-script version.

    -

    16.15 DIFFERENCES FROM COMPILERCACHE

    +

    17.15 DIFFERENCES FROM COMPILERCACHE

    The biggest differences between Erik's compilercache script and ccache are:

      @@ -19180,7 +20802,7 @@ http://www.erikyyy.de/compilercache/ for the Erik's scripts.
    • ccache avoids a double call to cpp on a cache miss

    -

    16.16 CREDITS

    +

    17.16 CREDITS

    Thanks to the following people for their contributions to ccache

    • Erik Thiele for the original compilercache script
    • @@ -19189,7 +20811,7 @@ http://www.erikyyy.de/compilercache/ for the Erik's scripts.
    • Paul Russell for many suggestions and the debian packaging

    -

    16.17 AUTHOR

    +

    17.17 AUTHOR

    ccache was written by Andrew Tridgell http://samba.org/~tridge/. ccache was adapted to create ccache-swig for use with SWIG by William Fulton.

    @@ -19200,9 +20822,7 @@ http://www.swig.org/mail.html

    later. Please see the file COPYING for license details.


    - - -

    17 SWIG and Allegro Common Lisp

    +

    18 SWIG and Allegro Common Lisp

    @@ -19332,8 +20952,8 @@ http://www.swig.org/mail.html

    interfaces (UFFI or CFFI, for example). Such work can only benefit the lisp community, and we would not be unhappy to see some enterprising folk use this work to add to it.

    -

    17.1 Basics

    -

    17.1.1 Running SWIG

    +

    18.1 Basics

    +

    18.1.1 Running SWIG

    If you're reading this, you must have some library you need to generate an interface for. In order for SWIG to do this work, however, it needs a bit of information about how it should go about creating @@ -19513,7 +21133,7 @@ EXPORT int ACL___fact__SWIG_1 (int larg1) { lisp, you will also need to link in the Allegro shared library. The library you create from the C++ wrapper will be what you then load into Allegro CL.

    -

    17.1.2 Command Line Options

    +

    18.1.2 Command Line Options

    There are three Allegro CL specific command-line option:

    @@ -19521,27 +21141,27 @@ swig -allegrocl [ options ] filename
     
        -identifier-converter [name] - Binds the variable swig:*swig-identifier-convert* 
                                       in the generated .cl file to name.
    -				  This function is used to generate symbols
    -				  for the lisp side of the interface. 
    +                                  This function is used to generate symbols
    +                                  for the lisp side of the interface.
     
        -cwrap - [default] Generate a .cxx file containing C wrapper function when
                 wrapping C code. The interface generated is similar to what is
    -	    done for C++ code.
    +            done for C++ code.
        -nocwrap - Explicitly turn off generation of .cxx wrappers for C code. Reasonable
                   for modules with simple interfaces. Can not handle all legal enum
    -	      and constant constructs, or take advantage of SWIG customization features.
    +              and constant constructs, or take advantage of SWIG customization features.
     
        -isolate - With this command-line argument, all lisp helper functions are defined
                   in a unique package named swig.<module-name> rather than
    -	      swig. This prevents conflicts when the module is
    -	      intended to be used with other swig generated interfaces that may, 
    -	      for instance, make use of different identifier converters.
    +              swig. This prevents conflicts when the module is
    +              intended to be used with other swig generated interfaces that may,
    +              for instance, make use of different identifier converters.
     

    See Section 17.5 Identifier converter functions for more details.

    -

    17.1.3 Inserting user code into - generated files

    +

    18.1.3 Inserting user code into generated + files

    It is often necessary to include user-defined code into the automatically generated interface files. For example, when building a C++ interface, example_wrap.cxx will likely not compile unless you add @@ -19569,11 +21189,11 @@ int fact(int n);

    Note that the block %{ ... %} is effectively a shortcut for %insert("header") %{ ... %}.

    -

    17.2 Wrapping Overview

    +

    18.2 Wrapping Overview

    New users to SWIG are encouraged to read SWIG Basics , and SWIG and C++, for those interested in generating an interface to C++.

    -

    17.2.1 Function Wrapping

    +

    18.2.1 Function Wrapping

    Writing lisp code that directly invokes functions at the foreign function interface level can be cumbersome. Data must often be translated between lisp and foreign types, data extracted from objects, @@ -19591,7 +21211,7 @@ int fact(int n); | Foreign Code | What we're generating an interface to. |______________| | - | + | _______v______ | | (foreign side) | Wrapper code | extern "C" wrappers calling C++ @@ -19603,28 +21223,28 @@ int fact(int n); | FFI Layer | Low level lisp interface. ff:def-foreign-call, |______________| ff:def-foreign-variable | - +---------------------------- + +---------------------------- _______v______ _______v______ | | | | (lisp side) | Defuns | | Defmethods | wrapper for overloaded |______________| |______________| functions or those with (lisp side) | defaulted arguments - Wrapper for non-overloaded | - functions and methods _______v______ - | | (lisp side) - | Defuns | dispatch function - |______________| to overloads based - on arity + Wrapper for non-overloaded | + functions and methods _______v______ + | | (lisp side) + | Defuns | dispatch function + |______________| to overloads based + on arity

    -

    17.2.2 Foreign Wrappers

    +

    18.2.2 Foreign Wrappers

    These wrappers are as generated by SWIG default. The types of function parameters can be transformed in place using the CTYPE typemap. This is use for converting pass-by-value parameters to pass-by-reference where necessary. All wrapper parameters are then bound to local variables for possible transformation of values (see LIN typemap). Return values can be transformed via the OUT typemap.

    -

    17.2.3 FFI Wrappers

    +

    18.2.3 FFI Wrappers

    These are the generated ff:def-foreign-call forms. No typemaps are applicable to this layer, but the %ffargs directive is available for use in .i files, to specify which keyword arguments @@ -19692,7 +21312,7 @@ char *xxx();

    Is the only default value specified in allegrocl.swg to force the muffling of warnings about automatic string conversion when defining ff:def-foreign-call's.

    -

    17.2.4 Non-overloaded Defuns

    +

    18.2.4 Non-overloaded Defuns

    These are simple defuns. There is no typechecking of arguments. Parameters are bound to local variables for possible transformation of values, such as pulling values out of instance slots or allocating @@ -19700,7 +21320,7 @@ char *xxx(); These arguments are then passed to the foreign-call (where typechecking may occur). The return value from this function can be manipulated via the lout typemap.

    -

    17.2.5 Overloaded Defuns

    +

    18.2.5 Overloaded Defuns

    In the case of overloaded functions, mulitple layers are generated. First, all the overloads for a given name are separated out into groups based on arity, and are wrapped in defmethods. Each method calls a @@ -19710,8 +21330,8 @@ char *xxx(); appropriate generic-function based on arity. This provides a single functional interface to all overloads. The return value from this function can be manipulated via the lout typemap.

    -

    17.2.6 What about constant and variable - access?

    +

    18.2.6 What about constant and variable + access?

    Along with the described functional layering, when creating a .cxx wrapper, this module will generate getter and--if not immutable--setter, functions for variables and constants. If the @@ -19719,7 +21339,7 @@ char *xxx(); ff:def-foreign-variable forms will be generated for accessing constants and global variables. These, along with the defuns listed above are the intended API for calling into the foreign module.

    -

    17.2.7 Object Wrapping

    +

    18.2.7 Object Wrapping

    All non-primitive types (Classes, structs, unions, and typedefs involving same) have a corresponding foreign-type defined on the lisp side via ff:def-foreign-type.

    @@ -19733,10 +21353,10 @@ ff:def-foreign-variable forms will be generated for accessing legally be passed and the pointer to the C++ object automatically extracted. This is a natural feature of Allegro's foreign function interface.

    -

    17.3 Wrapping Details

    +

    18.3 Wrapping Details

    In this section is described how particular C/C++ constructs are translated into lisp.

    -

    17.3.1 Namespaces

    +

    18.3.1 Namespaces

    C++ namespaces are translated into Lisp packages by SWIG. The Global namespace is mapped to a package named by the %module directive or the -module command-line argument. Further @@ -19797,9 +21417,9 @@ namespace car { toplevel modules package. This may lead to confusion if, for example, the current package is foo.car.tires and you attempt to use a common-lisp function such as (car '(1 2 3).

    -

    17.3.2 Constants

    +

    18.3.2 Constants

    Constants, as declared by the preprocessor #define macro or SWIG -%constant directive, are included in SWIGs parse tree when it can +%constant directive, are included in SWIG's parse tree when it can be determined that they are, or could be reduced to, a literal value. Such values are translated into defconstant forms in the generated lisp wrapper when the -nocwrap command-line options is used. Else, wrapper @@ -19843,7 +21463,7 @@ namespace car {

    Users are cautioned to get to know their constants before use, or not use the -nocwrap command-line option.

    -

    17.3.3 Variables

    +

    18.3.3 Variables

    For C wrapping, a def-foreign-variable call is generated for access to global variables.

    When wrapping C++ code, both global and member variables, getter @@ -19906,11 +21526,11 @@ globalvar> (globalvar.nnn::glob_float) 3.0

    -

    17.3.4 Enumerations

    +

    18.3.4 Enumerations

    In C, an enumeration value is an integer value, while in C++ an enumeration value is implicitly convertible to an integer value, but - can also be distinguished by it's enum type. For each enum declaration - a def-foreign-type is generated, assigning the enum a default type of + can also be distinguished by its enum type. For each enum declaration a + def-foreign-type is generated, assigning the enum a default type of :int. Users may adjust the foreign type of enums via SWIG typemaps .

    Enum values are a bit trickier as they can be initialized using any @@ -19920,11 +21540,11 @@ globalvar> (globalvar.nnn::glob_float) being necessary to probe into foreign space to retrieve enum values. When generating a .cxx wrapper file, a more general solution is employed. A wrapper variable is created in the module_wrap.cxx file, - and a ff:def-foreign-variable call is generated to retrieve it's value + and a ff:def-foreign-variable call is generated to retrieve its value into lisp.

    For example, the following header file

    enum.h:
    -enum COL { RED, GREEN, BLUE };	
    +enum COL { RED, GREEN, BLUE };
     enum FOO { FOO1 = 10, FOO2, FOO3 };
           

    @@ -19967,7 +21587,7 @@ EXPORT const int ACL_ENUM___FOO3__SWIG_0 = FOO3;
    -

    17.3.5 Arrays

    +

    18.3.5 Arrays

    One limitation in the Allegro CL foreign-types module, is that, without macrology, expressions may not be used to specify the dimensions of an array declaration. This is not a horrible drawback @@ -20103,9 +21723,9 @@ namespace BAR { (make-instance 'ff:foreign-pointer :foreign-address (swig-ff-call)))

    -

    17.3.6 Classes and Structs and Unions - (oh my!)

    -

    17.3.6.1 CLOS wrapping of

    +

    18.3.6 Classes and Structs and Unions (oh + my!)

    +

    18.3.6.1 CLOS wrapping of

    Classes, unions, and structs are all treated the same way by the interface generator. For any of these objects, a def-foreign-type and a defclass form are generated. For every function that returns an object @@ -20114,14 +21734,14 @@ namespace BAR { returned in an instance of the appropriate class. This makes it much easier to write and debug code than if pointers were passed around as a jumble of integer values.

    -

    17.3.6.2 CLOS Inheritance

    +

    18.3.6.2 CLOS Inheritance

    The CLOS class schema generated by the interface mirrors the inheritance of the classes in foreign code, with the ff:foreign-pointer class at its root. ff:foreign-pointer is a thin wrapper for pointers - that is made available by the foreign function interface. It's key + that is made available by the foreign function interface. Its key benefit is that it may be passed as an argument to any ff:def-foreign-call that is expecting a pointer as the parameter.

    -

    17.3.6.3 Member fields and functions

    +

    18.3.6.3 Member fields and functions

    All public fields will have accessor getter/setter functions generated for them, as appropriate. All public member functions will have wrapper functions generated.

    @@ -20129,8 +21749,8 @@ namespace BAR { private or protected), because the C++ compiler won't allow the wrapper functions to access such fields. Likewise, the interface does nothing for friend directives,

    -

    17.3.6.4 Why not directly access C++ - classes using foreign types?

    +

    18.3.6.4 Why not directly access C++ + classes using foreign types?

    The def-foreign-type generated by the SWIG interface is currently incomplete. We can reliably generate the object layout of simple structs and unions; they can be allocated via ff:allocate-fobject, and @@ -20142,21 +21762,21 @@ private or protected), because the C++ compiler won't result, it is recommended that users of any generated interface not attempt to access C++ instances via the foreign type system, but instead use the more robust wrapper functions.

    -

    17.3.7 Templates

    -

    17.3.7.1 Generating wrapper code for - templates

    +

    18.3.7 Templates

    +

    18.3.7.1 Generating wrapper code for + templates

    SWIG provides support for dealing with templates, but by default, it will not generate any member variable or function wrappers for templated classes. In order to create these wrappers, you need to explicitly tell SWIG to instantiate them. This is done via the %template directive.

    -

    17.3.7.2 Implicit Template - instantiation

    +

    18.3.7.2 Implicit Template instantiation +

    While no wrapper code is generated for accessing member variables, or calling member functions, type code is generated to include these templated classes in the foreign-type and CLOS class schema.

    -

    17.3.8 Typedef, Templates, and Synonym - Types

    +

    18.3.8 Typedef, Templates, and Synonym + Types

    In C/C++ it is possible, via typedef, to have many names refer to the same type. In general, this is not a problem, though it can lead to confusion. Assume the below C++ header file:

    @@ -20216,7 +21836,7 @@ synonym> (zzz foo) synonym>
    -

    17.3.8.1 Choosing a primary type

    +

    18.3.8.1 Choosing a primary type

    The choice of a primary type is selected by the following criteria from a set of synonym types.

      @@ -20226,8 +21846,8 @@ synonym>
    • For all other sets of synonymous types, the synonym which is parsed first becomes the primary type.
    -

    17.3.9 Function overloading/Parameter - defaulting

    +

    18.3.9 Function overloading/Parameter + defaulting

    For each possible argument combination, a distinct wrapper function is created in the .cxx file. On the Lisp side, a generic functions is defined for each possible arity the overloaded/defaulted call may have. @@ -20375,76 +21995,76 @@ overload> (xxx a 2) overload>

    -

    17.3.10 Operator wrapping and Operator - overloading

    +

    18.3.10 Operator wrapping and Operator + overloading

    Wrappers to defined C++ Operators are automatically renamed, using %rename, to the following defaults:

     /* name conversion for overloaded operators. */
     #ifdef __cplusplus
    -%rename(__add__)	     *::operator+;
    -%rename(__pos__)	     *::operator+();
    -%rename(__pos__)	     *::operator+() const;
    +%rename(__add__)             *::operator+;
    +%rename(__pos__)             *::operator+();
    +%rename(__pos__)             *::operator+() const;
     
    -%rename(__sub__)	     *::operator-;
    -%rename(__neg__)	     *::operator-() const;
    -%rename(__neg__)	     *::operator-();
    +%rename(__sub__)             *::operator-;
    +%rename(__neg__)             *::operator-() const;
    +%rename(__neg__)             *::operator-();
     
    -%rename(__mul__)	     *::operator*;
    -%rename(__deref__)	     *::operator*();
    -%rename(__deref__)	     *::operator*() const;
    +%rename(__mul__)             *::operator*;
    +%rename(__deref__)           *::operator*();
    +%rename(__deref__)           *::operator*() const;
     
    -%rename(__div__)	     *::operator/;
    -%rename(__mod__)	     *::operator%;
    -%rename(__logxor__)	     *::operator^;
    -%rename(__logand__)	     *::operator&;
    -%rename(__logior__)	     *::operator|;
    -%rename(__lognot__)	     *::operator~();
    -%rename(__lognot__)	     *::operator~() const;
    +%rename(__div__)             *::operator/;
    +%rename(__mod__)             *::operator%;
    +%rename(__logxor__)          *::operator^;
    +%rename(__logand__)          *::operator&;
    +%rename(__logior__)          *::operator|;
    +%rename(__lognot__)          *::operator~();
    +%rename(__lognot__)          *::operator~() const;
     
    -%rename(__not__)	     *::operator!();
    -%rename(__not__)	     *::operator!() const;
    +%rename(__not__)             *::operator!();
    +%rename(__not__)             *::operator!() const;
     
    -%rename(__assign__)	     *::operator=;
    +%rename(__assign__)          *::operator=;
     
     %rename(__add_assign__)      *::operator+=;
    -%rename(__sub_assign__)	     *::operator-=;
    -%rename(__mul_assign__)	     *::operator*=;
    -%rename(__div_assign__)	     *::operator/=;
    -%rename(__mod_assign__)	     *::operator%=;
    +%rename(__sub_assign__)      *::operator-=;
    +%rename(__mul_assign__)      *::operator*=;
    +%rename(__div_assign__)      *::operator/=;
    +%rename(__mod_assign__)      *::operator%=;
     %rename(__logxor_assign__)   *::operator^=;
     %rename(__logand_assign__)   *::operator&=;
     %rename(__logior_assign__)   *::operator|=;
     
    -%rename(__lshift__)	     *::operator<<;
    +%rename(__lshift__)          *::operator<<;
     %rename(__lshift_assign__)   *::operator<<=;
    -%rename(__rshift__)	     *::operator>>;
    +%rename(__rshift__)          *::operator>>;
     %rename(__rshift_assign__)   *::operator>>=;
     
    -%rename(__eq__)		     *::operator==;
    -%rename(__ne__)		     *::operator!=;
    -%rename(__lt__)		     *::operator<;
    -%rename(__gt__)		     *::operator>;
    -%rename(__lte__)	     *::operator<=;
    -%rename(__gte__)	     *::operator>=;
    +%rename(__eq__)              *::operator==;
    +%rename(__ne__)              *::operator!=;
    +%rename(__lt__)              *::operator<;
    +%rename(__gt__)              *::operator>;
    +%rename(__lte__)             *::operator<=;
    +%rename(__gte__)             *::operator>=;
     
    -%rename(__and__)	     *::operator&&;
    -%rename(__or__)		     *::operator||;
    +%rename(__and__)             *::operator&&;
    +%rename(__or__)              *::operator||;
     
    -%rename(__preincr__)	     *::operator++();
    -%rename(__postincr__)	     *::operator++(int);
    -%rename(__predecr__)	     *::operator--();
    -%rename(__postdecr__)	     *::operator--(int);
    +%rename(__preincr__)         *::operator++();
    +%rename(__postincr__)        *::operator++(int);
    +%rename(__predecr__)         *::operator--();
    +%rename(__postdecr__)        *::operator--(int);
     
    -%rename(__comma__)	     *::operator,();
    -%rename(__comma__)	     *::operator,() const;
    +%rename(__comma__)           *::operator,();
    +%rename(__comma__)           *::operator,() const;
     
     %rename(__member_ref__)      *::operator->;
     %rename(__member_func_ref__) *::operator->*;
     
    -%rename(__funcall__)	     *::operator();
    -%rename(__aref__)	     *::operator[];
    +%rename(__funcall__)         *::operator();
    +%rename(__aref__)            *::operator[];
         

    Name mangling occurs on all such renamed identifiers, so that @@ -20504,39 +22124,39 @@ nil opoverload>

    -

    17.3.11 Varargs

    +

    18.3.11 Varargs

    Variable length argument lists are not supported, by default. If such a function is encountered, a warning will generated to stderr. Varargs are supported via the SWIG %varargs directive. This directive allows you to specify a (finite) argument list which will be inserted into the wrapper in place of the variable length argument - indicator. As an example, consider the function printf(). It's + indicator. As an example, consider the function printf(). Its declaration would appear as follows:

    See the following section on Variable Length arguments provides examples on how %varargs can be used, along with other ways such functions can be wrapped.

    -

    17.3.12 C++ Exceptions

    +

    18.3.12 C++ Exceptions

    Each C++ wrapper includes a handler to catch any exceptions that may be thrown while in foreign code. This helps prevent simple C++ errors from killing the entire lisp process. There is currently no mechanism to have these exceptions forwarded to the lisp condition system, nor has any explicit support of the exception related SWIG typemaps been implemented.

    -

    17.3.13 Pass by value, pass by - reference

    +

    18.3.13 Pass by value, pass by reference +

    Allegro CL does not support the passing of non-primitive foreign structures by value. As a result, SWIG must automatically detect and convert function parameters and return values to pointers whenever necessary. This is done via the use of typemaps, and should not require any fine tuning by the user, even for newly defined types.

    -

    17.4 Typemaps

    +

    18.4 Typemaps

    SWIG Typemaps provide a powerful tool for automatically generating code to handle various menial tasks required of writing an interface to foreign code. The purpose of this section is to describe each of the typemaps used by the Allegro CL module. Please read the chapter on Typemaps for more information.

    -

    17.4.1 Code Generation in the C++ - Wrapper

    +

    18.4.1 Code Generation in the C++ Wrapper +

    Every C++ wrapper generated by SWIG takes the following form:

    @@ -20559,7 +22179,7 @@ return-val wrapper-name(parm0, parm1, ..., parmN)
        }
         
    -

    17.4.1.1 IN Typemap

    +

    18.4.1.1 IN Typemap

    the in typemap is used to generate code to convert parameters passed to C++ wrapper functions into the arguments desired for the call being wrapped. That is, it fills in the code for the @@ -20586,11 +22206,11 @@ $1 is the local variable to which it is being assigned. The default %typemap(in) SWIGTYPE "$1 = *$input;";

    -

    17.4.1.2 OUT Typemap

    +

    18.4.1.2 OUT Typemap

    The out typemap is used to generate code to form the return value of the wrapper from the return value of the wrapped function. This code is placed in the <convert and bind result to lresult> section - of the above code diagram. It's default mapping is as follows:

    + of the above code diagram. Its default mapping is as follows:

     %typemap(out) bool                          "$result = (int)$1;";
    @@ -20604,11 +22224,11 @@ $1 is the local variable to which it is being assigned. The default
     %typemap(out) SWIGTYPE                     "$result = new $1_type($1);";
         
    -

    17.4.1.3 CTYPE Typemap

    +

    18.4.1.3 CTYPE Typemap

    This typemap is not used for code generation, but purely for the transformation of types in the parameter list of the wrapper function. - It's primary use is to handle by-value to by-reference conversion in - the wrappers parameter list. Its default settings are:

    + Its primary use is to handle by-value to by-reference conversion in the + wrappers parameter list. Its default settings are:

     %typemap(ctype) bool                       "int";
    @@ -20626,7 +22246,7 @@ $1 is the local variable to which it is being assigned. The default
      interface generator. SWIG also implements a number of other typemaps
      that can be used for generating code in the C/C++ wrappers. You can
      read about these common typemaps here.

    -

    17.4.2 Code generation in Lisp wrappers

    +

    18.4.2 Code generation in Lisp wrappers

    A number of custom typemaps have also been added to facilitate the generation of code in the lisp side of the interface. These are described below. The basic code generation structure is applied as a @@ -20637,7 +22257,7 @@ $1 is the local variable to which it is being assigned. The default necessary. Users writing their own typemaps should do likewise. See the explanation in the last paragraph of 16.3.1 Namespaces for details.

    -

    17.4.2.1 LIN Typemap

    +

    18.4.2.1 LIN Typemap

    The LIN typemap allows for the manipulating the lisp objects passed as arguments to the wrapping defun before passing them to the foreign function call. For example, when passing lisp strings to foreign code, @@ -20664,10 +22284,10 @@ $1 is the local variable to which it is being assigned. The default

    -%typemap(lin)	SWIGTYPE 	"(cl:let (($out $in))\n  $body)";
    +%typemap(lin) SWIGTYPE "(cl:let (($out $in))\n  $body)";
         
    -

    17.4.2.2 LOUT Typemap

    +

    18.4.2.2 LOUT Typemap

    The LOUT typemap is the means by which we effect the wrapping of foreign pointers in CLOS instances. It is applied after all LIN typemaps, and immediately before the actual foreign-call.

    @@ -20699,7 +22319,7 @@ $1 is the local variable to which it is being assigned. The default ACL_result)";
    -

    17.4.2.3 FFITYPE Typemap

    +

    18.4.2.3 FFITYPE Typemap

    The FFITYPE typemap works as a helper for a body of code that converts C/C++ type specifications into Allegro CL foreign-type specifications. These foreign-type specifications appear in @@ -20737,7 +22357,7 @@ $1 is the local variable to which it is being assigned. The default %typemap(ffitype) SWIGTYPE & "(* :void)";

    -

    17.4.2.4 LISPTYPE Typemap

    +

    18.4.2.4 LISPTYPE Typemap

    This is another type only transformation map, and is used to provide the lisp-type, which is the optional third argument in argument specifier in a ff:def-foreign-call form. Specifying a lisp-type allows @@ -20751,7 +22371,7 @@ $1 is the local variable to which it is being assigned. The default %typemap(lisptype) signed char "cl:integer";

    -

    17.4.2.5 LISPCLASS Typemap

    +

    18.4.2.5 LISPCLASS Typemap

    The LISPCLASS typemap is used to generate the method signatures for the generic-functions which wrap overloaded functions and functions with defaulted arguments. The default entries are:

    @@ -20769,8 +22389,8 @@ $1 is the local variable to which it is being assigned. The default %typemap(lispclass) char * "cl:string";
    -

    17.4.3 Modifying SWIG behavior using - typemaps

    +

    18.4.3 Modifying SWIG behavior using + typemaps

    The following example shows how we made use of the above typemaps to add support for the wchar_t type.

    @@ -20798,9 +22418,9 @@ $1 is the local variable to which it is being assigned. The default %typemap(lispclass) wchar_t* "cl:string";
    -

    17.5 Identifier Converter functions

    -

    17.5.1 Creating symbols in the lisp - environment

    +

    18.5 Identifier Converter functions

    +

    18.5.1 Creating symbols in the lisp + environment

    Various symbols must be generated in the lisp environment to which class definitions, functions, constants, variables, etc. must be bound. Rather than force a particular convention for naming these symbols, an @@ -20813,23 +22433,23 @@ $1 is the local variable to which it is being assigned. The default reference. It is therefore expected that the identifier-converter function reliably return the same (eq) symbol given the same set of arguments.

    -

    17.5.2 Existing identifier-converter - functions

    +

    18.5.2 Existing identifier-converter + functions

    Two basic identifier routines have been defined.

    -

    17.5.2.1 identifier-convert-null

    +

    18.5.2.1 identifier-convert-null

    No modification of the identifier string is performed. Based on other arguments, the identifier may be concatenated with other strings, from which a symbol will be created.

    -

    17.5.2.2 identifier-convert-lispify

    +

    18.5.2.2 identifier-convert-lispify

    All underscores in the identifier string are converted to hyphens. Otherwise, identifier-convert-lispify performs the same symbol transformations.

    -

    17.5.2.3 Default identifier to symbol - conversions

    +

    18.5.2.3 Default identifier to symbol + conversions

    Check the definitions of the above two default identifier-converters in Lib/allegrocl/allegrocl.swg for default naming conventions.

    -

    17.5.3 Defining your own - identifier-converter

    +

    18.5.3 Defining your own + identifier-converter

    A user-defined identifier-converter function should conform to the following specification:

    @@ -20841,10 +22461,10 @@ result ==> symbol or (setf symbol)

    The ID argument is a string representing an identifier in the foreign environment.

    The :type keyword argument provides more information on the type of - identifier. It's value is a symbol. This allows the - identifier-converter to apply different heuristics when mapping - different types of identifiers to symbols. SWIG will generate calls to - your identifier-converter using the following types.

    + identifier. Its value is a symbol. This allows the identifier-converter + to apply different heuristics when mapping different types of + identifiers to symbols. SWIG will generate calls to your + identifier-converter using the following types.

    • :class - names a CLOS class.
    • :constant - names a defconstant
    • @@ -20865,11 +22485,11 @@ result ==> symbol or (setf symbol) non-nil, it indicates that the current identifier has scope in the specified class.

      The :arity keyword argument only appears in swig:swig-defmethod - forms generated for overloaded functions. It's value is an integer + forms generated for overloaded functions. Its value is an integer indicating the number of arguments passed to the routine indicated by this identifier.

      -

      17.5.4 Instructing SWIG to use a - particular identifier-converter

      +

      18.5.4 Instructing SWIG to use a particular + identifier-converter

      By default, SWIG will use identifier-converter-null. To specify another convert function, use the -identifier-converter command-line argument. The value should be a string naming the function @@ -20879,7 +22499,7 @@ result ==> symbol or (setf symbol) % swig -allegrocl -c++ -module mymodule -identifier-converter my-identifier-converter


    -

    18 SWIG and Android

    +

    19 SWIG and Android

    @@ -20898,16 +22518,16 @@ result ==> symbol or (setf symbol)

    This chapter describes SWIG's support of Android.

    -

    18.1 Overview

    +

    19.1 Overview

    The Android chapter is fairly short as support for Android is the same as for Java, where the Java Native Interface (JNI) is used to call - from Android Java into C or C++ compiled code. Everything in the + from Android Java into C or C++ compiled code. Everything in the Java chapter applies to generating code for access from Android Java code. This chapter contains a few Android specific notes and examples.

    -

    18.2 Android examples

    -

    18.2.1 Examples introduction

    +

    19.2 Android examples

    +

    19.2.1 Examples introduction

    The examples require the -Android SDK and +Android SDK and Android NDK which can be installed as per instructions in the links. The Eclipse version is not required for these examples as just the command line tools are used (shown for Linux as the host, but Windows @@ -20919,7 +22539,7 @@ Android NDK which can be installed as per instructions in the links.

     $ export PATH=$HOME/android/android-sdk-linux_x86/tools:$HOME/android/android-sdk-linux_x86/platform-tools:$HOME/android/android-ndk-r6b:$PATH
     $ mkdir AndroidApps 
    -$ cd AnrdoidApps
    +$ cd AndroidApps
     

    The examples use a target id of 1. This might need changing @@ -20934,7 +22554,7 @@ $ android list targets

    The following examples are shipped with SWIG under the Examples/android directory and include a Makefile to build and install each example.

    -

    18.2.2 Simple C example

    +

    19.2.2 Simple C example

    This simple C example shows how to call a C function as well as read and modify a global variable. First we'll create and build a pure Java Android app. Afterwards the JNI code will be generated by SWIG and @@ -21055,7 +22675,7 @@ Using hardware devices on the Android developer's site. When

     $ adb devices
     List of devices attached 
    -A32-6DBE0001-9FF80000-015D62C3-02018028	device
    +A32-6DBE0001-9FF80000-015D62C3-02018028 device
     

    This means you are now ready to install the application...

    @@ -21063,7 +22683,7 @@ A32-6DBE0001-9FF80000-015D62C3-02018028 device
     $ adb install bin/SwigSimple-debug.apk 
     95 KB/s (4834 bytes in 0.049s)
    -	pkg: /data/local/tmp/SwigSimple-debug.apk
    +        pkg: /data/local/tmp/SwigSimple-debug.apk
     Success
     
    @@ -21210,7 +22830,7 @@ $ adb install bin/SwigSimple-debug.apk below, showing the result of calls into the C code:

    Android screenshot of SwigSimple example
    -

    18.2.3 C++ class example

    +

    19.2.3 C++ class example

    The steps for calling C++ code are almost identical to those in the previous C code example. All the steps required to compile and use a simple hierarchy of classes for shapes are shown in this example.

    @@ -21238,11 +22858,11 @@ public: } virtual ~Shape() { nshapes--; - }; + } double x, y; void move(double dx, double dy); - virtual double area(void) = 0; - virtual double perimeter(void) = 0; + virtual double area() = 0; + virtual double perimeter() = 0; static int nshapes; }; @@ -21250,18 +22870,18 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; - virtual double area(void); - virtual double perimeter(void); + Circle(double r) : radius(r) { } + virtual double area(); + virtual double perimeter(); }; class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; - virtual double area(void); - virtual double perimeter(void); + Square(double w) : width(w) { } + virtual double area(); + virtual double perimeter(); };
    @@ -21281,19 +22901,19 @@ void Shape::move(double dx, double dy) { int Shape::nshapes = 0; -double Circle::area(void) { +double Circle::area() { return M_PI*radius*radius; } -double Circle::perimeter(void) { +double Circle::perimeter() { return 2*M_PI*radius; } -double Square::area(void) { +double Square::area() { return width*width; } -double Square::perimeter(void) { +double Square::perimeter() { return 4*width; } @@ -21518,14 +23138,14 @@ $ adb install bin/SwigClass-debug.apk

    Run the app to see the result of calling the C++ code from Java:

    Android screenshot of SwigClass example
    -

    18.2.4 Other examples

    +

    19.2.4 Other examples

    The Examples/android directory contains further examples which can be run and installed in a similar manner to the previous two examples.

    Note that the 'extend' example is demonstrates the directors feature. Normally C++ exception handling and the STL is not available by default in the version of g++ shipped with Android, but this example turns these features on as described in the next section.

    -

    18.3 C++ STL

    +

    19.3 C++ STL

    Should the C++ Standard Template Library (STL) be required, an Application.mk file needs to be created in the same directory as the Android.mk directory containing information about the STL @@ -21539,12 +23159,18 @@ Application.mk file to make the STLport static library available APP_STL := gnustl_static


    -

    19 SWIG and C#

    +

    20 SWIG and C#

    -

    19.1 Introduction

    +

    20.1 Introduction

    The purpose of the C# module is to offer an automated way of accessing existing C/C++ code from .NET languages. The wrapper code implementation uses C# and the Platform Invoke (PInvoke) interface to @@ -21616,10 +23242,55 @@ Portable.NET.

    required. The Microsoft Developer Network (MSDN) has a good reference guide in a section titled "Interop Marshaling". Monodoc, available from the Mono project, has a - very useful section titled + very useful section titled Interop with native libraries.

    -

    19.2 Differences to the Java - module

    +

    20.1.1 SWIG 2 + Compatibility

    +

    In order to minimize name collisions between names generated based + on input to SWIG and names used in the generated code from the .NET + framework, SWIG 3 fully qualifies the use of all .NET types. + Furthermore, SWIG 3 avoids using directives in generated code. + This breaks backwards compatibility with typemaps, pragmas, etc written + for use with SWIG 2 that assume the presence of using System; + or using System.Runtime.InteropServices; directives in the + intermediate class imports, module imports, or proxy imports. SWIG 3 + supports backwards compatibility though the use of the SWIG2_CSHARP + macro. If SWIG2_CSHARP is defined, SWIG 3 generates using + directives in the intermediate class, module class, and proxy class + code similar to those generated by SWIG 2. This can be done without + modifying any of the input code by passing the -DSWIG2_CSHARP + commandline parameter when executing swig.

    +

    20.1.2 Additional command line options +

    +

    The following table lists the additional commandline options + available for the C# module. They can also be seen by using:

    +
    +
    +swig -csharp -help 
    +
    +
    + + + + + + + + +
    C# specific options
    -dllimport <dl>Override DllImport attribute name to + <dl>
    -namespace <nm>Generate wrappers into C# namespace <nm>
    -noproxyGenerate the low-level functional interface + instead of proxy classes
    -oldvarnamesOld intermediary method names for variable + wrappers
    -outfile <file>Write all C# into a single <file> + located in the output directory
    +

    The -outfile option combines all the generated C# code into a single + output file instead of creating multiple C# files. The default, when + this option is not provided, is to generate separate .cs files for the + module class, intermediary class and each of the generated proxy and + type wrapper classes. Note that the file extension (.cs) will not be + automatically added and needs to be provided. Due to possible compiler + limits it is not advisable to use -outfile for large projects.

    +

    20.2 Differences to the Java + module

    The C# module is very similar to the Java module, so until some more complete documentation has been written, please use the Java documentation as a guide to using SWIG with C#. The C# module @@ -21696,6 +23367,7 @@ javabody -> csbody javafinalize -> csfinalize javadestruct -> csdestruct javadestruct_derived -> csdestruct_derived +javainterfacecode -> csinterfacecode

  • @@ -21758,6 +23430,9 @@ $*javaclassname -> $*csclassname $javaclazzname -> $csclazzname $javainput -> $csinput $jnicall -> $imcall +$javainterfacename -> $csinterfacename +$&javainterfacename -> $&csinterfacename +$*javainterfacename -> $*csinterfacename
  • @@ -21791,7 +23466,7 @@ Date marshalling director example for further understanding of the char * could be marshalled in different ways,

    -%typemap(imtype, out="IntPtr") char * "string"
    +%typemap(imtype, out="global::System.IntPtr") char * "string"
     char * function(char *);
     
    @@ -21799,7 +23474,7 @@ char * function(char *); resulting intermediary C# code is:

    -public static extern IntPtr function(string jarg1);
    +public static extern global::System.IntPtr function(string jarg1);
     
  • @@ -21818,8 +23493,8 @@ directors implementation. Note that there are C# attributes and
     %typemap(imtype,
    -         inattributes="[MarshalAs(UnmanagedType.LPStr)]",
    -         outattributes="[return: MarshalAs(UnmanagedType.LPStr)]") const char * "String"
    +         inattributes="[global::System.Runtime.InteropServices.MarshalAs(UnmanagedType.LPStr)]",
    +         outattributes="[return: global::System.Runtime.InteropServices.MarshalAs(UnmanagedType.LPStr)]") const char * "String"
     
     const char * GetMsg() {}
     void SetMsg(const char *msg) {}
    @@ -21831,12 +23506,12 @@ void SetMsg(const char *msg) {}
     
     class examplePINVOKE {
       ...
    -  [DllImport("example", EntryPoint="CSharp_GetMsg")]
    -  [return: MarshalAs(UnmanagedType.LPStr)]
    +  [global::System.Runtime.InteropServices.DllImport("example", EntryPoint="CSharp_GetMsg")]
    +  [return: global::System.Runtime.InteropServices.MarshalAs(UnmanagedType.LPStr)]
       public static extern String GetMsg();
     
    -  [DllImport("example", EntryPoint="CSharp_SetMsg")]
    -  public static extern void SetMsg([MarshalAs(UnmanagedType.LPStr)]String jarg1);
    +  [global::System.Runtime.InteropServices.DllImport("example", EntryPoint="CSharp_SetMsg")]
    +  public static extern void SetMsg([global::System.Runtime.InteropServices.MarshalAs(UnmanagedType.LPStr)]String jarg1);
     }
     
    @@ -21878,7 +23553,7 @@ public:
     [ThreadSafe]
    -public class AClass : IDisposable {
    +public class AClass : global::System.IDisposable {
       ...
       [ThreadSafe(false)]
       public AClass(double a) ...
    @@ -21898,9 +23573,9 @@ public class AClass : IDisposable {
      shown below.

    -%typemap(csattributes) Couleur "[System.ComponentModel.Description(\"Colours\")]"
    -%csattributes Rouge "[System.ComponentModel.Description(\"Red\")]"
    -%csattributes Vert "[System.ComponentModel.Description(\"Green\")]"
    +%typemap(csattributes) Couleur "[global::System.ComponentModel.Description(\"Colours\")]"
    +%csattributes Rouge "[global::System.ComponentModel.Description(\"Red\")]"
    +%csattributes Vert "[global::System.ComponentModel.Description(\"Green\")]"
     %inline %{
       enum Couleur { Rouge, Orange, Vert };
     %}
    @@ -21909,12 +23584,12 @@ public class AClass : IDisposable {
     

    which will result in the following C# enum:

    -[System.ComponentModel.Description("Colours")]
    +[global::System.ComponentModel.Description("Colours")]
     public enum Couleur {
    -  [System.ComponentModel.Description("Red")]
    +  [global::System.ComponentModel.Description("Red")]
       Rouge,
       Orange,
    -  [System.ComponentModel.Description("Green")]
    +  [global::System.ComponentModel.Description("Green")]
       Vert
     }
     
    @@ -21975,7 +23650,7 @@ Cygwin or MinGW environment for automatic configuration of the example makefiles. Any one of the three C# compilers (Portable.NET, Mono or Microsoft) can be detected from within a Cygwin or Mingw environment if installed in your path.

    -

    19.3 Void pointers

    +

    20.3 Void pointers

    By default SWIG treats void * as any other pointer and hence marshalls it as a type wrapper class called SWIGTYPE_p_void . If you want to marshall with the .NET System.IntPtr type @@ -21988,7 +23663,7 @@ Cygwin or MinGW environment for void * f(void *v);

    -

    19.4 C# Arrays

    +

    20.4 C# Arrays

    There are various ways to pass arrays from C# to C/C++. The default wrapping treats arrays as pointers and as such simple type wrapper classes are generated, eg SWIGTYPE_p_int when wrapping the C @@ -21997,8 +23672,8 @@ void * f(void *v); arrays is to enhance or customise with one of the following three approaches; namely the SWIG C arrays library, P/Invoke default array marshalling or pinned arrays.

    -

    19.4.1 The SWIG C arrays - library

    +

    20.4.1 The SWIG C arrays + library

    The C arrays library keeps all the array memory in the unmanaged layer. The library is available to all language modules and is documented in the carrays.i library @@ -22025,8 +23700,8 @@ for (int i=0; i<10; i++) example.print_array(c.cast()); // Pass to C

    -

    19.4.2 - Managed arrays using P/Invoke default array marshalling

    +

    20.4.2 + Managed arrays using P/Invoke default array marshalling

    In the P/Invoke default marshalling scheme, one needs to designate whether the invoked function will treat a managed array parameter as input, output, or both. When the function is invoked, the CLR allocates @@ -22075,9 +23750,9 @@ public static void myArrayCopy(int[] sourceArray, int[] targetArray, int nitems) use default marshalling for the arrays:

    -[DllImport("example", EntryPoint="CSharp_myArrayCopy")]
    -public static extern void myArrayCopy([In, MarshalAs(UnmanagedType.LPArray)]int[] jarg1, 
    -                                      [Out, MarshalAs(UnmanagedType.LPArray)]int[] jarg2,
    +[global::System.Runtime.InteropServices.DllImport("example", EntryPoint="CSharp_myArrayCopy")]
    +public static extern void myArrayCopy([global::System.Runtime.InteropServices.In, global::System.Runtime.InteropServices.MarshalAs(UnmanagedType.LPArray)]int[] jarg1, 
    +                                      [global::System.Runtime.InteropServices.Out, global::System.Runtime.InteropServices.MarshalAs(UnmanagedType.LPArray)]int[] jarg2,
                                            int jarg3);
     
    @@ -22109,14 +23784,14 @@ void myArraySwap(int *array1, int *array2, int nitems);

    and intermediary class method

    -  [DllImport("example", EntryPoint="CSharp_myArraySwap")]
    -  public static extern void myArraySwap([In, Out, MarshalAs(UnmanagedType.LPArray)]int[] jarg1, 
    -                                        [In, Out, MarshalAs(UnmanagedType.LPArray)]int[] jarg2,
    +  [global::System.Runtime.InteropServices.DllImport("example", EntryPoint="CSharp_myArraySwap")]
    +  public static extern void myArraySwap([global::System.Runtime.InteropServices.In, global::System.Runtime.InteropServices.Out, global::System.Runtime.InteropServices.MarshalAs(UnmanagedType.LPArray)]int[] jarg1, 
    +                                        [global::System.Runtime.InteropServices.In, global::System.Runtime.InteropServices.Out, global::System.Runtime.InteropServices.MarshalAs(UnmanagedType.LPArray)]int[] jarg2,
                                              int jarg3);
     
    -

    19.4.3 Managed arrays using - pinning

    +

    20.4.3 Managed arrays using pinning +

    It is also possible to pin a given array in memory (i.e. fix its location in memory), obtain a direct pointer to it, and then pass this pointer to the wrapped C/C++ function. This approach involves no @@ -22162,7 +23837,7 @@ void myArrayCopy(int *sourceArray, int *targetArray, int nitems); fixed ( int *swig_ptrTo_sourceArray = sourceArray ) { fixed ( int *swig_ptrTo_targetArray = targetArray ) { { - examplePINVOKE.myArrayCopy((IntPtr)swig_ptrTo_sourceArray, (IntPtr)swig_ptrTo_targetArray, + examplePINVOKE.myArrayCopy((global::System.IntPtr)swig_ptrTo_sourceArray, (global::System.IntPtr)swig_ptrTo_targetArray, nitems); } } @@ -22178,11 +23853,11 @@ void myArrayCopy(int *sourceArray, int *targetArray, int nitems); parameter type.

    -[DllImport("example", EntryPoint="CSharp_myArrayCopy")]
    -public static extern void myArrayCopy(IntPtr jarg1, IntPtr jarg2, int jarg3);
    +[global::System.Runtime.InteropServices.DllImport("example", EntryPoint="CSharp_myArrayCopy")]
    +public static extern void myArrayCopy(global::System.IntPtr jarg1, global::System.IntPtr jarg2, int jarg3);
     
    -

    19.5 C# Exceptions

    +

    20.5 C# Exceptions

    It is possible to throw a C# Exception from C/C++ code. SWIG already provides the framework for throwing C# exceptions if it is able to detect that a C++ exception could be thrown. Automatically detecting @@ -22272,9 +23947,9 @@ msg and param_name parameters contain the C# exception attribute set. The %csnothrowexception feature is like %exception, but it does not have the canthrow attribute set so should only be used when a C# exception is not created.

    -

    19.5.1 C# - exception example using "check" typemap

    -

    Lets say we have the following simple C++ method:

    +

    20.5.1 C# exception + example using "check" typemap

    +

    Let's say we have the following simple C++ method:

     void positivesonly(int number);
    @@ -22420,8 +24095,8 @@ method and C# code does not handle pending exceptions via the canthrow attribute
     

    Actually it will issue this warning for any function beginning with SWIG_CSharpSetPendingException.

    -

    19.5.2 C# - exception example using %exception

    +

    20.5.2 C# + exception example using %exception

    Let's consider a similar, but more common example that throws a C++ exception from within a wrapped function. We can use %exception as mentioned in Exception handling @@ -22433,6 +24108,7 @@ try { $action } catch (std::out_of_range e) { SWIG_CSharpSetPendingException(SWIG_CSharpApplicationException, e.what()); + return $null; } %} @@ -22477,8 +24153,8 @@ canthrow attribute set by default:

    }
  • -

    -19.5.3 C# exception example using exception specifications

    +

    20.5.3 + C# exception example using exception specifications

    When C++ exception specifications are used, SWIG is able to detect that the method might throw an exception. By default SWIG will automatically generate code to catch the exception and convert it into @@ -22526,8 +24202,8 @@ SWIGEXPORT void SWIGSTDCALL CSharp_evensonly(int jarg1) {

    Multiple catch handlers are generated should there be more than one exception specifications declared.

    -

    19.5.4 Custom C# - ApplicationException example

    +

    20.5.4 Custom C# + ApplicationException example

    This example involves a user defined exception. The conventional .NET exception handling approach is to create a custom ApplicationException and throw it in your application. The goal in @@ -22570,7 +24246,7 @@ imclasscode pragma as follows:

    static CustomExceptionDelegate customDelegate = new CustomExceptionDelegate(SetPendingCustomException); - [DllImport("$dllimport", EntryPoint="CustomExceptionRegisterCallback")] + [global::System.Runtime.InteropServices.DllImport("$dllimport", EntryPoint="CustomExceptionRegisterCallback")] public static extern void CustomExceptionRegisterCallback(CustomExceptionDelegate customCallback); @@ -22618,7 +24294,7 @@ SWIG_CSharpSetPendingExceptionArgument() does. In fact the method
     // Custom C# Exception
    -class CustomApplicationException : System.ApplicationException {
    +class CustomApplicationException : global::System.ApplicationException {
       public CustomApplicationException(string message) 
         : base(message) {
       }
    @@ -22653,7 +24329,7 @@ try {
     }
     
    -

    19.6 C# Directors

    +

    20.6 C# Directors

    The SWIG directors feature adds extra code to the generated C# proxy classes that enable these classes to be used in cross-language polymorphism. Essentially, it enables unmanaged C++ code to call back @@ -22664,7 +24340,7 @@ try { C# directors. However, the Java directors section should also be read in order to gain more insight into directors.

    -

    19.6.1 Directors example

    +

    20.6.1 Directors example

    Imagine we are wrapping a C++ base class, Base, from which we would like to inherit in C#. Such a class is shown below as well as another class, Caller, which calls the virtual method @@ -22765,8 +24441,8 @@ Base - UIntMethod(123) CSharpDerived - UIntMethod(123)

    -

    19.6.2 Directors - implementation

    +

    20.6.2 Directors + implementation

    The previous section demonstrated a simple example where the virtual UIntMethod method was called from C++ code, even when the overridden method is implemented in C#. The intention of this section @@ -22777,20 +24453,17 @@ Base class.

    Below is the generated C# Base director class.

    -using System;
    -using System.Runtime.InteropServices;
    -
    -public class Base : IDisposable {
    -  private HandleRef swigCPtr;
    +public class Base : global::System.IDisposable {
    +  private global::System.Runtime.InteropServices.HandleRef swigCPtr;
       protected bool swigCMemOwn;
     
    -  internal Base(IntPtr cPtr, bool cMemoryOwn) {
    +  internal Base(global::System.IntPtr cPtr, bool cMemoryOwn) {
         swigCMemOwn = cMemoryOwn;
    -    swigCPtr = new HandleRef(this, cPtr);
    +    swigCPtr = new global::System.Runtime.InteropServices.HandleRef(this, cPtr);
       }
     
    -  internal static HandleRef getCPtr(Base obj) {
    -    return (obj == null) ? new HandleRef(null, IntPtr.Zero) : obj.swigCPtr;
    +  internal static global::System.Runtime.InteropServices.HandleRef getCPtr(Base obj) {
    +    return (obj == null) ? new global::System.Runtime.InteropServices.HandleRef(null, global::System.IntPtr.Zero) : obj.swigCPtr;
       }
     
       ~Base() {
    @@ -22799,12 +24472,12 @@ public class Base : IDisposable {
     
       public virtual void Dispose() {
         lock(this) {
    -      if(swigCPtr.Handle != IntPtr.Zero && swigCMemOwn) {
    +      if(swigCPtr.Handle != global::System.IntPtr.Zero && swigCMemOwn) {
             swigCMemOwn = false;
             examplePINVOKE.delete_Base(swigCPtr);
           }
    -      swigCPtr = new HandleRef(null, IntPtr.Zero);
    -      GC.SuppressFinalize(this);
    +      swigCPtr = new global::System.Runtime.InteropServices.HandleRef(null, global::System.IntPtr.Zero);
    +      global::System.GC.SuppressFinalize(this);
         }
       }
     
    @@ -22831,7 +24504,7 @@ public class Base : IDisposable {
         examplePINVOKE.Base_director_connect(swigCPtr, swigDelegate0, swigDelegate1);
       }
     
    -  private bool SwigDerivedClassHasMethod(string methodName, Type[] methodTypes) {
    +  private bool SwigDerivedClassHasMethod(string methodName, global::System.global::System.Type[] methodTypes) {
         System.Reflection.MethodInfo methodInfo = this.GetType().GetMethod(methodName, methodTypes);
         bool hasDerivedMethod = methodInfo.DeclaringType.IsSubclassOf(typeof(Base));
         return hasDerivedMethod;
    @@ -22841,18 +24514,18 @@ public class Base : IDisposable {
         return UIntMethod(x);
       }
     
    -  private void SwigDirectorBaseBoolMethod(IntPtr b, bool flag) {
    +  private void SwigDirectorBaseBoolMethod(global::System.IntPtr b, bool flag) {
         BaseBoolMethod(new Base(b, false), flag);
       }
     
       internal delegate uint SwigDelegateBase_0(uint x);
    -  internal delegate void SwigDelegateBase_1(IntPtr b, bool flag);
    +  internal delegate void SwigDelegateBase_1(global::System.IntPtr b, bool flag);
     
       private SwigDelegateBase_0 swigDelegate0;
       private SwigDelegateBase_1 swigDelegate1;
     
    -  private static Type[] swigMethodTypes0 = new Type[] { typeof(uint) };
    -  private static Type[] swigMethodTypes1 = new Type[] { typeof(Base), typeof(bool) };
    +  private static global::System.Type[] swigMethodTypes0 = new global::System.Type[] { typeof(uint) };
    +  private static global::System.Type[] swigMethodTypes1 = new global::System.Type[] { typeof(Base), typeof(bool) };
     }
     
    @@ -22945,7 +24618,7 @@ void SwigDirector_Base::BaseBoolMethod(Base const &b, bool flag) { }
    -

    19.6.3 Director caveats

    +

    20.6.3 Director caveats

    There is a subtle gotcha with directors. If default parameters are used, it is recommended to follow a pattern of always calling a single method in any C# derived class. An example will clarify this and the @@ -22990,22 +24663,22 @@ CSharpDefaults.DefaultMethod() will of course call this exact the implementation should pass the call on to CSharpDefaults.DefaultMethod(int)using the C++ default value, as shown above.

    -

    19.7 Multiples modules

    -

    When using multiple modules it is is - possible to compile each SWIG generated wrapper into a different - assembly. However, by default the generated code may not compile if - generated classes in one assembly use generated classes in another - assembly. The visibility of the getCPtr() and pointer - constructor generated from the csbody typemaps needs changing. - The default visibility is internal but it needs to be -public for access from a different assembly. Just changing - 'internal' to 'public' in the typemap achieves this. Two macros are - available in csharp.swg to make this easier and using them is - the preferred approach over simply copying the typemaps and modifying - as this is forward compatible with any changes in the csbody - typemap in future versions of SWIG. The macros are for the proxy and - typewrapper classes and can respectively be used to to make the method - and constructor public:

    +

    20.7 Multiple modules

    +

    When using multiple modules it is is possible + to compile each SWIG generated wrapper into a different assembly. + However, by default the generated code may not compile if generated + classes in one assembly use generated classes in another assembly. The + visibility of the getCPtr() and pointer constructor generated + from the csbody typemaps needs changing. The default + visibility is internal but it needs to be public for + access from a different assembly. Just changing 'internal' to 'public' + in the typemap achieves this. Two macros are available in +csharp.swg to make this easier and using them is the preferred + approach over simply copying the typemaps and modifying as this is + forward compatible with any changes in the csbody typemap in + future versions of SWIG. The macros are for the proxy and typewrapper + classes and can respectively be used to to make the method and + constructor public:

       SWIG_CSBODY_PROXY(public, public, SWIGTYPE)
    @@ -23020,12 +24693,12 @@ public for access from a different assembly. Just changing
     [System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)]
      attribute if you don't want users to easily stumble upon these so
      called 'internal workings' of the wrappers.

    -

    19.8 C# Typemap examples

    +

    20.8 C# Typemap examples

    This section includes a few examples of typemaps. For more examples, you might look at the files "csharp.swg" and "typemaps.i " in the SWIG library. -

    19.8.1 - Memory management when returning references to member variables

    +

    20.8.1 Memory + management when returning references to member variables

    This example shows how to prevent premature garbage collection of objects when the underlying C++ class returns a pointer or reference to a member variable. The example is a direct equivalent to this @@ -23052,9 +24725,9 @@ public: Wheel wheel = new Bike(10).getWheel(); Console.WriteLine("wheel size: " + wheel.size); // Simulate a garbage collection - System.GC.Collect(); - System.GC.WaitForPendingFinalizers(); - Console.WriteLine("wheel size: " + wheel.size); + global::System.GC.Collect(); + global::System.GC.WaitForPendingFinalizers(); + global::System.Console.WriteLine("wheel size: " + wheel.size);

    Don't be surprised that if the resulting output gives strange @@ -23087,9 +24760,9 @@ getWheel() method is called using the following typemaps.

    // of dangling C++ pointer. Intended for methods that return pointers or // references to a member variable. %typemap(csout, excode=SWIGEXCODE) Wheel& getWheel { - IntPtr cPtr = $imcall;$excode + global::System.IntPtr cPtr = $imcall;$excode $csclassname ret = null; - if (cPtr != IntPtr.Zero) { + if (cPtr != global::System.IntPtr.Zero) { ret = new $csclassname(cPtr, $owner); ret.addReference(this); } @@ -23102,7 +24775,7 @@ getWheel() method is called using the following typemaps.

    in the generated getWheel() function:

    -public class Wheel : IDisposable {
    +public class Wheel : global::System.IDisposable {
       ...
       // Ensure that the GC doesn't collect any Bike instance set from C#
       private Bike bikeReference;
    @@ -23111,12 +24784,12 @@ public class Wheel : IDisposable {
       }
     }
     
    -public class Bike : IDisposable {
    +public class Bike : global::System.IDisposable {
       ...
       public Wheel getWheel() {
    -    IntPtr cPtr = examplePINVOKE.Bike_getWheel(swigCPtr);
    +    global::System.IntPtr cPtr = examplePINVOKE.Bike_getWheel(swigCPtr);
         Wheel ret = null;
    -    if (cPtr != IntPtr.Zero) {
    +    if (cPtr != global::System.IntPtr.Zero) {
           ret = new Wheel(cPtr, false);
           ret.addReference(this);
         }
    @@ -23126,8 +24799,8 @@ public class Bike : IDisposable {
     

    Note the addReference call.

    -

    19.8.2 Memory - management for objects passed to the C++ layer

    +

    20.8.2 Memory management + for objects passed to the C++ layer

    The example is a direct equivalent to this Java equivalent. Managing memory can be tricky when using C++ and C# proxy classes. The previous example shows one such case and this @@ -23176,9 +24849,9 @@ public: container.setElement(element); Console.WriteLine("element.value: " + container.getElement().value); // Simulate a garbage collection - System.GC.Collect(); - System.GC.WaitForPendingFinalizers(); - Console.WriteLine("element.value: " + container.getElement().value); + global::System.GC.Collect(); + global::System.GC.WaitForPendingFinalizers(); + global::System.Console.WriteLine("element.value: " + container.getElement().value);

    The temporary element created with new Element(20) could @@ -23188,14 +24861,14 @@ public: add in the appropriate references in the C# layer...

    -public class Container : IDisposable {
    +public class Container : global::System.IDisposable {
     
       ...
     
       // Ensure that the GC doesn't collect any Element set from C#
       // as the underlying C++ class stores a shallow copy
       private Element elementReference;
    -  private HandleRef getCPtrAndAddReference(Element element) {
    +  private global::System.Runtime.InteropServices.HandleRef getCPtrAndAddReference(Element element) {
         elementReference = element;
         return Element.getCPtr(element);
       }
    @@ -23218,15 +24891,15 @@ public class Container : IDisposable {
       // Ensure that the GC doesn't collect any Element set from C#
       // as the underlying C++ class stores a shallow copy
       private Element elementReference;
    -  private HandleRef getCPtrAndAddReference(Element element) {
    +  private global::System.Runtime.InteropServices.HandleRef getCPtrAndAddReference(Element element) {
         elementReference = element;
         return Element.getCPtr(element);
       }
     %}
     
    -

    19.8.3 Date marshalling using - the csin typemap and associated attributes

    +

    20.8.3 Date marshalling using the + csin typemap and associated attributes

    The NaN Exception example is a simple example of the "javain" typemap and its 'pre' attribute. This example demonstrates how a C++ date class, say CDate, can @@ -23260,7 +24933,7 @@ dateOut is a non-const output type.

    C# proxy class CDate is used in the proxy interface:

    -public class Action : IDisposable {
    +public class Action : global::System.IDisposable {
       ...
       public Action(CDate dateIn, CDate dateOut) 
           : this(examplePINVOKE.new_Action(CDate.getCPtr(dateIn), CDate.getCPtr(dateOut)), true) {
    @@ -23330,7 +25003,7 @@ dateIn = new System.DateTime(2012, 7, 14);
      follows:

    -public class Action : IDisposable {
    +public class Action : global::System.IDisposable {
       ...
       public int doSomething(System.DateTime dateIn, out System.DateTime dateOut) {
         CDate tempdateIn = new CDate(dateIn.Year, dateIn.Month, dateIn.Day);
    @@ -23348,7 +25021,7 @@ public class Action : IDisposable {
         }
       }
     
    -  static private IntPtr SwigConstructAction(System.DateTime dateIn, out System.DateTime dateOut) {
    +  static private global::System.IntPtr SwigConstructAction(System.DateTime dateIn, out System.DateTime dateOut) {
         CDate tempdateIn = new CDate(dateIn.Year, dateIn.Month, dateIn.Day);
         CDate tempdateOut = new CDate();
         try {
    @@ -23490,8 +25163,8 @@ public class example {
     }
     
    -

    19.8.4 A date example - demonstrating marshalling of C# properties

    +

    20.8.4 A date example demonstrating + marshalling of C# properties

    The previous section looked at converting a C++ date class to System.DateTime for parameters. This section extends this idea so that the correct marshalling is obtained when wrapping C++ variables. @@ -23539,8 +25212,8 @@ Structure data members. The typemap type required is thus CDate %typemap(csvarout, excode=SWIGEXCODE2) CDate * %{ /* csvarout typemap code */ get { - IntPtr cPtr = $imcall; - CDate tempDate = (cPtr == IntPtr.Zero) ? null : new CDate(cPtr, $owner);$excode + global::System.IntPtr cPtr = $imcall; + CDate tempDate = (cPtr == global::System.IntPtr.Zero) ? null : new CDate(cPtr, $owner);$excode return new System.DateTime(tempDate.getYear(), tempDate.getMonth(), tempDate.getDay(), 0, 0, 0); } %} @@ -23559,8 +25232,8 @@ public class example { } /* csvarout typemap code */ get { - IntPtr cPtr = examplePINVOKE.ImportantDate_get(); - CDate tempDate = (cPtr == IntPtr.Zero) ? null : new CDate(cPtr, false); + global::System.IntPtr cPtr = examplePINVOKE.ImportantDate_get(); + CDate tempDate = (cPtr == global::System.IntPtr.Zero) ? null : new CDate(cPtr, false); return new System.DateTime(tempDate.getYear(), tempDate.getMonth(), tempDate.getDay(), 0, 0, 0); } @@ -23596,8 +25269,8 @@ CDate.getCPtr(tempvalue). creating the temp$csinput variable is such an example; it is identical to what is in the 'pre' attribute. -

    19.8.5 Date example - demonstrating the 'pre' and 'post' typemap attributes for directors

    +

    20.8.5 Date example + demonstrating the 'pre' and 'post' typemap attributes for directors

    The 'pre' and 'post' attributes in the "csdirectorin" typemap act like the attributes of the same name in the "csin" typemap. For example if we modify the Date marshalling @@ -23636,7 +25309,7 @@ CDate & parameter. The typemap may look like this:

     ...
    -  private void SwigDirectorsomeCallback(IntPtr date) {
    +  private void SwigDirectorsomeCallback(global::System.IntPtr date) {
         System.DateTime tempdate = new System.DateTime();
         try {
           someCallback(out tempdate);
    @@ -23653,8 +25326,8 @@ CDate & parameter. The typemap may look like this:

    Pay special attention to the memory management issues, using these attributes.

    -

    19.8.6 Turning wrapped classes - into partial classes

    +

    20.8.6 Turning wrapped classes into + partial classes

    C# supports the notion of partial classes whereby a class definition can be split into more than one file. It is possible to turn the wrapped C++ class into a partial C# class using the @@ -23671,7 +25344,7 @@ public:

    The default C# proxy class generated is:

    -public class ExtendMe : IDisposable {
    +public class ExtendMe : global::System.IDisposable {
       ...
       public int Part1() {
         ...
    @@ -23696,7 +25369,7 @@ ExtendMe class:

    The C# proxy class becomes a partial class:

    -public partial class ExtendMe : IDisposable {
    +public partial class ExtendMe : global::System.IDisposable {
       ...
       public int Part1() {
         ...
    @@ -23708,7 +25381,7 @@ public partial class ExtendMe : IDisposable {
      elsewhere, for example:

    -public partial class ExtendMe : IDisposable {
    +public partial class ExtendMe : global::System.IDisposable {
       public int Part2() {
         return 2;
       }
    @@ -23727,8 +25400,8 @@ Console.WriteLine("part2: {0}", em.Part2());
      code - Part1() and managed code - Part2(). The
      following example is an alternative approach to adding managed code to
      the generated proxy class.

    -

    19.8.7 Extending proxy - classes with additional C# code

    +

    20.8.7 Extending proxy + classes with additional C# code

    The previous example showed how to use partial classes to add functionality to a generated C# proxy class. It is also possible to extend a wrapped struct/class with C/C++ code by using the @@ -23749,7 +25422,7 @@ Console.WriteLine("part2: {0}", em.Part2());

    The generated C# proxy class will instead be:

    -public class ExtendMe : IDisposable {
    +public class ExtendMe : global::System.IDisposable {
       ...
       public int Part3() {
         return 3;
    @@ -23760,8 +25433,8 @@ public class ExtendMe : IDisposable {
     }
     
    -

    19.8.8 Underlying type for - enums

    +

    20.8.8 Underlying type for + enums

    C# enums use int as the underlying type for each enum item. If you wish to change the underlying type to something else, then use the csbase typemap. For example when your C++ code uses a value larget @@ -23785,9 +25458,7 @@ public enum BigNumbers : uint { }


    - - -

    20 SWIG and Chicken

    +

    21 SWIG and Chicken

    @@ -23848,7 +25519,7 @@ public enum BigNumbers : uint { -- object-oriented code is difficult to wrap by hand in CHICKEN -- and its typed pointer representation, essential for C and C++ libraries involving structures or classes.

    -

    20.1 Preliminaries

    +

    21.1 Preliminaries

    CHICKEN support was introduced to SWIG in version 1.3.18. SWIG relies on some recent additions to CHICKEN, which are only present in releases of CHICKEN with version number greater than or equal @@ -23856,7 +25527,7 @@ public enum BigNumbers : uint { the Garbage collection section below.

    You may want to look at any of the examples in Examples/chicken/ directory for the basic steps to run SWIG CHICKEN.

    -

    20.1.1 Running SWIG in C mode

    +

    21.1.1 Running SWIG in C mode

    To run SWIG CHICKEN in C mode, use the -chicken option.

    % swig -chicken example.i
    @@ -23875,7 +25546,7 @@ example.scm). The basic Scheme code must be compiled to C using

    So for the C mode of SWIG CHICKEN, example_wrap.c and oexample.c are the files that must be compiled to object files and linked into your project.

    -

    20.1.2 Running SWIG in C++ mode

    +

    21.1.2 Running SWIG in C++ mode

    To run SWIG CHICKEN in C++ mode, use the -chicken -c++ option.

    % swig -chicken -c++ example.i
    @@ -23890,15 +25561,15 @@ oexample.c are the files that must be compiled to object files and

    So for the C++ mode of SWIG CHICKEN, example_wrap.cxx and oexample.c are the files that must be compiled to object files and linked into your project.

    -

    20.2 Code Generation

    -

    20.2.1 Naming Conventions

    +

    21.2 Code Generation

    +

    21.2.1 Naming Conventions

    Given a C variable, function or constant declaration named Foo_Bar, the declaration will be available in CHICKEN as an identifier ending with Foo-Bar. That is, an underscore is converted to a dash.

    You may control what the CHICKEN identifier will be by using the %rename SWIG directive in the SWIG interface file.

    -

    20.2.2 Modules

    +

    21.2.2 Modules

    The name of the module must be declared one of two ways:

    • Placing %module example in the SWIG interface file.
    • @@ -23909,7 +25580,7 @@ Foo_Bar, the declaration will be available in CHICKEN as an (declare (unit modulename)), pass the -nounit option to SWIG.

      CHICKEN will be able to access the module using the (declare (uses modulename)) CHICKEN Scheme form.

      -

      20.2.3 Constants and Variables

      +

      21.2.3 Constants and Variables

      Constants may be created using any of the four constructs in the interface file:

        @@ -23932,7 +25603,7 @@ Foo_Bar, the declaration will be available in CHICKEN as an MYCONSTANT1 (MYCONSTANT1)). See Features and the %feature directive for info on how to apply the %feature.

        -

        20.2.4 Functions

        +

        21.2.4 Functions

        C functions declared in the SWIG interface file will have corresponding CHICKEN Scheme procedures. For example, the C function "int sqrt(double x);" will be available using the Scheme form (sqrt @@ -23945,7 +25616,7 @@ Features and the %feature directive for info on how to apply the parameter, or a void return value and at least two argout parameters). The return values can then be accessed with (call-with-values) .

        -

        20.2.5 Exceptions

        +

        21.2.5 Exceptions

        The SWIG chicken module has support for exceptions thrown from C or C++ code to be caught in scheme. See Exception handling with %exception for more information about @@ -23982,7 +25653,7 @@ SFRI-12. Since the exception values are thrown directly, if (test-throw 1))

    -

    20.3 TinyCLOS

    +

    21.3 TinyCLOS

    The author of TinyCLOS, Gregor Kiczales, describes TinyCLOS as: "Tiny CLOS is a Scheme implementation of a `kernelized' CLOS, with a metaobject protocol. The implementation is even simpler than the simple @@ -24007,7 +25678,7 @@ SFRI-12. Since the exception values are thrown directly, if the -closprefix mymod: argument is passed to SWIG, then the exported functions will be prefixed by the string "mymod:". If -useclassprefix is passed, -closprefix is ignored.

    -

    20.4 Linkage

    +

    21.4 Linkage

    Please refer to CHICKEN - A practical and portable Scheme system - User's manual for detailed help on how to link object files to create a CHICKEN Scheme program. Briefly, to link object files, be sure @@ -24020,8 +25691,8 @@ SFRI-12. Since the exception values are thrown directly, if (uses modname)). This means that to load the module from scheme code, the code must include (declare (uses modname )).

    -

    20.4.1 Static binary or shared library - linked at compile time

    +

    21.4.1 Static binary or shared library linked + at compile time

    We can easily use csc to build a static binary.

    @@ -24053,8 +25724,8 @@ $ csc -v test_script.scm -lexample
     (load-library 'example "example.so"), in which case the test
      script does not need to be linked with example.so. The test_script.scm
      file can then be run with csi.

    -

    20.4.2 Building chicken extension - libraries

    +

    21.4.2 Building chicken extension libraries +

    Building a shared library like in the above section only works if the library is linked at compile time with a script containing (declare (uses ...)) or is loaded explicitly with @@ -24106,8 +25777,8 @@ mod2_wrap.c files that are created by SWIG are stand alone and do

    See the Examples/chicken/egg directory in the SWIG source for an example that builds two eggs, one using the first method and one using the second method.

    -

    20.4.3 Linking multiple SWIG modules with - TinyCLOS

    +

    21.4.3 Linking multiple SWIG modules with + TinyCLOS

    Linking together multiple modules that share type information using the %import directive while also using -proxy is more complicated. For example, if mod2.i imports mod1.i @@ -24136,11 +25807,11 @@ mod2_wrap.c files that are created by SWIG are stand alone and do create an extension library or an egg, just create a module_load.scm file that (declare (uses ...)) all the modules.

    -

    20.5 Typemaps

    +

    21.5 Typemaps

    The Chicken module handles all types via typemaps. This information is read from Lib/chicken/typemaps.i and Lib/chicken/chicken.swg.

    -

    20.6 Pointers

    +

    21.6 Pointers

    For pointer types, SWIG uses CHICKEN tagged pointers. A tagged pointer is an ordinary CHICKEN pointer with an extra slot for a void *. With SWIG CHICKEN, this void * is a pointer to a type-info structure. @@ -24160,7 +25831,7 @@ SWIG_NewPointerObj more than once, just make sure known_space has **result, swig_type_info *type, int flags), passing a pointer to a struct representing the expected pointer type. flags is either zero or SWIG_POINTER_DISOWN (see below).

    -

    20.6.1 Garbage collection

    +

    21.6.1 Garbage collection

    If the owner flag passed to SWIG_NewPointerObj is 1, NewPointerObj will add a finalizer to the type which will call the destructor or delete method of that type. The destructor and delete @@ -24189,8 +25860,8 @@ Object ownership and %newobject for more information.

    SWIG. This will not export code inside the _wrap.c file to register finalizers, and will then export destructor functions which must be called manually.

    -

    20.7 Unsupported features and known - problems

    +

    21.7 Unsupported features and known problems +

    • No director support.
    • No support for c++ standard types like std::vector.
    • @@ -24198,8 +25869,8 @@ Object ownership and %newobject for more information.

      correctly when using %feature(compactdefaultargs).
    -

    20.7.1 TinyCLOS problems with Chicken - version <= 1.92

    +

    21.7.1 TinyCLOS problems with Chicken version + <= 1.92

    In Chicken versions equal to or below 1.92, TinyCLOS has a limitation such that generic methods do not properly work on methods with different number of specializers: TinyCLOS assumes that every method @@ -24235,7 +25906,7 @@ Lib/chicken/multi-generic.scm file in the SWIG source. This file functions inside TinyCLOS to correctly support multi-argument generics. Please see the comments at the top of both files for more information.


    -

    21 SWIG and D

    +

    22 SWIG and D

    @@ -24255,13 +25926,13 @@ Lib/chicken/multi-generic.scm file in the SWIG source. This file
  • Special variable macros
  • -
  • %features
  • +
  • D and %feature
  • Pragmas
  • D Exceptions
  • D Directors
  • Other features
  • -

    21.1 Introduction

    +

    22.1 Introduction

    From the D Programming Language web site: D is a systems programming language. Its focus is on combining the power and high performance of C and C++ with @@ -24302,10 +25973,10 @@ interface with C libraries. Why would a SWIG module for D be needed

    To help addressing these issues, the SWIG C# module has been forked to support D. Is has evolved quite a lot since then, but there are still many similarities, so if you do not find what you are looking for - on this page, it might be worth having a look at the chapter on -C# (and also on Java, since the C# module - was in turn forked from it).

    -

    21.2 Command line invocation

    + on this page, it might be worth having a look at the chapter on +C# (and also on Java, since the C# module was in + turn forked from it).

    +

    22.2 Command line invocation

    To activate the D module, pass the -d option to SWIG at the command line. The same standard command line switches as with any other language module are available, plus the following D specific ones:

    @@ -24315,7 +25986,7 @@ C# (and also on Java, since the C# module

    By default, SWIG generates code for D1/Tango. Use the -d2 flag to target D2/Phobos instead.

    -
    -splitproxy
    +
    -splitproxy

    By default, SWIG generates two D modules: the proxy module, named like the source module (either specified via the %module @@ -24348,9 +26019,9 @@ C# (and also on Java, since the C# module shared library.

    -

    21.3 Typemaps

    -

    21.3.1 C# <-> D name - comparison

    +

    22.3 Typemaps

    +

    22.3.1 C# <-> D name comparison +

    If you already know the SWIG C# module, you might find the following name comparison table useful:

    @@ -24374,7 +26045,7 @@ C# (and also on Java, since the C# module csdestruct_derived <-> ddispose_derived
    -

    21.3.2 ctype, imtype, dtype

    +

    22.3.2 ctype, imtype, dtype

    Mapping of types between the C/C++ library, the C/C++ library wrapper exposing the C functions, the D wrapper module importing these functions and the D proxy code.

    @@ -24383,8 +26054,8 @@ C# (and also on Java, since the C# module used in the extern(C) declarations of these functions in the intermediary D module. The dtype typemap contains the D types used in the D proxy module/class.

    -

    21.3.3 in, out, - directorin, directorout

    +

    22.3.3 in, out, + directorin, directorout

    Used for converting between the types for C/C++ and D when generating the code for the wrapper functions (on the C++ side).

    The code from the in typemap is used to convert arguments to @@ -24395,31 +26066,32 @@ C# (and also on Java, since the C# module

    The directorin typemap is used to convert parameters to the type used in the D director callback function, its return value is processed by directorout (see below).

    -

    21.3.4 din, dout, - ddirectorin, ddirectorout

    +

    22.3.4 din, dout, + ddirectorin, ddirectorout

    Typemaps for code generation in D proxy and type wrapper classes.

    -

    The din typemap is used for converting function - parameter types from the type used in the proxy module or class to the - type used in the intermediary D module (the -$dinput macro is replaced). To inject further parameter - processing code before or after the call to the intermediary layer, the - pre, post and terminator attributes can be - used (please refer to the C# date - marshalling example for more information on these).

    -

    The dout typemap is used for converting function - return values from the return type used in the intermediary D module to - the type returned by the proxy function. The $excode special - variable in dout typemaps is replaced by the excode - typemap attribute code if the method can throw any exceptions from - unmanaged code, otherwise by nothing (the -$imcall and $owner macros are replaced).

    -

    The code from the ddirectorin and -ddirectorout typemaps is used for conversion in director callback - functions. Arguments are converted to the type used in the proxy class - method they are calling by using the code from ddirectorin, - the proxy class method return value is converted to the type the C++ - code expects via the ddirectorout typemap (the -$dcall and $winput macros are replaced).

    +

    The din typemap is used for converting + function parameter types from the type used in the proxy module or + class to the type used in the intermediary D module (the +$dinput macro is replaced). To inject further parameter processing + code before or after the call to the intermediary layer, the pre +, post and terminator attributes can be used (please + refer to the C# date marshalling + example for more information on these).

    +

    The dout typemap is used for converting + function return values from the return type used in the intermediary D + module to the type returned by the proxy function. The $excode + special variable in dout typemaps is replaced by the +excode typemap attribute code if the method can throw any + exceptions from unmanaged code, otherwise by nothing (the +$imcall and $owner macros are replaced).

    +

    The code from the ddirectorin + and ddirectorout typemaps is used for conversion in director + callback functions. Arguments are converted to the type used in the + proxy class method they are calling by using the code from +ddirectorin, the proxy class method return value is converted to + the type the C++ code expects via the ddirectorout typemap + (the $dcall and $winput + macros are replaced).

    The full chain of type conversions when a director callback is invoked looks like this:

    @@ -24436,14 +26108,14 @@ ddirectorout typemaps is used for conversion in director callback ↑ ↓ dtype DClass.method(dtype a)
    -

    21.3.5 typecheck typemaps

    +

    22.3.5 typecheck typemaps

    Because, unlike many scripting languages supported by SWIG, D does not need any dynamic dispatch helper to access an overloaded function, the purpose of these is merely to issue a warning for overloaded C++ functions that cannot be overloaded in D (as more than one C++ type maps to a single D type).

    -

    21.3.6 Code injection - typemaps

    +

    22.3.6 Code injection typemaps +

    These typemaps are used for generating the skeleton of proxy classes for C++ types.

    By overriding dbase, dinterfaces or @@ -24454,13 +26126,13 @@ dinterfaces_derived, the inheritance chain of the generated proxy additional D code which will be emitted into the class body respectively the imports section of the D module the class is written to.

    -

    dconstructor, ddestructor -, ddispose and ddispose_derived are used to generate - the class constructor, destructor and dispose() method, - respectively. The auxiliary code for handling the pointer to the C++ - object is stored in dbody and dbody_derived. You can - override them for specific types.

    -

    21.3.7 Special variable macros

    +

    dconstructor, +ddestructor, ddispose and ddispose_derived are + used to generate the class constructor, destructor and dispose() + method, respectively. The auxiliary code for handling the pointer to + the C++ object is stored in dbody and dbody_derived. + You can override them for specific types.

    +

    22.3.7 Special variable macros

    The standard SWIG special variables are available for use within typemaps as described in the Typemaps documentation , for example $1, $input, $result etc.

    @@ -24498,11 +26170,10 @@ $*dclassname would be replaced by the proxy class name on whether the function has a return value or not. It can be used to bail out early e.g. in case of errors (return $null;).

    -
    $dinput (C#: $csinput)
    +
    $dinput (C#: $csinput)
    -

    This variable is used in din - typemaps and is replaced by the expression which is to be passed to - C/C++.

    +

    This variable is used in din typemaps + and is replaced by the expression which is to be passed to C/C++.

    For example, this input

    @@ -24520,10 +26191,10 @@ void foo(SomeClass arg) {
       example_im.foo(SomeClass.getCPointer(arg));
     }
    -
    $imcall and $owner (C#: $imcall -)
    +
    $imcall and $owner (C#: +$imcall)
    -

    These variables are used in dout +

    These variables are used in dout typemaps. $imcall contains the call to the intermediary module which provides the value to be used, and $owner signals if the caller is responsible for managing the object lifetime (that is, if the @@ -24559,9 +26230,9 @@ SomeClass bar() {

    $dcall and $winput (C#: $cscall, $iminput)
    -
    -

    These variables are used in the director-specific typemaps -ddirectorin and +

    +

    These variables are used in the director-specific typemaps +ddirectorin and ddirectorout. They are more or less the reverse of the $imcall and $dinput macros: $dcall contains the invocation of the D proxy method of which the return value is to be @@ -24582,7 +26253,7 @@ C# documentation for details.

    $directorconnect
    -

    This macro is only valid inside the +

    This macro is only valid inside the dconstructor typemap and contains the value of the dconstructor typemap attribute if the currently wrapped class has directors enabled.

    @@ -24596,7 +26267,7 @@ dconstructor typemap attribute if the currently wrapped class has }
    -
    $importtype(SomeDType)
    +
    $importtype(SomeDType)

    This macro is used in the dimports typemap if a dependency on another D type generated by SWIG is added by a custom typemap.

    @@ -24643,7 +26314,7 @@ $importtype(AnotherInterface)

    Contains the fully qualified name of the intermediary D module.

    -

    21.4 %features

    +

    22.4 D and %feature

    The D module defines a number of directives which modify the SWIG features set globally or for a specific declaration:

    @@ -24678,7 +26349,7 @@ struct A {
    -

    21.5 Pragmas

    +

    22.5 Pragmas

    There are a few SWIG pragmas specific to the D module, which you can use to influence the D code SWIG generates:

    @@ -24691,16 +26362,16 @@ struct A {
    %pragma(d) imdmoduleimports

    Additional code to be emitted to the imports section of the - intermediary D module (the $importtype + intermediary D module (the $importtype macro can be used here). You probably want to use this in conjunction with the imdmodulecode pragma.

    %pragma(d) proxydmodulecode

    Just like proxydmodulecode, the argument is copied to the - proxy D module (if SWIG is in split proxy - mode and/or the nspace feature is used, it is emitted to - the main proxy D module only).

    + proxy D module (if SWIG is in split proxy mode + and/or the nspace feature is used, it is emitted to the main + proxy D module only).

    %pragma(d) globalproxyimports
    @@ -24736,7 +26407,7 @@ $symbol variable is replaced by the name of the symbol in the overwritten.

    -

    21.6 D Exceptions

    +

    22.6 D Exceptions

    Out of the box, C++ exceptions are fundamentally incompatible to their equivalent in the D world and cannot simply be propagated to a calling D method. There is, however, an easy way to solve this problem: @@ -24749,7 +26420,7 @@ $symbol variable is replaced by the name of the symbol in the

    As this feature is implemented in exactly the same way it is for C#, please see the C# documentation for a more detailed explanation.

    -

    21.7 D Directors

    +

    22.7 D Directors

    When the directors feature is activated, SWIG generates extra code on both the C++ and the D side to enable cross-language polymorphism. Essentially, this means that if you subclass a proxy class in D, C++ @@ -24758,9 +26429,8 @@ $symbol variable is replaced by the name of the symbol in the

    There is no D specific documentation yet, but the way the feature is implemented is very similar to how it is done in Java and C#.

    -

    21.8 Other features

    -

    21.8.1 Extended namespace support (nspace -)

    +

    22.8 Other features

    +

    22.8.1 Extended namespace support (nspace)

    By default, SWIG flattens all C++ namespaces into a single target language namespace, but as for Java and C#, the nspace feature is supported for D. If it is active, C++ @@ -24768,7 +26438,7 @@ Java and C#.

    for the other languages, free variables and functions are not supported yet; currently, they are all allows written to the main proxy D module.

    -

    21.8.2 Native pointer support

    +

    22.8.2 Native pointer support

    Contrary to many of the scripting languages supported by SWIG, D fully supports C-style pointers. The D module thus includes a custom mechanism to wrap C pointers directly as D pointers where applicable, @@ -24793,7 +26463,7 @@ cprimitive attribute on its dtype attribute is used. For cprimitive="1", so the code from the nativepointer attribute is taken into account e.g. for float ** or the function pointer float (*)(float *).

    -

    21.8.3 Operator overloading

    +

    22.8.3 Operator overloading

    The D module comes with basic operator overloading support for both D1 and D2. There are, however, a few limitations arising from conceptual differences between C++ and D:

    @@ -24819,7 +26489,7 @@ D2.

    -, or implicit casting (which was introduced in D2 via alias this ). Despite the lack of automatic support, manually handling these cases should be perfectly possible.

    -

    21.8.4 Running the test-suite

    +

    22.8.4 Running the test-suite

    As with any other language, the SWIG test-suite can be built for D using the *-d-test-suite targets of the top-level Makefile. By default, D1 is targeted, to build it with D2, use the optional @@ -24830,13 +26500,13 @@ D_VERSION variable, e.g. make check-d-test-suite D_VERSION=2 library, you might have to add -ldl manually to the d_compile target in Examples/Makefile, because GDC does not currently honor the pragma(lib,...) statement.

    -

    21.9 D Typemap examples

    +

    22.9 D Typemap examples

    There are no D-specific typemap examples yet. However, with the above name comparison table, you should be able to get an idea what can be done by looking at the corresponding C# section.

    -

    21.10 Work in progress and planned - features

    +

    22.10 Work in progress and planned + features

    There are a couple of features which are not implemented yet, but would be very useful and might be added in the near future:

      @@ -24864,16 +26534,17 @@ corresponding C# section.

      issues concerning const-correctness etc.

    -

    22 SWIG and Go

    +

    23 SWIG and Go

    @@ -24901,61 +26587,144 @@ corresponding C# section.

    This chapter describes SWIG's support of Go. For more information on the Go programming language see golang.org .

    -

    22.1 Overview

    -

    Go is a compiled language, not a scripting language. However, it - does not support direct calling of functions written in C/C++. The cgo - program may be used to generate wrappers to call C code from Go, but - there is no convenient way to call C++ code. SWIG fills this gap.

    -

    There are (at least) two different Go compilers. One is the gc - compiler, normally invoked under the names 6g, 8g, or 5g. The other is - the gccgo compiler, which is a frontend to the gcc compiler suite. The +

    23.1 Overview

    +

    Go does not support direct calling of functions written in C/C++. + The cgo program may be used + to generate wrappers to call C code from Go, but there is no convenient + way to call C++ code. SWIG fills this gap.

    +

    There are (at least) two different Go compilers. The first is the gc + compiler of the Go + distribution, normally invoked via the +go tool. The second Go compiler is the + gccgo compiler, which is a frontend to the GCC compiler suite. The interface to C/C++ code is completely different for the two Go - compilers. SWIG supports both, selected by a command line option.

    -

    Because Go is a type-safe compiled language, SWIG's runtime type - checking and runtime library are not used with Go. This should be borne - in mind when reading the rest of the SWIG documentation.

    -

    22.2 Running SWIG with Go

    -

    To generate Go code, use the -go option with SWIG. By - default SWIG will generate code for the gc compilers. To generate code - for gccgo, you should also use the -gccgo option.

    -

    22.2.1 Additional Commandline Options

    -

    These are the command line options for SWIG's GO module. They can + compilers. SWIG supports both Go compilers, selected by the -gccgo + command line option.

    +

    Go is a type-safe compiled language and the wrapper code generated + by SWIG is type-safe as well. In case of type issues the build will + fail and hence SWIG's runtime library and +runtime type checking are not used.

    +

    23.2 Examples

    +

    Working examples can be found in the +SWIG source tree .

    +

    Please note that the examples in the SWIG source tree use makefiles + with the .i SWIG interface file extension for backwards compatibility + with Go 1.

    +

    23.3 Running SWIG with Go

    +

    Most Go programs are built using the +go tool. Since Go 1.1 the go tool has support for SWIG. To use it, + give your SWIG interface file the extension .swig (for C code) or + .swigcxx (for C++ code). Put that file in a GOPATH/src directory as + usual for Go sources. Put other C/C++ code in the same directory with + extensions of .c and .cxx. The go build and go install + commands will automatically run SWIG for you and compile the generated + wrapper code. To check the SWIG command line options the go tool uses + run go build -x. To access the automatically generated files + run go build -work. You'll find the files under the temporary + WORK directory.

    +

    To manually generate and compile C/C++ wrapper code for Go, use the +-go option with SWIG. By default SWIG will generate code for the Go + compiler of the Go distribution. To generate code for gccgo, you should + also use the -gccgo option.

    +

    When using the -cgo option, SWIG will generate files that + can be used directly by go build. Starting with the Go 1.5 + distribution the -cgo option has to be given. Put your SWIG + interface file in a directory under GOPATH/src, and give it a name that + does not end in the .swig or .swigcxx extension. Typically the + SWIG interface file extension is .i in this case.

    +
    +
    +% swig -go -cgo example.i
    +% go install
    +
    +
    +

    You will now have a Go package that you can import from other Go + packages as usual.

    +

    To use SWIG without the -cgo option, more steps are + required. Recall that this only works with Go versions before 1.5. When + using Go version 1.2 or later, or when using gccgo, the code generated + by SWIG can be linked directly into the Go program. A typical command + sequence when using the Go compiler of the Go distribution would look + like this:

    +
    +
    +% swig -go example.i
    +% gcc -c code.c    # The C library being wrapped.
    +% gcc -c example_wrap.c
    +% go tool 6g example.go
    +% go tool 6c example_gc.c
    +% go tool pack grc example.a example.6 example_gc.6 code.o example_wrap.o
    +% go tool 6g main.go
    +% go tool 6l main.6
    +
    +
    +

    You can also put the wrapped code into a shared library, and when + using the Go versions before 1.2 this is the only supported option. A + typical command sequence for this approach would look like this:

    +
    +
    +% swig -go -use-shlib example.i
    +% gcc -c -fpic example.c
    +% gcc -c -fpic example_wrap.c
    +% gcc -shared example.o example_wrap.o -o example.so
    +% go tool 6g example.go
    +% go tool 6c example_gc.c
    +% go tool pack grc example.a example.6 example_gc.6
    +% go tool 6g main.go  # your code, not generated by SWIG
    +% go tool 6l main.6
    +
    +
    +

    23.3.1 Go-specific Commandline Options

    +

    These are the command line options for SWIG's Go module. They can also be seen by using:

     swig -go -help
     
    - - - +
    Go specific options
    -intgo-type-size %lt;s%gt;Set the size for the Go type -int. This controls the size that the C/C++ code expects to see. The - %lt;s%gt; argument should be 32 or 64. This option is currently - required during the transition from Go 1.0 to Go 1.1, as the size of -int on 64-bit x86 systems changes between those releases (from 32 - bits to 64 bits). In the future the option may become optional, and - SWIG will assume that the size of int is the size of a C - pointer.
    + + + + generate code for the Go compiler of the Go distribution. - + + generating code for the Go compiler of the Go distribution; when using + gccgo, the equivalent name will be taken from the -soname + option passed to the linker. Using this option implies the -use-shlib + option. + - + to gccgo. If -go-pkgpath is used, -go-prefix will be + ignored.
    Go-specific options
    -cgoGenerate files to be used as input for the Go cgo + tool. This option is required for Go 1.5 and later, and works for Go + 1.2 and later. In the future this option will likely become the + default.
    -intgosize <s>Set the size for the Go type int +. This controls the size that the C/C++ code expects to see. The <s> + argument should be 32 or 64. This option is currently required during + the transition from Go 1.0 to Go 1.1, as the size of int on + 64-bit x86 systems changes between those releases (from 32 bits to 64 + bits). In the future the option may become optional, and SWIG will + assume that the size of int is the size of a C pointer.
    -gccgoGenerate code for gccgo. The default is to - generate code for 6g/8g/5g.
    -package <name>Set the name of the Go package to <name>. The default package name is the SWIG module name.
    -soname %lt;name%gt;Set the runtime name of the shared +
    -use-shlibTell SWIG to emit code that uses a shared + library. This is only meaningful for the Go compiler of the Go + distribution, which needs to know at compile time whether a shared + library will be used.
    -soname <name>Set the runtime name of the shared library that the dynamic linker should include at runtime. The default is the package name with ".so" appended. This is only used when - generating code for 6g/8g/5g; when using gccgo, the equivalent name - will be taken from the -soname option passed to the - linker.
    -go-pkgpath <pkgpath>When generating code for gccgo, + set the pkgpath to use. This corresponds to the -fgo-pkgpath + option to gccgo.
    -go-prefix <prefix>When generating code for gccgo, set the prefix to use. This corresponds to the -fgo-prefix option - to gccgo.
    -long-type-size <s>Set the size for the C/C++ type -long. This controls whether long is converted to the Go - type int32 or int64. The <s> argument should be 32 or - 64.
    -

    22.2.2 Go Output Files

    -

    When generating Go code, SWIG will generate the following files:

    +

    23.3.2 Generated Wrapper Files

    +

    There are two different approaches to generating wrapper files, + controlled by SWIG's -cgo option. The -cgo option + works with Go version 1.2 or later. It is required when using Go + version 1.5 or later.

    +

    With or without the -cgo option, SWIG will generate the + following files when generating wrapper code:

    • MODULE.go will contain the Go functions that your Go code will call. These functions will be wrappers for the C++ functions defined by @@ -24963,43 +26732,31 @@ long. This controls whether long is converted to the Go compiler.
    • MODULE_wrap.c or MODULE_wrap.cxx will contain C/C++ functions will be invoked by the Go wrapper code. This file should be compiled with - the usual C or C++ compiler and linked into a shared library.
    • + the usual C or C++ compiler.
    • MODULE_wrap.h will be generated if you use the directors feature. It provides a definition of the generated C++ director classes. It is generally not necessary to use this file, but in some special cases it may be helpful to include it in your code, compiled with the usual C or C++ compiler.
    • -
    • If using the gc compiler, MODULE_gc.c will contain C code which - should be compiled with the C compiler distributed as part of the gc - compiler: 6c, 8c, or 5c. It should then be combined with the compiled - MODULE.go using gopack. This file will not be generated when using - gccgo.
    -

    A typical command sequence would look like this:

    -
    -
    -% swig -go example.i
    -% gcc -c -fpic example.c
    -% gcc -c -fpic example_wrap.c
    -% gcc -shared example.o example_wrap.o -o example.so
    -% 6g example.go
    -% 6c example_gc.c
    -% gopack grc example.a example.6 example_gc.6
    -% 6g main.go  # your code, not generated by SWIG
    -% 6l main.6
    -
    -
    -

    22.3 A tour of basic C/C++ wrapping

    +

    When neither the -cgo nor the -gccgo option is + used, SWIG will also generate an additional file:

    +
      +
    • MODULE_gc.c will contain C code which should be compiled with the C + compiler distributed as part of the gc compiler. It should then be + combined with the compiled MODULE.go using go tool pack.
    • +
    +

    23.4 A tour of basic C/C++ wrapping

    By default, SWIG attempts to build a natural Go interface to your C/C++ code. However, the languages are somewhat different, so some modifications have to occur. This section briefly covers the essential aspects of this wrapping.

    -

    22.3.1 Go Package Name

    +

    23.4.1 Go Package Name

    All Go source code lives in a package. The name of this package will default to the name of the module from SWIG's %module directive. You may override this by using SWIG's -package command line option.

    -

    22.3.2 Go Names

    +

    23.4.2 Go Names

    In Go, a function is only visible outside the current package if the first letter of the name is uppercase. This is quite different from C/C++. Because of this, C/C++ names are modified when generating the Go @@ -25019,16 +26776,16 @@ long. This controls whether long is converted to the Go the name of a type in Go. A constructor will be named New followed by that name, and the destructor will be named Delete followed by that name.

    -

    22.3.3 Go Constants

    +

    23.4.3 Go Constants

    C/C++ constants created via #define or the %constant directive become Go constants, declared with a const declaration.

    -

    22.3.4 Go Enumerations

    +

    23.4.4 Go Enumerations

    C/C++ enumeration types will cause SWIG to define an integer type with the name of the enumeration (with first letter forced to uppercase as usual). The values of the enumeration will become variables in Go; code should avoid modifying those variables.

    -

    22.3.5 Go Classes

    +

    23.4.5 Go Classes

    Go has interfaces, methods and inheritance, but it does not have classes in the same sense as C++. This sections describes how SWIG represents C++ classes represented in Go.

    @@ -25077,7 +26834,7 @@ type MyClass interface { MyMethod() int } -MyClassMyFactoryFunction() MyClass { +func MyClassMyFactoryFunction() MyClass { // swig magic here } @@ -25085,47 +26842,544 @@ MyClassMyFactoryFunction() MyClass {

    Note that the factory function does not return a go pointer; it actually returns a go interface. If the returned pointer can be null, you can check for this by calling the Swigcptr() method.

    -

    22.3.5.1 Go Class Inheritance

    +

    23.4.5.1 Go Class Memory Management

    +

    Calling NewClassName for a C++ class ClassName + will allocate memory using the C++ memory allocator. This memory will + not be automatically freed by Go's garbage collector as the object + ownership is not tracked. When you are done with the C++ object you + must free it using DeleteClassName. +
    +
    The most Go idiomatic way to manage the memory for some C++ class + is to call NewClassName followed by a +defer of the DeleteClassName call. Using defer + ensures that the memory of the C++ object is freed as soon as the + function containing the defer statement returns. Furthemore +defer works great for short-lived objects and fits nicely C++'s + RAII idiom. Example:

    +
    +
    +func UseClassName(...) ... {
    +  o := NewClassName(...)
    +  defer DeleteClassName(o)
    +  // Use the ClassName object
    +  return ...
    +}
    +
    +
    +

    With increasing complexity, especially complex C++ object + hierarchies, the correct placement of defer statements becomes + harder and harder as C++ objects need to be freed in the correct order. + This problem can be eased by keeping a C++ object function local so + that it is only available to the function that creates a C++ object and + functions called by this function. Example:

    +
    +
    +func WithClassName(constructor args, f func(ClassName, ...interface{}) error, data ...interface{}) error {
    +  o := NewClassName(constructor args)
    +  defer DeleteClassName(o)
    +  return f(o, data...)
    +}
    +
    +func UseClassName(o ClassName, data ...interface{}) (err error) {
    +  // Use the ClassName object and additional data and return error.
    +}
    +
    +func main() {
    +  WithClassName(constructor args, UseClassName, additional data)
    +}
    +
    +
    +

    Using defer has limitations though, especially when it + comes to long-lived C++ objects whichs lifetimes are hard to predict. + For such C++ objects a common technique is to store the C++ object into + a Go object, and to use the Go function runtime.SetFinalizer + to add a finalizer which frees the C++ object when the Go object is + freed. It is strongly recommended to read the +runtime.SetFinalizer documentation before using this technique to + understand the runtime.SetFinalizer limitations. +

    +

    Common pitfalls with runtime.SetFinalizer are:

    +
      +
    • If a hierarchy of C++ objects will be automatically freed by Go + finalizers then the Go objects that store the C++ objects need to + replicate the hierarchy of the C++ objects to prevent that C++ objects + are freed prematurely while other C++ objects still rely on them.
    • +
    • The usage of Go finalizers is problematic with C++'s RAII idiom as + it isn't predictable when the finalizer will run and this might require + a Close or Delete method to be added the Go object that stores a C++ + object to mitigate.
    • +
    • The Go finalizer function typically runs in a different OS thread + which can be problematic with C++ code that uses thread-local storage.
    • +
    +

    runtime.SetFinalizer Example:

    +
    +
    +import (
    +  "runtime"
    +  "wrap" // SWIG generated wrapper code
    +)
    +
    +type GoClassName struct {
    +  wcn wrap.ClassName
    +}
    +
    +func NewGoClassName() *GoClassName {
    +  o := &GoClassName{wcn: wrap.NewClassName()}
    +  runtime.SetFinalizer(o, deleteGoClassName)
    +  return o
    +}
    +
    +func deleteGoClassName(o *GoClassName) {
    +  // Runs typically in a different OS thread!
    +  wrap.DeleteClassName(o.wcn)
    +  o.wcn = nil
    +}
    +
    +func (o *GoClassName) Close() {
    +  // If the C++ object has a Close method.
    +  o.wcn.Close()
    +
    +  // If the GoClassName object is no longer in an usable state.
    +  runtime.SetFinalizer(o, nil) // Remove finalizer.
    +  deleteGoClassName() // Free the C++ object.
    +}
    +
    +
    +

    23.4.5.2 Go Class Inheritance

    C++ class inheritance is automatically represented in Go due to its use of interfaces. The interface for a child class will be a superset of the interface of its parent class. Thus a value of the child class type in Go may be passed to a function which expects the parent class. Doing the reverse will require an explicit type assertion, which will be checked dynamically.

    -

    22.3.6 Go Templates

    +

    23.4.6 Go Templates

    In order to use C++ templates in Go, you must tell SWIG to create wrappers for a particular template instantation. To do this, use the %template directive.

    -

    22.3.7 Go Director Classes

    +

    23.4.7 Go Director Classes

    SWIG's director feature permits a Go type to act as the subclass of - a C++ class with virtual methods. This is complicated by the fact that - C++ and Go define inheritance differently. In Go, structs can inherit - methods via anonymous field embedding. However, when a method is called - for an embedded struct, if that method calls any other methods, they - are called for the embedded struct, not for the original type. - Therefore, SWIG must use Go interfaces to represent C++ inheritance.

    -

    In order to use the director feature in Go, you must define a type - in your Go code. You must then add methods for the type. Define a - method in Go for each C++ virtual function that you want to override. - You must then create a value of your new type, and pass a pointer to it - to the function NewDirectorClassName, where ClassName - is the name of the C++ class. That will return a value of type -ClassName.

    -

    For example:

    + a C++ class. This is complicated by the fact that C++ and Go define + inheritance differently. SWIG normally represents the C++ class + inheritance automatically in Go via interfaces but with a Go type + representing a subclass of a C++ class some manual work is necessary.

    +

    This subchapter gives a step by step guide how to properly sublass a + C++ class with a Go type. In general it is strongly recommended to + follow this guide completely to avoid common pitfalls with directors in + Go.

    +

    23.4.7.1 Example C++ code

    +

    The step by step guide is based on two example C++ classes. + FooBarAbstract is an abstract C++ class and the FooBarCpp class + inherits from it. This guide explains how to implement a FooBarGo class + similar to the FooBarCpp class.

    +

    FooBarAbstract abstract C++ class:

    +
    +
    +class FooBarAbstract
    +{
    +public:
    +  FooBarAbstract() {};
    +  virtual ~FooBarAbstract() {};
    +
    +  std::string FooBar() {
    +          return this->Foo() + ", " + this->Bar();
    +  };
    +
    +protected:
    +  virtual std::string Foo() {
    +          return "Foo";
    +  };
    +
    +  virtual std::string Bar() = 0;
    +};
    +
    +
    +

    FooBarCpp C++ class:

    +
    +
    +class FooBarCpp : public FooBarAbstract
    +{
    +protected:
    +  virtual std::string Foo() {
    +    return "C++ " + FooBarAbstract::Foo();
    +  }
    +
    +  virtual std::string Bar() {
    +    return "C++ Bar";
    +  }
    +};
    +
    +
    +

    Returned string by the FooBarCpp::FooBar method is:

    +
    +
    +C++ Foo, C++ Bar
    +
    +
    +

    The complete example, including the FooBarGoo class + implementation, can be found in +the end of the guide.

    +

    23.4.7.2 Enable director feature

    +

    The director feature is disabled by default. To use directors you + must make two changes to the interface file. First, add the "directors" + option to the %module directive, like this:

    +
    +
    +%module(directors="1") modulename
    +
    +
    +

    Second, you must use the %feature("director") directive to tell SWIG + which classes should get directors. In the example the FooBarAbstract + class needs the director feature enabled so that the FooBarGo class can + inherit from it, like this:

    +
    +
    +%feature("director") FooBarAbstract;
    +
    +
    +

    For a more detailed documentation of the director feature and how to + enable or disable it for specific classes and virtual methods see + SWIG's Java documentation on directors.

    +

    23.4.7.3 Constructor and destructor +

    +

    SWIG creates an additional set of constructor and destructor + functions once the director feature has been enabled for a C++ class. +NewDirectorClassName allows overriding virtual methods on the new + object instance and DeleteDirectorClassName needs to be used + to free a director object instance created with +NewDirectorClassName. More on overriding virtual methods follows + later in this guide under overriding + virtual methods.

    +

    The default constructor and destructor functions NewClassName + and DeleteClassName can still be used as before so that + existing code doesn't break just because the director feature has been + enabled for a C++ class. The behavior is undefined if the default and + director constructor and destructor functions get mixed and so great + care needs to be taken that only one of the constructor and destructor + function pairs is used for any object instance. Both constructor + functions, the default and the director one, return the same interface + type. This makes it potentially hard to know which destructor function, + the default or the director one, needs to be called to delete an object + instance.

    +

    In theory the DirectorInterface method could be used + to determine if an object instance was created via +NewDirectorClassName:

    +
    +
    +if o.DirectorInterface() != nil {
    +  DeleteDirectorClassName(o)
    +} else {
    +  DeleteClassName(o)
    +}
    +
    +
    +

    In practice it is strongly recommended to embed a director + object instance in a Go struct so that a director object instance will + be represented as a distinct Go type that subclasses a C++ class. For + this Go type custom constructor and destructor functions take care of + the director constructor and destructor function calls and the + resulting Go class will appear to the user as any other SWIG wrapped + C++ class. More on properly subclassing a C++ class follows later in + this guide under subclass via embedding +.

    +

    23.4.7.4 Override virtual methods +

    +

    In order to override virtual methods on a C++ class with Go methods + the NewDirectorClassName constructor functions receives a +DirectorInterface argument. The methods in the +DirectorInterface are a subset of the public and protected virtual + methods of the C++ class. If the DirectorInterface contains a + method with a matching signature to a virtual method of the C++ class + then the virtual C++ method will be overwritten with the Go method. As + Go doesn't support protected methods all overriden protected virtual + C++ methods will be public in Go.

    +

    As an example see part of the FooBarGo class:

    +
    +
    +type overwrittenMethodsOnFooBarAbstract struct {
    +  fb FooBarAbstract
    +}
    +
    +func (om *overwrittenMethodsOnFooBarAbstract) Foo() string {
    +  ...
    +}
    +
    +func (om *overwrittenMethodsOnFooBarAbstract) Bar() string {
    +  ...
    +}
    +
    +func NewFooBarGo() FooBarGo {
    +  om := &overwrittenMethodsOnFooBarAbstract{}
    +  fb := NewDirectorFooBarAbstract(om)
    +  om.fb = fb
    +  ...
    +}
    +
    +
    +

    The complete example, including the FooBarGoo class + implementation, can be found in +the end of the guide. In this part of the example the virtual + methods FooBarAbstract::Foo and FooBarAbstract::Bar + have been overwritten with Go methods similarly to how the +FooBarAbstract virtual methods are overwritten by the FooBarCpp + class.

    +

    The DirectorInterface in the example is implemented by the +overwrittenMethodsOnFooBarAbstract Go struct type. A pointer to a +overwrittenMethodsOnFooBarAbstract struct instance will be given to + the NewDirectorFooBarAbstract constructor function. The + constructor return value implements the FooBarAbstract + interface. overwrittenMethodsOnFooBarAbstract could in theory + be any Go type but in practice a struct is used as it typically + contains at least a value of the C++ class interface so that the + overwritten methods can use the rest of the C++ class. If the +FooBarGo class would receive additional constructor arguments then + these would also typically be stored in the +overwrittenMethodsOnFooBarAbstract struct so that they can be used + by the Go methods.

    +

    23.4.7.5 Call base methods

    +

    Often a virtual method will be overwritten to extend the original + behavior of the method in the base class. This is also the case for the + FooBarCpp::Foo method of the example code:

    +
    +
    +virtual std::string Foo() {
    +  return "C++ " + FooBarAbstract::Foo();
    +}
    +
    +
    +

    To use base methods the DirectorClassNameMethodName wrapper + functions are automatically generated by SWIG for public and protected + virtual methods. The FooBarGo.Foo implementation in the + example looks like this:

    +
    +
    +func (om *overwrittenMethodsOnFooBarAbstract) Foo() string {
    +  return "Go " + DirectorFooBarAbstractFoo(om.fb)
    +}
    +
    +
    +

    The complete example, including the FooBarGoo class + implementation, can be found in +the end of the guide.

    +

    23.4.7.6 Subclass via embedding

    +

    As previously mentioned in this + guide the default and director constructor functions return the + same interface type. To properly subclass a C++ class with a Go type + the director object instance returned by the NewDirectorClassName + constructor function should be embedded into a Go struct so that it + represents a distinct but compatible type in Go's type system. This Go + struct should be private and the constructor and destructor functions + should instead work with a public interface type so that the Go class + that subclasses a C++ class can be used as a compatible drop in.

    +

    The subclassing part of the FooBarGo class for an example + looks like this:

    +
    +
    +type FooBarGo interface {
    +  FooBarAbstract
    +  deleteFooBarAbstract()
    +  IsFooBarGo()
    +}
    +
    +type fooBarGo struct {
    +  FooBarAbstract
    +}
    +
    +func (fbgs *fooBarGo) deleteFooBarAbstract() {
    +  DeleteDirectorFooBarAbstract(fbgs.FooBarAbstract)
    +}
    +
    +func (fbgs *fooBarGo) IsFooBarGo() {}
    +
    +func NewFooBarGo() FooBarGo {
    +  om := &overwrittenMethodsOnFooBarAbstract{}
    +  fb := NewDirectorFooBarAbstract(om)
    +  om.fb = fb
    +
    +  return &fooBarGo{FooBarAbstract: fb}
    +}
    +
    +func DeleteFooBarGo(fbg FooBarGo) {
    +  fbg.deleteFooBarAbstract()
    +}
    +
    +
    +

    The complete example, including the FooBarGoo class + implementation, can be found in +the end of the guide. In this part of the example the private +fooBarGo struct embeds FooBarAbstract which lets the +fooBarGo Go type "inherit" all the methods of the +FooBarAbstract C++ class by means of embedding. The public +FooBarGo interface type includes the FooBarAbstract + interface and hence FooBarGo can be used as a drop in + replacement for FooBarAbstract while the reverse isn't + possible and would raise a compile time error. Furthemore the + constructor and destructor functions NewFooBarGo and +DeleteFooBarGo take care of all the director specifics and to the + user the class appears as any other SWIG wrapped C++ class.

    +

    23.4.7.7 Memory management with + runtime.SetFinalizer

    +

    In general all guidelines for C++ class + memory management apply as well to director classes. One often + overlooked limitation with runtime.SetFinalizer is that a + finalizer doesn't run in case of a cycle and director classes typically + have a cycle. The cycle in the FooBarGo class is here:

    +
    +
    +type overwrittenMethodsOnFooBarAbstract struct {
    +  fb FooBarAbstract
    +}
    +
    +func NewFooBarGo() FooBarGo {
    +  om := &overwrittenMethodsOnFooBarAbstract{}
    +  fb := NewDirectorFooBarAbstract(om) // fb.v = om
    +  om.fb = fb // Backlink causes cycle as fb.v = om!
    +  ...
    +}
    +
    +
    +

    In order to be able to use runtime.SetFinalizer + nevertheless the finalizer needs to be set on something that isn't in a + cycle and that references the director object instance. In the +FooBarGo class example the FooBarAbstract director + instance can be automatically deleted by setting the finalizer on +fooBarGo:

    +
    +
    +type fooBarGo struct {
    +  FooBarAbstract
    +}
    +
    +type overwrittenMethodsOnFooBarAbstract struct {
    +  fb FooBarAbstract
    +}
    +
    +func NewFooBarGo() FooBarGo {
    +  om := &overwrittenMethodsOnFooBarAbstract{}
    +  fb := NewDirectorFooBarAbstract(om)
    +  om.fb = fb // Backlink causes cycle as fb.v = om!
    +
    +  fbgs := &fooBarGo{FooBarAbstract: fb}
    +  runtime.SetFinalizer(fbgs, FooBarGo.deleteFooBarAbstract)
    +  return fbgs
    +}
    +
    +
    +

    Furthermore if runtime.SetFinalizer is in use either the +DeleteClassName destructor function needs to be removed or the +fooBarGo struct needs additional data to prevent double deletion. + Please read the C++ class memory management + subchapter before using runtime.SetFinalizer to know all of + its gotchas.

    +

    23.4.7.8 Complete FooBarGo + example class

    +

    The complete and annotated FooBarGo class looks like this:

    -type GoClass struct { }
    -func (p *GoClass) VirtualFunction() { }
    -func MakeClass() ClassName {
    -	return NewDirectorClassName(&GoClass{})
    +// FooBarGo is a superset of FooBarAbstract and hence FooBarGo can be used as a
    +// drop in replacement for FooBarAbstract but the reverse causes a compile time
    +// error.
    +type FooBarGo interface {
    +  FooBarAbstract
    +  deleteFooBarAbstract()
    +  IsFooBarGo()
    +}
    +
    +// Via embedding fooBarGo "inherits" all methods of FooBarAbstract.
    +type fooBarGo struct {
    +  FooBarAbstract
    +}
    +
    +func (fbgs *fooBarGo) deleteFooBarAbstract() {
    +  DeleteDirectorFooBarAbstract(fbgs.FooBarAbstract)
    +}
    +
    +// The IsFooBarGo method ensures that FooBarGo is a superset of FooBarAbstract.
    +// This is also how the class hierarchy gets represented by the SWIG generated
    +// wrapper code.  For an instance FooBarCpp has the IsFooBarAbstract and
    +// IsFooBarCpp methods.
    +func (fbgs *fooBarGo) IsFooBarGo() {}
    +
    +// Go type that defines the DirectorInterface. It contains the Foo and Bar
    +// methods that overwrite the respective virtual C++ methods on FooBarAbstract.
    +type overwrittenMethodsOnFooBarAbstract struct {
    +  // Backlink to FooBarAbstract so that the rest of the class can be used by
    +  // the overridden methods.
    +  fb FooBarAbstract
    +
    +  // If additional constructor arguments have been given they are typically
    +  // stored here so that the overriden methods can use them.
    +}
    +
    +func (om *overwrittenMethodsOnFooBarAbstract) Foo() string {
    +  // DirectorFooBarAbstractFoo calls the base method FooBarAbstract::Foo.
    +  return "Go " + DirectorFooBarAbstractFoo(om.fb)
    +}
    +
    +func (om *overwrittenMethodsOnFooBarAbstract) Bar() string {
    +  return "Go Bar"
    +}
    +
    +func NewFooBarGo() FooBarGo {
    +  // Instantiate FooBarAbstract with selected methods overridden.  The methods
    +  // that will be overwritten are defined on
    +  // overwrittenMethodsOnFooBarAbstract and have a compatible signature to the
    +  // respective virtual C++ methods. Furthermore additional constructor
    +  // arguments will be typically stored in the
    +  // overwrittenMethodsOnFooBarAbstract struct.
    +  om := &overwrittenMethodsOnFooBarAbstract{}
    +  fb := NewDirectorFooBarAbstract(om)
    +  om.fb = fb // Backlink causes cycle as fb.v = om!
    +
    +  fbgs := &fooBarGo{FooBarAbstract: fb}
    +  // The memory of the FooBarAbstract director object instance can be
    +  // automatically freed once the FooBarGo instance is garbage collected by
    +  // uncommenting the following line.  Please make sure to understand the
    +  // runtime.SetFinalizer specific gotchas before doing this.  Furthemore
    +  // DeleteFooBarGo should be deleted if a finalizer is in use or the fooBarGo
    +  // struct needs additional data to prevent double deletion.
    +  // runtime.SetFinalizer(fbgs, FooBarGo.deleteFooBarAbstract)
    +  return fbgs
    +}
    +
    +// Recommended to be removed if runtime.SetFinalizer is in use.
    +func DeleteFooBarGo(fbg FooBarGo) {
    +  fbg.deleteFooBarAbstract()
     }
     
    -

    Any call in C++ code to the virtual function will wind up calling - the method defined in Go. The Go code may of course call other methods - on itself, and those methods may be defined either in Go or in C++.

    -

    22.3.8 Default Go primitive - type mappings

    +

    Returned string by the FooBarGo.FooBar method is:

    +
    +
    +Go Foo, Go Bar
    +
    +
    +

    For comparison the FooBarCpp class looks like this:

    +
    +
    +class FooBarCpp : public FooBarAbstract
    +{
    +protected:
    +  virtual std::string Foo() {
    +    return "C++ " + FooBarAbstract::Foo();
    +  }
    +
    +  virtual std::string Bar() {
    +    return "C++ Bar";
    +  }
    +};
    +
    +
    +

    For comparison the returned string by the FooBarCpp::FooBar + method is:

    +
    +
    +C++ Foo, C++ Bar
    +
    +
    +

    The complete source of this example can be found under + SWIG/Examples/go/director/.

    +

    23.4.8 Default Go primitive + type mappings

    The following table lists the default type mapping from C/C++ to Go. This table will tell you which Go type to expect for a function which uses a given C/C++ type.

    @@ -25139,10 +27393,8 @@ func MakeClass() ClassName { unsigned shortuint16 intint unsigned intuint -longint32 or int64, depending on -long-type-size - -unsigned longuint32 or uint64, depending on --long-type-size +longint64 +unsigned longuint64 long longint64 unsigned long longuint64 floatfloat32 @@ -25159,7 +27411,7 @@ func MakeClass() ClassName {

    These type mappings are defined by the "gotype" typemap. You may change that typemap, or add new values, to control how C/C++ types are mapped into Go types.

    -

    22.3.9 Output arguments

    +

    23.4.9 Output arguments

    Because of limitations in the way output arguments are processed in swig, a function with output arguments will not have multiple return values. Instead, you must pass a pointer into the C++ function to tell @@ -25207,8 +27459,8 @@ fraction := modulename.Modf(5.0, ptr) void f(char *output);

    -

    22.3.10 Adding additional go - code

    +

    23.4.10 Adding additional go + code

    Often the APIs generated by swig are not very natural in go, especially if there are output arguments. You can insert additional go wrapping code to add new APIs with %insert(go_wrapper), @@ -25274,14 +27526,93 @@ func (arg SwigcptrWrapped_MyClass) GetAValue() (int, bool) { just a few, then you might as well define your own struct that includes the swig-wrapped object, instead of adding methods to the swig-generated object.

    -

    This only works if your wrappers do not need to import other go - modules. There is at present no way to insert import statements in the - correct place in swig-generated go. If you need to do that, you must - put your go code in a separate file.

    -
    +

    If you need to import other go packages, you can do this with +%go_import. For example,

    +
    +
    +%go_import("fmt", _ "unusedPackage", rp "renamed/package")
    +
    +%insert(go_wrapper) %{
     
    -
    -

    23 SWIG and Guile

    +func foo() { + fmt.Println("Some string:", rp.GetString()) +} + +// Importing the same package twice is permitted, +// Go code will be generated with only the first instance of the import. +%go_import("fmt") + +%insert(go_wrapper) %{ + +func bar() { + fmt.Println("Hello world!") +} + +%} +
    +
    +

    23.4.11 Go typemaps

    +

    You can use the %typemap directive to modify SWIG's default + wrapping behavior for specific C/C++ types. You need to be familiar + with the material in the general "Typemaps" + chapter. That chapter explains how to define a typemap. This section + describes some specific typemaps used for Go.

    +

    In general type conversion code may be written either in C/C++ or in + Go. The choice to make normally depends on where memory should be + allocated. To allocate memory controlled by the Go garbage collector, + write Go code. To allocate memory in the C/C++ heap, write C code.

    + + + + + + + + + + + + + + +
    TypemapDescription
    gotype The Go type to use for a C++ type. This type + will appear in the generated Go wrapper function. If this is not + defined SWIG will use a default as +described above.
    imtype An intermediate Go type used by the "goin", + "goout", "godirectorin", and "godirectorout" typemaps. If this typemap + is not defined for a C/C++ type, the gotype typemape will be used. This + is useful when gotype is best converted to C/C++ using Go code.
    goin Go code to convert from gotype to imtype when + calling a C/C++ function. SWIG will then internally convert imtype to a + C/C++ type and pass it down. If this is not defined, or is the empty + string, no conversion is done.
    in C/C++ code to convert the internally generated C/C++ + type, based on imtype, into the C/C++ type that a function call + expects. If this is not defined the value will simply be cast to the + desired type.
    out C/C++ code to convert the C/C++ type that a + function call returns into the internally generated C/C++ type, based + on imtype, that will be returned to Go. If this is not defined the + value will simply be cast to the desired type.
    goout Go code to convert a value returned from a C/C++ + function from imtype to gotype. If this is not defined, or is the empty + string, no conversion is done.
    argout C/C++ code to adjust an argument value when + returning from a function. This is called after the real C/C++ function + has run. This uses the internally generated C/C++ type, based on + imtype. This is only useful for a pointer type of some sort. If this is + not defined nothing will be done.
    goargout Go code to adjust an argument value when + returning from a function. This is called after the real C/C++ function + has run. The value will be in imtype. This is only useful for a pointer + type of some sort. If this is not defined, or is the empty string, + nothing will be done.
    directorin C/C++ code to convert the C/C++ type used to + call a director method into the internally generated C/C++ type, based + on imtype, that will be passed to Go. If this is not defined the value + will simply be cast to the desired type.
    godirectorin Go code to convert a value used to call a + director method from imtype to gotype. If this is not defined, or is + the empty string, no conversion is done.
    godirectorout Go code to convert a value returned from + a director method from gotype to imtype. If this is not defined, or is + the empty string, no conversion is done.
    directorout C/C++ code to convert a value returned from + a director method from the internally generated C/C++ type, based on + imtype, into the type that the method should return If this is not + defined the value will simply be cast to the desired type.
    +
    +

    24 SWIG and Guile

    @@ -25319,7 +27650,7 @@ func (arg SwigcptrWrapped_MyClass) GetAValue() (int, bool) {

    This section details guile-specific support in SWIG.

    -

    23.1 Supported Guile Versions

    +

    24.1 Supported Guile Versions

    SWIG works with Guile versions 1.8.x and 2.0.x. Support for version 1.6.x has been dropped. The last version of SWIG that still works with Guile version 1.6.x is SWIG 2.0.9.

    @@ -25327,11 +27658,11 @@ func (arg SwigcptrWrapped_MyClass) GetAValue() (int, bool) { for improved performance. This is currently not tested with swig so your mileage may vary. To be safe set environment variable GUILE_AUTO_COMPILE to 0 when using swig generated guile code.

    -

    23.2 Meaning of "Module"

    +

    24.2 Meaning of "Module"

    There are three different concepts of "module" involved, defined separately for SWIG, Guile, and Libtool. To avoid horrible confusion, we explicitly prefix the context, e.g., "guile-module".

    -

    23.3 Old GH Guile API

    +

    24.3 Old GH Guile API

    Guile 1.8 and older could be interfaced using two different api's, the SCM or the GH API. The GH interface to guile is deprecated. Read more about why in the @@ -25340,12 +27671,12 @@ Guile manual.

    from SWIG. The last version of SWIG that can still generate guile GH wrapper code is 2.0.9. Please use that version if you really need the GH wrapper code.

    -

    23.4 Linkage

    +

    24.4 Linkage

    Guile support is complicated by a lack of user community cohesiveness, which manifests in multiple shared-library usage conventions. A set of policies implementing a usage convention is called a linkage.

    -

    23.4.1 Simple Linkage

    +

    24.4.1 Simple Linkage

    The default linkage is the simplest; nothing special is done. In this case the function SWIG_init() is exported. Simple linkage can be used in several ways:

    @@ -25395,8 +27726,8 @@ inner_main() function. See the "simple" and "matrix"
     (module-map (lambda (sym var)
    -	      (module-export! (current-module) (list sym)))
    -	    (current-module))
    +              (module-export! (current-module) (list sym)))
    +            (current-module))
     

    SWIG can also generate this Scheme stub (from define-module @@ -25422,13 +27753,13 @@ export form.)

    If you want to include several SWIG modules, you would need to rename SWIG_init via a preprocessor define to avoid symbol clashes. For this case, however, passive linkage is available.

    -

    23.4.2 Passive Linkage

    +

    24.4.2 Passive Linkage

    Passive linkage is just like simple linkage, but it generates an initialization function whose name is derived from the module and package name (see below).

    You should use passive linkage rather than simple linkage when you are using multiple modules.

    -

    23.4.3 Native Guile Module Linkage

    +

    24.4.3 Native Guile Module Linkage

    SWIG can also generate wrapper code that does all the Guile module declarations on its own if you pass it the -Linkage module command-line option.

    @@ -25459,7 +27790,7 @@ inner_main() function. -

    23.4.4 Old Auto-Loading Guile Module Linkage

    +

    24.4.4 Old Auto-Loading Guile Module Linkage

    Guile used to support an autoloading facility for object-code modules. This support has been marked deprecated in version 1.4.1 and is going to disappear sooner or later. SWIG still supports building @@ -25478,7 +27809,7 @@ scm_init_my_modules_foo_module,

    When invoked with the -Linkage ltdlmod command-line option, SWIG generates an exported module initialization function with an appropriate name.

    -

    23.4.5 Hobbit4D Linkage

    +

    24.4.5 Hobbit4D Linkage

    The only other linkage supported at this time creates shared object libraries suitable for use by hobbit's (hobbit4d link) guile module. This is called the "hobbit" linkage, and requires also @@ -25494,14 +27825,14 @@ swig -guile -package my/lib -module foo foo.i case foo.i declares the module to be "foo"). The installed files are my/lib/libfoo.so.X.Y.Z and friends. This scheme is still very experimental; the (hobbit4d link) conventions are not well understood.

    -

    23.5 Underscore Folding

    +

    24.5 Underscore Folding

    Underscores are converted to dashes in identifiers. Guile support may grow an option to inhibit this folding in the future, but no one has complained so far.

    You can use the SWIG directives %name and %rename to specify the Guile name of the wrapped functions and variables (see CHANGES).

    -

    23.6 Typemaps

    +

    24.6 Typemaps

    The Guile module handles all types via typemaps. This information is read from Lib/guile/typemaps.i. Some non-standard typemap substitutions are supported:

    @@ -25568,7 +27899,7 @@ receive. The latter is available if you issue (use-modules must be called, the constant will appear as a scheme variable. See Features and the %feature directive for info on how to apply the %feature.

    -

    23.7 Representation of pointers as smobs

    +

    24.7 Representation of pointers as smobs

    For pointer types, SWIG uses Guile smobs. SWIG smobs print like this: #<swig struct xyzzy * 0x1234affe> Two of them are equal? if and only if they have the same type and value.

    @@ -25582,7 +27913,7 @@ SWIG_ConvertPtr()
    , passing a pointer to a struct representing the The run-time type checker. If the Scheme object passed was not a SWIG smob representing a compatible pointer, a wrong-type-arg exception is raised.

    -

    23.7.1 Smobs

    +

    24.7.1 Smobs

    In earlier versions of SWIG, C pointers were represented as Scheme strings containing a hexadecimal rendering of the pointer value and a mangled type name. As Guile allows registering user types, so-called @@ -25596,7 +27927,7 @@ The run-time type checker. If the Scheme object passed was not a object and the second word of data is the swig_type_info * structure describing this type. If a generated GOOPS module has been loaded, smobs will be wrapped by the corresponding GOOPS class.

    -

    23.7.2 Garbage Collection

    +

    24.7.2 Garbage Collection

    Garbage collection is a feature of Guile since version 1.6. As SWIG now requires Guile > 1.8, it is automatically included. Garbage collection works like this. Every swig_type_info structure stores in @@ -25610,25 +27941,25 @@ The run-time type checker. If the Scheme object passed was not a Object ownership and %newobject in the SWIG manual. All typemaps use an $owner var, and the guile module replaces $owner with 0 or 1 depending on feature:new.

    -

    23.8 Exception Handling

    +

    24.8 Exception Handling

    SWIG code calls scm_error on exception, using the following mapping:

    -      MAP(SWIG_MemoryError,	"swig-memory-error");
    -      MAP(SWIG_IOError,		"swig-io-error");
    -      MAP(SWIG_RuntimeError,	"swig-runtime-error");
    -      MAP(SWIG_IndexError,	"swig-index-error");
    -      MAP(SWIG_TypeError,	"swig-type-error");
    -      MAP(SWIG_DivisionByZero,	"swig-division-by-zero");
    -      MAP(SWIG_OverflowError,	"swig-overflow-error");
    -      MAP(SWIG_SyntaxError,	"swig-syntax-error");
    -      MAP(SWIG_ValueError,	"swig-value-error");
    -      MAP(SWIG_SystemError,	"swig-system-error");
    +      MAP(SWIG_MemoryError,     "swig-memory-error");
    +      MAP(SWIG_IOError,         "swig-io-error");
    +      MAP(SWIG_RuntimeError,    "swig-runtime-error");
    +      MAP(SWIG_IndexError,      "swig-index-error");
    +      MAP(SWIG_TypeError,       "swig-type-error");
    +      MAP(SWIG_DivisionByZero,  "swig-division-by-zero");
    +      MAP(SWIG_OverflowError,   "swig-overflow-error");
    +      MAP(SWIG_SyntaxError,     "swig-syntax-error");
    +      MAP(SWIG_ValueError,      "swig-value-error");
    +      MAP(SWIG_SystemError,     "swig-system-error");
     

    The default when not specified here is to use "swig-error". See Lib/exception.i for details.

    -

    23.9 Procedure documentation

    +

    24.9 Procedure documentation

    If invoked with the command-line option -procdoc file , SWIG creates documentation strings for the generated wrapper functions, describing the procedure signature and return value, and @@ -25656,7 +27987,7 @@ The run-time type checker. If the Scheme object passed was not a

    Documentation strings can be configured using the Guile-specific typemap argument doc. See Lib/guile/typemaps.i for details.

    -

    23.10 Procedures with setters

    +

    24.10 Procedures with setters

    For global variables, SWIG creates a single wrapper procedure ( variable :optional value), which is used for both getting and setting the value. For struct members, SWIG creates two wrapper @@ -25678,7 +28009,7 @@ variable is created, so you can use (variable struct members, the procedures (struct-member -get pointer) and (struct-member-set pointer value) are not generated.

    -

    23.11 GOOPS Proxy Classes

    +

    24.11 GOOPS Proxy Classes

    SWIG can also generate classes and generic functions for use with Guile's Object-Oriented Programming System (GOOPS). GOOPS is a sophisticated object system in the spirit of the Common Lisp Object @@ -25816,7 +28147,7 @@ module.scm file in the directory specified by -outdir or the

    Notice that <Foo> is used before it is defined. The fix is to just put the %import "foo.h" before the %inline block.

    -

    23.11.1 Naming Issues

    +

    24.11.1 Naming Issues

    As you can see in the example above, there are potential naming conflicts. The default exported accessor for the Foo::a variable is named a. The name of the wrapper global @@ -25856,7 +28187,7 @@ Test-primitive.scm. The string "primitive" can be changed by th (use-modules ((Test) #:renamer (symbol-prefix-proc 'goops:))) -

    23.11.2 Linking

    +

    24.11.2 Linking

    The guile-modules generated above all need to be linked together. GOOPS support requires either passive or module linkage. The exported GOOPS guile-module will be the name of the swig-module and should be @@ -25982,7 +28313,7 @@ mod2 uses symbols from mod1, the mod2 future SWIG can detect dependencies and export this line. (how do other language modules handle this problem?)


    -

    24 SWIG and Java

    +

    25 SWIG and Java

    @@ -26038,7 +28369,13 @@ mod2 uses symbols from mod1, the mod2
  • C++ default arguments
  • C++ namespaces
  • C++ templates
  • -
  • C++ Smart Pointers
  • +
  • C++ Smart Pointers + +
  • Further details on the generated @@ -26077,6 +28414,7 @@ mod2 uses symbols from mod1, the mod2
  • +
  • Interfaces
  • Cross language polymorphism using @@ -26089,6 +28427,8 @@ mod2 uses symbols from mod1, the mod2
  • Director threading issues
  • Director performance tuning
  • +
  • Java exceptions from + directors
  • Accessing protected members
  • @@ -26180,7 +28520,7 @@ mod2 uses symbols from mod1, the mod2

    This chapter describes SWIG's support of Java. It covers most SWIG features, but certain low-level details are covered in less depth than in earlier chapters.

    -

    24.1 Overview

    +

    25.1 Overview

    The 100% Pure Java effort is a commendable concept, however in the real world programmers often either need to re-use their existing code or in some situations want to take advantage of Java but are forced @@ -26220,7 +28560,7 @@ tour of basic C/C++ wrapping section which explains how to call the directives are covered. The latter sections cover the advanced techniques of using typemaps for complete control of the wrapping process.

    -

    24.2 Preliminaries

    +

    25.2 Preliminaries

    SWIG 1.1 works with JDKs from JDK 1.1 to JDK1.4 (Java 2 SDK1.4) and should also work with any later versions. Given the choice, you should probably use the latest version of Sun's JDK. The SWIG Java module is @@ -26236,10 +28576,10 @@ tour of basic C/C++ wrapping section which explains how to call the

    The Java module requires your system to support shared libraries and dynamic loading. This is the commonly used method to load JNI code so your system will more than likely support this.

    -

    Android uses Java JNI and also works with SWIG. Please read the +

    Android uses Java JNI and also works with SWIG. Please read the Android chapter in conjunction with this one if you are targeting Android.

    -

    24.2.1 Running SWIG

    +

    25.2.1 Running SWIG

    Suppose that you defined a SWIG module such as the following:

    @@ -26282,7 +28622,7 @@ later. Note that the module name does not define a Java package and
      use.

    The following sections have further practical examples and details on how you might go about compiling and using the generated files.

    -

    24.2.2 Additional Commandline Options

    +

    25.2.2 Additional Commandline Options

    The following table list the additional commandline options available for the Java module. They can also be seen by using:

    @@ -26301,8 +28641,8 @@ swig -java -help

    Their use will become clearer by the time you have finished reading this section on SWIG and Java.

    -

    24.2.3 Getting the right - header files

    +

    25.2.3 Getting the right header + files

    In order to compile the C/C++ wrappers, the compiler needs the jni.h and jni_md.h header files which are part of the JDK. They are usually in directories like this:

    @@ -26314,8 +28654,8 @@ jni.h and jni_md.h header files which are part of the JDK.

    The exact location may vary on your machine, but the above locations are typical.

    -

    24.2.4 Compiling a dynamic - module

    +

    25.2.4 Compiling a dynamic module +

    The JNI code exists in a dynamic module or shared library (DLL on Windows) and gets loaded by the JVM. Assuming you have code you need to link to in a file called example.c, in order to build a shared @@ -26324,8 +28664,8 @@ jni.h and jni_md.h header files which are part of the JDK.

     $ swig -java example.i
    -$ gcc -c example_wrap.c  -I/usr/java/include -I/usr/java/include/solaris
    -$ gcc -c example.c
    +$ gcc -fPIC -c example_wrap.c -I/usr/java/include -I/usr/java/include/solaris
    +$ gcc -fPIC -c example.c
     $ ld -G example_wrap.o example.o -o libexample.so
     
    @@ -26335,9 +28675,7 @@ $ ld -G example_wrap.o example.o -o libexample.so Examples/java directory. If that doesn't work, you will need to read the man-pages for your compiler and linker to get the right set of options. You might also check the -SWIG Wiki for additional information. -JNI compilation is a useful reference for compiling on different - platforms.

    +SWIG Wiki for additional information.

    Important
    If you are going to use optimisations turned on with gcc (for example -O2), ensure you also compile with -fno-strict-aliasing. The @@ -26352,7 +28690,7 @@ JNI compilation is a useful reference for compiling on different Dynamic linking problems for more information). The name of the module is specified using the %module directive or -module command line option.

    -

    24.2.5 Using your module

    +

    25.2.5 Using your module

    To load your shared native library module in Java, simply use Java's System.loadLibrary method in a Java class:

    @@ -26381,8 +28719,8 @@ $

    If it doesn't work have a look at the following section which discusses problems loading the shared library.

    -

    24.2.6 Dynamic linking - problems

    +

    25.2.6 Dynamic linking + problems

    As shown in the previous section the code to load a native library (shared library) is System.loadLibrary("name"). This can fail with an UnsatisfiedLinkError exception and can be due to a number of @@ -26445,9 +28783,9 @@ $

     $ java runme
     Exception in thread "main" java.lang.UnsatisfiedLinkError: exampleJNI.gcd(II)I
    -	at exampleJNI.gcd(Native Method)
    -	at example.gcd(example.java:12)
    -	at runme.main(runme.java:18)
    +        at exampleJNI.gcd(Native Method)
    +        at example.gcd(example.java:12)
    +        at runme.main(runme.java:18)
     

    where gcd is the missing JNI function that SWIG generated @@ -26465,16 +28803,15 @@ Exception in thread "main" java.lang.UnsatisfiedLinkError: exampleJNI. SWIG Wiki also has some settings for commonly used compiler and operating system combinations. The following section also contains some C++ specific linking problems and solutions.

    -

    24.2.7 Compilation - problems and compiling with C++

    +

    25.2.7 Compilation problems + and compiling with C++

    On most machines, shared library files should be linked using the C++ compiler. For example:

     % swig -c++ -java example.i
     % g++ -c -fpic example.cxx
    -% g++ -c -fpic example_wrap.cxx -I/usr/java/j2sdk1.4.1/include -I/usr/java/
    -j2sdk1.4.1/include/linux
    +% g++ -c -fpic example_wrap.cxx -I/usr/java/j2sdk1.4.1/include -I/usr/java/j2sdk1.4.1/include/linux
     % g++ -shared example.o example_wrap.o -o libexample.so
     
    @@ -26508,15 +28845,15 @@ $

    Finally make sure the version of JDK header files matches the version of Java that you are running as incompatibilities could lead to compilation problems or unpredictable behaviour.

    -

    24.2.8 Building on Windows

    +

    25.2.8 Building on Windows

    Building on Windows is roughly similar to the process used with Unix. You will want to produce a DLL that can be loaded by the Java Virtual Machine. This section covers the process of using SWIG with Microsoft Visual C++ 6 although the procedure may be similar with other compilers. In order for everything to work, you will need to have a JDK installed on your machine in order to read the JNI header files.

    -

    24.2.8.1 Running SWIG from Visual - Studio

    +

    25.2.8.1 Running SWIG from Visual + Studio

    If you are developing your application within Microsoft Visual studio, SWIG can be invoked as a custom build option. The Examples\java directory has a few Windows Examples @@ -26565,7 +28902,7 @@ _wrap.c in the instructions above and add -c++ when invoking swig.

    as described in the previous section. If the library fails to load have a look at Dynamic linking problems.

    -

    24.2.8.2 Using NMAKE

    +

    25.2.8.2 Using NMAKE

    Alternatively, a Makefile for use by NMAKE can be written. Make sure the environment variables for MSVC++ are available and the MSVC++ tools are in your path. Now, just write a short Makefile like this :

    @@ -26607,11 +28944,11 @@ CFLAGS = /Z7 /Od /c /nologo JAVA_INCLUDE = -ID:\jdk1.3\include -ID:\jdk1.3\include\win32 java:: - swig -java -o $(WRAPFILE) $(INTERFACE) - $(CC) $(CFLAGS) $(JAVA_INCLUDE) $(SRCS) $(WRAPFILE) - set LIB=$(TOOLS)\lib - $(LINK) $(LOPT) -out:example.dll $(LIBS) example.obj example_wrap.obj - javac *.java + swig -java -o $(WRAPFILE) $(INTERFACE) + $(CC) $(CFLAGS) $(JAVA_INCLUDE) $(SRCS) $(WRAPFILE) + set LIB=$(TOOLS)\lib + $(LINK) $(LOPT) -out:example.dll $(LIBS) example.obj example_wrap.obj + javac *.java

    To build the DLL and compile the java code, run NMAKE (you may need @@ -26619,14 +28956,14 @@ java:: but hopefully its enough to get you started. Of course you may want to make changes for it to work for C++ by adding in the -c++ command line switch for swig and replacing .c with .cxx.

    -

    24.3 A tour of basic C/C++ wrapping

    +

    25.3 A tour of basic C/C++ wrapping

    By default, SWIG attempts to build a natural Java interface to your C/C++ code. Functions are wrapped as functions, classes are wrapped as classes, variables are wrapped with JavaBean type getters and setters and so forth. This section briefly covers the essential aspects of this wrapping.

    -

    24.3.1 Modules, packages - and generated Java classes

    +

    25.3.1 Modules, packages and + generated Java classes

    The SWIG %module directive specifies the name of the Java module. When you specify `%module example', the module name determines the name of some of the generated files in the module. The @@ -26658,7 +28995,7 @@ swig -java -package com.bloggs.swig -outdir com/bloggs/swig example.i

    SWIG won't create the directory, so make sure it exists beforehand.

    -

    24.3.2 Functions

    +

    25.3.2 Functions

    There is no such thing as a global Java function so global C functions are wrapped as static methods in the module class. For example,

    @@ -26687,7 +29024,7 @@ public class example { System.out.println(example.fact(4)); -

    24.3.3 Global variables

    +

    25.3.3 Global variables

    C/C++ global variables are fully supported by SWIG. Java does not allow the overriding of the dot operator so all variables are accessed through getters and setters. Again because there is no such thing as a @@ -26757,7 +29094,7 @@ extern char *path; extern char *path; // Read-only (due to %immutable) -

    24.3.4 Constants

    +

    25.3.4 Constants

    C/C++ constants are wrapped as Java static final variables. To create a constant, use #define or the %constant directive. For example:

    @@ -26887,7 +29224,7 @@ public class example implements exampleConstants { example.EXPRESSION or exampleConstants.EXPRESSION. Or if you decide this practice isn't so bad and your own class implements exampleConstants, you can of course just use EXPRESSION.

    -

    24.3.5 Enumerations

    +

    25.3.5 Enumerations

    SWIG handles both named and unnamed (anonymous) enumerations. There is a choice of approaches to wrapping named C/C++ enums. This is due to historical reasons as SWIG's initial support for enums was limited and @@ -26899,7 +29236,7 @@ exampleConstants, you can of course just use EXPRESSION.

    final two approaches use simple integers for each enum item. Before looking at the various approaches for wrapping named C/C++ enums, anonymous enums are considered.

    -

    24.3.5.1 Anonymous enums

    +

    25.3.5.1 Anonymous enums

    There is no name for anonymous enums and so they are handled like constants. For example:

    @@ -26952,7 +29289,7 @@ public interface exampleConstants {

    As in the case of constants, you can access them through either the module class or the constants interface, for example, example.ALE or exampleConstants.ALE.

    -

    24.3.5.2 Typesafe enums

    +

    25.3.5.2 Typesafe enums

    This is the default approach to wrapping named enums. The typesafe enum pattern is a relatively well known construct to work around the lack of enums in versions of Java prior to JDK 1.5. It basically @@ -27034,7 +29371,7 @@ Java Tip 122: Beware of Java typesafe enumerations JavaWorld tips.

    1.5 or later, proper Java enums could be used instead, without users having to change their code. The following section details proper Java enum generation.

    -

    24.3.5.3 Proper Java enums

    +

    25.3.5.3 Proper Java enums

    Proper Java enums were only introduced in JDK 1.5 so this approach is only compatible with more recent versions of Java. Java enums have been designed to overcome all the limitations of both typesafe and type @@ -27079,7 +29416,7 @@ Constants section can also be used for proper Java enums.

    The additional support methods need not be generated if none of the enum items have initializers and this is covered later in the Simpler Java enums for enums without initializers section.

    -

    24.3.5.4 Type unsafe enums

    +

    25.3.5.4 Type unsafe enums

    In this approach each enum item in a named enumeration is wrapped as a static final integer in a class named after the C/C++ enum name. This is a commonly used pattern in Java to simulate C/C++ enums, but it is @@ -27089,5595 +29426,7193 @@ Simpler Java enums for enums without initializers section.

    look at an example.

    -%include "enumtypeunsafe.swg"
    -%javaconst(1);
    -enum Beverage { ALE, LAGER=10, STOUT, PILSNER, PILZ=PILSNER };
    +%include "enumtypeunsafe.swg"
    +%javaconst(1);
    +enum Beverage { ALE, LAGER=10, STOUT, PILSNER, PILZ=PILSNER };
    +
    +
    +

    will generate:

    +
    +
    +public final class Beverage {
    +  public final static int ALE = 0;
    +  public final static int LAGER = 10;
    +  public final static int STOUT = LAGER + 1;
    +  public final static int PILSNER = STOUT + 1;
    +  public final static int PILZ = PILSNER;
    +}
    +
    +
    +

    As is the case previously, the default is %javaconst(0) as + not all C/C++ values will compile as Java code. However, again it is + recommended to add in a %javaconst(1) directive. and the +%javaconstvalue(value) directive covered in the +Constants section can also be used for type unsafe enums. Note that + global enums are generated into a Java class within whatever package + you are using. C++ enums defined within a C++ class are generated into + a static final inner Java class within the Java proxy class.

    +

    Note that unlike typesafe enums, this approach requires users to + mostly use different syntax compared with proper Java enums. Thus the + upgrade path to proper enums provided in JDK 1.5 is more painful.

    +

    25.3.5.5 Simple enums

    +

    This approach is similar to the type unsafe approach. Each enum item + is also wrapped as a static final integer. However, these integers are + not generated into a class named after the C/C++ enum. Instead, global + enums are generated into the constants interface. Also, enums defined + in a C++ class have their enum items generated directly into the Java + proxy class rather than an inner class within the Java proxy class. In + fact, this approach is effectively wrapping the enums as if they were + anonymous enums and the resulting code is as per +anonymous enums. The implementation is in the "enumsimple.swg" file.

    +

    Compatibility Note: SWIG-1.3.21 and earlier versions wrapped + all enums using this approach. The type unsafe approach is preferable + to this one and this simple approach is only included for backwards + compatibility with these earlier versions of SWIG.

    +

    25.3.6 Pointers

    +

    C/C++ pointers are fully supported by SWIG. Furthermore, SWIG has no + problem working with incomplete type information. Here is a rather + simple interface:

    +
    +
    +%module example
    +
    +FILE *fopen(const char *filename, const char *mode);
    +int fputs(const char *, FILE *);
    +int fclose(FILE *);
    +
    +
    +

    When wrapped, you will be able to use the functions in a natural way + from Java. For example:

    +
    +
    +SWIGTYPE_p_FILE f = example.fopen("junk","w");
    +example.fputs("Hello World\n", f);
    +example.fclose(f);
    +
    +
    +

    C pointers in the Java module are stored in a Java long and + cross the JNI boundary held within this 64 bit number. Many other SWIG + language modules use an encoding of the pointer in a string. These + scripting languages use the SWIG runtime type checker for dynamic type + checking as they do not support static type checking by a compiler. In + order to implement static type checking of pointers within Java, they + are wrapped by a simple Java class. In the example above the FILE * + pointer is wrapped with a type wrapper class called +SWIGTYPE_p_FILE.

    +

    Once obtained, a type wrapper object can be freely passed around to + different C functions that expect to receive an object of that type. + The only thing you can't do is dereference the pointer from Java. Of + course, that isn't much of a concern in this example.

    +

    As much as you might be inclined to modify a pointer value directly + from Java, don't. The value is not necessarily the same as the logical + memory address of the underlying object. The value will vary depending + on the native byte-ordering of the platform (i.e., big-endian vs. + little-endian). Most JVMs are 32 bit applications so any JNI code must + also be compiled as 32 bit. The net result is pointers in JNI code are + also 32 bits and are stored in the high order 4 bytes on big-endian + machines and in the low order 4 bytes on little-endian machines. By + design it is also not possible to manually cast a pointer to a new type + by using Java casts as it is particularly dangerous especially when + casting C++ objects. If you need to cast a pointer or change its value, + consider writing some helper functions instead. For example:

    +
    +
    +%inline %{
    +/* C-style cast */
    +Bar *FooToBar(Foo *f) {
    +   return (Bar *) f;
    +}
    +
    +/* C++-style cast */
    +Foo *BarToFoo(Bar *b) {
    +   return dynamic_cast<Foo*>(b);
    +}
    +
    +Foo *IncrFoo(Foo *f, int i) {
    +    return f+i;
    +}
    +%}
    +
    +
    +

    Also, if working with C++, you should always try to use the new C++ + style casts. For example, in the above code, the C-style cast may + return a bogus result whereas as the C++-style cast will return a NULL + pointer if the conversion can't be performed.

    +

    25.3.7 Structures

    +

    If you wrap a C structure, it is wrapped by a Java class with + getters and setters for access to the member variables. For example,

    +
    +
    +struct Vector {
    +  double x,y,z;
    +};
    +
    +
    +
    +

    is used as follows:

    +
    +
    +Vector v = new Vector();
    +v.setX(3.5);
    +v.setY(7.2);
    +double x = v.getX();
    +double y = v.getY();
    +
    +
    +

    The variable setters and getters are also based on the JavaBean + design pattern already covered under the Global variables section. + Similar access is provided for unions and the public data members of + C++ classes.

    +

    This object is actually an instance of a Java class that has been + wrapped around a pointer to the C structure. This instance doesn't + actually do anything--it just serves as a proxy. The pointer to the C + object is held in the Java proxy class in much the same way as pointers + are held by type wrapper classes. Further details about Java proxy + classes are covered a little later.

    +

    const members of a structure are read-only. Data members + can also be forced to be read-only using the %immutable + directive. For example:

    +
    +
    +struct Foo {
    +   ...
    +   %immutable;
    +   int x;        /* Read-only members */
    +   char *name;
    +   %mutable;
    +   ...
    +};
    +
    +
    +

    When char * members of a structure are wrapped, the + contents are assumed to be dynamically allocated using malloc + or new (depending on whether or not SWIG is run with the -c++ + option). When the structure member is set, the old contents will be + released and a new value created. If this is not the behavior you want, + you will have to use a typemap (described later).

    +

    If a structure contains arrays, access to those arrays is managed + through pointers. For example, consider this:

    +
    +
    +struct Bar {
    +    int  x[16];
    +};
    +
    +
    +

    If accessed in Java, you will see behavior like this:

    +
    +
    +Bar b = new Bar();
    +SWIGTYPE_p_int x = b.getX();
    +
    +
    +

    This pointer can be passed around to functions that expect to + receive an int * (just like C). You can also set the value of + an array member using another pointer. For example:

    +
    +
    +Bar b = new Bar();
    +SWIGTYPE_p_int x = b.getX();
    +Bar c = new Bar();
    +c.setX(x);                    // Copy contents of b.x to c.x
    +
    +
    +

    For array assignment (setters not getters), SWIG copies the entire + contents of the array starting with the data pointed to by b.x +. In this example, 16 integers would be copied. Like C, SWIG makes no + assumptions about bounds checking---if you pass a bad pointer, you may + get a segmentation fault or access violation. The default wrapping + makes it hard to set or get just one element of the array and so array + access from Java is somewhat limited. This can be changed easily though + by using the approach outlined later in the +Wrapping C arrays with Java arrays and +Unbounded C Arrays sections.

    +

    When a member of a structure is itself a structure, it is handled as + a pointer. For example, suppose you have two structures like this:

    +
    +
    +struct Foo {
    +   int a;
    +};
    +
    +struct Bar {
    +   Foo f;
    +};
    +
    +
    +

    Now, suppose that you access the f member of Bar + like this:

    +
    +
    +Bar b = new Bar();
    +Foo x = b.getF();
    +
    +
    +

    In this case, x is a pointer that points to the Foo + that is inside b. This is the same value as generated by this + C code:

    +
    +
    +Bar b;
    +Foo *x = &b->f;       /* Points inside b */
    +
    +
    +

    Because the pointer points inside the structure, you can modify the + contents and everything works just like you would expect. For example:

    +
    +
    +Bar b = new Bar();
    +b.getF().setA(3);   // Modify b.f.a
    +Foo x = b.getF();                   
    +x.setA(3);          // Modify x.a - this is the same as b.f.a
    +
    +
    +

    25.3.8 C++ classes

    +

    C++ classes are wrapped by Java classes as well. For example, if you + have this class,

    +
    +
    +class List {
    +public:
    +  List();
    +  ~List();
    +  int  search(char *item);
    +  void insert(char *item);
    +  void remove(char *item);
    +  char *get(int n);
    +  int  length;
    +};
    +
    +
    +

    you can use it in Java like this:

    +
    +
    +List l = new List();
    +l.insert("Ale");
    +l.insert("Stout");
    +l.insert("Lager");
    +String item = l.get(2);
    +int length = l.getLength();
    +
    +
    +

    Class data members are accessed in the same manner as C structures.

    +

    Static class members are unsurprisingly wrapped as static members of + the Java class:

    +
    +
    +class Spam {
    +public:
    +   static void foo();
    +   static int bar;
    +};
    +
    +
    +

    The static members work like any other Java static member:

    +
    +
    +Spam.foo();
    +int bar = Spam.getBar();
    +
    +
    +

    25.3.9 C++ inheritance

    +

    SWIG is fully aware of issues related to C++ inheritance. Therefore, + if you have classes like this

    +
    +
    +class Foo {
    +...
    +};
    +
    +class Bar : public Foo {
    +...
    +};
    +
    +
    +

    those classes are wrapped into a hierarchy of Java classes that + reflect the same inheritance structure:

    +
    +
    +Bar b = new Bar();
    +Class c = b.getClass();
    +System.out.println(c.getSuperclass().getName());
    +
    +
    +

    will of course display:

    +
    +
    +Foo
    +
    +
    +

    Furthermore, if you have functions like this

    +
    +
    +void spam(Foo *f);
    +
    +
    +

    then the Java function spam() accepts instances of Foo + or instances of any other proxy classes derived from Foo.

    +

    Note that Java does not support multiple inheritance so any multiple + inheritance in the C++ code is not going to work. A warning is given + when multiple inheritance is detected and only the first base class is + used.

    +

    25.3.10 Pointers, references, + arrays and pass by value

    +

    In C++, there are many different ways a function might receive and + manipulate objects. For example:

    +
    +
    +void spam1(Foo *x);      // Pass by pointer
    +void spam2(Foo &x);      // Pass by reference
    +void spam3(Foo x);       // Pass by value
    +void spam4(Foo x[]);     // Array of objects
    +
    +
    +

    In Java, there is no detailed distinction like this--specifically, + there are only instances of classes. There are no pointers nor + references. Because of this, SWIG unifies all of these types together + in the wrapper code. For instance, if you actually had the above + functions, it is perfectly legal to do this from Java:

    +
    +
    +Foo f = new Foo();  // Create a Foo
    +example.spam1(f);   // Ok. Pointer
    +example.spam2(f);   // Ok. Reference
    +example.spam3(f);   // Ok. Value.
    +example.spam4(f);   // Ok. Array (1 element)
    +
    +
    +

    Similar behavior occurs for return values. For example, if you had + functions like this,

    +
    +
    +Foo *spam5();
    +Foo &spam6();
    +Foo  spam7();
    +
    +
    +

    then all three functions will return a pointer to some Foo + object. Since the third function (spam7) returns a value, newly + allocated memory is used to hold the result and a pointer is returned + (Java will release this memory when the returned object's finalizer is + run by the garbage collector).

    +

    25.3.10.1 Null pointers

    +

    Working with null pointers is easy. A Java null can be used + whenever a method expects a proxy class or typewrapper class. However, + it is not possible to pass null to C/C++ functions that take parameters + by value or by reference. If you try you will get a + NullPointerException.

    +
    +
    +example.spam1(null);   // Pointer - ok
    +example.spam2(null);   // Reference - NullPointerException
    +example.spam3(null);   // Value - NullPointerException
    +example.spam4(null);   // Array - ok
    +
    +
    +

    For spam1 and spam4 above the Java null + gets translated into a NULL pointer for passing to the C/C++ function. + The converse also occurs, that is, NULL pointers are translated into +null Java objects when returned from a C/C++ function.

    +

    25.3.11 C++ overloaded functions +

    +

    C++ overloaded functions, methods, and constructors are mostly + supported by SWIG. For example, if you have two functions like this:

    +
    +
    +%module example
    +
    +void foo(int);
    +void foo(char *c);
    +
    +
    +

    You can use them in Java in a straightforward manner:

    +
    +
    +example.foo(3);           // foo(int)
    +example.foo("Hello");     // foo(char *c)
    +
    +
    +

    Similarly, if you have a class like this,

    +
    +
    +class Foo {
    +public:
    +    Foo();
    +    Foo(const Foo &);
    +    ...
    +};
    +
    +
    +

    you can write Java code like this:

    +
    +
    +Foo f = new Foo();        // Create a Foo
    +Foo g = new Foo(f);       // Copy f
    +
    +
    +

    Overloading support is not quite as flexible as in C++. Sometimes + there are methods that SWIG cannot disambiguate as there can be more + than one C++ type mapping onto a single Java type. For example:

    +
    +
    +void spam(int);
    +void spam(unsigned short);
    +
    +
    +

    Here both int and unsigned short map onto a Java int. Here is + another example:

    +
    +
    +void foo(Bar *b);
    +void foo(Bar &b);
    +
    +
    +

    If declarations such as these appear, you will get a warning message + like this:

    +
    +
    +example.i:12: Warning 515: Overloaded method spam(unsigned short) ignored.
    +Method spam(int) at example.i:11 used.
    +
    +
    +

    To fix this, you either need to either +rename or ignore one of the methods. For example:

    +
    +
    +%rename(spam_ushort) spam(unsigned short);
    +...
    +void spam(int);    
    +void spam(unsigned short);   // Now renamed to spam_ushort
    +
    +
    +

    or

    +
    +
    +%ignore spam(unsigned short);
    +...
    +void spam(int);    
    +void spam(unsigned short);   // Ignored
    +
    +
    +

    25.3.12 C++ default arguments

    +

    Any function with a default argument is wrapped by generating an + additional function for each argument that is defaulted. For example, + if we have the following C++:

    +
    +
    +%module example
    +
    +void defaults(double d=10.0, int i=0);
     
    -

    will generate:

    +

    The following methods are generated in the Java module class:

    -public final class Beverage {
    -  public final static int ALE = 0;
    -  public final static int LAGER = 10;
    -  public final static int STOUT = LAGER + 1;
    -  public final static int PILSNER = STOUT + 1;
    -  public final static int PILZ = PILSNER;
    +public class example {
    +  public static void defaults(double d, int i) { ... }
    +  public static void defaults(double d) { ... }
    +  public static void defaults() { ... }
     }
     
    -

    As is the case previously, the default is %javaconst(0) as - not all C/C++ values will compile as Java code. However, again it is - recommended to add in a %javaconst(1) directive. and the -%javaconstvalue(value) directive covered in the -Constants section can also be used for type unsafe enums. Note that - global enums are generated into a Java class within whatever package - you are using. C++ enums defined within a C++ class are generated into - a static final inner Java class within the Java proxy class.

    -

    Note that unlike typesafe enums, this approach requires users to - mostly use different syntax compared with proper Java enums. Thus the - upgrade path to proper enums provided in JDK 1.5 is more painful.

    -

    24.3.5.5 Simple enums

    -

    This approach is similar to the type unsafe approach. Each enum item - is also wrapped as a static final integer. However, these integers are - not generated into a class named after the C/C++ enum. Instead, global - enums are generated into the constants interface. Also, enums defined - in a C++ class have their enum items generated directly into the Java - proxy class rather than an inner class within the Java proxy class. In - fact, this approach is effectively wrapping the enums as if they were - anonymous enums and the resulting code is as per -anonymous enums. The implementation is in the "enumsimple.swg" file.

    -

    Compatibility Note: SWIG-1.3.21 and earlier versions wrapped - all enums using this approach. The type unsafe approach is preferable - to this one and this simple approach is only included for backwards - compatibility with these earlier versions of SWIG.

    -

    24.3.6 Pointers

    -

    C/C++ pointers are fully supported by SWIG. Furthermore, SWIG has no - problem working with incomplete type information. Here is a rather - simple interface:

    +

    It is as if SWIG had parsed three separate overloaded methods. The + same approach is taken for static methods, constructors and member + methods.

    +

    Compatibility note: Versions of SWIG prior to SWIG-1.3.23 + wrapped these with a single wrapper method and so the default values + could not be taken advantage of from Java. Further details on default + arguments and how to restore this approach are given in the more + general Default arguments section.

    +

    25.3.13 C++ namespaces

    +

    SWIG is aware of named C++ namespaces and they can be mapped to Java + packages, however, the default wrapping flattens the namespaces, + effectively ignoring them. So by default, the namespace names do not + appear in the module nor do namespaces result in a module that is + broken up into submodules or packages. For example, if you have a file + like this,

     %module example
     
    -FILE *fopen(const char *filename, const char *mode);
    -int fputs(const char *, FILE *);
    -int fclose(FILE *);
    +namespace foo {
    +   int fact(int n);
    +   struct Vector {
    +       double x,y,z;
    +   };
    +};
     
    -

    When wrapped, you will be able to use the functions in a natural way - from Java. For example:

    +

    it works in Java as follows:

    -SWIGTYPE_p_FILE f = example.fopen("junk","w");
    -example.fputs("Hello World\n", f);
    -example.fclose(f);
    +int f = example.fact(3);
    +Vector v = new Vector();
    +v.setX(3.4);
    +double y = v.getY();
     
    -

    C pointers in the Java module are stored in a Java long and - cross the JNI boundary held within this 64 bit number. Many other SWIG - language modules use an encoding of the pointer in a string. These - scripting languages use the SWIG runtime type checker for dynamic type - checking as they do not support static type checking by a compiler. In - order to implement static type checking of pointers within Java, they - are wrapped by a simple Java class. In the example above the FILE * - pointer is wrapped with a type wrapper class called -SWIGTYPE_p_FILE.

    -

    Once obtained, a type wrapper object can be freely passed around to - different C functions that expect to receive an object of that type. - The only thing you can't do is dereference the pointer from Java. Of - course, that isn't much of a concern in this example.

    -

    As much as you might be inclined to modify a pointer value directly - from Java, don't. The value is not necessarily the same as the logical - memory address of the underlying object. The value will vary depending - on the native byte-ordering of the platform (i.e., big-endian vs. - little-endian). Most JVMs are 32 bit applications so any JNI code must - also be compiled as 32 bit. The net result is pointers in JNI code are - also 32 bits and are stored in the high order 4 bytes on big-endian - machines and in the low order 4 bytes on little-endian machines. By - design it is also not possible to manually cast a pointer to a new type - by using Java casts as it is particularly dangerous especially when - casting C++ objects. If you need to cast a pointer or change its value, - consider writing some helper functions instead. For example:

    +

    If your program has more than one namespace, name conflicts (if any) + can be resolved using %rename For example:

    -%inline %{
    -/* C-style cast */
    -Bar *FooToBar(Foo *f) {
    -   return (Bar *) f;
    -}
    +%rename(Bar_spam) Bar::spam;
     
    -/* C++-style cast */
    -Foo *BarToFoo(Bar *b) {
    -   return dynamic_cast<Foo*>(b);
    +namespace Foo {
    +    int spam();
     }
     
    -Foo *IncrFoo(Foo *f, int i) {
    -    return f+i;
    +namespace Bar {
    +    int spam();
     }
    -%}
     
    -

    Also, if working with C++, you should always try to use the new C++ - style casts. For example, in the above code, the C-style cast may - return a bogus result whereas as the C++-style cast will return a NULL - pointer if the conversion can't be performed.

    -

    24.3.7 Structures

    -

    If you wrap a C structure, it is wrapped by a Java class with - getters and setters for access to the member variables. For example,

    +

    If you have more than one namespace and you want to keep their + symbols separate, consider wrapping them as separate SWIG modules. Each + SWIG module can be placed into a separate package.

    +

    The default behaviour described above can be improved via the +nspace feature. Note that it only works for classes, structs, unions + and enums declared within a named C++ namespace. When the nspace + feature is used, the C++ namespaces are converted into Java packages of + the same name. Proxy classes are thus declared within a package and + this proxy makes numerous calls to the JNI intermediary class which is + declared in the unnamed package by default. As Java does not support + types declared in a named package accessing types declared in an + unnamed package, the -package commandline option described + earlier generally should be used to provide a parent package. So if + SWIG is run using the -package com.myco option, a wrapped + class, MyWorld::Material::Color, can then be accessed as +com.myco.MyWorld.Material.Color. If you don't specify a package, + you will get the following warning:

    +
    +
    +example.i:16: Warning 826: The nspace feature is used on 'MyWorld::Material::Color' without -package. The generated code 
    +may not compile as Java does not support types declared in a named package accessing types declared in an unnamed package.
    +
    +
    +

    If it is undesirable to have a single top level package, the nspace + feature may be used without the -package commandline option + (and the resulting warning ignored) if all of the types exposed using + SWIG are placed in a package using the nspace feature and the + 'jniclasspackage' pragma is used to specify a package for the JNI + intermediary class.

    +

    If the resulting use of the nspace feature and hence packages + results in a proxy class in one package deriving or using a proxy class + from another package, you will need to open up the visibility for the + pointer constructor and getCPtr method from the default + 'protected' to 'public' with the SWIG_JAVABODY_PROXY macro. + See Java code typemaps.

    +

    25.3.14 C++ templates

    +

    C++ templates don't present a huge problem for SWIG. However, in + order to create wrappers, you have to tell SWIG to create wrappers for + a particular template instantiation. To do this, you use the +%template directive. For example:

    -struct Vector {
    -	double x,y,z;
    +%module example
    +%{
    +#include <utility>
    +%}
    +
    +template<class T1, class T2>
    +struct pair {
    +   typedef T1 first_type;
    +   typedef T2 second_type;
    +   T1 first;
    +   T2 second;
    +   pair();
    +   pair(const T1&, const T2&);
    +  ~pair();
     };
     
    +%template(pairii) pair<int,int>;
     
    -

    is used as follows:

    +

    In Java:

    -Vector v = new Vector();
    -v.setX(3.5);
    -v.setY(7.2);
    -double x = v.getX();
    -double y = v.getY();
    +pairii p = new pairii(3,4);
    +int first = p.getFirst();
    +int second = p.getSecond();
     
    -

    The variable setters and getters are also based on the JavaBean - design pattern already covered under the Global variables section. - Similar access is provided for unions and the public data members of - C++ classes.

    -

    This object is actually an instance of a Java class that has been - wrapped around a pointer to the C structure. This instance doesn't - actually do anything--it just serves as a proxy. The pointer to the C - object is held in the Java proxy class in much the same way as pointers - are held by type wrapper classes. Further details about Java proxy - classes are covered a little later.

    -

    const members of a structure are read-only. Data members - can also be forced to be read-only using the %immutable - directive. For example:

    +

    Obviously, there is more to template wrapping than shown in this + example. More details can be found in the SWIG and + C++ chapter.

    +

    25.3.15 C++ Smart Pointers

    +

    25.3.15.1 The shared_ptr + Smart Pointer

    +

    The C++11 standard provides std::shared_ptr which was + derived from the Boost implementation, boost::shared_ptr. Both + of these are available for Java in the SWIG library and usage is + outlined in the shared_ptr smart + pointer library section.

    +

    25.3.15.2 Generic Smart + Pointers

    +

    In certain C++ programs, it is common to use classes that have been + wrapped by so-called "smart pointers." Generally, this involves the use + of a template class that implements operator->() like this:

    -struct Foo {
    +template<class T> class SmartPtr {
        ...
    -   %immutable;
    -   int x;        /* Read-only members */
    -   char *name;
    -   %mutable;
    +   T *operator->();
        ...
    -};
    +}
     
    -

    When char * members of a structure are wrapped, the - contents are assumed to be dynamically allocated using malloc - or new (depending on whether or not SWIG is run with the -c++ - option). When the structure member is set, the old contents will be - released and a new value created. If this is not the behavior you want, - you will have to use a typemap (described later).

    -

    If a structure contains arrays, access to those arrays is managed - through pointers. For example, consider this:

    +

    Then, if you have a class like this,

    -struct Bar {
    -    int  x[16];
    +class Foo {
    +public:
    +     int x;
    +     int bar();
     };
     
    -

    If accessed in Java, you will see behavior like this:

    +

    A smart pointer would be used in C++ as follows:

    -Bar b = new Bar();
    -SWIGTYPE_p_int x = b.getX();
    +SmartPtr<Foo> p = CreateFoo();   // Created somehow (not shown)
    +...
    +p->x = 3;                        // Foo::x
    +int y = p->bar();                // Foo::bar
     
    -

    This pointer can be passed around to functions that expect to - receive an int * (just like C). You can also set the value of - an array member using another pointer. For example:

    +

    To wrap this in Java, simply tell SWIG about the SmartPtr + class and the low-level Foo object. Make sure you instantiate +SmartPtr using %template if necessary. For example:

    -Bar b = new Bar();
    -SWIGTYPE_p_int x = b.getX();
    -Bar c = new Bar();
    -c.setX(x);                    // Copy contents of b.x to c.x
    +%module example
    +...
    +%template(SmartPtrFoo) SmartPtr<Foo>;
    +...
     
    -

    For array assignment (setters not getters), SWIG copies the entire - contents of the array starting with the data pointed to by b.x -. In this example, 16 integers would be copied. Like C, SWIG makes no - assumptions about bounds checking---if you pass a bad pointer, you may - get a segmentation fault or access violation. The default wrapping - makes it hard to set or get just one element of the array and so array - access from Java is somewhat limited. This can be changed easily though - by using the approach outlined later in the -Wrapping C arrays with Java arrays and -Unbounded C Arrays sections.

    -

    When a member of a structure is itself a structure, it is handled as - a pointer. For example, suppose you have two structures like this:

    +

    Now, in Java, everything should just "work":

    -struct Foo {
    -   int a;
    -};
    -
    -struct Bar {
    -   Foo f;
    +SmartPtrFoo p = example.CreateFoo(); // Create a smart-pointer somehow
    +p.setX(3);                           // Foo::x
    +int y = p.bar();                     // Foo::bar
    +
    +
    +

    If you ever need to access the underlying pointer returned by +operator->() itself, simply use the __deref__() method. + For example:

    +
    +
    +Foo f = p.__deref__();               // Returns underlying Foo *
    +
    +
    +

    25.4 Further details on the generated + Java classes

    +

    In the previous section, a high-level view of Java wrapping was + presented. A key component of this wrapping is that structures and + classes are wrapped by Java proxy classes and type wrapper classes are + used in situations where no proxies are generated. This provides a very + natural, type safe Java interface to the C/C++ code and fits in with + the Java programming paradigm. However, a number of low-level details + were omitted. This section provides a brief overview of how the proxy + classes work and then covers the type wrapper classes. Finally enum + classes are covered. First, the crucial intermediary JNI class is + considered.

    +

    25.4.1 The intermediary JNI class

    +

    In the "SWIG basics" and +"SWIG and C++" chapters, details of low-level structure and class + wrapping are described. To summarize those chapters, if you have a + global function and class like this

    +
    +
    +class Foo {
    +public:
    +     int x;
    +     int spam(int num, Foo* foo);
     };
    +void egg(Foo* chips);
     
    -

    Now, suppose that you access the f member of Bar - like this:

    +

    then SWIG transforms the class into a set of low-level procedural + wrappers. These procedural wrappers essentially perform the equivalent + of this C++ code:

    -Bar b = new Bar();
    -Foo x = b.getF();
    +Foo *new_Foo() {
    +    return new Foo();
    +}
    +void delete_Foo(Foo *f) {
    +    delete f;
    +}
    +int Foo_x_get(Foo *f) {
    +    return f->x;
    +}
    +void Foo_x_set(Foo *f, int value) {
    +    f->x = value;
    +}
    +int Foo_spam(Foo *f, int num, Foo* foo) {
    +    return f->spam(num, foo);
    +}
     
    -

    In this case, x is a pointer that points to the Foo - that is inside b. This is the same value as generated by this - C code:

    +

    These procedural function names don't actually exist, but their + functionality appears inside the generated JNI functions. The JNI + functions have to follow a particular naming convention so the function + names are actually:

    -Bar b;
    -Foo *x = &b->f;       /* Points inside b */
    +SWIGEXPORT jlong JNICALL Java_exampleJNI_new_1Foo(JNIEnv *jenv, jclass jcls);
    +SWIGEXPORT void JNICALL Java_exampleJNI_delete_1Foo(JNIEnv *jenv, jclass jcls,
    +                                                    jlong jarg1);
    +SWIGEXPORT void JNICALL Java_exampleJNI_Foo_1x_1set(JNIEnv *jenv, jclass jcls,
    +                                                    jlong jarg1, jobject jarg1_, jint jarg2);
    +SWIGEXPORT jint JNICALL Java_exampleJNI_Foo_1x_1get(JNIEnv *jenv, jclass jcls,
    +                                                    jlong jarg1, jobject jarg1_);
    +SWIGEXPORT jint JNICALL Java_exampleJNI_Foo_1spam(JNIEnv *jenv, jclass jcls,
    +                                                  jlong jarg1, jobject jarg1_, jint jarg2,
    +                                                  jlong jarg3, jobject jarg3_);
    +SWIGEXPORT void JNICALL Java_exampleJNI_egg(JNIEnv *jenv, jclass jcls,
    +                                            jlong jarg1, jobject jarg1_);
     
    -

    Because the pointer points inside the structure, you can modify the - contents and everything works just like you would expect. For example:

    +

    For every JNI C function there has to be a static native Java + function. These appear in the intermediary JNI class:

    -Bar b = new Bar();
    -b.getF().setA(3);   // Modify b.f.a
    -Foo x = b.getF();                   
    -x.setA(3);          // Modify x.a - this is the same as b.f.a
    +class exampleJNI {
    +  public final static native long new_Foo();
    +  public final static native void delete_Foo(long jarg1);
    +  public final static native void Foo_x_set(long jarg1, Foo jarg1_, int jarg2);
    +  public final static native int Foo_x_get(long jarg1, Foo jarg1_);
    +  public final static native int Foo_spam(long jarg1, Foo jarg1_, int jarg2,
    +                                          long jarg3, Foo jarg3_);
    +  public final static native void egg(long jarg1, Foo jarg1_);
    +}
     
    -

    24.3.8 C++ classes

    -

    C++ classes are wrapped by Java classes as well. For example, if you - have this class,

    +

    This class contains the complete Java - C/C++ interface so all + function calls go via this class. As this class acts as a go-between + for all JNI calls to C/C++ code from the Java +proxy classes, type wrapper + classes and module class, it is + known as the intermediary JNI class.

    +

    You may notice that SWIG uses a Java long wherever a pointer or + class object needs to be marshalled across the Java-C/C++ boundary. + This approach leads to minimal JNI code which makes for better + performance as JNI code involves a lot of string manipulation. SWIG + favours generating Java code over JNI code as Java code is compiled + into byte code and avoids the costly string operations needed in JNI + code. This approach has a downside though as the proxy class might get + collected before the native method has completed. You might notice + above that there is an additional parameters with a underscore postfix, + eg jarg1_. These are added in order to prevent +premature garbage collection when marshalling proxy classes.

    +

    The functions in the intermediary JNI class cannot be accessed + outside of its package. Access to them is gained through the module + class for globals otherwise the appropriate proxy class.

    + +

    The name of the intermediary JNI class can be changed from its + default, that is, the module name with JNI appended after it. The + module directive attribute jniclassname is used to achieve + this:

    -class List {
    -public:
    -  List();
    -  ~List();
    -  int  search(char *item);
    -  void insert(char *item);
    -  void remove(char *item);
    -  char *get(int n);
    -  int  length;
    -};
    +%module (jniclassname="name") modulename
     
    -

    you can use it in Java like this:

    +

    If name is the same as modulename then the module + class name gets changed from modulename to +modulenameModule.

    +

    25.4.1.1 The intermediary JNI class + pragmas

    +

    The intermediary JNI class can be tailored through the use of + pragmas, but is not commonly done. The pragmas for this class are:

    + + + + + + + + + +
    PragmaDescription
    jniclassbaseBase class for the intermediary JNI class
    jniclasspackagePackage in which to place the + intermediary JNI class
    jniclassclassmodifiersClass modifiers and class type + for the intermediary JNI class
    jniclasscodeJava code is copied verbatim into the + intermediary JNI class
    jniclassimportsJava code, usually one or more import + statements, placed before the intermediary JNI class definition
    jniclassinterfacesComma separated interface classes for + the intermediary JNI class
    +

    The pragma code appears in the generated intermediary JNI class + where you would expect:

    -List l = new List();
    -l.insert("Ale");
    -l.insert("Stout");
    -l.insert("Lager");
    -String item = l.get(2);
    -int length = l.getLength();
    +[ jniclassimports pragma ]
    +[ jniclassclassmodifiers pragma ] jniclassname extends [ jniclassbase pragma ]
    +                                          implements [ jniclassinterfaces pragma ] {
    +[ jniclasscode pragma ]
    +... SWIG generated native methods ...
    +}
     
    -

    Class data members are accessed in the same manner as C structures.

    -

    Static class members are unsurprisingly wrapped as static members of - the Java class:

    +

    The jniclasscode pragma is quite useful for adding in a + static block for loading the shared library / dynamic link library and + demonstrates how pragmas work:

    -class Spam {
    -public:
    -   static void foo();
    -   static int bar;
    -};
    +%pragma(java) jniclasscode=%{
    +  static {
    +    try {
    +      System.loadLibrary("example");
    +    } catch (UnsatisfiedLinkError e) {
    +      System.err.println("Native code library failed to load. \n" + e);
    +      System.exit(1);
    +    }
    +  }
    +%}
     
    -

    The static members work like any other Java static member:

    +

    Pragmas will take either "" or %{ %} as + delimiters. For example, let's change the intermediary JNI class access + to just the default package-private access.

    +
    +
    +%pragma(java) jniclassclassmodifiers="class"
    +
    +
    +

    All the methods in the intermediary JNI class will then not be + callable outside of the package as the method modifiers have been + changed from public access to default access. This is useful if you + want to prevent users calling these low level functions.

    +

    25.4.2 The Java module class

    +

    All global functions and variable getters/setters appear in the + module class. For our example, there is just one function:

    +
    +
    +public class example {
    +  public static void egg(Foo chips) {
    +    exampleJNI.egg(Foo.getCPtr(chips), chips);
    +  }
    +}
    +
    +
    +

    The module class is necessary as there is no such thing as a global + in Java so all the C globals are put into this class. They are + generated as static functions and so must be accessed as such by using + the module name in the static function call:

    +
    +
    +example.egg(new Foo());
    +
    +
    +

    The primary reason for having the module class wrapping the calls in + the intermediary JNI class is to implement static type checking. In + this case only a Foo can be passed to the egg + function, whereas any long can be passed to the egg + function in the intermediary JNI class.

    +

    25.4.2.1 The Java module class + pragmas

    +

    The module class can be tailored through the use of pragmas, in the + same manner as the intermediary JNI class. The pragmas are similarly + named and are used in the same way. The complete list follows:

    + + + + + + + +
    PragmaDescription
    modulebaseBase class for the module class
    moduleclassmodifiersClass modifiers and class type for + the module class
    modulecodeJava code is copied verbatim into the module + class
    moduleimportsJava code, usually one or more import + statements, placed before the module class definition
    moduleinterfacesComma separated interface classes for + the module class
    +

    The pragma code appears in the generated module class like this:

    -Spam.foo();
    -int bar = Spam.getBar();
    +[ moduleimports pragma ]
    +[ modulemodifiers pragma ] modulename extends [ modulebase pragma ]
    +                                      implements [ moduleinterfaces pragma ] {
    +[ modulecode pragma ]
    +... SWIG generated wrapper functions ...
    +}
     
    -

    24.3.9 C++ inheritance

    -

    SWIG is fully aware of issues related to C++ inheritance. Therefore, - if you have classes like this

    +

    See The intermediary JNI class + pragmas section for further details on using pragmas.

    +

    25.4.3 Java proxy classes

    +

    A Java proxy class is generated for each structure, union or C++ + class that is wrapped. Proxy classes have also been called +peer classes. The default proxy class for our previous example looks + like this:

    -class Foo {
    -...
    -};
    +public class Foo {
    +  private transient long swigCPtr;
    +  protected transient boolean swigCMemOwn;
     
    -class Bar : public Foo {
    -...
    -};
    +  protected Foo(long cPtr, boolean cMemoryOwn) {
    +    swigCMemOwn = cMemoryOwn;
    +    swigCPtr = cPtr;
    +  }
    +
    +  protected static long getCPtr(Foo obj) {
    +    return (obj == null) ? 0 : obj.swigCPtr;
    +  }
    +
    +  protected void finalize() {
    +    delete();
    +  }
    +
    +  public synchronized void delete() {
    +    if(swigCPtr != 0 && swigCMemOwn) {
    +      swigCMemOwn = false;
    +      exampleJNI.delete_Foo(swigCPtr);
    +    }
    +    swigCPtr = 0;
    +  }
    +
    +  public void setX(int value) {
    +    exampleJNI.Foo_x_set(swigCPtr, this, value);
    +  }
    +
    +  public int getX() {
    +    return exampleJNI.Foo_x_get(swigCPtr, this);
    +  }
    +
    +  public int spam(int num, Foo foo) {
    +    return exampleJNI.Foo_spam(swigCPtr, this, num, Foo.getCPtr(foo), foo);
    +  }
    +
    +  public Foo() {
    +    this(exampleJNI.new_Foo(), true);
    +  }
    +
    +}
     
    -

    those classes are wrapped into a hierarchy of Java classes that - reflect the same inheritance structure:

    +

    This class merely holds a pointer to the underlying C++ object ( +swigCPtr). It also contains all the methods in the C++ class it is + proxying plus getters and setters for public member variables. These + functions call the native methods in the intermediary JNI class. The + advantage of having this extra layer is the type safety that the proxy + class functions offer. It adds static type checking which leads to + fewer surprises at runtime. For example, you can see that if you + attempt to use the spam() function it will only compile when + the parameters passed are an int and a Foo. From a + user's point of view, it makes the class work as if it were a Java + class:

    -Bar b = new Bar();
    -Class c = b.getClass();
    -System.out.println(c.getSuperclass().getName());
    +Foo f = new Foo();
    +f.setX(3);
    +int y = f.spam(5, new Foo());
     
    -

    will of course display:

    +

    25.4.3.1 Memory management

    +

    Each proxy class has an ownership flag swigCMemOwn. The + value of this flag determines who is responsible for deleting the + underlying C++ object. If set to true, the proxy class's + finalizer will destroy the C++ object when the proxy class is garbage + collected. If set to false, then the destruction of the proxy class has + no effect on the C++ object.

    +

    When an object is created by a constructor or returned by value, + Java automatically takes ownership of the result. On the other hand, + when pointers or references are returned to Java, there is often no way + to know where they came from. Therefore, the ownership is set to false. + For example:

    -Foo
    +class Foo {
    +public:
    +    Foo();
    +    Foo bar1();
    +    Foo &bar2();
    +    Foo *bar2();
    +};
     
    -

    Furthermore, if you have functions like this

    +

    In Java:

    -void spam(Foo *f);
    +Foo f = new Foo();   //  f.swigCMemOwn = true
    +Foo f1 = f.bar1();   // f1.swigCMemOwn = true
    +Foo f2 = f.bar2();   // f2.swigCMemOwn = false
    +Foo f3 = f.bar3();   // f3.swigCMemOwn = false
     
    -

    then the Java function spam() accepts instances of Foo - or instances of any other proxy classes derived from Foo.

    -

    Note that Java does not support multiple inheritance so any multiple - inheritance in the C++ code is not going to work. A warning is given - when multiple inheritance is detected and only the first base class is - used.

    -

    24.3.10 Pointers, - references, arrays and pass by value

    -

    In C++, there are many different ways a function might receive and - manipulate objects. For example:

    +

    This behavior for pointers and references is especially important + for classes that act as containers. For example, if a method returns a + pointer to an object that is contained inside another object, you + definitely don't want Java to assume ownership and destroy it!

    +

    For the most part, memory management issues remain hidden. However, + there are situations where you might have to manually change the + ownership of an object. For instance, consider code like this:

    -void spam1(Foo *x);      // Pass by pointer
    -void spam2(Foo &x);      // Pass by reference
    -void spam3(Foo x);       // Pass by value
    -void spam4(Foo x[]);     // Array of objects
    +class Obj {};
    +class Node {
    +   Obj *value;
    +public:
    +   void set_value(Obj *v) { value = v; }
    +};
     
    -

    In Java, there is no detailed distinction like this--specifically, - there are only instances of classes. There are no pointers nor - references. Because of this, SWIG unifies all of these types together - in the wrapper code. For instance, if you actually had the above - functions, it is perfectly legal to do this from Java:

    +

    Now, consider the following Java code:

    -Foo f = new Foo();  // Create a Foo
    -example.spam1(f);   // Ok. Pointer
    -example.spam2(f);   // Ok. Reference
    -example.spam3(f);   // Ok. Value.
    -example.spam4(f);   // Ok. Array (1 element)
    +Node n = new Node();    // Create a node
    +{
    +  Obj o = new Obj();    // Create an object
    +  n.set_value(o);       // Set value
    +}                       // o goes out of scope
     
    -

    Similar behavior occurs for return values. For example, if you had - functions like this,

    +

    In this case, the Node n is holding a reference to o + internally. However, SWIG has no way to know that this has occurred. + The Java proxy class still thinks that it has ownership of o. + As o has gone out of scope, it could be garbage collected in + which case the C++ destructor will be invoked and n will then + be holding a stale-pointer to o. If you're lucky, you will + only get a segmentation fault.

    +

    To work around this, the ownership flag of o needs changing + to false. The ownership flag is a private member variable of + the proxy class so this is not possible without some customization of + the proxy class. This can be achieved by using a typemap to customise + the proxy class with pure Java code as detailed later in the section on + Java typemaps.

    +

    Sometimes a function will create memory and return a pointer to a + newly allocated object. SWIG has no way of knowing this so by default + the proxy class does not manage the returned object. However, you can + tell the proxy class to manage the memory if you specify the +%newobject directive. Consider:

    -Foo *spam5();
    -Foo &spam6();
    -Foo  spam7();
    +class Obj {...};
    +class Factory {
    +public:
    +    static Obj *createObj() { return new Obj(); }
    +};
     
    -

    then all three functions will return a pointer to some Foo - object. Since the third function (spam7) returns a value, newly - allocated memory is used to hold the result and a pointer is returned - (Java will release this memory when the returned object's finalizer is - run by the garbage collector).

    -

    24.3.10.1 Null pointers

    -

    Working with null pointers is easy. A Java null can be used - whenever a method expects a proxy class or typewrapper class. However, - it is not possible to pass null to C/C++ functions that take parameters - by value or by reference. If you try you will get a - NullPointerException.

    +

    If we call the factory function, then we have to manually delete the + memory:

    -example.spam1(null);   // Pointer - ok
    -example.spam2(null);   // Reference - NullPointerException
    -example.spam3(null);   // Value - NullPointerException
    -example.spam4(null);   // Array - ok
    +Obj obj = Factory.createObj();   // obj.swigCMemOwn = false
    +...
    +obj.delete();
     
    -

    For spam1 and spam4 above the Java null - gets translated into a NULL pointer for passing to the C/C++ function. - The converse also occurs, that is, NULL pointers are translated into -null Java objects when returned from a C/C++ function.

    -

    24.3.11 C++ overloaded - functions

    -

    C++ overloaded functions, methods, and constructors are mostly - supported by SWIG. For example, if you have two functions like this:

    +

    Now add in the %newobject directive:

    -%module example
    +%newobject Factory::createObj();
     
    -void foo(int);
    -void foo(char *c);
    +class Obj {...};
    +class Factory {
    +public:
    +    static Obj *createObj() { return new Obj(); }
    +};
     
    -

    You can use them in Java in a straightforward manner:

    +

    A call to delete() is no longer necessary as the garbage + collector will make the C++ destructor call because swigCMemOwn + is now true.

    -example.foo(3);           // foo(int)
    -example.foo("Hello");     // foo(char *c)
    +Obj obj = Factory.createObj();   // obj.swigCMemOwn = true;
    +...
     
    -

    Similarly, if you have a class like this,

    +

    Some memory management issues are quite tricky to fix and may only + be noticeable after using for a long time. One such issue is premature + garbage collection of an object created from Java and resultant usage + from C++ code. The section on typemap examples cover two such + scenarios, Memory management + for objects passed to the C++ layer and +Memory management when returning references to member variables

    +

    25.4.3.2 Inheritance

    +

    Java proxy classes will mirror C++ inheritance chains. For example, + given the base class Base and its derived class Derived +:

    -class Foo {
    +class Base {
     public:
    -    Foo();
    -    Foo(const Foo &);
    -    ...
    +  virtual double foo();
    +};
    +
    +class Derived : public Base {
    +public:
    +  virtual double foo();
     };
     
    -

    you can write Java code like this:

    -
    -
    -Foo f = new Foo();        // Create a Foo
    -Foo g = new Foo(f);       // Copy f
    -
    -
    -

    Overloading support is not quite as flexible as in C++. Sometimes - there are methods that SWIG cannot disambiguate as there can be more - than one C++ type mapping onto a single Java type. For example:

    +

    The base class is generated much like any other proxy class seen so + far:

    -void spam(int);
    -void spam(unsigned short);
    +public class Base {
    +  private transient long swigCPtr;
    +  protected transient boolean swigCMemOwn;
    +
    +  protected Base(long cPtr, boolean cMemoryOwn) {
    +    swigCMemOwn = cMemoryOwn;
    +    swigCPtr = cPtr;
    +  }
    +
    +  protected static long getCPtr(Base obj) {
    +    return (obj == null) ? 0 : obj.swigCPtr;
    +  }
    +
    +  protected void finalize() {
    +    delete();
    +  }
    +
    +  public synchronized void delete() {
    +    if(swigCPtr != 0 && swigCMemOwn) {
    +      swigCMemOwn = false;
    +      exampleJNI.delete_Base(swigCPtr);
    +    }
    +    swigCPtr = 0;
    +  }
    +
    +  public double foo() {
    +    return exampleJNI.Base_foo(swigCPtr, this);
    +  }
    +
    +  public Base() {
    +    this(exampleJNI.new_Base(), true);
    +  }
    +
    +}
     
    -

    Here both int and unsigned short map onto a Java int. Here is - another example:

    +

    The Derived class extends Base mirroring the C++ + class inheritance hierarchy.

    -void foo(Bar *b);
    -void foo(Bar &b);
    +public class Derived extends Base {
    +  private transient long swigCPtr;
    +
    +  protected Derived(long cPtr, boolean cMemoryOwn) {
    +    super(exampleJNI.SWIGDerivedUpcast(cPtr), cMemoryOwn);
    +    swigCPtr = cPtr;
    +  }
    +
    +  protected static long getCPtr(Derived obj) {
    +    return (obj == null) ? 0 : obj.swigCPtr;
    +  }
    +
    +  protected void finalize() {
    +    delete();
    +  }
    +
    +  public synchronized void delete() {
    +    if(swigCPtr != 0 && swigCMemOwn) {
    +      swigCMemOwn = false;
    +      exampleJNI.delete_Derived(swigCPtr);
    +    }
    +    swigCPtr = 0;
    +    super.delete();
    +  }
    +
    +  public double foo() {
    +    return exampleJNI.Derived_foo(swigCPtr, this);
    +  }
    +
    +  public Derived() {
    +    this(exampleJNI.new_Derived(), true);
    +  }
    +
    +}
     
    -

    If declarations such as these appear, you will get a warning message - like this:

    +

    Note the memory ownership is controlled by the base class. However + each class in the inheritance hierarchy has its own pointer value which + is obtained during construction. The SWIGDerivedUpcast() call + converts the pointer from a Derived * to a Base *. + This is a necessity as C++ compilers are free to implement pointers in + the inheritance hierarchy with different values.

    +

    It is of course possible to extend Base using your own Java + classes. If Derived is provided by the C++ code, you could for + example add in a pure Java class Extended derived from +Base. There is a caveat and that is any C++ code will not know + about your pure Java class Extended so this type of derivation + is restricted. However, true cross language polymorphism can be + achieved using the directors feature.

    +

    25.4.3.3 Proxy classes and garbage + collection

    +

    By default each proxy class has a delete() and a +finalize() method. The finalize() method calls +delete() which frees any malloc'd memory for wrapped C structs or + calls the C++ class destructors. The idea is for delete() to + be called when you have finished with the C/C++ object. Ideally you + need not call delete(), but rather leave it to the garbage + collector to call it from the finalizer. When a program exits, the + garbage collector does not guarantee to call all finalizers. An insight + into the reasoning behind this can be obtained from +Hans Boehm's Destructors, Finalizers, and Synchronization paper. + Depending on what the finalizers do and which operating system you use, + this may or may not be a problem.

    +

    If the delete() call into JNI code is just for memory + handling, there is not a problem when run on most operating systems, + for example Windows and Unix. Say your JNI code creates memory on the + heap which your finalizers should clean up, the finalizers may or may + not be called before the program exits. In Windows and Unix all memory + that a process uses is returned to the system on exit, so this isn't a + problem. This is not the case in some operating systems like vxWorks. + If however, your finalizer calls into JNI code invoking the C++ + destructor which in turn releases a TCP/IP socket for example, there is + no guarantee that it will be released. Note that with long running + programs the garbage collector will eventually run, thereby calling any + unreferenced object's finalizers.

    +

    Some not so ideal solutions are:

    +
      +
    1. +

      Call the System.runFinalizersOnExit(true) or +Runtime.getRuntime().runFinalizersOnExit(true) to ensure the + finalizers are called before the program exits. The catch is that this + is a deprecated function call as the documentation says:

      +
      This method is inherently unsafe. It may result in + finalizers being called on live objects while other threads are + concurrently manipulating those objects, resulting in erratic behavior + or deadlock.
      +

      In many cases you will be lucky and find that it works, but it is not + to be advocated. Have a look at +Java web site and search for runFinalizersOnExit.

      +
    2. +
    3. +

      From jdk1.3 onwards a new function, addShutdownHook(), was + introduced which is guaranteed to be called when your program exits. + You can encourage the garbage collector to call the finalizers, for + example, add this static block to the class that has the main() + function:

      -example.i:12: Warning 515: Overloaded method spam(unsigned short) ignored.
      -Method spam(int) at example.i:11 used.
      +  static {
      +    Runtime.getRuntime().addShutdownHook( 
      +      new Thread() {
      +        public void run() { System.gc(); System.runFinalization(); }
      +      }
      +    );
      +  }
       
      -

      To fix this, you either need to either -rename or ignore one of the methods. For example:

      +

      Although this usually works, the documentation doesn't guarantee that + runFinalization() will actually call the finalizers. As the + shutdown hook is guaranteed you could also make a JNI call to clean up + any resources that are being tracked by the C/C++ code.

      +
    4. +
    5. +

      Call the delete() function manually which will immediately + invoke the C++ destructor. As a suggestion it may be a good idea to set + the object to null so that should the object be inadvertently used + again a Java null pointer exception is thrown, the alternative would + crash the JVM by using a null C pointer. For example given a SWIG + generated class A:

      -%rename(spam_ushort) spam(unsigned short);
      -...
      -void spam(int);    
      -void spam(unsigned short);   // Now renamed to spam_ushort
      +A myA = new A();
      +// use myA ...
      +myA.delete();
      +// any use of myA here would crash the JVM 
      +myA=null;
      +// any use of myA here would cause a Java null pointer exception to be thrown
       
      -

      or

      +

      The SWIG generated code ensures that the memory is not deleted + twice, in the event the finalizers get called in addition to the manual + delete() call.

      +
    6. +
    7. +

      Write your own object manager in Java. You could derive all SWIG + classes from a single base class which could track which objects have + had their finalizers run, then call the rest of them on program + termination. The section on Java typemaps + details how to specify a pure Java base class.

      +
    8. +
    +

    See the How to + Handle Java Finalization's Memory-Retention Issues article for + alternative approaches to managing memory by avoiding finalizers + altogether.

    +

    25.4.3.4 The premature garbage collection + prevention parameter for proxy class marshalling

    +

    As covered earlier, the C/C++ struct/class pointer is stored in the + proxy class as a Java long and when needed is passed into the native + method where it is cast into the appropriate type. This approach + provides very fast marshalling but could be susceptible to premature + garbage collection. Consider the following C++ code:

    -%ignore spam(unsigned short);
    -...
    -void spam(int);    
    -void spam(unsigned short);   // Ignored
    +class Wibble {
    +};
    +void wobble(Wibble &w);
     
    -

    24.3.12 C++ default arguments

    -

    Any function with a default argument is wrapped by generating an - additional function for each argument that is defaulted. For example, - if we have the following C++:

    +

    The module class contains the Java wrapper for the global wobble + method:

    -%module example
    -
    -void defaults(double d=10.0, int i=0);
    +public class example {
    +  ...
    +  public static void wobble(Wibble w) {
    +    exampleJNI.wobble(Wibble.getCPtr(w), w);
    +  }
    +}
     
    -

    The following methods are generated in the Java module class:

    +

    where example is the name of the module. All native methods + go through the intermediary class which has the native method declared + as such:

    -public class example {
    -  public static void defaults(double d, int i) { ... }
    -  public static void defaults(double d) { ... }
    -  public static void defaults() { ... }
    +public class exampleJNI {
    +  ...
    +  public final static native void wobble(long jarg1, Wibble jarg1_);
     }
     
    -

    It is as if SWIG had parsed three separate overloaded methods. The - same approach is taken for static methods, constructors and member - methods.

    -

    Compatibility note: Versions of SWIG prior to SWIG-1.3.23 - wrapped these with a single wrapper method and so the default values - could not be taken advantage of from Java. Further details on default - arguments and how to restore this approach are given in the more - general Default arguments section.

    -

    24.3.13 C++ namespaces

    -

    SWIG is aware of named C++ namespaces and they can be mapped to Java - packages, however, the default wrapping flattens the namespaces, - effectively ignoring them. So by default, the namespace names do not - appear in the module nor do namespaces result in a module that is - broken up into submodules or packages. For example, if you have a file - like this,

    +

    The second parameter, jarg1_, is the premature garbage + collection prevention parameter and is added to the native method + parameter list whenever a C/C++ struct or class is marshalled as a Java + long. In order to understand why, consider the alternative where the + intermediary class method is declared without the additional parameter:

    -%module example
    -
    -namespace foo {
    -   int fact(int n);
    -   struct Vector {
    -       double x,y,z;
    -   };
    -};
    +public class exampleJNI {
    +  ...
    +  public final static native void wobble(long jarg1);
    +}
     
    -

    it works in Java as follows:

    +

    and the following simple call to wobble:

    -int f = example.fact(3);
    -Vector v = new Vector();
    -v.setX(3.4);
    -double y = v.getY();
    +{
    +  Wibble w = new Wibble();
    +  example.wobble(w);
    +}
     
    -

    If your program has more than one namespace, name conflicts (if any) - can be resolved using %rename For example:

    +

    The hotspot compiler effectively sees something like:

    -%rename(Bar_spam) Bar::spam;
    -
    -namespace Foo {
    -    int spam();
    +{
    +  Wibble w = new Wibble();
    +  long w_ptr = Wibble.getCPtr(w);
    +  // w is no longer reachable
    +  exampleJNI.wobble(w_ptr);
     }
    -
    -namespace Bar {
    -    int spam();
    +
    +
    +

    The Wibble object is no longer reachable after the point + shown as in this bit of code, the Wibble object is not + referenced again after this point. This means that it is a candidate + for garbage collection. Should wobble be a long running + method, it is quite likely that the finalizer for the Wibble + instance will be called. This in turn will call its underlying C++ + destructor which is obviously disastrous while the method wobble + is running using this object. Even if wobble is not a long + running method, it is possible for the Wibble instance to be + finalized. By passing the Wibble instance into the native + method, it will not be finalized as the JVM guarantees not to finalize + any objects until the native method returns. Effectively, the code then + becomes

    +
    +
    +{
    +  Wibble w = new Wibble();
    +  long w_ptr = Wibble.getCPtr(w);
    +  exampleJNI.wobble(w_ptr, w);
    +  // w is no longer reachable
     }
     
    -

    If you have more than one namespace and you want to keep their - symbols separate, consider wrapping them as separate SWIG modules. Each - SWIG module can be placed into a separate package.

    -

    The default behaviour described above can be improved via the -nspace feature. Note that it only works for classes, structs, unions - and enums declared within a named C++ namespace. When the nspace - feature is used, the C++ namespaces are converted into Java packages of - the same name. Proxy classes are thus declared within a package and - this proxy makes numerous calls to the JNI intermediary class which is - declared in the unnamed package by default. As Java does not support - types declared in a named package accessing types declared in an - unnamed package, the -package commandline option described - earlier generally should be used to provide a parent package. So if - SWIG is run using the -package com.myco option, a wrapped - class, MyWorld::Material::Color, can then be accessed as -com.myco.MyWorld.Material.Color. If you don't specify a package, - you will get the following warning:

    -
    +

    and therefore there is no possibility of premature garbage + collection. In practice, this premature garbage collection was only + ever observed in Sun's server JVM from jdk-1.3 onwards and in Sun's + client JVM from jdk-1.6 onwards.

    +

    The premature garbage collection prevention parameter for proxy + classes is generated by default whenever proxy classes are passed by + value, reference or with a pointer. The implementation for this extra + parameter generation requires the "jtype" typemap to contain long + and the "jstype" typemap to contain the name of a proxy class.

    +

    The additional parameter does impose a slight performance overhead + and the parameter generation can be suppressed globally with the +-nopgcpp commandline option. More selective suppression is possible + with the 'nopgcpp' attribute in the "jtype" +Java typemap. The attribute is a flag and so should be set to "1" to + enable the suppression, or it can be omitted or set to "0" to disable. + For example:

    +
    -example.i:16: Warning 826: The nspace feature is used on 'MyWorld::Material::Color' without -package. The generated code 
    -may not compile as Java does not support types declared in a named package accessing types declared in an unnamed package.
    +%typemap(jtype, nopgcpp="1") Wibble & "long"
     
    -

    If it is undesirable to have a single top level package, the nspace - feature may be used without the -package commandline option - (and the resulting warning ignored) if all of the types exposed using - SWIG are placed in a package using the nspace feature and the - 'jniclasspackage' pragma is used to specify a package for the JNI - intermediary class.

    -

    If the resulting use of the nspace feature and hence packages - results in a proxy class in one package deriving or using a proxy class - from another package, you will need to open up the visibility for the - pointer constructor and getCPtr method from the default - 'protected' to 'public' with the SWIG_JAVABODY_PROXY macro. - See Java code typemaps.

    -

    24.3.14 C++ templates

    -

    C++ templates don't present a huge problem for SWIG. However, in - order to create wrappers, you have to tell SWIG to create wrappers for - a particular template instantiation. To do this, you use the -%template directive. For example:

    +

    Compatibility note: The generation of this additional + parameter did not occur in versions prior to SWIG-1.3.30.

    +

    25.4.3.5 Single threaded + applications and thread safety

    +

    Single threaded Java applications using JNI need to consider thread + safety. The same applies for the C# module where the .NET wrappers use + PInvoke. Consider the C++ class:

    -%module example
    -%{
    -#include <utility>
    -%}
    -
    -template<class T1, class T2>
    -struct pair {
    -   typedef T1 first_type;
    -   typedef T2 second_type;
    -   T1 first;
    -   T2 second;
    -   pair();
    -   pair(const T1&, const T2&);
    -  ~pair();
    +class Test {
    +  string str;
    +public:
    +  Test() : str("initial") {}
     };
    -
    -%template(pairii) pair<int,int>;
     
    -

    In Java:

    +

    and the Java proxy class generated by SWIG:

    -pairii p = new pairii(3,4);
    -int first = p.getFirst();
    -int second = p.getSecond();
    +public class Test {
    +  private transient long swigCPtr;
    +  protected transient boolean swigCMemOwn;
    +
    +  protected Test(long cPtr, boolean cMemoryOwn) {
    +    swigCMemOwn = cMemoryOwn;
    +    swigCPtr = cPtr;
    +  }
    +
    +  protected static long getCPtr(Test obj) {
    +    return (obj == null) ? 0 : obj.swigCPtr;
    +  }
    +
    +  protected void finalize() {
    +    delete();
    +  }
    +
    +  // Call C++ destructor
    +  public synchronized void delete() {
    +    if(swigCPtr != 0 && swigCMemOwn) {
    +      swigCMemOwn = false;
    +      exampleJNI.delete_Test(swigCPtr);
    +    }
    +    swigCPtr = 0;
    +  }
    +
    +  // Call C++ constructor
    +  public Test() {
    +    this(exampleJNI.new_Test(), true);
    +  }
    +
    +}
     
    -

    Obviously, there is more to template wrapping than shown in this - example. More details can be found in the SWIG and - C++ chapter.

    -

    24.3.15 C++ Smart Pointers

    -

    In certain C++ programs, it is common to use classes that have been - wrapped by so-called "smart pointers." Generally, this involves the use - of a template class that implements operator->() like this:

    +

    It has two methods that call JNI methods, namely, +exampleJNI.new_Test() for the C++ constructor and +exampleJNI.delete_Test() for the C++ destructor. If the garbage + collector collects an instance of this class, ie delete() is + not explicitly called, then the C++ destructor will be run in a + different thread to the main thread. This is because when an object is + marked for garbage collection, any objects with finalizers are added to + a finalization queue and the objects in the finalization queue have + their finalize() methods run in a separate finalization + thread. Therefore, if the C memory allocator is not thread safe, then + the heap will get corrupted sooner or later, when a concurrent C++ + delete and new are executed. It is thus essential, even in single + threaded usage, to link to the C multi-thread runtime libraries, for + example, use the /MD option for Visual C++ on Windows. Alternatively, + lock all access to C++ functions that have heap + allocation/deallocation.

    +

    Note that some of the STL in Visual C++ 6 is not thread safe, so + although code might be linked to the multithread runtime libraries, + undefined behaviour might still occur in a single threaded Java + program. Similarly some older versions of Sun Studio have bugs in the + multi-threaded implementation of the std::string class and so will lead + to undefined behaviour in these supposedly single threaded Java + applications.

    +

    The following innocuous Java usage of Test is an example that will + crash very quickly on a multiprocessor machine if the JNI compiled code + is linked against the single thread C runtime libraries.

    -template<class T> class SmartPtr {
    -   ...
    -   T *operator->();
    -   ...
    +for (int i=0; i<100000; i++) {
    +  System.out.println("Iteration " + i);
    +  for (int k=0; k<10; k++) {
    +    Test test = new Test();
    +  }
    +  System.gc();
     }
     
    -

    Then, if you have a class like this,

    +

    25.4.4 Type wrapper classes

    +

    The generated type wrapper class, for say an int *, looks + like this:

    -class Foo {
    -public:
    -     int x;
    -     int bar();
    -};
    +public class SWIGTYPE_p_int {
    +  private transient long swigCPtr;
    +
    +  protected SWIGTYPE_p_int(long cPtr, boolean bFutureUse) {
    +    swigCPtr = cPtr;
    +  }
    +
    +  protected SWIGTYPE_p_int() {
    +    swigCPtr = 0;
    +  }
    +
    +  protected static long getCPtr(SWIGTYPE_p_int obj) {
    +    return obj.swigCPtr;
    +  }
    +}
     
    -

    A smart pointer would be used in C++ as follows:

    +

    The methods do not have public access, so by default it is + impossible to do anything with objects of this class other than pass + them around. The methods in the class are part of the inner workings of + SWIG. If you need to mess around with pointers you will have to use + some typemaps specific to the Java module to achieve this. The section + on Java typemaps details how to modify the + generated code.

    +

    Note that if you use a pointer or reference to a proxy class in a + function then no type wrapper class is generated because the proxy + class can be used as the function parameter. If however, you need + anything more complicated like a pointer to a pointer to a proxy class + then a typewrapper class is generated for your use.

    +

    Note that SWIG generates a type wrapper class and not a proxy class + when it has not parsed the definition of a type that gets used. For + example, say SWIG has not parsed the definition of class Snazzy + because it is in a header file that you may have forgotten to use the +%include directive on. Should SWIG parse Snazzy * being + used in a function parameter, it will then generates a type wrapper + class around a Snazzy pointer. Also recall from earlier that + SWIG will use a pointer when a class is passed by value or by + reference:

    -SmartPtr<Foo> p = CreateFoo();   // Created somehow (not shown)
    -...
    -p->x = 3;                        // Foo::x
    -int y = p->bar();                // Foo::bar
    +void spam(Snazzy *x, Snazzy &y, Snazzy z);
     
    -

    To wrap this in Java, simply tell SWIG about the SmartPtr - class and the low-level Foo object. Make sure you instantiate -SmartPtr using %template if necessary. For example:

    +

    Should SWIG not know anything about Snazzy then a +SWIGTYPE_p_Snazzy must be used for all 3 parameters in the spam + function. The Java function generated is:

    -%module example
    -...
    -%template(SmartPtrFoo) SmartPtr<Foo>;
    -...
    +public static void spam(SWIGTYPE_p_Snazzy x, SWIGTYPE_p_Snazzy y, SWIGTYPE_p_Snazzy z) {
    + ...
    +}
     
    -

    Now, in Java, everything should just "work":

    +

    Note that typedefs are tracked by SWIG and the typedef name is used + to construct the type wrapper class name. For example, consider the + case where Snazzy is a typedef to an int which SWIG + does parse:

    -SmartPtrFoo p = example.CreateFoo(); // Create a smart-pointer somehow
    -p.setX(3);                           // Foo::x
    -int y = p.bar();                     // Foo::bar
    +typedef int Snazzy;
    +void spam(Snazzy *x, Snazzy &y, Snazzy z);
     
    -

    If you ever need to access the underlying pointer returned by -operator->() itself, simply use the __deref__() method. - For example:

    +

    Because the typedefs have been tracked the Java function generated + is:

    -Foo f = p.__deref__();               // Returns underlying Foo *
    +public static void spam(SWIGTYPE_p_int x, SWIGTYPE_p_int y, int z) { ... }
     
    -

    24.4 Further details on the - generated Java classes

    -

    In the previous section, a high-level view of Java wrapping was - presented. A key component of this wrapping is that structures and - classes are wrapped by Java proxy classes and type wrapper classes are - used in situations where no proxies are generated. This provides a very - natural, type safe Java interface to the C/C++ code and fits in with - the Java programming paradigm. However, a number of low-level details - were omitted. This section provides a brief overview of how the proxy - classes work and then covers the type wrapper classes. Finally enum - classes are covered. First, the crucial intermediary JNI class is - considered.

    -

    24.4.1 The intermediary JNI class

    -

    In the "SWIG basics" and -"SWIG and C++" chapters, details of low-level structure and class - wrapping are described. To summarize those chapters, if you have a - global function and class like this

    +

    25.4.5 Enum classes

    +

    SWIG can generate three types of enum classes. The +Enumerations section discussed these but omitted all the details. + The following sub-sections detail the various types of enum classes + that can be generated.

    +

    25.4.5.1 Typesafe enum classes +

    +

    The following example demonstrates the typesafe enum classes which + SWIG generates:

    -class Foo {
    -public:
    -     int x;
    -     int spam(int num, Foo* foo);
    -};
    -void egg(Foo* chips);
    +%include "enumtypesafe.swg"
    +%javaconst(1);
    +enum Beverage { ALE, LAGER=10, STOUT, PILSNER, PILZ=PILSNER };
     
    -

    then SWIG transforms the class into a set of low-level procedural - wrappers. These procedural wrappers essentially perform the equivalent - of this C++ code:

    +

    The following is the code that SWIG generates:

    -Foo *new_Foo() {
    -    return new Foo();
    -}
    -void delete_Foo(Foo *f) {
    -    delete f;
    -}
    -int Foo_x_get(Foo *f) {
    -    return f->x;
    -}
    -void Foo_x_set(Foo *f, int value) {
    -    f->x = value;
    -}
    -int Foo_spam(Foo *f, int num, Foo* foo) {
    -    return f->spam(num, foo);
    +public final class Beverage {
    +  public final static Beverage ALE = new Beverage("ALE");
    +  public final static Beverage LAGER = new Beverage("LAGER", 10);
    +  public final static Beverage STOUT = new Beverage("STOUT");
    +  public final static Beverage PILSNER = new Beverage("PILSNER");
    +  public final static Beverage PILZ = new Beverage("PILZ", PILSNER);
    +
    +  public final int swigValue() {
    +    return swigValue;
    +  }
    +
    +  public String toString() {
    +    return swigName;
    +  }
    +
    +  public static Beverage swigToEnum(int swigValue) {
    +    if (swigValue < swigValues.length && swigValue >= 0 &&
    +        swigValues[swigValue].swigValue == swigValue)
    +      return swigValues[swigValue];
    +    for (int i = 0; i < swigValues.length; i++)
    +      if (swigValues[i].swigValue == swigValue)
    +        return swigValues[i];
    +    throw new IllegalArgumentException("No enum " + Beverage.class + " with value " +
    +                                                                         swigValue);
    +  }
    +
    +  private Beverage(String swigName) {
    +    this.swigName = swigName;
    +    this.swigValue = swigNext++;
    +  }
    +
    +  private Beverage(String swigName, int swigValue) {
    +    this.swigName = swigName;
    +    this.swigValue = swigValue;
    +    swigNext = swigValue+1;
    +  }
    +
    +  private Beverage(String swigName, Beverage swigEnum) {
    +    this.swigName = swigName;
    +    this.swigValue = swigEnum.swigValue;
    +    swigNext = this.swigValue+1;
    +  }
    +
    +  private static Beverage[] swigValues = { ALE, LAGER, STOUT, PILSNER, PILZ };
    +  private static int swigNext = 0;
    +  private final int swigValue;
    +  private final String swigName;
     }
     
    -

    These procedural function names don't actually exist, but their - functionality appears inside the generated JNI functions. The JNI - functions have to follow a particular naming convention so the function - names are actually:

    +

    As can be seen, there are a fair number of support methods for the + typesafe enum pattern. The typesafe enum pattern involves creating a + fixed number of static instances of the enum class. The constructors + are private to enforce this. Three constructors are available - two for + C/C++ enums with an initializer and one for those without an + initializer. Note that the two enums with initializers, LAGER + and PILZ, each call one the two different initializer + constructors. In order to use one of these typesafe enums, the +swigToEnum static method must be called to return a reference to + one of the static instances. The JNI layer returns the enum value from + the C/C++ world as an integer and this method is used to find the + appropriate Java enum static instance. The swigValue method is + used for marshalling in the other direction. The toString + method is overridden so that the enum name is available.

    +

    25.4.5.2 Proper Java enum + classes

    +

    The following example demonstrates the Java enums approach:

    -SWIGEXPORT jlong JNICALL Java_exampleJNI_new_1Foo(JNIEnv *jenv, jclass jcls);
    -SWIGEXPORT void JNICALL Java_exampleJNI_delete_1Foo(JNIEnv *jenv, jclass jcls,
    -                                                    jlong jarg1);
    -SWIGEXPORT void JNICALL Java_exampleJNI_Foo_1x_1set(JNIEnv *jenv, jclass jcls,
    -                                                    jlong jarg1, jobject jarg1_, jint jarg2);
    -SWIGEXPORT jint JNICALL Java_exampleJNI_Foo_1x_1get(JNIEnv *jenv, jclass jcls,
    -                                                    jlong jarg1, jobject jarg1_);
    -SWIGEXPORT jint JNICALL Java_exampleJNI_Foo_1spam(JNIEnv *jenv, jclass jcls,
    -                                                  jlong jarg1, jobject jarg1_, jint jarg2,
    -                                                  jlong jarg3, jobject jarg3_);
    -SWIGEXPORT void JNICALL Java_exampleJNI_egg(JNIEnv *jenv, jclass jcls,
    -                                            jlong jarg1, jobject jarg1_);
    +%include "enums.swg"
    +%javaconst(1);
    +enum Beverage { ALE, LAGER=10, STOUT, PILSNER, PILZ=PILSNER };
     
    -

    For every JNI C function there has to be a static native Java - function. These appear in the intermediary JNI class:

    +

    SWIG will generate the following Java enum:

    -class exampleJNI {
    -  public final static native long new_Foo();
    -  public final static native void delete_Foo(long jarg1);
    -  public final static native void Foo_x_set(long jarg1, Foo jarg1_, int jarg2);
    -  public final static native int Foo_x_get(long jarg1, Foo jarg1_);
    -  public final static native int Foo_spam(long jarg1, Foo jarg1_, int jarg2,
    -                                          long jarg3, Foo jarg3_);
    -  public final static native void egg(long jarg1, Foo jarg1_);
    +public enum Beverage {
    +  ALE,
    +  LAGER(10),
    +  STOUT,
    +  PILSNER,
    +  PILZ(PILSNER);
    +
    +  public final int swigValue() {
    +    return swigValue;
    +  }
    +
    +  public static Beverage swigToEnum(int swigValue) {
    +    Beverage[] swigValues = Beverage.class.getEnumConstants();
    +    if (swigValue < swigValues.length && swigValue >= 0 &&
    +        swigValues[swigValue].swigValue == swigValue)
    +      return swigValues[swigValue];
    +    for (Beverage swigEnum : swigValues)
    +      if (swigEnum.swigValue == swigValue)
    +        return swigEnum;
    +    throw new IllegalArgumentException("No enum " + Beverage.class +
    +                                       " with value " + swigValue);
    +  }
    +
    +  private Beverage() {
    +    this.swigValue = SwigNext.next++;
    +  }
    +
    +  private Beverage(int swigValue) {
    +    this.swigValue = swigValue;
    +    SwigNext.next = swigValue+1;
    +  }
    +
    +  private Beverage(Beverage swigEnum) {
    +    this.swigValue = swigEnum.swigValue;
    +    SwigNext.next = this.swigValue+1;
    +  }
    +
    +  private final int swigValue;
    +
    +  private static class SwigNext {
    +    private static int next = 0;
    +  }
     }
     
    -

    This class contains the complete Java - C/C++ interface so all - function calls go via this class. As this class acts as a go-between - for all JNI calls to C/C++ code from the Java -proxy classes, type wrapper - classes and module class, it is - known as the intermediary JNI class.

    -

    You may notice that SWIG uses a Java long wherever a pointer or - class object needs to be marshalled across the Java-C/C++ boundary. - This approach leads to minimal JNI code which makes for better - performance as JNI code involves a lot of string manipulation. SWIG - favours generating Java code over JNI code as Java code is compiled - into byte code and avoids the costly string operations needed in JNI - code. This approach has a downside though as the proxy class might get - collected before the native method has completed. You might notice - above that there is an additional parameters with a underscore postfix, - eg jarg1_. These are added in order to prevent -premature garbage collection when marshalling proxy classes.

    -

    The functions in the intermediary JNI class cannot be accessed - outside of its package. Access to them is gained through the module - class for globals otherwise the appropriate proxy class.

    - -

    The name of the intermediary JNI class can be changed from its - default, that is, the module name with JNI appended after it. The - module directive attribute jniclassname is used to achieve - this:

    +

    The enum items appear first. Like the typesafe enum pattern, the + constructors are private. The constructors are required to handle C/C++ + enums with initializers. The next variable is in the +SwigNext inner class rather than in the enum class as static + primitive variables cannot be modified from within enum constructors. + Marshalling between Java enums and the C/C++ enum integer value is + handled via the swigToEnum and swigValue methods. All + the constructors and methods in the Java enum are required just to + handle C/C++ enums with initializers. These needn't be generated if the + enum being wrapped does not have any initializers and the +Simpler Java enums for enums without initializers section describes + how typemaps can be used to achieve this.

    +

    25.4.5.3 Type unsafe enum + classes

    +

    The following example demonstrates type unsafe enums:

    +
    +
    +%include "enumtypeunsafe.swg"
    +%javaconst(1);
    +enum Beverage { ALE, LAGER=10, STOUT, PILSNER, PILZ=PILSNER };
    +
    +
    +

    SWIG will generate the following simple class:

    -%module (jniclassname="name") modulename
    +public final class Beverage {
    +  public final static int ALE = 0;
    +  public final static int LAGER = 10;
    +  public final static int STOUT = LAGER + 1;
    +  public final static int PILSNER = STOUT + 1;
    +  public final static int PILZ = PILSNER;
    +}
     
    -

    If name is the same as modulename then the module - class name gets changed from modulename to -modulenameModule.

    -

    24.4.1.1 The intermediary JNI - class pragmas

    -

    The intermediary JNI class can be tailored through the use of - pragmas, but is not commonly done. The pragmas for this class are:

    - - - +

    25.4.6 Interfaces

    +

    By default SWIG wraps all C++ classes as Java classes. As Java only + supports derivation from a single base class, SWIG has to ignore all + bases except the first when a C++ class inherits from more than one + base class. However, there is a family of SWIG macros that change the + default wrapping and allows a C++ class to be wrapped as a Java + interface instead of a Java class. These macros provide a way to + support some sort of multiple inheritance as there is no limit to the + number of interfaces that a Java class can inherit from.

    +

    When a C++ class is wrapped as a Java interface, a Java proxy class + is still needed. The swiginterface.i library file provides + three macros for marking a C++ class to be wrapped as a Java interface. + There is more than one macro in order to provide a choice for choosing + the Java interface and Java proxy names.

    +
    PragmaDescription
    jniclassbaseBase class for the intermediary JNI class
    + + + + +
    Interface Macro NameDescription +
    %interface(CTYPE)Proxy class name is + unchanged, interface name has SwigInterface added as a suffix + for C++ class CTYPE.
    %interface_impl(CTYPE)Proxy class name has +SwigImpl as a suffix, interface name has SwigInterface + added as a suffix for C++ class CTYPE.
    %interface_custom("PROXY", "INTERFACE", CTYPE) +Proxy class name is given by the string PROXY, interface name + is given by the string INTERFACE for C++ class CTYPE. + The PROXY and INTERFACE names can use the +string formatting functions used in %rename.
    +

    The table below has a few examples showing the resulting proxy and + interface names.

    + + + + + + + + - - - - -
    Example UsageProxy Class Name +Interface Class Name
    %interface(Base)Base +BaseSwigInterface
    %interface_impl(Base)BaseSwigImpl +Base
    %interface_custom("BaseProxy", "IBase", Base) +BaseProxyIBase
    %interface_custom("%sProxy", "IBase", Base) +BaseProxyIBase
    %interface_custom("%sProxy", "%sInterface", Base) +BaseProxyBaseProxyInterface
    %interface_custom("%sProxy", "%(rstrip:[Proxy])sInterface", + Base)BaseProxyBaseInterface
    jniclasspackagePackage in which to place the - intermediary JNI class
    jniclassclassmodifiersClass modifiers and class type - for the intermediary JNI class
    jniclasscodeJava code is copied verbatim into the - intermediary JNI class
    jniclassimportsJava code, usually one or more import - statements, placed before the intermediary JNI class definition
    jniclassinterfacesComma separated interface classes for - the intermediary JNI class
    -

    The pragma code appears in the generated intermediary JNI class - where you would expect:

    +

    The 2nd last example shows the names used in the string formatting + functions. The input for PROXY that "%s" expands to + is the proxy name, that is, Base. The input for INTERFACE that + "%s" expands to is the proxy name, that is, BaseProxy +.

    +

    The last example shows rstrip and in this case strips the +Proxy suffix and then adds on Interface.

    +

    Consider the following C++ code:

    -[ jniclassimports pragma ]
    -[ jniclassclassmodifiers pragma ] jniclassname extends [ jniclassbase pragma ]
    -                                          implements [ jniclassinterfaces pragma ] {
    -[ jniclasscode pragma ]
    -... SWIG generated native methods ...
    +namespace Space {
    +  struct Base1 {
    +    virtual void Method1();
    +  };
    +  struct Base2 {
    +    virtual void Method2();
    +  };
    +  struct Derived : Base1, Base2 {
    +  };
    +  void UseBases(const Base1 &b1, const Base2 &b2);
     }
     
    -

    The jniclasscode pragma is quite useful for adding in a - static block for loading the shared library / dynamic link library and - demonstrates how pragmas work:

    -
    +

    By default all classes are wrapped and are available in Java, but, +Derived has all bases ignored except the first. SWIG generates a + warning for the above code:

    +
    -%pragma(java) jniclasscode=%{
    -  static {
    -    try {
    -        System.loadLibrary("example");
    -    } catch (UnsatisfiedLinkError e) {
    -      System.err.println("Native code library failed to load. \n" + e);
    -      System.exit(1);
    -    }
    -  }
    -%}
    +example.i:10: Warning 813: Warning for Derived, base Base2 ignored. 
    +Multiple inheritance is not supported in Java.
     
    -

    Pragmas will take either "" or %{ %} as - delimiters. For example, let's change the intermediary JNI class access - to just the default package-private access.

    +

    If we decide to wrap the two base classes as interfaces and add the + following before SWIG parses the above example code:

    -%pragma(java) jniclassclassmodifiers="class"
    +%include <swiginterface.i>
    +%interface_impl(Space::Base1);
    +%interface_impl(Space::Base2);
     
    -

    All the methods in the intermediary JNI class will then not be - callable outside of the package as the method modifiers have been - changed from public access to default access. This is useful if you - want to prevent users calling these low level functions.

    -

    24.4.2 The Java module class

    -

    All global functions and variable getters/setters appear in the - module class. For our example, there is just one function:

    +

    then two interface files are generated, Base1.java and Base2.java in + addition to proxy class files, Base1SwigImpl.java and + Base2SwigImpl.java. The contents of interface file Base1.java for +Base1 is shown below:

    -public class example {
    -  public static void egg(Foo chips) {
    -    exampleJNI.egg(Foo.getCPtr(chips), chips);
    -  }
    +public interface Base1 {
    +  long Base1_GetInterfaceCPtr();
    +  void Method1();
     }
     
    -

    The module class is necessary as there is no such thing as a global - in Java so all the C globals are put into this class. They are - generated as static functions and so must be accessed as such by using - the module name in the static function call:

    -
    -
    -example.egg(new Foo());
    -
    -
    -

    The primary reason for having the module class wrapping the calls in - the intermediary JNI class is to implement static type checking. In - this case only a Foo can be passed to the egg - function, whereas any long can be passed to the egg - function in the intermediary JNI class.

    -

    24.4.2.1 The Java module - class pragmas

    -

    The module class can be tailored through the use of pragmas, in the - same manner as the intermediary JNI class. The pragmas are similarly - named and are used in the same way. The complete list follows:

    - - - - - - - -
    PragmaDescription
    modulebaseBase class for the module class
    moduleclassmodifiersClass modifiers and class type for - the module class
    modulecodeJava code is copied verbatim into the module - class
    moduleimportsJava code, usually one or more import - statements, placed before the module class definition
    moduleinterfacesComma separated interface classes for - the module class
    -

    The pragma code appears in the generated module class like this:

    +

    The proxy class in Base1SwigImpl.java for Base1 is as it would have + been if %interface was not used, except the name has changed + to Base1SwigImpl and it implements the appropriate base:

    -[ moduleimports pragma ]
    -[ modulemodifiers pragma ] modulename extends [ modulebase pragma ]
    -                                      implements [ moduleinterfaces pragma ] {
    -[ modulecode pragma ]
    -... SWIG generated wrapper functions ...
    +public class Base1SwigImpl implements Base1 {
    +...
    +  public long Base1_GetInterfaceCPtr() {
    +    return exampleJNI.Base1SwigImpl_Base1_GetInterfaceCPtr(swigCPtr);
    +  }
    +
    +  public void Method1() {
    +    exampleJNI.Base1SwigImpl_Method1(swigCPtr, this);
    +  }
    +...
     }
     
    -

    See The intermediary JNI class - pragmas section for further details on using pragmas.

    -

    24.4.3 Java proxy classes

    -

    A Java proxy class is generated for each structure, union or C++ - class that is wrapped. Proxy classes have also been called -peer classes. The default proxy class for our previous example looks - like this:

    +

    In fact any class deriving from Base will now implement the + interface instead of deriving from it (or ignoring the base in the case + of multiple base classes). Hence the Derived proxy class will + now implement both bases:

    -public class Foo {
    -  private long swigCPtr;
    -  protected boolean swigCMemOwn;
    -
    -  protected Foo(long cPtr, boolean cMemoryOwn) {
    -    swigCMemOwn = cMemoryOwn;
    -    swigCPtr = cPtr;
    +public class Derived implements Base1, Base2 {
    +...
    +  public long Base1_GetInterfaceCPtr() {
    +    return exampleJNI.Derived_Base1_GetInterfaceCPtr(swigCPtr);
       }
     
    -  protected static long getCPtr(Foo obj) {
    -    return (obj == null) ? 0 : obj.swigCPtr;
    +  public long Base2_GetInterfaceCPtr() {
    +    return exampleJNI.Derived_Base2_GetInterfaceCPtr(swigCPtr);
       }
     
    -  protected void finalize() {
    -    delete();
    +  public void Method1() {
    +    exampleJNI.Derived_Method1(swigCPtr, this);
       }
     
    -  public synchronized void delete() {
    -    if(swigCPtr != 0 && swigCMemOwn) {
    -      swigCMemOwn = false;
    -      exampleJNI.delete_Foo(swigCPtr);
    -    }
    -    swigCPtr = 0;
    +  public void Method2() {
    +    exampleJNI.Derived_Method2(swigCPtr, this);
       }
    -
    -  public void setX(int value) {
    -    exampleJNI.Foo_x_set(swigCPtr, this, value);
    +...
    +}
    +
    +
    +

    Wherever a class marked as an interface is used, such as the +UseBases method in the example, the interface name is used as the + type in the Java layer:

    +
    +
    +  public static void UseBases(Base1 b1, Base2 b2) {
    +    exampleJNI.UseBases(b1.Base1_GetInterfaceCPtr(), b1, b2.Base2_GetInterfaceCPtr(), b2);
       }
    +
    +
    +

    Note that each Java interface has a method added to obtain the + correct C++ pointer for passing to the native function - +Base1_GetInterfaceCPtr for Base1. This method is similar + to the getCPtr method in the proxy classes. In fact, as shown + above in the Derived class, the proxy classes implement this + generated interface by calling a native method ( +Derived_Base1_GetInterfaceCPtr) which calls an appropriate C++ cast + of the pointer up the inheritance chain.

    +

    The interface macros are implemented using the interface + feature and typemaps. For example:

    +
    +
    +%define %interface(CTYPE...)
    +%feature("interface", name="%sSwigInterface") CTYPE;
    +INTERFACE_TYPEMAPS(CTYPE)
    +%enddef
    +
    +
    +

    The feature accepts one attribute called name, which is the + name of the Java interface mentioned earlier. The +INTERFACE_TYPEMAPS macro implements the typemaps and can be viewed + in the swiginterface.i file and contain the usual Java + typemaps for generating code plus the javainterfacecode + typemap which is only used when a class is marked with the +interface feature. See Java code + typemaps for details.

    +

    25.5 Cross language polymorphism using + directors

    +

    Proxy classes provide a natural, object-oriented way to wrap C++ + classes. as described earlier, each proxy instance has an associated + C++ instance, and method calls from Java to the proxy are passed to the + C++ instance transparently via C wrapper functions.

    +

    This arrangement is asymmetric in the sense that no corresponding + mechanism exists to pass method calls down the inheritance chain from + C++ to Java. In particular, if a C++ class has been extended in Java + (by deriving from the proxy class), these classes will not be visible + from C++ code. Virtual method calls from C++ are thus not able to + access the lowest implementation in the inheritance chain.

    +

    SWIG can address this problem and make the relationship between C++ + classes and proxy classes more symmetric. To achieve this goal, new + classes called directors are introduced at the bottom of the C++ + inheritance chain. The job of the directors is to route method calls + correctly, either to C++ implementations higher in the inheritance + chain or to Java implementations lower in the inheritance chain. The + upshot is that C++ classes can be extended in Java and from C++ these + extensions look exactly like native C++ classes. Neither C++ code nor + Java code needs to know where a particular method is implemented: the + combination of proxy classes, director classes, and C wrapper functions + transparently takes care of all the cross-language method routing.

    +

    25.5.1 Enabling directors

    +

    The director feature is disabled by default. To use directors you + must make two changes to the interface file. First, add the "directors" + option to the %module directive, like this:

    +
    +
    +%module(directors="1") modulename
    +
    +
    +

    Without this option no director code will be generated. Second, you + must use the %feature("director") directive to tell SWIG which classes + and methods should get directors. The %feature directive can be applied + globally, to specific classes, and to specific methods, like this:

    +
    +
    +// generate directors for all classes that have virtual methods
    +%feature("director");         
     
    -  public int getX() {
    -    return exampleJNI.Foo_x_get(swigCPtr, this);
    -  }
    +// generate directors for all virtual methods in class Foo
    +%feature("director") Foo;      
    +
    +
    +

    You can use the %feature("nodirector") directive to turn off + directors for specific classes or methods. So for example,

    +
    +
    +%feature("director") Foo;
    +%feature("nodirector") Foo::bar;
    +
    +
    +

    will generate directors for all virtual methods of class Foo except + bar().

    +

    Directors can also be generated implicitly through inheritance. In + the following, class Bar will get a director class that handles the + methods one() and two() (but not three()):

    +
    +
    +%feature("director") Foo;
    +class Foo {
    +public:
    +    virtual void one();
    +    virtual void two();
    +};
     
    -  public int spam(int num, Foo foo) {
    -    return exampleJNI.Foo_spam(swigCPtr, this, num, Foo.getCPtr(foo), foo);
    -  }
    +class Bar: public Foo {
    +public:
    +    virtual void three();
    +};
    +
    +
    +

    25.5.2 Director classes

    +

    For each class that has directors enabled, SWIG generates a new + class that derives from both the class in question and a special +Swig::Director class. These new classes, referred to as director + classes, can be loosely thought of as the C++ equivalent of the Java + proxy classes. The director classes store a pointer to their underlying + Java proxy classes.

    +

    For simplicity let's ignore the Swig::Director class and + refer to the original C++ class as the director's base class. By + default, a director class extends all virtual methods in the + inheritance chain of its base class (see the preceding section for how + to modify this behavior). Thus all virtual method calls, whether they + originate in C++ or in Java via proxy classes, eventually end up in at + the implementation in the director class. The job of the director + methods is to route these method calls to the appropriate place in the + inheritance chain. By "appropriate place" we mean the method that would + have been called if the C++ base class and its Java derived classes + were seamlessly integrated. That seamless integration is exactly what + the director classes provide, transparently skipping over all the messy + JNI glue code that binds the two languages together.

    +

    In reality, the "appropriate place" is one of only two + possibilities: C++ or Java. Once this decision is made, the rest is + fairly easy. If the correct implementation is in C++, then the lowest + implementation of the method in the C++ inheritance chain is called + explicitly. If the correct implementation is in Java, the Java API is + used to call the method of the underlying Java object (after which the + usual virtual method resolution in Java automatically finds the right + implementation).

    +

    25.5.3 Overhead and code bloat

    +

    Enabling directors for a class will generate a new director method + for every virtual method in the class' inheritance chain. This alone + can generate a lot of code bloat for large hierarchies. Method + arguments that require complex conversions to and from Java types can + result in large director methods. For this reason it is recommended + that directors are selectively enabled only for specific classes that + are likely to be extended in Java and used in C++.

    +

    Although directors make it natural to mix native C++ objects with + Java objects (as director objects), one should be aware of the obvious + fact that method calls to Java objects from C++ will be much slower + than calls to C++ objects. Additionally, compared to classes that do + not use directors, the call routing in the director methods adds a + small overhead. This situation can be optimized by selectively enabling + director methods (using the %feature directive) for only those methods + that are likely to be extended in Java.

    +

    25.5.4 Simple directors example

    +

    Consider the following SWIG interface file:

    +
    +
    +%module(directors="1") example;
     
    -  public Foo() {
    -    this(exampleJNI.new_Foo(), true);
    +%feature("director") DirectorBase;
    +
    +class DirectorBase {
    +public:
    +  virtual ~DirectorBase() {}
    +  virtual void upcall_method() {}
    +};
    +
    +void callup(DirectorBase *director) {
    +  director->upcall_method();
    +}
    +
    +
    +

    The following DirectorDerived Java class is derived + from the Java proxy class DirectorBase and overrides +upcall_method(). When C++ code invokes upcall_method() +, the SWIG-generated C++ code redirects the call via JNI to the Java +DirectorDerived subclass. Naturally, the SWIG generated C++ code + and the generated Java intermediary class marshal and convert arguments + between C++ and Java when needed.

    +
    +
    +public class DirectorDerived extends DirectorBase {
    +  public DirectorDerived() {
       }
     
    +  public void upcall_method() {
    +    System.out.println("DirectorDerived::upcall_method() invoked.");
    +  }
     }
     
    -

    This class merely holds a pointer to the underlying C++ object ( -swigCPtr). It also contains all the methods in the C++ class it is - proxying plus getters and setters for public member variables. These - functions call the native methods in the intermediary JNI class. The - advantage of having this extra layer is the type safety that the proxy - class functions offer. It adds static type checking which leads to - fewer surprises at runtime. For example, you can see that if you - attempt to use the spam() function it will only compile when - the parameters passed are an int and a Foo. From a - user's point of view, it makes the class work as if it were a Java - class:

    +

    Running the following Java code

    -Foo f = new Foo();
    -f.setX(3);
    -int y = f.spam(5, new Foo());
    +DirectorDerived director = new DirectorDerived();
    +example.callup(director);
     
    -

    24.4.3.1 Memory management

    -

    Each proxy class has an ownership flag swigCMemOwn. The - value of this flag determines who is responsible for deleting the - underlying C++ object. If set to true, the proxy class's - finalizer will destroy the C++ object when the proxy class is garbage - collected. If set to false, then the destruction of the proxy class has - no effect on the C++ object.

    -

    When an object is created by a constructor or returned by value, - Java automatically takes ownership of the result. On the other hand, - when pointers or references are returned to Java, there is often no way - to know where they came from. Therefore, the ownership is set to false. - For example:

    +

    will result in the following being output:

    -class Foo {
    -public:
    -    Foo();
    -    Foo bar1();
    -    Foo &bar2();
    -    Foo *bar2();
    -};
    +DirectorDerived::upcall_method() invoked.
     
    -

    In Java:

    +

    25.5.5 Director threading issues +

    +

    Depending on your operating system and version of Java and how you + are using threads, you might find the JVM hangs on exit. There are a + couple of solutions to try out. The preferred solution requires jdk-1.4 + and later and uses AttachCurrentThreadAsDaemon instead of +AttachCurrentThread whenever a call into the JVM is required. This + can be enabled by defining the + SWIG_JAVA_ATTACH_CURRENT_THREAD_AS_DAEMON macro when compiling the C++ + wrapper code. For older JVMs define SWIG_JAVA_NO_DETACH_CURRENT_THREAD + instead, to avoid the DetachCurrentThread call but this will + result in a memory leak instead. For further details inspect the source + code in the java/director.swg library file.

    +

    Macros can be defined on the commandline when compiling your C++ + code, or alternatively added to the C++ wrapper file as shown below:

    -Foo f = new Foo();   //  f.swigCMemOwn = true
    -Foo f1 = f.bar1();   // f1.swigCMemOwn = true
    -Foo f2 = f.bar2();   // f2.swigCMemOwn = false
    -Foo f3 = f.bar3();   // f3.swigCMemOwn = false
    +%insert("runtime") %{
    +#define SWIG_JAVA_NO_DETACH_CURRENT_THREAD
    +%}
     
    -

    This behavior for pointers and references is especially important - for classes that act as containers. For example, if a method returns a - pointer to an object that is contained inside another object, you - definitely don't want Java to assume ownership and destroy it!

    -

    For the most part, memory management issues remain hidden. However, - there are situations where you might have to manually change the - ownership of an object. For instance, consider code like this:

    +

    25.5.6 Director performance + tuning

    +

    When a new instance of a director (or subclass) is created in Java, + the C++ side of the director performs a runtime check per director + method to determine if that particular method is overridden in Java or + if it should invoke the C++ base implementation directly. Although this + makes initialization slightly more expensive, it is generally a good + overall tradeoff.

    +

    However, if all director methods are expected to usually be + overridden by Java subclasses, then initialization can be made faster + by avoiding these checks via the assumeoverride attribute. For + example:

    -class Obj {};
    -class Node {
    -   Obj *value;
    -public:
    -   void set_value(Obj *v) { value = v; }
    -};
    +%feature("director", assumeoverride=1) Foo;
     
    -

    Now, consider the following Java code:

    +

    The disadvantage is that invocation of director methods from C++ + when Java doesn't actually override the method will require an + additional call up into Java and back to C++. As such, this option is + only useful when overrides are extremely common and instantiation is + frequent enough that its performance is critical.

    +

    25.5.7 Java exceptions from + directors

    +

    With directors routing method calls to Java, and proxies routing + them to C++, the handling of exceptions is an important concern. The + default behavior from SWIG 3.0 onwards is to convert the thrown Java + exception into a SWIG defined DirectorException C++ + exception. SWIG 2.0 and earlier versions didn't provide any mechanism + to handle the Java director method exceptions in C++.

    +

    Converting Java exceptions into C++ exceptions can be done in two + different ways using the director:except +feature. In the simplest approach, a code block is attached to each + director method to handle the mapping of Java exceptions into C++ + exceptions.

    -Node n = new Node();    // Create a node
    -{
    -  Obj o = new Obj();    // Create an object
    -  n.set_value(o);       // Set value
    -}                       // o goes out of scope
    +%feature("director:except") MyClass::method(int x) {
    +  jthrowable $error = jenv->ExceptionOccurred();
    +  if ($error) {
    +    jenv->ExceptionClear();
    +    if (Swig::ExceptionMatches(jenv, $error, "java/lang/IndexOutOfBoundsException"))
    +      throw std::out_of_range(Swig::JavaExceptionMessage(jenv, $error).message());
    +    if (Swig::ExceptionMatches(jenv, $error, "$packagepath/MyJavaException"))
    +      throw MyCppException(Swig::JavaExceptionMessage(jenv, $error).message());
    +    throw std::runtime_error("Unexpected exception thrown in MyClass::method");
    +  }
    +}
    +
    +class MyClass {
    +  /** Throws either a std::out_of_range or MyCppException on error */
    +  void method(int x);
    +}
    +
    +
    +

    This approach allows a flexible mapping of Java exceptions thrown by + director methods into C++ exceptions expected by a C++ caller. There + need not be any C++ exception specifications on the C++ + method. The utility function Swig::ExceptionMatches and + class Swig::JavaExceptionMessage are provided to simplify + writing code for wrappers that use the director:except + feature. The function Swig::ExceptionMatches matches the + type of the jthrowable thrown against a fully qualified + JNI style class name, such as "java/lang/IOError". If the + throwable class is the same type, or derives from the given type, +Swig::ExceptionMatches will return true. Care must be taken to + provide the correct fully qualified name, since for wrapped exceptions + the generated proxy class will have additional package qualification, + depending on the '-package' argument and use of the +nspace feature. The special variable $error is expanded + by SWIG into a unique variable name and should be used for the + assignment of the exception that occurred. The special variable +$packagepath is replaced by the outer package provided for SWIG + generation by the -package option. The utility class +Swig::JavaExceptionMessage is a holder providing access to the + message from the thrown Java exception. The message() + method returns the exception message as a const char *, + which is only valid during the lifetime of the holder. Any code using + this message needs to copy it, for example into a std::string or a + newly constructed C++ exception.

    +

    Using the above approach to write handlers for a large number of + methods will require repetitive duplication of the +director:except feature code. To mitigate this, an alternative + approach is provided via typemaps in a fashion analagous to the +"throws" typemap. The "throws" typemap provides an approach to + automatically map all the C++ exceptions listed in a method's defined + exceptions (either from a C++ exception specification or a +%catches feature) into Java exceptions. The "directorthrows" + typemap provides the inverse mapping and should contain code to convert + a suitably matching Java exception into a C++ exception. The example + below converts a Java java.lang.IndexOutOfBoundsException + exception to the typemap's type, that is std::out_of_range +:

    +
    +%typemap(directorthrows) std::out_of_range %{
    +  if (Swig::ExceptionMatches(jenv, $error, "java/lang/IndexOutOfBoundsException")) {
    +    throw std::out_of_range(Swig::JavaExceptionMessage(jenv, $error).message());
    +  }
    +%}
    +
    +

    +

    The "directorthrows" typemap is then used in conjunction with the +director:except feature if the $directorthrowshandlers + special variable is used in the feature code. Consider the following, + which also happens to be the default:

    +
    +
    +%feature("director:except") %{
    +   jthrowable $error = jenv->ExceptionOccurred();
    +   if ($error) {
    +     jenv->ExceptionClear();
    +     $directorthrowshandlers
    +     throw Swig::DirectorException(jenv, $error);
    +   }
    +%}
     
    -

    In this case, the Node n is holding a reference to o - internally. However, SWIG has no way to know that this has occurred. - The Java proxy class still thinks that it has ownership of o. - As o has gone out of scope, it could be garbage collected in - which case the C++ destructor will be invoked and n will then - be holding a stale-pointer to o. If you're lucky, you will - only get a segmentation fault.

    -

    To work around this, the ownership flag of o needs changing - to false. The ownership flag is a private member variable of - the proxy class so this is not possible without some customization of - the proxy class. This can be achieved by using a typemap to customise - the proxy class with pure Java code as detailed later in the section on - Java typemaps.

    -

    Sometimes a function will create memory and return a pointer to a - newly allocated object. SWIG has no way of knowing this so by default - the proxy class does not manage the returned object. However, you can - tell the proxy class to manage the memory if you specify the -%newobject directive. Consider:

    +

    The code generated using the director:except feature + replaces the $directorthrowshandlers special variable with + the code in the "directorthrows" typemaps, for each and every exception + defined for the method. The possible exceptions can be defined either + with a C++ exception specification or %catches as + described for the "throws" typemap.

    +

    Consider the following director method:

    -class Obj {...};
    -class Factory {
    -public:
    -    static Obj *createObj() { return new Obj(); }
    -};
    +  ...
    +  virtual void doSomething(int index) throw (std::out_of_range);
    +  ...
     
    -

    If we call the factory function, then we have to manually delete the - memory:

    +

    When combined with the default director:except feature + and the "directorthrows" typemap above, the resulting code generated in + the director method after calling up to Java will be:

    -Obj obj = Factory.createObj();   // obj.swigCMemOwn = false
    -...
    -obj.delete();
    +jthrowable swigerror = jenv->ExceptionOccurred();
    +if (swigerror) {
    +  jenv->ExceptionClear();
    +  if (Swig::ExceptionMatches(jenv, swigerror, "java/lang/IndexOutOfBoundsException")) {
    +    throw std::out_of_range(Swig::JavaExceptionMessage(jenv, swigerror).message());
    +  }
    +  
    +  throw Swig::DirectorException(jenv, swigerror);
    +}
     
    -

    Now add in the %newobject directive:

    +

    Note: Beware of using exception specifications as the SWIG + director methods will be generated with the same exception + specifications and if the director method throws an exception that is + not specified it is likely to terminate your program. See the C++ + standard for more details. Using the %catches feature instead to define + the handled exceptions does not suffer this potential fate.

    +

    Because the default code generation maps any unhandled Java + exceptions to Swig::DirectorException, any director + methods that have exception specifications may cause program + termination. To simply ignore unexpected exceptions, the default + handling can be changed with:

    -%newobject Factory::createObj();
    -
    -class Obj {...};
    -class Factory {
    -public:
    -    static Obj *createObj() { return new Obj(); }
    -};
    +%feature("director:except") %{
    +   jthrowable $error = jenv->ExceptionOccurred();
    +   if ($error) {
    +     jenv->ExceptionClear();
    +     $directorthrowshandlers
    +     return $null; // exception is ignored
    +   }
    +%}
     
    -

    A call to delete() is no longer necessary as the garbage - collector will make the C++ destructor call because swigCMemOwn - is now true.

    +

    Alternatively an exception compatible with the existing director + method exception specifications can be thrown. Assuming that all + methods allow std::runtime_error to be thrown, the return $null; + could be changed to:

    -Obj obj = Factory.createObj();   // obj.swigCMemOwn = true;
    -...
    +   throw std::runtime_error(Swig::JavaExceptionMessage(jenv, $error).message());
     
    -

    Some memory management issues are quite tricky to fix and may only - be noticeable after using for a long time. One such issue is premature - garbage collection of an object created from Java and resultant usage - from C++ code. The section on typemap examples cover two such - scenarios, Memory management - for objects passed to the C++ layer and -Memory management when returning references to member variables

    -

    24.4.3.2 Inheritance

    -

    Java proxy classes will mirror C++ inheritance chains. For example, - given the base class Base and its derived class Derived -:

    +

    In more complex situations, a separate director:except + feature may need to be attached to specific methods.

    +

    Below is a complete example demonstrating the use of the + "directorthrows" typemaps. In this example, a generic "directorthrows" + typemap is appropriate for all three exceptions - all take single + string constructors. If the exceptions had different constructors, it + would be necessary to have separate typemaps for each exception type. +

    -class Base {
    -public:
    -  virtual double foo();
    -};
    +%module(directors="1") example
     
    -class Derived : public Base {
    -public:
    -  virtual double foo();
    -};
    +%{
    +  #include <string>
    +  #include <stdexcept>
    +%}
    +
    +// Define exceptions in header section using std::runtime_error
    +%define DEFINE_EXCEPTION(NAME)
    +%{
    +  namespace MyNS {
    +    struct NAME : public std::runtime_error { NAME(const std::string &what) : runtime_error(what) {} };
    +  }
    +%}
    +%enddef
    +
    +// Expose C++ exceptions as Java Exceptions by changing the Java base class and providing a getMessage()
    +%define DECLARE_EXCEPTION(NAME)
    +%typemap(javabase) MyNS::NAME "java.lang.Exception";
    +%rename(getMessage) MyNS::NAME::what;
    +namespace MyNS {
    +  struct NAME {
    +    NAME(const std::string& what);
    +    const char * what();
    +  };
    +}
    +%enddef
    +
    +DEFINE_EXCEPTION(ExceptionA)
    +DEFINE_EXCEPTION(ExceptionB)
    +DEFINE_EXCEPTION(Unexpected)
    +
    +// Mark three methods to map director thrown exceptions.
    +%feature("director:except") MyClass::meth1(int);
    +%feature("director:except") MyClass::meth2;
    +%feature("director:except") meth3;
    +
    +%typemap(directorthrows) MyNS::ExceptionA, MyNS::ExceptionB, MyNS::Unexpected %{
    +  if (Swig::ExceptionMatches(jenv, $error, "$packagepath/$javaclassname"))
    +    throw $1_type(Swig::JavaExceptionMessage(jenv, $error).message());
    +%}
    +
    +DECLARE_EXCEPTION(ExceptionA)
    +DECLARE_EXCEPTION(ExceptionB)
    +DECLARE_EXCEPTION(Unexpected)
    +
    +%catches(MyNS::ExceptionA, MyNS::ExceptionB, MyNS::Unexpected) MyClass::meth2();
    +
    +%inline {
    +  class MyClass {
    +  public:
    +    virtual void meth1(int x) throw(MyNS::ExceptionA, MyNS::ExceptionB) = 0;
    +    virtual void meth2() = 0;   /* throws MyNS::ExceptionA, MyNS::ExceptionB, MyNS::Unexpected */
    +    virtual void meth3(float x) throw(MyNS::Unexpected) = 0;
    +    virtual ~MyClass() {}
    +  };
    +}
    +
    +

    +

    In this case the three different "directorthrows" typemaps will be + used to generate the three different exception handlers for meth1 +, meth2 and meth3. The generated handlers will + have "if" blocks for each exception type specified, in the exception + specification or %catches feature.

    +

    Note that the "directorthrows" typemaps are important only if it is + important for the the exceptions passed through the C++ layer to be + mapped to distinct C++ exceptions. If director methods are being called + by C++ code that is itself wrapped in a SWIG generated Java wrapper and + access is always through this wrapper, the default +Swig::DirectorException class provides enough information to + reconstruct the original exception. In this case removing the +$directorthrowshandlers special variable from the default +director:except feature and simply always throwing a +Swig::DirectorException will achieve the desired result. Along + with this a generic exception feature is added to convert any caught +Swig::DirectorExceptions back into the underlying Java exceptions + via the Swig::DirectorException::raiseJavaException + method, as demonstrated with %javaexception below:

    +
    +
    +%javaexception("Exception") MyClass::myMethod %{
    +  try {
    +    $action
    +  } catch (Swig::DirectorException &e) {
    +    // raise/throw the Java exception that originally caused the DirectorException
    +    e.raiseJavaException(jenv);
    +    return $null;
    +  }
    +%}
    +
    +
    +

    See the Exception handling with + %exception and %javaexception section for more on converting C++ + exceptions to Java exceptions.

    +

    25.6 Accessing protected members

    +

    When using directors, the protected virtual methods are also + wrapped. These methods are wrapped with a protected Java proxy method, + so the only way that Java code can access these is from within a Java + class derived from the director class.

    +

    Members which are protected and non-virtual can also be accessed + when using the 'allprotected' mode. The allprotected mode requires + directors and is turned on by setting the allprotected option + in addition to the directors option in the %module directive, + like this:

    +
    +
    +%module(directors="1", allprotected="1") modulename
     
    -

    The base class is generated much like any other proxy class seen so - far:

    +

    Protected member variables and methods (both static and non-static) + will then be wrapped with protected access in the Java proxy class.

    +

    Note: Neither the directors option nor the allprotected mode + support types defined with protected scope. This includes any enums or + typedefs declared in the protected section of the C++ class.

    +

    The following simple example is a class with numerous protected + members, including the constructor and destructor:

    -public class Base {
    -  private long swigCPtr;
    -  protected boolean swigCMemOwn;
    +%module(directors="1", allprotected="1") example
     
    -  protected Base(long cPtr, boolean cMemoryOwn) {
    -    swigCMemOwn = cMemoryOwn;
    -    swigCPtr = cPtr;
    -  }
    +%feature("director") ProtectedBase;
     
    -  protected static long getCPtr(Base obj) {
    -    return (obj == null) ? 0 : obj.swigCPtr;
    -  }
    +// Ignore use of unsupported types (those defined in the protected section)
    +%ignore ProtectedBase::typedefs;
     
    -  protected void finalize() {
    -    delete();
    -  }
    +%inline %{
     
    -  public synchronized void delete() {
    -    if(swigCPtr != 0 && swigCMemOwn) {
    -      swigCMemOwn = false;
    -      exampleJNI.delete_Base(swigCPtr);
    -    }
    -    swigCPtr = 0;
    -  }
    +class ProtectedBase {
    +protected:
    +  ProtectedBase() {}
    +  virtual ~ProtectedBase() {}
    +  virtual void virtualMethod() const {}
    +  void nonStaticMethod(double d) const {}
    +  static void staticMethod(int i) {}
    +  int instanceMemberVariable;
    +  static int staticMemberVariable;
     
    -  public double foo() {
    -    return exampleJNI.Base_foo(swigCPtr, this);
    -  }
    +  // unsupported: types defined with protected access and the methods/variables which use them
    +  typedef int IntegerType;
    +  IntegerType typedefs(IntegerType it) { return it; }
    +};
    +int ProtectedBase::staticMemberVariable = 10;
     
    -  public Base() {
    -    this(exampleJNI.new_Base(), true);
    -  }
    +%}
     
    -}
     
    -

    The Derived class extends Base mirroring the C++ - class inheritance hierarchy.

    +

    Note that the IntegerType has protected scope and the + members which use this type must be ignored as they cannot be wrapped.

    +

    The proxy methods are protected, so the only way the protected + members can be accessed is within a class that derives from the + director class, such as the following:

    -public class Derived extends Base {
    -  private long swigCPtr;
    -
    -  protected Derived(long cPtr, boolean cMemoryOwn) {
    -    super(exampleJNI.SWIGDerivedUpcast(cPtr), cMemoryOwn);
    -    swigCPtr = cPtr;
    -  }
    -
    -  protected static long getCPtr(Derived obj) {
    -    return (obj == null) ? 0 : obj.swigCPtr;
    -  }
    -
    -  protected void finalize() {
    -    delete();
    +class MyProtectedBase extends ProtectedBase
    +{
    +  public MyProtectedBase() {
       }
     
    -  public synchronized void delete() {
    -    if(swigCPtr != 0 && swigCMemOwn) {
    -      swigCMemOwn = false;
    -      exampleJNI.delete_Derived(swigCPtr);
    -    }
    -    swigCPtr = 0;
    -    super.delete();
    -  }
    +  public void accessProtected() {
    +    virtualMethod();
    +    nonStaticMethod(1.2);
    +    staticMethod(99);
     
    -  public double foo() {
    -    return exampleJNI.Derived_foo(swigCPtr, this);
    -  }
    +    setInstanceMemberVariable(5);
    +    int i = getInstanceMemberVariable();
     
    -  public Derived() {
    -    this(exampleJNI.new_Derived(), true);
    +    setStaticMemberVariable(10);
    +    i = getStaticMemberVariable();
       }
    -
     }
     
    -

    Note the memory ownership is controlled by the base class. However - each class in the inheritance hierarchy has its own pointer value which - is obtained during construction. The SWIGDerivedUpcast() call - converts the pointer from a Derived * to a Base *. - This is a necessity as C++ compilers are free to implement pointers in - the inheritance hierarchy with different values.

    -

    It is of course possible to extend Base using your own Java - classes. If Derived is provided by the C++ code, you could for - example add in a pure Java class Extended derived from -Base. There is a caveat and that is any C++ code will not know - about your pure Java class Extended so this type of derivation - is restricted. However, true cross language polymorphism can be - achieved using the directors feature.

    -

    24.4.3.3 Proxy classes and - garbage collection

    -

    By default each proxy class has a delete() and a -finalize() method. The finalize() method calls -delete() which frees any malloc'd memory for wrapped C structs or - calls the C++ class destructors. The idea is for delete() to - be called when you have finished with the C/C++ object. Ideally you - need not call delete(), but rather leave it to the garbage - collector to call it from the finalizer. When a program exits, the - garbage collector does not guarantee to call all finalizers. An insight - into the reasoning behind this can be obtained from -Hans Boehm's Destructors, Finalizers, and Synchronization paper. - Depending on what the finalizers do and which operating system you use, - this may or may not be a problem.

    -

    If the delete() call into JNI code is just for memory - handling, there is not a problem when run on most operating systems, - for example Windows and Unix. Say your JNI code creates memory on the - heap which your finalizers should clean up, the finalizers may or may - not be called before the program exits. In Windows and Unix all memory - that a process uses is returned to the system on exit, so this isn't a - problem. This is not the case in some operating systems like vxWorks. - If however, your finalizer calls into JNI code invoking the C++ - destructor which in turn releases a TCP/IP socket for example, there is - no guarantee that it will be released. Note that with long running - programs the garbage collector will eventually run, thereby calling any - unreferenced object's finalizers.

    -

    Some not so ideal solutions are:

    -
      -
    1. -

      Call the System.runFinalizersOnExit(true) or -Runtime.getRuntime().runFinalizersOnExit(true) to ensure the - finalizers are called before the program exits. The catch is that this - is a deprecated function call as the documentation says:

      -
      This method is inherently unsafe. It may result in - finalizers being called on live objects while other threads are - concurrently manipulating those objects, resulting in erratic behavior - or deadlock.
      -

      In many cases you will be lucky and find that it works, but it is not - to be advocated. Have a look at -Java web site and search for runFinalizersOnExit.

      -
    2. -
    3. -

      From jdk1.3 onwards a new function, addShutdownHook(), was - introduced which is guaranteed to be called when your program exits. - You can encourage the garbage collector to call the finalizers, for - example, add this static block to the class that has the main() - function:

      +

      25.7 Common customization + features

      +

      An earlier section presented the absolute basics of C/C++ wrapping. + If you do nothing but feed SWIG a header file, you will get an + interface that mimics the behavior described. However, sometimes this + isn't enough to produce a nice module. Certain types of functionality + might be missing or the interface to certain functions might be + awkward. This section describes some common SWIG features that are used + to improve the interface to existing C/C++ code.

      +

      25.7.1 C/C++ helper functions

      +

      Sometimes when you create a module, it is missing certain bits of + functionality. For example, if you had a function like this

      -  static {
      -    Runtime.getRuntime().addShutdownHook( 
      -      new Thread() {
      -        public void run() { System.gc(); System.runFinalization(); }
      -      }
      -    );
      -  }
      +typedef struct Image {...};
      +void set_transform(Image *im, double m[4][4]);
       
      -

      Although this usually works, the documentation doesn't guarantee that - runFinalization() will actually call the finalizers. As the - shutdown hook is guaranteed you could also make a JNI call to clean up - any resources that are being tracked by the C/C++ code.

      -
    4. -
    5. -

      Call the delete() function manually which will immediately - invoke the C++ destructor. As a suggestion it may be a good idea to set - the object to null so that should the object be inadvertently used - again a Java null pointer exception is thrown, the alternative would - crash the JVM by using a null C pointer. For example given a SWIG - generated class A:

      +

      it would be accessible from Java, but there may be no easy way to + call it. The problem here is that a type wrapper class is generated for + the two dimensional array parameter so there is no easy way to + construct and manipulate a suitable double [4][4] value. To + fix this, you can write some extra C helper functions. Just use the +%inline directive. For example:

      -A myA = new A();
      -// use myA ...
      -myA.delete();
      -// any use of myA here would crash the JVM 
      -myA=null;
      -// any use of myA here would cause a Java null pointer exception to be thrown
      +%inline %{
      +/* Note: double[4][4] is equivalent to a pointer to an array double (*)[4] */
      +double (*new_mat44())[4] {
      +   return (double (*)[4]) malloc(16*sizeof(double));
      +}
      +void free_mat44(double (*x)[4]) {
      +   free(x);
      +}
      +void mat44_set(double x[4][4], int i, int j, double v) {
      +   x[i][j] = v;
      +}
      +double mat44_get(double x[4][4], int i, int j) {
      +   return x[i][j];
      +}
      +%}
       
      -

      The SWIG generated code ensures that the memory is not deleted - twice, in the event the finalizers get called in addition to the manual - delete() call.

      -
    6. -
    7. -

      Write your own object manager in Java. You could derive all SWIG - classes from a single base class which could track which objects have - had their finalizers run, then call the rest of them on program - termination. The section on Java typemaps - details how to specify a pure Java base class.

      -
    8. -
    -

    See the How to - Handle Java Finalization's Memory-Retention Issues article for - alternative approaches to managing memory by avoiding finalizers - altogether.

    -

    24.4.3.4 The premature garbage collection - prevention parameter for proxy class marshalling

    -

    As covered earlier, the C/C++ struct/class pointer is stored in the - proxy class as a Java long and when needed is passed into the native - method where it is cast into the appropriate type. This approach - provides very fast marshalling but could be susceptible to premature - garbage collection. Consider the following C++ code:

    +

    From Java, you could then write code like this:

    -class Wibble {
    -};
    -void wobble(Wibble &w);
    +Image im = new Image();
    +SWIGTYPE_p_a_4__double a = example.new_mat44();
    +example.mat44_set(a,0,0,1.0);
    +example.mat44_set(a,1,1,1.0);
    +example.mat44_set(a,2,2,1.0);
    +...
    +example.set_transform(im,a);
    +example.free_mat44(a);
     
    -

    The module class contains the Java wrapper for the global wobble - method:

    +

    Admittedly, this is not the most elegant looking approach. However, + it works and it wasn't too hard to implement. It is possible to improve + on this using Java code, typemaps, and other customization features as + covered in later sections, but sometimes helper functions are a quick + and easy solution to difficult cases.

    +

    25.7.2 Class extension with %extend +

    +

    One of the more interesting features of SWIG is that it can extend + structures and classes with new methods or constructors. Here is a + simple example:

    -public class example {
    -  ...
    -  public static void wobble(Wibble w) {
    -    exampleJNI.wobble(Wibble.getCPtr(w), w);
    -  }
    -}
    +%module example
    +%{
    +#include "someheader.h"
    +%}
    +
    +struct Vector {
    +   double x,y,z;
    +};
    +
    +%extend Vector {
    +   char *toString() {
    +       static char tmp[1024];
    +       sprintf(tmp,"Vector(%g,%g,%g)", $self->x,$self->y,$self->z);
    +       return tmp;
    +   }
    +   Vector(double x, double y, double z) {
    +       Vector *v = (Vector *) malloc(sizeof(Vector));
    +       v->x = x;
    +       v->y = y;
    +       v->z = z;
    +       return v;
    +   }
    +};
     
    -

    where example is the name of the module. All native methods - go through the intermediary class which has the native method declared - as such:

    +

    Now, in Java

    -public class exampleJNI {
    -  ...
    -  public final static native void wobble(long jarg1, Wibble jarg1_);
    -}
    +Vector v = new Vector(2,3,4);
    +System.out.println(v);
     
    -

    The second parameter, jarg1_, is the premature garbage - collection prevention parameter and is added to the native method - parameter list whenever a C/C++ struct or class is marshalled as a Java - long. In order to understand why, consider the alternative where the - intermediary class method is declared without the additional parameter:

    +

    will display

    -public class exampleJNI {
    -  ...
    -  public final static native void wobble(long jarg1);
    -}
    +Vector(2,3,4)
     
    -

    and the following simple call to wobble:

    +

    %extend works with both C and C++ code. It does not modify + the underlying object in any way---the extensions only show up in the + Java interface.

    +

    25.7.3 Exception handling with + %exception and %javaexception

    +

    If a C or C++ function throws an error, you may want to convert that + error into a Java exception. To do this, you can use the %exception + directive. The %exception directive simply lets you rewrite + part of the generated wrapper code to include an error check. It is + detailed in full in the Exception + handling with %exception section.

    +

    In C, a function often indicates an error by returning a status code + (a negative number or a NULL pointer perhaps). Here is a simple example + of how you might handle that:

    -{
    -  Wibble w = new Wibble();
    -  example.wobble(w);
    +%exception malloc {
    +  $action
    +  if (!result) {
    +    jclass clazz = (*jenv)->FindClass(jenv, "java/lang/OutOfMemoryError");
    +    (*jenv)->ThrowNew(jenv, clazz, "Not enough memory");
    +    return $null;
    +  }
     }
    +void *malloc(size_t nbytes);
     
    -

    The hotspot compiler effectively sees something like:

    +

    In Java,

    -{
    -  Wibble w = new Wibble();
    -  long w_ptr = Wibble.getCPtr(w);
    -  // w is no longer reachable
    -  exampleJNI.wobble(w_ptr);
    -}
    +SWIGTYPE_p_void a = example.malloc(2000000000);
     
    -

    The Wibble object is no longer reachable after the point - shown as in this bit of code, the Wibble object is not - referenced again after this point. This means that it is a candidate - for garbage collection. Should wobble be a long running - method, it is quite likely that the finalizer for the Wibble - instance will be called. This in turn will call its underlying C++ - destructor which is obviously disastrous while the method wobble - is running using this object. Even if wobble is not a long - running method, it is possible for the Wibble instance to be - finalized. By passing the Wibble instance into the native - method, it will not be finalized as the JVM guarantees not to finalize - any objects until the native method returns. Effectively, the code then - becomes

    +

    will produce a familiar looking Java exception:

    -{
    -  Wibble w = new Wibble();
    -  long w_ptr = Wibble.getCPtr(w);
    -  exampleJNI.wobble(w_ptr, w);
    -  // w is no longer reachable
    -}
    +Exception in thread "main" java.lang.OutOfMemoryError: Not enough memory
    +        at exampleJNI.malloc(Native Method)
    +        at example.malloc(example.java:16)
    +        at runme.main(runme.java:112)
     
    -

    and therefore there is no possibility of premature garbage - collection. In practice, this premature garbage collection was only - ever observed in Sun's server JVM from jdk-1.3 onwards and in Sun's - client JVM from jdk-1.6 onwards.

    -

    The premature garbage collection prevention parameter for proxy - classes is generated by default whenever proxy classes are passed by - value, reference or with a pointer. The implementation for this extra - parameter generation requires the "jtype" typemap to contain long - and the "jstype" typemap to contain the name of a proxy class.

    -

    The additional parameter does impose a slight performance overhead - and the parameter generation can be suppressed globally with the --nopgcpp commandline option. More selective suppression is possible - with the 'nopgcpp' attribute in the "jtype" -Java typemap. The attribute is a flag and so should be set to "1" to - enable the suppression, or it can be omitted or set to "0" to disable. - For example:

    +

    If a library provides some kind of general error handling framework, + you can also use that. For example:

    -%typemap(jtype, nopgcpp="1") Wibble & "long"
    +%exception malloc {
    +  $action
    +  if (err_occurred()) {
    +    jclass clazz = (*jenv)->FindClass(jenv, "java/lang/OutOfMemoryError");
    +    (*jenv)->ThrowNew(jenv, clazz, "Not enough memory");
    +    return $null;
    +  }
    +}
    +void *malloc(size_t nbytes);
     
    -

    Compatibility note: The generation of this additional - parameter did not occur in versions prior to SWIG-1.3.30.

    -

    24.4.3.5 Single threaded - applications and thread safety

    -

    Single threaded Java applications using JNI need to consider thread - safety. The same applies for the C# module where the .NET wrappers use - PInvoke. Consider the C++ class:

    +

    If no declaration name is given to %exception, it is + applied to all wrapper functions. The $action is a SWIG + special variable and is replaced by the C/C++ function call being + wrapped. The return $null; handles all native method return + types, namely those that have a void return and those that do not. This + is useful for typemaps that will be used in native method returning all + return types. See the section on Java + special variables for further explanation.

    +

    C++ exceptions are also easy to handle. We can catch the C++ + exception and rethrow it as a Java exception like this:

    -class Test {
    -  string str;
    +%exception getitem {
    +  try {
    +     $action
    +  } catch (std::out_of_range &e) {
    +    jclass clazz = jenv->FindClass("java/lang/Exception");
    +    jenv->ThrowNew(clazz, "Range error");
    +    return $null;
    +   }
    +}
    +
    +class FooClass {
     public:
    -  Test() : str("initial") {}
    +     FooClass *getitem(int index);      // Might throw std::out_of_range exception
    +     ...
     };
     
    -

    and the Java proxy class generated by SWIG:

    -
    -
    -public class Test {
    -  private long swigCPtr;
    -  protected boolean swigCMemOwn;
    -
    -  protected Test(long cPtr, boolean cMemoryOwn) {
    -    swigCMemOwn = cMemoryOwn;
    -    swigCPtr = cPtr;
    -  }
    -
    -  protected static long getCPtr(Test obj) {
    -    return (obj == null) ? 0 : obj.swigCPtr;
    -  }
    -
    -  protected void finalize() {
    -    delete();
    -  }
    -
    -  // Call C++ destructor
    -  public synchronized void delete() {
    -    if(swigCPtr != 0 && swigCMemOwn) {
    -      swigCMemOwn = false;
    -      exampleJNI.delete_Test(swigCPtr);
    -    }
    -    swigCPtr = 0;
    -  }
    -
    -  // Call C++ constructor
    -  public Test() {
    -    this(exampleJNI.new_Test(), true);
    -  }
    -
    -}
    -
    -
    -

    It has two methods that call JNI methods, namely, -exampleJNI.new_Test() for the C++ constructor and -exampleJNI.delete_Test() for the C++ destructor. If the garbage - collector collects an instance of this class, ie delete() is - not explicitly called, then the C++ destructor will be run in a - different thread to the main thread. This is because when an object is - marked for garbage collection, any objects with finalizers are added to - a finalization queue and the objects in the finalization queue have - their finalize() methods run in a separate finalization - thread. Therefore, if the C memory allocator is not thread safe, then - the heap will get corrupted sooner or later, when a concurrent C++ - delete and new are executed. It is thus essential, even in single - threaded usage, to link to the C multi-thread runtime libraries, for - example, use the /MD option for Visual C++ on Windows. Alternatively, - lock all access to C++ functions that have heap - allocation/deallocation.

    -

    Note that some of the STL in Visual C++ 6 is not thread safe, so - although code might be linked to the multithread runtime libraries, - undefined behaviour might still occur in a single threaded Java - program. Similarly some older versions of Sun Studio have bugs in the - multi-threaded implementation of the std::string class and so will lead - to undefined behaviour in these supposedly single threaded Java - applications.

    -

    The following innocuous Java usage of Test is an example that will - crash very quickly on a multiprocessor machine if the JNI compiled code - is linked against the single thread C runtime libraries.

    +

    In the example above, java.lang.Exception is a checked + exception class and so ought to be declared in the throws clause of +getitem. Classes can be specified for adding to the throws clause + using %javaexception(classes) instead of %exception, + where classes is a string containing one or more comma + separated Java classes. The %clearjavaexception feature is the + equivalent to %clearexception and clears previously declared + exception handlers. The %nojavaexception feature is the + equivalent to %noexception and disables the exception handler. + See Clearing features + for the difference on disabling and clearing features.

    -for (int i=0; i<100000; i++) {
    -  System.out.println("Iteration " + i);
    -  for (int k=0; k<10; k++) {
    -    Test test = new Test();
    -  }
    -  System.gc();
    +%javaexception("java.lang.Exception") getitem {
    +  try {
    +     $action
    +  } catch (std::out_of_range &e) {
    +    jclass clazz = jenv->FindClass("java/lang/Exception");
    +    jenv->ThrowNew(clazz, "Range error");
    +    return $null;
    +   }
     }
    +
    +class FooClass {
    +public:
    +     FooClass *getitem(int index);      // Might throw std::out_of_range exception
    +     ...
    +};
     
    -

    24.4.4 Type wrapper classes

    -

    The generated type wrapper class, for say an int *, looks - like this:

    +

    The generated proxy method now generates a throws clause containing +java.lang.Exception:

    -public class SWIGTYPE_p_int {
    -  private long swigCPtr;
    -
    -  protected SWIGTYPE_p_int(long cPtr, boolean bFutureUse) {
    -    swigCPtr = cPtr;
    -  }
    -
    -  protected SWIGTYPE_p_int() {
    -    swigCPtr = 0;
    -  }
    -
    -  protected static long getCPtr(SWIGTYPE_p_int obj) {
    -    return obj.swigCPtr;
    -  }
    +public class FooClass {
    +  ...
    +  public FooClass getitem(int index) throws java.lang.Exception { ... }
    +  ...
     }
     
    -

    The methods do not have public access, so by default it is - impossible to do anything with objects of this class other than pass - them around. The methods in the class are part of the inner workings of - SWIG. If you need to mess around with pointers you will have to use - some typemaps specific to the Java module to achieve this. The section - on Java typemaps details how to modify the - generated code.

    -

    Note that if you use a pointer or reference to a proxy class in a - function then no type wrapper class is generated because the proxy - class can be used as the function parameter. If however, you need - anything more complicated like a pointer to a pointer to a proxy class - then a typewrapper class is generated for your use.

    -

    Note that SWIG generates a type wrapper class and not a proxy class - when it has not parsed the definition of a type that gets used. For - example, say SWIG has not parsed the definition of class Snazzy - because it is in a header file that you may have forgotten to use the -%include directive on. Should SWIG parse Snazzy * being - used in a function parameter, it will then generates a type wrapper - class around a Snazzy pointer. Also recall from earlier that - SWIG will use a pointer when a class is passed by value or by - reference:

    +

    The examples above first use the C JNI calling syntax then the C++ + JNI calling syntax. The C++ calling syntax will not compile as C and + also vice versa. It is however possible to write JNI calls which will + compile under both C and C++ and is covered in the +Typemaps for both C and C++ compilation section.

    +

    The language-independent exception.i library file can also + be used to raise exceptions. See the SWIG Library + chapter. The typemap example Handling + C++ exception specifications as Java exceptions provides further + exception handling capabilities.

    +

    25.7.4 Method access with + %javamethodmodifiers

    +

    A Java feature called %javamethodmodifiers can be used to + change the method modifiers from the default public. It + applies to both module class methods and proxy class methods. For + example:

    -void spam(Snazzy *x, Snazzy &y, Snazzy z);
    +%javamethodmodifiers protect_me() "protected";
    +void protect_me();
     
    -

    Should SWIG not know anything about Snazzy then a -SWIGTYPE_p_Snazzy must be used for all 3 parameters in the spam - function. The Java function generated is:

    +

    Will produce the method in the module class with protected access.

    -public static void spam(SWIGTYPE_p_Snazzy x, SWIGTYPE_p_Snazzy y, SWIGTYPE_p_Snazzy z) {
    - ...
    +protected static void protect_me() {
    +  exampleJNI.protect_me();
     }
     
    -

    Note that typedefs are tracked by SWIG and the typedef name is used - to construct the type wrapper class name. For example, consider the - case where Snazzy is a typedef to an int which SWIG - does parse:

    +

    25.8 Tips and techniques

    +

    Although SWIG is largely automatic, there are certain types of + wrapping problems that require additional user input. Examples include + dealing with output parameters, strings and arrays. This chapter + discusses the common techniques for solving these problems.

    +

    25.8.1 Input and output + parameters using primitive pointers and references

    +

    A common problem in some C programs is handling parameters passed as + simple pointers or references. For example:

    -typedef int Snazzy;
    -void spam(Snazzy *x, Snazzy &y, Snazzy z);
    +void add(int x, int y, int *result) {
    +   *result = x + y;
    +}
     
    -

    Because the typedefs have been tracked the Java function generated - is:

    +

    or perhaps

    -public static void spam(SWIGTYPE_p_int x, SWIGTYPE_p_int y, int z) { ... }
    +int sub(int *x, int *y) {
    +   return *x-*y;
    +}
     
    -

    24.4.5 Enum classes

    -

    SWIG can generate three types of enum classes. The -Enumerations section discussed these but omitted all the details. - The following sub-sections detail the various types of enum classes - that can be generated.

    -

    24.4.5.1 Typesafe enum - classes

    -

    The following example demonstrates the typesafe enum classes which - SWIG generates:

    +

    The typemaps.i library file will help in these situations. + For example:

    -%include "enumtypesafe.swg"
    -%javaconst(1);
    -enum Beverage { ALE, LAGER=10, STOUT, PILSNER, PILZ=PILSNER };
    +%module example
    +%include "typemaps.i"
    +
    +void add(int, int, int *OUTPUT);
    +int  sub(int *INPUT, int *INPUT);
     
    -

    The following is the code that SWIG generates:

    +

    In Java, this allows you to pass simple values. For example:

    -public final class Beverage {
    -  public final static Beverage ALE = new Beverage("ALE");
    -  public final static Beverage LAGER = new Beverage("LAGER", 10);
    -  public final static Beverage STOUT = new Beverage("STOUT");
    -  public final static Beverage PILSNER = new Beverage("PILSNER");
    -  public final static Beverage PILZ = new Beverage("PILZ", PILSNER);
    -
    -  public final int swigValue() {
    -    return swigValue;
    -  }
    -
    -  public String toString() {
    -    return swigName;
    -  }
    -
    -  public static Beverage swigToEnum(int swigValue) {
    -    if (swigValue < swigValues.length && swigValue >= 0 &&
    -        swigValues[swigValue].swigValue == swigValue)
    -      return swigValues[swigValue];
    -    for (int i = 0; i < swigValues.length; i++)
    -      if (swigValues[i].swigValue == swigValue)
    -        return swigValues[i];
    -    throw new IllegalArgumentException("No enum " + Beverage.class + " with value " +
    -                                                                         swigValue);
    -  }
    -
    -  private Beverage(String swigName) {
    -    this.swigName = swigName;
    -    this.swigValue = swigNext++;
    -  }
    -
    -  private Beverage(String swigName, int swigValue) {
    -    this.swigName = swigName;
    -    this.swigValue = swigValue;
    -    swigNext = swigValue+1;
    -  }
    -
    -  private Beverage(String swigName, Beverage swigEnum) {
    -    this.swigName = swigName;
    -    this.swigValue = swigEnum.swigValue;
    -    swigNext = this.swigValue+1;
    -  }
    -
    -  private static Beverage[] swigValues = { ALE, LAGER, STOUT, PILSNER, PILZ };
    -  private static int swigNext = 0;
    -  private final int swigValue;
    -  private final String swigName;
    -}
    +int result = example.sub(7,4);
    +System.out.println("7 - 4 = " + result);
    +int[] sum = {0};
    +example.add(3,4,sum);
    +System.out.println("3 + 4 = " + sum[0]);
     
    -

    As can be seen, there are a fair number of support methods for the - typesafe enum pattern. The typesafe enum pattern involves creating a - fixed number of static instances of the enum class. The constructors - are private to enforce this. Three constructors are available - two for - C/C++ enums with an initializer and one for those without an - initializer. Note that the two enums with initializers, LAGER - and PILZ, each call one the two different initializer - constructors. In order to use one of these typesafe enums, the -swigToEnum static method must be called to return a reference to - one of the static instances. The JNI layer returns the enum value from - the C/C++ world as an integer and this method is used to find the - appropriate Java enum static instance. The swigValue method is - used for marshalling in the other direction. The toString - method is overridden so that the enum name is available.

    -

    24.4.5.2 Proper Java enum - classes

    -

    The following example demonstrates the Java enums approach:

    +

    Which will display:

    -%include "enums.swg"
    -%javaconst(1);
    -enum Beverage { ALE, LAGER=10, STOUT, PILSNER, PILZ=PILSNER };
    +7 - 4 = 3
    +3 + 4 = 7
     
    -

    SWIG will generate the following Java enum:

    +

    Notice how the INPUT parameters allow integer values to be + passed instead of pointers and how the OUTPUT parameter will + return the result in the first element of the integer array.

    +

    If you don't want to use the names INPUT or OUTPUT +, use the %apply directive. For example:

    -public enum Beverage {
    -  ALE,
    -  LAGER(10),
    -  STOUT,
    -  PILSNER,
    -  PILZ(PILSNER);
    -
    -  public final int swigValue() {
    -    return swigValue;
    -  }
    -
    -  public static Beverage swigToEnum(int swigValue) {
    -    Beverage[] swigValues = Beverage.class.getEnumConstants();
    -    if (swigValue < swigValues.length && swigValue >= 0 &&
    -        swigValues[swigValue].swigValue == swigValue)
    -      return swigValues[swigValue];
    -    for (Beverage swigEnum : swigValues)
    -      if (swigEnum.swigValue == swigValue)
    -        return swigEnum;
    -    throw new IllegalArgumentException("No enum " + Beverage.class +
    -                                       " with value " + swigValue);
    -  }
    -
    -  private Beverage() {
    -    this.swigValue = SwigNext.next++;
    -  }
    -
    -  private Beverage(int swigValue) {
    -    this.swigValue = swigValue;
    -    SwigNext.next = swigValue+1;
    -  }
    -
    -  private Beverage(Beverage swigEnum) {
    -    this.swigValue = swigEnum.swigValue;
    -    SwigNext.next = this.swigValue+1;
    -  }
    +%module example
    +%include "typemaps.i"
     
    -  private final int swigValue;
    +%apply int *OUTPUT { int *result };
    +%apply int *INPUT  { int *x, int *y};
     
    -  private static class SwigNext {
    -    private static int next = 0;
    -  }
    -}
    +void add(int x, int y, int *result);
    +int  sub(int *x, int *y);
     
    -

    The enum items appear first. Like the typesafe enum pattern, the - constructors are private. The constructors are required to handle C/C++ - enums with initializers. The next variable is in the -SwigNext inner class rather than in the enum class as static - primitive variables cannot be modified from within enum constructors. - Marshalling between Java enums and the C/C++ enum integer value is - handled via the swigToEnum and swigValue methods. All - the constructors and methods in the Java enum are required just to - handle C/C++ enums with initializers. These needn't be generated if the - enum being wrapped does not have any initializers and the -Simpler Java enums for enums without initializers section describes - how typemaps can be used to achieve this.

    -

    24.4.5.3 Type unsafe - enum classes

    -

    The following example demonstrates type unsafe enums:

    +

    If a function mutates one of its parameters like this,

    -%include "enumtypeunsafe.swg"
    -%javaconst(1);
    -enum Beverage { ALE, LAGER=10, STOUT, PILSNER, PILZ=PILSNER };
    +void negate(int *x) {
    +   *x = -(*x);
    +}
     
    -

    SWIG will generate the following simple class:

    +

    you can use INOUT like this:

    -public final class Beverage {
    -  public final static int ALE = 0;
    -  public final static int LAGER = 10;
    -  public final static int STOUT = LAGER + 1;
    -  public final static int PILSNER = STOUT + 1;
    -  public final static int PILZ = PILSNER;
    -}
    +%include "typemaps.i"
    +...
    +void negate(int *INOUT);
     
    -

    24.5 Cross language polymorphism using - directors

    -

    Proxy classes provide a natural, object-oriented way to wrap C++ - classes. as described earlier, each proxy instance has an associated - C++ instance, and method calls from Java to the proxy are passed to the - C++ instance transparently via C wrapper functions.

    -

    This arrangement is asymmetric in the sense that no corresponding - mechanism exists to pass method calls down the inheritance chain from - C++ to Java. In particular, if a C++ class has been extended in Java - (by deriving from the proxy class), these classes will not be visible - from C++ code. Virtual method calls from C++ are thus not able to - access the lowest implementation in the inheritance chain.

    -

    SWIG can address this problem and make the relationship between C++ - classes and proxy classes more symmetric. To achieve this goal, new - classes called directors are introduced at the bottom of the C++ - inheritance chain. The job of the directors is to route method calls - correctly, either to C++ implementations higher in the inheritance - chain or to Java implementations lower in the inheritance chain. The - upshot is that C++ classes can be extended in Java and from C++ these - extensions look exactly like native C++ classes. Neither C++ code nor - Java code needs to know where a particular method is implemented: the - combination of proxy classes, director classes, and C wrapper functions - transparently takes care of all the cross-language method routing.

    -

    24.5.1 Enabling directors

    -

    The director feature is disabled by default. To use directors you - must make two changes to the interface file. First, add the "directors" - option to the %module directive, like this:

    +

    In Java, the input parameter is the first element in a 1 element + array and is replaced by the output of the function. For example:

    -%module(directors="1") modulename
    +int[] neg = {3};
    +example.negate(neg);
    +System.out.println("Negative of 3 = " + neg[0]);
     
    -

    Without this option no director code will be generated. Second, you - must use the %feature("director") directive to tell SWIG which classes - and methods should get directors. The %feature directive can be applied - globally, to specific classes, and to specific methods, like this:

    +

    And no prizes for guessing the output:

    -// generate directors for all classes that have virtual methods
    -%feature("director");         
    -
    -// generate directors for all virtual methods in class Foo
    -%feature("director") Foo;      
    +Negative of 3 = -3
     
    -

    You can use the %feature("nodirector") directive to turn off - directors for specific classes or methods. So for example,

    +

    These typemaps can also be applied to C++ references. The above + examples would work the same if they had been defined using references + instead of pointers. For example, the Java code to use the negate + function would be the same if it were defined either as it is above:

    -%feature("director") Foo;
    -%feature("nodirector") Foo::bar;
    +void negate(int *INOUT);
     
    -

    will generate directors for all virtual methods of class Foo except - bar().

    -

    Directors can also be generated implicitly through inheritance. In - the following, class Bar will get a director class that handles the - methods one() and two() (but not three()):

    +

    or using a reference:

    -%feature("director") Foo;
    -class Foo {
    -public:
    -    virtual void one();
    -    virtual void two();
    -};
    -
    -class Bar: public Foo {
    -public:
    -    virtual void three();
    -};
    +void negate(int &INOUT);
     
    -

    24.5.2 Director classes

    -

    For each class that has directors enabled, SWIG generates a new - class that derives from both the class in question and a special -Swig::Director class. These new classes, referred to as director - classes, can be loosely thought of as the C++ equivalent of the Java - proxy classes. The director classes store a pointer to their underlying - Java proxy classes.

    -

    For simplicity let's ignore the Swig::Director class and - refer to the original C++ class as the director's base class. By - default, a director class extends all virtual methods in the - inheritance chain of its base class (see the preceding section for how - to modify this behavior). Thus all virtual method calls, whether they - originate in C++ or in Java via proxy classes, eventually end up in at - the implementation in the director class. The job of the director - methods is to route these method calls to the appropriate place in the - inheritance chain. By "appropriate place" we mean the method that would - have been called if the C++ base class and its Java derived classes - were seamlessly integrated. That seamless integration is exactly what - the director classes provide, transparently skipping over all the messy - JNI glue code that binds the two languages together.

    -

    In reality, the "appropriate place" is one of only two - possibilities: C++ or Java. Once this decision is made, the rest is - fairly easy. If the correct implementation is in C++, then the lowest - implementation of the method in the C++ inheritance chain is called - explicitly. If the correct implementation is in Java, the Java API is - used to call the method of the underlying Java object (after which the - usual virtual method resolution in Java automatically finds the right - implementation).

    -

    24.5.3 Overhead and code bloat

    -

    Enabling directors for a class will generate a new director method - for every virtual method in the class' inheritance chain. This alone - can generate a lot of code bloat for large hierarchies. Method - arguments that require complex conversions to and from Java types can - result in large director methods. For this reason it is recommended - that directors are selectively enabled only for specific classes that - are likely to be extended in Java and used in C++.

    -

    Although directors make it natural to mix native C++ objects with - Java objects (as director objects), one should be aware of the obvious - fact that method calls to Java objects from C++ will be much slower - than calls to C++ objects. Additionally, compared to classes that do - not use directors, the call routing in the director methods adds a - small overhead. This situation can be optimized by selectively enabling - director methods (using the %feature directive) for only those methods - that are likely to be extended in Java.

    -

    24.5.4 Simple directors example

    -

    Consider the following SWIG interface file:

    +

    Note: Since most Java primitive types are immutable and are passed + by value, it is not possible to perform in-place modification of a type + passed as a parameter.

    +

    Be aware that the primary purpose of the typemaps.i file is + to support primitive datatypes. Writing a function like this

    -%module(directors="1") example;
    -
    -%feature("director") DirectorBase;
    -
    -class DirectorBase {
    -public:
    -  virtual ~DirectorBase() {}
    -  virtual void upcall_method() {}
    -};
    -
    -void callup(DirectorBase *director) {
    -  director->upcall_method();
    -}
    +void foo(Bar *OUTPUT);
     
    -

    The following DirectorDerived Java class is derived - from the Java proxy class DirectorBase and overrides -upcall_method(). When C++ code invokes upcall_method() -, the SWIG-generated C++ code redirects the call via JNI to the Java -DirectorDerived subclass. Naturally, the SWIG generated C++ code - and the generated Java intermediary class marshal and convert arguments - between C++ and Java when needed.

    +

    will not have the intended effect since typemaps.i does not + define an OUTPUT rule for Bar.

    +

    25.8.2 Simple pointers

    +

    If you must work with simple pointers such as int * or +double * another approach to using typemaps.i is to use + the cpointer.i pointer library file. For example:

    -public class DirectorDerived extends DirectorBase {
    -  public DirectorDerived() {
    -  }
    +%module example
    +%include "cpointer.i"
     
    -  public void upcall_method() {
    -    System.out.println("DirectorDerived::upcall_method() invoked.");
    -  }
    -}
    +%inline %{
    +extern void add(int x, int y, int *result);
    +%}
    +
    +%pointer_functions(int, intp);
     
    -

    Running the following Java code

    +

    The %pointer_functions(type,name) macro generates five + helper functions that can be used to create, destroy, copy, assign, and + dereference a pointer. In this case, the functions are as follows:

    -DirectorDerived director = new DirectorDerived();
    -example.callup(director);
    +int  *new_intp();
    +int  *copy_intp(int *x);
    +void  delete_intp(int *x);
    +void  intp_assign(int *x, int value);
    +int   intp_value(int *x);
     
    -

    will result in the following being output:

    +

    In Java, you would use the functions like this:

    -DirectorDerived::upcall_method() invoked.
    +SWIGTYPE_p_int intPtr = example.new_intp();
    +example.add(3,4,intPtr);
    +int result = example.intp_value(intPtr);
    +System.out.println("3 + 4 = " + result);
     
    -

    24.5.5 Director threading - issues

    -

    Depending on your operating system and version of Java and how you - are using threads, you might find the JVM hangs on exit. There are a - couple of solutions to try out. The preferred solution requires jdk-1.4 - and later and uses AttachCurrentThreadAsDaemon instead of -AttachCurrentThread whenever a call into the JVM is required. This - can be enabled by defining the - SWIG_JAVA_ATTACH_CURRENT_THREAD_AS_DAEMON macro when compiling the C++ - wrapper code. For older JVMs define SWIG_JAVA_NO_DETACH_CURRENT_THREAD - instead, to avoid the DetachCurrentThread call but this will - result in a memory leak instead. For further details inspect the source - code in the java/director.swg library file.

    -

    Macros can be defined on the commandline when compiling your C++ - code, or alternatively added to the C++ wrapper file as shown below:

    +

    If you replace %pointer_functions(int,intp) by +%pointer_class(int,intp), the interface is more class-like.

    -%insert("runtime") %{
    -#define SWIG_JAVA_NO_DETACH_CURRENT_THREAD
    -%}
    +intp intPtr = new intp();
    +example.add(3,4,intPtr.cast());
    +int result = intPtr.value();
    +System.out.println("3 + 4 = " + result);
     
    -

    24.5.6 Director performance - tuning

    -

    When a new instance of a director (or subclass) is created in Java, - the C++ side of the director performs a runtime check per director - method to determine if that particular method is overridden in Java or - if it should invoke the C++ base implementation directly. Although this - makes initialization slightly more expensive, it is generally a good - overall tradeoff.

    -

    However, if all director methods are expected to usually be - overridden by Java subclasses, then initialization can be made faster - by avoiding these checks via the assumeoverride attribute. For +

    See the SWIG Library chapter for further + details.

    +

    25.8.3 Wrapping C arrays with Java arrays +

    +

    SWIG can wrap arrays in a more natural Java manner than the default + by using the arrays_java.i library file. Let's consider an example:

    -%feature("director", assumeoverride=1) Foo;
    -
    -
    -

    The disadvantage is that invocation of director methods from C++ - when Java doesn't actually override the method will require an - additional call up into Java and back to C++. As such, this option is - only useful when overrides are extremely common and instantiation is - frequent enough that its performance is critical.

    -

    24.6 Accessing protected members

    -

    When using directors, the protected virtual methods are also - wrapped. These methods are wrapped with a protected Java proxy method, - so the only way that Java code can access these is from within a Java - class derived from the director class.

    -

    Members which are protected and non-virtual can also be accessed - when using the 'allprotected' mode. The allprotected mode requires - directors and is turned on by setting the allprotected option - in addition to the directors option in the %module directive, - like this:

    -
    -
    -%module(directors="1", allprotected="1") modulename
    +%include "arrays_java.i";
    +int array[4];
    +void populate(int x[]) {
    +    int i;
    +    for (i=0; i<4; i++)
    +        x[i] = 100 + i;
    +}
     
    -

    Protected member variables and methods (both static and non-static) - will then be wrapped with protected access in the Java proxy class.

    -

    Note: Neither the directors option nor the allprotected mode - support types defined with protected scope. This includes any enums or - typedefs declared in the protected section of the C++ class.

    -

    The following simple example is a class with numerous protected - members, including the constructor and destructor:

    +

    These one dimensional arrays can then be used as if they were Java + arrays:

    -%module(directors="1", allprotected="1") example
    -
    -%feature("director") ProtectedBase;
    -
    -// Ignore use of unsupported types (those defined in the protected section)
    -%ignore ProtectedBase::typedefs;
    -
    -%inline %{
    +int[] array = new int[4];
    +example.populate(array);
     
    -class ProtectedBase {
    -protected:
    -  ProtectedBase() {}
    -  virtual ~ProtectedBase() {}
    -  virtual void virtualMethod() const {}
    -  void nonStaticMethod(double d) const {}
    -  static void staticMethod(int i) {}
    -  int instanceMemberVariable;
    -  static int staticMemberVariable;
    +System.out.print("array: ");
    +for (int i=0; i<array.length; i++)
    +    System.out.print(array[i] + " ");
     
    -  // unsupported: types defined with protected access and the methods/variables which use them
    -  typedef int IntegerType;
    -  IntegerType typedefs(IntegerType it) { return it; }
    -};
    -int ProtectedBase::staticMemberVariable = 10;
    +example.setArray(array);
     
    -%}
    +int[] global_array = example.getArray();
     
    +System.out.print("\nglobal_array: ");
    +for (int i=0; i<array.length; i++)
    +    System.out.print(global_array[i] + " ");
     
    -

    Note that the IntegerType has protected scope and the - members which use this type must be ignored as they cannot be wrapped.

    -

    The proxy methods are protected, so the only way the protected - members can be accessed is within a class that derives from the - director class, such as the following:

    +

    Java arrays are always passed by reference, so any changes a + function makes to the array will be seen by the calling function. Here + is the output after running this code:

    -class MyProtectedBase extends ProtectedBase
    -{
    -  public MyProtectedBase() {
    -  }
    -
    -  public void accessProtected() {
    -    virtualMethod();
    -    nonStaticMethod(1.2);
    -    staticMethod(99);
    -
    -    setInstanceMemberVariable(5);
    -    int i = getInstanceMemberVariable();
    -
    -    setStaticMemberVariable(10);
    -    i = getStaticMemberVariable();
    -  }
    -}
    +array: 100 101 102 103
    +global_array: 100 101 102 103
     
    -

    24.7 Common customization - features

    -

    An earlier section presented the absolute basics of C/C++ wrapping. - If you do nothing but feed SWIG a header file, you will get an - interface that mimics the behavior described. However, sometimes this - isn't enough to produce a nice module. Certain types of functionality - might be missing or the interface to certain functions might be - awkward. This section describes some common SWIG features that are used - to improve the interface to existing C/C++ code.

    -

    24.7.1 C/C++ helper functions

    -

    Sometimes when you create a module, it is missing certain bits of - functionality. For example, if you had a function like this

    +

    Note that for assigning array variables the length of the C variable + is used, so it is possible to use a Java array that is bigger than the + C code will cope with. Only the number of elements in the C array will + be used. However, if the Java array is not large enough then you are + likely to get a segmentation fault or access violation, just like you + would in C. When arrays are used in functions like populate, + the size of the C array passed to the function is determined by the + size of the Java array.

    +

    Please be aware that the typemaps in this library are not efficient + as all the elements are copied from the Java array to a C array + whenever the array is passed to and from JNI code. There is an + alternative approach using the SWIG array library and this is covered + in the next section.

    +

    25.8.4 Unbounded C Arrays

    +

    Sometimes a C function expects an array to be passed as a pointer. + For example,

    -typedef struct Image {...};
    -void set_transform(Image *im, double m[4][4]);
    +int sumitems(int *first, int nitems) {
    +    int i, sum = 0;
    +    for (i = 0; i < nitems; i++) {
    +        sum += first[i];
    +    }
    +    return sum;
    +}
     
    -

    it would be accessible from Java, but there may be no easy way to - call it. The problem here is that a type wrapper class is generated for - the two dimensional array parameter so there is no easy way to - construct and manipulate a suitable double [4][4] value. To - fix this, you can write some extra C helper functions. Just use the -%inline directive. For example:

    +

    One of the ways to wrap this is to apply the Java array typemaps + that come in the arrays_java.i library file:

    -%inline %{
    -/* Note: double[4][4] is equivalent to a pointer to an array double (*)[4] */
    -double (*new_mat44())[4] {
    -   return (double (*)[4]) malloc(16*sizeof(double));
    -}
    -void free_mat44(double (*x)[4]) {
    -   free(x);
    -}
    -void mat44_set(double x[4][4], int i, int j, double v) {
    -   x[i][j] = v;
    -}
    -double mat44_get(double x[4][4], int i, int j) {
    -   return x[i][j];
    -}
    -%}
    +%include "arrays_java.i"
    +%apply int[] {int *};
     
    -

    From Java, you could then write code like this:

    +

    The ANY size will ensure the typemap is applied to arrays + of all sizes. You could narrow the typemap matching rules by specifying + a particular array size. Now you can use a pure Java array and pass it + to the C code:

    -Image im = new Image();
    -SWIGTYPE_p_a_4__double a = example.new_mat44();
    -example.mat44_set(a,0,0,1.0);
    -example.mat44_set(a,1,1,1.0);
    -example.mat44_set(a,2,2,1.0);
    -...
    -example.set_transform(im,a);
    -example.free_mat44(a);
    +int[] array = new int[10000000];          // Array of 10-million integers
    +for (int i=0; i<array.length; i++) {      // Set some values
    +  array[i] = i;
    +}
    +int sum = example.sumitems(array,10000);
    +System.out.println("Sum = " + sum);
     
    -

    Admittedly, this is not the most elegant looking approach. However, - it works and it wasn't too hard to implement. It is possible to improve - on this using Java code, typemaps, and other customization features as - covered in later sections, but sometimes helper functions are a quick - and easy solution to difficult cases.

    -

    24.7.2 Class extension with - %extend

    -

    One of the more interesting features of SWIG is that it can extend - structures and classes with new methods or constructors. Here is a - simple example:

    +

    and the sum would be displayed:

    -%module example
    -%{
    -#include "someheader.h"
    -%}
    -
    -struct Vector {
    -   double x,y,z;
    -};
    -
    -%extend Vector {
    -   char *toString() {
    -       static char tmp[1024];
    -       sprintf(tmp,"Vector(%g,%g,%g)", $self->x,$self->y,$self->z);
    -       return tmp;
    -   }
    -   Vector(double x, double y, double z) {
    -       Vector *v = (Vector *) malloc(sizeof(Vector));
    -       v->x = x;
    -       v->y = y;
    -       v->z = z;
    -       return v;
    -   }
    -};
    +Sum = 49995000
     
    -

    Now, in Java

    +

    This approach is probably the most natural way to use arrays. + However, it suffers from performance problems when using large arrays + as a lot of copying of the elements occurs in transferring the array + from the Java world to the C++ world. An alternative approach to using + Java arrays for C arrays is to use an alternative SWIG library file +carrays.i. This approach can be more efficient for large arrays as + the array is accessed one element at a time. For example:

    -Vector v = new Vector(2,3,4);
    -System.out.println(v);
    +%include "carrays.i"
    +%array_functions(int, intArray);
     
    -

    will display

    +

    The %array_functions(type,name) macro generates four helper + functions that can be used to create and destroy arrays and operate on + elements. In this case, the functions are as follows:

    -Vector(2,3,4)
    +int *new_intArray(int nelements);
    +void delete_intArray(int *x);
    +int intArray_getitem(int *x, int index);
    +void intArray_setitem(int *x, int index, int value);
     
    -

    %extend works with both C and C++ code. It does not modify - the underlying object in any way---the extensions only show up in the - Java interface.

    -

    24.7.3 Exception handling with - %exception and %javaexception

    -

    If a C or C++ function throws an error, you may want to convert that - error into a Java exception. To do this, you can use the %exception - directive. The %exception directive simply lets you rewrite - part of the generated wrapper code to include an error check. It is - detailed in full in the Exception - handling with %exception section.

    -

    In C, a function often indicates an error by returning a status code - (a negative number or a NULL pointer perhaps). Here is a simple example - of how you might handle that:

    +

    In Java, you would use the functions like this:

    -%exception malloc {
    -  $action
    -  if (!result) {
    -    jclass clazz = (*jenv)->FindClass(jenv, "java/lang/OutOfMemoryError");
    -    (*jenv)->ThrowNew(jenv, clazz, "Not enough memory");
    -    return $null;
    -  }
    +SWIGTYPE_p_int array = example.new_intArray(10000000);  // Array of 10-million integers
    +for (int i=0; i<10000; i++) {                           // Set some values
    +    example.intArray_setitem(array,i,i);
     }
    -void *malloc(size_t nbytes);
    +int sum = example.sumitems(array,10000);
    +System.out.println("Sum = " + sum);
     
    -

    In Java,

    +

    If you replace %array_functions(int,intp) by +%array_class(int,intp), the interface is more class-like and a + couple more helper functions are available for casting between the + array and the type wrapper class.

    -SWIGTYPE_p_void a = example.malloc(2000000000);
    +%include "carrays.i"
    +%array_class(int, intArray);
     
    -

    will produce a familiar looking Java exception:

    +

    The %array_class(type, name) macro creates wrappers for an + unbounded array object that can be passed around as a simple pointer + like int * or double *. For instance, you will be + able to do this in Java:

    -Exception in thread "main" java.lang.OutOfMemoryError: Not enough memory
    -        at exampleJNI.malloc(Native Method)
    -        at example.malloc(example.java:16)
    -        at runme.main(runme.java:112)
    +intArray array = new intArray(10000000);  // Array of 10-million integers
    +for (int i=0; i<10000; i++) {             // Set some values
    +    array.setitem(i,i);
    +}
    +int sum = example.sumitems(array.cast(),10000);
    +System.out.println("Sum = " + sum);
     
    -

    If a library provides some kind of general error handling framework, - you can also use that. For example:

    +

    The array "object" created by %array_class() does not + encapsulate pointers inside a special array object. In fact, there is + no bounds checking or safety of any kind (just like in C). Because of + this, the arrays created by this library are extremely low-level + indeed. You can't iterate over them nor can you even query their + length. In fact, any valid memory address can be accessed if you want + (negative indices, indices beyond the end of the array, etc.). Needless + to say, this approach is not going to suit all applications. On the + other hand, this low-level approach is extremely efficient and well + suited for applications in which you need to create buffers, package + binary data, etc.

    +

    25.8.5 Binary data vs Strings

    +

    By default SWIG handles char * as a string but there is a + handy multi-argument typemap available as mentioned in +Passing binary data. The following simple example demonstrates using + a byte array instead of passing the default string type and length to + the wrapped function.

    -%exception malloc {
    -  $action
    -  if (err_occurred()) {
    -    jclass clazz = (*jenv)->FindClass(jenv, "java/lang/OutOfMemoryError");
    -    (*jenv)->ThrowNew(jenv, clazz, "Not enough memory");
    -    return $null;
    -  }
    +%apply (char *STRING, size_t LENGTH) { (const char data[], size_t len) }
    +%inline %{
    +void binaryChar1(const char data[], size_t len) {
    +  printf("len: %d data: ", len);
    +  for (size_t i=0; i<len; ++i)
    +    printf("%x ", data[i]);
    +  printf("\n");
     }
    -void *malloc(size_t nbytes);
    +%}
     
    -

    If no declaration name is given to %exception, it is - applied to all wrapper functions. The $action is a SWIG - special variable and is replaced by the C/C++ function call being - wrapped. The return $null; handles all native method return - types, namely those that have a void return and those that do not. This - is useful for typemaps that will be used in native method returning all - return types. See the section on Java - special variables for further explanation.

    -

    C++ exceptions are also easy to handle. We can catch the C++ - exception and rethrow it as a Java exception like this:

    +

    Calling from Java requires just the byte array to be passed in as + the multi-argument typemap being applied reduces the number of + arguments in the target language to one, from the original two:

    -%exception getitem {
    -  try {
    -     $action
    -  } catch (std::out_of_range &e) {
    -    jclass clazz = jenv->FindClass("java/lang/Exception");
    -    jenv->ThrowNew(clazz, "Range error");
    -    return $null;
    -   }
    -}
    -
    -class FooClass {
    -public:
    -     FooClass *getitem(int index);      // Might throw std::out_of_range exception
    -     ...
    -};
    +byte[] data = "hi\0jk".getBytes();
    +example.binaryChar1(data);     
     
    -

    In the example above, java.lang.Exception is a checked - exception class and so ought to be declared in the throws clause of -getitem. Classes can be specified for adding to the throws clause - using %javaexception(classes) instead of %exception, - where classes is a string containing one or more comma - separated Java classes. The %clearjavaexception feature is the - equivalent to %clearexception and clears previously declared - exception handlers. The %nojavaexception feature is the - equivalent to %noexception and disables the exception handler. - See Clearing features - for the difference on disabling and clearing features.

    +

    resulting in the output

    -%javaexception("java.lang.Exception") getitem {
    -  try {
    -     $action
    -  } catch (std::out_of_range &e) {
    -    jclass clazz = jenv->FindClass("java/lang/Exception");
    -    jenv->ThrowNew(clazz, "Range error");
    -    return $null;
    -   }
    -}
    -
    -class FooClass {
    -public:
    -     FooClass *getitem(int index);      // Might throw std::out_of_range exception
    -     ...
    -};
    +$ java runme
    +len: 5 data: 68 69 0 6a 6b
     
    -

    The generated proxy method now generates a throws clause containing -java.lang.Exception:

    +

    25.8.6 Overriding new and delete to + allocate from Java heap

    +

    Unlike some languages supported by SWIG, Java has a true garbage + collection subsystem. Other languages will free SWIG wrapped objects + when their reference count reaches zero. Java only schedules these + objects for finalization, which may not occur for some time. Because + SWIG objects are allocated on the C heap, Java users may find the JVM + memory use quickly exceeds the assigned limits, as memory fills with + unfinalized proxy objects. Forcing garbage collection is clearly an + undesirable solution.

    +

    An elegant fix for C++ users is to override new and delete using the + following code (here shown included in a SWIG interface file)

    -public class FooClass {
    -  ...
    -  public FooClass getitem(int index) throws java.lang.Exception { ... }
    -  ...
    +/* File: java_heap.i */
    +%module test
    +%{
    +#include <stdexcept>
    +#include "jni.h"
    +
    +/**
    + *  A stash area embedded in each allocation to hold java handles
    + */
    +struct Jalloc {
    +  jbyteArray jba;
    +  jobject ref;
    +};
    +
    +static JavaVM *cached_jvm = 0;
    +
    +JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM *jvm, void *reserved) {
    +  cached_jvm = jvm;
    +  return JNI_VERSION_1_2;
    +}
    +
    +static JNIEnv * JNU_GetEnv() {
    +  JNIEnv *env;
    +  jint rc = cached_jvm->GetEnv((void **)&env, JNI_VERSION_1_2);
    +  if (rc == JNI_EDETACHED)
    +    throw std::runtime_error("current thread not attached");
    +  if (rc == JNI_EVERSION)
    +    throw std::runtime_error("jni version not supported");
    +  return env;
    +}
    +
    +void * operator new(size_t t) {
    +  if (cached_jvm != 0) {
    +    JNIEnv *env = JNU_GetEnv();
    +    jbyteArray jba = env->NewByteArray((int) t + sizeof(Jalloc));
    +    if (env->ExceptionOccurred())
    +      throw bad_alloc();
    +    void *jbuffer = static_cast<void *>(env->GetByteArrayElements(jba, 0));
    +    if (env->ExceptionOccurred())
    +      throw bad_alloc();
    +    Jalloc *pJalloc = static_cast<Jalloc *>(jbuffer);
    +    pJalloc->jba = jba;
    +    /* Assign a global reference so byte array will persist until delete'ed */
    +    pJalloc->ref = env->NewGlobalRef(jba);
    +    if (env->ExceptionOccurred())
    +      throw bad_alloc();
    +    return static_cast<void *>(static_cast<char *>(jbuffer) + sizeof(Jalloc));
    +  }
    +  else { /* JNI_OnLoad not called, use malloc and mark as special */
    +    Jalloc *pJalloc = static_cast<Jalloc *>(malloc((int) t + sizeof(Jalloc)));
    +    if (!pJalloc)
    +      throw bad_alloc();
    +    pJalloc->ref = 0;
    +    return static_cast<void *>(
    +        static_cast<char *>(static_cast<void *>(pJalloc)) + sizeof(Jalloc));
    +  }
    +}
    +
    +void operator delete(void *v) {
    +  if (v != 0) {
    +    void *buffer = static_cast<void *>( static_cast<char *>(v) - sizeof(Jalloc));
    +    Jalloc *pJalloc = static_cast<Jalloc *>(buffer);
    +    if (pJalloc->ref) {
    +      JNIEnv *env = JNU_GetEnv();
    +      env->DeleteGlobalRef(pJalloc->ref);
    +      env->ReleaseByteArrayElements(pJalloc->jba, static_cast<jbyte *>(buffer), 0);
    +    }
    +    else {
    +      free(buffer);
    +    }
    +  }
     }
    +%}
    +...
     
    -

    The examples above first use the C JNI calling syntax then the C++ - JNI calling syntax. The C++ calling syntax will not compile as C and - also vice versa. It is however possible to write JNI calls which will - compile under both C and C++ and is covered in the -Typemaps for both C and C++ compilation section.

    -

    The language-independent exception.i library file can also - be used to raise exceptions. See the SWIG Library - chapter. The typemap example Handling - C++ exception specifications as Java exceptions provides further - exception handling capabilities.

    -

    24.7.4 Method access with - %javamethodmodifiers

    -

    A Java feature called %javamethodmodifiers can be used to - change the method modifiers from the default public. It - applies to both module class methods and proxy class methods. For - example:

    +

    This code caches the Java environment during initialization, and + when new is called, a Java ByteArray is allocated to provide the SWIG + objects with space in the Java heap. This has the combined effect of + re-asserting the Java virtual machine's limit on memory allocation, and + puts additional pressure on the garbage collection system to run more + frequently. This code is made slightly more complicated because + allowances must be made if new is called before the JNI_OnLoad is + executed. This can happen during static class initialization, for + example.

    +

    Unfortunately, because most Java implementations call malloc and + free, this solution will not work for C wrapped structures. However, + you are free to make functions that allocate and free memory from the + Java heap using this model and use these functions in place of malloc + and free in your own code.

    +

    25.9 Java typemaps

    +

    This section describes how you can modify SWIG's default wrapping + behavior for various C/C++ datatypes using the %typemap + directive. You are advised to be familiar with the material in the " +Typemaps" chapter. While not absolutely essential knowledge, this + section assumes some familiarity with the Java Native Interface (JNI). + JNI documentation can be consulted either online at +Sun's Java web site or from a good JNI book. The following two books + are recommended:

    +
      +
    • Title: 'Essential JNI: Java Native Interface.' Author: Rob Gordon. + Publisher: Prentice Hall. ISBN: 0-13-679895-0.
    • +
    • Title: 'The Java Native Interface: Programmer's Guide and + Specification.' Author: Sheng Liang. Publisher: Addison-Wesley. ISBN: + 0-201-32577-2. Also available +online at the Sun Developer Network.
    • +
    +

    Before proceeding, it should be stressed that typemaps are not a + required part of using SWIG---the default wrapping behavior is enough + in most cases. Typemaps are only used if you want to change some aspect + of the generated code.

    +

    25.9.1 Default + primitive type mappings

    +

    The following table lists the default type mapping from Java to + C/C++.

    + + + + + + + + + + + + + + + + + +
    C/C++ typeJava typeJNI type +
    bool +
    const bool &
    booleanjboolean
    char +
    const char &
    charjchar
    signed char +
    const signed char &
    bytejbyte
    unsigned char +
    const unsigned char &
    shortjshort
    short +
    const short &
    shortjshort
    unsigned short +
    const unsigned short &
    intjint
    int +
    const int &
    intjint
    unsigned int +
    const unsigned int &
    longjlong
    long +
    const long &
    intjint
    unsigned long +
    const unsigned long &
    longjlong
    long long +
    const long long &
    longjlong
    unsigned long long +
    const unsigned long long &
    java.math.BigInteger +jobject
    float +
    const float &
    floatjfloat
    double +
    const double &
    doublejdouble
    char * +
    char []
    Stringjstring
    +

    Note that SWIG wraps the C char type as a character. + Pointers and arrays of this type are wrapped as strings. The signed + char type can be used if you want to treat char as a + signed number rather than a character. Also note that all const + references to primitive types are treated as if they are passed by + value.

    +

    Given the following C function:

    -%javamethodmodifiers protect_me() "protected";
    -void protect_me();
    +void func(unsigned short a, char *b, const long &c, unsigned long long d);
     
    -

    Will produce the method in the module class with protected access.

    +

    The module class method would be:

    -protected static void protect_me() {
    -  exampleJNI.protect_me();
    -}
    +public static void func(int a, String b, int c, java.math.BigInteger d) {...}
     
    -

    24.8 Tips and techniques

    -

    Although SWIG is largely automatic, there are certain types of - wrapping problems that require additional user input. Examples include - dealing with output parameters, strings and arrays. This chapter - discusses the common techniques for solving these problems.

    -

    24.8.1 Input and output - parameters using primitive pointers and references

    -

    A common problem in some C programs is handling parameters passed as - simple pointers or references. For example:

    +

    The intermediary JNI class would use the same types:

    -void add(int x, int y, int *result) {
    -   *result = x + y;
    -}
    +public final static native void func(int jarg1, String jarg2, int jarg3,
    +                                     java.math.BigInteger jarg4);
     
    -

    or perhaps

    +

    and the JNI function would look like this:

    -int sub(int *x, int *y) {
    -   return *x-*y;
    -}
    +SWIGEXPORT void JNICALL Java_exampleJNI_func(JNIEnv *jenv, jclass jcls,
    +                jint jarg1, jstring jarg2, jint jarg3, jobject jarg4) {...}
     
    -

    The typemaps.i library file will help in these situations. - For example:

    +

    The mappings for C int and C long are appropriate + for 32 bit applications which are used in the 32 bit JVMs. There is no + perfect mapping between Java and C as Java doesn't support all the + unsigned C data types. However, the mappings allow the full range of + values for each C type from Java.

    +

    25.9.2 Default + typemaps for non-primitive types

    +

    The previous section covered the primitive type mappings. + Non-primitive types such as classes and structs are mapped using + pointers on the C/C++ side and storing the pointer into a Java long + variable which is held by the proxy class or type wrapper class. This + applies whether the type is marshalled as a pointer, by reference or by + value. It also applies for any unknown/incomplete types which use type + wrapper classes.

    +

    So in summary, the C/C++ pointer to non-primitive types is cast into + the 64 bit Java long type and therefore the JNI type is a +jlong. The Java type is either the proxy class or type wrapper + class.

    +

    25.9.3 Sixty four bit JVMs

    +

    If you are using a 64 bit JVM you may have to override the C long, + but probably not C int default mappings. Mappings will be system + dependent, for example long will need remapping on Unix LP64 systems + (long, pointer 64 bits, int 32 bits), but not on Microsoft 64 bit + Windows which will be using a P64 IL32 (pointer 64 bits and int, long + 32 bits) model. This may be automated in a future version of SWIG. Note + that the Java write once run anywhere philosophy holds true for all + pure Java code when moving to a 64 bit JVM. Unfortunately it won't of + course hold true for JNI code.

    +

    25.9.4 What is a typemap?

    +

    A typemap is nothing more than a code generation rule that is + attached to a specific C datatype. For example, to convert integers + from Java to C, you might define a typemap like this:

     %module example
    -%include "typemaps.i"
     
    -void add(int, int, int *OUTPUT);
    -int  sub(int *INPUT, int *INPUT);
    +%typemap(in) int {
    +  $1 = $input;
    +  printf("Received an integer : %d\n",  $1);
    +}
    +%inline %{
    +extern int fact(int nonnegative);
    +%}
     
    -

    In Java, this allows you to pass simple values. For example:

    +

    Typemaps are always associated with some specific aspect of code + generation. In this case, the "in" method refers to the conversion of + input arguments to C/C++. The datatype int is the datatype to + which the typemap will be applied. The supplied C code is used to + convert values. In this code a number of special variables prefaced by + a $ are used. The $1 variable is a placeholder for a + local variable of type int. The $input variable + contains the Java data, the JNI jint in this case.

    +

    When this example is compiled into a Java module, it can be used as + follows:

    -int result = example.sub(7,4);
    -System.out.println("7 - 4 = " + result);
    -int[] sum = {0};
    -example.add(3,4,sum);
    -System.out.println("3 + 4 = " + sum[0]);
    +System.out.println(example.fact(6));
     
    -

    Which will display:

    +

    and the output will be:

    -7 - 4 = 3
    -3 + 4 = 7
    +Received an integer : 6
    +720
     
    -

    Notice how the INPUT parameters allow integer values to be - passed instead of pointers and how the OUTPUT parameter will - return the result in the first element of the integer array.

    -

    If you don't want to use the names INPUT or OUTPUT -, use the %apply directive. For example:

    +

    In this example, the typemap is applied to all occurrences of the +int datatype. You can refine this by supplying an optional + parameter name. For example:

     %module example
    -%include "typemaps.i"
     
    -%apply int *OUTPUT { int *result };
    -%apply int *INPUT  { int *x, int *y};
    +%typemap(in) int nonnegative {
    +  $1 = $input;
    +  printf("Received an integer : %d\n",  $1);
    +}
     
    -void add(int x, int y, int *result);
    -int  sub(int *x, int *y);
    +%inline %{
    +extern int fact(int nonnegative);
    +%}
     
    -

    If a function mutates one of its parameters like this,

    +

    In this case, the typemap code is only attached to arguments that + exactly match int nonnegative.

    +

    The application of a typemap to specific datatypes and argument + names involves more than simple text-matching--typemaps are fully + integrated into the SWIG C++ type-system. When you define a typemap for + int, that typemap applies to int and qualified + variations such as const int. In addition, the typemap system + follows typedef declarations. For example:

    -void negate(int *x) {
    -   *x = -(*x);
    +%typemap(in) int nonnegative {
    +  $1 = $input;
    +  printf("Received an integer : %d\n",  $1);
     }
    +%inline %{
    +typedef int Integer;
    +extern int fact(Integer nonnegative);    // Above typemap is applied
    +%}
     
    -

    you can use INOUT like this:

    +

    However, the matching of typedef only occurs in one + direction. If you defined a typemap for Integer, it is not + applied to arguments of type int.

    +

    Typemaps can also be defined for groups of consecutive arguments. + For example:

    -%include "typemaps.i"
    +%typemap(in) (char *str, int len) {
     ...
    -void negate(int *INOUT);
    +};
    +
    +int count(char c, char *str, int len);
     
    -

    In Java, the input parameter is the first element in a 1 element - array and is replaced by the output of the function. For example:

    +

    When a multi-argument typemap is defined, the arguments are always + handled as a single Java parameter. This allows the function to be used + like this (notice how the length parameter is omitted):

    -int[] neg = {3};
    -example.negate(neg);
    -System.out.println("Negative of 3 = " + neg[0]);
    +int c = example.count('e',"Hello World");
     
    -

    And no prizes for guessing the output:

    +

    25.9.5 Typemaps for mapping + C/C++ types to Java types

    +

    The typemaps available to the Java module include the common + typemaps listed in the main typemaps section. There are a number of + additional typemaps which are necessary for using SWIG with Java. The + most important of these implement the mapping of C/C++ types to Java + types:

    +
      + + + + + + + + + + + +
    TypemapDescription
    jniJNI C types. These provide the default mapping of + types from C/C++ to JNI for use in the JNI (C/C++) code.
    jtypeJava intermediary types. These provide the default + mapping of types from C/C++ to Java for use in the native functions in + the intermediary JNI class. The type must be the equivalent Java type + for the JNI C type specified in the "jni" typemap.
    jstypeJava types. These provide the default mapping of + types from C/C++ to Java for use in the Java module class, proxy + classes and type wrapper classes.
    javainConversion from jstype to jtype. These are Java + code typemaps which transform the type used in the Java module class, + proxy classes and type wrapper classes (as specified in the "jstype" + typemap) to the type used in the Java intermediary JNI class (as + specified in the "jtype" typemap). In other words the typemap provides + the conversion to the native method call parameter types.
    javaoutConversion from jtype to jstype. These are Java + code typemaps which transform the type used in the Java intermediary + JNI class (as specified in the "jtype" typemap) to the Java type used + in the Java module class, proxy classes and type wrapper classes (as + specified in the "jstype" typemap). In other words the typemap provides + the conversion from the native method call return type.
    javadirectorinConversion from jtype to jstype for + director methods. These are Java code typemaps which transform the type + used in the Java intermediary JNI class (as specified in the "jtype" + typemap) to the Java type used in the Java module class, proxy classes + and type wrapper classes (as specified in the "jstype" typemap). This + typemap provides the conversion for the parameters in the director + methods when calling up from C++ to Java. See +Director typemaps.
    javadirectoroutConversion from jstype to jtype for + director methods. These are Java code typemaps which transform the type + used in the Java module class, proxy classes and type wrapper classes + (as specified in the "jstype" typemap) to the type used in the Java + intermediary JNI class (as specified in the "jtype" typemap). This + typemap provides the conversion for the return type in the director + methods when returning from the C++ to Java upcall. See +Director typemaps.
    directorinConversion from C++ type to jni type for + director methods. These are C++ typemaps which convert the parameters + used in the C++ director method to the appropriate JNI intermediary + type. The conversion is done in JNI code prior to calling the Java + function from the JNI code. See +Director typemaps.
    directoroutConversion from jni type to C++ type for + director methods. These are C++ typemaps which convert the JNI return + type used in the C++ director method to the appropriate C++ return + type. The conversion is done in JNI code after calling the Java + function from the JNI code. See +Director typemaps.
    +

    If you are writing your own typemaps to handle a particular type, + you will normally have to write a collection of them. The default + typemaps are in "java.swg" and so might be a good place for + finding typemaps to base any new ones on.

    +

    The "jni", "jtype" and "jstype" typemaps are usually defined + together to handle the Java to C/C++ type mapping. An "in" typemap + should be accompanied by a "javain" typemap and likewise an "out" + typemap by a "javaout" typemap. If an "in" typemap is written, a + "freearg" and "argout" typemap may also need to be written as some + types have a default "freearg" and/or "argout" typemap which may need + overriding. The "freearg" typemap sometimes releases memory allocated + by the "in" typemap. The "argout" typemap sometimes sets values in + function parameters which are passed by reference in Java.

    +

    Note that the "in" typemap marshals the JNI type held in the "jni" + typemap to the real C/C++ type and for the opposite direction, the + "out" typemap marshals the real C/C++ type to the JNI type held in the + "jni" typemap. For +non-primitive types the "in" and "out" typemaps are responsible for + casting between the C/C++ pointer and the 64 bit jlong type. + There is no portable way to cast a pointer into a 64 bit integer type + and the approach taken by SWIG is mostly portable, but breaks C/C++ + aliasing rules. In summary, these rules state that a pointer to any + type must never be dereferenced by a pointer to any other incompatible + type. The following code snippet might aid in understand aliasing rules + better:

    -Negative of 3 = -3
    +    short a;
    +    short* pa = 0;
    +    int i = 0x1234;
    +
    +    a = (short)i;    /* okay */
    +    a = *(short*)&i; /* breaks aliasing rules */
     
    -

    These typemaps can also be applied to C++ references. The above - examples would work the same if they had been defined using references - instead of pointers. For example, the Java code to use the negate - function would be the same if it were defined either as it is above:

    +

    An email posting, +Aliasing, pointer casts and gcc 3.3 elaborates further on the + subject. In SWIG, the "in" and "out" typemaps for pointers are + typically

    -void negate(int *INOUT);
    +    %typemap(in) struct Foo * %{
    +      $1 = *(struct Foo **)&$input; /* cast jlong into C ptr */
    +    %}
    +    %typemap(out) struct Bar * %{
    +      *(struct Bar **)&$result = $1; /* cast C ptr into jlong */
    +    %} 
    +    struct Bar {...};
    +    struct Foo {...};
    +    struct Bar * FooBar(struct Foo *f);
     
    -

    or using a reference:

    +

    resulting in the following code which breaks the aliasing rules:

    -void negate(int &INOUT);
    +SWIGEXPORT jlong JNICALL Java_exampleJNI_FooBar(JNIEnv *jenv, jclass jcls,
    +                                                jlong jarg1, jobject jarg1_) {
    +  jlong jresult = 0 ;
    +  struct Foo *arg1 = (struct Foo *) 0 ;
    +  struct Bar *result = 0 ;
    +  
    +  (void)jenv;
    +  (void)jcls;
    +  (void)jarg1_;
    +  arg1 = *(struct Foo **)&jarg1; 
    +  result = (struct Bar *)FooBar(arg1);
    +  *(struct Bar **)&jresult = result; 
    +  return jresult;
    +}
     
    -

    Note: Since most Java primitive types are immutable and are passed - by value, it is not possible to perform in-place modification of a type - passed as a parameter.

    -

    Be aware that the primary purpose of the typemaps.i file is - to support primitive datatypes. Writing a function like this

    +

    If you are using gcc as your C compiler, you might get a + "dereferencing type-punned pointer will break strict-aliasing rules" + warning about this. Please see +Compiling a dynamic module to avoid runtime problems with these + strict aliasing rules.

    +

    The default code generated by SWIG for the Java module comes from + the typemaps in the "java.swg" library file which implements + the Default primitive + type mappings and +Default typemaps for non-primitive types covered earlier. There are + other type mapping typemaps in the Java library. These are listed + below:

    +
      + + + + + + + + + + + + + +
    C TypeTypemap +FileKindJava Type +Function
    primitive pointers and referencesINPUT +typemaps.iinputJava basic typesAllows values + to be used for C functions taking pointers for data input.
    primitive pointers and referencesOUTPUT +typemaps.ioutputJava basic type arraysAllows + values held within an array to be used for C functions taking pointers + for data output.
    primitive pointers and referencesINOUT +typemaps.iinput +
    output
    Java basic type arraysAllows values held + within an array to be used for C functions taking pointers for data + input and output.
    string +
    wstring
    [unnamed]std_string.iinput +
    output
    StringUse for std::string mapping to Java + String.
    arrays of primitive types[unnamed] +arrays_java.iinput +
    output
    arrays of primitive Java typesUse for + mapping C arrays to Java arrays.
    arrays of classes/structs/unionsJAVA_ARRAYSOFCLASSES + macroarrays_java.iinput +
    output
    arrays of proxy classesUse for mapping C + arrays to Java arrays.
    arrays of enumsARRAYSOFENUMSarrays_java.i +input +
    output
    int[]Use for mapping C arrays to Java + arrays (typeunsafe and simple enum wrapping approaches only).
    char *BYTEvarious.iinput +byte[]Java byte array is converted to char array
    char **STRING_ARRAYvarious.iinput +
    output
    String[]Use for mapping NULL terminated + arrays of C strings to Java String arrays
    unsigned char *NIOBUFFERvarious.i +input +
    output
    java.nio.BufferUse for mapping directly + allocated buffers to c/c++. useful with directors and long lived memory + objects
    +

    25.9.6 Java typemap attributes

    +

    There are a few additional typemap attributes that the Java module + supports.

    +

    The first of these is the 'throws' attribute. The throws attribute + is optional and specified after the typemap name and contains one or + more comma separated classes for adding to the throws clause for any + methods that use that typemap. It is analogous to the +%javaexception feature's throws attribute.

    -void foo(Bar *OUTPUT);
    +%typemap(typemapname, throws="ExceptionClass1, ExceptionClass2") type { ... }
     
    -

    will not have the intended effect since typemaps.i does not - define an OUTPUT rule for Bar.

    -

    24.8.2 Simple pointers

    -

    If you must work with simple pointers such as int * or -double * another approach to using typemaps.i is to use - the cpointer.i pointer library file. For example:

    +

    The attribute is necessary for supporting Java checked exceptions + and can be added to just about any typemap. The list of typemaps + include all the C/C++ (JNI) typemaps in the " +Typemaps" chapter and the Java specific typemaps listed in +the previous section, barring the "jni", "jtype" and "jstype" + typemaps as they could never contain code to throw an exception.

    +

    The throws clause is generated for the proxy method as well as the + JNI method in the JNI intermediary class. If a method uses more than + one typemap and each of those typemaps have classes specified in the + throws clause, the union of the exception classes is added to the + throws clause ensuring there are no duplicate classes. See the +NaN exception example for further usage.

    +

    The "jtype" typemap has the optional 'nopgcpp' attribute which can + be used to suppress the generation of the +premature garbage collection prevention parameter.

    +

    The "javain" typemap has the optional 'pre', 'post' and 'pgcppname' + attributes. These are used for generating code before and after the JNI + call in the proxy class or module class. The 'pre' attribute contains + code that is generated before the JNI call and the 'post' attribute + contains code generated after the JNI call. The 'pgcppname' attribute + is used to change the premature garbage + collection prevention parameter name passed to the JNI function. + This is sometimes needed when the 'pre' typemap creates a temporary + variable which is then passed to the JNI function.

    +

    Note that when the + 'pre' or 'post' attributes are specified and the associated type is + used in a constructor, a constructor helper function is generated. This + is necessary as the Java proxy constructor wrapper makes a call to a + support constructor using a this call. In Java the this + call must be the first statement in the constructor body. The + constructor body thus calls the helper function and the helper function + instead makes the JNI call, ensuring the 'pre' code is called before + the JNI call is made. There is a Date + marshalling example showing 'pre', 'post' and 'pgcppname' + attributes in action.

    +

    25.9.7 Java special variables

    +

    The standard SWIG special variables are available for use within + typemaps as described in the Typemaps documentation +, for example $1, $input,$result etc.

    +

    The Java module uses a few additional special variables:

    +

    $javaclassname +
    This special variable works like the other +special variables and $javaclassname is similar to +$1_type. It expands to the class name for use in Java given a + pointer. SWIG wraps unions, structs and classes using pointers and in + this case it expands to the Java proxy class name. For example, +$javaclassname is replaced by the proxy classname Foo when + wrapping a Foo * and $&javaclassname expands to the + proxy classname when wrapping the C/C++ type Foo and +$*javaclassname expands to the proxy classname when wrapping +Foo *&. If the type does not have an associated proxy class, it + expands to the type wrapper class name, for example, +SWIGTYPE_p_unsigned_short is generated when wrapping unsigned + short *. The class name is fully qualified with the package name + when using the nspace feature.

    +

    $javaclazzname +
    This special variable works like $javaclassname, but + expands the fully qualified C++ class into the package name, if used by + the nspace feature, and the proxy class + name, mangled for use as a function name. For example, +Namespace1::Namespace2::Klass is expanded into +Namespace1_Namespace2_Klass_. This special variable is usually used + for making calls to a function in the intermediary JNI class, as they + are mangled with this prefix.

    +

    $null +
    Used in input typemaps to return early from JNI functions that have + either void or a non-void return type. Example:

    -%module example
    -%include "cpointer.i"
    -
    -%inline %{
    -extern void add(int x, int y, int *result);
    +%typemap(check) int * %{ 
    +  if (error) {
    +    SWIG_JavaThrowException(jenv, SWIG_JavaIndexOutOfBoundsException, "Array element error");
    +    return $null;
    +  }
     %}
    -
    -%pointer_functions(int, intp);
    -
    -
    -

    The %pointer_functions(type,name) macro generates five - helper functions that can be used to create, destroy, copy, assign, and - dereference a pointer. In this case, the functions are as follows:

    -
    -
    -int  *new_intp();
    -int  *copy_intp(int *x);
    -void  delete_intp(int *x);
    -void  intp_assign(int *x, int value);
    -int   intp_value(int *x);
    -
    -
    -

    In Java, you would use the functions like this:

    -
    -
    -SWIGTYPE_p_int intPtr = example.new_intp();
    -example.add(3,4,intPtr);
    -int result = example.intp_value(intPtr);
    -System.out.println("3 + 4 = " + result);
    -
    -
    -

    If you replace %pointer_functions(int,intp) by -%pointer_class(int,intp), the interface is more class-like.

    -
    -
    -intp intPtr = new intp();
    -example.add(3,4,intPtr.cast());
    -int result = intPtr.value();
    -System.out.println("3 + 4 = " + result);
     
    -

    See the SWIG Library chapter for further - details.

    -

    24.8.3 Wrapping C arrays with Java - arrays

    -

    SWIG can wrap arrays in a more natural Java manner than the default - by using the arrays_java.i library file. Let's consider an - example:

    +

    If the typemap gets put into a function with void as return, $null + will expand to nothing:

    -%include "arrays_java.i";
    -int array[4];
    -void populate(int x[]) {
    -    int i;
    -    for (i=0; i<4; i++)
    -        x[i] = 100 + i;
    +SWIGEXPORT void JNICALL Java_jnifn(...) {
    +    if (error) {
    +      SWIG_JavaThrowException(jenv, SWIG_JavaIndexOutOfBoundsException, "Array element error");
    +      return ;
    +    }
    +  ...
     }
     
    -

    These one dimensional arrays can then be used as if they were Java - arrays:

    +

    otherwise $null expands to NULL

    -int[] array = new int[4];
    -example.populate(array);
    -
    -System.out.print("array: ");
    -for (int i=0; i<array.length; i++)
    -    System.out.print(array[i] + " ");
    -
    -example.setArray(array);
    -
    -int[] global_array = example.getArray();
    -
    -System.out.print("\nglobal_array: ");
    -for (int i=0; i<array.length; i++)
    -    System.out.print(global_array[i] + " ");
    +SWIGEXPORT jobject JNICALL Java_jnifn(...) {
    +    if (error) {
    +      SWIG_JavaThrowException(jenv, SWIG_JavaIndexOutOfBoundsException, "Array element error");
    +      return NULL;
    +    }
    +  ...
    +}
     
    -

    Java arrays are always passed by reference, so any changes a - function makes to the array will be seen by the calling function. Here - is the output after running this code:

    +

    $javainput, $jnicall and $owner +
    The $javainput special variable is used in "javain" typemaps and + $jnicall and $owner are used in "javaout" typemaps. $jnicall is + analogous to $action in %exception. It is replaced by the call to the + native method in the intermediary JNI class. $owner is replaced by + either true if %newobject has been used, otherwise false +. $javainput is analogous to the $input special variable. It is replaced + by the parameter name.

    +

    Here is an example:

    -array: 100 101 102 103
    -global_array: 100 101 102 103
    +%typemap(javain) Class "Class.getCPtr($javainput)"
    +%typemap(javain) unsigned short "$javainput"
    +%typemap(javaout) Class * {
    +    return new Class($jnicall, $owner);
    +  }
    +
    +%inline %{
    +    class Class {...};
    +    Class * bar(Class cls, unsigned short ush) { return new Class(); };
    +%}
     
    -

    Note that for assigning array variables the length of the C variable - is used, so it is possible to use a Java array that is bigger than the - C code will cope with. Only the number of elements in the C array will - be used. However, if the Java array is not large enough then you are - likely to get a segmentation fault or access violation, just like you - would in C. When arrays are used in functions like populate, - the size of the C array passed to the function is determined by the - size of the Java array.

    -

    Please be aware that the typemaps in this library are not efficient - as all the elements are copied from the Java array to a C array - whenever the array is passed to and from JNI code. There is an - alternative approach using the SWIG array library and this is covered - in the next section.

    -

    24.8.4 Unbounded C Arrays

    -

    Sometimes a C function expects an array to be passed as a pointer. - For example,

    +

    The generated proxy code is then:

    -int sumitems(int *first, int nitems) {
    -    int i, sum = 0;
    -    for (i = 0; i < nitems; i++) {
    -        sum += first[i];
    -    }
    -    return sum;
    +public static Class bar(Class cls, int ush) {
    +  return new Class(exampleJNI.bar(Class.getCPtr(cls), cls, ush), false);
     }
     
    -

    One of the ways to wrap this is to apply the Java array typemaps - that come in the arrays_java.i library file:

    +

    Here $javainput has been replaced by cls and ush. + $jnicall has been replaced by the native method call, +exampleJNI.bar(...) and $owner has been replaced by false. + If %newobject is used by adding the following at the beginning of our + example:

    -%include "arrays_java.i"
    -%apply int[] {int *};
    +%newobject bar(Class cls, unsigned short ush);
     
    -

    The ANY size will ensure the typemap is applied to arrays - of all sizes. You could narrow the typemap matching rules by specifying - a particular array size. Now you can use a pure Java array and pass it - to the C code:

    +

    The generated code constructs the return type using true + indicating the proxy class Class is responsible for destroying + the C++ memory allocated for it in bar:

    -int[] array = new int[10000000];          // Array of 10-million integers
    -for (int i=0; i<array.length; i++) {      // Set some values
    -  array[i] = i;
    +public static Class bar(Class cls, int ush) {
    +  return new Class(exampleJNI.bar(Class.getCPtr(cls), cls, ush), true);
     }
    -int sum = example.sumitems(array,10000);
    -System.out.println("Sum = " + sum);
     
    -

    and the sum would be displayed:

    +

    $static +
    This special variable expands to either static or nothing + depending on whether the class is an inner Java class or not. It is + used in the "javaclassmodifiers" typemap so that global classes can be + wrapped as Java proxy classes and nested C++ classes/enums can be + wrapped with the Java equivalent, that is, static inner proxy classes.

    +

    $error, $jniinput, $javacall and $packagepath +
    These special variables are used in the directors typemaps. See +Director specific typemaps for details.

    +

    $module +
    This special variable expands to the module name, as specified by +%module or the -module commandline option.

    +

    $imclassname +
    This special variable expands to the intermediary class name. + Usually this is the same as '$moduleJNI', unless the jniclassname + attribute is specified in the %module + directive.

    +

    $javainterfacename +
    This special variable is only expanded when the interface + feature is applied to a class. It works much like $javaclassname +, but instead of expanding to the proxy classname, it expands to the + value in the name attribute in the interface feature. + For example:

    -Sum = 49995000
    +%feature("interface", name="MyInterface") MyClass;
    +%typemap(jstype) MyClass  "$&javainterfacename"
    +%typemap(jstype) MyClass * "$javainterfacename"
     
    -

    This approach is probably the most natural way to use arrays. - However, it suffers from performance problems when using large arrays - as a lot of copying of the elements occurs in transferring the array - from the Java world to the C++ world. An alternative approach to using - Java arrays for C arrays is to use an alternative SWIG library file -carrays.i. This approach can be more efficient for large arrays as - the array is accessed one element at a time. For example:

    +

    will result in the jstype typemap expanding to +MyInterface for both MyClass and MyClass *. The + interface name is fully qualified with the package name when using the nspace feature.

    +

    $interfacename +
    This special variable is only expanded when the interface + feature is applied to a class. It expands to just the interface name + and is thus different to $javainterfacename in that it is not + fully qualified with the package name when using the +nspace feature.

    +

    25.9.8 Typemaps for both C and + C++ compilation

    +

    JNI calls must be written differently depending on whether the code + is being compiled as C or C++. For example C compilation requires the + pointer to a function pointer struct member syntax like

    -%include "carrays.i"
    -%array_functions(int, intArray);
    +const jclass clazz = (*jenv)->FindClass(jenv, "java/lang/String");
     
    -

    The %array_functions(type,name) macro generates four helper - functions that can be used to create and destroy arrays and operate on - elements. In this case, the functions are as follows:

    +

    whereas C++ code compilation of the same function call is a member + function call using a class pointer like

    -int *new_intArray(int nelements);
    -void delete_intArray(int *x);
    -int intArray_getitem(int *x, int index);
    -void intArray_setitem(int *x, int index, int value);
    +const jclass clazz = jenv->FindClass("java/lang/String");
     
    -

    In Java, you would use the functions like this:

    +

    To enable typemaps to be used for either C or C++ compilation, a set + of JCALLx macros have been defined in Lib/java/javahead.swg, where x is + the number of arguments in the C++ version of the JNI call. The above + JNI calls would be written in a typemap like this

    -SWIGTYPE_p_int array = example.new_intArray(10000000);  // Array of 10-million integers
    -for (int i=0; i<10000; i++) {                           // Set some values
    -    example.intArray_setitem(array,i,i);
    -}
    -int sum = example.sumitems(array,10000);
    -System.out.println("Sum = " + sum);
    +const jclass clazz = JCALL1(FindClass, jenv, "java/lang/String");
     
    -

    If you replace %array_functions(int,intp) by -%array_class(int,intp), the interface is more class-like and a - couple more helper functions are available for casting between the - array and the type wrapper class.

    +

    Note that the SWIG preprocessor expands these into the appropriate C + or C++ JNI calling convention. The C calling convention is emitted by + default and the C++ calling convention is emitted when using the -c++ + SWIG commandline option. If you do not intend your code to be targeting + both C and C++ then your typemaps can use the appropriate JNI calling + convention and need not use the JCALLx macros.

    +

    25.9.9 Java code typemaps

    +

    Most of SWIG's typemaps are used for the generation of C/C++ code. + The typemaps in this section are used solely for the generation of Java + code. Elements of proxy classes and type wrapper classes come from the + following typemaps (the defaults).

    +

    %typemap(javabase)

    +
    base (extends) for Java class: empty default +
    Note that this typemap accepts a replace attribute as an + optional flag. When set to "1", it will replace/override any C++ base + classes that might have been parsed. If this flag is not specified and + there are C++ base classes, then a multiple inheritance warning is + issued and the code in the typemap is ignored. The typemap also accepts + a notderived attribute as an optional flag. When set to "1", + it will not apply to classes that are derived from a C++ base. When + used with the SWIGTYPE type, it is useful for giving a common base for + all proxy classes, that is, providing a base class that sits in between + all proxy classes and the Java base class Object for example: +%typemap(javabase, notderived="1") SWIGTYPE "CommonBase".
    +

    %typemap(javabody)

    +
    the essential support body for proxy classes (proxy + base classes only), typewrapper classes and enum classes. Default + contains extra constructors, memory ownership control member variables + (swigCMemOwn, swigCPtr), the getCPtr method + etc.
    +

    %typemap(javabody_derived)

    +
    the essential support body for proxy classes + (derived classes only). Same as "javabody" typemap, but only used for + proxy derived classes.
    +

    %typemap(javaclassmodifiers)

    +
    class modifiers for the Java class: default is + "public class"
    +

    %typemap(javacode)

    +
    Java code is copied verbatim to the Java class: + empty default
    +

    %typemap(javadestruct, methodname="delete", + methodmodifiers="public synchronized") +

    +
    destructor wrapper - the delete() method + (proxy classes only), used for all proxy classes except those which + have a base class : default calls C++ destructor (or frees C memory) + and resets swigCPtr and swigCMemOwn flags +
    +
    Note that the delete() method name is configurable and is + specified by the methodname attribute. The method modifiers + are also configurable via the methodmodifiers attribute.
    +

    %typemap(javadestruct_derived, methodname="delete", + methodmodifiers="public synchronized")

    +
    destructor wrapper - the delete() method + (proxy classes only), same as "javadestruct" but only used for derived + proxy classes : default calls C++ destructor (or frees C memory) and + resets swigCPtr and swigCMemOwn flags +
    +
    Note that the delete() method name is configurable and is + specified by the methodname attribute. The method modifiers + are also configurable via the methodmodifiers attribute.
    +

    %typemap(javaimports)

    +
    import statements for Java class: empty default
    +

    %typemap(javainterfaces)

    +
    interfaces (implements) for Java class: empty + default
    +

    %typemap(javafinalize)

    +
    the finalize() method (proxy classes + only): default calls the delete() method +

    Note that the default javafinalize typemap must contain the full + implementation of the finalize method. Any customization to this + typemap must still declare a java finalize method with the correct + signature. Note also that the name of the generated "delete" method may + be affected by javadestruct and javadestruct_derived + typemaps. Below shows an example modifying the finalizer, assuming the +delete method has been renamed to swig_delete.

    -%include "carrays.i"
    -%array_class(int, intArray);
    +%typemap(javafinalize) SWIGTYPE %{
    +   protected void finalize() {
    +     swig_delete();  // renamed to prevent conflict with existing delete method
    +   }
    +]%
     
    -
    -

    The %array_class(type, name) macro creates wrappers for an - unbounded array object that can be passed around as a simple pointer - like int * or double *. For instance, you will be - able to do this in Java:

    +
    +

    %typemap(javainterfacecode, declaration="...", cptrmethod="...") +

    +
    +

    The code in this typemap is added to the body of a Java proxy class + but only when a class is marked with the interface feature. + The typemap is used in the proxy class marked with the interface + feature as well as all proxy classes derived from the marked C++ class, + as they are all generated as implementing the Java interface. The + default typemap used in the %interface family of macros + mentioned in the Java interfaces + section, where CTYPE is the C++ class macro argument, is as + follows:

    -intArray array = new intArray(10000000);  // Array of 10-million integers
    -for (int i=0; i<10000; i++) {             // Set some values
    -    array.setitem(i,i);
    +%typemap(javainterfacecode,
    +         declaration="  long $interfacename_GetInterfaceCPtr();\n",
    +         cptrmethod="$interfacename_GetInterfaceCPtr") CTYPE %{
    +  public long $interfacename_GetInterfaceCPtr() {
    +    return $imclassname.$javaclazzname$interfacename_GetInterfaceCPtr(swigCPtr);
    +  }
    +%}
    +
    +
    +

    The special variable $interfacename is expanded into the + name specified in the interface feature.

    +

    Compatibility Note: In SWIG-1.3.21 and earlier releases, + typemaps called "javagetcptr" and "javaptrconstructormodifiers" were + available. These are deprecated and the "javabody" typemap can be used + instead. The javainterfacecode typemap and interface feature + was introduced in SWIG-3.0.9.

    +

    In summary the contents of the typemaps make up a proxy class like + this:

    +
    +
    +[ javaimports typemap ]
    +[ javaclassmodifiers typemap ] javaclassname extends [ javabase typemap ]
    +                                             implements [ javainterfaces typemap ] {
    +[ javabody or javabody_derived typemap ]
    +[ javafinalize typemap ]
    +public synchronized void delete() [ javadestruct OR javadestruct_derived typemap ]
    +[ javacode typemap ]
    +[ javainterfacecode typemap]
    +... proxy functions ...
     }
    -int sum = example.sumitems(array.cast(),10000);
    -System.out.println("Sum = " + sum);
     
    -

    The array "object" created by %array_class() does not - encapsulate pointers inside a special array object. In fact, there is - no bounds checking or safety of any kind (just like in C). Because of - this, the arrays created by this library are extremely low-level - indeed. You can't iterate over them nor can you even query their - length. In fact, any valid memory address can be accessed if you want - (negative indices, indices beyond the end of the array, etc.). Needless - to say, this approach is not going to suit all applications. On the - other hand, this low-level approach is extremely efficient and well - suited for applications in which you need to create buffers, package - binary data, etc.

    -

    24.8.5 Binary data vs Strings

    -

    By default SWIG handles char * as a string but there is a - handy multi-argument typemap available as mentioned in -Passing binary data. The following simple example demonstrates using - a byte array instead of passing the default string type and length to - the wrapped function.

    +

    Note the delete() methodname and method modifiers + are configurable, see "javadestruct" and "javadestruct_derived" + typemaps above.

    +

    The javainterfacecode typemap is only used when bases are + marked by the interface feature and the implements + list will also then be expanded to include these Java interfaces.

    +

    The type wrapper class is similar in construction:

    -%apply (char *STRING, size_t LENGTH) { (const char data[], size_t len) }
    -%inline %{
    -void binaryChar1(const char data[], size_t len) {
    -  printf("len: %d data: ", len);
    -  for (size_t i=0; i<len; ++i)
    -    printf("%x ", data[i]);
    -  printf("\n");
    +[ javaimports typemap ]
    +[ javaclassmodifiers typemap ] javaclassname extends [ javabase typemap ]
    +                                             implements [ javainterfaces typemap ] {
    +[ javabody typemap ]
    +[ javacode typemap ]
     }
    -%}
     
    -

    Calling from Java requires just the byte array to be passed in as - the multi-argument typemap being applied reduces the number of - arguments in the target language to one, from the original two:

    +

    The enum class is also similar in construction:

    -byte[] data = "hi\0jk".getBytes();
    -example.binaryChar1(data);     
    +[ javaimports typemap ]
    +[ javaclassmodifiers typemap ] javaclassname extends [ javabase typemap ]
    +                                             implements [ javainterfaces typemap ] {
    +... Enum values ...
    +[ javabody typemap ]
    +[ javacode typemap ]
    +}
     
    -

    resulting in the output

    +

    The "javaimports" typemap is ignored if the enum class is wrapped by + an inner Java class, that is when wrapping an enum declared within a + C++ class.

    +

    The Java interface turned on by the interface feature is + fairly simple:

    -$ java runme
    -len: 5 data: 68 69 0 6a 6b
    +[ javaimports typemap ]
    +public interface [ javainterfacename ] {
    +[ javainterfacecode:cptrmethod typemap attribute ]
    +... interface declarations ...
    +}
     
    -

    24.8.6 Overriding new and delete - to allocate from Java heap

    -

    Unlike some languages supported by SWIG, Java has a true garbage - collection subsystem. Other languages will free SWIG wrapped objects - when their reference count reaches zero. Java only schedules these - objects for finalization, which may not occur for some time. Because - SWIG objects are allocated on the C heap, Java users may find the JVM - memory use quickly exceeds the assigned limits, as memory fills with - unfinalized proxy objects. Forcing garbage collection is clearly an - undesirable solution.

    -

    An elegant fix for C++ users is to override new and delete using the - following code (here shown included in a SWIG interface file)

    +

    where javainterfacename is the name attribute in + the interface feature.

    +

    The defaults can be overridden to tailor the generated classes. Here + is an example which will change the getCPtr method and + constructor from the default public access to protected access. If the + classes in one package are not using the classes in another package, + then these methods need not be public and removing access to these low + level implementation details, is a good thing. If you are invoking SWIG + more than once and generating the wrapped classes into different + packages in each invocation, then you cannot do this as you will then + have different packages.

    -/* File: java_heap.i */
    -%module test
    -%{
    -#include <stdexcept>
    -#include "jni.h"
    -
    -/**
    - *  A stash area embedded in each allocation to hold java handles
    - */
    -struct Jalloc {
    -  jbyteArray jba;
    -  jobject ref;
    -};
    -
    -static JavaVM *cached_jvm = 0;
    +%typemap(javabody) SWIGTYPE %{
    +  private transient long swigCPtr;
    +  protected transient boolean swigCMemOwn;
     
    -JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM *jvm, void *reserved) {
    -  cached_jvm = jvm;
    -  return JNI_VERSION_1_2;
    -}
    +  protected $javaclassname(long cPtr, boolean cMemoryOwn) {
    +    swigCMemOwn = cMemoryOwn;
    +    swigCPtr = cPtr;
    +  }
     
    -static JNIEnv * JNU_GetEnv() {
    -  JNIEnv *env;
    -  jint rc = cached_jvm->GetEnv((void **)&env, JNI_VERSION_1_2);
    -  if (rc == JNI_EDETACHED)
    -    throw std::runtime_error("current thread not attached");
    -  if (rc == JNI_EVERSION)
    -    throw std::runtime_error("jni version not supported");
    -  return env;
    -}
    +  protected static long getCPtr($javaclassname obj) {
    +    return (obj == null) ? 0 : obj.swigCPtr;
    +  }
    +%}
    +
    +
    +

    The typemap code is the same that is in "java.swg", barring + the last two method modifiers. Note that SWIGTYPE will target + all proxy classes, but not the type wrapper classes. Also the above + typemap is only used for proxy classes that are potential base classes. + To target proxy classes that are derived from a wrapped class as well, + the "javabody_derived" typemap should also be overridden.

    +

    For the typemap to be used in all type wrapper classes, all the + different types that type wrapper classes could be used for should be + targeted:

    +
    +
    +%typemap(javabody) SWIGTYPE *, SWIGTYPE &, SWIGTYPE [], SWIGTYPE (CLASS::*) %{
    +  private transient long swigCPtr;
     
    -void * operator new(size_t t) {
    -  if (cached_jvm != 0) {
    -    JNIEnv *env = JNU_GetEnv();
    -    jbyteArray jba = env->NewByteArray((int) t + sizeof(Jalloc));
    -    if (env->ExceptionOccurred())
    -      throw bad_alloc();
    -    void *jbuffer = static_cast<void *>(env->GetByteArrayElements(jba, 0));
    -    if (env->ExceptionOccurred())
    -      throw bad_alloc();
    -    Jalloc *pJalloc = static_cast<Jalloc *>(jbuffer);
    -    pJalloc->jba = jba;
    -    /* Assign a global reference so byte array will persist until delete'ed */
    -    pJalloc->ref = env->NewGlobalRef(jba);
    -    if (env->ExceptionOccurred())
    -      throw bad_alloc();
    -    return static_cast<void *>(static_cast<char *>(jbuffer) + sizeof(Jalloc));
    +  protected $javaclassname(long cPtr, boolean bFutureUse) {
    +    swigCPtr = cPtr;
       }
    -  else { /* JNI_OnLoad not called, use malloc and mark as special */
    -    Jalloc *pJalloc = static_cast<Jalloc *>(malloc((int) t + sizeof(Jalloc)));
    -    if (!pJalloc)
    -      throw bad_alloc();
    -    pJalloc->ref = 0;
    -    return static_cast<void *>(
    -        static_cast<char *>(static_cast<void *>(pJalloc)) + sizeof(Jalloc));
    +
    +  protected $javaclassname() {
    +    swigCPtr = 0;
       }
    -}
     
    -void operator delete(void *v) {
    -  if (v != 0) {
    -    void *buffer = static_cast<void *>( static_cast<char *>(v) - sizeof(Jalloc));
    -    Jalloc *pJalloc = static_cast<Jalloc *>(buffer);
    -    if (pJalloc->ref) {
    -      JNIEnv *env = JNU_GetEnv();
    -      env->DeleteGlobalRef(pJalloc->ref);
    -      env->ReleaseByteArrayElements(pJalloc->jba, static_cast<jbyte *>(buffer), 0);
    -    }
    -    else {
    -      free(buffer);
    -    }
    +  protected static long getCPtr($javaclassname obj) {
    +    return (obj == null) ? 0 : obj.swigCPtr;
       }
    -}
     %}
    -...
     
    -

    This code caches the Java environment during initialization, and - when new is called, a Java ByteArray is allocated to provide the SWIG - objects with space in the Java heap. This has the combined effect of - re-asserting the Java virtual machine's limit on memory allocation, and - puts additional pressure on the garbage collection system to run more - frequently. This code is made slightly more complicated because - allowances must be made if new is called before the JNI_OnLoad is - executed. This can happen during static class initialization, for - example.

    -

    Unfortunately, because most Java implementations call malloc and - free, this solution will not work for C wrapped structures. However, - you are free to make functions that allocate and free memory from the - Java heap using this model and use these functions in place of malloc - and free in your own code.

    -

    24.9 Java typemaps

    -

    This section describes how you can modify SWIG's default wrapping - behavior for various C/C++ datatypes using the %typemap - directive. You are advised to be familiar with the material in the " -Typemaps" chapter. While not absolutely essential knowledge, this - section assumes some familiarity with the Java Native Interface (JNI). - JNI documentation can be consulted either online at -Sun's Java web site or from a good JNI book. The following two books - are recommended:

    -
      -
    • Title: 'Essential JNI: Java Native Interface.' Author: Rob Gordon. - Publisher: Prentice Hall. ISBN: 0-13-679895-0.
    • -
    • Title: 'The Java Native Interface: Programmer's Guide and - Specification.' Author: Sheng Liang. Publisher: Addison-Wesley. ISBN: - 0-201-32577-2. Also available -online at the Sun Developer Network.
    • -
    -

    Before proceeding, it should be stressed that typemaps are not a - required part of using SWIG---the default wrapping behavior is enough - in most cases. Typemaps are only used if you want to change some aspect - of the generated code.

    -

    24.9.1 Default - primitive type mappings

    -

    The following table lists the default type mapping from Java to - C/C++.

    - - - - - - - - - - - - - - - - - -
    C/C++ typeJava typeJNI type -
    bool -
    const bool &
    booleanjboolean
    char -
    const char &
    charjchar
    signed char -
    const signed char &
    bytejbyte
    unsigned char -
    const unsigned char &
    shortjshort
    short -
    const short &
    shortjshort
    unsigned short -
    const unsigned short &
    intjint
    int -
    const int &
    intjint
    unsigned int -
    const unsigned int &
    longjlong
    long -
    const long &
    intjint
    unsigned long -
    const unsigned long &
    longjlong
    long long -
    const long long &
    longjlong
    unsigned long long -
    const unsigned long long &
    java.math.BigInteger -jobject
    float -
    const float &
    floatjfloat
    double -
    const double &
    doublejdouble
    char * -
    char []
    Stringjstring
    -

    Note that SWIG wraps the C char type as a character. - Pointers and arrays of this type are wrapped as strings. The signed - char type can be used if you want to treat char as a - signed number rather than a character. Also note that all const - references to primitive types are treated as if they are passed by - value.

    -

    Given the following C function:

    +

    Again this is the same that is in "java.swg", barring the + method modifier for getCPtr.

    +

    When using multiple modules or the +nspace feature it is common to invoke SWIG with a different +-package command line option for each module. However, by default + the generated code may not compile if generated classes in one package + use generated classes in another package. The visibility of the +getCPtr() and pointer constructor generated from the javabody + typemaps needs changing. The default visibility is protected + but it needs to be public for access from a different package. + Just changing 'protected' to 'public' in the typemap achieves this. Two + macros are available in java.swg to make this easier and using + them is the preferred approach over simply copying the typemaps and + modifying as this is forward compatible with any changes in the +javabody typemap in future versions of SWIG. The macros are for the + proxy and typewrapper classes and can respectively be used to to make + the method and constructor public:

    +
    +
    +  SWIG_JAVABODY_PROXY(public, public, SWIGTYPE)
    +  SWIG_JAVABODY_TYPEWRAPPER(public, public, public, SWIGTYPE)
    +
    +
    +

    25.9.10 Director specific typemaps +

    +

    The Java directors feature requires the "javadirectorin", + "javadirectorout", "directorin" and the "directorout" typemaps in order + to work properly. The "javapackage" typemap is an optional typemap used + to identify the Java package path for individual SWIG generated proxy + classes used in director methods.

    +

    %typemap(directorin)

    +
    +

    The "directorin" typemap is used for converting arguments in the C++ + director class to the appropriate JNI type before the upcall to Java. + This typemap also specifies the JNI field descriptor for the type in + the "descriptor" attribute. For example, integers are converted as + follows:

    +
    +
    +%typemap(directorin,descriptor="I") int "$input = (jint) $1;"
    +
    +
    +

    $input is the SWIG name of the JNI temporary variable + passed to Java in the upcall. The descriptor="I" will put + an I into the JNI field descriptor that identifies the + Java method that will be called from C++. For more about JNI field + descriptors and their importance, refer to the +JNI documentation mentioned earlier. A typemap for C character + strings is:

    -void func(unsigned short a, char *b, const long &c, unsigned long long d);
    +%typemap(directorin,descriptor="Ljava/lang/String;") char *
    +  %{ $input = jenv->NewStringUTF($1); %}
     
    -

    The module class method would be:

    +

    User-defined types have the default "descriptor" attribute " +L$packagepath/$javaclassname;" where $packagepath is + the package name passed from the SWIG command line and +$javaclassname is the Java proxy class' name. If the -package + commandline option is not used to specify the package, then + '$packagepath/' will be removed from the resulting output JNI field + descriptor. Do not forget the terminating ';' for JNI field + descriptors starting with 'L'. If the ';' is left out, Java will + generate a "method not found" runtime error. Note that the +$packagepath substitution always uses the path separator '/' when + expanded. The $javaclassname expansion can be confusing as + it is normally expanded using the '.' separator. However, +$javaclassname is expanded using the path separator '/' in + typemap's "descriptor" attribute as well as in the "directorthrows" + typemap.

    +
    +

    %typemap(directorout)

    +
    +

    The "directorout" typemap is used for converting the JNI return type + in the C++ director class to the appropriate C++ type after the upcall + to Java. For example, integers are converted as follows:

    -public static void func(int a, String b, int c, java.math.BigInteger d) {...}
    +%typemap(directorout) int %{ $result = (int)$input; %}
     
    -

    The intermediary JNI class would use the same types:

    +

    $input is the SWIG name of the JNI temporary variable + returned from Java after the upcall. $result is the + resulting output. A typemap for C character strings is:

    -public final static native void func(int jarg1, String jarg2, int jarg3,
    -                                     java.math.BigInteger jarg4);
    +%typemap(directorout) char * {
    +  $1 = 0;
    +  if ($input) {
    +    $result = (char *)jenv->GetStringUTFChars($input, 0);
    +    if (!$1) return $null;
    +  }
    +}
    +
    +
    +

    %typemap(javadirectorin)

    +
    +

    Conversion from jtype to jstype for director methods. These are Java + code typemaps which transform the type used in the Java intermediary + JNI class (as specified in the "jtype" typemap) to the Java type used + in the Java module class, proxy classes and type wrapper classes (as + specified in the "jstype" typemap). This typemap provides the + conversion for the parameters in the director methods when calling up + from C++ to Java.

    +

    For primitive types, this typemap is usually specified as:

    +
    +
    +%typemap(javadirectorin) int "$jniinput"
     
    -

    and the JNI function would look like this:

    +

    The $jniinput special variable is analogous to +$javainput special variable. It is replaced by the input + parameter name.

    +
    +

    %typemap(javadirectorout)

    +
    +

    Conversion from jstype to jtype for director methods. These are Java + code typemaps which transform the type used in the Java module class, + proxy classes and type wrapper classes (as specified in the "jstype" + typemap) to the type used in the Java intermediary JNI class (as + specified in the "jtype" typemap). This typemap provides the conversion + for the return type in the director methods when returning from the C++ + to Java upcall.

    +

    For primitive types, this typemap is usually specified as:

    -SWIGEXPORT void JNICALL Java_exampleJNI_func(JNIEnv *jenv, jclass jcls,
    -                jint jarg1, jstring jarg2, jint jarg3, jobject jarg4) {...}
    +%typemap(javadirectorout) int "$javacall"
     
    -

    The mappings for C int and C long are appropriate - for 32 bit applications which are used in the 32 bit JVMs. There is no - perfect mapping between Java and C as Java doesn't support all the - unsigned C data types. However, the mappings allow the full range of - values for each C type from Java.

    -

    24.9.2 Default - typemaps for non-primitive types

    -

    The previous section covered the primitive type mappings. - Non-primitive types such as classes and structs are mapped using - pointers on the C/C++ side and storing the pointer into a Java long - variable which is held by the proxy class or type wrapper class. This - applies whether the type is marshalled as a pointer, by reference or by - value. It also applies for any unknown/incomplete types which use type - wrapper classes.

    -

    So in summary, the C/C++ pointer to non-primitive types is cast into - the 64 bit Java long type and therefore the JNI type is a -jlong. The Java type is either the proxy class or type wrapper - class.

    -

    24.9.3 Sixty four bit JVMs

    -

    If you are using a 64 bit JVM you may have to override the C long, - but probably not C int default mappings. Mappings will be system - dependent, for example long will need remapping on Unix LP64 systems - (long, pointer 64 bits, int 32 bits), but not on Microsoft 64 bit - Windows which will be using a P64 IL32 (pointer 64 bits and int, long - 32 bits) model. This may be automated in a future version of SWIG. Note - that the Java write once run anywhere philosophy holds true for all - pure Java code when moving to a 64 bit JVM. Unfortunately it won't of - course hold true for JNI code.

    -

    24.9.4 What is a typemap?

    -

    A typemap is nothing more than a code generation rule that is - attached to a specific C datatype. For example, to convert integers - from Java to C, you might define a typemap like this:

    +

    The $javacall special variable is analogous to the +$jnicall special variable. It is replaced by the call to the + target Java method. The target method is the method in the Java proxy + class which overrides the virtual C++ method in the C++ base class.

    +
    +

    %typemap(directorthrows)

    +
    +

    Conversion of Java exceptions to C++ exceptions in director method's + exception handling. This typemap is expected to test the $error + special variable for a matching Java exception and if successful + convert and throw it into a C++ exception given by the typemap's type. + The $error special variable is of type jthrowable + and is substituted with a unique variable name in the generated code.

    +

    The example below converts a Java +java.lang.IndexOutOfBoundsException exception to the typemap's + type, that is std::out_of_range:

    -%module example
    -
    -%typemap(in) int {
    -  $1 = $input;
    -  printf("Received an integer : %d\n",  $1);
    -}
    -%inline %{
    -extern int fact(int nonnegative);
    +%typemap(directorthrows) std::out_of_range %{
    +  if (Swig::ExceptionMatches(jenv, $error, "java/lang/IndexOutOfBoundsException")) {
    +    throw std::out_of_range(Swig::JavaExceptionMessage(jenv, $error).message());
    +  }
     %}
     
    -

    Typemaps are always associated with some specific aspect of code - generation. In this case, the "in" method refers to the conversion of - input arguments to C/C++. The datatype int is the datatype to - which the typemap will be applied. The supplied C code is used to - convert values. In this code a number of special variables prefaced by - a $ are used. The $1 variable is a placeholder for a - local variable of type int. The $input variable - contains the Java data, the JNI jint in this case.

    -

    When this example is compiled into a Java module, it can be used as - follows:

    +

    The utility function Swig::ExceptionMatches and class +Swig::JavaExceptionMessage are helpers available when using + directors and are described in the +Java Exceptions from Directors section.

    +
    +

    %typemap(javapackage)

    +
    +

    The "javapackage" typemap is optional; it serves to identify a + class's Java package. This typemap should be used in conjunction with + classes that are defined outside of the current SWIG interface file. + The typemap is only used if the type is used in a director method, that + is, in a virtual method in a director class. For example:

    -System.out.println(example.fact(6));
    +// class Foo is handled in a different interface file:
    +%import "Foo.i"
    +
    +%feature("director") Example;
    +
    +%inline {
    +  class Bar { };
    +
    +  class Example {
    +  public:
    +    virtual ~Example();
    +    virtual void ping(Foo *arg1, Bar *arg2);
    +  };
    +}
     
    -

    and the output will be:

    +

    Assume that the Foo class is part of the Java package + com.wombat.foo but the above interface file is part of the Java + package com.wombat.example. Without the "javapackage" typemap, + SWIG will assume that the Foo class belongs to com.wombat.example + class. The corrected interface file looks like:

    -Received an integer : 6
    -720
    +// class Foo is handled in a different interface file:
    +%import "Foo.i"
    +%typemap("javapackage") Foo, Foo *, Foo & "com.wombat.foo";
    +%feature("director") Example;
    +
    +%inline {
    +  class Bar { };
    +
    +  class Example {
    +  public:
    +    virtual ~Example();
    +    virtual void ping(Foo *arg1, Bar *arg2);
    +  };
    +}
     
    -

    In this example, the typemap is applied to all occurrences of the -int datatype. You can refine this by supplying an optional - parameter name. For example:

    +

    SWIG looks up the package based on the actual type (plain + Foo, Foo pointer and Foo reference), so it is important to associate + all three types with the desired package. Practically speaking, you + should create a separate SWIG interface file, which is %import-ed into + each SWIG interface file, when you have multiple Java packages. Note + the helper macros below, OTHER_PACKAGE_SPEC and +ANOTHER_PACKAGE_SPEC, which reduce the amount of extra typing. " +TYPE..." is useful when passing templated types to the macro, + since multiargument template types appear to the SWIG preprocessor as + multiple macro arguments.

    -%module example
    +%typemap("javapackage") SWIGTYPE, SWIGTYPE *, SWIGTYPE &
    +                                            "package.for.most.classes";
     
    -%typemap(in) int nonnegative {
    -  $1 = $input;
    -  printf("Received an integer : %d\n",  $1);
    -}
    +%define OTHER_PACKAGE_SPEC(TYPE...)
    +%typemap("javapackage") TYPE, TYPE *, TYPE & "package.for.other.classes";
    +%enddef
     
    -%inline %{
    -extern int fact(int nonnegative);
    -%}
    +%define ANOTHER_PACKAGE_SPEC(TYPE...)
    +%typemap("javapackage") TYPE, TYPE *, TYPE & "package.for.another.set";
    +%enddef
    +
    +OTHER_PACKAGE_SPEC(Package_2_class_one)
    +ANOTHER_PACKAGE_SPEC(Package_3_class_two)
    +/* etc */
     
    -

    In this case, the typemap code is only attached to arguments that - exactly match int nonnegative.

    -

    The application of a typemap to specific datatypes and argument - names involves more than simple text-matching--typemaps are fully - integrated into the SWIG C++ type-system. When you define a typemap for - int, that typemap applies to int and qualified - variations such as const int. In addition, the typemap system - follows typedef declarations. For example:

    +

    The basic strategy here is to provide a default package typemap for + the majority of the classes, only providing "javapackage" typemaps for + the exceptions.

    +
    +

    25.10 Typemap Examples

    +

    This section includes a few examples of typemaps. For more examples, + you might look at the files "java.swg" and "typemaps.i +" in the SWIG library.

    +

    25.10.1 Simpler Java enums for + enums without initializers

    +

    The default Proper Java enums + approach to wrapping enums is somewhat verbose. This is to handle all + possible C/C++ enums, in particular enums with initializers. The + generated code can be simplified if the enum being wrapped does not + have any initializers.

    +

    The following shows how to remove the support methods that are + generated by default and instead use the methods in the Java enum base + class java.lang.Enum and java.lang.Class for + marshalling enums between C/C++ and Java. The type used for the + typemaps below is enum SWIGTYPE which is the default type used + for all enums. The "enums.swg" file should be examined in order to see + the original overridden versions of the typemaps.

    -%typemap(in) int nonnegative {
    -  $1 = $input;
    -  printf("Received an integer : %d\n",  $1);
    -}
    +%include "enums.swg"
    +
    +%typemap(javain) enum SWIGTYPE "$javainput.ordinal()"
    +%typemap(javaout) enum SWIGTYPE {
    +    return $javaclassname.class.getEnumConstants()[$jnicall];
    +  }
    +%typemap(javabody) enum SWIGTYPE ""
    +
     %inline %{
    -typedef int Integer;
    -extern int fact(Integer nonnegative);    // Above typemap is applied
    +  enum HairType { blonde, ginger, brunette };
    +  void setHair(HairType h);
    +  HairType getHair();
     %}
     
    -

    However, the matching of typedef only occurs in one - direction. If you defined a typemap for Integer, it is not - applied to arguments of type int.

    -

    Typemaps can also be defined for groups of consecutive arguments. - For example:

    +

    SWIG will generate the following Java enum, which is somewhat + simpler than the default:

    -%typemap(in) (char *str, int len) {
    -...
    -};
    -
    -int count(char c, char *str, int len);
    +public enum HairType {
    +  blonde,
    +  ginger,
    +  brunette;
    +}
     
    -

    When a multi-argument typemap is defined, the arguments are always - handled as a single Java parameter. This allows the function to be used - like this (notice how the length parameter is omitted):

    +

    and the two Java proxy methods will be:

    -int c = example.count('e',"Hello World");
    +public static void setHair(HairType h) {
    +  exampleJNI.setHair(h.ordinal());
    +}
    +
    +public static HairType getHair() {
    +  return HairType.class.getEnumConstants()[exampleJNI.getHair()];
    +}
     
    -

    24.9.5 Typemaps for - mapping C/C++ types to Java types

    -

    The typemaps available to the Java module include the common - typemaps listed in the main typemaps section. There are a number of - additional typemaps which are necessary for using SWIG with Java. The - most important of these implement the mapping of C/C++ types to Java - types:

    -
      - - - - - - - - - - - -
    TypemapDescription
    jniJNI C types. These provide the default mapping of - types from C/C++ to JNI for use in the JNI (C/C++) code.
    jtypeJava intermediary types. These provide the default - mapping of types from C/C++ to Java for use in the native functions in - the intermediary JNI class. The type must be the equivalent Java type - for the JNI C type specified in the "jni" typemap.
    jstypeJava types. These provide the default mapping of - types from C/C++ to Java for use in the Java module class, proxy - classes and type wrapper classes.
    javainConversion from jstype to jtype. These are Java - code typemaps which transform the type used in the Java module class, - proxy classes and type wrapper classes (as specified in the "jstype" - typemap) to the type used in the Java intermediary JNI class (as - specified in the "jtype" typemap). In other words the typemap provides - the conversion to the native method call parameter types.
    javaoutConversion from jtype to jstype. These are Java - code typemaps which transform the type used in the Java intermediary - JNI class (as specified in the "jtype" typemap) to the Java type used - in the Java module class, proxy classes and type wrapper classes (as - specified in the "jstype" typemap). In other words the typemap provides - the conversion from the native method call return type.
    javadirectorinConversion from jtype to jstype for - director methods. These are Java code typemaps which transform the type - used in the Java intermediary JNI class (as specified in the "jtype" - typemap) to the Java type used in the Java module class, proxy classes - and type wrapper classes (as specified in the "jstype" typemap). This - typemap provides the conversion for the parameters in the director - methods when calling up from C++ to Java. See -Director typemaps.
    javadirectoroutConversion from jstype to jtype for - director methods. These are Java code typemaps which transform the type - used in the Java module class, proxy classes and type wrapper classes - (as specified in the "jstype" typemap) to the type used in the Java - intermediary JNI class (as specified in the "jtype" typemap). This - typemap provides the conversion for the return type in the director - methods when returning from the C++ to Java upcall. See -Director typemaps.
    directorinConversion from C++ type to jni type for - director methods. These are C++ typemaps which convert the parameters - used in the C++ director method to the appropriate JNI intermediary - type. The conversion is done in JNI code prior to calling the Java - function from the JNI code. See -Director typemaps.
    directoroutConversion from jni type to C++ type for - director methods. These are C++ typemaps which convert the JNI return - type used in the C++ director method to the appropriate C++ return - type. The conversion is done in JNI code after calling the Java - function from the JNI code. See -Director typemaps.
    -

    If you are writing your own typemaps to handle a particular type, - you will normally have to write a collection of them. The default - typemaps are in "java.swg" and so might be a good place for - finding typemaps to base any new ones on.

    -

    The "jni", "jtype" and "jstype" typemaps are usually defined - together to handle the Java to C/C++ type mapping. An "in" typemap - should be accompanied by a "javain" typemap and likewise an "out" - typemap by a "javaout" typemap. If an "in" typemap is written, a - "freearg" and "argout" typemap may also need to be written as some - types have a default "freearg" and/or "argout" typemap which may need - overriding. The "freearg" typemap sometimes releases memory allocated - by the "in" typemap. The "argout" typemap sometimes sets values in - function parameters which are passed by reference in Java.

    -

    Note that the "in" typemap marshals the JNI type held in the "jni" - typemap to the real C/C++ type and for the opposite direction, the - "out" typemap marshals the real C/C++ type to the JNI type held in the - "jni" typemap. For -non-primitive types the "in" and "out" typemaps are responsible for - casting between the C/C++ pointer and the 64 bit jlong type. - There is no portable way to cast a pointer into a 64 bit integer type - and the approach taken by SWIG is mostly portable, but breaks C/C++ - aliasing rules. In summary, these rules state that a pointer to any - type must never be dereferenced by a pointer to any other incompatible - type. The following code snippet might aid in understand aliasing rules - better:

    +

    For marshalling Java enums to C/C++ enums, the ordinal + method is used to convert the Java enum into an integer value for + passing to the JNI layer, see the "javain" typemap. For marshalling + C/C++ enums to Java enums, the C/C++ enum value is cast to an integer + in the C/C++ typemaps (not shown). This integer value is then used to + index into the array of enum constants that the Java language provides. + See the getEnumConstants method in the "javaout" typemap.

    +

    These typemaps can often be used as the default for wrapping enums + as in many cases there won't be any enum initializers. In fact a good + strategy is to always use these typemaps and to specifically handle + enums with initializers using %apply. This would be done by using the + original versions of these typemaps in "enums.swg" under another + typemap name for applying using %apply.

    +

    25.10.2 Handling C++ exception + specifications as Java exceptions

    +

    This example demonstrates various ways in which C++ exceptions can + be tailored and converted into Java exceptions. Let's consider a simple + file class SimpleFile and an exception class FileException + which it may throw on error:

    -    short a;
    -    short* pa = 0;
    -    int i = 0x1234;
    +%include "std_string.i" // for std::string typemaps
    +#include <string>
     
    -    a = (short)i;    /* okay */
    -    a = *(short*)&i; /* breaks aliasing rules */
    +class FileException {
    +  std::string message;
    +public:
    +  FileException(const std::string& msg) : message(msg) {}
    +  std::string what() {
    +    return message;
    +  }
    +};
    +
    +class SimpleFile {
    +  std::string filename;
    +public:
    +  SimpleFile(const std::string& filename) : filename(filename) {}
    +  void open() throw(FileException) {
    +  ...
    +  }
    +};
     
    -

    An email posting, -Aliasing, pointer casts and gcc 3.3 elaborates further on the - subject. In SWIG, the "in" and "out" typemaps for pointers are - typically

    +

    As the open method has a C++ exception specification, SWIG + will parse this and know that the method can throw an exception. The +"throws" typemap is then used when SWIG encounters an exception + specification. The default generic "throws" typemap looks like this:

    -    %typemap(in) struct Foo * %{
    -      $1 = *(struct Foo **)&$input; /* cast jlong into C ptr */
    -    %}
    -    %typemap(out) struct Bar * %{
    -      *(struct Bar **)&$result = $1; /* cast C ptr into jlong */
    -    %} 
    -    struct Bar {...};
    -    struct Foo {...};
    -    struct Bar * FooBar(struct Foo *f);
    +%typemap(throws) SWIGTYPE, SWIGTYPE &, SWIGTYPE *, SWIGTYPE [ANY] %{
    +  SWIG_JavaThrowException(jenv, SWIG_JavaRuntimeException,
    +                          "C++ $1_type exception thrown");
    +  return $null;
    +%}
     
    -

    resulting in the following code which breaks the aliasing rules:

    +

    Basically SWIG will generate a C++ try catch block and the body of + the "throws" typemap constitutes the catch block. The above typemap + calls a SWIG supplied method which throws a +java.lang.RuntimeException. This exception class is a runtime + exception and therefore not a checked exception. If, however, we wanted + to throw a checked exception, say java.io.IOException, then we + could use the following typemap:

    -SWIGEXPORT jlong JNICALL Java_exampleJNI_FooBar(JNIEnv *jenv, jclass jcls,
    -                                                jlong jarg1, jobject jarg1_) {
    -  jlong jresult = 0 ;
    -  struct Foo *arg1 = (struct Foo *) 0 ;
    -  struct Bar *result = 0 ;
    -  
    -  (void)jenv;
    -  (void)jcls;
    -  (void)jarg1_;
    -  arg1 = *(struct Foo **)&jarg1; 
    -  result = (struct Bar *)FooBar(arg1);
    -  *(struct Bar **)&jresult = result; 
    -  return jresult;
    +%typemap(throws, throws="java.io.IOException") FileException {
    +  jclass excep = jenv->FindClass("java/io/IOException");
    +  if (excep)
    +    jenv->ThrowNew(excep, $1.what().c_str());
    +  return $null;
     }
     
    -

    If you are using gcc as your C compiler, you might get a - "dereferencing type-punned pointer will break strict-aliasing rules" - warning about this. Please see -Compiling a dynamic module to avoid runtime problems with these - strict aliasing rules.

    -

    The default code generated by SWIG for the Java module comes from - the typemaps in the "java.swg" library file which implements - the Default primitive - type mappings and -Default typemaps for non-primitive types covered earlier. There are - other type mapping typemaps in the Java library. These are listed - below:

    -
      - - - - - - - - - - - - -
    C TypeTypemap -FileKindJava Type -Function
    primitive pointers and referencesINPUT -typemaps.iinputJava basic typesAllows values - to be used for C functions taking pointers for data input.
    primitive pointers and referencesOUTPUT -typemaps.ioutputJava basic type arraysAllows - values held within an array to be used for C functions taking pointers - for data output.
    primitive pointers and referencesINOUT -typemaps.iinput -
    output
    Java basic type arraysAllows values held - within an array to be used for C functions taking pointers for data - input and output.
    string -
    wstring
    [unnamed]std_string.iinput -
    output
    StringUse for std::string mapping to Java - String.
    arrays of primitive types[unnamed] -arrays_java.iinput -
    output
    arrays of primitive Java typesUse for - mapping C arrays to Java arrays.
    arrays of classes/structs/unionsJAVA_ARRAYSOFCLASSES - macroarrays_java.iinput -
    output
    arrays of proxy classesUse for mapping C - arrays to Java arrays.
    arrays of enumsARRAYSOFENUMSarrays_java.i -input -
    output
    int[]Use for mapping C arrays to Java - arrays (typeunsafe and simple enum wrapping approaches only).
    char *BYTEvarious.iinput -byte[]Java byte array is converted to char array
    char **STRING_ARRAYvarious.iinput -
    output
    String[]Use for mapping NULL terminated - arrays of C strings to Java String arrays
    -

    24.9.6 Java typemap attributes

    -

    There are a few additional typemap attributes that the Java module - supports.

    -

    The first of these is the 'throws' attribute. The throws attribute - is optional and specified after the typemap name and contains one or - more comma separated classes for adding to the throws clause for any - methods that use that typemap. It is analogous to the -%javaexception feature's throws attribute.

    +

    Note that this typemap uses the 'throws' +typemap attribute to ensure a throws clause is generated. The + generated proxy method then specifies the checked exception by + containing java.io.IOException in the throws clause:

    -%typemap(typemapname, throws="ExceptionClass1, ExceptionClass2") type { ... }
    +public class SimpleFile {
    +  ...
    +  public void open() throws java.io.IOException { ... }
    +}
     
    -

    The attribute is necessary for supporting Java checked exceptions - and can be added to just about any typemap. The list of typemaps - include all the C/C++ (JNI) typemaps in the " -Typemaps" chapter and the Java specific typemaps listed in -the previous section, barring the "jni", "jtype" and "jstype" - typemaps as they could never contain code to throw an exception.

    -

    The throws clause is generated for the proxy method as well as the - JNI method in the JNI intermediary class. If a method uses more than - one typemap and each of those typemaps have classes specified in the - throws clause, the union of the exception classes is added to the - throws clause ensuring there are no duplicate classes. See the -NaN exception example for further usage.

    -

    The "jtype" typemap has the optional 'nopgcpp' attribute which can - be used to suppress the generation of the -premature garbage collection prevention parameter.

    -

    The "javain" typemap has the optional 'pre', 'post' and 'pgcppname' - attributes. These are used for generating code before and after the JNI - call in the proxy class or module class. The 'pre' attribute contains - code that is generated before the JNI call and the 'post' attribute - contains code generated after the JNI call. The 'pgcppname' attribute - is used to change the premature garbage - collection prevention parameter name passed to the JNI function. - This is sometimes needed when the 'pre' typemap creates a temporary - variable which is then passed to the JNI function.

    -

    Note that when the - 'pre' or 'post' attributes are specified and the associated type is - used in a constructor, a constructor helper function is generated. This - is necessary as the Java proxy constructor wrapper makes a call to a - support constructor using a this call. In Java the this - call must be the first statement in the constructor body. The - constructor body thus calls the helper function and the helper function - instead makes the JNI call, ensuring the 'pre' code is called before - the JNI call is made. There is a Date - marshalling example showing 'pre', 'post' and 'pgcppname' - attributes in action.

    -

    24.9.7 Java special variables

    -

    The standard SWIG special variables are available for use within - typemaps as described in the Typemaps documentation -, for example $1, $input,$result etc.

    -

    The Java module uses a few additional special variables:

    -

    $javaclassname -
    This special variable works like the other -special variables and $javaclassname is similar to -$1_type. It expands to the class name for use in Java given a - pointer. SWIG wraps unions, structs and classes using pointers and in - this case it expands to the Java proxy class name. For example, -$javaclassname is replaced by the proxy classname Foo when - wrapping a Foo * and $&javaclassname expands to the - proxy classname when wrapping the C/C++ type Foo and -$*javaclassname expands to the proxy classname when wrapping -Foo *&. If the type does not have an associated proxy class, it - expands to the type wrapper class name, for example, -SWIGTYPE_p_unsigned_short is generated when wrapping unsigned - short *.

    -

    $javaclazzname -
    This special variable works like $javaclassname, but - expands the fully qualified C++ class into the package name, if used by - the nspace feature, and the proxy class - name, mangled for use as a function name. For example, -Namespace1::Namespace2::Klass is expanded into -Namespace1_Namespace2_Klass_. This special variable is usually used - for making calls to a function in the intermediary JNI class, as they - are mangled with this prefix.

    -

    $null -
    Used in input typemaps to return early from JNI functions that have - either void or a non-void return type. Example:

    +

    Lastly, if you don't want to map your C++ exception into one of the + standard Java exceptions, the C++ class can be wrapped and turned into + a custom Java exception class. If we go back to our example, the first + thing we must do is get SWIG to wrap FileException and ensure + that it derives from java.lang.Exception. Additionally, we + might want to override the java.lang.Exception.getMessage() + method. The typemaps to use then are as follows:

    -%typemap(check) int * %{ 
    -  if (error) {
    -    SWIG_JavaThrowException(jenv, SWIG_JavaIndexOutOfBoundsException, "Array element error");
    -    return $null;
    +%typemap(javabase) FileException "java.lang.Exception";
    +%typemap(javacode) FileException %{
    +  public String getMessage() {
    +    return what();
       }
     %}
     
    -

    If the typemap gets put into a function with void as return, $null - will expand to nothing:

    +

    This generates:

    -SWIGEXPORT void JNICALL Java_jnifn(...) {
    -    if (error) {
    -      SWIG_JavaThrowException(jenv, SWIG_JavaIndexOutOfBoundsException, "Array element error");
    -      return ;
    -    }
    +public class FileException extends java.lang.Exception {
       ...
    +  public String getMessage() {
    +    return what();
    +  }
    +
    +  public FileException(String msg) { ... }
    +
    +  public String what() {
    +    return exampleJNI.FileException_what(swigCPtr, this);
    +  }
     }
     
    -

    otherwise $null expands to NULL

    +

    We could alternatively have used %rename to rename +what() into getMessage().

    +

    25.10.3 NaN Exception - + exception handling for a particular type

    +

    A Java exception can be thrown from any Java or JNI code. Therefore, + as most typemaps contain either Java or JNI code, just about any + typemap could throw an exception. The following example demonstrates + exception handling on a type by type basis by checking for 'Not a + number' (NaN) whenever a parameter of type float is wrapped.

    +

    Consider the following C++ code:

    -SWIGEXPORT jobject JNICALL Java_jnifn(...) {
    -    if (error) {
    -      SWIG_JavaThrowException(jenv, SWIG_JavaIndexOutOfBoundsException, "Array element error");
    -      return NULL;
    -    }
    -  ...
    -}
    +bool calculate(float first, float second);
     
    -

    $javainput, $jnicall and $owner -
    The $javainput special variable is used in "javain" typemaps and - $jnicall and $owner are used in "javaout" typemaps. $jnicall is - analogous to $action in %exception. It is replaced by the call to the - native method in the intermediary JNI class. $owner is replaced by - either true if %newobject has been used, otherwise false -. $javainput is analogous to the $input special variable. It is replaced - by the parameter name.

    -

    Here is an example:

    +

    To validate every float being passed to C++, we could + precede the code being wrapped by the following typemap which throws a + runtime exception whenever the float is 'Not a Number':

    -%typemap(javain) Class "Class.getCPtr($javainput)"
    -%typemap(javain) unsigned short "$javainput"
    -%typemap(javaout) Class * {
    -    return new Class($jnicall, $owner);
    +%module example
    +%typemap(javain) float "$module.CheckForNaN($javainput)"
    +%pragma(java) modulecode=%{
    +  /** Simply returns the input value unless it is not a number,
    +      whereupon an exception is thrown. */
    +  static protected float CheckForNaN(float num) {
    +    if (Float.isNaN(num))
    +      throw new RuntimeException("Not a number");
    +    return num;
       }
    -
    -%inline %{
    -    class Class {...};
    -    Class * bar(Class cls, unsigned short ush) { return new Class(); };
     %}
     
    -

    The generated proxy code is then:

    +

    Note that the CheckForNaN support method has been added to + the module class using the modulecode pragma. The following + shows the generated code of interest:

    -public static Class bar(Class cls, int ush) {
    -  return new Class(exampleJNI.bar(Class.getCPtr(cls), cls, ush), false);
    +public class example {
    +  ...
    +
    +  /** Simply returns the input value unless it is not a number,
    +      whereupon an exception is thrown. */
    +  static protected float CheckForNaN(float num) {
    +    if (Float.isNaN(num))
    +      throw new RuntimeException("Not a number");
    +    return num;
    +  }
    +
    +  public static boolean calculate(float first, float second) {
    +    return exampleJNI.calculate(example.CheckForNaN(first), example.CheckForNaN(second));
    +  }
     }
     
    -

    Here $javainput has been replaced by cls and ush. - $jnicall has been replaced by the native method call, -exampleJNI.bar(...) and $owner has been replaced by false. - If %newobject is used by adding the following at the beginning of our - example:

    +

    Note that the "javain" typemap is used for every occurrence of a +float being used as an input. Of course, we could have targeted the + typemap at a particular parameter by using float first, say, + instead of just float.

    +

    The exception checking could alternatively have been placed into the + 'pre' attribute that the "javain" typemap supports. The "javain" + typemap above could be replaced with the following:

    -%newobject bar(Class cls, unsigned short ush);
    +%typemap(javain, pre="    $module.CheckForNaN($javainput);") float "$javainput"
     
    -

    The generated code constructs the return type using true - indicating the proxy class Class is responsible for destroying - the C++ memory allocated for it in bar:

    +

    which would modify the calculate function to instead be + generated as:

    -public static Class bar(Class cls, int ush) {
    -  return new Class(exampleJNI.bar(Class.getCPtr(cls), cls, ush), true);
    +public class example {
    +  ...
    +  public static boolean calculate(float first, float second) {
    +    example.CheckForNaN(first);
    +    example.CheckForNaN(second);
    +    {
    +      return exampleJNI.calculate(first, second);
    +    }
    +  }
     }
     
    -

    $static -
    This special variable expands to either static or nothing - depending on whether the class is an inner Java class or not. It is - used in the "javaclassmodifiers" typemap so that global classes can be - wrapped as Java proxy classes and nested C++ classes/enums can be - wrapped with the Java equivalent, that is, static inner proxy classes.

    -

    $jniinput, $javacall and $packagepath -
    These special variables are used in the directors typemaps. See -Director specific typemaps for details.

    -

    $module -
    This special variable expands to the module name, as specified by -%module or the -module commandline option.

    -

    $imclassname -
    This special variable expands to the intermediary class name. - Usually this is the same as '$moduleJNI', unless the jniclassname - attribute is specified in the %module - directive.

    -

    24.9.8 Typemaps for both C - and C++ compilation

    -

    JNI calls must be written differently depending on whether the code - is being compiled as C or C++. For example C compilation requires the - pointer to a function pointer struct member syntax like

    +

    See the Date marshalling example + for an example using further "javain" typemap attributes.

    +

    If we decide that what we actually want is a checked exception + instead of a runtime exception, we can change this easily enough. The + proxy method that uses float as an input, must then add the + exception class to the throws clause. SWIG can handle this as it + supports the 'throws' typemap + attribute for specifying classes for the throws clause. Thus we can + modify the pragma and the typemap for the throws clause:

    -const jclass clazz = (*jenv)->FindClass(jenv, "java/lang/String");
    +%typemap(javain, throws="java.lang.Exception") float "$module.CheckForNaN($javainput)"
    +%pragma(java) modulecode=%{
    +  /** Simply returns the input value unless it is not a number,
    +      whereupon an exception is thrown. */
    +  static protected float CheckForNaN(float num) throws java.lang.Exception {
    +    if (Float.isNaN(num))
    +      throw new RuntimeException("Not a number");
    +    return num;
    +  }
    +%}
     
    -

    whereas C++ code compilation of the same function call is a member - function call using a class pointer like

    +

    The calculate method now has a throws clause and even + though the typemap is used twice for both float first and +float second, the throws clause contains a single instance of +java.lang.Exception:

    -const jclass clazz = jenv->FindClass("java/lang/String");
    +public class example {
    +  ...
    +
    +  /** Simply returns the input value unless it is not a number,
    +      whereupon an exception is thrown. */
    +  static protected float CheckForNaN(float num) throws java.lang.Exception {
    +    if (Float.isNaN(num))
    +      throw new RuntimeException("Not a number");
    +    return num;
    +  }
    +
    +  public static boolean calculate(float first, float second) throws java.lang.Exception {
    +    return exampleJNI.calculate(example.CheckForNaN(first), example.CheckForNaN(second));
    +  }
    +}
     
    -

    To enable typemaps to be used for either C or C++ compilation, a set - of JCALLx macros have been defined in Lib/java/javahead.swg, where x is - the number of arguments in the C++ version of the JNI call. The above - JNI calls would be written in a typemap like this

    +

    If we were a martyr to the JNI cause, we could replace the succinct + code within the "javain" typemap with a few pages of JNI code. If we + had, we would have put it in the "in" typemap which, like all JNI and + Java typemaps, also supports the 'throws' attribute.

    +

    25.10.4 Converting Java + String arrays to char **

    +

    A common problem in many C programs is the processing of command + line arguments, which are usually passed in an array of NULL terminated + strings. The following SWIG interface file allows a Java String array + to be used as a char ** object.

    -const jclass clazz = JCALL1(FindClass, jenv, "java/lang/String");
    +%module example
    +
    +/* This tells SWIG to treat char ** as a special case when used as a parameter
    +   in a function call */
    +%typemap(in) char ** (jint size) {
    +    int i = 0;
    +    size = (*jenv)->GetArrayLength(jenv, $input);
    +    $1 = (char **) malloc((size+1)*sizeof(char *));
    +    /* make a copy of each string */
    +    for (i = 0; i<size; i++) {
    +        jstring j_string = (jstring)(*jenv)->GetObjectArrayElement(jenv, $input, i);
    +        const char * c_string = (*jenv)->GetStringUTFChars(jenv, j_string, 0);
    +        $1[i] = malloc((strlen(c_string)+1)*sizeof(char));
    +        strcpy($1[i], c_string);
    +        (*jenv)->ReleaseStringUTFChars(jenv, j_string, c_string);
    +        (*jenv)->DeleteLocalRef(jenv, j_string);
    +    }
    +    $1[i] = 0;
    +}
    +
    +/* This cleans up the memory we malloc'd before the function call */
    +%typemap(freearg) char ** {
    +    int i;
    +    for (i=0; i<size$argnum-1; i++)
    +      free($1[i]);
    +    free($1);
    +}
    +
    +/* This allows a C function to return a char ** as a Java String array */
    +%typemap(out) char ** {
    +    int i;
    +    int len=0;
    +    jstring temp_string;
    +    const jclass clazz = (*jenv)->FindClass(jenv, "java/lang/String");
    +
    +    while ($1[len]) len++;    
    +    jresult = (*jenv)->NewObjectArray(jenv, len, clazz, NULL);
    +    /* exception checking omitted */
    +
    +    for (i=0; i<len; i++) {
    +      temp_string = (*jenv)->NewStringUTF(jenv, *result++);
    +      (*jenv)->SetObjectArrayElement(jenv, jresult, i, temp_string);
    +      (*jenv)->DeleteLocalRef(jenv, temp_string);
    +    }
    +}
    +
    +/* These 3 typemaps tell SWIG what JNI and Java types to use */
    +%typemap(jni) char ** "jobjectArray"
    +%typemap(jtype) char ** "String[]"
    +%typemap(jstype) char ** "String[]"
    +
    +/* These 2 typemaps handle the conversion of the jtype to jstype typemap type
    +   and vice versa */
    +%typemap(javain) char ** "$javainput"
    +%typemap(javaout) char ** {
    +    return $jnicall;
    +  }
    +
    +/* Now a few test functions */
    +%inline %{
    +
    +int print_args(char **argv) {
    +    int i = 0;
    +    while (argv[i]) {
    +         printf("argv[%d] = %s\n", i, argv[i]);
    +         i++;
    +    }
    +    return i;
    +}
    +
    +char **get_args() {
    +  static char *values[] = { "Dave", "Mike", "Susan", "John", "Michelle", 0};
    +  return &values[0];
    +}
    +
    +%}
     
    -

    Note that the SWIG preprocessor expands these into the appropriate C - or C++ JNI calling convention. The C calling convention is emitted by - default and the C++ calling convention is emitted when using the -c++ - SWIG commandline option. If you do not intend your code to be targeting - both C and C++ then your typemaps can use the appropriate JNI calling - convention and need not use the JCALLx macros.

    -

    24.9.9 Java code typemaps

    -

    Most of SWIG's typemaps are used for the generation of C/C++ code. - The typemaps in this section are used solely for the generation of Java - code. Elements of proxy classes and type wrapper classes come from the - following typemaps (the defaults).

    -

    %typemap(javabase)

    -
    base (extends) for Java class: empty default -
    Note that this typemap accepts a replace attribute as an - optional flag. When set to "1", it will replace/override any C++ base - classes that might have been parsed. If this flag is not specified and - there are C++ base classes, then a multiple inheritance warning is - issued and the code in the typemap is ignored. The typemap also accepts - a notderived attribute as an optional flag. When set to "1", - it will not apply to classes that are derived from a C++ base. When - used with the SWIGTYPE type, it is useful for giving a common base for - all proxy classes, that is, providing a base class that sits in between - all proxy classes and the Java base class Object for example: -%typemap(javabase, notderived="1") SWIGTYPE "CommonBase".
    -

    %typemap(javabody)

    -
    the essential support body for proxy classes (proxy - base classes only), typewrapper classes and enum classes. Default - contains extra constructors, memory ownership control member variables - (swigCMemOwn, swigCPtr), the getCPtr method - etc.
    -

    %typemap(javabody_derived)

    -
    the essential support body for proxy classes - (derived classes only). Same as "javabody" typemap, but only used for - proxy derived classes.
    -

    %typemap(javaclassmodifiers)

    -
    class modifiers for the Java class: default is - "public class"
    -

    %typemap(javacode)

    -
    Java code is copied verbatim to the Java class: - empty default
    -

    %typemap(javadestruct, methodname="delete", - methodmodifiers="public synchronized") -

    -
    destructor wrapper - the delete() method - (proxy classes only), used for all proxy classes except those which - have a base class : default calls C++ destructor (or frees C memory) - and resets swigCPtr and swigCMemOwn flags -
    -
    Note that the delete() method name is configurable and is - specified by the methodname attribute. The method modifiers - are also configurable via the methodmodifiers attribute.
    -

    %typemap(javadestruct_derived, methodname="delete", - methodmodifiers="public synchronized")

    -
    destructor wrapper - the delete() method - (proxy classes only), same as "javadestruct" but only used for derived - proxy classes : default calls C++ destructor (or frees C memory) and - resets swigCPtr and swigCMemOwn flags -
    -
    Note that the delete() method name is configurable and is - specified by the methodname attribute. The method modifiers - are also configurable via the methodmodifiers attribute.
    -

    %typemap(javaimports)

    -
    import statements for Java class: empty default
    -

    %typemap(javainterfaces)

    -
    interfaces (implements) for Java class: empty - default
    -

    %typemap(javafinalize)

    -
    the finalize() method (proxy classes - only): default calls the delete() method -

    Note that the default javafinalize typemap must contain the full - implementation of the finalize method. Any customization to this - typemap must still declare a java finalize method with the correct - signature. Note also that the name of the generated "delete" method may - be affected by javadestruct and javadestruct_derived - typemaps. Below shows an example modifying the finalizer, assuming the -delete method has been renamed to swig_delete.

    +

    Note that the 'C' JNI calling convention is used. Checking for any + thrown exceptions after JNI function calls has been omitted. When this + module is compiled, our wrapped C functions can be used by the + following Java program:

    -%typemap(javafinalize) SWIGTYPE %{
    -   protected void finalize() {
    -     swig_delete();  // renamed to prevent conflict with existing delete method
    -   }
    -]%
    +// File runme.java
    +
    +public class runme {
    +
    +  static {
    +    try {
    +      System.loadLibrary("example");
    +    } catch (UnsatisfiedLinkError e) {
    +      System.err.println("Native code library failed to load. " + e);
    +      System.exit(1);
    +    }
    +  }
    +
    +  public static void main(String argv[]) {
    +    String animals[] = {"Cat","Dog","Cow","Goat"};
    +    example.print_args(animals);
    +    String args[] = example.get_args();
    +    for (int i=0; i<args.length; i++)
    +        System.out.println(i + ":" + args[i]);
    +  }
    +}
     
    -
    -

    Compatibility Note: In SWIG-1.3.21 and earlier releases, - typemaps called "javagetcptr" and "javaptrconstructormodifiers" were - available. These are deprecated and the "javabody" typemap can be used - instead.

    -

    In summary the contents of the typemaps make up a proxy class like - this:

    +
    +

    When compiled and run we get:

    -[ javaimports typemap ]
    -[ javaclassmodifiers typemap ] javaclassname extends [ javabase typemap ]
    -                                             implements [ javainterfaces typemap ] {
    -[ javabody or javabody_derived typemap ]
    -[ javafinalize typemap ]
    -public synchronized void delete() [ javadestruct OR javadestruct_derived typemap ]
    -[ javacode typemap ]
    -... proxy functions ...
    +$ java runme
    +argv[0] = Cat
    +argv[1] = Dog
    +argv[2] = Cow
    +argv[3] = Goat
    +0:Dave
    +1:Mike
    +2:Susan
    +3:John
    +4:Michelle
    +
    +
    +

    In the example, a few different typemaps are used. The "in" typemap + is used to receive an input argument and convert it to a C array. Since + dynamic memory allocation is used to allocate memory for the array, the + "freearg" typemap is used to later release this memory after the + execution of the C function. The "out" typemap is used for function + return values. Lastly the "jni", "jtype" and "jstype" typemaps are also + required to specify what Java types to use.

    +

    25.10.5 Expanding a Java object + to multiple arguments

    +

    Suppose that you had a collection of C functions with arguments such + as the following:

    +
    +
    +int foo(int argc, char **argv);
    +
    +
    +

    In the previous example, a typemap was written to pass a Java String + array as the char **argv. This allows the function to be used + from Java as follows:

    +
    +
    +example.foo(4, new String[]{"red", "green", "blue", "white"});
    +
    +
    +

    Although this works, it's a little awkward to specify the argument + count. To fix this, a multi-argument typemap can be defined. This is + not very difficult--you only have to make slight modifications to the + previous example's typemaps:

    +
    +
    +%typemap(in) (int argc, char **argv) {
    +    int i = 0;
    +    $1 = (*jenv)->GetArrayLength(jenv, $input);
    +    $2 = (char **) malloc(($1+1)*sizeof(char *));
    +    /* make a copy of each string */
    +    for (i = 0; i<$1; i++) {
    +        jstring j_string = (jstring)(*jenv)->GetObjectArrayElement(jenv, $input, i);
    +        const char * c_string = (*jenv)->GetStringUTFChars(jenv, j_string, 0);
    +        $2[i] = malloc((strlen(c_string)+1)*sizeof(char));
    +        strcpy($2[i], c_string);
    +        (*jenv)->ReleaseStringUTFChars(jenv, j_string, c_string);
    +        (*jenv)->DeleteLocalRef(jenv, j_string);
    +    }
    +    $2[i] = 0;
    +}
    +
    +%typemap(freearg) (int argc, char **argv) {
    +    int i;
    +    for (i=0; i<$1-1; i++)
    +      free($2[i]);
    +    free($2);
     }
    +
    +%typemap(jni) (int argc, char **argv) "jobjectArray"
    +%typemap(jtype) (int argc, char **argv) "String[]"
    +%typemap(jstype) (int argc, char **argv) "String[]"
    +
    +%typemap(javain) (int argc, char **argv) "$javainput"
     
    -

    Note the delete() methodname and method modifiers - are configurable, see "javadestruct" and "javadestruct_derived" - typemaps above.

    -

    The type wrapper class is similar in construction:

    +

    When writing a multiple-argument typemap, each of the types is + referenced by a variable such as $1 or $2. The + typemap code simply fills in the appropriate values from the supplied + Java parameter.

    +

    With the above typemap in place, you will find it no longer + necessary to supply the argument count. This is automatically set by + the typemap code. For example:

    -[ javaimports typemap ]
    -[ javaclassmodifiers typemap ] javaclassname extends [ javabase typemap ]
    -                                             implements [ javainterfaces typemap ] {
    -[ javabody typemap ]
    -[ javacode typemap ]
    -}
    +example.foo(new String[]{"red", "green", "blue", "white"});
     
    -

    The enum class is also similar in construction:

    +

    25.10.6 Using + typemaps to return arguments

    +

    A common problem in some C programs is that values may be returned + in function parameters rather than in the return value of a function. + The typemaps.i file defines INPUT, OUTPUT and INOUT typemaps + which can be used to solve some instances of this problem. This library + file uses an array as a means of moving data to and from Java when + wrapping a C function that takes non const pointers or non const + references as parameters.

    +

    Now we are going to outline an alternative approach to using arrays + for C pointers. The INOUT typemap uses a double[] array for + receiving and returning the double* parameters. In this + approach we are able to use a Java class myDouble instead of +double[] arrays where the C pointer double* is required.

    +

    Here is our example function:

    -[ javaimports typemap ]
    -[ javaclassmodifiers typemap ] javaclassname extends [ javabase typemap ]
    -                                             implements [ javainterfaces typemap ] {
    -... Enum values ...
    -[ javabody typemap ]
    -[ javacode typemap ]
    -}
    +/* Returns a status value and two values in out1 and out2 */
    +int spam(double a, double b, double *out1, double *out2);
     
    -

    The "javaimports" typemap is ignored if the enum class is wrapped by - an inner Java class, that is when wrapping an enum declared within a - C++ class.

    -

    The defaults can be overridden to tailor these classes. Here is an - example which will change the getCPtr method and constructor - from the default public access to protected access. If the classes in - one package are not using the classes in another package, then these - methods need not be public and removing access to these low level - implementation details, is a good thing. If you are invoking SWIG more - than once and generating the wrapped classes into different packages in - each invocation, then you cannot do this as you will then have - different packages.

    +

    If we define a structure MyDouble containing a double + member variable and use some typemaps we can solve this problem. For + example we could put the following through SWIG:

    -%typemap(javabody) SWIGTYPE %{
    -  private long swigCPtr;
    -  protected boolean swigCMemOwn;
    +%module example
     
    -  protected $javaclassname(long cPtr, boolean cMemoryOwn) {
    -    swigCMemOwn = cMemoryOwn;
    -    swigCPtr = cPtr;
    -  }
    +/* Define a new structure to use instead of double * */
    +%inline %{
    +typedef struct {
    +    double value;
    +} MyDouble;
    +%}
     
    -  protected static long getCPtr($javaclassname obj) {
    -    return (obj == null) ? 0 : obj.swigCPtr;
    -  }
    +
    +%{
    +/* Returns a status value and two values in out1 and out2 */
    +int spam(double a, double b, double *out1, double *out2) {
    +  int status = 1;
    +  *out1 = a*10.0;
    +  *out2 = b*100.0;
    +  return status;
    +}
     %}
    +
    +/* 
    +This typemap will make any double * function parameters with name OUTVALUE take an
    +argument of MyDouble instead of double *. This will 
    +allow the calling function to read the double * value after returning from the function.
    +*/
    +%typemap(in) double *OUTVALUE {
    +    jclass clazz = jenv->FindClass("MyDouble");
    +    jfieldID fid = jenv->GetFieldID(clazz, "swigCPtr", "J");
    +    jlong cPtr = jenv->GetLongField($input, fid);
    +    MyDouble *pMyDouble = NULL;
    +    *(MyDouble **)&pMyDouble = *(MyDouble **)&cPtr;
    +    $1 = &pMyDouble->value;
    +}
    +
    +%typemap(jtype) double *OUTVALUE "MyDouble"
    +%typemap(jstype) double *OUTVALUE "MyDouble"
    +%typemap(jni) double *OUTVALUE "jobject"
    +
    +%typemap(javain) double *OUTVALUE "$javainput"
    +
    +/* Now we apply the typemap to the named variables */
    +%apply double *OUTVALUE { double *out1, double *out2 };
    +int spam(double a, double b, double *out1, double *out2);
     
    -

    The typemap code is the same that is in "java.swg", barring - the last two method modifiers. Note that SWIGTYPE will target - all proxy classes, but not the type wrapper classes. Also the above - typemap is only used for proxy classes that are potential base classes. - To target proxy classes that are derived from a wrapped class as well, - the "javabody_derived" typemap should also be overridden.

    -

    For the typemap to be used in all type wrapper classes, all the - different types that type wrapper classes could be used for should be - targeted:

    +

    Note that the C++ JNI calling convention has been used this time and + so must be compiled as C++ and the -c++ commandline must be passed to + SWIG. JNI error checking has been omitted for clarity.

    +

    What the typemaps do are make the named double* function + parameters use our new MyDouble wrapper structure. The "in" + typemap takes this structure, gets the C++ pointer to it, takes the +double value member variable and passes it to the C++ spam + function. In Java, when the function returns, we use the SWIG created +getValue() function to get the output value. The following Java + program demonstrates this:

    -%typemap(javabody) SWIGTYPE *, SWIGTYPE &, SWIGTYPE [], SWIGTYPE (CLASS::*) %{
    -  private long swigCPtr;
    +// File: runme.java
     
    -  protected $javaclassname(long cPtr, boolean bFutureUse) {
    -    swigCPtr = cPtr;
    -  }
    +public class runme {
     
    -  protected $javaclassname() {
    -    swigCPtr = 0;
    +  static {
    +    try {
    +      System.loadLibrary("example");
    +    } catch (UnsatisfiedLinkError e) {
    +      System.err.println("Native code library failed to load. " + e);
    +      System.exit(1);
    +    }
       }
     
    -  protected static long getCPtr($javaclassname obj) {
    -    return (obj == null) ? 0 : obj.swigCPtr;
    +  public static void main(String argv[]) {
    +    MyDouble out1 = new MyDouble();
    +    MyDouble out2 = new MyDouble();
    +    int ret = example.spam(1.2, 3.4, out1, out2);
    +    System.out.println(ret + "  " + out1.getValue() + "  " + out2.getValue());
       }
    -%}
    +}
     
    -

    Again this is the same that is in "java.swg", barring the - method modifier for getCPtr.

    -

    When using multiple modules or the -nspace feature it is common to invoke SWIG with a different --package command line option for each module. However, by default - the generated code may not compile if generated classes in one package - use generated classes in another package. The visibility of the -getCPtr() and pointer constructor generated from the javabody - typemaps needs changing. The default visibility is protected - but it needs to be public for access from a different package. - Just changing 'protected' to 'public' in the typemap achieves this. Two - macros are available in java.swg to make this easier and using - them is the preferred approach over simply copying the typemaps and - modifying as this is forward compatible with any changes in the -javabody typemap in future versions of SWIG. The macros are for the - proxy and typewrapper classes and can respectively be used to to make - the method and constructor public:

    +

    When compiled and run we get:

    -  SWIG_JAVABODY_PROXY(public, public, SWIGTYPE)
    -  SWIG_JAVABODY_TYPEWRAPPER(public, public, public, SWIGTYPE)
    +$ java runme
    +1 12.0  340.0
     
    -

    24.9.10 Director specific - typemaps

    -

    The Java directors feature requires the "javadirectorin", - "javadirectorout", "directorin" and the "directorout" typemaps in order - to work properly. The "javapackage" typemap is an optional typemap used - to identify the Java package path for individual SWIG generated proxy - classes used in director methods.

    -

    %typemap(directorin)

    -
    -

    The "directorin" typemap is used for converting arguments in the C++ - director class to the appropriate JNI type before the upcall to Java. - This typemap also specifies the JNI field descriptor for the type in - the "descriptor" attribute. For example, integers are converted as - follows:

    +

    25.10.7 Adding Java downcasts to + polymorphic return types

    +

    SWIG support for polymorphism works in that the appropriate virtual + function is called. However, the default generated code does not allow + for downcasting. Let's examine this with the following code:

    -%typemap(directorin,descriptor="I") int "$input = (jint) $1;"
    +%include "std_string.i"
    +
    +#include <iostream>
    +using namespace std;
    +class Vehicle {
    +public:
    +    virtual void start() = 0;
    +...
    +};
    +
    +class Ambulance : public Vehicle {
    +    string vol;
    +public:
    +    Ambulance(string volume) : vol(volume) {}
    +    virtual void start() {
    +        cout << "Ambulance started" << endl;
    +    }
    +    void sound_siren() {
    +        cout << vol << " siren sounded!" << endl;
    +    }
    +...
    +};
    +
    +Vehicle *vehicle_factory() {
    +    return new Ambulance("Very loud");
    +}
     
    -

    $input is the SWIG name of the JNI temporary variable - passed to Java in the upcall. The descriptor="I" will put - an I into the JNI field descriptor that identifies the - Java method that will be called from C++. For more about JNI field - descriptors and their importance, refer to the -JNI documentation mentioned earlier. A typemap for C character - strings is:

    +

    If we execute the following Java code:

    -%typemap(directorin,descriptor="Ljava/lang/String;") char *
    -  %{ $input = jenv->NewStringUTF($1); %}
    +Vehicle vehicle = example.vehicle_factory();
    +vehicle.start();
    +
    +Ambulance ambulance = (Ambulance)vehicle;
    +ambulance.sound_siren();
     
    -

    User-defined types have the default "descriptor" attribute " -L$packagepath/$javaclassname;" where $packagepath is - the package name passed from the SWIG command line and -$javaclassname is the Java proxy class' name. If the -package - commandline option is not used to specify the package, then - '$packagepath/' will be removed from the resulting output JNI field - descriptor. Do not forget the terminating ';' for JNI field - descriptors starting with 'L'. If the ';' is left out, Java will - generate a "method not found" runtime error.

    -
    -

    %typemap(directorout)

    -
    -

    The "directorout" typemap is used for converting the JNI return type - in the C++ director class to the appropriate C++ type after the upcall - to Java. For example, integers are converted as follows:

    +

    We get:

    -%typemap(directorout) int %{ $result = (int)$input; %}
    +Ambulance started
    +java.lang.ClassCastException
    +        at runme.main(runme.java:16)
     
    -

    $input is the SWIG name of the JNI temporary variable - returned from Java after the upcall. $result is the - resulting output. A typemap for C character strings is:

    +

    Even though we know from examination of the C++ code that +vehicle_factory returns an object of type Ambulance, we + are not able to use this knowledge to perform the downcast in Java. + This occurs because the runtime type information is not completely + passed from C++ to Java when returning the type from +vehicle_factory(). Usually this is not a problem as virtual + functions do work by default, such as in the case of start(). + There are a few solutions to getting downcasts to work.

    +

    The first is not to use a Java cast but a call to C++ to make the + cast. Add this to your code:

    -%typemap(directorout) char * {
    -  $1 = 0;
    -  if ($input) {
    -    $result = (char *)jenv->GetStringUTFChars($input, 0);
    -    if (!$1) return $null;
    -  }
    +%exception Ambulance::dynamic_cast(Vehicle *vehicle) {
    +    $action
    +    if (!result) {
    +        jclass excep = jenv->FindClass("java/lang/ClassCastException");
    +        if (excep) {
    +            jenv->ThrowNew(excep, "dynamic_cast exception");
    +        }
    +    }
     }
    +%extend Ambulance {
    +    static Ambulance *dynamic_cast(Vehicle *vehicle) {
    +        return dynamic_cast<Ambulance *>(vehicle);
    +    }
    +};
     
    -
    -

    %typemap(javadirectorin)

    -
    -

    Conversion from jtype to jstype for director methods. These are Java - code typemaps which transform the type used in the Java intermediary - JNI class (as specified in the "jtype" typemap) to the Java type used - in the Java module class, proxy classes and type wrapper classes (as - specified in the "jstype" typemap). This typemap provides the - conversion for the parameters in the director methods when calling up - from C++ to Java.

    -

    For primitive types, this typemap is usually specified as:

    +
    +

    It would then be used from Java like this

    -%typemap(javadirectorin) int "$jniinput"
    +Ambulance ambulance = Ambulance.dynamic_cast(vehicle);
    +ambulance.sound_siren();
     
    -

    The $jniinput special variable is analogous to -$javainput special variable. It is replaced by the input - parameter name.

    -
    -

    %typemap(javadirectorout)

    -
    -

    Conversion from jstype to jtype for director methods. These are Java - code typemaps which transform the type used in the Java module class, - proxy classes and type wrapper classes (as specified in the "jstype" - typemap) to the type used in the Java intermediary JNI class (as - specified in the "jtype" typemap). This typemap provides the conversion - for the return type in the director methods when returning from the C++ - to Java upcall.

    -

    For primitive types, this typemap is usually specified as:

    +

    Should vehicle not be of type ambulance then a + Java ClassCastException is thrown. The next solution is a + purer solution in that Java downcasts can be performed on the types. + Add the following before the definition of vehicle_factory:

    -%typemap(javadirectorout) int "$javacall"
    +%typemap(out) Vehicle * {
    +    Ambulance *downcast = dynamic_cast<Ambulance *>($1);
    +    *(Ambulance **)&$result = downcast;
    +}
    +
    +%typemap(javaout) Vehicle * {
    +    return new Ambulance($jnicall, $owner);
    +  }
     
    -

    The $javacall special variable is analogous to the -$jnicall special variable. It is replaced by the call to the - target Java method. The target method is the method in the Java proxy - class which overrides the virtual C++ method in the C++ base class.

    -
    -

    %typemap(javapackage)

    -
    -

    The "javapackage" typemap is optional; it serves to identify a - class's Java package. This typemap should be used in conjunction with - classes that are defined outside of the current SWIG interface file. - The typemap is only used if the type is used in a director method, that - is, in a virtual method in a director class. For example:

    +

    Here we are using our knowledge that vehicle_factory always + returns type Ambulance so that the Java proxy is created as a + type Ambulance. If vehicle_factory can manufacture + any type of Vehicle and we want to be able to downcast using + Java casts for any of these types, then a different approach is needed. + Consider expanding our example with a new Vehicle type and a more + flexible factory function:

    -// class Foo is handled in a different interface file:
    -%import "Foo.i"
    -
    -%feature("director") Example;
    -
    -%inline {
    -  class Bar { };
    -
    -  class Example {
    -  public:
    -    virtual ~Example();
    -    virtual void ping(Foo *arg1, Bar *arg2);
    -  };
    +class FireEngine : public Vehicle {
    +public:
    +    FireEngine() {}
    +    virtual void start() {
    +        cout << "FireEngine started" << endl;
    +    }
    +    void roll_out_hose() {
    +        cout << "Hose rolled out" << endl;
    +    }
    + ...
    +};
    +Vehicle *vehicle_factory(int vehicle_number) {
    +    if (vehicle_number == 0)
    +        return new Ambulance("Very loud");
    +    else
    +        return new FireEngine();
     }
     
    -

    Assume that the Foo class is part of the Java package - com.wombat.foo but the above interface file is part of the Java - package com.wombat.example. Without the "javapackage" typemap, - SWIG will assume that the Foo class belongs to com.wombat.example - class. The corrected interface file looks like:

    +

    To be able to downcast with this sort of Java code:

    -// class Foo is handled in a different interface file:
    -%import "Foo.i"
    -%typemap("javapackage") Foo, Foo *, Foo & "com.wombat.foo";
    -%feature("director") Example;
    -
    -%inline {
    -  class Bar { };
    -
    -  class Example {
    -  public:
    -    virtual ~Example();
    -    virtual void ping(Foo *arg1, Bar *arg2);
    -  };
    -}
    +FireEngine fireengine = (FireEngine)example.vehicle_factory(1);
    +fireengine.roll_out_hose();
    +Ambulance ambulance = (Ambulance)example.vehicle_factory(0);
    +ambulance.sound_siren();
     
    -

    SWIG looks up the package based on the actual type (plain - Foo, Foo pointer and Foo reference), so it is important to associate - all three types with the desired package. Practically speaking, you - should create a separate SWIG interface file, which is %import-ed into - each SWIG interface file, when you have multiple Java packages. Note - the helper macros below, OTHER_PACKAGE_SPEC and -ANOTHER_PACKAGE_SPEC, which reduce the amount of extra typing. " -TYPE..." is useful when passing templated types to the macro, - since multiargument template types appear to the SWIG preprocessor as - multiple macro arguments.

    +

    the following typemaps targeted at the vehicle_factory + function will achieve this. Note that in this case, the Java class is + constructed using JNI code rather than passing a pointer across the JNI + boundary in a Java long for construction in Java code.

    -%typemap("javapackage") SWIGTYPE, SWIGTYPE *, SWIGTYPE &
    -                                            "package.for.most.classes";
    -
    -%define OTHER_PACKAGE_SPEC(TYPE...)
    -%typemap("javapackage") TYPE, TYPE *, TYPE & "package.for.other.classes";
    -%enddef
    +%typemap(jni) Vehicle *vehicle_factory "jobject"
    +%typemap(jtype) Vehicle *vehicle_factory "Vehicle"
    +%typemap(jstype) Vehicle *vehicle_factory "Vehicle"
    +%typemap(javaout) Vehicle *vehicle_factory {
    +    return $jnicall;
    +  }
     
    -%define ANOTHER_PACKAGE_SPEC(TYPE...)
    -%typemap("javapackage") TYPE, TYPE *, TYPE & "package.for.another.set";
    -%enddef
    +%typemap(out) Vehicle *vehicle_factory {
    +    Ambulance *ambulance = dynamic_cast<Ambulance *>($1);
    +    FireEngine *fireengine = dynamic_cast<FireEngine *>($1);
    +    if (ambulance) {
    +        // call the Ambulance(long cPtr, boolean cMemoryOwn) constructor
    +        jclass clazz = jenv->FindClass("Ambulance");
    +        if (clazz) {
    +            jmethodID mid = jenv->GetMethodID(clazz, "<init>", "(JZ)V");
    +            if (mid) {
    +                jlong cptr = 0;
    +                *(Ambulance **)&cptr = ambulance; 
    +                $result = jenv->NewObject(clazz, mid, cptr, false);
    +            }
    +        }
    +    } else if (fireengine) {
    +        // call the FireEngine(long cPtr, boolean cMemoryOwn) constructor
    +        jclass clazz = jenv->FindClass("FireEngine");
    +        if (clazz) {
    +            jmethodID mid = jenv->GetMethodID(clazz, "<init>", "(JZ)V");
    +            if (mid) {
    +                jlong cptr = 0;
    +                *(FireEngine **)&cptr = fireengine; 
    +                $result = jenv->NewObject(clazz, mid, cptr, false);
    +            }
    +        }
    +    }
    +    else {
    +        cout << "Unexpected type " << endl;
    +    }
     
    -OTHER_PACKAGE_SPEC(Package_2_class_one)
    -ANOTHER_PACKAGE_SPEC(Package_3_class_two)
    -/* etc */
    +    if (!$result)
    +        cout << "Failed to create new java object" << endl;
    +}
     
    -

    The basic strategy here is to provide a default package typemap for - the majority of the classes, only providing "javapackage" typemaps for - the exceptions.

    -
    -

    24.10 Typemap Examples

    -

    This section includes a few examples of typemaps. For more examples, - you might look at the files "java.swg" and "typemaps.i -" in the SWIG library.

    -

    24.10.1 Simpler Java enums - for enums without initializers

    -

    The default Proper Java enums - approach to wrapping enums is somewhat verbose. This is to handle all - possible C/C++ enums, in particular enums with initializers. The - generated code can be simplified if the enum being wrapped does not - have any initializers.

    -

    The following shows how to remove the support methods that are - generated by default and instead use the methods in the Java enum base - class java.lang.Enum and java.lang.Class for - marshalling enums between C/C++ and Java. The type used for the - typemaps below is enum SWIGTYPE which is the default type used - for all enums. The "enums.swg" file should be examined in order to see - the original overridden versions of the typemaps.

    -
    -
    -%include "enums.swg"
    -
    -%typemap(javain) enum SWIGTYPE "$javainput.ordinal()"
    -%typemap(javaout) enum SWIGTYPE {
    -    return $javaclassname.class.getEnumConstants()[$jnicall];
    +

    Better error handling would need to be added into this code. There + are other solutions to this problem, but this last example demonstrates + some more involved JNI code. SWIG usually generates code which + constructs the proxy classes using Java code as it is easier to handle + error conditions and is faster. Note that the JNI code above uses a + number of string lookups to call a constructor, whereas this would not + occur using byte compiled Java code.

    +

    25.10.8 Adding an equals method + to the Java classes

    +

    When a pointer is returned from a JNI function, it is wrapped using + a new Java proxy class or type wrapper class. Even when the pointers + are the same, it will not be possible to know that the two Java classes + containing those pointers are actually the same object. It is common in + Java to use the equals() method to check whether two objects + are equivalent. The equals() method is usually accompanied by + a hashCode() method in order to fulfill the requirement that + the hash code is equal for equal objects. Pure Java code methods like + these can be easily added:

    +
    +
    +%typemap(javacode) SWIGTYPE %{
    +  public boolean equals(Object obj) {
    +    boolean equal = false;
    +    if (obj instanceof $javaclassname)
    +      equal = ((($javaclassname)obj).swigCPtr == this.swigCPtr);
    +    return equal;
    +  }
    +  public int hashCode() {
    +     return (int)getPointer();
       }
    -%typemap(javabody) enum SWIGTYPE ""
    -
    -%inline %{
    -  enum HairType { blonde, ginger, brunette };
    -  void setHair(HairType h);
    -  HairType getHair();
     %}
    +
    +class Foo { };
    +Foo* returnFoo(Foo *foo) { return foo; }
     
    -

    SWIG will generate the following Java enum, which is somewhat - simpler than the default:

    +

    The following would display false without the javacode + typemap above. With the typemap defining the equals method the + result is true.

    -public enum HairType {
    -  blonde,
    -  ginger,
    -  brunette;
    -}
    +Foo foo1 = new Foo();
    +Foo foo2 = example.returnFoo(foo1);
    +System.out.println("foo1? " + foo1.equals(foo2));
     
    -

    and the two Java proxy methods will be:

    +

    25.10.9 Void pointers and a common Java + base class

    +

    One might wonder why the common code that SWIG emits for the proxy + and type wrapper classes is not pushed into a base class. The reason is + that although swigCPtr could be put into a common base class + for all classes wrapping C structures, it would not work for C++ + classes involved in an inheritance chain. Each class derived from a + base needs a separate swigCPtr because C++ compilers sometimes + use a different pointer value when casting a derived class to a base. + Additionally as Java only supports single inheritance, it would not be + possible to derive wrapped classes from your own pure Java classes if + the base class has been 'used up' by SWIG. However, you may want to + move some of the common code into a base class. Here is an example + which uses a common base class for all proxy classes and type wrapper + classes:

    -public static void setHair(HairType h) {
    -  exampleJNI.setHair(h.ordinal());
    -}
    +%typemap(javabase) SWIGTYPE, SWIGTYPE *, SWIGTYPE &, SWIGTYPE [], 
    +                                                         SWIGTYPE (CLASS::*) "SWIG"
     
    -public static HairType getHair() {
    -  return HairType.class.getEnumConstants()[exampleJNI.getHair()];
    -}
    +%typemap(javacode) SWIGTYPE, SWIGTYPE *, SWIGTYPE &, SWIGTYPE [], 
    +                                                         SWIGTYPE (CLASS::*) %{
    +  protected long getPointer() {
    +    return swigCPtr;
    +  }
    +%}
     
    -

    For marshalling Java enums to C/C++ enums, the ordinal - method is used to convert the Java enum into an integer value for - passing to the JNI layer, see the "javain" typemap. For marshalling - C/C++ enums to Java enums, the C/C++ enum value is cast to an integer - in the C/C++ typemaps (not shown). This integer value is then used to - index into the array of enum constants that the Java language provides. - See the getEnumConstants method in the "javaout" typemap.

    -

    These typemaps can often be used as the default for wrapping enums - as in many cases there won't be any enum initializers. In fact a good - strategy is to always use these typemaps and to specifically handle - enums with initializers using %apply. This would be done by using the - original versions of these typemaps in "enums.swg" under another - typemap name for applying using %apply.

    -

    24.10.2 Handling C++ exception - specifications as Java exceptions

    -

    This example demonstrates various ways in which C++ exceptions can - be tailored and converted into Java exceptions. Let's consider a simple - file class SimpleFile and an exception class FileException - which it may throw on error:

    +

    Define new base class called SWIG:

    -%include "std_string.i" // for std::string typemaps
    -#include <string>
    +public abstract class SWIG {
    +  protected abstract long getPointer();
     
    -class FileException {
    -  std::string message;
    -public:
    -  FileException(const std::string& msg) : message(msg) {}
    -  std::string what() {
    -    return message;
    +  public boolean equals(Object obj) {
    +    boolean equal = false;
    +    if (obj instanceof SWIG)
    +      equal = (((SWIG)obj).getPointer() == this.getPointer());
    +    return equal;
       }
    -};
    -
    -class SimpleFile {
    -  std::string filename;
    -public:
    -  SimpleFile(const std::string& filename) : filename(filename) {}
    -  void open() throw(FileException) {
    -  ...
    +  
    +  SWIGTYPE_p_void getVoidPointer() {
    +    return new SWIGTYPE_p_void(getPointer(), false);
       }
    -};
    +}
     
    -

    As the open method has a C++ exception specification, SWIG - will parse this and know that the method can throw an exception. The -"throws" typemap is then used when SWIG encounters an exception - specification. The default generic "throws" typemap looks like this:

    +

    This example contains some useful functionality which you may want + in your code.

    +
      +
    • It has an equals() method. Unlike the previous example, + the method code isn't replicated in all classes.
    • +
    • It also has a function which effectively implements a cast from the + type of the proxy/type wrapper class to a void pointer. This is + necessary for passing a proxy class or a type wrapper class to a + function that takes a void pointer.
    • +
    +

    25.10.10 Struct pointer to + pointer

    +

    Pointers to pointers are often used as output parameters in C + factory type functions. These are a bit more tricky to handle. Consider + the following situation where a Butler can be hired and fired:

    -%typemap(throws) SWIGTYPE, SWIGTYPE &, SWIGTYPE *, SWIGTYPE [ANY] %{
    -  SWIG_JavaThrowException(jenv, SWIG_JavaRuntimeException,
    -                          "C++ $1_type exception thrown");
    -  return $null;
    -%}
    +typedef struct {
    +  int hoursAvailable;
    +  char *greeting;
    +} Butler;
    +
    +// Note: HireButler will allocate the memory 
    +// The caller must free the memory by calling FireButler()!!
    +extern int HireButler(Butler **ppButler);
    +extern void FireButler(Butler *pButler);
     
    -

    Basically SWIG will generate a C++ try catch block and the body of - the "throws" typemap constitutes the catch block. The above typemap - calls a SWIG supplied method which throws a -java.lang.RuntimeException. This exception class is a runtime - exception and therefore not a checked exception. If, however, we wanted - to throw a checked exception, say java.io.IOException, then we - could use the following typemap:

    +

    C code implementation:

    -%typemap(throws, throws="java.io.IOException") FileException {
    -  jclass excep = jenv->FindClass("java/io/IOException");
    -  if (excep)
    -    jenv->ThrowNew(excep, $1.what().c_str());
    -  return $null;
    +int HireButler(Butler **ppButler) {
    +  Butler *pButler = (Butler *)malloc(sizeof(Butler));
    +  pButler->hoursAvailable = 24;
    +  pButler->greeting = (char *)malloc(32);
    +  strcpy(pButler->greeting, "At your service Sir");
    +  *ppButler = pButler;
    +  return 1;
    +}
    +void FireButler(Butler *pButler) {
    +  free(pButler->greeting);
    +  free(pButler);
     }
     
    -

    Note that this typemap uses the 'throws' -typemap attribute to ensure a throws clause is generated. The - generated proxy method then specifies the checked exception by - containing java.io.IOException in the throws clause:

    +

    Let's take two approaches to wrapping this code. The first is to + provide a functional interface, much like the original C interface. The + following Java code shows how we intend the code to be used:

    -public class SimpleFile {
    -  ...
    -  public void open() throws java.io.IOException { ... }
    -}
    +    Butler jeeves = new Butler();
    +    example.HireButler(jeeves);
    +    System.out.println("Greeting:     " + jeeves.getGreeting());
    +    System.out.println("Availability: " + jeeves.getHoursAvailable() + " hours per day");
    +    example.FireButler(jeeves);
     
    -

    Lastly, if you don't want to map your C++ exception into one of the - standard Java exceptions, the C++ class can be wrapped and turned into - a custom Java exception class. If we go back to our example, the first - thing we must do is get SWIG to wrap FileException and ensure - that it derives from java.lang.Exception. Additionally, we - might want to override the java.lang.Exception.getMessage() - method. The typemaps to use then are as follows:

    -
    +

    Resulting in the following output when run:

    +
    -%typemap(javabase) FileException "java.lang.Exception";
    -%typemap(javacode) FileException %{
    -  public String getMessage() {
    -    return what();
    -  }
    -%}
    +Greeting:     At your service Sir
    +Availability: 24 hours per day
     
    -

    This generates:

    +

    Note the usage is very much like it would be used if we were writing + C code, that is, explicit memory management is needed. No C memory is + allocated in the construction of the Butler proxy class and + the proxy class will not destroy the underlying C memory when it is + collected. A number of typemaps and features are needed to implement + this approach. The following interface file code should be placed + before SWIG parses the above C code.

    -public class FileException extends java.lang.Exception {
    -  ...
    -  public String getMessage() {
    -    return what();
    -  }
    +%module example
     
    -  public FileException(String msg) { ... }
    +// Do not generate the default proxy constructor or destructor
    +%nodefaultctor Butler;
    +%nodefaultdtor Butler;
     
    -  public String what() {
    -    return exampleJNI.FileException_what(swigCPtr, this);
    +// Add in pure Java code proxy constructor
    +%typemap(javacode) Butler %{
    +  /** This constructor creates the proxy which initially does not create nor own any C memory */
    +  public Butler() {
    +    this(0, false);
       }
    +%}
    +
    +// Type typemaps for marshalling Butler **
    +%typemap(jni) Butler ** "jobject"
    +%typemap(jtype) Butler ** "Butler"
    +%typemap(jstype) Butler ** "Butler"
    +
    +// Typemaps for Butler ** as a parameter output type
    +%typemap(in) Butler ** (Butler *ppButler = 0) %{
    +  $1 = &ppButler;
    +%}
    +%typemap(argout) Butler ** {
    +  // Give Java proxy the C pointer (of newly created object)
    +  jclass clazz = (*jenv)->FindClass(jenv, "Butler");
    +  jfieldID fid = (*jenv)->GetFieldID(jenv, clazz, "swigCPtr", "J");
    +  jlong cPtr = 0;
    +  *(Butler **)&cPtr = *$1;
    +  (*jenv)->SetLongField(jenv, $input, fid, cPtr);
     }
    +%typemap(javain) Butler ** "$javainput"
     
    -

    We could alternatively have used %rename to rename -what() into getMessage().

    -

    24.10.3 NaN Exception - - exception handling for a particular type

    -

    A Java exception can be thrown from any Java or JNI code. Therefore, - as most typemaps contain either Java or JNI code, just about any - typemap could throw an exception. The following example demonstrates - exception handling on a type by type basis by checking for 'Not a - number' (NaN) whenever a parameter of type float is wrapped.

    -

    Consider the following C++ code:

    -
    -
    -bool calculate(float first, float second);
    -
    -
    -

    To validate every float being passed to C++, we could - precede the code being wrapped by the following typemap which throws a - runtime exception whenever the float is 'Not a Number':

    +

    Note that the JNI code sets the proxy's swigCPtr member + variable to point to the newly created object. The swigCMemOwn + remains unchanged (at false), so that the proxy does not own the + memory.

    +

    Note: The old %nodefault directive disabled the default constructor + and destructor at the same time. This is unsafe in most of the cases, + and you can use the explicit %nodefaultctor and %nodefaultdtor + directives to achieve the same result if needed.

    +

    The second approach offers a more object oriented interface to the + Java user. We do this by making the Java proxy class's constructor call + the HireButler() method to create the underlying C object. + Additionally we get the proxy to take ownership of the memory so that + the finalizer will call the FireButler() function. The proxy + class will thus take ownership of the memory and clean it up when no + longer needed. We will also prevent the user from being able to + explicitly call the HireButler() and FireButler() + functions. Usage from Java will simply be:

    -%module example
    -%typemap(javain) float "$module.CheckForNaN($javainput)"
    -%pragma(java) modulecode=%{
    -  /** Simply returns the input value unless it is not a number,
    -      whereupon an exception is thrown. */
    -  static protected float CheckForNaN(float num) {
    -    if (Float.isNaN(num))
    -      throw new RuntimeException("Not a number");
    -    return num;
    -  }
    -%}
    +Butler jeeves = new Butler();
    +System.out.println("Greeting:     " + jeeves.getGreeting());
    +System.out.println("Availability: " + jeeves.getHoursAvailable() + " hours per day");
     
    -

    Note that the CheckForNaN support method has been added to - the module class using the modulecode pragma. The following - shows the generated code of interest:

    +

    Note that the Butler class is used just like any other Java class + and no extra coding by the user needs to be written to clear up the + underlying C memory as the finalizer will be called by the garbage + collector which in turn will call the FireButler() function. + To implement this, we use the above interface file code but remove the +javacode typemap and add the following:

    -public class example {
    -  ...
    -
    -  /** Simply returns the input value unless it is not a number,
    -      whereupon an exception is thrown. */
    -  static protected float CheckForNaN(float num) {
    -    if (Float.isNaN(num))
    -      throw new RuntimeException("Not a number");
    -    return num;
    -  }
    +// Don't expose the memory allocation/de-allocation functions
    +%ignore FireButler(Butler *pButler);
    +%ignore HireButler(Butler **ppButler);
     
    -  public static boolean calculate(float first, float second) {
    -    return exampleJNI.calculate(example.CheckForNaN(first), example.CheckForNaN(second));
    +// Add in a custom proxy constructor and destructor
    +%extend Butler {
    +  Butler() {
    +    Butler *pButler = 0;
    +    HireButler(&pButler);
    +    return pButler;
       }
    +  ~Butler() {
    +     FireButler($self);
    +   }
     }
     
    -

    Note that the "javain" typemap is used for every occurrence of a -float being used as an input. Of course, we could have targeted the - typemap at a particular parameter by using float first, say, - instead of just float.

    -

    The exception checking could alternatively have been placed into the - 'pre' attribute that the "javain" typemap supports. The "javain" - typemap above could be replaced with the following:

    -
    -
    -%typemap(javain, pre="    $module.CheckForNaN($javainput);") float "$javainput"
    -
    -
    -

    which would modify the calculate function to instead be - generated as:

    +

    Note that the code in %extend is using a C++ type + constructor and destructor, yet the generated code will still compile + as C code, see Adding member + functions to C structures. The C functional interface has been + completely morphed into an object-oriented interface and the Butler + class would behave much like any pure Java class and feel more natural + to Java users.

    +

    25.10.11 Memory + management when returning references to member variables

    +

    This example shows how to prevent premature garbage collection of + objects when the underlying C++ class returns a pointer or reference to + a member variable.

    +

    Consider the following C++ code:

    -public class example {
    -  ...
    -  public static boolean calculate(float first, float second) {
    -    example.CheckForNaN(first);
    -    example.CheckForNaN(second);
    -    {
    -      return exampleJNI.calculate(first, second);
    -    }
    -  }
    -}
    +struct Wheel {
    +  int size;
    +  Wheel(int sz) : size(sz) {}
    +};
    +
    +class Bike {
    +  Wheel wheel;
    +public:
    +  Bike(int val) : wheel(val) {}
    +  Wheel& getWheel() { return wheel; }
    +};
     
    -

    See the Date marshalling example - for an example using further "javain" typemap attributes.

    -

    If we decide that what we actually want is a checked exception - instead of a runtime exception, we can change this easily enough. The - proxy method that uses float as an input, must then add the - exception class to the throws clause. SWIG can handle this as it - supports the 'throws' typemap - attribute for specifying classes for the throws clause. Thus we can - modify the pragma and the typemap for the throws clause:

    +

    and the following usage from Java after running the code through + SWIG:

    -%typemap(javain, throws="java.lang.Exception") float "$module.CheckForNaN($javainput)"
    -%pragma(java) modulecode=%{
    -  /** Simply returns the input value unless it is not a number,
    -      whereupon an exception is thrown. */
    -  static protected float CheckForNaN(float num) throws java.lang.Exception {
    -    if (Float.isNaN(num))
    -      throw new RuntimeException("Not a number");
    -    return num;
    -  }
    -%}
    +    Wheel wheel = new Bike(10).getWheel();
    +    System.out.println("wheel size: " + wheel.getSize());
    +    // Simulate a garbage collection
    +    System.gc();
    +    System.runFinalization();
    +    System.out.println("wheel size: " + wheel.getSize());
     
    -

    The calculate method now has a throws clause and even - though the typemap is used twice for both float first and -float second, the throws clause contains a single instance of -java.lang.Exception:

    -
    +

    Don't be surprised that if the resulting output gives strange + results such as...

    +
    -public class example {
    -  ...
    -
    -  /** Simply returns the input value unless it is not a number,
    -      whereupon an exception is thrown. */
    -  static protected float CheckForNaN(float num) throws java.lang.Exception {
    -    if (Float.isNaN(num))
    -      throw new RuntimeException("Not a number");
    -    return num;
    -  }
    -
    -  public static boolean calculate(float first, float second) throws java.lang.Exception {
    -    return exampleJNI.calculate(example.CheckForNaN(first), example.CheckForNaN(second));
    -  }
    -}
    +wheel size: 10
    +wheel size: 135019664
     
    -

    If we were a martyr to the JNI cause, we could replace the succinct - code within the "javain" typemap with a few pages of JNI code. If we - had, we would have put it in the "in" typemap which, like all JNI and - Java typemaps, also supports the 'throws' attribute.

    -

    24.10.4 Converting - Java String arrays to char **

    -

    A common problem in many C programs is the processing of command - line arguments, which are usually passed in an array of NULL terminated - strings. The following SWIG interface file allows a Java String array - to be used as a char ** object.

    +

    What has happened here is the garbage collector has collected the +Bike instance as it doesn't think it is needed any more. The proxy + instance, wheel, contains a reference to memory that was + deleted when the Bike instance was collected. In order to + prevent the garbage collector from collecting the Bike + instance a reference to the Bike must be added to the +wheel instance. You can do this by adding the reference when the +getWheel() method is called using the following typemaps.

    -%module example
    -
    -/* This tells SWIG to treat char ** as a special case when used as a parameter
    -   in a function call */
    -%typemap(in) char ** (jint size) {
    -    int i = 0;
    -    size = (*jenv)->GetArrayLength(jenv, $input);
    -    $1 = (char **) malloc((size+1)*sizeof(char *));
    -    /* make a copy of each string */
    -    for (i = 0; i<size; i++) {
    -        jstring j_string = (jstring)(*jenv)->GetObjectArrayElement(jenv, $input, i);
    -        const char * c_string = (*jenv)->GetStringUTFChars(jenv, j_string, 0);
    -        $1[i] = malloc((strlen(c_string)+1)*sizeof(char));
    -        strcpy($1[i], c_string);
    -        (*jenv)->ReleaseStringUTFChars(jenv, j_string, c_string);
    -        (*jenv)->DeleteLocalRef(jenv, j_string);
    -    }
    -    $1[i] = 0;
    -}
    -
    -/* This cleans up the memory we malloc'd before the function call */
    -%typemap(freearg) char ** {
    -    int i;
    -    for (i=0; i<size$argnum-1; i++)
    -      free($1[i]);
    -    free($1);
    -}
    -
    -/* This allows a C function to return a char ** as a Java String array */
    -%typemap(out) char ** {
    -    int i;
    -    int len=0;
    -    jstring temp_string;
    -    const jclass clazz = (*jenv)->FindClass(jenv, "java/lang/String");
    -
    -    while ($1[len]) len++;    
    -    jresult = (*jenv)->NewObjectArray(jenv, len, clazz, NULL);
    -    /* exception checking omitted */
    -
    -    for (i=0; i<len; i++) {
    -      temp_string = (*jenv)->NewStringUTF(jenv, *result++);
    -      (*jenv)->SetObjectArrayElement(jenv, jresult, i, temp_string);
    -      (*jenv)->DeleteLocalRef(jenv, temp_string);
    -    }
    -}
    -
    -/* These 3 typemaps tell SWIG what JNI and Java types to use */
    -%typemap(jni) char ** "jobjectArray"
    -%typemap(jtype) char ** "String[]"
    -%typemap(jstype) char ** "String[]"
    -
    -/* These 2 typemaps handle the conversion of the jtype to jstype typemap type
    -   and vice versa */
    -%typemap(javain) char ** "$javainput"
    -%typemap(javaout) char ** {
    -    return $jnicall;
    -  }
    -
    -/* Now a few test functions */
    -%inline %{
    -
    -int print_args(char **argv) {
    -    int i = 0;
    -    while (argv[i]) {
    -         printf("argv[%d] = %s\n", i, argv[i]);
    -         i++;
    -    }
    -    return i;
    -}
    -
    -char **get_args() {
    -  static char *values[] = { "Dave", "Mike", "Susan", "John", "Michelle", 0};
    -  return &values[0];
    -}
    -
    +%typemap(javacode) Wheel %{
    +  // Ensure that the GC doesn't collect any Bike instance set from Java
    +  private Bike bikeReference;
    +  protected void addReference(Bike bike) {
    +    bikeReference = bike;
    +  }
     %}
    +
    +// Add a Java reference to prevent premature garbage collection and resulting use
    +// of dangling C++ pointer. Intended for methods that return pointers or
    +// references to a member variable.
    +%typemap(javaout) Wheel& getWheel {
    +    long cPtr = $jnicall;
    +    $javaclassname ret = null;
    +    if (cPtr != 0) {
    +      ret = new $javaclassname(cPtr, $owner);
    +      ret.addReference(this);
    +    }
    +    return ret;
    +  }
     
    -

    Note that the 'C' JNI calling convention is used. Checking for any - thrown exceptions after JNI function calls has been omitted. When this - module is compiled, our wrapped C functions can be used by the - following Java program:

    +

    The code in the first typemap gets added to the Wheel proxy + class. The code in the second typemap constitutes the bulk of the code + in the generated getWheel() function:

    -// File runme.java
    -
    -public class runme {
    -
    -  static {
    -    try {
    -      System.loadLibrary("example");
    -    } catch (UnsatisfiedLinkError e) {
    -      System.err.println("Native code library failed to load. " + e);
    -      System.exit(1);
    -    }
    +public class Wheel {
    +  ...
    +  // Ensure that the GC doesn't collect any bike set from Java 
    +  private Bike bikeReference;
    +  protected void addReference(Bike bike) {
    +    bikeReference = bike;
       }
    +}
     
    -  public static void main(String argv[]) {
    -    String animals[] = {"Cat","Dog","Cow","Goat"};
    -    example.print_args(animals);
    -    String args[] = example.get_args();
    -    for (int i=0; i<args.length; i++)
    -        System.out.println(i + ":" + args[i]);
    +public class Bike {
    +  ...
    +  public Wheel getWheel() {
    +    long cPtr = exampleJNI.Bike_getWheel(swigCPtr, this);
    +    Wheel ret = null;
    +    if (cPtr != 0) {
    +      ret = new Wheel(cPtr, false);
    +      ret.addReference(this);
    +    }
    +    return ret;
       }
     }
     
    -

    When compiled and run we get:

    +

    Note the addReference call.

    +

    25.10.12 Memory management + for objects passed to the C++ layer

    +

    Managing memory can be tricky when using C++ and Java proxy classes. + The previous example shows one such case and this example looks at + memory management for a class passed to a C++ method which expects the + object to remain in scope after the function has returned. Consider the + following two C++ classes:

    -$ java runme
    -argv[0] = Cat
    -argv[1] = Dog
    -argv[2] = Cow
    -argv[3] = Goat
    -0:Dave
    -1:Mike
    -2:Susan
    -3:John
    -4:Michelle
    +struct Element {
    +  int value;
    +  Element(int val) : value(val) {}
    +};
    +class Container {
    +  Element* element;
    +public:
    +  Container() : element(0) {}
    +  void setElement(Element* e) { element = e; }
    +  Element* getElement() { return element; }
    +};
     
    -

    In the example, a few different typemaps are used. The "in" typemap - is used to receive an input argument and convert it to a C array. Since - dynamic memory allocation is used to allocate memory for the array, the - "freearg" typemap is used to later release this memory after the - execution of the C function. The "out" typemap is used for function - return values. Lastly the "jni", "jtype" and "jstype" typemaps are also - required to specify what Java types to use.

    -

    24.10.5 Expanding a Java - object to multiple arguments

    -

    Suppose that you had a collection of C functions with arguments such - as the following:

    +

    and usage from C++

    -int foo(int argc, char **argv);
    +    Container container;
    +    Element element(20);
    +    container.setElement(&element);
    +    cout << "element.value: " << container.getElement()->value << endl;
     
    -

    In the previous example, a typemap was written to pass a Java String - array as the char **argv. This allows the function to be used - from Java as follows:

    +

    and more or less equivalent usage from Java

    -example.foo(4, new String[]{"red", "green", "blue", "white"});
    +    Container container = new Container();
    +    container.setElement(new Element(20));
    +    System.out.println("element value: " + container.getElement().getValue());
     
    -

    Although this works, it's a little awkward to specify the argument - count. To fix this, a multi-argument typemap can be defined. This is - not very difficult--you only have to make slight modifications to the - previous example's typemaps:

    +

    The C++ code will always print out 20, but the value printed out may + not be this in the Java equivalent code. In order to understand why, + consider a garbage collection occuring...

    -%typemap(in) (int argc, char **argv) {
    -    int i = 0;
    -    $1 = (*jenv)->GetArrayLength(jenv, $input);
    -    $2 = (char **) malloc(($1+1)*sizeof(char *));
    -    /* make a copy of each string */
    -    for (i = 0; i<$1; i++) {
    -        jstring j_string = (jstring)(*jenv)->GetObjectArrayElement(jenv, $input, i);
    -        const char * c_string = (*jenv)->GetStringUTFChars(jenv, j_string, 0);
    -        $2[i] = malloc((strlen(c_string)+1)*sizeof(char));
    -        strcpy($2[i], c_string);
    -        (*jenv)->ReleaseStringUTFChars(jenv, j_string, c_string);
    -        (*jenv)->DeleteLocalRef(jenv, j_string);
    -    }
    -    $2[i] = 0;
    -}
    -
    -%typemap(freearg) (int argc, char **argv) {
    -    int i;
    -    for (i=0; i<$1-1; i++)
    -      free($2[i]);
    -    free($2);
    -}
    -
    -%typemap(jni) (int argc, char **argv) "jobjectArray"
    -%typemap(jtype) (int argc, char **argv) "String[]"
    -%typemap(jstype) (int argc, char **argv) "String[]"
    -
    -%typemap(javain) (int argc, char **argv) "$javainput"
    +    Container container = new Container();
    +    container.setElement(new Element(20));
    +    // Simulate a garbage collection
    +    System.gc();
    +    System.runFinalization();
    +    System.out.println("element value: " + container.getElement().getValue());
     
    -

    When writing a multiple-argument typemap, each of the types is - referenced by a variable such as $1 or $2. The - typemap code simply fills in the appropriate values from the supplied - Java parameter.

    -

    With the above typemap in place, you will find it no longer - necessary to supply the argument count. This is automatically set by - the typemap code. For example:

    +

    The temporary element created with new Element(20) could + get garbage collected which ultimately means the container + variable is holding a dangling pointer, thereby printing out any old + random value instead of the expected value of 20. One solution is to + add in the appropriate references in the Java layer...

    -example.foo(new String[]{"red", "green", "blue", "white"});
    +public class Container {
    +
    +  ...
    +
    +  // Ensure that the GC doesn't collect any Element set from Java
    +  // as the underlying C++ class stores a shallow copy
    +  private Element elementReference;
    +  private long getCPtrAndAddReference(Element element) {
    +    elementReference = element;
    +    return Element.getCPtr(element);
    +  }
    +
    +  public void setElement(Element e) {
    +    exampleJNI.Container_setElement(swigCPtr, this, getCPtrAndAddReference(e), e);
    +  }
    +}
     
    -

    24.10.6 Using - typemaps to return arguments

    -

    A common problem in some C programs is that values may be returned - in function parameters rather than in the return value of a function. - The typemaps.i file defines INPUT, OUTPUT and INOUT typemaps - which can be used to solve some instances of this problem. This library - file uses an array as a means of moving data to and from Java when - wrapping a C function that takes non const pointers or non const - references as parameters.

    -

    Now we are going to outline an alternative approach to using arrays - for C pointers. The INOUT typemap uses a double[] array for - receiving and returning the double* parameters. In this - approach we are able to use a Java class myDouble instead of -double[] arrays where the C pointer double* is required.

    -

    Here is our example function:

    +

    The following typemaps will generate the desired code. The 'javain' + typemap matches the input parameter type for the setElement + method. The 'javacode' typemap simply adds in the specified code into + the Java proxy class.

    -/* Returns a status value and two values in out1 and out2 */
    -int spam(double a, double b, double *out1, double *out2);
    +%typemap(javain) Element *e "getCPtrAndAddReference($javainput)"
    +
    +%typemap(javacode) Container %{
    +  // Ensure that the GC doesn't collect any element set from Java
    +  // as the underlying C++ class stores a shallow copy
    +  private Element elementReference;
    +  private long getCPtrAndAddReference(Element element) {
    +    elementReference = element;
    +    return Element.getCPtr(element);
    +  }
    +%}
     
    -

    If we define a structure MyDouble containing a double - member variable and use some typemaps we can solve this problem. For - example we could put the following through SWIG:

    +

    25.10.13 Date marshalling using the + javain typemap and associated attributes

    +

    The NaN Exception example + is a simple example of the "javain" typemap and its 'pre' attribute. + This example demonstrates how a C++ date class, say CDate, can + be mapped onto the standard Java date class, +java.util.GregorianCalendar by using the 'pre', 'post' and + 'pgcppname' attributes of the "javain" typemap. The idea is that the +GregorianCalendar is used wherever the C++ API uses a CDate +. Let's assume the code being wrapped is as follows:

    -%module example
    -
    -/* Define a new structure to use instead of double * */
    -%inline %{
    -typedef struct {
    -    double value;
    -} MyDouble;
    -%}
    -
    -
    -%{
    -/* Returns a status value and two values in out1 and out2 */
    -int spam(double a, double b, double *out1, double *out2) {
    -  int status = 1;
    -  *out1 = a*10.0;
    -  *out2 = b*100.0;
    -  return status;
    +class CDate {
    +public:
    +  CDate(int year, int month, int day);
    +  int getYear();
    +  int getMonth();
    +  int getDay();
    +  ...
    +};
    +struct Action {
    +  static int doSomething(const CDate &dateIn, CDate &dateOut);
    +  Action(const CDate &date, CDate &dateOut);
     };
    -%}
    -
    -/* 
    -This typemap will make any double * function parameters with name OUTVALUE take an
    -argument of MyDouble instead of double *. This will 
    -allow the calling function to read the double * value after returning from the function.
    -*/
    -%typemap(in) double *OUTVALUE {
    -    jclass clazz = jenv->FindClass("MyDouble");
    -    jfieldID fid = jenv->GetFieldID(clazz, "swigCPtr", "J");
    -    jlong cPtr = jenv->GetLongField($input, fid);
    -    MyDouble *pMyDouble = NULL;
    -    *(MyDouble **)&pMyDouble = *(MyDouble **)&cPtr;
    -    $1 = &pMyDouble->value;
    -}
    -
    -%typemap(jtype) double *OUTVALUE "MyDouble"
    -%typemap(jstype) double *OUTVALUE "MyDouble"
    -%typemap(jni) double *OUTVALUE "jobject"
    -
    -%typemap(javain) double *OUTVALUE "$javainput"
    -
    -/* Now we apply the typemap to the named variables */
    -%apply double *OUTVALUE { double *out1, double *out2 };
    -int spam(double a, double b, double *out1, double *out2);
     
    -

    Note that the C++ JNI calling convention has been used this time and - so must be compiled as C++ and the -c++ commandline must be passed to - SWIG. JNI error checking has been omitted for clarity.

    -

    What the typemaps do are make the named double* function - parameters use our new MyDouble wrapper structure. The "in" - typemap takes this structure, gets the C++ pointer to it, takes the -double value member variable and passes it to the C++ spam - function. In Java, when the function returns, we use the SWIG created -getValue() function to get the output value. The following Java - program demonstrates this:

    +

    Note that dateIn is const and therefore read only and +dateOut is a non-const output type.

    +

    First let's look at the code that is generated by default, where the + Java proxy class CDate is used in the proxy interface:

    -// File: runme.java
    -
    -public class runme {
    -
    -  static {
    -    try {
    -      System.loadLibrary("example");
    -    } catch (UnsatisfiedLinkError e) {
    -      System.err.println("Native code library failed to load. " + e);
    -      System.exit(1);
    -    }
    +public class Action {
    +  ...
    +  public static int doSomething(CDate dateIn, CDate dateOut) {
    +    return exampleJNI.Action_doSomething(CDate.getCPtr(dateIn), dateIn, 
    +                                         CDate.getCPtr(dateOut), dateOut);
       }
     
    -  public static void main(String argv[]) {
    -    MyDouble out1 = new MyDouble();
    -    MyDouble out2 = new MyDouble();
    -    int ret = example.spam(1.2, 3.4, out1, out2);
    -    System.out.println(ret + "  " + out1.getValue() + "  " + out2.getValue());
    +  public Action(CDate date, CDate dateOut) {
    +    this(exampleJNI.new_Action(CDate.getCPtr(date), date, 
    +                               CDate.getCPtr(dateOut), dateOut), true);
       }
     }
     
    -

    When compiled and run we get:

    +

    The CDate & and const CDate & Java code is + generated from the following two default typemaps:

    -$ java runme
    -1 12.0  340.0
    +%typemap(jstype) SWIGTYPE & "$javaclassname"
    +%typemap(javain) SWIGTYPE & "$javaclassname.getCPtr($javainput)"
     
    -

    24.10.7 Adding Java downcasts to - polymorphic return types

    -

    SWIG support for polymorphism works in that the appropriate virtual - function is called. However, the default generated code does not allow - for downcasting. Let's examine this with the following code:

    +

    where '$javaclassname' is translated into the proxy class name, +CDate and '$javainput' is translated into the name of the + parameter, eg dateIn. From Java, the intention is then to call + into a modifed API with something like:

    -%include "std_string.i"
    +java.util.GregorianCalendar calendarIn = 
    +    new java.util.GregorianCalendar(2011, java.util.Calendar.APRIL, 13, 0, 0, 0);
    +java.util.GregorianCalendar calendarOut = new java.util.GregorianCalendar();
     
    -#include <iostream>
    -using namespace std;
    -class Vehicle {
    -public:
    -    virtual void start() = 0;
    -...
    -};
    +// Note in calls below, calendarIn remains unchanged and calendarOut 
    +// is set to a new value by the C++ call
    +Action.doSomething(calendarIn, calendarOut);
    +Action action = new Action(calendarIn, calendarOut);
    +
    +
    +

    To achieve this mapping, we need to alter the default code + generation slightly so that at the Java layer, a GregorianCalendar + is converted into a CDate. The JNI intermediary layer will + still take a pointer to the underlying CDate class. The + typemaps to achieve this are shown below.

    +
    +
    +%typemap(jstype) const CDate& "java.util.GregorianCalendar"
    +%typemap(javain, 
    +         pre="    CDate temp$javainput = new CDate($javainput.get(java.util.Calendar.YEAR), "
    +             "$javainput.get(java.util.Calendar.MONTH), $javainput.get(java.util.Calendar.DATE));", 
    +         pgcppname="temp$javainput") const CDate &
    +         "$javaclassname.getCPtr(temp$javainput)"
     
    -class Ambulance : public Vehicle {
    -    string vol;
    -public:
    -    Ambulance(string volume) : vol(volume) {}
    -    virtual void start() {
    -        cout << "Ambulance started" << endl;
    +%typemap(jstype) CDate& "java.util.Calendar"
    +%typemap(javain, 
    +         pre="    CDate temp$javainput = new CDate($javainput.get(java.util.Calendar.YEAR), "
    +             "$javainput.get(java.util.Calendar.MONTH), $javainput.get(java.util.Calendar.DATE));", 
    +         post="      $javainput.set(temp$javainput.getYear(), temp$javainput.getMonth(), "
    +              "temp$javainput.getDay(), 0, 0, 0);", 
    +         pgcppname="temp$javainput") CDate &
    +         "$javaclassname.getCPtr(temp$javainput)"
    +
    +
    +

    The resulting generated proxy code in the Action class + follows:

    +
    +
    +public class Action {
    +  ...
    +  public static int doSomething(java.util.GregorianCalendar dateIn, 
    +                                java.util.Calendar dateOut) {
    +    CDate tempdateIn = new CDate(dateIn.get(java.util.Calendar.YEAR), 
    +                                 dateIn.get(java.util.Calendar.MONTH), 
    +                                 dateIn.get(java.util.Calendar.DATE));
    +    CDate tempdateOut = new CDate(dateOut.get(java.util.Calendar.YEAR), 
    +                                  dateOut.get(java.util.Calendar.MONTH), 
    +                                  dateOut.get(java.util.Calendar.DATE));
    +    try {
    +      return exampleJNI.Action_doSomething(CDate.getCPtr(tempdateIn), tempdateIn, 
    +                                           CDate.getCPtr(tempdateOut), tempdateOut);
    +    } finally {
    +      dateOut.set(tempdateOut.getYear(), tempdateOut.getMonth(), tempdateOut.getDay(), 0, 0, 0);
         }
    -    void sound_siren() {
    -        cout << vol << " siren sounded!" << endl;
    +  }
    +
    +  static private long SwigConstructAction(java.util.GregorianCalendar date, 
    +                                          java.util.Calendar dateOut) {
    +    CDate tempdate = new CDate(date.get(java.util.Calendar.YEAR), 
    +                               date.get(java.util.Calendar.MONTH), 
    +                               date.get(java.util.Calendar.DATE));
    +    CDate tempdateOut = new CDate(dateOut.get(java.util.Calendar.YEAR), 
    +                                  dateOut.get(java.util.Calendar.MONTH), 
    +                                  dateOut.get(java.util.Calendar.DATE));
    +    try {
    +      return exampleJNI.new_Action(CDate.getCPtr(tempdate), tempdate, 
    +                                   CDate.getCPtr(tempdateOut), tempdateOut);
    +    } finally {
    +      dateOut.set(tempdateOut.getYear(), tempdateOut.getMonth(), tempdateOut.getDay(), 0, 0, 0);
         }
    -...
    -};
    +  }
     
    -Vehicle *vehicle_factory() {
    -    return new Ambulance("Very loud");
    +  public Action(java.util.GregorianCalendar date, java.util.Calendar dateOut) {
    +    this(Action.SwigConstructAction(date, dateOut), true);
    +  }
     }
     
    -

    If we execute the following Java code:

    +

    A few things to note:

    +
      +
    • The "javatype" typemap has changed the parameter type to +java.util.GregorianCalendar or java.util.Calendar instead + of the default generated CDate proxy.
    • +
    • The code in the 'pre' attribute appears before the JNI call ( +exampleJNI.new_Action / exampleJNI.Action_doSomething).
    • +
    • The code in the 'post' attribute appears after the JNI call.
    • +
    • A try .. finally block is generated with the JNI call in the try + block and 'post' code in the finally block. The alternative of just + using a temporary variable for the return value from the JNI call and + the 'post' code being generated before the return statement is not + possible given that the JNI call is in one line and comes from the + "javaout" typemap.
    • +
    • The temporary variables in the "javain" typemaps are called +temp$javain, where "$javain" is replaced with the parameter name. + "$javain" is used to mangle the variable name so that more than one +CDate & type can be used as a parameter in a method, otherwise two + or more local variables with the same name would be generated.
    • +
    • The use of the "javain" typemap causes a constructor helper + function (SwigConstructAction) to be generated. This allows + Java code to be called before the JNI call and is required as the Java + compiler won't compile code inserted before the 'this' call.
    • +
    • The 'pgcppname' attribute is used to modify the object being passed + as the premature garbage collection prevention + parameter (the 2nd and 4th parameters in the JNI calls).
    • +
    +

    25.11 Living with Java Directors

    +

    This section is intended to address frequently asked questions and + frequently encountered problems when using Java directors.

    +
      +
    1. When my program starts up, it complains that method_foo + cannot be found in a Java method called swig_module_init. How do + I fix this? +

      Open up the C++ wrapper source code file and look for +"method_foo" (include the double quotes, they are important!) + Look at the JNI field descriptor and make sure that each class that + occurs in the descriptor has the correct package name in front of it. + If the package name is incorrect, put a "javapackage" typemap in your + SWIG interface file.

      +
    2. +
    3. I'm compiling my code and I'm using templates. I provided a + javapackage typemap, but SWIG doesn't generate the right JNI field + descriptor. +

      Use the template's renamed name as the argument to the "javapackage" + typemap:

      -Vehicle vehicle = example.vehicle_factory();
      -vehicle.start();
      -
      -Ambulance ambulance = (Ambulance)vehicle;
      -ambulance.sound_siren();
      +%typemap(javapackage)  std::vector<int>  "your.package.here"
      +%template(VectorOfInt) std::vector<int>;
       
      -
      -

      We get:

      +
    +
  • +

    When I pass class pointers or references through a C++ upcall and + I try to type cast them, Java complains with a ClassCastException. What + am I doing wrong?

    +

    Normally, a non-director generated Java proxy class creates + temporary Java objects as follows:

    -Ambulance started
    -java.lang.ClassCastException
    -        at runme.main(runme.java:16)
    +public static void MyClass_method_upcall(MyClass self, long jarg1)
    +{
    +  Foo darg1 = new Foo(jarg1, false);
    +
    +  self.method_upcall(darg1);
    +}
     
    -

    Even though we know from examination of the C++ code that -vehicle_factory returns an object of type Ambulance, we - are not able to use this knowledge to perform the downcast in Java. - This occurs because the runtime type information is not completely - passed from C++ to Java when returning the type from -vehicle_factory(). Usually this is not a problem as virtual - functions do work by default, such as in the case of start(). - There are a few solutions to getting downcasts to work.

    -

    The first is not to use a Java cast but a call to C++ to make the - cast. Add this to your code:

    -
    -
    -%exception Ambulance::dynamic_cast(Vehicle *vehicle) {
    -    $action
    -    if (!result) {
    -        jclass excep = jenv->FindClass("java/lang/ClassCastException");
    -        if (excep) {
    -            jenv->ThrowNew(excep, "dynamic_cast exception");
    -        }
    -    }
    +

    Unfortunately, this loses the Java type information that is part of + the underlying Foo director proxy class's Java object pointer causing + the type cast to fail. The SWIG Java module's director code attempts to + correct the problem, but only for director-enabled classes, + since the director class retains a global reference to its Java object. + Thus, for director-enabled classes and only for director-enabled + classes, the generated proxy Java code looks something like:

    +
    +
    +public static void MyClass_method_upcall(MyClass self, long jarg1,
    +                                         Foo jarg1_object)
    +{
    +  Foo darg1 = (jarg1_object != null ? jarg1_object : new Foo(jarg1, false));
    +
    +  self.method_upcall(darg1);
     }
    -%extend Ambulance {
    -    static Ambulance *dynamic_cast(Vehicle *vehicle) {
    -        return dynamic_cast<Ambulance *>(vehicle);
    -    }
    -};
     
    -

    It would then be used from Java like this

    +

    When you import a SWIG interface file containing class definitions, + the classes you want to be director-enabled must be have the +feature("director") enabled for type symmetry to work. This + applies even when the class being wrapped isn't a director-enabled + class but takes parameters that are director-enabled classes.

    +

    The current "type symmetry" design will work for simple C++ + inheritance, but will most likely fail for anything more complicated + such as tree or diamond C++ inheritance hierarchies. Those who are + interested in challenging problems are more than welcome to hack the +Java::Java_director_declaration method in +Source/Modules/java.cxx.

    +

    If all else fails, you can use the downcastXXXXX() method to attempt + to recover the director class's Java object pointer. For the Java Foo + proxy class, the Foo director class's java object pointer can be + accessed through the javaObjectFoo() method. The generated method's + signature is:

    -Ambulance ambulance = Ambulance.dynamic_cast(vehicle);
    -ambulance.sound_siren();
    +  public static Foo javaObjectFoo(Foo obj);
     
    -

    Should vehicle not be of type ambulance then a - Java ClassCastException is thrown. The next solution is a - purer solution in that Java downcasts can be performed on the types. - Add the following before the definition of vehicle_factory:

    +

    From your code, this method is invoked as follows:

    -%typemap(out) Vehicle * {
    -    Ambulance *downcast = dynamic_cast<Ambulance *>($1);
    -    *(Ambulance **)&$result = downcast;
    -}
    -
    -%typemap(javaout) Vehicle * {
    -    return new Ambulance($jnicall, $owner);
    +public class MyClassDerived {
    +  public void method_upcall(Foo foo_object)
    +  {
    +    FooDerived    derived = (foo_object != null ?
    +                 (FooDerived) Foo.downcastFoo(foo_object) : null);
    +    /* rest of your code here */
       }
    +}
     
    -

    Here we are using our knowledge that vehicle_factory always - returns type Ambulance so that the Java proxy is created as a - type Ambulance. If vehicle_factory can manufacture - any type of Vehicle and we want to be able to downcast using - Java casts for any of these types, then a different approach is needed. - Consider expanding our example with a new Vehicle type and a more - flexible factory function:

    +

    An good approach for managing downcasting is placing a static method + in each derived class that performs the downcast from the superclass, + e.g.,

    -class FireEngine : public Vehicle {
    -public:
    -    FireEngine() {}
    -    virtual void start() {
    -        cout << "FireEngine started" << endl;
    +public class FooDerived extends Foo {
    +  /* ... */
    +  public static FooDerived downcastFooDerived(Foo foo_object)
    +  {
    +    try {
    +     return (foo_object != null ? (FooDerived) Foo.downcastFoo(foo_object);
         }
    -    void roll_out_hose() {
    -        cout << "Hose rolled out" << endl;
    +
    +    catch (ClassCastException exc) {
    +      // Wasn't a FooDerived object, some other subclass of Foo
    +      return null;
         }
    - ...
    -};
    -Vehicle *vehicle_factory(int vehicle_number) {
    -    if (vehicle_number == 0)
    -        return new Ambulance("Very loud");
    -    else
    -        return new FireEngine();
    +  }
     }
     
    -

    To be able to downcast with this sort of Java code:

    +

    Then change the code in MyClassDerived as follows:

    -FireEngine fireengine = (FireEngine)example.vehicle_factory(1);
    -fireengine.roll_out_hose();
    -Ambulance ambulance = (Ambulance)example.vehicle_factory(0);
    -ambulance.sound_siren();
    +public class MyClassDerived extends MyClass {
    +  /* ... */
    +  public void method_upcall(Foo foo_object)
    +  {
    +    FooDerived    derived = FooDerived.downcastFooDerived(foo_object);
    +    /* rest of your code here */
    +  }
    +}
     
    -
    -

    the following typemaps targeted at the vehicle_factory - function will achieve this. Note that in this case, the Java class is - constructed using JNI code rather than passing a pointer across the JNI - boundary in a Java long for construction in Java code.

    +
  • +
  • +

    Why isn't the proxy class declared abstract? Why aren't the + director upcall methods in the proxy class declared abstract?

    +

    Declaring the proxy class and its methods abstract would break the + JNI argument marshalling and SWIG's downcall functionality (going from + Java to C++.) Create an abstract Java subclass that inherits from the + director-enabled class instead. Using the previous Foo class example:

    -%typemap(jni) Vehicle *vehicle_factory "jobject"
    -%typemap(jtype) Vehicle *vehicle_factory "Vehicle"
    -%typemap(jstype) Vehicle *vehicle_factory "Vehicle"
    -%typemap(javaout) Vehicle *vehicle_factory {
    -    return $jnicall;
    -  }
    +public abstract class UserVisibleFoo extends Foo {
    +  /** Make sure user overrides this method, it's where the upcall
    +   * happens.
    +   */
    +  public abstract void method_upcall(Foo foo_object);
     
    -%typemap(out) Vehicle *vehicle_factory {
    -    Ambulance *ambulance = dynamic_cast<Ambulance *>($1);
    -    FireEngine *fireengine = dynamic_cast<FireEngine *>($1);
    -    if (ambulance) {
    -        // call the Ambulance(long cPtr, boolean cMemoryOwn) constructor
    -        jclass clazz = jenv->FindClass("Ambulance");
    -        if (clazz) {
    -            jmethodID mid = jenv->GetMethodID(clazz, "<init>", "(JZ)V");
    -            if (mid) {
    -                jlong cptr = 0;
    -                *(Ambulance **)&cptr = ambulance; 
    -                $result = jenv->NewObject(clazz, mid, cptr, false);
    -            }
    -        }
    -    } else if (fireengine) {
    -        // call the FireEngine(long cPtr, boolean cMemoryOwn) constructor
    -        jclass clazz = jenv->FindClass("FireEngine");
    -        if (clazz) {
    -            jmethodID mid = jenv->GetMethodID(clazz, "<init>", "(JZ)V");
    -            if (mid) {
    -                jlong cptr = 0;
    -                *(FireEngine **)&cptr = fireengine; 
    -                $result = jenv->NewObject(clazz, mid, cptr, false);
    -            }
    -        }
    -    }
    -    else {
    -        cout << "Unexpected type " << endl;
    +  /// Downcast from Foo to UserVisibleFoo
    +  public static UserVisibleFoo downcastUserVisibleFoo(Foo foo_object)
    +  {
    +    try {
    +     return (foo_object != null ? (FooDerived) Foo.downcastFoo(foo_object) : null);
         }
     
    -    if (!$result)
    -        cout << "Failed to create new java object" << endl;
    +    catch (ClassCastException exc) {
    +      // Wasn't a FooDerived object, some other subclass of Foo
    +      return null;
    +    }
    +  }
     }
     
    -

    Better error handling would need to be added into this code. There - are other solutions to this problem, but this last example demonstrates - some more involved JNI code. SWIG usually generates code which - constructs the proxy classes using Java code as it is easier to handle - error conditions and is faster. Note that the JNI code above uses a - number of string lookups to call a constructor, whereas this would not - occur using byte compiled Java code.

    -

    24.10.8 Adding an equals - method to the Java classes

    -

    When a pointer is returned from a JNI function, it is wrapped using - a new Java proxy class or type wrapper class. Even when the pointers - are the same, it will not be possible to know that the two Java classes - containing those pointers are actually the same object. It is common in - Java to use the equals() method to check whether two objects - are equivalent. The equals() method is usually accompanied by - a hashCode() method in order to fulfill the requirement that - the hash code is equal for equal objects. Pure Java code methods like - these can be easily added:

    +

    This doesn't prevent the user from creating subclasses derived from + Foo, however, UserVisibleFoo provides the safety net that reminds the + user to override the method_upcall() method.

    +
  • + +

    25.12 Odds and ends

    +

    25.12.1 JavaDoc comments

    +

    The SWIG documentation system is currently deprecated. When it is + resurrected JavaDoc comments will be fully supported. If you can't wait + for the full documentation system a couple of workarounds are + available. The %javamethodmodifiers feature can be used for + adding proxy class method comments and module class method comments. + The "javaimports" typemap can be hijacked for adding in proxy class + JavaDoc comments. The jniclassimports or +jniclassclassmodifiers pragmas can also be used for adding + intermediary JNI class comments and likewise the moduleimports + or moduleclassmodifiers pragmas for the module class. Here is + an example adding in a proxy class and method comment:

    -%typemap(javacode) SWIGTYPE %{
    -  public boolean equals(Object obj) {
    -    boolean equal = false;
    -    if (obj instanceof $javaclassname)
    -      equal = ((($javaclassname)obj).swigCPtr == this.swigCPtr);
    -    return equal;
    -  }
    -  public int hashCode() {
    -     return (int)getPointer();
    -  }
    -%}
    +%javamethodmodifiers Barmy::lose_marbles() "
    +  /**
    +    * Calling this method will make you mad.
    +    * Use with <b>utmost</b> caution. 
    +    */
    +  public";
     
    -class Foo { };
    -Foo* returnFoo(Foo *foo) { return foo; }
    +%typemap(javaimports) Barmy "
    +/** The crazy class. Use as a last resort. */"
    +
    +class Barmy {
    +public:
    +  void lose_marbles() {}
    +};
     
    -

    The following would display false without the javacode - typemap above. With the typemap defining the equals method the - result is true.

    +

    Note the "public" added at the end of the %javamethodmodifiers + as this is the default for this feature. The generated proxy class with + JavaDoc comments is then as follows:

    -Foo foo1 = new Foo();
    -Foo foo2 = example.returnFoo(foo1);
    -System.out.println("foo1? " + foo1.equals(foo2));
    +/** The crazy class. Use as a last resort. */
    +public class Barmy {
    +...
    +  /**
    +    * Calling this method will make you mad.
    +    * Use with <b>utmost</b> caution. 
    +    */
    +  public void lose_marbles() {
    +    ...
    +  }
    +...
    +}
     
    -

    24.10.9 Void pointers and a common - Java base class

    -

    One might wonder why the common code that SWIG emits for the proxy - and type wrapper classes is not pushed into a base class. The reason is - that although swigCPtr could be put into a common base class - for all classes wrapping C structures, it would not work for C++ - classes involved in an inheritance chain. Each class derived from a - base needs a separate swigCPtr because C++ compilers sometimes - use a different pointer value when casting a derived class to a base. - Additionally as Java only supports single inheritance, it would not be - possible to derive wrapped classes from your own pure Java classes if - the base class has been 'used up' by SWIG. However, you may want to - move some of the common code into a base class. Here is an example - which uses a common base class for all proxy classes and type wrapper - classes:

    +

    25.12.2 Functional interface + without proxy classes

    +

    It is possible to run SWIG in a mode that does not produce proxy + classes by using the -noproxy commandline option. The interface is + rather primitive when wrapping structures or classes and is accessed + through function calls to the module class. All the functions in the + module class are wrapped by functions with identical names as those in + the intermediary JNI class.

    +

    Consider the example we looked at when examining proxy classes:

    -%typemap(javabase) SWIGTYPE, SWIGTYPE *, SWIGTYPE &, SWIGTYPE [], 
    -                                                         SWIGTYPE (CLASS::*) "SWIG"
    -
    -%typemap(javacode) SWIGTYPE, SWIGTYPE *, SWIGTYPE &, SWIGTYPE [], 
    -                                                         SWIGTYPE (CLASS::*) %{
    -  protected long getPointer() {
    -    return swigCPtr;
    -  }
    -%}
    +class Foo {
    +public:
    +     int x;
    +     int spam(int num, Foo* foo);
    +};
     
    -

    Define new base class called SWIG:

    +

    When using -noproxy, type wrapper classes are generated + instead of proxy classes. Access to all the functions and variables is + through a C like set of functions where the first parameter passed is + the pointer to the class, that is an instance of a type wrapper class. + Here is what the module class looks like:

    -public abstract class SWIG {
    -  protected abstract long getPointer();
    -
    -  public boolean equals(Object obj) {
    -    boolean equal = false;
    -    if (obj instanceof SWIG)
    -      equal = (((SWIG)obj).getPointer() == this.getPointer());
    -    return equal;
    -  }
    -  
    -  SWIGTYPE_p_void getVoidPointer() {
    -    return new SWIGTYPE_p_void(getPointer(), false);
    -  }
    +public class example {
    +  public static void Foo_x_get(SWIGTYPE_p_Foo self, int x) {...}
    +  public static int Foo_x_get(SWIGTYPE_p_Foo self) {...}
    +  public static int Foo_spam(SWIGTYPE_p_Foo self, int num, SWIGTYPE_p_Foo foo) {...}
    +  public static SWIGTYPE_p_Foo new_Foo() {...}
    +  public static void delete_Foo(SWIGTYPE_p_Foo self) {...}
     }
     
    -

    This example contains some useful functionality which you may want - in your code.

    -
      -
    • It has an equals() method. Unlike the previous example, - the method code isn't replicated in all classes.
    • -
    • It also has a function which effectively implements a cast from the - type of the proxy/type wrapper class to a void pointer. This is - necessary for passing a proxy class or a type wrapper class to a - function that takes a void pointer.
    • -
    -

    24.10.10 Struct pointer to - pointer

    -

    Pointers to pointers are often used as output parameters in C - factory type functions. These are a bit more tricky to handle. Consider - the following situation where a Butler can be hired and fired:

    +

    This approach is not nearly as natural as using proxy classes as the + functions need to be used like this:

    -typedef struct {
    -  int hoursAvailable;
    -  char *greeting;
    -} Butler;
    -
    -// Note: HireButler will allocate the memory 
    -// The caller must free the memory by calling FireButler()!!
    -extern int HireButler(Butler **ppButler);
    -extern void FireButler(Butler *pButler);
    +SWIGTYPE_p_Foo foo = example.new_Foo();
    +example.Foo_x_set(foo, 10);
    +int var = example.Foo_x_get(foo);
    +example.Foo_spam(foo, 20, foo);
    +example.delete_Foo(foo);
     
    -

    C code implementation:

    +

    Unlike proxy classes, there is no attempt at tracking memory. All + destructors have to be called manually for example the +delete_Foo(foo) call above.

    +

    25.12.3 Using your own JNI + functions

    +

    You may have some hand written JNI functions that you want to use in + addition to the SWIG generated JNI functions. Adding these to your SWIG + generated package is possible using the %native directive. If + you don't want SWIG to wrap your JNI function then of course you can + simply use the %ignore directive. However, if you want SWIG to + generate just the Java code for a JNI function then use the %native + directive. The C types for the parameters and return type must be + specified in place of the JNI types and the function name must be the + native method name. For example:

    -int HireButler(Butler **ppButler) {
    -  Butler *pButler = (Butler *)malloc(sizeof(Butler));
    -  pButler->hoursAvailable = 24;
    -  pButler->greeting = (char *)malloc(32);
    -  strcpy(pButler->greeting, "At your service Sir");
    -  *ppButler = pButler;
    -  return 1;
    -}
    -void FireButler(Butler *pButler) {
    -  free(pButler->greeting);
    -  free(pButler);
    -}
    +%native (HandRolled) void HandRolled(int, char *);
    +%{
    +JNIEXPORT void JNICALL Java_packageName_moduleName_HandRolled(JNIEnv *, jclass,
    +                                                              jlong, jstring);
    +%}
     
    -

    Let's take two approaches to wrapping this code. The first is to - provide a functional interface, much like the original C interface. The - following Java code shows how we intend the code to be used:

    +

    No C JNI function will be generated and the +Java_packageName_moduleName_HandRolled function will be accessible + using the SWIG generated Java native method call in the intermediary + JNI class which will look like this:

    -    Butler jeeves = new Butler();
    -    example.HireButler(jeeves);
    -    System.out.println("Greeting:     " + jeeves.getGreeting());
    -    System.out.println("Availability: " + jeeves.getHoursAvailable() + " hours per day");
    -    example.FireButler(jeeves);
    +  public final static native void HandRolled(int jarg1, String jarg2);
     
    -

    Resulting in the following output when run:

    -
    +

    and as usual this function is wrapped by another which for a global + C function would appear in the module class:

    +
    -Greeting:     At your service Sir
    -Availability: 24 hours per day
    +  public static void HandRolled(int arg0, String arg1) {
    +    exampleJNI.HandRolled(arg0, arg1);
    +  }
     
    -

    Note the usage is very much like it would be used if we were writing - C code, that is, explicit memory management is needed. No C memory is - allocated in the construction of the Butler proxy class and - the proxy class will not destroy the underlying C memory when it is - collected. A number of typemaps and features are needed to implement - this approach. The following interface file code should be placed - before SWIG parses the above C code.

    +

    The packageName and moduleName must of course be + correct else you will get linker errors when the JVM dynamically loads + the JNI function. You may have to add in some "jtype", "jstype", + "javain" and "javaout" typemaps when wrapping some JNI types. Here the + default typemaps work for int and char *.

    +

    In summary the %native directive is telling SWIG to + generate the Java code to access the JNI C code, but not the JNI C + function itself. This directive is only really useful if you want to + mix your own hand crafted JNI code and the SWIG generated code into one + Java class or package.

    +

    25.12.4 Performance concerns and hints +

    +

    If you're directly manipulating huge arrays of complex objects from + Java, performance may suffer greatly when using the array functions in +arrays_java.i. Try and minimise the expensive JNI calls to C/C++ + functions, perhaps by using temporary Java variables instead of + accessing the information directly from the C/C++ object.

    +

    Java classes without any finalizers generally speed up code + execution as there is less for the garbage collector to do. Finalizer + generation can be stopped by using an empty javafinalize + typemap:

    -%module example
    -
    -// Do not generate the default proxy constructor or destructor
    -%nodefaultctor Butler;
    -%nodefaultdtor Butler;
    -
    -// Add in pure Java code proxy constructor
    -%typemap(javacode) Butler %{
    -  /** This constructor creates the proxy which initially does not create nor own any C memory */
    -  public Butler() {
    -    this(0, false);
    -  }
    -%}
    -
    -// Type typemaps for marshalling Butler **
    -%typemap(jni) Butler ** "jobject"
    -%typemap(jtype) Butler ** "Butler"
    -%typemap(jstype) Butler ** "Butler"
    -
    -// Typemaps for Butler ** as a parameter output type
    -%typemap(in) Butler ** (Butler *ppButler = 0) %{
    -  $1 = &ppButler;
    -%}
    -%typemap(argout) Butler ** {
    -  // Give Java proxy the C pointer (of newly created object)
    -  jclass clazz = (*jenv)->FindClass(jenv, "Butler");
    -  jfieldID fid = (*jenv)->GetFieldID(jenv, clazz, "swigCPtr", "J");
    -  jlong cPtr = 0;
    -  *(Butler **)&cPtr = *$1;
    -  (*jenv)->SetLongField(jenv, $input, fid, cPtr);
    -}
    -%typemap(javain) Butler ** "$javainput"
    +%typemap(javafinalize) SWIGTYPE ""
     
    -

    Note that the JNI code sets the proxy's swigCPtr member - variable to point to the newly created object. The swigCMemOwn - remains unchanged (at false), so that the proxy does not own the - memory.

    -

    Note: The old %nodefault directive disabled the default constructor - and destructor at the same time. This is unsafe in most of the cases, - and you can use the explicit %nodefaultctor and %nodefaultdtor - directives to achieve the same result if needed.

    -

    The second approach offers a more object oriented interface to the - Java user. We do this by making the Java proxy class's constructor call - the HireButler() method to create the underlying C object. - Additionally we get the proxy to take ownership of the memory so that - the finalizer will call the FireButler() function. The proxy - class will thus take ownership of the memory and clean it up when no - longer needed. We will also prevent the user from being able to - explicitly call the HireButler() and FireButler() - functions. Usage from Java will simply be:

    +

    However, you will have to be careful about memory management and + make sure that you code in a call to the delete() member + function. This method normally calls the C++ destructor or free() + for C code.

    +

    25.12.5 Debugging

    +

    The generated code can be debugged using both a Java debugger and a + C++ debugger using the usual debugging techniques. Breakpoints can be + set in either Java or C++ code and so both can be debugged + simultaneously. Most debuggers do not understand both Java and C++, + with one noteable exception of Sun Studio, where it is possible to step + from Java code into a JNI method within one environment.

    +

    Alternatively, debugging can involve placing debug printout + statements in the JNI layer using the %exception directive. + See the special + variables for %exception section. Many of the default typemaps can + also be overridden and modified for adding in extra logging/debug + display information.

    +

    The -Xcheck:jni and -Xcheck:nabounds Java + executable options are useful for debugging to make sure the JNI code + is behaving. The -verbose:jni and -verbose:gc are also useful options + for monitoring code behaviour.

    +

    25.13 Java Examples

    +

    The directory Examples/java has a number of further examples. Take a + look at these if you want to see some of the techniques described in + action. The Examples/index.html file in the parent directory contains + the SWIG Examples Documentation and is a useful starting point. If your + SWIG installation went well Unix users should be able to type make + in each example directory, then java main to see them running. + For the benefit of Windows users, there are also Visual C++ project + files in a couple of the Windows Examples +. There are also many regression tests in the Examples/test-suite + directory. Many of these have runtime tests in the java subdirectory.

    +
    +

    26 SWIG and Javascript

    + + + + +

    This chapter describes SWIG's support of Javascript. It does not + cover SWIG basics, but only information that is specific to this + module.

    +

    26.1 Overview

    +

    Javascript is a prototype-based scripting language that is dynamic, + weakly typed and has first-class functions. Its arguably the most + popular language for web development. Javascript has gone beyond being + a browser-based scripting language and with +node.js, it is also used as a backend development language.

    +

    Native Javascript extensions can be used for applications that embed + a web-browser view or that embed a Javascript engine (such as + node.js). Extending a general purpose web-browser is not possible + as this would be a severe security issue.

    +

    SWIG Javascript currently supports JavascriptCore, + the Javascript engine used by Safari/Webkit, and +v8, which is used by Chromium and +node.js.

    +

    WebKit is a modern browser + implementation available as open-source which can be embedded into an + application. With +node-webkit there is a platform which uses Google's Chromium + as Web-Browser widget and node.js for javascript + extensions.

    +

    26.2 Preliminaries

    +

    26.2.1 Running SWIG

    +

    Suppose that you defined a SWIG module such as the following:

    -Butler jeeves = new Butler();
    -System.out.println("Greeting:     " + jeeves.getGreeting());
    -System.out.println("Availability: " + jeeves.getHoursAvailable() + " hours per day");
    -
    +%module example +%{ +#include "example.h" +%} +int gcd(int x, int y); +extern double Foo;
    -

    Note that the Butler class is used just like any other Java class - and no extra coding by the user needs to be written to clear up the - underlying C memory as the finalizer will be called by the garbage - collector which in turn will call the FireButler() function. - To implement this, we use the above interface file code but remove the -javacode typemap and add the following:

    -
    +

    To build a Javascript module, run SWIG using the -javascript + option and a desired target engine -jsc, -v8, + or -node. The generator for node is + essentially delegating to the v8 generator and adds some + necessary preprocessor definitions.

    +
    -// Don't expose the memory allocation/de-allocation functions
    -%ignore FireButler(Butler *pButler);
    -%ignore HireButler(Butler **ppButler);
    -
    -// Add in a custom proxy constructor and destructor
    -%extend Butler {
    -  Butler() {
    -    Butler *pButler = 0;
    -    HireButler(&pButler);
    -    return pButler;
    -  }
    -  ~Butler() {
    -     FireButler($self);
    -   }
    -}
    -
    +$ swig -javascript -jsc example.i
    -

    Note that the code in %extend is using a C++ type - constructor and destructor, yet the generated code will still compile - as C code, see Adding member - functions to C structures. The C functional interface has been - completely morphed into an object-oriented interface and the Butler - class would behave much like any pure Java class and feel more natural - to Java users.

    -

    24.10.11 - Memory management when returning references to member variables

    -

    This example shows how to prevent premature garbage collection of - objects when the underlying C++ class returns a pointer or reference to - a member variable.

    -

    Consider the following C++ code:

    +

    If building a C++ extension, add the -c++ option:

    +
    +
    +$ swig -c++ -javascript -jsc example.i
    +
    +

    The V8 code that SWIG generates should work with most versions from + 3.11.10 up to 3.29.14 and later.

    +

    The API headers for V8 >= 4.3.0 define constants which SWIG can use + to determine the V8 version it is compiling for. For versions < 4.3.0, + you need to specify the V8 version when running SWIG. This is specified + as a hex constant, but the constant is read as pairs of decimal digits, + so for V8 3.25.30 use constant 0x032530. This scheme can't represent + components > 99, but this constant is only useful for V8 < 4.3.0, and + no V8 versions from that era had a component > 99. For example:

    +
    +
    +$ swig -c++ -javascript -v8 -DV8_VERSION=0x032530 example.i
    +
    +

    If you're targetting V8 >= 4.3.0, you would just run swig like so:

    +
    +
    +$ swig -c++ -javascript -v8 example.i
    +
    +

    This creates a C/C++ source file example_wrap.c or +example_wrap.cxx. The generated C source file contains the + low-level wrappers that need to be compiled and linked with the rest of + your C/C++ application to create an extension module.

    +

    The name of the wrapper file is derived from the name of the input + file. For example, if the input file is example.i, the + name of the wrapper file is example_wrap.c. To change + this, you can use the -o option. The wrapped module will export one + function which must be called to register the module with the + Javascript interpreter. For example, if your module is named +example the corresponding initializer for JavascriptCore would be

    -struct Wheel {
    -  int size;
    -  Wheel(int sz) : size(sz) {}
    -};
    -
    -class Bike {
    -  Wheel wheel;
    -public:
    -  Bike(int val) : wheel(val) {}
    -  Wheel& getWheel() { return wheel; }
    -};
    -
    +bool example_initialize(JSGlobalContextRef context, JSObjectRef *exports)
    -

    and the following usage from Java after running the code through - SWIG:

    +

    and for v8:

    -    Wheel wheel = new Bike(10).getWheel();
    -    System.out.println("wheel size: " + wheel.getSize());
    -    // Simulate a garbage collection
    -    System.gc();
    -    System.runFinalization();
    -    System.out.println("wheel size: " + wheel.getSize());
    -
    +void example_initialize(v8::Handle<v8::Object> exports)
    -

    Don't be surprised that if the resulting output gives strange - results such as...

    +

    Note: be aware that v8 has a C++ API, and thus, + the generated modules must be compiled as C++.

    +

    26.2.2 Running Tests and + Examples

    +

    The configuration for tests and examples currently supports Linux and + Mac only and not MinGW (Windows) yet.

    +

    The default interpreter is node.js as it is available on + all platforms and convenient to use.

    +

    Running the examples with JavascriptCore requires +libjavascriptcoregtk-1.0 to be installed, e.g., under Ubuntu with

    -wheel size: 10
    -wheel size: 135019664
    -
    +$ sudo apt-get install libjavascriptcoregtk-1.0-dev
    -

    What has happened here is the garbage collector has collected the -Bike instance as it doesn't think it is needed any more. The proxy - instance, wheel, contains a reference to memory that was - deleted when the Bike instance was collected. In order to - prevent the garbage collector from collecting the Bike - instance a reference to the Bike must be added to the -wheel instance. You can do this by adding the reference when the -getWheel() method is called using the following typemaps.

    -
    +

    Running with V8 requires libv8:

    +
    -%typemap(javacode) Wheel %{
    -  // Ensure that the GC doesn't collect any Bike instance set from Java
    -  private Bike bikeReference;
    -  protected void addReference(Bike bike) {
    -    bikeReference = bike;
    -  }
    -%}
    -
    -// Add a Java reference to prevent premature garbage collection and resulting use
    -// of dangling C++ pointer. Intended for methods that return pointers or
    -// references to a member variable.
    -%typemap(javaout) Wheel& getWheel {
    -    long cPtr = $jnicall;
    -    $javaclassname ret = null;
    -    if (cPtr != 0) {
    -      ret = new $javaclassname(cPtr, $owner);
    -      ret.addReference(this);
    -    }
    -    return ret;
    -  }
    -
    +$ sudo apt-get install libv8-dev
    -

    The code in the first typemap gets added to the Wheel proxy - class. The code in the second typemap constitutes the bulk of the code - in the generated getWheel() function:

    +

    Examples can be run using

    +
    +
    +$ make check-javascript-examples ENGINE=jsc
    +
    +

    ENGINE can be node, jsc, or +v8.

    +

    The test-suite can be run using

    +
    +
    +$ make check-javascript-test-suite ENGINE=jsc
    +
    +

    You can specify a specific V8 version for running the + examples and tests

    +
    +
    +$ make check-javascript-examples V8_VERSION=0x032530 ENGINE=v8
    +
    +

    26.2.3 Known Issues

    +

    At the moment, the Javascript generators pass all tests + syntactically, i.e., the generated source code compiles. However, there + are still remaining runtime issues.

    +
      +
    • +

      Default optional arguments do not work for all targeted interpreters

      +
    • +
    • +

      Multiple output arguments do not work for JSC

      +
    • +
    • +

      C89 incompatibily: the JSC generator might still generate C89 + violating code

      +
    • +
    • +

      long long is not supported

      +
    • +
    • +

      %native is not supported

      +
    • +
    • +

      Javascript callbacks are not supported

      +
    • +
    • +

      instanceOf does not work under JSC

      +
    • +
    +

    The primary development environment has been Linux (Ubuntu 12.04). + Windows and Mac OS X have been tested sporadically. Therefore, the + generators might have more issues on those platforms. Please report + back any problem you observe to help us improving this module quickly.

    +

    26.3 Integration

    +

    This chapter gives a short introduction how to use a native + Javascript extension: as a node.js module, and as an + extension for an embedded Webkit.

    +

    26.3.1 Creating node.js + Extensions

    +

    To install node.js you can download an installer from + their +web-site for Mac OS X and Windows. For Linux you can either build + the source yourself and run sudo checkinstall or keep to + the (probably stone-age) packaged version. For Ubuntu there is a +PPA available.

    +
    +
    +$ sudo add-apt-repository ppa:chris-lea/node.js
    +$ sudo apt-get update
    +$ sudo apt-get install nodejs
    +
    +

    As v8 is written in C++ and comes as a C++ library it is + crucial to compile your module using the same compiler flags as used + for building v8. To make things easier, node.js provides a + build tool called node-gyp.

    +

    You have to install it using npm:

    +
    +
    +$ sudo npm install -g node-gyp
    +
    +

    node-gyp expects a configuration file named +binding.gyp which is basically in JSON format and conforms to the + same format that is used with Google's build-tool gyp.

    +

    binding.gyp:

    -public class Wheel {
    -  ...
    -  // Ensure that the GC doesn't collect any bike set from Java 
    -  private Bike bikeReference;
    -  protected void addReference(Bike bike) {
    -    bikeReference = bike;
    -  }
    -}
    -
    -public class Bike {
    -  ...
    -  public Wheel getWheel() {
    -    long cPtr = exampleJNI.Bike_getWheel(swigCPtr, this);
    -    Wheel ret = null;
    -    if (cPtr != 0) {
    -      ret = new Wheel(cPtr, false);
    -      ret.addReference(this);
    +{
    +  "targets": [
    +    {
    +      "target_name": "example",
    +      "sources": [ "example.cxx", "example_wrap.cxx" ]
         }
    -    return ret;
    -  }
    -}
    -
    + ] +}
    -

    Note the addReference call.

    -

    24.10.12 Memory - management for objects passed to the C++ layer

    -

    Managing memory can be tricky when using C++ and Java proxy classes. - The previous example shows one such case and this example looks at - memory management for a class passed to a C++ method which expects the - object to remain in scope after the function has returned. Consider the - following two C++ classes:

    -
    +

    First create the wrapper using SWIG:

    +
    -struct Element {
    -  int value;
    -  Element(int val) : value(val) {}
    -};
    -class Container {
    -  Element* element;
    -public:
    -  Container() : element(0) {}
    -  void setElement(Element* e) { element = e; }
    -  Element* getElement() { return element; }
    -};
    -
    +$ swig -javascript -node -c++ example.i
    -

    and usage from C++

    -
    +

    Then run node-gyp build to actually create the module:

    +
    -    Container container;
    -    Element element(20);
    -    container.setElement(&element);
    -    cout << "element.value: " << container.getElement()->value << endl;
    -
    +$ node-gyp build
    -

    and more or less equivalent usage from Java

    +

    This will create a build folder containing the native + module. To use the extension you need to 'require' it in your + Javascript source file:

    -    Container container = new Container();
    -    container.setElement(new Element(20));
    -    System.out.println("element value: " + container.getElement().getValue());
    -
    +require("./build/Release/example")
    -

    The C++ code will always print out 20, but the value printed out may - not be this in the Java equivalent code. In order to understand why, - consider a garbage collection occuring...

    -
    +

    A more detailed explanation is given in the +Examples section.

    +

    26.3.1.1 Troubleshooting

    +
      +
    • 'module' object has no attribute 'script_main'
    • +
    +

    This error happens when gyp is installed as a + distribution package. It seems to be outdated. Removing it resolves the + problem.

    +
    -    Container container = new Container();
    -    container.setElement(new Element(20));
    -    // Simulate a garbage collection
    -    System.gc();
    -    System.runFinalization();
    -    System.out.println("element value: " + container.getElement().getValue());
    -
    +$ sudo apt-get remove gyp
    -

    The temporary element created with new Element(20) could - get garbage collected which ultimately means the container - variable is holding a dangling pointer, thereby printing out any old - random value instead of the expected value of 20. One solution is to - add in the appropriate references in the Java layer...

    +

    26.3.2 Embedded Webkit

    +

    Webkit is pre-installed on Mac OS X and available as a library for + GTK.

    +

    26.3.2.1 Mac OS X

    +

    There is general information about programming with WebKit on +Apple Developer Documentation. Details about Cocoa + programming are not covered here.

    +

    An integration of a native extension 'example' would look like this:

    -public class Container {
    +#import "appDelegate.h"
     
    -  ...
    +extern bool example_initialize(JSGlobalContextRef context, JSObjectRef* exports);
     
    -  // Ensure that the GC doesn't collect any Element set from Java
    -  // as the underlying C++ class stores a shallow copy
    -  private Element elementReference;
    -  private long getCPtrAndAddReference(Element element) {
    -    elementReference = element;
    -    return Element.getCPtr(element);
    -  }
     
    -  public void setElement(Element e) {
    -    exampleJNI.Container_setElement(swigCPtr, this, getCPtrAndAddReference(e), e);
    +@implementation ExampleAppDelegate
    +
    +@synthesize webView;
    +
    +- (void)addGlobalObject:(JSContextRef) context:(NSString *)objectName:(JSObjectRef) theObject {
    +  JSObjectRef global = JSContextGetGlobalObject(context);
    +  JSStringRef objectJSName = JSStringCreateWithCFString( (CFStringRef) objectName )
    +  if ( objectJSName != NULL ) {
    +    JSObjectSetProperty(context, global, objectJSName, theObject, kJSPropertyAttributeReadOnly, NULL);
    +    JSStringRelease( objectJSName );
       }
     }
    -
    + +- (void)applicationDidFinishLaunching:(NSNotification *)aNotification { + + // Start a webview with the bundled index.html file + NSString *path = [[NSBundle mainBundle] bundlePath]; + NSString *url = [NSString stringWithFormat: @"file://%@/Contents/Assets/index.html", path]; + + WebFrame *webframe = [webView mainFrame]; + JSGlobalContextRef context = [webframe globalContext]; + + JSObjectRef example; + example_initialize(context, &example); + [self addGlobalObject:context:@"example":example] + + JSObjectSetProperty(context, global, JSStringRef propertyName, example, JSPropertyAttributes attributes, NULL); + + [ [webView mainFrame] loadRequest: + [NSURLRequest requestWithURL: [NSURL URLWithString:url] ] + ]; +} + +@end
    -

    The following typemaps will generate the desired code. The 'javain' - typemap matches the input parameter type for the setElement - method. The 'javacode' typemap simply adds in the specified code into - the Java proxy class.

    +

    26.3.2.2 GTK

    +

    There is general information about programming GTK at +GTK documentation and in the +GTK tutorial, and for Webkit there is a +Webkit GTK+ API Reference.

    +

    An integration of a native extension 'example' would look like this:

    -%typemap(javain) Element *e "getCPtrAndAddReference($javainput)"
    +#include <gtk/gtk.h>
    +#include <webkit/webkit.h>
     
    -%typemap(javacode) Container %{
    -  // Ensure that the GC doesn't collect any element set from Java
    -  // as the underlying C++ class stores a shallow copy
    -  private Element elementReference;
    -  private long getCPtrAndAddReference(Element element) {
    -    elementReference = element;
    -    return Element.getCPtr(element);
    -  }
    -%}
    -
    +extern bool example_initialize(JSGlobalContextRef context); + +int main(int argc, char* argv[]) +{ + // Initialize GTK+ + gtk_init(&argc, &argv); + + ... + + // Create a browser instance + WebKitWebView *webView = WEBKIT_WEB_VIEW(webkit_web_view_new()); + WebFrame *webframe = webkit_web_view_get_main_frame(webView); + JSGlobalContextRef context = webkit_web_frame_get_global_context(webFrame); + JSObjectRef global = JSContextGetGlobalObject(context); + + JSObjectRef exampleModule; + example_initialize(context, &exampleModule); + JSStringRef jsName = JSStringCreateWithUTF8CString("example"); + JSObjectSetProperty(context, global, jsName, exampleModule, kJSPropertyAttributeReadOnly, NULL); + JSStringRelease(jsName); + + ... + + // Load a web page into the browser instance + webkit_web_view_load_uri(webView, "http://www.webkitgtk.org/"); + + ... + + // Run the main GTK+ event loop + gtk_main(); + + return 0; +}
    -

    24.10.13 Date marshalling using - the javain typemap and associated attributes

    -

    The NaN Exception example - is a simple example of the "javain" typemap and its 'pre' attribute. - This example demonstrates how a C++ date class, say CDate, can - be mapped onto the standard Java date class, -java.util.GregorianCalendar by using the 'pre', 'post' and - 'pgcppname' attributes of the "javain" typemap. The idea is that the -GregorianCalendar is used wherever the C++ API uses a CDate -. Let's assume the code being wrapped is as follows:

    +

    26.3.3 Creating + Applications with node-webkit

    +

    To get started with node-webkit there is a very + informative set of +wiki pages.

    +

    Similar to node.js, node-webkit is started + from command line within a node.js project directory. + Native extensions are created in the very same way as for node.js +, except that a customized gyp derivate has to be used: +nw-gyp.

    +

    A simple example would have the following structure:

    -class CDate {
    -public:
    -  CDate(int year, int month, int day);
    -  int getYear();
    -  int getMonth();
    -  int getDay();
    -  ...
    -};
    -struct Action {
    -  static int doSomething(const CDate &dateIn, CDate &dateOut);
    -  Action(const CDate &date, CDate &dateOut);
    -};
    +- package.json
    +- app.html
    +- app.js
    +- node_modules
    +  / example
    +  ... (as known from node.js)
     
    -

    Note that dateIn is const and therefore read only and -dateOut is a non-const output type.

    -

    First let's look at the code that is generated by default, where the - Java proxy class CDate is used in the proxy interface:

    +

    The configuration file essentially conforms to node.js + syntax. It has some extras to configure node-webkit. See + the +Manifest specification for more details.

    +

    package.json:

    -public class Action {
    -  ...
    -  public static int doSomething(CDate dateIn, CDate dateOut) {
    -    return exampleJNI.Action_doSomething(CDate.getCPtr(dateIn), dateIn, 
    -                                         CDate.getCPtr(dateOut), dateOut);
    -  }
    -
    -  public Action(CDate date, CDate dateOut) {
    -    this(exampleJNI.new_Action(CDate.getCPtr(date), date, 
    -                               CDate.getCPtr(dateOut), dateOut), true);
    +{
    +  "name": "example",
    +  "main": "app.html",
    +  "window": {
    +    "show": true,
    +    "width": 800,
    +    "height": 600
       }
    -}
    -
    +}
    -

    The CDate & and const CDate & Java code is - generated from the following two default typemaps:

    +

    The 'main' property of package.json + specifies a web-page to be rendered in the main window.

    +

    app.html:

    +
    +
    +<html>
    +  <head>
    +    <script src="app.js"></script>
    +  </head>
    +  <body>
    +    <div>
    +      The greatest common divisor of
    +      <span id="x"></span> and
    +      <span id="y"></span> is
    +      <span id="z"></span>.
    +    </div>
    +  </body>
    +</html>
    +
    +

    As known from node.js one can use require + to load javascript modules. Additionally, node-webkit + provides an API that allows to manipulate the window's menu, open new + windows, and many more things.

    +

    app.js:

    +
    +
    window.onload = function() {
    +  var example = require("example");
    +  var x = 18;
    +  var y = 24;
    +  var z = example.gcd(x,y);
    +  document.querySelector('#x').innerHTML = x;
    +  document.querySelector('#y').innerHTML = y;
    +  document.querySelector('#z').innerHTML = z;
    +};
    +
    +

    26.4 Examples

    +

    Some basic examples are shown here in more detail.

    +

    26.4.1 Simple

    +

    The common example simple looks like this:

    -%typemap(jstype) SWIGTYPE & "$javaclassname"
    -%typemap(javain) SWIGTYPE & "$javaclassname.getCPtr($javainput)"
    -
    +/* File : example.i */ +%module example + +%inline %{ +extern int gcd(int x, int y); +extern double Foo; +%}
    -

    where '$javaclassname' is translated into the proxy class name, -CDate and '$javainput' is translated into the name of the - parameter, eg dateIn. From Java, the intention is then to call - into a modifed API with something like:

    +

    To make this available as a node extension a binding.gyp + has to be created:

    -java.util.GregorianCalendar calendarIn = 
    -    new java.util.GregorianCalendar(2011, java.util.Calendar.APRIL, 13, 0, 0, 0);
    -java.util.GregorianCalendar calendarOut = new java.util.GregorianCalendar();
    -
    -// Note in calls below, calendarIn remains unchanged and calendarOut 
    -// is set to a new value by the C++ call
    -Action.doSomething(calendarIn, calendarOut);
    -Action action = new Action(calendarIn, calendarOut);
    -
    +{ + "targets": [ + { + "target_name": "example", + "sources": [ "example.cxx", "example_wrap.cxx" ] + } + ] +}
    -

    To achieve this mapping, we need to alter the default code - generation slightly so that at the Java layer, a GregorianCalendar - is converted into a CDate. The JNI intermediary layer will - still take a pointer to the underlying CDate class. The - typemaps to achieve this are shown below.

    +

    Then node-gyp is used to build the extension:

    +
    +
    +$ node-gyp configure build
    +
    +

    From a 'nodejs` application the extension would be used like this:

    -%typemap(jstype) const CDate& "java.util.GregorianCalendar"
    -%typemap(javain, 
    -         pre="    CDate temp$javainput = new CDate($javainput.get(java.util.Calendar.YEAR), "
    -             "$javainput.get(java.util.Calendar.MONTH), $javainput.get(java.util.Calendar.DATE));", 
    -         pgcppname="temp$javainput") const CDate &
    -         "$javaclassname.getCPtr(temp$javainput)"
    +// import the extension via require
    +var example = require("./build/Release/example");
     
    -%typemap(jstype) CDate& "java.util.Calendar"
    -%typemap(javain, 
    -         pre="    CDate temp$javainput = new CDate($javainput.get(java.util.Calendar.YEAR), "
    -             "$javainput.get(java.util.Calendar.MONTH), $javainput.get(java.util.Calendar.DATE));", 
    -         post="      $javainput.set(temp$javainput.getYear(), temp$javainput.getMonth(), "
    -              "temp$javainput.getDay(), 0, 0, 0);", 
    -         pgcppname="temp$javainput") CDate &
    -         "$javaclassname.getCPtr(temp$javainput)"
    -
    +// calling the global method +var x = 42; +var y = 105; +var g = example.gcd(x,y); + +// Accessing the global variable +var f = example.Foo; +example.Foo = 3.1415926;
    -

    The resulting generated proxy code in the Action class - follows:

    +

    First the module example is loaded from the previously + built extension. Global methods and variables are available in the + scope of the module.

    +

    Note: ECMAScript 5, the currently implemented Javascript + standard, does not have modules. node.js and other + implementations provide this mechanism defined by the +CommonJS group. For browsers this is provided by +Browserify, for instance.

    +

    26.4.2 Class

    +

    The common example class defines three classes, +Shape, Circle, and Square:

    -public class Action {
    -  ...
    -  public static int doSomething(java.util.GregorianCalendar dateIn, 
    -                                java.util.Calendar dateOut) {
    -    CDate tempdateIn = new CDate(dateIn.get(java.util.Calendar.YEAR), 
    -                                 dateIn.get(java.util.Calendar.MONTH), 
    -                                 dateIn.get(java.util.Calendar.DATE));
    -    CDate tempdateOut = new CDate(dateOut.get(java.util.Calendar.YEAR), 
    -                                  dateOut.get(java.util.Calendar.MONTH), 
    -                                  dateOut.get(java.util.Calendar.DATE));
    -    try {
    -      return exampleJNI.Action_doSomething(CDate.getCPtr(tempdateIn), tempdateIn, 
    -                                           CDate.getCPtr(tempdateOut), tempdateOut);
    -    } finally {
    -      dateOut.set(tempdateOut.getYear(), tempdateOut.getMonth(), tempdateOut.getDay(), 0, 0, 0);
    -    }
    +class Shape {
    +public:
    +  Shape() {
    +    nshapes++;
       }
    -
    -  static private long SwigConstructAction(java.util.GregorianCalendar date, 
    -                                          java.util.Calendar dateOut) {
    -    CDate tempdate = new CDate(date.get(java.util.Calendar.YEAR), 
    -                               date.get(java.util.Calendar.MONTH), 
    -                               date.get(java.util.Calendar.DATE));
    -    CDate tempdateOut = new CDate(dateOut.get(java.util.Calendar.YEAR), 
    -                                  dateOut.get(java.util.Calendar.MONTH), 
    -                                  dateOut.get(java.util.Calendar.DATE));
    -    try {
    -      return exampleJNI.new_Action(CDate.getCPtr(tempdate), tempdate, 
    -                                   CDate.getCPtr(tempdateOut), tempdateOut);
    -    } finally {
    -      dateOut.set(tempdateOut.getYear(), tempdateOut.getMonth(), tempdateOut.getDay(), 0, 0, 0);
    -    }
    +  virtual ~Shape() {
    +    nshapes--;
       }
    +  double  x, y;
    +  void    move(double dx, double dy);
    +  virtual double area(void) = 0;
    +  virtual double perimeter(void) = 0;
    +  static  int nshapes;
    +};
     
    -  public Action(java.util.GregorianCalendar date, java.util.Calendar dateOut) {
    -    this(Action.SwigConstructAction(date, dateOut), true);
    -  }
    -}
    -
    +class Circle : public Shape { +private: + double radius; +public: + Circle(double r) : radius(r) { } + virtual double area(void); + virtual double perimeter(void); +}; + +class Square : public Shape { +private: + double width; +public: + Square(double w) : width(w) { } + virtual double area(void); + virtual double perimeter(void); +};
    -

    A few things to note:

    -
      -
    • The "javatype" typemap has changed the parameter type to -java.util.GregorianCalendar or java.util.Calendar instead - of the default generated CDate proxy.
    • -
    • The code in the 'pre' attribute appears before the JNI call ( -exampleJNI.new_Action / exampleJNI.Action_doSomething).
    • -
    • The code in the 'post' attribute appears after the JNI call.
    • -
    • A try .. finally block is generated with the JNI call in the try - block and 'post' code in the finally block. The alternative of just - using a temporary variable for the return value from the JNI call and - the 'post' code being generated before the return statement is not - possible given that the JNI call is in one line and comes from the - "javaout" typemap.
    • -
    • The temporary variables in the "javain" typemaps are called -temp$javain, where "$javain" is replaced with the parameter name. - "$javain" is used to mangle the variable name so that more than one -CDate & type can be used as a parameter in a method, otherwise two - or more local variables with the same name would be generated.
    • -
    • The use of the "javain" typemap causes a constructor helper - function (SwigConstructAction) to be generated. This allows - Java code to be called before the JNI call and is required as the Java - compiler won't compile code inserted before the 'this' call.
    • -
    • The 'pgcppname' attribute is used to modify the object being passed - as the premature garbage collection prevention - parameter (the 2nd and 4th parameters in the JNI calls).
    • -
    -

    24.11 Living with Java Directors

    -

    This section is intended to address frequently asked questions and - frequently encountered problems when using Java directors.

    -
      -
    1. When my program starts up, it complains that method_foo - cannot be found in a Java method called swig_module_init. How do - I fix this? -

      Open up the C++ wrapper source code file and look for -"method_foo" (include the double quotes, they are important!) - Look at the JNI field descriptor and make sure that each class that - occurs in the descriptor has the correct package name in front of it. - If the package name is incorrect, put a "javapackage" typemap in your - SWIG interface file.

      -
    2. -
    3. I'm compiling my code and I'm using templates. I provided a - javapackage typemap, but SWIG doesn't generate the right JNI field - descriptor. -

      Use the template's renamed name as the argument to the "javapackage" - typemap:

      -
      -
      -%typemap(javapackage)  std::vector<int>  "your.package.here"
      -%template(VectorOfInt) std::vector<int>;
      -
      -
    4. -
    5. -

      When I pass class pointers or references through a C++ upcall and - I try to type cast them, Java complains with a ClassCastException. What - am I doing wrong?

      -

      Normally, a non-director generated Java proxy class creates - temporary Java objects as follows:

      +

      Circle and Square inherit from Shape +. Shape has a static variable nshapes, a + function move that can't be overridden (non-virtual), and + two abstract functions area and perimeter + (pure virtual) that must be overridden by the sub-classes.

      +

      A nodejs extension is built the same way as for the +simple example.

      +

      In Javascript it can be used as follows:

      -public static void MyClass_method_upcall(MyClass self, long jarg1)
      -{
      -  Foo darg1 = new Foo(jarg1, false);
      +var example = require("./build/Release/example");
       
      -  self.method_upcall(darg1);
      -}
      -
      -
      -

      Unfortunately, this loses the Java type information that is part of - the underlying Foo director proxy class's Java object pointer causing - the type cast to fail. The SWIG Java module's director code attempts to - correct the problem, but only for director-enabled classes, - since the director class retains a global reference to its Java object. - Thus, for director-enabled classes and only for director-enabled - classes, the generated proxy Java code looks something like:

      -
      +// local aliases for convenience +var Shape = example.Shape; +var Circle = example.Circle; +var Square = example.Square; + +// creating new instances using the 'new' operator +var c = new Circle(10); +var s = new Square(10); + +// accessing a static member +Shape.nshapes; + +// accessing member variables +c.x = 20; +c.y = 30; +s.x = -10; +s.y = 5; + +// calling some methods +c.area(); +c.perimeter(); +s.area(); +s.perimeter(); + +// instantiation of Shape is not permitted +new Shape(); +
      +

      Running these commands in an interactive node shell results in the + following output:

      +
      -public static void MyClass_method_upcall(MyClass self, long jarg1,
      -                                         Foo jarg1_object)
      -{
      -  Foo darg1 = (jarg1_object != null ? jarg1_object : new Foo(jarg1, false));
      +$ node -i
      +& var example = require("./build/Release/example");
      +undefined
      +& var Shape = example.Shape;
      +undefined
      +& var Circle = example.Circle;
      +undefined
      +& var Square = example.Square;
      +undefined
      +& var c = new Circle(10);
      +undefined
      +& var s = new Square(10);
      +undefined
      +& Shape.nshapes;
      +2
      +& c.x = 20;
      +20
      +& c.y = 30;
      +30
      +& s.x = -10;
      +-10
      +& s.y = 5;
      +5
      +& c.area();
      +314.1592653589793
      +& c.perimeter();
      +62.83185307179586
      +& s.area();
      +100
      +& s.perimeter();
      +40
      +& c.move(40, 40)
      +undefined
      +& c.x
      +60
      +& c.y
      +70
      +& new Shape()
      +Error: Class Shape can not be instantiated
      +at repl:1:2
      +at REPLServer.self.eval (repl.js:110:21)
      +at Interface.<anonymous> (repl.js:239:12)
      +at Interface.EventEmitter.emit (events.js:95:17)
      +at Interface._onLine (readline.js:202:10)
      +at Interface._line (readline.js:531:8)
      +at Interface._ttyWrite (readline.js:760:14)
      +at ReadStream.onkeypress (readline.js:99:10)
      +at ReadStream.EventEmitter.emit (events.js:98:17)
      +at emitKey (readline.js:1095:12)
      +
      +

      Note: In ECMAScript 5 there is no concept for classes. + Instead each function can be used as a constructor function which is + executed by the 'new' operator. Furthermore, during construction the + key property prototype of the constructor function is used + to attach a prototype instance to the created object. A prototype is + essentially an object itself that is the first-class delegate of a + class used whenever the access to a property of an object fails. The + very same prototype instance is shared among all instances of one type. + Prototypal inheritance is explained in more detail on in +Inheritance and the prototype chain, for instance.

      +

      26.5 Implementation

      +

      The Javascript Module implementation has taken a very different + approach compared to other language modules in order to support + different Javascript interpreters.

      +

      26.5.1 Source Code

      +

      The Javascript module is implemented in +Source/Modules/javascript.cxx. It dispatches the code generation + to a JSEmitter instance, V8Emitter or +JSCEmitter. Additionally there are some helpers: Template +, for templated code generation, and JSEmitterState, which + is used to manage state information during AST traversal. This rough + map shall make it easier to find a way through this huge source file:

      +
      +
      +// module wide defines
      +
      +#define NAME "name"
      +...
       
      -  self.method_upcall(darg1);
      -}
      -
      +// ############################### +// # Helper class declarations + +class JSEmitterState { ... }; + +class Template { ... }; + +// ############################### +// # JSEmitter declaration + +class JSEmitter { ... }; + +// Emitter factory declarations + +JSEmitter *swig_javascript_create_JSCEmitter(); +JSEmitter *swig_javascript_create_V8Emitter(); + +// ############################### +// # Javascript module + +// Javascript module declaration + +class JAVASCRIPT:public Language { ... }; + +// Javascript module implementation + +int JAVASCRIPT::functionWrapper(Node *n) { ... } +... + +// Module factory implementation + +static Language *new_swig_javascript() { ... } + +extern "C" Language *swig_javascript(void) { ... } + +// ############################### +// # JSEmitter base implementation + +JSEmitter::JSEmitter() { ... } + +Template JSEmitter::getTemplate(const String *name) { ... } +... + +// ############################### +// # JSCEmitter + +// JSCEmitter declaration + +class JSCEmitter: public JSEmitter { ... }; + +// JSCEmitter implementation + +JSCEmitter::JSCEmitter() { ... } + +void JSCEmitter::marshalInputArgs(Node *n, ParmList *parms, Wrapper *wrapper, MarshallingMode mode, bool is_member, bool is_static) { ... } +... + +// JSCEmitter factory + +JSEmitter *swig_javascript_create_JSCEmitter() { ... } + + +// ############################### +// # V8Emitter + +// V8Emitter declaration + +class V8Emitter: public JSEmitter { ... }; + +// V8Emitter implementation + +V8Emitter::V8Emitter() { ... } + +int V8Emitter::initialize(Node *n) { ... } + +// V8Emitter factory + +JSEmitter *swig_javascript_create_V8Emitter() { ... } + + +// ############################### +// # Helper implementation (JSEmitterState, Template) + +JSEmitterState::JSEmitterState() { ... } +... + +Template::Template(const String *code_) { ... } +...
      -

      When you import a SWIG interface file containing class definitions, - the classes you want to be director-enabled must be have the -feature("director") enabled for type symmetry to work. This - applies even when the class being wrapped isn't a director-enabled - class but takes parameters that are director-enabled classes.

      -

      The current "type symmetry" design will work for simple C++ - inheritance, but will most likely fail for anything more complicated - such as tree or diamond C++ inheritance hierarchies. Those who are - interested in challenging problems are more than welcome to hack the -Java::Java_director_declaration method in -Source/Modules/java.cxx.

      -

      If all else fails, you can use the downcastXXXXX() method to attempt - to recover the director class's Java object pointer. For the Java Foo - proxy class, the Foo director class's java object pointer can be - accessed through the javaObjectFoo() method. The generated method's - signature is:

      -
      +

      26.5.2 Code Templates

      +

      All generated code is created on the basis of code templates. The + templates for JavascriptCore can be found in +Lib/javascript/jsc/javascriptcode.swg, for v8 in +Lib/javascript/v8/javascriptcode.swg.

      +

      To track the originating code template for generated code you can run

      +
      -  public static Foo javaObjectFoo(Foo obj);
      -
      +$ swig -javascript -jsc -debug-codetemplates
      -

      From your code, this method is invoked as follows:

      +

      which wraps generated code with a descriptive comment

      -public class MyClassDerived {
      -  public void method_upcall(Foo foo_object)
      -  {
      -    FooDerived    derived = (foo_object != null ?
      -                 (FooDerived) Foo.downcastFoo(foo_object) : null);
      -    /* rest of your code here */
      -  }
      -}
      -
      +/* begin fragment("template_name") */ + +...generated code ... + +/* end fragment("template_name") */
      -

      An good approach for managing downcasting is placing a static method - in each derived class that performs the downcast from the superclass, - e.g.,

      +

      The Template class is used like this:

      -public class FooDerived extends Foo {
      -  /* ... */
      -  public static FooDerived downcastFooDerived(Foo foo_object)
      -  {
      -    try {
      -     return (foo_object != null ? (FooDerived) Foo.downcastFoo(foo_object);
      -    }
      -
      -    catch (ClassCastException exc) {
      -      // Wasn't a FooDerived object, some other subclass of Foo
      -      return null;
      -    }
      -  }
      -}
      -
      +Template t_register = getTemplate("jsv8_register_static_variable"); +t_register.replace("$jsparent", state.clazz(NAME_MANGLED)) + .replace("$jsname", state.variable(NAME)) + .replace("$jsgetter", state.variable(GETTER)) + .replace("$jssetter", state.variable(SETTER)) + .trim(). + print(f_init_static_wrappers);
      -

      Then change the code in MyClassDerived as follows:

      +

      A code template is registered with the JSEmitter via +fragment(name, "template"), e.g.,

      -public class MyClassDerived extends MyClass {
      -  /* ... */
      -  public void method_upcall(Foo foo_object)
      -  {
      -    FooDerived    derived = FooDerived.downcastFooDerived(foo_object);
      -    /* rest of your code here */
      -  }
      -}
      -
      -
    6. -
    7. -

      Why isn't the proxy class declared abstract? Why aren't the - director upcall methods in the proxy class declared abstract?

      -

      Declaring the proxy class and its methods abstract would break the - JNI argument marshalling and SWIG's downcall functionality (going from - Java to C++.) Create an abstract Java subclass that inherits from the - director-enabled class instead. Using the previous Foo class example:

      +%fragment ("jsc_variable_declaration", "templates") +%{ + {"$jsname", $jsgetter, $jssetter, kJSPropertyAttributeNone}, +%} +
    +

    Template creates a copy of that string and +Template::replace uses Swig's Replaceall to replace + variables in the template. Template::trim can be used to + eliminate leading and trailing whitespaces. Template::print + is used to write the final template string to a Swig DOH + (based on Printv). All methods allow chaining.

    +

    26.5.3 Emitter

    +

    The Javascript module delegates code generation to a JSEmitter + instance. The following extract shows the essential interface:

    -public abstract class UserVisibleFoo extends Foo {
    -  /** Make sure user overrides this method, it's where the upcall
    -   * happens.
    +class JSEmitter {
    +  ...
    +
    +  /**
    +   * Opens output files and temporary output DOHs.
        */
    -  public abstract void method_upcall(Foo foo_object);
    +  virtual int initialize(Node *n);
     
    -  /// Downcast from Foo to UserVisibleFoo
    -  public static UserVisibleFoo downcastUserVisibleFoo(Foo foo_object)
    -  {
    -    try {
    -     return (foo_object != null ? (FooDerived) Foo.downcastFoo(foo_object) : null);
    -    }
    +  /**
    +   * Writes all collected code into the output file(s).
    +   */
    +  virtual int dump(Node *n) = 0;
     
    -    catch (ClassCastException exc) {
    -      // Wasn't a FooDerived object, some other subclass of Foo
    -      return null;
    -    }
    +  /**
    +   * Cleans up all open output DOHs.
    +   */
    +  virtual int close() = 0;
    +
    +  ...
    +
    +  /**
    +   * Invoked at the beginning of the classHandler.
    +   */
    +  virtual int enterClass(Node *);
    +
    +  /**
    +   * Invoked at the end of the classHandler.
    +   */
    +  virtual int exitClass(Node *) {
    +    return SWIG_OK;
       }
    -}
    -
    -
    -

    This doesn't prevent the user from creating subclasses derived from - Foo, however, UserVisibleFoo provides the safety net that reminds the - user to override the method_upcall() method.

    - - -

    24.12 Odds and ends

    -

    24.12.1 JavaDoc comments

    -

    The SWIG documentation system is currently deprecated. When it is - resurrected JavaDoc comments will be fully supported. If you can't wait - for the full documentation system a couple of workarounds are - available. The %javamethodmodifiers feature can be used for - adding proxy class method comments and module class method comments. - The "javaimports" typemap can be hijacked for adding in proxy class - JavaDoc comments. The jniclassimports or -jniclassclassmodifiers pragmas can also be used for adding - intermediary JNI class comments and likewise the moduleimports - or moduleclassmodifiers pragmas for the module class. Here is - an example adding in a proxy class and method comment:

    -
    -
    -%javamethodmodifiers Barmy::lose_marbles() "
    +
       /**
    -    * Calling this method will make you mad.
    -    * Use with <b>utmost</b> caution. 
    -    */
    -  public";
    +   * Invoked at the beginning of the variableHandler.
    +   */
    +  virtual int enterVariable(Node *);
     
    -%typemap(javaimports) Barmy "
    -/** The crazy class. Use as a last resort. */"
    +  /**
    +   * Invoked at the end of the variableHandler.
    +   */
    +  virtual int exitVariable(Node *) {
    +    return SWIG_OK;
    +  }
     
    -class Barmy {
    -public:
    -  void lose_marbles() {}
    -};
    -
    -
    -

    Note the "public" added at the end of the %javamethodmodifiers - as this is the default for this feature. The generated proxy class with - JavaDoc comments is then as follows:

    -
    -
    -/** The crazy class. Use as a last resort. */
    -public class Barmy {
    -...
       /**
    -    * Calling this method will make you mad.
    -    * Use with <b>utmost</b> caution. 
    -    */
    -  public void lose_marbles() {
    -    ...
    +   * Invoked at the beginning of the functionHandler.
    +   */
    +  virtual int enterFunction(Node *);
    +
    +  /**
    +   * Invoked at the end of the functionHandler.
    +   */
    +  virtual int exitFunction(Node *) {
    +    return SWIG_OK;
       }
    -...
    -}
    -
    -
    -

    24.12.2 Functional interface - without proxy classes

    -

    It is possible to run SWIG in a mode that does not produce proxy - classes by using the -noproxy commandline option. The interface is - rather primitive when wrapping structures or classes and is accessed - through function calls to the module class. All the functions in the - module class are wrapped by functions with identical names as those in - the intermediary JNI class.

    -

    Consider the example we looked at when examining proxy classes:

    -
    -
    -class Foo {
    -public:
    -     int x;
    -     int spam(int num, Foo* foo);
    -};
    -
    + + /** + * Invoked by functionWrapper callback after call to Language::functionWrapper. + */ + virtual int emitWrapperFunction(Node *n); + + /** + * Invoked from constantWrapper after call to Language::constantWrapper. + **/ + virtual int emitConstant(Node *n); + + /** + * Registers a given code snippet for a given key name. + * + * This method is called by the fragmentDirective handler + * of the JAVASCRIPT language module. + **/ + int registerTemplate(const String *name, const String *code); + + /** + * Retrieve the code template registered for a given name. + */ + Template getTemplate(const String *name); + + State &getState(); + + ... + +}
    -

    When using -noproxy, type wrapper classes are generated - instead of proxy classes. Access to all the functions and variables is - through a C like set of functions where the first parameter passed is - the pointer to the class, that is an instance of a type wrapper class. - Here is what the module class looks like:

    +

    The module calls initialize, dump, and +close from within the top method:

    -public class example {
    -  public static void Foo_x_get(SWIGTYPE_p_Foo self, int x) {...}
    -  public static int Foo_x_get(SWIGTYPE_p_Foo self) {...}
    -  public static int Foo_spam(SWIGTYPE_p_Foo self, int num, SWIGTYPE_p_Foo foo) {...}
    -  public static SWIGTYPE_p_Foo new_Foo() {...}
    -  public static void delete_Foo(SWIGTYPE_p_Foo self) {...}
    -}
    -
    +int JAVASCRIPT::top(Node *n) { + emitter->initialize(n); + + Language::top(n); + + emitter->dump(n); + emitter->close(); + + return SWIG_OK; +}
    -

    This approach is not nearly as natural as using proxy classes as the - functions need to be used like this:

    +

    The methods enterClass and exitClass are + called from within the classHandler method:

    -SWIGTYPE_p_Foo foo = example.new_Foo();
    -example.Foo_x_set(foo, 10);
    -int var = example.Foo_x_get(foo);
    -example.Foo_spam(foo, 20, foo);
    -example.delete_Foo(foo);
    -
    +int JAVASCRIPT::classHandler(Node *n) { + + emitter->enterClass(n); + Language::classHandler(n); + emitter->exitClass(n); + + return SWIG_OK; +}
    -

    Unlike proxy classes, there is no attempt at tracking memory. All - destructors have to be called manually for example the -delete_Foo(foo) call above.

    -

    24.12.3 Using your own - JNI functions

    -

    You may have some hand written JNI functions that you want to use in - addition to the SWIG generated JNI functions. Adding these to your SWIG - generated package is possible using the %native directive. If - you don't want SWIG to wrap your JNI function then of course you can - simply use the %ignore directive. However, if you want SWIG to - generate just the Java code for a JNI function then use the %native - directive. The C types for the parameters and return type must be - specified in place of the JNI types and the function name must be the - native method name. For example:

    +

    In enterClass the emitter stores state information that + is necessary when processing class members. In exitClass + the wrapper code for the whole class is generated.

    +

    26.5.4 Emitter states

    +

    For storing information during the AST traversal the emitter provides + a JSEmitterState with different slots to store data + representing the scopes global, class, function, and variable.

    -%native (HandRolled) void HandRolled(int, char *);
    -%{
    -JNIEXPORT void JNICALL Java_packageName_moduleName_HandRolled(JNIEnv *, jclass,
    -                                                              jlong, jstring);
    -%}
    -
    +class JSEmitterState { + +public: + + JSEmitterState(); + + ~JSEmitterState(); + + DOH *global(); + + DOH *global(const char* key, DOH *initial = 0); + + DOH *clazz(bool reset = false); + + DOH *clazz(const char* key, DOH *initial = 0); + + DOH *function(bool reset = false); + + DOH *function(const char* key, DOH *initial = 0); + + DOH *variable(bool reset = false); + + DOH *variable(const char* key, DOH *initial = 0); + + static int IsSet(DOH *val); + + ... +};
    -

    No C JNI function will be generated and the -Java_packageName_moduleName_HandRolled function will be accessible - using the SWIG generated Java native method call in the intermediary - JNI class which will look like this:

    +

    When entering a scope, such as in enterClass, the + corresponding state is reset and new data is stored:

    -  public final static native void HandRolled(int jarg1, String jarg2);
    -
    +state.clazz(RESET); +state.clazz(NAME, Getattr(n, "sym:name"));
    -

    and as usual this function is wrapped by another which for a global - C function would appear in the module class:

    +

    State information can be retrieved using state.clazz(NAME) + or with Getattr on state.clazz() which + actually returns a Hash instance.

    +

    26.5.5 Handling Exceptions in + JavascriptCore

    +

    Applications with an embedded JavascriptCore should be able to + present detailed exception messages that occur in the Javascript + engine. Below is an example derived from code provided by Brian Barnes + on how these exception details can be extracted.

    -  public static void HandRolled(int arg0, String arg1) {
    -    exampleJNI.HandRolled(arg0, arg1);
    +void script_exception_to_string(JSContextRef js_context,JSValueRef exception_value_ref,char* return_error_string, int return_error_string_max_length)
    +{
    +  JSObjectRef exception_object;
    +  JSValueRef value_ref;
    +  JSStringRef jsstring_property_name = NULL;
    +  JSValueRef temporary_exception = NULL;
    +  JSStringRef js_return_string = NULL;
    +  size_t bytes_needed;
    +  char* c_result_string = NULL;
    +  exception_object = JSValueToObject(js_context, exception_value_ref, NULL);
    +
    +  /* source url */
    +  strcpy(return_error_string,"[");
    +  jsstring_property_name = JSStringCreateWithUTF8CString("sourceURL");
    +  value_ref = JSObjectGetProperty(js_context, exception_object, jsstring_property_name, &temporary_exception);
    +  JSStringRelease(jsstring_property_name);
    +  js_return_string = JSValueToStringCopy(js_context, value_ref, NULL);
    +  bytes_needed = JSStringGetMaximumUTF8CStringSize(js_return_string);
    +  c_result_string = (char*)calloc(bytes_needed, sizeof(char));
    +  JSStringGetUTF8CString(js_return_string, c_result_string, bytes_needed);
    +  JSStringRelease(js_return_string);
    +  strncat(return_error_string, c_result_string, return_error_string_max_length-1);
    +  free(c_result_string);
    +
    +  strncat(return_error_string, ":", return_error_string_max_length-1);
    +
    +  /* line number */
    +
    +  jsstring_property_name = JSStringCreateWithUTF8CString("line");
    +  value_ref = JSObjectGetProperty(js_context, exception_object, jsstring_property_name, &temporary_exception);
    +  JSStringRelease(jsstring_property_name);
    +  js_return_string = JSValueToStringCopy(js_context, value_ref, NULL);
    +  bytes_needed = JSStringGetMaximumUTF8CStringSize(js_return_string);
    +  c_result_string = (char*)calloc(bytes_needed, sizeof(char));
    +  JSStringGetUTF8CString(js_return_string, c_result_string, bytes_needed);
    +  JSStringRelease(js_return_string);
    +  strncat(return_error_string, c_result_string, return_error_string_max_length-1);
    +  free(c_result_string);
    +
    +  strncat(return_error_string, "]", return_error_string_max_length-1);
    +
    +  /* error message */
    +
    +  jsstring_property_name = JSStringCreateWithUTF8CString("message");
    +  value_ref = JSObjectGetProperty(js_context, exception_object, jsstring_property_name, &temporary_exception);
    +  JSStringRelease(jsstring_property_name);
    +  if(NULL == value_ref)
    +  {
    +    strncat(return_error_string, "Unknown Error", return_error_string_max_length-1);
       }
    -
    + else + { + js_return_string = JSValueToStringCopy(js_context, value_ref, NULL); + bytes_needed = JSStringGetMaximumUTF8CStringSize(js_return_string); + c_result_string = (char*)calloc(bytes_needed, sizeof(char)); + JSStringGetUTF8CString(js_return_string, c_result_string, bytes_needed); + JSStringRelease(js_return_string); + strncat(return_error_string, c_result_string, return_error_string_max_length-1); + free(c_result_string); + } +}
    -

    The packageName and moduleName must of course be - correct else you will get linker errors when the JVM dynamically loads - the JNI function. You may have to add in some "jtype", "jstype", - "javain" and "javaout" typemaps when wrapping some JNI types. Here the - default typemaps work for int and char *.

    -

    In summary the %native directive is telling SWIG to - generate the Java code to access the JNI C code, but not the JNI C - function itself. This directive is only really useful if you want to - mix your own hand crafted JNI code and the SWIG generated code into one - Java class or package.

    -

    24.12.4 Performance concerns and - hints

    -

    If you're directly manipulating huge arrays of complex objects from - Java, performance may suffer greatly when using the array functions in -arrays_java.i. Try and minimise the expensive JNI calls to C/C++ - functions, perhaps by using temporary Java variables instead of - accessing the information directly from the C/C++ object.

    -

    Java classes without any finalizers generally speed up code - execution as there is less for the garbage collector to do. Finalizer - generation can be stopped by using an empty javafinalize - typemap:

    +

    It would be used in the following way:

    -%typemap(javafinalize) SWIGTYPE ""
    -
    -
    -

    However, you will have to be careful about memory management and - make sure that you code in a call to the delete() member - function. This method normally calls the C++ destructor or free() - for C code.

    -

    24.12.5 Debugging

    -

    The generated code can be debugged using both a Java debugger and a - C++ debugger using the usual debugging techniques. Breakpoints can be - set in either Java or C++ code and so both can be debugged - simultaneously. Most debuggers do not understand both Java and C++, - with one noteable exception of Sun Studio, where it is possible to step - from Java code into a JNI method within one environment.

    -

    Alternatively, debugging can involve placing debug printout - statements in the JNI layer using the %exception directive. - See the special - variables for %exception section. Many of the default typemaps can - also be overidden and modified for adding in extra logging/debug - display information.

    -

    The -Xcheck:jni and -Xcheck:nabounds Java - executable options are useful for debugging to make sure the JNI code - is behaving. The -verbose:jni and -verbose:gc are also useful options - for monitoring code behaviour.

    -

    24.13 Java Examples

    -

    The directory Examples/java has a number of further examples. Take a - look at these if you want to see some of the techniques described in - action. The Examples/index.html file in the parent directory contains - the SWIG Examples Documentation and is a useful starting point. If your - SWIG installation went well Unix users should be able to type make - in each example directory, then java main to see them running. - For the benefit of Windows users, there are also Visual C++ project - files in a couple of the Windows Examples -. There are also many regression tests in the Examples/test-suite - directory. Many of these have runtime tests in the java subdirectory.

    -
    -

    25 SWIG and Common Lisp

    +if(js_exception) +{ + char return_error_string[256]; + script_exception_to_string(js_context, js_exception, return_error_string, 256); + printf("Compile error is %s", return_error_string); +} +

    +

    27 SWIG and Common Lisp

    @@ -32709,11 +36644,11 @@ arrays_java.i. Try and minimise the expensive JNI calls to C/C++ foreign function interfaces. SWIG currently supports only the Allegro Common Lisp, Common Foreign Function Interface(CFFI), CLisp and UFFI foreign function interfaces.

    -

    25.1 Allegro Common Lisp

    +

    27.1 Allegro Common Lisp

    Allegro Common Lisp support in SWIG has been updated to include support for both C and C++. You can read about the interface here

    -

    25.2 Common Foreign Function Interface(CFFI)

    +

    27.2 Common Foreign Function Interface(CFFI)

    CFFI, the Common Foreign Function Interface, is a portable foreign function interface for ANSI Common Lisp systems, similar in spirit to UFFI. Unlike UFFI, CFFI requires only a small set of low-level @@ -32731,7 +36666,7 @@ swig -cffi -module module-name file-name

    But a better was of using all the power of SWIG is to write SWIG interface files. Below we will explain how to write interface files and the various things which you can do with them.

    -

    25.2.1 Additional Commandline Options

    +

    27.2.1 Additional Commandline Options

    The following table list the additional commandline options available for the CLISP module. They can also be seen by using:

    @@ -32754,9 +36689,9 @@ swig -cffi -help wrappers. These macros, functions may still be used by generated wrapper code. -

    25.2.2 Generating CFFI bindings

    +

    27.2.2 Generating CFFI bindings

    As we mentioned earlier the ideal way to use SWIG is to use interface - files. To illustrate the use of it, lets assume that we have a file + files. To illustrate the use of it, let's assume that we have a file named test.h with the following C code:
     #define y 5
    @@ -32849,19 +36784,19 @@ enum color { RED, BLUE, GREEN};
     (cl:defconstant x (cl:ash 5 -1))
     
     (cffi:defcstruct bar
    -	(p :short)
    -	(q :short)
    -	(a :char)
    -	(b :char)
    -	(z :pointer)
    -	(n :pointer))
    +        (p :short)
    +        (q :short)
    +        (a :char)
    +        (b :char)
    +        (z :pointer)
    +        (n :pointer))
     
     (cffi:defcvar ("my_struct" my_struct)
      :pointer)
     
     (cffi:defcstruct foo
    -	(a :int)
    -	(b :pointer))
    +        (a :int)
    +        (b :pointer))
     
     (cffi:defcfun ("pointer_func" pointer_func) :int
       (ClosureFun :pointer)
    @@ -32877,9 +36812,9 @@ enum color { RED, BLUE, GREEN};
       (array :pointer))
     
     (cffi:defcenum color
    -	:RED
    -	:BLUE
    -	:GREEN)
    +        :RED
    +        :BLUE
    +        :GREEN)
     

    The SWIG wrapper code refers to the special code which SWIG @@ -32907,9 +36842,11 @@ feature directive. Let's edit the interface file such that the C %feature("export"); %feature("inline") lispsort_double; - %feature("intern_function", "my-lispify") lispsort_double; +%feature("export", package="'some-other-package") lispsort_double; + %rename func123 renamed_cool_func; + %ignore "pointer_func"; %include "test.h" @@ -32929,11 +36866,13 @@ feature directive. Let's edit the interface file such that the C %feature("intern_function", "my-lispify") lispsort_double;, here we are using an additional feature which allows us to use our lispify function.

    -

    The export feature allows us to export the symbols. The - inline feature declaims the declared function as inline. The - rename directive allows us to change the name(it is useful when - generating C wrapper code for handling overloaded functions). The - ignore directive ignores a certain declaration.

    +

    The export feature allows us to export the symbols. If the + package argument is given, then the symbol will be exported to the + specified Lisp package. The inline feature declaims the declared + function as inline. The rename directive allows us to change the + name(it is useful when generating C wrapper code for handling + overloaded functions). The ignore directive ignores a certain + declaration.

    There are several other things which are possible, to see some example of usage of SWIG look at the Lispbuilder and wxCL projects. The generated code with 'noswig-lisp' option is:

    @@ -32948,12 +36887,12 @@ feature directive. Let's edit the interface file such that the C (cl:export '#.(swig-lispify "x" 'constant)) (cffi:defcstruct #.(swig-lispify "bar" 'classname) - (#.(swig-lispify "p" 'slotname) :short) - (#.(swig-lispify "q" 'slotname) :short) - (#.(swig-lispify "a" 'slotname) :char) - (#.(swig-lispify "b" 'slotname) :char) - (#.(swig-lispify "z" 'slotname) :pointer) - (#.(swig-lispify "n" 'slotname) :pointer)) + (#.(swig-lispify "p" 'slotname) :short) + (#.(swig-lispify "q" 'slotname) :short) + (#.(swig-lispify "a" 'slotname) :char) + (#.(swig-lispify "b" 'slotname) :char) + (#.(swig-lispify "z" 'slotname) :pointer) + (#.(swig-lispify "n" 'slotname) :pointer)) (cl:export '#.(swig-lispify "bar" 'classname)) @@ -32975,8 +36914,8 @@ feature directive. Let's edit the interface file such that the C (cl:export '#.(swig-lispify "my_struct" 'variable)) (cffi:defcstruct #.(swig-lispify "foo" 'classname) - (#.(swig-lispify "a" 'slotname) :int) - (#.(swig-lispify "b" 'slotname) :pointer)) + (#.(swig-lispify "a" 'slotname) :int) + (#.(swig-lispify "b" 'slotname) :pointer)) (cl:export '#.(swig-lispify "foo" 'classname)) @@ -32997,18 +36936,18 @@ feature directive. Let's edit the interface file such that the C (n :int) (array :pointer)) -(cl:export '#.(my-lispify "lispsort_double" 'function)) +(cl:export '#.(my-lispify "lispsort_double" 'function) 'some-other-package) (cffi:defcenum #.(swig-lispify "color" 'enumname) - #.(swig-lispify "RED" 'enumvalue :keyword) - #.(swig-lispify "BLUE" 'enumvalue :keyword) - #.(swig-lispify "GREEN" 'enumvalue :keyword)) + #.(swig-lispify "RED" 'enumvalue :keyword) + #.(swig-lispify "BLUE" 'enumvalue :keyword) + #.(swig-lispify "GREEN" 'enumvalue :keyword)) (cl:export '#.(swig-lispify "color" 'enumname))
    -

    25.2.3 Generating CFFI bindings for C++ code

    +

    27.2.3 Generating CFFI bindings for C++ code

    This feature to SWIG (for CFFI) is very new and still far from complete. Pitch in with your patches, bug reports and feature requests to improve it.

    @@ -33175,8 +37114,8 @@ namespace OpenDemo {

    If you have any questions, suggestions, patches, etc., related to CFFI module feel free to contact us on the SWIG mailing list, and also please add a "[CFFI]" tag in the subject line.

    -

    25.2.4 Inserting user code into generated - files

    +

    27.2.4 Inserting user code into generated files +

    It is often necessary to include user-defined code into the automatically generated interface files. For example, when building a C++ interface, example_wrap.cxx will likely not compile @@ -33205,7 +37144,7 @@ int fact(int n);

    Note that the block %{ ... %} is effectively a shortcut for %insert("header") %{ ... %}.

    -

    25.3 CLISP

    +

    27.3 CLISP

    CLISP is a feature-loaded implementation of common lisp which is portable across most of the operating system environments and hardware. CLISP includes an @@ -33227,7 +37166,7 @@ swig -clisp -module module-name file-name modify them. The good thing is that you don't need to complex interface file for the CLISP module. The CLISP module tries to produce code which is both human readable and easily modifyable.

    -

    25.3.1 Additional Commandline Options

    +

    27.3.1 Additional Commandline Options

    The following table list the additional commandline options available for the CLISP module. They can also be seen by using:

    @@ -33246,7 +37185,7 @@ swig -clisp -help def-c-type will be used to generate
    shortcuts according to the typedefs in the input. -

    25.3.2 Details on CLISP bindings

    +

    27.3.2 Details on CLISP bindings

    As mentioned earlier the CLISP bindings generated by SWIG may need some modifications. The clisp module creates a lisp file with the same name as the module name. This lisp file contains a 'defpackage' @@ -33304,18 +37243,18 @@ void test123(float x , double y); (ffi:def-call-out pointer_func (:name "pointer_func") (:arguments (ClosureFun (ffi:c-function (:arguments (arg0 (ffi:c-pointer NIL)) - (arg1 (ffi:c-pointer NIL)) - (arg2 (ffi:c-pointer NIL))) - (:return-type NIL))) - (y ffi:int)) + (arg1 (ffi:c-pointer NIL)) + (arg2 (ffi:c-pointer NIL))) + (:return-type NIL))) + (y ffi:int)) (:return-type ffi:int) (:library +library-name+)) (ffi:def-call-out func123 (:name "func123") (:arguments (x (ffi:c-pointer div_t)) - (z (ffi:c-ptr (ffi:c-array (ffi:c-ptr (ffi:c-ptr ffi:int)) 100))) - (y (ffi:c-ptr (ffi:c-ptr (ffi:c-array ffi:int (1000 10)))))) + (z (ffi:c-ptr (ffi:c-array (ffi:c-ptr (ffi:c-ptr ffi:int)) 100))) + (y (ffi:c-ptr (ffi:c-ptr (ffi:c-array ffi:int (1000 10)))))) (:return-type ffi:int) (:library +library-name+)) @@ -33323,14 +37262,14 @@ void test123(float x , double y); (ffi:def-call-out lispsort_double (:name "lispsort_double") (:arguments (n ffi:int) - (array (ffi:c-ptr DOUBLE-FLOAT))) + (array (ffi:c-ptr DOUBLE-FLOAT))) (:return-type NIL) (:library +library-name+)) (ffi:def-call-out test123 (:name "test") (:arguments (x SINGLE-FLOAT) - (y DOUBLE-FLOAT)) + (y DOUBLE-FLOAT)) (:return-type NIL) (:library +library-name+)) @@ -33364,9 +37303,9 @@ struct bar {

    -

    25.4 UFFI

    +

    27.4 UFFI


    -

    26 SWIG and Lua

    +

    28 SWIG and Lua

    @@ -33385,9 +37324,13 @@ struct bar {
  • Modules
  • Functions
  • Global variables
  • -
  • Constants and enums
  • +
  • Constants and enums + +
  • Pointers
  • -
  • Structures
  • +
  • Structures
  • C++ classes
  • C++ inheritance
  • Pointers, references, values, and arrays
  • @@ -33398,19 +37341,27 @@ struct bar {
  • C++ templates
  • C++ Smart Pointers
  • C++ Exceptions
  • +
  • Namespaces + +
  • Typemaps
  • -
  • Writing typemaps +
  • Writing typemaps
  • @@ -33448,16 +37399,17 @@ http://www.lua.org

    regular Lua desktop version. More information on eLua can be found here: http://www.eluaproject.net

    -

    26.1 Preliminaries

    +

    28.1 Preliminaries

    The current SWIG implementation is designed to work with Lua 5.0.x, 5.1.x and 5.2.x. It should work with later versions of Lua, but certainly not with Lua 4.0 due to substantial API changes. It is possible to either static link or dynamic link a Lua module into the interpreter (normally Lua static links its libraries, as dynamic - linking is not available on all platforms). SWIG also supports eLua and - works with eLua 0.8. SWIG generated code for eLua has been tested on - Stellaris ARM Cortex-M3 LM3S and Infineon TriCore.

    -

    26.2 Running SWIG

    + linking is not available on all platforms). SWIG also has support for + eLua starting from eLua 0.8. Due to substantial changes between SWIG + 2.x and SWIG 3.0 and unavailability of testing platform, eLua status + was downgraded to 'experimental'.

    +

    28.2 Running SWIG

    Suppose that you defined a SWIG module such as the following:

    @@ -33515,7 +37467,7 @@ $ swig -lua -eluac example.i
      is a catch though: Metatables are not generated with -eluac.
      To access any value from eLua, one must directly call the wrapper
      function associated with that value.

    -

    26.2.1 Additional command line options

    +

    28.2.1 Additional command line options

    The following table list the additional commandline options available for the Lua module. They can also be seen by using:

    @@ -33531,8 +37483,15 @@ swig -lua -help for elua. -nomoduleglobalDo not register the module name as a global variable but return the module table from calls to require. +-no-old-metatable-bindingsDisable backward + compatibility: old-style binding names generations and a few other + things. Explanations are included in appropriate later sections. +-squash-basesSquashes symbols from all inheritance tree + of a given class into itself. Emulates pre-SWIG3.0 inheritance. + Insignificantly speeds things up, but increases memory consumption. + -

    26.2.2 Compiling and Linking and Interpreter

    +

    28.2.2 Compiling and Linking and Interpreter

    Normally Lua is embedded into another program and will be statically linked. An extremely simple stand-alone interpreter (min.c) is given below:

    @@ -33554,8 +37513,8 @@ int main(int argc,char* argv[]) return 0; } L=lua_open(); - luaopen_base(L); // load basic libs (eg. print) - luaopen_example(L); // load the wrapped module + luaopen_base(L); // load basic libs (eg. print) + luaopen_example(L); // load the wrapped module if (luaL_loadfile(L,argv[1])==0) // load and run the file lua_pcall(L,0,0,0); else @@ -33607,7 +37566,7 @@ LUALIB_API int ( luaopen_mod )(lua_State *L );

    More information on building and configuring eLua can be found here: http://www.eluaproject.net/doc/v0.8/en_building.html

    -

    26.2.3 Compiling a dynamic module

    +

    28.2.3 Compiling a dynamic module

    Most, but not all platforms support the dynamic loading of modules (Windows & Linux do). Refer to the Lua manual to determine if your platform supports it. For compiling a dynamically loaded module the @@ -33617,8 +37576,8 @@ http://www.eluaproject.net/doc/v0.8/en_building.html

     $ swig -lua example.i -o example_wrap.c
    -$ gcc -I/usr/include/lua -c example_wrap.c -o example_wrap.o
    -$ gcc -c example.c -o example.o
    +$ gcc -fPIC -I/usr/include/lua -c example_wrap.c -o example_wrap.o
    +$ gcc -fPIC -c example.c -o example.o
     $ gcc -shared -I/usr/include/lua -L/usr/lib/lua example_wrap.o example.o -o example.so
     
    @@ -33684,7 +37643,7 @@ print(a,b,c)
    'loadlib' not installed/supported
    Is quite obvious (Go back and consult the Lua documents on how to enable loadlib for your platform).

    -

    26.2.4 Using your module

    +

    28.2.4 Using your module

    Assuming all goes well, you will be able to this:

    @@ -33699,17 +37658,17 @@ $ ./my_lua
     >
     
    -

    26.3 A tour of basic C/C++ wrapping

    +

    28.3 A tour of basic C/C++ wrapping

    By default, SWIG tries to build a very natural Lua interface to your C/C++ code. This section briefly covers the essential aspects of this wrapping.

    -

    26.3.1 Modules

    +

    28.3.1 Modules

    The SWIG module directive specifies the name of the Lua module. If you specify `module example', then everything is wrapped into a Lua table 'example' containing all the functions and variables. When choosing a module name, make sure you don't use the same name as a built-in Lua command or standard module name.

    -

    26.3.2 Functions

    +

    28.3.2 Functions

    Global functions are wrapped as new Lua built-in functions. For example,

    @@ -33726,11 +37685,13 @@ int fact(int n);
    >
    -

    To avoid name collisions, SWIG create a Lua table which it keeps all - the functions and global variables in. It is possible to copy the - functions out of this and into the global environment with the +

    To avoid name collisions, SWIG create a Lua table which keeps all + the functions, constants, classes and global variables in. It is + possible to copy the functions, constants and classes (but not + variables) out of this and into the global environment with the following code. This can easily overwrite existing functions, so this - must be used with care.

    + must be used with care. This option is considered deprecated and will + be removed in the near future.

     > for k,v in pairs(example) do _G[k]=v end
    @@ -33749,7 +37710,7 @@ int fact(int n);
    24
    -

    26.3.3 Global variables

    +

    28.3.3 Global variables

    Global variables (which are linked to C code) are supported, and appear to be just another variable in Lua. However the actual mechanism is more complex. Given a global variable:

    @@ -33851,7 +37812,7 @@ nil

    In general, functions of the form "variable_get()" and "variable_set()" are automatically generated by SWIG for use with -eluac.

    -

    26.3.4 Constants and enums

    +

    28.3.4 Constants and enums

    Because Lua doesn't really have the concept of constants, C/C++ constants are not really constant in Lua. They are actually just a copy of the value into the Lua interpreter. Therefore they can be changed @@ -33894,7 +37855,65 @@ example.SUNDAY=0 Hello World

    -

    26.3.5 Pointers

    +

    28.3.4.1 Constants/enums and classes/structures +

    +

    Enums are exported into a class table. For example, given some + enums:

    +
    +
    %module example
    +enum Days { SUNDAY = 0, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY };
    +struct Test {
    +    enum { TEST1 = 10, TEST2 = 20 };
    +#ifdef __cplusplus // There are no static members in C
    +    static const int ICONST = 12;
    +#endif
    +};
    +
    +
    +

    There is a slight difference in behaviour wrapping C and C++ code + due to the different scoping rules of C and C++. The wrapped C++ code + is used as follows from Lua code:

    +
    +
    +> print(example.SUNDAY)
    +0
    +> print(example.Test.TEST1)
    +10
    +> print(example.Test.ICONST)
    +12
    +
    +
    +

    Enums within a C struct are in the global namespace and are used as + follows from Lua

    +
    +
    +> print(example.SUNDAY)
    +0
    +> -- See the difference here
    +> print(example.TEST1)
    +10
    +
    +
    +

    Compatibility Note: Versions of SWIG prior to SWIG-3.0.0 did + not generate the class table members above. There is no change in the C + wrappers, but the following code was the only way to access these + constants/enums when wrapping C++ member constants:

    +
    +
    +> print(example.Test_TEST1)
    +10
    +> print(example.Test_ICONST)
    +12
    +
    +
    +

    The old-style bindings are still generated in addition to the new + ones. If the -no-old-metatable-bindings option is used, then + these old-style bindings are not generated.

    +

    It is worth mentioning, that example.Test.TEST1 and +example.Test_TEST1 are different entities and changing one does not + change the other. Given the fact that these are constantes and they are + not supposed to be changed, it is up to you to avoid such issues.

    +

    28.3.5 Pointers

    C/C++ pointers are fully supported by SWIG. Furthermore, SWIG has no problem working with incomplete type information. Given a wrapping of the <file.h> interface:

    @@ -33943,7 +37962,7 @@ FILE * -- it's a FILE* nil
    -

    26.3.6 Structures

    +

    28.3.6 Structures

    If you wrap a C structure, it is also mapped to a Lua userdata. By adding a metatable to the userdata, this provides a very natural interface. For example,

    @@ -33966,8 +37985,9 @@ nil

    Similar access is provided for unions and the data members of C++ classes. -
    C structures are created using a function new_Point(), but - for C++ classes are created using just the name Point().

    +
    C structures can be created using a function new_Point(), + and both C structures and C++ classes can be created using just the + name Point().

    If you print out the value of p in the above example, you will see something like this:

    @@ -34060,7 +38080,7 @@ Foo *x = &b->f; // Points inside b "free_struct()" are automatically generated by SWIG for each structure defined in C. (Please note: This doesn't apply for modules generated with the -elua option)

    -

    26.3.7 C++ classes

    +

    28.3.7 C++ classes

    C++ classes are wrapped by a Lua userdata as well. For example, if you have this class,

    @@ -34107,12 +38127,12 @@ public: };
    -

    In Lua, the static members can be accessed as follows:

    +

    In Lua, C++ static members can be accessed as follows:

    -> example.Spam_foo()            -- calling Spam::foo()
    -> a=example.Spam_bar            -- reading Spam::bar 
    -> example.Spam_bar=b            -- writing to Spam::bar
    +> example.Spam.foo()            -- calling Spam::foo()
    +> a=example.Spam.bar            -- reading Spam::bar 
    +> example.Spam.bar=b            -- writing to Spam::bar
     

    It is not (currently) possible to access static members of an @@ -34124,7 +38144,19 @@ public: -- does NOT work

    -

    26.3.8 C++ inheritance

    +

    Compatibility Note: In versions prior to SWIG-3.0.0 only the + following names would work:

    +
    +
    +> example.Spam_foo()            -- calling Spam::foo()
    +> a=example.Spam_bar            -- reading Spam::bar 
    +> example.Spam_bar=b            -- writing to Spam::bar
    +
    +
    +

    Both style names are generated by default now. However, if the +-no-old-metatable-bindings option is used, then the backward + compatible names are not generated in addition to ordinary ones.

    +

    28.3.8 C++ inheritance

    SWIG is fully aware of issues related to C++ inheritance. Therefore, if you have classes like this

    @@ -34145,8 +38177,8 @@ class Bar : public Foo {

    then the function spam() accepts a Foo pointer or a pointer to any class derived from Foo.

    It is safe to use multiple inheritance with SWIG.

    -

    26.3.9 Pointers, references, values, and - arrays

    +

    28.3.9 Pointers, references, values, and arrays +

    In C++, there are many different ways a function might receive and manipulate objects. For example:

    @@ -34184,7 +38216,7 @@ Foo spam7(); release this memory when the return value is garbage collected). The other two are pointers which are assumed to be managed by the C code and so will not be garbage collected.

    -

    26.3.10 C++ overloaded functions

    +

    28.3.10 C++ overloaded functions

    C++ overloaded functions, methods, and constructors are mostly supported by SWIG. For example, if you have two functions like this:

    @@ -34234,8 +38266,8 @@ void spam(short);

    or

    -
    -
    VOID FOO(bAR *B);
    +
    +
    void foo(Bar *b);
     void foo(Bar &b);
     
    @@ -34274,7 +38306,7 @@ void spam(short); // Ignored

    Dealing with the Lua coercion mechanism, the priority is roughly (integers, floats, strings, userdata). But it is better to rename the functions rather than rely upon the ordering.

    -

    26.3.11 C++ operators

    +

    28.3.11 C++ operators

    Certain C++ overloaded operators can be handled automatically by SWIG. For example, consider a class like this:

    @@ -34346,13 +38378,12 @@ Complex operator+(double, const Complex &c);
  • __sub__ operator-
  • __mul__ operator *
  • __div__ operator/
  • -
  • __neg__ unary minus
  • +
  • __unm__ unary minus
  • __call__ operator() (often used in functor classes)
  • __pow__ the exponential fn (no C++ equivalent, Lua uses ^)
  • -
  • __concat__ the concatenation operator (SWIG maps C++'s -~ to Lua's ..)
  • +
  • __concat__ the concatenation operator (Lua's ..)
  • __eq__ operator==
  • __lt__ operator<
  • __le__ operator<=
  • @@ -34409,7 +38440,33 @@ __getitem__() and __setitem__()

    };
    -

    26.3.12 Class extension with %extend

    +

    C++ operators are mapped to Lua predefined metafunctions. Class + inherits from its bases the following list of metafunctions ( thus + inheriting the folloging operators and pseudo-operators):

    +
      +
    • __add__
    • +
    • __sub__
    • +
    • __mul__
    • +
    • __div__
    • +
    • __unm__
    • +
    • __mod__
    • +
    • __call__
    • +
    • __pow__
    • +
    • __concat__
    • +
    • __eq__
    • +
    • __lt__
    • +
    • __le__
    • +
    • __len__
    • +
    • __getitem__
    • +
    • __setitem__
    • +
    • __tostring used internally by Lua for tostring() function. + __str__ is mapped to this function
    • +
    +

    No other lua metafunction is inherited. For example, __gc is not + inherited and must be redefined in every class. __tostring is + subject to a special handling. If absent in class and in class bases, a + default one will be provided by SWIG.

    +

    28.3.12 Class extension with %extend

    One of the more interesting features of SWIG is that it can extend structures and classes with new methods. In the previous section, the Complex class would have benefited greatly from an __str__() method as @@ -34443,7 +38500,7 @@ public: return tmp; } bool operator==(const Complex& c) - { return ($self->re()==c.re() && $self->im()==c.im();} + { return ($self->re()==c.re() && $self->im()==c.im());} };

    @@ -34467,7 +38524,7 @@ true has to use the '$self' instead of 'this', and that you cannot access protected/private members of the code (as you are not officially part of the class).

    -

    26.3.13 Using %newobject to release memory

    +

    28.3.13 Using %newobject to release memory

    If you have a function that allocates memory like this,

    char *foo() {
    @@ -34489,7 +38546,7 @@ char *foo();
     

    This will release the allocated memory.

    -

    26.3.14 C++ templates

    +

    28.3.14 C++ templates

    C++ templates don't present a huge problem for SWIG. However, in order to create wrappers, you have to tell SWIG to create wrappers for a particular template instantiation. To do this, you use the template @@ -34525,7 +38582,7 @@ struct pair {

    Obviously, there is more to template wrapping than shown in this example. More details can be found in the SWIG and C++ chapter. Some more complicated examples will appear later.

    -

    26.3.15 C++ Smart Pointers

    +

    28.3.15 C++ Smart Pointers

    In certain C++ programs, it is common to use classes that have been wrapped by so-called "smart pointers." Generally, this involves the use of a template class that implements operator->() like this:

    @@ -34580,7 +38637,7 @@ operator->() itself, simply use the __deref__() method. > f = p:__deref__() -- Returns underlying Foo *
    -

    26.3.16 C++ Exceptions

    +

    28.3.16 C++ Exceptions

    Lua does not natively support exceptions, but it has errors which are similar. When a Lua function terminates with an error it returns one value back to the caller. SWIG automatically maps any basic type @@ -34721,13 +38778,179 @@ userdata: 0003D880 Exception handling with %catches" section and the " Exception handling with %exception" section, for more details on how to add exception specification to functions or globally (respectively).

    -

    26.4 Typemaps

    +

    28.3.17 Namespaces

    +

    Since SWIG-3.0.0 C++ namespaces are supported via the %nspace + feature.

    +

    Namespaces are mapped into Lua tables. Each of those tables contains + names that were defined within appropriate namespace. Namespaces + structure (a.k.a nested namespaces) is preserved. Consider the + following C++ code:

    +
    +
    %module example
    +%nspace MyWorld::Nested::Dweller;
    +%nspace MyWorld::World;
    +
    +int module_function() { return 7; }
    +int module_variable = 9;
    +
    +namespace MyWorld {
    +  class World {
    +  public:
    +    World() : world_max_count(9) {}
    +    int create_world() { return 17; }
    +    const int world_max_count; // = 9
    +  };
    +  namespace Nested {
    +    class Dweller {
    +      public:
    +        enum Gender { MALE = 0, FEMALE = 1 };
    +        static int count() { return 19; }
    +    };
    +  }
    +}
    +
    +
    +

    Now, from Lua usage is as follows:

    +
    +
    +> print(example.module_function())
    +7
    +> print(example.module_variable)
    +9
    +> print(example.MyWorld.World():create_world())
    +17
    +> print(example.MyWorld.World.world_max_count)
    +9
    +> print(example.MyWorld.Nested.Dweller.MALE)
    +0
    +> print(example.MyWorld.Nested.Dweller.count())
    +19
    +>
    +
    +
    +

    28.3.17.1 Compatibility Note

    +

    If SWIG is running in a backwards compatible way, i.e. without the +-no-old-metatable-bindings option, then additional old-style names + are generated (notice the underscore):

    +
    +
    +9
    +> print(example.MyWorld.Nested.Dweller_MALE)
    +0
    +> print(example.MyWorld.Nested.Dweller_count())
    +11
    +>
    +
    +
    +

    28.3.17.2 Names

    +

    If SWIG is launched without -no-old-metatable-bindings + option, then it enters backward-compatible mode. While in this mode, it + tries to generate additional names for static functions, class static + constants and class enums. Those names are in a form +$classname_$symbolname and are added to the scope surrounding the + class. If %nspace is enabled, then class namespace is taken as scope. + If there is no namespace, or %nspace is disabled, then module is + considered a class namespace.

    +

    Consider the following C++ code

    +
    +
    %module example
    +%nspace MyWorld::Test;
    +namespace MyWorld {
    +class Test {
    +  public:
    +  enum { TEST1 = 10, TEST2 }
    +  static const int ICONST = 12;
    +};
    +class Test2 {
    +  public:
    +  enum { TEST3 = 20, TEST4 }
    +  static const int ICONST2 = 23;
    +}
    +
    +
    +

    When in backward compatible mode, in addition to the usual names, + the following ones will be generated (notice the underscore):

    +
    +
    +9
    +> print(example.MyWorld.Test_TEST1) -- Test has %nspace enabled
    +10
    +> print(example.MyWorld.Test_ICONST) -- Test has %nspace enabled
    +12
    +> print(example.Test2_TEST3) -- Test2 doesn't have %nspace enabled
    +20
    +> print(example.Test2_ICONST2) -- Test2 doesn't have %nspace enabled
    +23
    +>
    +
    +
    +

    There is a slight difference with enums when in C mode. As per C + standard, enums from C structures are exported to surrounding scope + without any prefixing. Pretending that Test2 is a struct, not class, + that would be:

    +
    +
    +> print(example.TEST3) -- NOT Test2_TEST3
    +20
    +>
    +
    +
    +

    28.3.17.3 Inheritance

    +

    The internal organization of inheritance has changed. Consider the + following C++ code:

    +
    +
    %module example
    +class Base {
    +  public:
    +  int base_func()
    +};
    +class Derived : public Base {
    +  public:
    +  int derived_func()
    +}
    +
    +
    +

    Lets assume for a moment that class member functions are stored in +.fn table. Previously, when classes were exported to Lua during + module initialization, for every derived class all service tables +ST(i.e. ".fn") were squashed and added to corresponding derived + class ST: Everything from .fn table of class Base was + copied to .fn table of class Derived and so on. This was a + recursive procedure, so in the end the whole inheritance tree of + derived class was squashed into derived class.

    +

    That means that any changes done to class Base after module + initialization wouldn't affect class Derived:

    +
    +
    +base = example.Base()
    +der = example.Derived()
    +> print(base.base_func)
    +function: 0x1367940
    +> getmetatable(base)[".fn"].new_func = function (x) return x -- Adding new function to class Base (to class, not to an instance!)
    +> print(base.new_func) -- Checking this function
    +function
    +> print(der.new_func) -- Wouldn't work. Derived doesn't check Base any more.
    +nil
    +>
    +
    +
    +

    This behaviour was changed. Now unless -squash-bases option is + provided, Derived store a list of it's bases and if some symbol is not + found in it's own service tables then its bases are searched for it. + Option -squash-bases will effectively return old behaviour.

    +
    +> print(der.new_func) -- Now it works
    +function
    +>
    +
    +

    +

    28.4 Typemaps

    This section explains what typemaps are and how to use them. The default wrapping behaviour of SWIG is enough in most cases. However sometimes SWIG may need a little additional assistance to know which typemap to apply to provide the best wrapping. This section will be explaining how to use typemaps to best effect

    -

    26.4.1 What is a typemap?

    +

    28.4.1 What is a typemap?

    A typemap is nothing more than a code generation rule that is attached to a specific C datatype. For example, to convert integers from Lua to C, you might define a typemap like this:

    @@ -34735,8 +38958,8 @@ Exception handling with %exception" section, for more details on how
    %module example
     
     %typemap(in) int {
    -	$1 = (int) lua_tonumber(L,$input);
    -	printf("Received an integer : %d\n",$1);
    +  $1 = (int) lua_tonumber(L,$input);
    +  printf("Received an integer : %d\n",$1);
     }
     %inline %{
     extern int fact(int n);
    @@ -34761,7 +38984,7 @@ Received an integer : 6
     720
     
    -

    26.4.2 Using typemaps

    +

    28.4.2 Using typemaps

    There are many ready written typemaps built into SWIG for all common types (int, float, short, long, char*, enum and more), which SWIG uses automatically, with no effort required on your part.

    @@ -34824,7 +39047,7 @@ void swap(int *sx, int *sy);

    Note: C++ references must be handled exactly the same way. However SWIG will automatically wrap a const int& as an input parameter (since that it obviously input).

    -

    26.4.3 Typemaps and arrays

    +

    28.4.3 Typemaps and arrays

    Arrays present a challenge for SWIG, because like pointers SWIG does not know whether these are input or output values, nor does SWIG have any indication of how large an array should be. However with the proper @@ -34896,7 +39119,8 @@ t=example.sort_double(t) -- replace t with the result accordingly. Take note of this behaviour if you have a C function which returns indexes.

    Note: SWIG also can support arrays of pointers in a similar manner.

    -

    26.4.4 Typemaps and pointer-pointer functions

    +

    28.4.4 Typemaps and + pointer-pointer functions

    Several C++ libraries use a pointer-pointer functions to create its objects. These functions require a pointer to a pointer which is then filled with the pointer to the new object. Microsoft's COM and DirectX @@ -34935,7 +39159,7 @@ int Create_Math(iMath** pptr); // its creator (assume it mallocs) ptr=nil -- the iMath* will be GC'ed as normal

    -

    26.5 Writing typemaps

    +

    28.5 Writing typemaps

    This section describes how you can modify SWIG's default wrapping behavior for various C/C++ datatypes using the %typemap directive. This is an advanced topic that assumes familiarity with the @@ -34950,7 +39174,7 @@ ptr=nil -- the iMath* will be GC'ed as normal You should not attempt to write your own typemaps until you have read and can understand both of these files (they may well also give you an idea to base your work on).

    -

    26.5.1 Typemaps you can write

    +

    28.5.1 Typemaps you can write

    There are many different types of typemap that can be written, the full list can be found in the "Typemaps" chapter. However the following are the most commonly used ones.

    @@ -34963,7 +39187,7 @@ ptr=nil -- the iMath* will be GC'ed as normal function should be called (the syntax for the typecheck is different from the typemap, see typemaps for details). -

    26.5.2 SWIG's Lua-C API

    +

    28.5.2 SWIG's Lua-C API

    This section explains the SWIG specific Lua-C API. It does not cover the main Lua-C api, as this is well documented and not worth covering.

    int SWIG_ConvertPtr(lua_State* L,int index,void** @@ -35013,10 +39237,10 @@ if (!SWIG_IsOK(SWIG_ConvertPtr( .....)){ type);

    Similar to SWIG_fail_arg, except that it will display the swig_type_info information instead.
    -

    26.6 Customization of your Bindings

    +

    28.6 Customization of your Bindings

    This section covers adding of some small extra bits to your module to add the last finishing touches.

    -

    26.6.1 Writing your own custom wrappers

    +

    28.6.1 Writing your own custom wrappers

    Sometimes, it may be necessary to add your own special functions, which bypass the normal SWIG wrapper method, and just use the native Lua API calls. These 'native' functions allow direct adding of your own @@ -35038,7 +39262,7 @@ int native_function(lua_State*L) // my native code to be added into the module under the name 'my_func'. SWIG will not add any wrapper for this function, beyond adding it into the function table. How you write your code is entirely up to you.

    -

    26.6.2 Adding additional Lua code

    +

    28.6.2 Adding additional Lua code

    As well as adding additional C/C++ code, it's also possible to add your own Lua code to the module as well. This code is executed once all other initialisation, including the %init code has been called.

    @@ -35069,7 +39293,7 @@ int native_function(lua_State*L) // my native code

    Good uses for this feature is adding of new code, or writing helper functions to simplify some of the code. See Examples/lua/arrays for an example of this code.

    -

    26.7 Details on the Lua binding

    +

    28.7 Details on the Lua binding

    In the previous section, a high-level view of Lua wrapping was presented. Obviously a lot of stuff happens behind the scenes to make this happen. This section will explain some of the low-level details on @@ -35078,7 +39302,7 @@ int native_function(lua_State*L) // my native code stop reading here. This is going into the guts of the code and how it works. It's mainly for people who need to know what's going on within the code.

    -

    26.7.1 Binding global data into the module.

    +

    28.7.1 Binding global data into the module.

    Assuming that you had some global data that you wanted to share between C and Lua. How does SWIG do it?

    @@ -35148,7 +39372,7 @@ end 'Foo_get()'. Similarly for the code 'example.Foo=10', the interpreter will check the table, then call the __newindex which will then check the '.set' table and call the C function 'Foo_set(10)'.

    -

    26.7.2 Userdata and Metatables

    +

    28.7.2 Userdata and Metatables

    As mentioned earlier, classes and structures, are all held as pointer, using the Lua 'userdata' structure. This structure is actually a pointer to a C structure 'swig_lua_userdata', which contains the @@ -35246,7 +39470,7 @@ end The current implementation is a bit rough as it will add any member function beginning with '__' into the metatable too, assuming its an operator overload.

    -

    26.7.3 Memory management

    +

    28.7.3 Memory management

    Lua is very helpful with the memory management. The 'swig_lua_userdata' is fully managed by the interpreter itself. This means that neither the C code nor the Lua code can damage it. Once a @@ -35267,7 +39491,7 @@ end the data (unlike most other scripting languages, Lua does not permit access to the data from within the interpreter).


    -

    27 SWIG and Modula-3

    +

    29 SWIG and Modula-3

    @@ -35309,10 +39533,10 @@ end
    -

    This chapter describes SWIG's support of +

    This chapter describes SWIG's support for Modula-3. You should be familiar with the basics of SWIG, especially typemaps.

    -

    27.1 Overview

    +

    29.1 Overview

    Modula-3 is a compiled language in the tradition of Niklaus Wirth's Modula 2, which is in turn a successor to Pascal.

    SWIG's Modula-3 support is currently very basic and highly @@ -35326,7 +39550,7 @@ Modula-3. You should be familiar with the basics

  • FFTW
  • -

    27.1.1 Motivation

    +

    29.1.1 Motivation

    Although it is possible to write Modula-3 code that performs as well as C/C++ most existing libraries are not written in Modula-3 but in C or C++, and even libraries in other languages may provide C header @@ -35340,21 +39564,21 @@ Modula-3. You should be familiar with the basics typemaps you can pass TEXTs or open arrays, and convert error return codes into exceptions.

    If the library API is ill designed writing appropriate typemaps can - be still time-consuming. E.g. C programmers are very creative to + still be time-consuming. E.g. C programmers are very creative to work-around missing data types like (real) enumerations and sets. You should turn such work-arounds back to the Modula-3 way otherwise you lose static safety and consistency.

    Without SWIG you would probably never consider trying to call C++ libraries from Modula-3, but with SWIG this is becomes feasible. SWIG can generate C wrappers to C++ functions and object methods that may - throw exceptions, and then wrap these C wrappers for Module-3. To make + throw exceptions, and then wrap these C wrappers for Modula-3. To make it complete you can then hide the C interface with Modula-3 classes and exceptions.

    SWIG allows you to call C and C++ libraries from Modula-3 (even with call back functions), but it doesn't allow you to easily integrate a - Module-3 module into a C/C++ project.

    -

    27.2 Conception

    -

    27.2.1 Interfaces to C libraries

    + Modula-3 module into a C/C++ project.

    +

    29.2 Conception

    +

    29.2.1 Interfaces to C libraries

    Modula-3 has integrated support for calling C functions. This is also extensively used by the standard Modula-3 libraries to call OS functions. The Modula-3 part of SWIG and the corresponding SWIG library @@ -35429,8 +39653,8 @@ Database, it is good Modula-3 style to set up one Module with the (different SWIG interfaces can share common data) per module. Identifiers belonging to a different module may ignored (%ignore ) and the principal type must be renamed (%typemap).

    -

    27.2.2 Interfaces to C++ - libraries

    +

    29.2.2 Interfaces to C++ libraries +

    Interfaces to C++ files are much more complicated and there are some more design decisions that are not made, yet. Modula-3 has no support for C++ functions but C++ compilers should support generating C++ @@ -35477,14 +39701,14 @@ C++ library

    Be warned: There is no C++ library I wrote a SWIG interface for, so I'm not sure if this is possible or sensible, yet.

    -

    27.3 Preliminaries

    -

    27.3.1 Compilers

    +

    29.3 Preliminaries

    +

    29.3.1 Compilers

    There are different Modula-3 compilers around: cm3, pm3, ezm3, Klagenfurth Modula-3, Cambridge Modula-3. SWIG itself does not contain compiler specific code but the modula3.swg library file may do so. For testing examples I use Critical Mass cm3.

    -

    27.3.2 Additional Commandline - Options

    +

    29.3.2 Additional Commandline Options +

    There are some experimental command line options that prevent SWIG from generating interface files. Instead files are emitted that may assist you when writing SWIG interface files.

    @@ -35523,8 +39747,8 @@ C++ library of interfaces and wrappers. Instead generate templates for some basic typemaps. -

    27.4 Modula-3 typemaps

    -

    27.4.1 Inputs and outputs

    +

    29.4 Modula-3 typemaps

    +

    29.4.1 Inputs and outputs

    Each C procedure has a bunch of inputs and outputs. Inputs are passed as function arguments, outputs are updated referential arguments and the function value.

    @@ -35603,7 +39827,7 @@ C++ library step should never be skipped, SWIG will put it in the FINALLY branch of a TRY .. FINALLY structure. -

    27.4.2 Subranges, Enumerations, Sets

    +

    29.4.2 Subranges, Enumerations, Sets

    Subranges, enumerations, and sets are machine oriented types that make Modula very strong and expressive compared with the type systems of many other languages.

    @@ -35628,12 +39852,12 @@ s that split the task up into converting the C bit patterns (integer or satisfying. So the best what you can currently do is to rewrite constant definitions manually. Though this is a tedious work that I'd like to automate.

    -

    27.4.3 Objects

    +

    29.4.3 Objects

    Declarations of C++ classes are mapped to OBJECT types while it is tried to retain the access hierarchy "public - protected - private" using partial revelation. Though the example in Examples/modula3/class/example.i is not really useful, yet.

    -

    27.4.4 Imports

    +

    29.4.4 Imports

    Pieces of Modula-3 code provided by typemaps may contain identifiers from foreign modules. If the typemap m3wrapinconv for blah * contains code using the function M3toC.SharedTtoS you @@ -35653,7 +39877,7 @@ IMPORT M3toC; %}

    -

    27.4.5 Exceptions

    +

    29.4.5 Exceptions

    Modula-3 provides another possibility of an output of a function: exceptions.

    Any piece of Modula-3 code that SWIG inserts due to a typemap can @@ -35664,7 +39888,7 @@ throws extension. If the typemap m3wrapinconv for blah * contains code that may raise the exceptions OSError.E you should declare %typemap("m3wrapinconv:throws") blah * %{OSError.E%}.

    -

    27.4.6 Example

    +

    29.4.6 Example

    The generation of wrappers in Modula-3 needs very fine control to take advantage of the language features. Here is an example of a generated wrapper where almost everything is generated by a typemap:

    @@ -35705,8 +39929,8 @@ throws extension. If the typemap m3wrapinconv for blah END Name; -

    27.5 More hints to the generator

    -

    27.5.1 Features

    +

    29.5 More hints to the generator

    +

    29.5.1 Features

    FeatureExampleDescription
    multiretval%m3multiretval get_box; or @@ -35725,7 +39949,7 @@ multiretval feature activated, but it is explicitly requested from option. In future it may be generalized to other kind of values such as strings.
    -

    27.5.2 Pragmas

    +

    29.5.2 Pragmas

    PragmaExampleDescription
    unsafe%pragma(modula3) unsafe="true"; @@ -35735,16 +39959,14 @@ Mark the raw interface modules as UNSAFE. This will be Specifies the library name for the wrapper library to be created. It should be distinct from the name of the library to be wrapped.
    -

    27.6 Remarks

    +

    29.6 Remarks

    • The Modula-3 part of SWIG doesn't try to generate nicely formatted code. If you need to read the generated code, use m3pp to postprocess the Modula files.

    - - -

    28 SWIG and MzScheme/Racket

    +

    30 SWIG and MzScheme/Racket

    @@ -35757,7 +39979,7 @@ Specifies the library name for the wrapper library to be created. It

    This section contains information on SWIG's support of Racket, formally known as MzScheme.

    -

    28.1 Creating native structures

    +

    30.1 Creating native structures

    Example interface file:

    @@ -35780,15 +40002,15 @@ handle_ptr(struct diag_cntrs, cntrs);
     

    Then in scheme, you can use regular struct access procedures like

    -	; suppose a function created a struct foo as 
    -	; (define foo (make-diag-cntrs (#x1 #x2 #x3) (make-inspector))
    -	; Then you can do
    -	(format "0x~x" (diag-cntrs-field1 foo))
    -	(format "0x~x" (diag-cntrs-field2 foo))
    -	;etc...
    +        ; suppose a function created a struct foo as
    +        ; (define foo (make-diag-cntrs (#x1 #x2 #x3) (make-inspector))
    +        ; Then you can do
    +        (format "0x~x" (diag-cntrs-field1 foo))
    +        (format "0x~x" (diag-cntrs-field2 foo))
    +        ;etc...
     
    -

    28.2 Simple example

    +

    30.2 Simple example

    A few examples are available in the Examples/mzscheme directory. The code and log of a session using SWIG below should help getting started.

    C header file:

    @@ -35879,7 +40101,7 @@ Welcome to MzScheme v4.2.4 [3m], Copyright (c) 2004-2010 PLT Scheme Inc. better performance, but work is still required for SWIG to emit code which is compatible with it. -

    28.3 External documentation

    +

    30.3 External documentation

    See the C API for more description of using the mechanism for adding extensions. The main documentation is @@ -35887,8 +40109,7 @@ here.

    Tip: mzc's --vv option is very useful for debugging the inevitable library problems you'll encounter.


    - -

    29 SWIG and Ocaml

    +

    31 SWIG and Ocaml

    -

    This chapter describes SWIG's support of Ocaml. Ocaml is a - relatively recent addition to the ML family, and is a recent addition - to SWIG. It's the second compiled, typed language to be added. Ocaml - has widely acknowledged benefits for engineers, mostly derived from a - sophisticated type system, compile-time checking which eliminates - several classes of common programming errors, and good native - performance. While all of this is wonderful, there are well-written C - and C++ libraries that Ocaml users will want to take advantage of as - part of their arsenal (such as SSL and gdbm), as well as their own - mature C and C++ code. SWIG allows this code to be used in a natural, - type-safe way with Ocaml, by providing the necessary, but repetitive - glue code which creates and uses Ocaml values to communicate with C and - C++ code. In addition, SWIG also produces the needed Ocaml source that - binds variants, functions, classes, etc.

    +

    This chapter describes SWIG's support of Ocaml.

    +

    Ocaml is a relatively recent addition to the ML family, and is a + recent addition to SWIG. It's the second compiled, typed language to be + added. Ocaml has widely acknowledged benefits for engineers, mostly + derived from a sophisticated type system, compile-time checking which + eliminates several classes of common programming errors, and good + native performance. While all of this is wonderful, there are + well-written C and C++ libraries that Ocaml users will want to take + advantage of as part of their arsenal (such as SSL and gdbm), as well + as their own mature C and C++ code. SWIG allows this code to be used in + a natural, type-safe way with Ocaml, by providing the necessary, but + repetitive glue code which creates and uses Ocaml values to communicate + with C and C++ code. In addition, SWIG also produces the needed Ocaml + source that binds variants, functions, classes, etc.

    If you're not familiar with the Objective Caml language, you can - visit The Ocaml Website.

    -

    29.1 Preliminaries

    -

    SWIG 1.3 works with Ocaml 3.04 and above. Given the choice, you + visit The Ocaml Website.

    +

    31.1 Preliminaries

    +

    SWIG 3.0 works with Ocaml 3.08.3 and above. Given the choice, you should use the latest stable release. The SWIG Ocaml module has been tested on Linux (x86,PPC,Sparc) and Cygwin on Windows. The best way to determine whether your system will work is to compile the examples and @@ -35971,26 +40192,26 @@ here.

    check
    from the SWIG root directory after installing SWIG. The Ocaml module has been tested using the system's dynamic linking (the usual -lxxx against libxxx.so, as well as with Gerd Stolpmann's -Dl package . The ocaml_dynamic and ocaml_dynamic_cpp targets in the +Dl package. The ocaml_dynamic and ocaml_dynamic_cpp targets in the file Examples/Makefile illustrate how to compile and link SWIG modules that will be loaded dynamically. This has only been tested on Linux so far.

    -

    29.1.1 Running SWIG

    +

    31.1.1 Running SWIG

    The basics of getting a SWIG Ocaml module up and running can be seen from one of SWIG's example Makefiles, but is also described here. To build an Ocaml module, run SWIG using the -ocaml option.

     %swig -ocaml example.i
    -  
    +
    -

    This will produce 3 files. The file example_wrap.c contains +

    This will produce 3 files. The file example_wrap.c contains all of the C code needed to build an Ocaml module. To build the module, you will compile the file example_wrap.c with ocamlc or ocamlopt to create the needed .o file. You will need to compile the resulting .ml and .mli files as well, and do the final link with -custom (not needed for native link).

    -

    29.1.2 Compiling the code

    +

    31.1.2 Compiling the code

    The OCaml SWIG module now requires you to compile a module (Swig ) separately. In addition to aggregating common SWIG functionality, the Swig module contains the data structure that represents C/C++ values. @@ -36007,23 +40228,22 @@ Dl package . The ocaml_dynamic and ocaml_dynamic_cpp targets in the % ocamlc -c -ccopt "-I/usr/include/foo" example_wrap.c % ocamlc -c example.mli % ocamlc -c example.ml - +

    -

    ocamlc is aware of .c files and knows how to handle them. +

    ocamlc is aware of .c files and knows how to handle them. Unfortunately, it does not know about .cxx, .cc, or .cpp files, so when SWIG is invoked in C++ mode, you must:

     % cp example_wrap.cxx example_wrap.cxx.c
    -
    % ocamlc -c ... -ccopt -xc++ example_wrap.cxx.c -
    % ... -
    -
    +% ocamlc -c ... -ccopt -xc++ example_wrap.cxx.c +% ... +
    -

    29.1.3 The camlp4 module

    +

    31.1.3 The camlp4 module

    The camlp4 module (swigp4.ml -> swigp4.cmo) contains a simple rewriter which makes C++ code blend more seamlessly with objective caml - code. It's use is optional, but encouraged. The source file is included + code. Its use is optional, but encouraged. The source file is included in the Lib/ocaml directory of the SWIG source distribution. You can checkout this file with "swig -ocaml -co swigp4.ml". You should compile the file with "ocamlc -I `camlp4 -where` -pp @@ -36068,28 +40288,27 @@ Dl package . The ocaml_dynamic and ocaml_dynamic_cpp targets in the (_atoi (C_string "2"))
    let b = C_string (getenv "PATH") -

    29.1.4 Using your module

    +

    31.1.4 Using your module

    You can test-drive your module by building a toplevel ocaml interpreter. Consult the ocaml manual for details.

    When linking any ocaml bytecode with your module, use the -custom option to build your functions into the primitive list. This option is not needed when you build native code.

    -

    29.1.5 Compilation problems and compiling - with C++

    +

    31.1.5 Compilation problems and compiling with + C++

    As mentioned above, .cxx files need special handling to be compiled with ocamlc. Other than that, C code that uses class as a non-keyword, and C code that is too liberal with pointer types may not compile under the C++ compiler. Most code meant to be compiled as C++ will not have problems.

    -

    29.2 The low-level Ocaml/C interface

    +

    31.2 The low-level Ocaml/C interface

    In order to provide access to overloaded functions, and provide sensible outputs from them, all C entities are represented as members of the c_obj type:

    In the code as seen by the typemap writer, there is a value, swig_result, that always contains the current return data. It is a list, and must be appended with the caml_list_append function, or with - functions and macros provided by objective caml. -

    + functions and macros provided by objective caml.

     type c_obj =
    @@ -36115,13 +40334,12 @@ type c_obj =
     

    A few functions exist which generate and return these:

      -
    • caml_ptr_val receives a c_obj and returns a void *.  This should be +
    • caml_ptr_val receives a c_obj and returns a void *. This should be used for all pointer purposes.
    • -
    • caml_long_val receives a c_obj and returns a long.  This should be - used for most integral purposes. -
    • +
    • caml_long_val receives a c_obj and returns a long. This should be + used for most integral purposes.
    • caml_val_ptr receives a void * and returns a c_obj.
    • -
    • caml_val_bool receives a C int and returns a c_obj representing it's +
    • caml_val_bool receives a C int and returns a c_obj representing its bool value.
    • caml_val_(u)?(char|short|int|long|float|double) receives an appropriate C value and returns a c_obj representing it.
    • @@ -36132,18 +40350,18 @@ type c_obj = C_obj, which contains a closure giving method access.

    Because of this style, a typemap can return any kind of value it - wants from a function.  This enables out typemaps and inout typemaps to - work well.  The one thing to remember about outputting values is that + wants from a function. This enables out typemaps and inout typemaps to + work well. The one thing to remember about outputting values is that you must append them to the return list with swig_result = caml_list_append(swig_result,v).

    -

     This function will return a new list that has your element - appended. Upon return to caml space, the fnhelper function beautifies - the result. A list containing a single item degrades to only that item - (i.e. [ C_int 3 ] -> C_int 3), and a list containing more than one item - is wrapped in C_list (i.e. [ C_char 'a' ; C_char 'b' -> C_list [ C_char - 'a' ; C_char b ]).  This is in order to make return values easier to +

    This function will return a new list that has your element appended. + Upon return to caml space, the fnhelper function beautifies the result. + A list containing a single item degrades to only that item (i.e. [ + C_int 3 ] -> C_int 3), and a list containing more than one item is + wrapped in C_list (i.e. [ C_char 'a' ; C_char 'b' -> C_list [ C_char + 'a' ; C_char b ]). This is in order to make return values easier to handle when functions have only one return value, such as constructors, - and operators.  In addition, string, pointer, and object values are + and operators. In addition, string, pointer, and object values are interchangeable with respect to caml_ptr_val, so you can allocate memory as caml strings and still use the resulting pointers for C purposes, even using them to construct simple objects on. Note, though, @@ -36151,7 +40369,7 @@ type c_obj = the SWIG interface does.

    The wild card type that you can use in lots of different ways is C_obj. It allows you to wrap any type of thing you like as an object - using the same mechanism that the ocaml module does.  When evaluated in + using the same mechanism that the ocaml module does. When evaluated in caml_ptr_val, the returned value is the result of a call to the object's "&" operator, taken as a pointer.

    You should only construct values using objective caml, or using the @@ -36160,7 +40378,7 @@ type c_obj = provide everything a typemap needs to produce values. In addition, value items pass through directly, but you must make your own type signature for a function that uses value in this way.

    -

    29.2.1 The generated module

    +

    31.2.1 The generated module

    The SWIG %module directive specifies the name of the Ocaml module to be generated. If you specified `%module example', then your Ocaml code will be accessible in the module Example. The @@ -36186,12 +40404,12 @@ type c_obj = because it describes the output SWIG will generate for class definitions. -

    29.2.2 Enums

    +

    31.2.2 Enums

    SWIG will wrap enumerations as polymorphic variants in the output - Ocaml code, as above in C_enum.  In order to support all C++-style uses + Ocaml code, as above in C_enum. In order to support all C++-style uses of enums, the function int_to_enum and enum_to_int are provided for - ocaml code to produce and consume these values as integers.  Other than - that, correct uses of enums will not have a problem.  Since enum labels + ocaml code to produce and consume these values as integers. Other than + that, correct uses of enums will not have a problem. Since enum labels may overlap between enums, the enum_to_int and int_to_enum functions take an enum type label as an argument. Example:

    @@ -36225,7 +40443,7 @@ val enum_to_int c_enum_type -> c_obj -> c_obj
     bash-2.05a$ ocamlmktop -custom enum_test_wrap.o enum_test.cmo -o enum_test_top
    -bash-2.05a$ ./enum_test_top 
    +bash-2.05a$ ./enum_test_top
             Objective Caml version 3.04
     
     # open Enum_test ;;
    @@ -36237,7 +40455,7 @@ val x : Enum_test.c_obj = C_enum `a
     - : Enum_test.c_obj = C_enum `c
     
    -

    29.2.2.1 Enum typing in Ocaml

    +

    31.2.2.1 Enum typing in Ocaml

    The ocaml SWIG module now has support for loading and using multiple SWIG modules at the same time. This enhances modularity, but presents problems when used with a language which assumes that each module's @@ -36246,8 +40464,8 @@ val x : Enum_test.c_obj = C_enum `a values are shared between functions imported from different modules. You must convert values to master values using the swig_val function before sharing them with another module.

    -

    29.2.3 Arrays

    -

    29.2.3.1 Simple types of bounded arrays

    +

    31.2.3 Arrays

    +

    31.2.3.1 Simple types of bounded arrays

    SWIG has support for array types, but you generally will need to provide a typemap to handle them. You can currently roll your own, or expand some of the macros provided (but not included by default) with @@ -36257,7 +40475,7 @@ val x : Enum_test.c_obj = C_enum `a

    %make_simple_array_typemap is the easiest way to get access to arrays of simple types with known bounds in your code, but this only works for arrays whose bounds are completely specified.

    -

    29.2.3.2 Complex and unbounded arrays

    +

    31.2.3.2 Complex and unbounded arrays

    Unfortunately, unbounded arrays and pointers can't be handled in a completely general way by SWIG, because the end-condition of such an array can't be predicted. In some cases, it will be by consent (e.g. an @@ -36265,15 +40483,15 @@ val x : Enum_test.c_obj = C_enum `a *buffer, int len), and sometimes by sentinel value (0,-1,etc.). SWIG can't predict which of these methods will be used in the array, so you have to specify it for yourself in the form of a typemap.

    -

    29.2.3.3 Using an object

    +

    31.2.3.3 Using an object

    It's possible to use C++ to your advantage by creating a simple object that provides access to your array. This may be more desirable in some cases, since the object can provide bounds checking, etc., that prevents crashes.

    Consider writing an object when the ending condition of your array is complex, such as using a required sentinel, etc.

    -

    29.2.3.4 Example typemap for a function - taking float * and int

    +

    31.2.3.4 Example typemap for a function taking + float * and int

    This is a simple example in typemap for an array of float, where the length of the array is specified as an extra parameter. Other such typemaps will work similarly. In the example, the function @@ -36292,24 +40510,24 @@ val x : Enum_test.c_obj = C_enum `a #include <stdio.h> void printfloats( float *tab, int len ) { - int i; + int i; - for( i = 0; i < len; i++ ) { - printf( "%f ", tab[i] ); - } + for( i = 0; i < len; i++ ) { + printf( "%f ", tab[i] ); + } - printf( "\n" ); + printf( "\n" ); } %} %typemap(in) (float *tab, int len) { - int i; - /* $*1_type */ - $2 = caml_array_len($input); - $1 = ($*1_type *)malloc( $2 * sizeof( float ) ); - for( i = 0; i < $2; i++ ) { - $1[i] = caml_double_val(caml_array_nth($input,i)); - } + int i; + /* $*1_type */ + $2 = caml_array_len($input); + $1 = ($*1_type *)malloc( $2 * sizeof( float ) ); + for( i = 0; i < $2; i++ ) { + $1[i] = caml_double_val(caml_array_nth($input,i)); + } } void printfloats( float *tab, int len ); @@ -36325,14 +40543,14 @@ void printfloats( float *tab, int len ); -

    29.2.4 C++ Classes

    +

    31.2.4 C++ Classes

    C++ classes, along with structs and unions are represented by C_obj - (string -> c_obj -> c_obj) wrapped closures.  These objects contain a + (string -> c_obj -> c_obj) wrapped closures. These objects contain a method list, and a type, which allow them to be used like C++ objects. When passed into typemaps that use pointers, they degrade to pointers - through their "&" method.  Every method an object has is represented as + through their "&" method. Every method an object has is represented as a string in the object's method table, and each method table exists in - memory only once.  In addition to any other operators an object might + memory only once. In addition to any other operators an object might have, certain builtin ones are provided by SWIG: (all of these take no arguments (C_void))

    @@ -36358,7 +40576,7 @@ void printfloats( float *tab, int len );

    Note that this string belongs to the wrapper object, and not the underlying pointer, so using create_[x]_from_ptr alters the returned value for the same object.

    -

    29.2.4.1 STL vector and string Example

    +

    31.2.4.1 STL vector and string Example

    Standard typemaps are now provided for STL vector and string. More are in the works. STL strings are passed just like normal strings, and returned as strings. STL string references don't mutate the original @@ -36379,7 +40597,7 @@ void printfloats( float *tab, int len ); %include <stl.i> namespace std { - %template(StringVector) std::vector < string >; + %template(StringVector) std::vector < string >; }; %include "example.h" @@ -36395,7 +40613,7 @@ namespace std { camlp4 module.

    -bash-2.05a$ ./example_top 
    +bash-2.05a$ ./example_top
             Objective Caml version 3.06
     
             Camlp4 Parsing version 3.06
    @@ -36423,17 +40641,17 @@ C_list
     - : Example.c_obj = C_void
     # x '[1] ;;
     - : Example.c_obj = C_string "spam"
    -# for i = 0 to (x -> size() as int) - 1 do 
    -    print_endline ((x '[i to int]) as string) 
    +# for i = 0 to (x -> size() as int) - 1 do
    +    print_endline ((x '[i to int]) as string)
       done ;;
     foo
     bar
     baz
     - : unit = ()
    -# 
    +#
     
    -

    29.2.4.2 C++ Class Example

    +

    31.2.4.2 C++ Class Example

    Here's a simple example using Trolltech's Qt Library:

    @@ -36448,30 +40666,30 @@ baz %} class QApplication { public: - QApplication( int argc, char **argv ); - void setMainWidget( QWidget *widget ); - void exec(); + QApplication( int argc, char **argv ); + void setMainWidget( QWidget *widget ); + void exec(); }; class QPushButton { public: - QPushButton( char *str, QWidget *w ); - void resize( int x, int y ); - void show(); + QPushButton( char *str, QWidget *w ); + void resize( int x, int y ); + void show(); };
    -

    29.2.4.3 Compiling the example

    +

    31.2.4.3 Compiling the example

     bash-2.05a$ QTPATH=/your/qt/path
     bash-2.05a$ for file in swig.mli swig.ml swigp4.ml ; do swig -ocaml -co $file ; done
     bash-2.05a$ ocamlc -c swig.mli ; ocamlc -c swig.ml
     bash-2.05a$ ocamlc -I `camlp4 -where` -pp "camlp4o pa_extend.cmo q_MLast.cmo" -c swigp4.ml
    -bash-2.05a$ swig -ocaml -c++ -I$QTPATH/include  qt.i
    +bash-2.05a$ swig -ocaml -c++ -I$QTPATH/include qt.i
     bash-2.05a$ mv qt_wrap.cxx qt_wrap.c
    -bash-2.05a$ ocamlc -c -ccopt -xc++ -ccopt -g -g -ccopt -I$QTPATH/include qt_wrap.c 
    +bash-2.05a$ ocamlc -c -ccopt -xc++ -ccopt -g -g -ccopt -I$QTPATH/include qt_wrap.c
     bash-2.05a$ ocamlc -c qt.mli
     bash-2.05a$ ocamlc -c qt.ml
     bash-2.05a$ ocamlmktop -custom swig.cmo -I `camlp4 -where` \
    @@ -36479,10 +40697,10 @@ bash-2.05a$ ocamlmktop -custom swig.cmo -I `camlp4 -where` \
       -L$QTPATH/lib -cclib -lqt
     
    -

    29.2.4.4 Sample Session

    +

    31.2.4.4 Sample Session

    -bash-2.05a$ ./qt_top 
    +bash-2.05a$ ./qt_top
             Objective Caml version 3.06
     
             Camlp4 Parsing version 3.06
    @@ -36502,8 +40720,8 @@ val hello : Qt.c_obj = C_obj <fun>
     

    Assuming you have a working installation of QT, you will see a window containing the string "hi" in a button.

    -

    29.2.5 Director Classes

    -

    29.2.5.1 Director Introduction

    +

    31.2.5 Director Classes

    +

    31.2.5.1 Director Introduction

    Director classes are classes which allow Ocaml code to override the public methods of a C++ object. This facility allows the user to use C++ libraries that require a derived class to provide application @@ -36524,7 +40742,7 @@ class foo { };

    -

    29.2.5.2 Overriding Methods in Ocaml

    +

    31.2.5.2 Overriding Methods in Ocaml

    Because the Ocaml language module treats C++ method calls as calls to a certain function, all you need to do is to define the function that will handle the method calls in terms of the public methods of the @@ -36544,7 +40762,7 @@ new_derived_object uses a stub class to call your methods in place

    In this example, I'll examine the objective caml code involved in providing an overloaded class. This example is contained in Examples/ocaml/shapes.

    -

    29.2.5.3 Director Usage Example

    +

    31.2.5.3 Director Usage Example

    example_prog.ml
    @@ -36561,14 +40779,14 @@ let triangle_class pts ob meth args = "cover" -> (match args with C_list [ x_arg ; y_arg ] -> - let xa = x_arg as float - and ya = y_arg as float in - (point_in_triangle pts xa ya) to bool + let xa = x_arg as float + and ya = y_arg as float in + (point_in_triangle pts xa ya) to bool | _ -> raise (Failure "cover needs two double arguments.")) | _ -> (invoke ob) meth args ;; let triangle = - new_derived_object + new_derived_object new_shape (triangle_class ((0.0,0.0),(0.5,1.0),(1.0,0.0))) '() ;; @@ -36598,13 +40816,13 @@ let _ = _draw_shape_coverage '(triangle, C_int 60, C_int 20) ;; returns bool). This might allow a tricky shape implementation, such as a boolean combination, to be expressed in a more effortless style in ocaml, while leaving the "engine" part of the program in C++.

    -

    29.2.5.4 Creating director objects

    +

    31.2.5.4 Creating director objects

    The definition of the actual object triangle can be described this way:

     let triangle =
    -  new_derived_object 
    +  new_derived_object
         new_shape
         (triangle_class ((0.0,0.0),(0.5,1.0),(1.0,0.0)))
         '()
    @@ -36631,28 +40849,28 @@ let triangle =
      actual raise is from an inner function used by new_derived_object, and
      throws NotObject). This prevents a deleted C++ object from causing a
      core dump, as long as the object is destroyed properly.

    -

    29.2.5.5 Typemaps for directors, -directorin, directorout, directorargout

    +

    31.2.5.5 Typemaps for directors, directorin, + directorout, directorargout

    Special typemaps exist for use with directors, the directorin, directorout, directorargout are used in place of in, out, argout typemaps, except that their direction is reversed. They provide for you to provide argout values, as well as a function return value in the same way you provide function arguments, and to receive arguments the same way you normally receive function returns.

    -

    29.2.5.6 directorin typemap

    +

    31.2.5.6 typemap

    The directorin typemap is used when you will receive arguments from a call made by C++ code to you, therefore, values will be translated from C++ to ocaml. You must provide some valid C_obj value. This is the value your ocaml code receives when you are called. In general, a simple directorin typemap can use the same body as a simple out typemap.

    -

    29.2.5.7 directorout typemap

    +

    31.2.5.7 directorout typemap

    The directorout typemap is used when you will send an argument from your code back to the C++ caller. That is; directorout specifies a function return conversion. You can usually use the same body as an in typemap for the same type, except when there are special requirements for object ownership, etc.

    -

    29.2.5.8 directorargout typemap

    +

    31.2.5.8 directorargout typemap

    C++ allows function arguments which are by pointer (*) and by reference (&) to receive a value from the called function, as well as sending one there. Sometimes, this is the main purpose of the argument @@ -36666,13 +40884,13 @@ directorin, directorout, directorargout typemaps. In the event that you don't specify all of the necessary values, integral values will read zero, and struct or object returns have undefined results.

    -

    29.2.6 Exceptions

    +

    31.2.6 Exceptions

    Catching exceptions is now supported using SWIG's %exception feature. A simple but not too useful example is provided by the throw_exception testcase in Examples/test-suite. You can provide your own exceptions, too.


    -

    30 SWIG and Octave

    +

    32 SWIG and Octave

    @@ -36698,7 +40916,13 @@ directorin, directorout, directorargout
  • C++ operators
  • Class extension with %extend
  • C++ templates
  • -
  • C++ Smart Pointers
  • +
  • C++ Smart Pointers + +
  • Directors (calling Octave from C++ code)
  • Threads
  • Memory management
  • @@ -36717,12 +40941,13 @@ directorin, directorout, directorargout specific to Octave. Also, there are a dozen or so examples in the Examples/octave directory, and hundreds in the test suite (Examples/test-suite and Examples/test-suite/octave).

    -

    30.1 Preliminaries

    -

    As of SWIG 3.0.0, the Octave module has been tested with Octave - versions 3.0.5, 3.2.4, 3.4.3, 3.6.4, and 3.8.0. Use of Octave versions - older than 3.x.x is not recommended, as these versions are no longer - tested with SWIG.

    -

    30.2 Running SWIG

    +

    32.1 Preliminaries

    +

    As of SWIG 3.0.7, the Octave module is regularly tested with Octave + versions 3.2.4, 3.8.1, and 4.0.0. Use of older Octave versions is not + recommended, as these versions are no longer tested with SWIG. The SWIG + runtime exports the function swig_octave_prereq() for checking + the version of Octave.

    +

    32.2 Running SWIG

    Let's start with a very simple SWIG interface file, example.i:

    @@ -36748,7 +40973,7 @@ extern double Foo; 
    source file contains the low-level wrappers that need to be compiled and linked with the rest of your C/C++ application (in this case, the gcd implementation) to create an extension module.

    -

    30.2.1 Command-line options

    +

    32.2.1 Command-line options

    The swig command line has a number of options you can use, like to redirect its output. Use swig -help to learn about these. Options specific to the Octave module are:

    @@ -36767,7 +40992,7 @@ Octave Options (available with -octave) i.e. alongside C functions and structs exported by the module. The -opprefix options sets the prefix of the names of global/friend operator functions.

    -

    30.2.2 Compiling a dynamic module

    +

    32.2.2 Compiling a dynamic module

    Octave modules are DLLs/shared objects having the ".oct" suffix. Building an oct file is usually done with the mkoctfile command (either within Octave itself, or from the shell). For example,

    @@ -36787,7 +41012,7 @@ $ mkoctfile example_wrap.cpp example.c
    octave:1> swigexample
    -

    30.2.3 Using your module

    +

    32.2.3 Using your module

    Assuming all goes well, you will be able to do this:

    @@ -36801,8 +41026,8 @@ octave:4> swigexample.cvar.Foo=4; octave:5> swigexample.cvar.Foo ans = 4
    -

    30.3 A tour of basic C/C++ wrapping

    -

    30.3.1 Modules

    +

    32.3 A tour of basic C/C++ wrapping

    +

    32.3.1 Modules

    The SWIG module directive specifies the name of the Octave module. If you specify "module swigexample", then in Octave everything in the module will be accessible under "swigexample", as in the above example. @@ -36844,7 +41069,7 @@ octave:4> swigexample.gcd(4,6) ans = 2 -

    30.3.2 Functions

    +

    32.3.2 Functions

    Global functions are wrapped as new Octave built-in functions. For example,

    @@ -36857,7 +41082,7 @@ int fact(int n);
    octave:1> swigexample.fact(4)
     24 
    -

    30.3.3 Global variables

    +

    32.3.3 Global variables

    Global variables are a little special in Octave. Given a global variable:

    @@ -36910,7 +41135,7 @@ octave:2> swigexample.PI=3.142; octave:3> swigexample.PI ans = 3.1420
    -

    30.3.4 Constants and enums

    +

    32.3.4 Constants and enums

    Because Octave doesn't really have the concept of constants, C/C++ constants are not really constant in Octave. They are actually just a copy of the value into the Octave interpreter. Therefore they can be @@ -36929,7 +41154,7 @@ swigexample.SCONST="Hello World" swigexample.SUNDAY=0 .... -

    30.3.5 Pointers

    +

    32.3.5 Pointers

    C/C++ pointers are fully supported by SWIG. Furthermore, SWIG has no problem working with incomplete type information. Given a wrapping of the <file.h> interface: C/C++ pointers are fully supported by SWIG. @@ -36952,7 +41177,7 @@ octave:3> swigexample.fputs("Hello world",f); octave:4> swigexample.fclose(f); -

    Simply printing the value of a wrapped C++ type will print it's +

    Simply printing the value of a wrapped C++ type will print its typename. E.g.,

    octave:1> swigexample;
    @@ -36974,7 +41199,7 @@ octave:2> f=swigexample.fopen("not there","r");
     error: value on right hand side of assignment is undefined
     error: evaluating assignment expression near line 2, column 2 
    -

    30.3.6 Structures and C++ classes

    +

    32.3.6 Structures and C++ classes

    SWIG wraps C structures and C++ classes by using a special Octave type called a swig_ref. A swig_ref contains a reference to one or more instances of C/C++ objects, or just the type @@ -37108,14 +41333,14 @@ ans = 1

    Depending on the ownership setting of a swig_ref, it may call C++ destructors when its reference count goes to zero. See the section on memory management below for details.

    -

    30.3.7 C++ inheritance

    +

    32.3.7 C++ inheritance

    Single and multiple inheritance are fully supported. The swig_ref type carries type information along with any C++ object pointer it holds. This information contains the full class hierarchy. When an indexing operation (such as a method invocation) occurs, the tree is walked to find a match in the current class as well as any of its bases. The lookup is then cached in the swig_ref.

    -

    30.3.8 C++ overloaded functions

    +

    32.3.8 C++ overloaded functions

    Overloaded functions are supported, and handled as in other modules. That is, each overload is wrapped separately (under internal names), and a dispatch function is also emitted under the external/visible @@ -37123,7 +41348,7 @@ swig_ref type carries type information along with any C++ object based on the passed arguments. typecheck typemaps are used to analyze each argument, as well as assign precedence. See the chapter on typemaps for details.

    -

    30.3.9 C++ operators

    +

    32.3.9 C++ operators

    C++ operator overloading is supported, in a way similar to other modules. The swig_ref type supports all unary and binary operators between itself and all other types that exist in the system @@ -37133,9 +41358,9 @@ swig_ref type carries type information along with any C++ object named is derived from the types of the operands (either both or just the lhs or rhs).

    For example, if a and b are SWIG variables in - Octave, a+b becomes a.__add(b). The wrapper is then - free to implement __add to do whatever it wants. A wrapper may define - the __add function manually, %rename some other function to + Octave, a+b becomes a.__add__(b). The wrapper is then + free to implement __add__ to do whatever it wants. A wrapper may define + the __add__ function manually, %rename some other function to it, or %rename a C++ operator to it.

    By default the C++ operators are renamed to their corresponding Octave operators. So without doing any work, the following interface

    @@ -37162,90 +41387,90 @@ assert(c.value==5);

    Octave operators are mapped in the following way:

    -__brace      a{args}
    -__brace_asgn a{args} = rhs
    -__paren      a(args)
    -__paren_asgn a(args) = rhs
    -__str        generates string rep
    -__not        !a
    -__uplus      +a
    -__uminus     -a
    -__transpose  a.'
    -__hermitian  a'
    -__incr       a++
    -__decr       a--
    -__add        a + b
    -__sub        a - b
    -__mul        a * b
    -__div        a / b
    -__pow        a ^ b
    -__ldiv       a \ b
    -__lshift     a <<b
    -__rshift     a >> b
    -__lt         a  <b
    -__le         a  <= b
    -__eq         a == b
    -__ge         a >= b
    -__gt         a > b
    -__ne         a != b
    -__el_mul     a .* b
    -__el_div     a ./ b
    -__el_pow     a .^ b
    -__el_ldiv    a .\ b
    -__el_and     a & b
    -__el_or      a | b
    +__brace__      a{args}
    +__brace_asgn__ a{args} = rhs
    +__paren__      a(args)
    +__paren_asgn__ a(args) = rhs
    +__str__        generates string rep
    +__not__        !a
    +__uplus__      +a
    +__uminus__     -a
    +__transpose__  a.'
    +__hermitian__  a'
    +__incr__       a++
    +__decr__       a--
    +__add__        a + b
    +__sub__        a - b
    +__mul__        a * b
    +__div__        a / b
    +__pow__        a ^ b
    +__ldiv__       a \ b
    +__lshift__     a <<b
    +__rshift__     a >> b
    +__lt__         a  <b
    +__le__         a  <= b
    +__eq__         a == b
    +__ge__         a >= b
    +__gt__         a > b
    +__ne__         a != b
    +__el_mul__     a .* b
    +__el_div__     a ./ b
    +__el_pow__     a .^ b
    +__el_ldiv__    a .\ b
    +__el_and__     a & b
    +__el_or__      a | b
     

    On the C++ side, the default mappings are as follows:

    -%rename(__add)       *::operator+;
    -%rename(__add)       *::operator+();
    -%rename(__add)       *::operator+() const;
    -%rename(__sub)       *::operator-;
    -%rename(__uminus)    *::operator-();
    -%rename(__uminus)    *::operator-() const;
    -%rename(__mul)       *::operator*;
    -%rename(__div)       *::operator/;
    -%rename(__mod)       *::operator%;
    -%rename(__lshift)    *::operator<
    +%rename(__add__)       *::operator+;
    +%rename(__add__)       *::operator+();
    +%rename(__add__)       *::operator+() const;
    +%rename(__sub__)       *::operator-;
    +%rename(__uminus__)    *::operator-();
    +%rename(__uminus__)    *::operator-() const;
    +%rename(__mul__)       *::operator*;
    +%rename(__div__)       *::operator/;
    +%rename(__mod__)       *::operator%;
    +%rename(__lshift__)    *::operator<
     
    +%rename(__rshift__)    *::operator-->
     >;
    -%rename(__el_and)    *::operator&&;
    -%rename(__el_or)     *::operator||;
    -%rename(__xor)       *::operator^;
    -%rename(__invert)    *::operator~;
    -%rename(__lt)        *::operator
    +%rename(__el_and__)    *::operator&&;
    +%rename(__el_or__)     *::operator||;
    +%rename(__xor__)       *::operator^;
    +%rename(__invert__)    *::operator~;
    +%rename(__lt__)        *::operator
     
    +%rename(__le__)        *::operator<=;
    +%rename(__gt__)        *::operator-->
     ;
    -%rename(__ge)        *::operator>=;
    -%rename(__eq)        *::operator==;
    -%rename(__ne)        *::operator!=;
    -%rename(__not)       *::operator!;
    -%rename(__incr)      *::operator++;
    -%rename(__decr)      *::operator--;
    -%rename(__paren)     *::operator();
    -%rename(__brace)     *::operator[];
    +%rename(__ge__)        *::operator>=;
    +%rename(__eq__)        *::operator==;
    +%rename(__ne__)        *::operator!=;
    +%rename(__not__)       *::operator!;
    +%rename(__incr__)      *::operator++;
    +%rename(__decr__)      *::operator--;
    +%rename(__paren__)     *::operator();
    +%rename(__brace__)     *::operator[];
     

    Octave can also utilise friend (i.e. non-member) operators with a simple %rename: see the example in the Examples/octave/operator directory.

    -

    30.3.10 Class extension with %extend

    +

    32.3.10 Class extension with %extend

    The %extend directive works the same as in other modules.

    You can use it to define special behavior, like for example defining Octave operators not mapped to C++ operators, or defining certain Octave mechanisms such as how an object prints. For example, the octave_value::{is_string,string_value,print} functions are routed - to a special method __str that can be defined inside an + to a special method __str__ that can be defined inside an %extend.

     %extend A {
    -string __str() {
    +string __str__() {
       stringstream sout;
       sout<<$self->value;
       return sout.str();
    @@ -37261,11 +41486,23 @@ octave:2> a
     a = 4
     octave:3> printf("%s\n",a);
     4
    -octave:4> a.__str()
    +octave:4> a.__str__()
     4
     
    -

    30.3.11 C++ templates

    +

    Similarly, Octave can use the __float__ method to convert + an object to a numeric value.

    +

    Octave 3.8.0 and later versions will also map unary functions X() to + the corresponding __X__ method, where X includes: abs(), + acos(), acosh(), angle(), arg(), asin(), asinh(), atan(), atanh(), + cbrt(), ceil(), conj(), cos(), cosh(), dawson(), erf(), erfc(), + erfcinv(), erfcx(), erfi(), erfinv(), exp(), expm1(), finite(), fix(), + floor(), gamma(), imag(), isalnum(), isalpha(), isascii(), iscntrl(), + isdigit(), isgraph(), isinf(), islower(), isna(), isnan(), isprint(), + ispunct(), isspace(), isupper(), isxdigit(), lgamma(), log(), log10(), + log1p(), log2(), real(), round(), roundb(), signbit(), signum(), sin(), + sinh(), sqrt(), tan(), tanh(), toascii(), tolower(), toupper()

    +

    32.3.11 C++ templates

    C++ class and function templates are fully supported as in other modules, in that the %template directive may used to create explicit instantiations of templated types. For example, function templates can @@ -37310,7 +41547,7 @@ ans = 22 + 46i s+=_s; return *this; } - std::string __str() const { + std::string __str__() const { std::stringstream sout; sout<<s; return sout.str(); @@ -37335,10 +41572,19 @@ ans = (7,4) -

    30.3.12 C++ Smart Pointers

    +

    32.3.12 C++ Smart Pointers

    +

    32.3.12.1 The shared_ptr + Smart Pointer

    +

    The C++11 standard provides std::shared_ptr which was + derived from the Boost implementation, boost::shared_ptr. Both + of these are available for Octave in the SWIG library and usage is + outlined in the shared_ptr smart + pointer library section.

    +

    32.3.12.2 Generic Smart + Pointers

    C++ smart pointers are fully supported as in other modules.

    -

    30.3.13 Directors (calling Octave from C++ - code)

    +

    32.3.13 Directors (calling Octave from C++ + code)

    There is full support for SWIG Directors, which permits Octave code to subclass C++ classes, and implement their virtual methods.

    Octave has no direct support for object oriented programming, @@ -37422,7 +41668,7 @@ c-side routine called octave-side routine called -

    30.3.14 Threads

    +

    32.3.14 Threads

    The use of threads in wrapped Director code is not supported; i.e., an Octave-side implementation of a C++ class must be called from the Octave interpreter's thread. Anything fancier (apartment/queue model, @@ -37430,7 +41676,7 @@ octave-side routine called to the limitation that Octave must drive the module... like, for example, an optimization package that calls Octave to evaluate an objective function.

    -

    30.3.15 Memory management

    +

    32.3.15 Memory management

    As noted above, swig_ref represents a reference counted pointer to a C/C++-side object. It also contains a flag indicating whether Octave or the C/C++ code owns the object. If Octave owns it, @@ -37468,9 +41714,9 @@ A destructing the object will invalidate the Octave-side object if it still exists (and call destructors of other C++ bases in the case of multiple inheritance/subclass()'ing).

    -

    30.3.16 STL support

    +

    32.3.16 STL support

    Various STL library files are provided for wrapping STL containers.

    -

    30.3.17 Matrix typemaps

    +

    32.3.17 Matrix typemaps

    Octave provides a rich set of classes for dealing with matrices. Currently there are no built-in typemaps to deal with those. However, these are relatively straight forward for users to add themselves (see @@ -37490,7 +41736,7 @@ ans = -0.18388


    -

    31 SWIG and Perl5

    +

    33 SWIG and Perl5

    @@ -37569,7 +41825,7 @@ ans = -0.18388 results, it is recommended that SWIG be used with Perl 5.8 or later. We're no longer testing regularly with older versions, but Perl 5.6 seems to mostly work, while older versions don't.

    -

    31.1 Overview

    +

    33.1 Overview

    To build Perl extension modules, SWIG uses a layered approach. At the lowest level, simple procedural wrappers are generated for functions, classes, methods, and other declarations in the input file. @@ -37583,7 +41839,7 @@ ans = -0.18388 interface is presented. Finally, proxy classes are described. Advanced customization features, typemaps, and other options are found near the end of the chapter.

    -

    31.2 Preliminaries

    +

    33.2 Preliminaries

    To build a Perl5 module, run SWIG using the -perl option as follows:

    @@ -37598,7 +41854,7 @@ swig -perl example.i properly load the module.

    To build the module, you will need to compile the file example_wrap.c and link it with the rest of your program.

    -

    31.2.1 Getting the right header files

    +

    33.2.1 Getting the right header files

    In order to compile, SWIG extensions need the following Perl5 header files:

    @@ -37624,7 +41880,7 @@ $ perl -e 'use Config; print "$Config{archlib}\n";' /usr/lib/perl/5.14
    -

    31.2.2 Compiling a dynamic module

    +

    33.2.2 Compiling a dynamic module

    The preferred approach to building an extension module is to compile it into a shared object file or DLL. Assuming you have code you need to link to in a file called example.c, you will need to compile @@ -37649,8 +41905,8 @@ SWIG Wiki for additional information.

    %module example', then the target should be named `example.so ', `example.sl', or the appropriate dynamic module name on your system.

    -

    31.2.3 Building a dynamic module with - MakeMaker

    +

    33.2.3 Building a dynamic module with MakeMaker +

    It is also possible to use Perl to build dynamically loadable modules for you using the MakeMaker utility. To do this, write a Perl script such as the following:

    @@ -37659,9 +41915,9 @@ SWIG Wiki for additional information.

    # File : Makefile.PL use ExtUtils::MakeMaker; WriteMakefile( - `NAME' => `example', # Name of package - `LIBS' => [`-lm'], # Name of custom libraries - `OBJECT' => `example.o example_wrap.o' # Object files + `NAME' => `example', # Name of package + `LIBS' => [`-lm'], # Name of custom libraries + `OBJECT' => `example.o example_wrap.o' # Object files ); @@ -37678,7 +41934,7 @@ $ make install the preferred approach to compilation. More information about MakeMaker can be found in "Programming Perl, 2nd ed." by Larry Wall, Tom Christiansen, and Randal Schwartz.

    -

    31.2.4 Building a static version of Perl

    +

    33.2.4 Building a static version of Perl

    If you machine does not support dynamic loading or if you've tried to use it without success, you can build a new version of the Perl interpreter with your SWIG extensions added to it. To build a static @@ -37726,14 +41982,14 @@ $ swig -perl -static -lperlmain.i example.i

     $ gcc example.o example_wrap.o -L/usr/lib/perl/5.14/CORE \
    -	-lperl -lsocket -lnsl -lm -o myperl
    +        -lperl -lsocket -lnsl -lm -o myperl
     

    This will produce a new version of Perl called myperl. It should be functionality identical to Perl with your C/C++ extension added to it. Depending on your machine, you may need to link with additional libraries such as -lsocket, -lnsl, -ldl, etc.

    -

    31.2.5 Using the module

    +

    33.2.5 Using the module

    To use the module, simply use the Perl use statement. If all goes well, you will be able to do this:

    @@ -37844,8 +42100,8 @@ $ env LD_LIBRARY_PATH=/home/beazley/projects/lib perl crle (Solaris) to add additional search paths to the default system configuration (this requires root access and you will need to read the man pages).

    -

    31.2.6 Compilation problems and compiling - with C++

    +

    33.2.6 Compilation problems and compiling with + C++

    Compilation of C++ extensions has traditionally been a tricky problem. Since the Perl interpreter is written in C, you need to take steps to make sure C++ is properly initialized and that modules are @@ -37867,8 +42123,8 @@ $ g++ -shared example.o example_wrap.o -o example.so

     $ swig -c++ -perl example.i
    -$ CC -c example.cxx
    -$ CC -c example_wrap.cxx -I/usr/lib/perl/5.14/i386-linux/CORE
    +$ CC -Kpic -c example.cxx
    +$ CC -Kpic -c example_wrap.cxx -I/usr/lib/perl/5.14/i386-linux/CORE
     $ CC -shared example.o example_wrap.o -o example.so -lCrun
     
    @@ -37960,7 +42216,7 @@ $ wrapper, you will have to find the macro that conflicts and add an #undef into the .i file. Please report any conflicting macros you find to swig-user mailing list.

    -

    31.2.7 Compiling for 64-bit platforms

    +

    33.2.7 Compiling for 64-bit platforms

    On platforms that support 64-bit applications (Solaris, Irix, etc.), special care is required when building extension modules. On these machines, 64-bit applications are compiled and linked using a different @@ -37977,13 +42233,13 @@ $ that software. This may prevent the use of 64-bit extensions. It may also introduce problems on platforms that support more than one linking standard (e.g., -o32 and -n32 on Irix).

    -

    31.3 Building Perl Extensions under Windows

    +

    33.3 Building Perl Extensions under Windows

    Building a SWIG extension to Perl under Windows is roughly similar to the process used with Unix. Normally, you will want to produce a DLL that can be loaded into the Perl interpreter. This section assumes you are using SWIG with Microsoft Visual C++ although the procedure may be similar with other compilers.

    -

    31.3.1 Running SWIG from Developer Studio

    +

    33.3.1 Running SWIG from Developer Studio

    If you are developing your application within Microsoft developer studio, SWIG can be invoked as a custom build option. The process roughly requires these steps:

    @@ -38030,17 +42286,17 @@ print "$a\n";
    -

    31.3.2 Using other compilers

    +

    33.3.2 Using other compilers

    SWIG is known to work with Cygwin and may work with other compilers on Windows. For general hints and suggestions refer to the Windows chapter.

    -

    31.4 The low-level interface

    +

    33.4 The low-level interface

    At its core, the Perl module uses a simple low-level interface to C function, variables, constants, and classes. This low-level interface can be used to control your application. However, it is also used to construct more user-friendly proxy classes as described in the next section.

    -

    31.4.1 Functions

    +

    33.4.1 Functions

    C functions are converted into new Perl built-in commands (or subroutines). For example:

    @@ -38057,7 +42313,7 @@ use example; $a = &example::fact(2);
    -

    31.4.2 Global variables

    +

    33.4.2 Global variables

    Global variables are handled using Perl's magic variable mechanism. SWIG generates a pair of functions that intercept read/write operations and attaches them to a Perl variable with the same name as the C global @@ -38111,7 +42367,7 @@ extern char *path; extern char *path; // Declared later in the input

    -

    31.4.3 Constants

    +

    33.4.3 Constants

    By default, constants are wrapped as read-only Perl variables. For example:

    @@ -38139,7 +42395,7 @@ use example; print example::FOO,"\n";
    -

    31.4.4 Pointers

    +

    33.4.4 Pointers

    SWIG represents pointers as blessed references. A blessed reference is the same as a Perl reference except that it has additional information attached to it indicating what kind of reference it is. @@ -38163,9 +42419,9 @@ defined() command:

     if (defined($ptr)) {
    -	print "Not a NULL pointer.";
    +  print "Not a NULL pointer.";
     } else {
    -	print "Is a NULL pointer.";
    +  print "Is a NULL pointer.";
     }
     
     
    @@ -38183,9 +42439,9 @@ $a and $b to check the equality of two C pointers. The
     if ($$a == $$b) {
    -	print "a and b point to the same thing in C";
    +  print "a and b point to the same thing in C";
     } else {
    -	print "a and b point to different objects.";
    +  print "a and b point to different objects.";
     }
     
     
    @@ -38224,14 +42480,14 @@ NULL if the conversion can't be performed.

    preserve the same pointer naming conventions as XS and xsubpp. Given the advancement of the SWIG typesystem and the growing differences between SWIG and XS, this is no longer supported.

    -

    31.4.5 Structures

    +

    33.4.5 Structures

    Access to the contents of a structure are provided through a set of low-level accessor functions as described in the "SWIG Basics" chapter. For example,

     struct Vector {
    -	double x,y,z;
    +  double x,y,z;
     };
     
    @@ -38326,7 +42582,7 @@ void Bar_f_set(Bar *b, Foo *val) { }
    -

    31.4.6 C++ classes

    +

    33.4.6 C++ classes

    C++ classes are wrapped by building a set of low level accessor functions. Consider the following class:

    @@ -38381,7 +42637,7 @@ print example::List_length_get($l),"\n"; fairly primitive, it provides direct access to C++ objects. A higher level interface using Perl proxy classes can be built using these low-level accessors. This is described shortly.

    -

    31.4.7 C++ classes and type-checking

    +

    33.4.7 C++ classes and type-checking

    The SWIG type-checker is fully aware of C++ inheritance. Therefore, if you have classes like this

    @@ -38405,7 +42661,7 @@ void spam(Foo *f); pointer to any class derived from Foo. If necessary, the type-checker also adjusts the value of the pointer (as is necessary when multiple inheritance is used).

    -

    31.4.8 C++ overloaded functions

    +

    33.4.8 C++ overloaded functions

    If you have a C++ program with overloaded functions or methods, you will need to disambiguate those methods using %rename. For example:

    @@ -38437,7 +42693,7 @@ example::Spam_foo_d($s,3.14);

    Please refer to the "SWIG Basics" chapter for more information.

    -

    31.4.9 Operators

    +

    33.4.9 Operators

    As of version 1.3.27 SWIG automatically renames the most common C++ operators, and maps them into the perl module with the proper 'use overload ...' so you don't need to do any work.

    @@ -38458,7 +42714,7 @@ example::Spam_foo_d($s,3.14);
  • operator and
  • operator or
  • -

    31.4.10 Modules and packages

    +

    33.4.10 Modules and packages

    When you create a SWIG extension, everything gets placed into a single Perl module. The name of the module is determined by the %module directive. To use the module, do the following:

    @@ -38532,7 +42788,7 @@ use example; # Load the module like before print Foo::fact(4),"\n"; # Call a function in package FooBar </pre></div> --> -

    31.5 Input and output parameters

    +

    33.5 Input and output parameters

    A common problem in some C programs is handling parameters passed as simple pointers. For example:

    @@ -38685,7 +42941,7 @@ print "$c\n";

    Note: The REFERENCE feature is only currently supported for numeric types (integers and floating point).

    -

    31.6 Exception handling

    +

    33.6 Exception handling

    The SWIG %exception directive can be used to create a user-definable exception handler for converting exceptions in your C/C++ program into Perl exceptions. The chapter on customization @@ -38824,7 +43080,7 @@ Customization features" for more examples.

    This is still supported, but it is deprecated. The newer %exception directive provides the same functionality, but it has additional capabilities that make it more powerful.

    -

    31.7 Remapping datatypes with typemaps

    +

    33.7 Remapping datatypes with typemaps

    This section describes how you can modify SWIG's default wrapping behavior for various C/C++ datatypes using the %typemap directive. This is an advanced topic that assumes familiarity with the @@ -38834,7 +43090,7 @@ Customization features" for more examples.

    a required part of using SWIG---the default wrapping behavior is enough in most cases. Typemaps are only used if you want to change some aspect of the primitive C-Perl interface.

    -

    31.7.1 A simple typemap example

    +

    33.7.1 A simple typemap example

    A typemap is nothing more than a code generation rule that is attached to a specific C datatype. For example, to convert integers from Perl to C, you might define a typemap like this:

    @@ -38843,8 +43099,8 @@ Customization features" for more examples.

    %module example %typemap(in) int { - $1 = (int) SvIV($input); - printf("Received an integer : %d\n", $1); + $1 = (int) SvIV($input); + printf("Received an integer : %d\n", $1); } ... %inline %{ @@ -38883,8 +43139,8 @@ typedef declarations. For example:

     %typemap(in) int n {
    -	$1 = (int) SvIV($input);
    -	printf("n = %d\n",$1);
    +  $1 = (int) SvIV($input);
    +  printf("n = %d\n",$1);
     }
     %inline %{
     typedef int Integer;
    @@ -38916,7 +43172,7 @@ example::count("e","Hello World");
     >>>
     
    -

    31.7.2 Perl5 typemaps

    +

    33.7.2 Perl5 typemaps

    The previous section illustrated an "in" typemap for converting Perl objects to C. A variety of different typemap methods are defined by the Perl module. For example, to convert a C integer back into a Perl @@ -38951,7 +43207,7 @@ example::count("e","Hello World");

    Return of C++ member data (all languages).

    %typemap(check)

    Check value of input parameter.
    -

    31.7.3 Typemap variables

    +

    33.7.3 Typemap variables

    Within typemap code, a number of special variables prefaced with a $ may appear. A full list of variables can be found in the " Typemaps" chapter. This is a list of the most common variables:

    @@ -38981,7 +43237,7 @@ Typemaps" chapter. This is a list of the most common variables:

    $symname

    The Perl name of the wrapper function being created.
    -

    31.7.4 Useful functions

    +

    33.7.4 Useful functions

    When writing typemaps, it is necessary to work directly with Perl5 objects. This, unfortunately, can be a daunting task. Consult the "perlguts" man-page for all of the really ugly details. A short summary @@ -39028,12 +43284,12 @@ SV *SvRV(SV *); int sv_isa(SV *, char *0;

    -

    31.8 Typemap Examples

    +

    33.8 Typemap Examples

    This section includes a few examples of typemaps. For more examples, you might look at the files "perl5.swg" and "typemaps.i " in the SWIG library.

    -

    31.8.1 Converting a Perl5 array to a char - **

    +

    33.8.1 Converting a Perl5 array to a char ** +

    A common problem in many C programs is the processing of command line arguments, which are usually passed in an array of NULL terminated strings. The following SWIG interface file allows a Perl5 array @@ -39044,47 +43300,47 @@ int sv_isa(SV *, char *0; // This tells SWIG to treat char ** as a special case %typemap(in) char ** { - AV *tempav; - I32 len; - int i; - SV **tv; - if (!SvROK($input)) - croak("Argument $argnum is not a reference."); - if (SvTYPE(SvRV($input)) != SVt_PVAV) - croak("Argument $argnum is not an array."); - tempav = (AV*)SvRV($input); - len = av_len(tempav); - $1 = (char **) malloc((len+2)*sizeof(char *)); - for (i = 0; i <= len; i++) { - tv = av_fetch(tempav, i, 0); - $1[i] = (char *) SvPV(*tv,PL_na); - } - $1[i] = NULL; + AV *tempav; + I32 len; + int i; + SV **tv; + if (!SvROK($input)) + croak("Argument $argnum is not a reference."); + if (SvTYPE(SvRV($input)) != SVt_PVAV) + croak("Argument $argnum is not an array."); + tempav = (AV*)SvRV($input); + len = av_len(tempav); + $1 = (char **) malloc((len+2)*sizeof(char *)); + for (i = 0; i <= len; i++) { + tv = av_fetch(tempav, i, 0); + $1[i] = (char *) SvPV(*tv,PL_na); + } + $1[i] = NULL; }; // This cleans up the char ** array after the function call %typemap(freearg) char ** { - free($1); + free($1); } // Creates a new Perl array and places a NULL-terminated char ** into it %typemap(out) char ** { - AV *myav; - SV **svs; - int i = 0,len = 0; - /* Figure out how many elements we have */ - while ($1[len]) - len++; - svs = (SV **) malloc(len*sizeof(SV *)); - for (i = 0; i < len ; i++) { - svs[i] = sv_newmortal(); - sv_setpv((SV*)svs[i],$1[i]); - }; - myav = av_make(len,svs); - free(svs); - $result = newRV_noinc((SV*)myav); - sv_2mortal($result); - argvi++; + AV *myav; + SV **svs; + int i = 0,len = 0; + /* Figure out how many elements we have */ + while ($1[len]) + len++; + svs = (SV **) malloc(len*sizeof(SV *)); + for (i = 0; i < len ; i++) { + svs[i] = sv_newmortal(); + sv_setpv((SV*)svs[i],$1[i]); + }; + myav = av_make(len,svs); + free(svs); + $result = newRV_noinc((SV*)myav); + sv_2mortal($result); + argvi++; } // Now a few test functions @@ -39118,7 +43374,7 @@ $b = argv::get_args(); # Get array of strings from C print @$b,"\n"; # Print it out

    -

    31.8.2 Return values

    +

    33.8.2 Return values

    Return values are placed on the argument stack of each wrapper function. The current value of the argument stack pointer is contained in a variable argvi. Whenever a new output value is added, it @@ -39131,16 +43387,16 @@ print @$b,"\n"; # Print it out

     %typemap(argout) int *OUTPUT {
    -	if (argvi >= items) {            
    -		EXTEND(sp,1);              /* Extend the stack by 1 object */
    -	}
    -	$result = sv_newmortal();
    -	sv_setiv($target,(IV) *($1));
    -	argvi++;
    +  if (argvi >= items) {
    +    EXTEND(sp,1);              /* Extend the stack by 1 object */
    +  }
    +  $result = sv_newmortal();
    +  sv_setiv($target,(IV) *($1));
    +  argvi++;
     }
     
    -

    31.8.3 Returning values from arguments

    +

    33.8.3 Returning values from arguments

    Sometimes it is desirable for a function to return a value in one of its arguments. This example describes the implementation of the OUTPUT typemap.

    @@ -39152,24 +43408,24 @@ OUTPUT typemap.

    // an output value. %typemap(argout) double *OUTPUT { - $result = sv_newmortal(); - sv_setnv($result, *$input); - argvi++; /* Increment return count -- important! */ + $result = sv_newmortal(); + sv_setnv($result, *$input); + argvi++; /* Increment return count -- important! */ } // We don't care what the input value is. Ignore, but set to a temporary variable %typemap(in,numinputs=0) double *OUTPUT(double junk) { - $1 = &junk; + $1 = &junk; } // Now a function to test it %{ /* Returns the first two input arguments */ int multout(double a, double b, double *out1, double *out2) { - *out1 = a; - *out2 = b; - return 0; + *out1 = a; + *out2 = b; + return 0; }; %} @@ -39189,7 +43445,7 @@ print "multout(7,13) = @r\n"; ($x,$y) = multout(7,13); -

    31.8.4 Accessing array structure members

    +

    33.8.4 Accessing array structure members

    Consider the following data structure:

    @@ -39238,15 +43494,15 @@ typedef struct {
      the "in" typemap in the previous section would be used to convert an 
     int[] array to C whereas the "memberin" typemap would be used to
      copy the converted array into a C data structure.

    -

    31.8.5 Turning Perl references into C - pointers

    +

    33.8.5 Turning Perl references into C pointers +

    A frequent confusion on the SWIG mailing list is errors caused by the mixing of Perl references and C pointers. For example, suppose you have a C function that modifies its arguments like this:

     void add(double a, double b, double *c) {
    -	*c = a + b;
    +  *c = a + b;
     }
     
    @@ -39296,7 +43552,7 @@ print "$c\n";
    -

    31.8.6 Pointer handling

    +

    33.8.6 Pointer handling

    Occasionally, it might be necessary to convert pointer values that have been stored using the SWIG typed-pointer representation. To convert a pointer from Perl to C, the following function is used:

    @@ -39349,14 +43605,14 @@ $descriptor() macro in a typemap. For example:

    } -

    31.9 Proxy classes

    +

    33.9 Proxy classes

    Out of date. Needs update.

    Using the low-level procedural interface, SWIG can also construct a high-level object oriented interface to C structures and C++ classes. This is done by constructing a Perl proxy class (also known as a shadow class) that provides an OO wrapper to the underlying code. This section describes the implementation details of the proxy interface.

    -

    31.9.1 Preliminaries

    +

    33.9.1 Preliminaries

    Proxy classes, are generated by default. If you want to turn them off, use the -noproxy command line option. For example:

    @@ -39371,15 +43627,15 @@ $ swig -c++ -perl -noproxy example.i original module, SWIG creates a collection of high-level Perl wrappers. In your scripts, you will use these high level wrappers. The wrappers, in turn, interact with the low-level procedural module.

    -

    31.9.2 Structure and class wrappers

    +

    33.9.2 Structure and class wrappers

    Suppose you have the following SWIG interface file:

     %module example
     struct Vector {
    -	Vector(double x, double y, double z);
    -	~Vector();
    -	double x,y,z;
    +  Vector(double x, double y, double z);
    +  ~Vector();
    +  double x,y,z;
     };
     
     
    @@ -39425,8 +43681,9 @@ sub DESTROY { my $self = tied(%{$_[0]}); delete $ITERATORS{$self}; if (exists $OWNER{$self}) { - examplec::delete_Vector($self)); - delete $OWNER{$self}; + examplec::delete_Vector($self)); + delete $OWNER{$self}; + } } sub FETCH { @@ -39473,8 +43730,8 @@ $v->{x} = 7.5; # Assignment of all members %$v = ( x=>3, - y=>9, - z=>-2); + y=>9, + z=>-2); # Reading members $x = $v->{x}; @@ -39484,14 +43741,14 @@ $v->DESTROY();
    -

    31.9.3 Object Ownership

    +

    33.9.3 Object Ownership

    In order for proxy classes to work properly, it is necessary for Perl to manage some mechanism of object ownership. Here's the crux of the problem---suppose you had a function like this:

     Vector *Vector_get(Vector *v, int index) {
    -	return &v[i];
    +  return &v[i];
     }
     
    @@ -39502,9 +43759,9 @@ Vector *Vector_get(Vector *v, int index) {
     Vector *new_Vector(double x, double y, double z) {
    -	Vector *v;
    -	v = new Vector(x,y,z);        // Call C++ constructor
    -	return v;
    +  Vector *v;
    +  v = new Vector(x,y,z);        // Call C++ constructor
    +  return v;
     }
     
    @@ -39553,15 +43810,15 @@ $u->ACQUIRE();

    As always, a little care is in order. SWIG does not provide reference counting, garbage collection, or advanced features one might find in sophisticated languages.

    -

    31.9.4 Nested Objects

    +

    33.9.4 Nested Objects

    Suppose that we have a new object that looks like this:

     struct Particle {
    -	Vector r;
    -	Vector v;
    -	Vector f;
    -	int	type;
    +  Vector r;
    +  Vector v;
    +  Vector f;
    +  int type;
     }
     
     
    @@ -39575,9 +43832,9 @@ struct Particle { package Particle; ... %BLESSEDMEMBERS = ( - r => `Vector', - v => `Vector', - f => `Vector', + r => `Vector', + v => `Vector', + f => `Vector', ); @@ -39596,7 +43853,7 @@ $p->{f}->{x} = 0.0; %${$p->{v}} = ( x=>0, y=>0, z=>0);
    -

    31.9.5 Proxy Functions

    +

    33.9.5 Proxy Functions

    When functions take arguments involving a complex object, it is sometimes necessary to write a proxy function. For example:

    @@ -39621,7 +43878,7 @@ sub dot_product {

    This function replaces the original function, but operates in an identical manner.

    -

    31.9.6 Inheritance

    +

    33.9.6 Inheritance

    Simple C++ inheritance is handled using the Perl @ISA array in each class package. For example, if you have the following interface file:

    @@ -39636,23 +43893,23 @@ sub dot_product { class Shape { public: - virtual double area() = 0; - virtual double perimeter() = 0; - void set_location(double x, double y); + virtual double area() = 0; + virtual double perimeter() = 0; + void set_location(double x, double y); }; class Circle : public Shape { public: - Circle(double radius); - ~Circle(); - double area(); - double perimeter(); + Circle(double radius); + ~Circle(); + double area(); + double perimeter(); }; class Square : public Shape { public: - Square(double size); - ~Square(); - double area(); - double perimeter(); + Square(double size); + ~Square(); + double area(); + double perimeter(); } @@ -39684,7 +43941,7 @@ Package Square; be forewarned that this is not a trivial problem. In particular, inheritance of data members is extremely tricky (and I'm not even sure if it really works).

    -

    31.9.7 Modifying the proxy methods

    +

    33.9.7 Modifying the proxy methods

    It is possible to override the SWIG generated proxy/shadow methods, using %feature("shadow"). It works like all the other %feature directives. Here is a simple example showing how to add @@ -39709,7 +43966,7 @@ public: };

    -

    31.10 Adding additional Perl code

    +

    33.10 Adding additional Perl code

    If writing support code in C isn't enough, it is also possible to write code in Perl. This code gets inserted in to the .pm file created by SWIG. One use of Perl code might be to supply a high-level @@ -39750,10 +44007,265 @@ my $a = [0,0,0,1]]; set_transform($im, $a); -


    + +

    33.11 Cross language polymorphism

    +

    Proxy classes provide a more natural, object-oriented way to access + extension classes. As described above, each proxy instance has an + associated C++ instance, and method calls to the proxy are passed to + the C++ instance transparently via C wrapper functions.

    +

    This arrangement is asymmetric in the sense that no corresponding + mechanism exists to pass method calls down the inheritance chain from + C++ to Perl. In particular, if a C++ class has been extended in Perl + (by extending the proxy class), these extensions will not be visible + from C++ code. Virtual method calls from C++ are thus not able access + the lowest implementation in the inheritance chain.

    +

    Changes have been made to SWIG to address this problem and make the + relationship between C++ classes and proxy classes more symmetric. To + achieve this goal, new classes called directors are introduced at the + bottom of the C++ inheritance chain. The job of the directors is to + route method calls correctly, either to C++ implementations higher in + the inheritance chain or to Perl implementations lower in the + inheritance chain. The upshot is that C++ classes can be extended in + Perl and from C++ these extensions look exactly like native C++ + classes. Neither C++ code nor Perl code needs to know where a + particular method is implemented: the combination of proxy classes, + director classes, and C wrapper functions takes care of all the + cross-language method routing transparently.

    +

    33.11.1 Enabling directors

    +

    The director feature is disabled by default. To use directors you + must make two changes to the interface file. First, add the "directors" + option to the %module directive, like this:

    +
    +
    +%module(directors="1") modulename
    +
    +
    +

    Without this option no director code will be generated. Second, you + must use the %feature("director") directive to tell SWIG which classes + and methods should get directors. The %feature directive can be applied + globally, to specific classes, and to specific methods, like this:

    +
    +
    +// generate directors for all classes that have virtual methods
    +%feature("director");         
    +
    +// generate directors for all virtual methods in class Foo
    +%feature("director") Foo;      
    +
    +
    +

    You can use the %feature("nodirector") directive to turn off + directors for specific classes or methods. So for example,

    +
    +
    +%feature("director") Foo;
    +%feature("nodirector") Foo::bar;
    +
    +
    +

    will generate directors for all virtual methods of class Foo except + bar().

    +

    Directors can also be generated implicitly through inheritance. In + the following, class Bar will get a director class that handles the + methods one() and two() (but not three()):

    +
    +
    +%feature("director") Foo;
    +class Foo {
    +public:
    +    Foo(int foo);
    +    virtual void one();
    +    virtual void two();
    +};
     
    -
    -

    32 SWIG and PHP

    +class Bar: public Foo { +public: + virtual void three(); +}; +
    +
    +

    then at the Perl side you can define

    +
    +
    +use mymodule;
    +
    +package MyFoo;
    +use base 'mymodule::Foo';
    +
    +sub one {
    +  print "one from Perl\n";
    +}
    +
    +
    +

    33.11.2 Director classes

    +

    For each class that has directors enabled, SWIG generates a new + class that derives from both the class in question and a special +Swig::Director class. These new classes, referred to as director + classes, can be loosely thought of as the C++ equivalent of the Perl + proxy classes. The director classes store a pointer to their underlying + Perl object and handle various issues related to object ownership.

    +

    For simplicity let's ignore the Swig::Director class and + refer to the original C++ class as the director's base class. By + default, a director class extends all virtual methods in the + inheritance chain of its base class (see the preceding section for how + to modify this behavior). Thus all virtual method calls, whether they + originate in C++ or in Perl via proxy classes, eventually end up in at + the implementation in the director class. The job of the director + methods is to route these method calls to the appropriate place in the + inheritance chain. By "appropriate place" we mean the method that would + have been called if the C++ base class and its extensions in Perl were + seamlessly integrated. That seamless integration is exactly what the + director classes provide, transparently skipping over all the messy + extension API glue that binds the two languages together.

    +

    In reality, the "appropriate place" is one of only two + possibilities: C++ or Perl. Once this decision is made, the rest is + fairly easy. If the correct implementation is in C++, then the lowest + implementation of the method in the C++ inheritance chain is called + explicitly. If the correct implementation is in Perl, the Perl API is + used to call the method of the underlying Perl object (after which the + usual virtual method resolution in Perl automatically finds the right + implementation).

    +

    Now how does the director decide which language should handle the + method call? The basic rule is to handle the method in Perl, unless + there's a good reason not to. The reason for this is simple: Perl has + the most "extended" implementation of the method. This assertion is + guaranteed, since at a minimum the Perl proxy class implements the + method. If the method in question has been extended by a class derived + from the proxy class, that extended implementation will execute exactly + as it should. If not, the proxy class will route the method call into a + C wrapper function, expecting that the method will be resolved in C++. + The wrapper will call the virtual method of the C++ instance, and since + the director extends this the call will end up right back in the + director method. Now comes the "good reason not to" part. If the + director method were to blindly call the Perl method again, it would + get stuck in an infinite loop. We avoid this situation by adding + special code to the C wrapper function that tells the director method + to not do this. The C wrapper function compares the pointer to the Perl + object that called the wrapper function to the pointer stored by the + director. If these are the same, then the C wrapper function tells the + director to resolve the method by calling up the C++ inheritance chain, + preventing an infinite loop.

    +

    One more point needs to be made about the relationship between + director classes and proxy classes. When a proxy class instance is + created in Perl, SWIG creates an instance of the original C++ class. + This is exactly what happens without directors and is true even if + directors are enabled for the particular class in question. When a + class derived from a proxy class is created, however, SWIG then + creates an instance of the corresponding C++ director class. The reason + for this difference is that user-defined subclasses may override or + extend methods of the original class, so the director class is needed + to route calls to these methods correctly. For unmodified proxy + classes, all methods are ultimately implemented in C++ so there is no + need for the extra overhead involved with routing the calls through + Perl.

    +

    33.11.3 Ownership and object destruction

    +

    Memory management issues are slightly more complicated with + directors than for proxy classes alone. Perl instances hold a pointer + to the associated C++ director object, and the director in turn holds a + pointer back to a Perl object. By default, proxy classes own their C++ + director object and take care of deleting it when they are garbage + collected.

    +

    This relationship can be reversed by calling the special +DISOWN() method of the proxy class. After calling this method the + director class increments the reference count of the Perl object. When + the director class is deleted it decrements the reference count. + Assuming no outstanding references to the Perl object remain, the Perl + object will be destroyed at the same time. This is a good thing, since + directors and proxies refer to each other and so must be created and + destroyed together. Destroying one without destroying the other will + likely cause your program to segfault.

    +

    Also note that due to the proxy implementation, the DESTROY() + method on directors can be called for several reasons, many of which + have little to do with the teardown of an object instance. To help + disambiguate this, a second argument is added to the DESTROY() + call when a C++ director object is being released. So, to avoid running + your clean-up code when an object is not really going away, or after it + has already been reclaimed, it is suggested that custom destructors in + Perl subclasses looks something like:

    +
    +
    +sub DESTROY {
    +  my($self, $final) = @_;
    +  if($final) {
    +    # real teardown code
    +  }
    +  shift->SUPER::DESTROY(@_);
    +}
    +
    +
    +

    33.11.4 Exception unrolling

    +

    With directors routing method calls to Perl, and proxies routing + them to C++, the handling of exceptions is an important concern. By + default, the directors ignore exceptions that occur during method calls + that are resolved in Perl. To handle such exceptions correctly, it is + necessary to temporarily translate them into C++ exceptions. This can + be done with the %feature("director:except") directive. The following + code should suffice in most cases:

    +
    +
    +%feature("director:except") {
    +    if ($error != NULL) {
    +        throw Swig::DirectorMethodException();
    +    }
    +}
    +
    +
    +

    This code will check the Perl error state after each method call + from a director into Perl, and throw a C++ exception if an error + occurred. This exception can be caught in C++ to implement an error + handler.

    +

    It may be the case that a method call originates in Perl, travels up + to C++ through a proxy class, and then back into Perl via a director + method. If an exception occurs in Perl at this point, it would be nice + for that exception to find its way back to the original caller. This + can be done by combining a normal %exception directive with the +director:except handler shown above. Here is an example of a + suitable exception handler:

    +
    +
    +%exception {
    +    try { $action }
    +    catch (Swig::DirectorException &e) { SWIG_fail; }
    +}
    +
    +
    +

    The class Swig::DirectorException used in this example is actually a + base class of Swig::DirectorMethodException, so it will trap this + exception. Because the Perl error state is still set when + Swig::DirectorMethodException is thrown, Perl will register the + exception as soon as the C wrapper function returns.

    +

    33.11.5 Overhead and code bloat

    +

    Enabling directors for a class will generate a new director method + for every virtual method in the class' inheritance chain. This alone + can generate a lot of code bloat for large hierarchies. Method + arguments that require complex conversions to and from target language + types can result in large director methods. For this reason it is + recommended that you selectively enable directors only for specific + classes that are likely to be extended in Perl and used in C++.

    +

    Compared to classes that do not use directors, the call routing in + the director methods does add some overhead. In particular, at least + one dynamic cast and one extra function call occurs per method call + from Perl. Relative to the speed of Perl execution this is probably + completely negligible. For worst case routing, a method call that + ultimately resolves in C++ may take one extra detour through Perl in + order to ensure that the method does not have an extended Perl + implementation. This could result in a noticeable overhead in some + cases.

    +

    Although directors make it natural to mix native C++ objects with + Perl objects (as director objects) via a common base class pointer, one + should be aware of the obvious fact that method calls to Perl objects + will be much slower than calls to C++ objects. This situation can be + optimized by selectively enabling director methods (using the %feature + directive) for only those methods that are likely to be extended in + Perl.

    +

    33.11.6 Typemaps

    +

    Typemaps for input and output of most of the basic types from + director classes have been written. These are roughly the reverse of + the usual input and output typemaps used by the wrapper code. The + typemap operation names are 'directorin', 'directorout', and + 'directorargout'. The director code does not currently use any of the + other kinds of typemaps. It is not clear at this point which kinds are + appropriate and need to be supported.

    +
    +

    34 SWIG and PHP

    @@ -39773,10 +44285,11 @@ set_transform($im, $a);
  • Pointers and References
  • Structures and C++ classes
  • PHP Pragmas, Startup and Shutdown code
  • @@ -39816,7 +44329,7 @@ set_transform($im, $a); . To use the built PHP module you will need either the php binary or the Apache php module. If you want to build your extension into php directly, you will need the complete PHP source tree available.

    -

    32.1 Generating PHP Extensions

    +

    34.1 Generating PHP Extensions

    To build a PHP extension, run swig using the -php option as follows:

    @@ -39838,56 +44351,63 @@ php_example.h contains the header information needed if you wish to more detail in section 27.2.6.

    The usual (and recommended) way is to build the extension as a separate dynamically loaded module (which is supported by all modern - operating systems). You can then specify that this be loaded - automatically in php.ini or load it explicitly for any script - which needs it.

    + operating systems).

    It is also possible to rebuild PHP from source so that your module is statically linked into the php executable/library. This is a lot more work, and also requires a full rebuild of PHP to update your module, and it doesn't play nicely with package system. We don't recommend this approach, or provide explicit support for it.

    -

    32.1.1 Building a loadable extension

    +

    34.1.1 Building a loadable extension

    To build your module as a dynamically loadable extension, use compilation commands like these (if you aren't using GCC, the commands will be different, and there may be some variation between platforms - these commands should at least work for Linux though):

    -	gcc `php-config --includes` -fpic -c example_wrap.c
    -	gcc -shared example_wrap.o -o example.so
    +        gcc `php-config --includes` -fpic -c example_wrap.c example.c
    +        gcc -shared example_wrap.o example.o -o example.so
     
    -

    32.1.2 Using PHP Extensions

    -

    To test the extension from a PHP script, you need to load it first. - You can load it for every script by adding this line to the [PHP] +

    34.1.2 Using PHP Extensions

    +

    To test the extension from a PHP script, you first need to tell PHP + to load it. To do this, add a line like this to the [PHP] section of php.ini:

    -	extension=/path/to/modulename.so
    +        extension=/path/to/modulename.so
     
    -

    Alternatively, you can load it explicitly only for scripts which - need it by adding this line to the start of each such PHP script::

    +

    If the module is in PHP's default extension directory, you can omit + the path.

    +

    For some SAPIs (for example, the CLI SAPI) you can instead use the dl() function to + load an extension at run time, by adding a like like this to the start + of each PHP script which uses your extension:

    -	dl("/path/to/modulename.so");	// Load the module
    +        dl("/path/to/modulename.so"); // Load the module
     
    -

    SWIG also generates a php module, which attempts to do the dl() - call for you:

    +

    But note that this doesn't work when running PHP through a webserver + in PHP5.3 and later - you'll need to use extension in +php.ini as described above.

    +

    The PHP module which SWIG generates will also attempt to do the +dl() call for you if the extension isn't already loaded:

    -	include("example.php");
    +        include("example.php");
     
    -

    32.2 Basic PHP interface

    +

    This PHP module also defines the PHP classes for the wrapped API, so + you'll almost certainly want to include it anyway.

    +

    34.2 Basic PHP interface

    It is important to understand that PHP uses a single global namespace into which all symbols from extension modules are loaded. It is quite possible for names of symbols in one extension module to clash with other symbols unless care is taken to %rename them. At present SWIG doesn't have support for the namespace feature added in PHP 5.3.

    -

    32.2.1 Constants

    +

    34.2.1 Constants

    These work in much the same way as in C/C++. Constants can be defined by using either the normal C pre-processor declarations, or the %constant SWIG directive. These will then be available from @@ -39915,16 +44435,16 @@ echo "E = " . E . "\n";

    There's one peculiarity of how constants work in PHP which it is useful to note (this is not specific to SWIG though) - if you try to - use an undeclared constant, PHP will issue a warning and then expand - the constant to a string version of the constant's name. The warning - will often be missed though as if you're using PHP in a webserver, it + use an undeclared constant, PHP will emit a notice and then expand the + constant to a string version of the constant's name. Unfortunately it + is easy to miss the notice if you're using PHP in a webserver, as it will probably end up in error.log or similar.

    For example,

     %module example
     
    -#define EASY_TO_MISPELL	0
    +#define EASY_TO_MISPELL 0
     

    accessed incorrectly in PHP,

    @@ -39933,9 +44453,9 @@ echo "E = " . E . "\n"; include("example.php"); if(EASY_TO_MISPEL) { - .... + ... } else { - .... + ... } @@ -39943,7 +44463,7 @@ if(EASY_TO_MISPEL) {

    The mis-spelled constant will become the string 'EASY_TO_MISPEL', which is treated as true by the if test, when the value of the intended constant would be treated as false!

    -

    32.2.2 Global Variables

    +

    34.2.2 Global Variables

    Because PHP does not provide a mechanism to intercept access and assignment of global variables, global variables are supported through the use of automatically generated accessor functions.

    @@ -39964,7 +44484,7 @@ if(EASY_TO_MISPEL) {
     include("example.php");
     print seki_get();
    -seki_set( seki_get() * 2);	# The C variable is now 4.
    +seki_set( seki_get() * 2); # The C variable is now 4.
     print seki_get();
     
    @@ -39977,7 +44497,7 @@ varinit typemap.

    method will result in a php fatal error because the function is undefined.

    At this time SWIG does not support custom accessor methods.

    -

    32.2.3 Functions

    +

    34.2.3 Functions

    C functions are converted into PHP functions. Default/optional arguments are also allowed. An interface file like this :

    @@ -39994,7 +44514,7 @@ double bar(double, double b = 3.0); include("example.php"); $a = foo(2); $b = bar(3.5, -1.5); -$c = bar(3.5); # Use default argument for 2nd parameter +$c = bar(3.5); # Use default argument for 2nd parameter
    @@ -40022,7 +44542,7 @@ $a = foo($s); # invokes 'foo(2)'; print $s; # The value of $s was not changed. </pre></div> --> -

    32.2.4 Overloading

    +

    34.2.4 Overloading

    Although PHP does not support overloading functions natively, swig will generate dispatch functions which will use %typecheck typemaps to allow overloading. This dispatch function's operation and @@ -40072,7 +44592,7 @@ Cause less confusion and <tt>doit("2");</tt> will invoke t taking the integer argument. </p> --> -

    32.2.5 Pointers and References

    +

    34.2.5 Pointers and References

    Pointers to C/C++ objects are represented as PHP resources, rather like MySQL connection handles.

    There are multiple ways to wrap pointers to simple types. Given the @@ -40141,10 +44661,15 @@ echo "The sum $in1 + $in2 = $result\n";

    Because PHP has a native concept of reference, it may seem more natural to the PHP developer to use references to pass pointers. To enable this, one needs to include phppointers.i which defines - the named typemap REFERENCE.

    -

    However, this relies on call-time pass-by-reference, which has been - deprecated in PHP for some time, and was finally removed in PHP 5.4 -. So you should avoid creating new wrappers which rely on this approach.

    + the named typemap REF.

    +

    Prior to SWIG 3.0, the REF typemaps relied on PHP's call-time + pass-by-reference, which was deprecated in PHP 5.3 and removed in PHP + 5.4. So if you use these REF typemaps, you should ensure that SWIG≥3.0 + is used to generate wrappers from your interface file.

    +

    In case you write your own typemaps, SWIG supports an attribute + called byref: if you set that, then SWIG will make sure that + the generated wrapper function will want the input parameter as a + reference.

     %module example
    @@ -40164,7 +44689,7 @@ include("example.php");
     $in1 = 3;
     $in2 = 5;
     $result = 0;
    -add(&$in1,&$in2,&$result);
    +add($in1,$in2,$result);
     
     echo "The sum $in1 + $in2 = $result\n";
     ?>
    @@ -40181,7 +44706,7 @@ echo "The sum $in1 + $in2 = $result\n";
      is sometimes required in C libraries. A NULL pointer can be created in
      PHP in a number of ways: by using unset on an existing
      variable, or assigning NULL to a variable.

    -

    32.2.6 Structures and C++ classes

    +

    34.2.6 Structures and C++ classes

    SWIG defaults to wrapping C++ structs and classes with PHP classes - this is done by generating a PHP wrapper script which defines proxy classes which calls a set of flat functions which actually wrap the C++ @@ -40194,10 +44719,10 @@ echo "The sum $in1 + $in2 = $result\n"; class Vector { public: - double x,y,z; - Vector(); - ~Vector(); - double magnitude(); + double x,y,z; + Vector(); + ~Vector(); + double magnitude(); }; struct Complex { @@ -40231,7 +44756,7 @@ struct Complex {

    Member variables and methods are accessed using the -> operator.

    -

    32.2.6.1 Using -noproxy

    +

    34.2.6.1 Using -noproxy

    The -noproxy option flattens the object structure and generates collections of named functions (these are the functions which the PHP5 class wrappers call). The above example results in the @@ -40253,7 +44778,7 @@ Complex_im_set($obj,$d); Complex_im_get($obj); -

    32.2.6.2 Constructors and Destructors

    +

    34.2.6.2 Constructors and Destructors

    The constructor is called when new Object() (or new_Object() if using -noproxy) is used to create an instance of the object. If multiple constructors are defined for an @@ -40279,7 +44804,7 @@ $o_copy = new Object($o); the instance are reassigned or go out of scope. The destructor is not available to be called manually. To force a destructor to be called the programmer can either reassign the variable or call unset($v)

    -

    32.2.6.3 Static Member Variables

    +

    34.2.6.3 Static Member Variables

    Static member variables in C++ are not wrapped as such in PHP as it does not appear to be possible to intercept accesses to such variables. Therefore, static member variables are wrapped using a class function @@ -40290,7 +44815,7 @@ $o_copy = new Object($o); %module example class Ko { - static int threats; + static int threats; }; @@ -40315,7 +44840,7 @@ echo "There have now been " . Ko::threats() . " threats\n"; -

    32.2.6.4 Static Member Functions

    +

    34.2.6.4 Static Member Functions

    Static member functions are supported in PHP using the class::function() syntax. For example

    @@ -40331,8 +44856,20 @@ include("example.php"); Ko::threats();
    -

    32.2.7 PHP Pragmas, Startup and Shutdown - code

    +

    34.2.6.5 Specifying Implemented Interfaces

    +

    PHP supports the concept of abstract interfaces which a class can + implement. Since SWIG 3.0.3, you can tell SWIG that a wrapped class + (for example MyIterator) implements the Iterator + interface like so:

    +
    +
    +%typemap("phpinterfaces") MyIterator "Iterator";
    +
    +
    +

    If there are multiple interfaces, just list them separated by + commas.

    +

    34.2.7 PHP Pragmas, Startup and Shutdown code +

    To place PHP code in the generated "example.php" file one can use the code pragma. The code is inserted after loading the shared object.

    @@ -40403,7 +44940,7 @@ include \"include.php\";

    The %rinit and %rshutdown statements are very similar but insert code into the request init (PHP_RINIT_FUNCTION) and request shutdown (PHP_RSHUTDOWN_FUNCTION) code respectively.

    -

    32.3 Cross language polymorphism

    +

    34.3 Cross language polymorphism

    Proxy classes provide a more natural, object-oriented way to access extension classes. As described above, each proxy instance has an associated C++ instance, and method calls to the proxy are passed to @@ -40427,7 +44964,7 @@ include \"include.php\"; know where a particular method is implemented: the combination of proxy classes, director classes, and C wrapper functions takes care of all the cross-language method routing transparently.

    -

    32.3.1 Enabling directors

    +

    34.3.1 Enabling directors

    The director feature is disabled by default. To use directors you must make two changes to the interface file. First, add the "directors" option to the %module directive, like this:

    @@ -40490,7 +45027,7 @@ class MyFoo extends Foo { } -

    32.3.2 Director classes

    +

    34.3.2 Director classes

    For each class that has directors enabled, SWIG generates a new class that derives from both the class in question and a special Swig::Director class. These new classes, referred to as director @@ -40551,7 +45088,7 @@ Swig::Director class. These new classes, referred to as director unmodified proxy classes, all methods are ultimately implemented in C++ so there is no need for the extra overhead involved with routing the calls through PHP.

    -

    32.3.3 Ownership and object destruction

    +

    34.3.3 Ownership and object destruction

    Memory management issues are slightly more complicated with directors than for proxy classes alone. PHP instances hold a pointer to the associated C++ director object, and the director in turn holds a @@ -40590,7 +45127,7 @@ $c->addFoo($a);

    In this example, we are assuming that FooContainer will take care of deleting all the Foo pointers it contains at some point.

    -

    32.3.4 Exception unrolling

    +

    34.3.4 Exception unrolling

    With directors routing method calls to PHP, and proxies routing them to C++, the handling of exceptions is an important concern. By default, the directors ignore exceptions that occur during method calls that are @@ -40633,7 +45170,7 @@ director:except handler shown above. Here is an example of a exception. Because the PHP error state is still set when Swig::DirectorMethodException is thrown, PHP will register the exception as soon as the C wrapper function returns.

    -

    32.3.5 Overhead and code bloat

    +

    34.3.5 Overhead and code bloat

    Enabling directors for a class will generate a new director method for every virtual method in the class' inheritance chain. This alone can generate a lot of code bloat for large hierarchies. Method @@ -40657,7 +45194,7 @@ director:except handler shown above. Here is an example of a optimized by selectively enabling director methods (using the %feature directive) for only those methods that are likely to be extended in PHP.

    -

    32.3.6 Typemaps

    +

    34.3.6 Typemaps

    Typemaps for input and output of most of the basic types from director classes have been written. These are roughly the reverse of the usual input and output typemaps used by the wrapper code. The @@ -40665,11 +45202,11 @@ director:except handler shown above. Here is an example of a 'directorargout'. The director code does not currently use any of the other kinds of typemaps. It is not clear at this point which kinds are appropriate and need to be supported.

    -

    32.3.7 Miscellaneous

    +

    34.3.7 Miscellaneous

    Director typemaps for STL classes are mostly in place, and hence you should be able to use std::string, etc., as you would any other type.


    -

    33 SWIG and Pike

    +

    35 SWIG and Pike

    @@ -40704,8 +45241,8 @@ director:except handler shown above. Here is an example of a least, make sure you read the "SWIG Basics" chapter.

    -

    33.1 Preliminaries

    -

    33.1.1 Running SWIG

    +

    35.1 Preliminaries

    +

    35.1.1 Running SWIG

    Suppose that you defined a SWIG module such as the following:

    %module example
    @@ -40742,7 +45279,7 @@ example_wrap.cxx, if you ran SWIG with the -c++ option).
     
    $ swig -pike -o pseudonym.c example.i
     
    -

    33.1.2 Getting the right header files

    +

    35.1.2 Getting the right header files

    In order to compile the C/C++ wrappers, the compiler needs to know the path to the Pike header files. These files are usually contained in a directory such as

    @@ -40754,7 +45291,7 @@ example_wrap.cxx, if you ran SWIG with the -c++ option). location of these files, so you may need to hunt around for them. You're looking for files with the names global.h, program.h and so on.

    -

    33.1.3 Using your module

    +

    35.1.3 Using your module

    To use your module, simply use Pike's import statement:

    @@ -40765,14 +45302,14 @@ Pike v7.4 release 10 running Hilfe v3.5 (Incremental Pike Frontend)
     (1) Result: 24
     
    -

    33.2 Basic C/C++ Mapping

    -

    33.2.1 Modules

    +

    35.2 Basic C/C++ Mapping

    +

    35.2.1 Modules

    All of the code for a given SWIG module is wrapped into a single Pike module. Since the name of the shared library that implements your module ultimately determines the module's name (as far as Pike is concerned), SWIG's %module directive doesn't really have any significance.

    -

    33.2.2 Functions

    +

    35.2.2 Functions

    Global functions are wrapped as new Pike built-in functions. For example,

    @@ -40791,7 +45328,7 @@ int fact(int n); (1) Result: 24
    -

    33.2.3 Global variables

    +

    35.2.3 Global variables

    Global variables are currently wrapped as a pair of functions, one to get the current value of the variable and another to set it. For example, the declaration

    @@ -40815,14 +45352,14 @@ double Foo; (3) Result: 3.141590
    -

    33.2.4 Constants and enumerated types

    +

    35.2.4 Constants and enumerated types

    Enumerated types in C/C++ declarations are wrapped as Pike constants, not as Pike enums.

    -

    33.2.5 Constructors and Destructors

    +

    35.2.5 Constructors and Destructors

    Constructors are wrapped as create() methods, and destructors are wrapped as destroy() methods, for Pike classes.

    -

    33.2.6 Static Members

    +

    35.2.6 Static Members

    Since Pike doesn't support static methods or data for Pike classes, static member functions in your C++ classes are wrapped as regular functions and static member variables are wrapped as pairs of functions @@ -40844,7 +45381,7 @@ public: methods, Shape_nshapes_get() and Shape_nshapes_set(), to get and set the value of Shape::nshapes.


    -

    34 SWIG and Python

    +

    36 SWIG and Python

    @@ -40877,7 +45414,13 @@ public:
  • C++ operators
  • C++ namespaces
  • C++ templates
  • -
  • C++ Smart Pointers
  • +
  • C++ Smart Pointers + +
  • C++ reference counted objects
  • @@ -40920,6 +45463,7 @@ public:
  • Simple pointers
  • Unbounded C Arrays
  • String handling
  • +
  • Default arguments
  • Typemaps @@ -40956,12 +45500,34 @@ public:
  • %feature("docstring")
  • -
  • Python Packages
  • +
  • Python Packages + +
  • Python 3 Support
  • @@ -40976,7 +45542,7 @@ public: details are covered in less depth than in earlier chapters. At the very least, make sure you read the "SWIG Basics" chapter.

    -

    34.1 Overview

    +

    36.1 Overview

    To build Python extension modules, SWIG uses a layered approach in which parts of the extension module are defined in C and other parts are defined in Python. The C layer contains low-level wrappers whereas @@ -40991,8 +45557,8 @@ public: Next, the Python interface to common C and C++ programming features is described. Advanced customization features such as typemaps are then described followed by a discussion of low-level implementation details.

    -

    34.2 Preliminaries

    -

    34.2.1 Running SWIG

    +

    36.2 Preliminaries

    +

    36.2.1 Running SWIG

    Suppose that you defined a SWIG module such as the following:

    @@ -41068,11 +45634,11 @@ example_wrap.c or example_wrap.cxx and a Python source
     example, then a file example.py is created.

    The following sections have further practical examples and details on how you might go about compiling and using the generated files.

    -

    34.2.2 Using distutils

    +

    36.2.2 Using distutils

    The preferred approach to building an extension module for python is to compile it with distutils, which comes with all recent versions of - python (Distutils - Docs).

    + python ( +Distutils Docs).

    Distutils takes care of making sure that your extension is built with all the correct flags, headers, etc. for the version of Python it is run with. Distutils will compile your extension into a shared object @@ -41142,7 +45708,7 @@ $ python setup.py build_ext --inplace

    This same approach works on all platforms if the appropriate compiler is installed. (it can even build extensions to the standard Windows Python using MingGW)

    -

    34.2.3 Hand compiling a dynamic module

    +

    36.2.3 Hand compiling a dynamic module

    While the preferred approach to building an extension module is to use the distutils, some people like to integrate building extensions with a larger build system, and thus may wish to compile their modules @@ -41178,7 +45744,7 @@ SWIG Wiki for additional information.

    socket module actually consists of two files; socket.py and _socket.so. Many other built-in Python modules follow a similar convention.

    -

    34.2.4 Static linking

    +

    36.2.4 Static linking

    An alternative approach to dynamic linking is to rebuild the Python interpreter with your extension module added to it. In the past, this approach was sometimes necessary due to limitations in dynamic loading @@ -41211,14 +45777,14 @@ extern double My_variable; interpreter, you simply do something like this:

    -$ swig -python example.i
    +$ swig -python -lembed.i example.i
     $ gcc example.c example_wrap.c \
             -Xlinker -export-dynamic \
    -        -DHAVE_CONFIG_H -I/usr/local/include/python2.1 \
    -	-I/usr/local/lib/python2.1/config \
    -	-L/usr/local/lib/python2.1/config -lpython2.1 -lm -ldl \
    -	-o mypython
    -
    +        -DHAVE_CONFIG_H -I/usr/include/python2.7 \
    +        -I/usr/lib/python2.7/config-x86_64-linux-gnu \
    +        -I/usr/lib/python2.7/config \
    +        -L/usr/lib/python2.7/config -lpython2.7 -lm -ldl \
    +        -o mypython
     

    You will need to supply the same libraries that were used to build @@ -41234,11 +45800,11 @@ $ gcc example.c example_wrap.c \ situations (and quite frankly not worth the extra hassle in the opinion of this author).

    Compatibility note: The embed.i library file is - deprecated and has not been maintained for several years. Even though - it appears to "work" with Python 2.1, no future support is guaranteed. - If using static linking, you might want to rely on a different approach - (perhaps using distutils).

    -

    34.2.5 Using your module

    + deprecated and has not been actively maintained for many years. Even + though it appears to "work" with Python 2.7, no future support is + guaranteed. If using static linking, you might want to rely on a + different approach (perhaps using distutils).

    +

    36.2.5 Using your module

    To use your module, simply use the Python import statement. If all goes well, you will be able to this:

    @@ -41353,7 +45919,7 @@ $ env LD_LIBRARY_PATH=/home/beazley/projects/lib python crle (Solaris) to add additional search paths to the default system configuration (this requires root access and you will need to read the man pages).

    -

    34.2.6 Compilation of C++ extensions

    +

    36.2.6 Compilation of C++ extensions

    Compilation of C++ extensions has traditionally been a tricky problem. Since the Python interpreter is written in C, you need to take steps to make sure C++ is properly initialized and that modules are @@ -41423,7 +45989,7 @@ $ ldd swig you will need to take steps to avoid segmentation faults and other erratic program behavior. If working with lots of software components, you might want to investigate using a more formal standard such as COM.

    -

    34.2.7 Compiling for 64-bit platforms

    +

    36.2.7 Compiling for 64-bit platforms

    On platforms that support 64-bit applications (Solaris, Irix, etc.), special care is required when building extension modules. On these machines, 64-bit applications are compiled and linked using a different @@ -41448,8 +46014,8 @@ $ ldd swig compatibility (under /usr/lib). Also, the compiler options -m32 and -m64 allow you to choose the desired binary format for your python extension.

    -

    34.2.8 Building Python Extensions under - Windows

    +

    36.2.8 Building Python Extensions under + Windows

    Building a SWIG extension to Python under Windows is roughly similar to the process used with Unix. Using the distutils, it is essentially identical. If you have the same version of the MS compiler that Python @@ -41543,12 +46109,12 @@ _MSC_VER ensures it is only used by the Visual Studio compiler:

    DLLs with these compilers tends to be rather problematic. For the latest information, you may want to consult the SWIG Wiki.

    -

    34.3 A tour of basic C/C++ wrapping

    +

    36.3 A tour of basic C/C++ wrapping

    By default, SWIG tries to build a very natural Python interface to your C/C++ code. Functions are wrapped as functions, classes are wrapped as classes, and so forth. This section briefly covers the essential aspects of this wrapping.

    -

    34.3.1 Modules

    +

    36.3.1 Modules

    The SWIG %module directive specifies the name of the Python module. If you specify `%module example', then everything is wrapped into a Python 'example' module. Underneath the covers, @@ -41556,7 +46122,7 @@ _MSC_VER ensures it is only used by the Visual Studio compiler:

    low-level extension module _example.so. When choosing a module name, make sure you don't use the same name as a built-in Python command or standard module name.

    -

    34.3.2 Functions

    +

    36.3.2 Functions

    Global functions are wrapped as new Python built-in functions. For example,

    @@ -41575,7 +46141,7 @@ int fact(int n); >>>
    -

    34.3.3 Global variables

    +

    36.3.3 Global variables

    C/C++ global variables are fully supported by SWIG. However, the underlying mechanism is somewhat different than you might expect due to the way that Python assignment works. When you type the following in @@ -41684,7 +46250,7 @@ $ swig -python -globals myvar example.i the module by giving it a name that starts with a leading underscore. SWIG does not create cvar if there are no global variables in a module.

    -

    34.3.4 Constants and enums

    +

    36.3.4 Constants and enums

    C/C++ constants are installed as Python objects containing the appropriate value. To create a constant, use #define, enum , or the %constant directive. For example:

    @@ -41712,7 +46278,7 @@ enum Beverage { ALE, LAGER, STOUT, PILSNER }; of the constant could be accidentally reassigned to refer to some other object. Unfortunately, there is no easy way for SWIG to generate code that prevents this. You will just have to be careful.

    -

    34.3.5 Pointers

    +

    36.3.5 Pointers

    C/C++ pointers are fully supported by SWIG. Furthermore, SWIG has no problem working with incomplete type information. Here is a rather simple interface:

    @@ -41730,7 +46296,7 @@ int fclose(FILE *);
     >>> import example
    ->>> f = example.fopen("junk","w")
    +>>> f = example.fopen("junk", "w")
     >>> example.fputs("Hello World\n", f)
     >>> example.fclose(f)
     
    @@ -41818,13 +46384,13 @@ Foo *IncrFoo(Foo *f, int i) { style casts. For example, in the above code, the C-style cast may return a bogus result whereas as the C++-style cast will return None if the conversion can't be performed.

    -

    34.3.6 Structures

    +

    36.3.6 Structures

    If you wrap a C structure, it is wrapped by a Python class. This provides a very natural interface. For example,

     struct Vector {
    -	double x,y,z;
    +  double x,y,z;
     };
     
     
    @@ -41956,7 +46522,7 @@ Foo *x = &b->f; /* Points inside b */ >>> x.a = 3 # Modifies the same structure
    -

    34.3.7 C++ classes

    +

    36.3.7 C++ classes

    C++ classes are wrapped by Python classes as well. For example, if you have this class,

    @@ -42024,7 +46590,7 @@ public: 7
    -

    34.3.8 C++ inheritance

    +

    36.3.8 C++ inheritance

    SWIG is fully aware of issues related to C++ inheritance. Therefore, if you have classes like this

    @@ -42061,8 +46627,8 @@ void spam(Foo *f);

    then the function spam() accepts Foo * or a pointer to any class derived from Foo.

    It is safe to use multiple inheritance with SWIG.

    -

    34.3.9 Pointers, references, values, and - arrays

    +

    36.3.9 Pointers, references, values, and + arrays

    In C++, there are many different ways a function might receive and manipulate objects. For example:

    @@ -42106,7 +46672,7 @@ const Foo &spam9(); collected). The fourth case (spam9) which returns a const reference, in most of the cases will be treated as a returning value, and it will follow the same allocation/deallocation process.

    -

    34.3.10 C++ overloaded functions

    +

    36.3.10 C++ overloaded functions

    C++ overloaded functions, methods, and constructors are mostly supported by SWIG. For example, if you have two functions like this:

    @@ -42189,7 +46755,7 @@ void spam(short); // Ignored arises--in this case, the first declaration takes precedence.

    Please refer to the "SWIG and C++" chapter for more information about overloading.

    -

    34.3.11 C++ operators

    +

    36.3.11 C++ operators

    Certain C++ overloaded operators can be handled automatically by SWIG. For example, consider a class like this:

    @@ -42256,7 +46822,7 @@ friend Complex operator+(double, const Complex &c);

    Also, be aware that certain operators don't map cleanly to Python. For instance, overloaded assignment operators don't map to Python semantics and will be ignored.

    -

    34.3.12 C++ namespaces

    +

    36.3.12 C++ namespaces

    SWIG is aware of C++ namespaces, but namespace names do not appear in the module nor do namespaces result in a module that is broken up into submodules or packages. For example, if you have a file like this,

    @@ -42306,7 +46872,7 @@ namespace Bar { extension modules for each namespace separately. If your program utilizes thousands of small deeply nested namespaces each with identical symbol names, well, then you get what you deserve.

    -

    34.3.13 C++ templates

    +

    36.3.13 C++ templates

    C++ templates don't present a huge problem for SWIG. However, in order to create wrappers, you have to tell SWIG to create wrappers for a particular template instantiation. To do this, you use the @@ -42346,7 +46912,16 @@ struct pair {

    Obviously, there is more to template wrapping than shown in this example. More details can be found in the SWIG and C++ chapter. Some more complicated examples will appear later.

    -

    34.3.14 C++ Smart Pointers

    +

    36.3.14 C++ Smart Pointers

    +

    36.3.14.1 The shared_ptr + Smart Pointer

    +

    The C++11 standard provides std::shared_ptr which was + derived from the Boost implementation, boost::shared_ptr. Both + of these are available for Python in the SWIG library and usage is + outlined in the shared_ptr smart + pointer library section.

    +

    36.3.14.2 Generic Smart + Pointers

    In certain C++ programs, it is common to use classes that have been wrapped by so-called "smart pointers." Generally, this involves the use of a template class that implements operator->() like this:

    @@ -42405,12 +46980,12 @@ operator->()
    itself, simply use the __deref__() method. >>> f = p.__deref__() # Returns underlying Foo *
    -

    34.3.15 C++ reference counted objects

    +

    36.3.15 C++ reference counted objects

    The C++ reference counted objects section contains Python examples of memory management using referencing counting.

    -

    34.4 Further details on the Python class - interface

    +

    36.4 Further details on the Python class + interface

    In the previous section, a high-level view of Python wrapping was presented. A key component of this wrapping is that structures and classes are wrapped by Python proxy classes. This provides a very @@ -42426,7 +47001,7 @@ operator->() itself, simply use the __deref__() method. following section ("Proxy classes") does not apply. Details on the use of the -builtin option are in the Built-in Types section.

    -

    34.4.1 Proxy classes

    +

    36.4.1 Proxy classes

    In the "SWIG basics" and "SWIG and C++" chapters, details of low-level structure and class wrapping are described. To summarize those chapters, if you have a @@ -42470,15 +47045,15 @@ int Foo_spam(Foo *f, int arg1) { import _example class Foo(object): - def __init__(self): - self.this = _example.new_Foo() - self.thisown = 1 - def __del__(self): - if self.thisown: - _example.delete_Foo(self.this) - def spam(self,arg1): - return _example.Foo_spam(self.this,arg1) - x = property(_example.Foo_x_get, _example.Foo_x_set) + def __init__(self): + self.this = _example.new_Foo() + self.thisown = 1 + def __del__(self): + if self.thisown: + _example.delete_Foo(self.this) + def spam(self,arg1): + return _example.Foo_spam(self.this,arg1) + x = property(_example.Foo_x_get, _example.Foo_x_set)

    This class merely holds a pointer to the underlying C++ object ( @@ -42496,7 +47071,7 @@ class Foo(object): offers certain advantages. For instance, you can attach new Python methods to the class and you can even inherit from it (something not supported by Python built-in types until Python 2.2).

    -

    34.4.2 Built-in Types

    +

    36.4.2 Built-in Types

    The -builtin option provides a significant performance improvement in the wrapped code. To understand the difference between proxy classes and built-in types, let's take a look at what a wrapped @@ -42507,9 +47082,9 @@ __init__ method looks like in a proxy class:

     class Foo(object):
    -     def __init__(self):
    -         self.this = _example.new_Foo()
    -         self.thisown = 1
    +    def __init__(self):
    +        self.this = _example.new_Foo()
    +        self.thisown = 1
     

    When a Foo instance is created, the call to @@ -42531,7 +47106,7 @@ SwigPyObject; and stores the SwigPyObject instance in the python documentation:

    http://docs.python.org/extending/newtypes.html

    -

    34.4.2.1 Limitations

    +

    36.4.2.1 Limitations

    Use of the -builtin option implies a couple of limitations:

    • @@ -42601,11 +47176,11 @@ private: exception:

      -class MyPyException (Exception) :
      -    def __init__(self, msg, *args) :
      +class MyPyException(Exception):
      +    def __init__(self, msg, *args):
               Exception.__init__(self, *args)
               self.myexc = MyException(msg)
      -    def what (self) :
      +    def what(self):
               return self.myexc.what()
       
    • @@ -42701,8 +47276,8 @@ assert(issubclass(B.Derived, A.Base))
    -

    34.4.2.2 Operator overloads - -- use them!

    +

    36.4.2.2 Operator overloads -- + use them!

    The entire justification for the -builtin option is improved performance. To that end, the best way to squeeze maximum performance out of your wrappers is to use operator overloads. Named method @@ -42784,7 +47359,7 @@ http://docs.python.org/c-api/typeobj.html

    You may override (almost) all of the slots defined in the PyTypeObject, PyNumberMethods, PyMappingMethods, PySequenceMethods, and PyBufferProcs structs.

    -

    34.4.3 Memory management

    +

    36.4.3 Memory management

    NOTE: Although this section refers to proxy objects, everything here also applies when the -builtin option is used.

    Associated with proxy object, is an ownership flag .thisown @@ -42929,13 +47504,13 @@ public:

    It is also possible to deal with situations like this using typemaps--an advanced topic discussed later.

    -

    34.4.4 Python 2.2 and classic classes

    +

    36.4.4 Python 2.2 and classic classes

    SWIG makes every attempt to preserve backwards compatibility with older versions of Python to the extent that it is possible. However, in Python-2.2, an entirely new type of class system was introduced. This new-style class system offers many enhancements including static member functions, properties (managed attributes), and class methods. Details - about all of these changes can be found on + about all of these changes can be found on www.python.org and is not repeated here.

    To address differences between Python versions, SWIG currently emits dual-mode proxy class wrappers. In Python-2.2 and newer releases, these @@ -42945,7 +47520,7 @@ www.python.org and is not repeated here.

    old-style classes are used instead.

    This dual-nature of the wrapper code means that you can create extension modules with SWIG and those modules will work with all - versions of Python ranging from Python-1.4 to the very latest release. + versions of Python ranging from Python-2.0 to the very latest release. Moreover, the wrappers take advantage of Python-2.2 features when available.

    For the most part, the interface presented to users is the same @@ -42954,7 +47529,7 @@ www.python.org and is not repeated here.

    can be accessed via the class itself. In Python-2.1 and earlier, they have to be accessed as a global function or through an instance (see the earlier section).

    -

    34.5 Cross language polymorphism

    +

    36.5 Cross language polymorphism

    Proxy classes provide a more natural, object-oriented way to access extension classes. As described above, each proxy instance has an associated C++ instance, and method calls to the proxy are passed to @@ -42977,7 +47552,7 @@ www.python.org and is not repeated here.

    to know where a particular method is implemented: the combination of proxy classes, director classes, and C wrapper functions takes care of all the cross-language method routing transparently.

    -

    34.5.1 Enabling directors

    +

    36.5.1 Enabling directors

    The director feature is disabled by default. To use directors you must make two changes to the interface file. First, add the "directors" option to the %module directive, like this:

    @@ -43018,6 +47593,7 @@ www.python.org and is not repeated here.

    class Foo { public: Foo(int foo); + virtual ~Foo(); virtual void one(); virtual void two(); }; @@ -43034,14 +47610,15 @@ public: import mymodule class MyFoo(mymodule.Foo): - def __init__(self, foo): - mymodule.Foo(self, foo) + def __init__(self, foo): + mymodule.Foo.__init__(self, foo) +# super().__init__(foo) # Alternative construction for Python3 - def one(self): - print "one from python" + def one(self): + print "one from python"
    -

    34.5.2 Director classes

    +

    36.5.2 Director classes

    For each class that has directors enabled, SWIG generates a new class that derives from both the class in question and a special Swig::Director class. These new classes, referred to as director @@ -43104,7 +47681,7 @@ Swig::Director class. These new classes, referred to as director unmodified proxy classes, all methods are ultimately implemented in C++ so there is no need for the extra overhead involved with routing the calls through Python.

    -

    34.5.3 Ownership and object destruction

    +

    36.5.3 Ownership and object destruction

    Memory management issues are slightly more complicated with directors than for proxy classes alone. Python instances hold a pointer to the associated C++ director object, and the director in turn holds a @@ -43153,7 +47730,7 @@ public:

    In this example, we are assuming that FooContainer will take care of deleting all the Foo pointers it contains at some point. Note that no hard references to the Foo objects remain in Python.

    -

    34.5.4 Exception unrolling

    +

    36.5.4 Exception unrolling

    With directors routing method calls to Python, and proxies routing them to C++, the handling of exceptions is an important concern. By default, the directors ignore exceptions that occur during method calls @@ -43196,7 +47773,7 @@ public: exception. Because the Python error state is still set when Swig::DirectorMethodException is thrown, Python will register the exception as soon as the C wrapper function returns.

    -

    34.5.5 Overhead and code bloat

    +

    36.5.5 Overhead and code bloat

    Enabling directors for a class will generate a new director method for every virtual method in the class' inheritance chain. This alone can generate a lot of code bloat for large hierarchies. Method @@ -43220,7 +47797,7 @@ public: can be optimized by selectively enabling director methods (using the %feature directive) for only those methods that are likely to be extended in Python.

    -

    34.5.6 Typemaps

    +

    36.5.6 Typemaps

    Typemaps for input and output of most of the basic types from director classes have been written. These are roughly the reverse of the usual input and output typemaps used by the wrapper code. The @@ -43228,7 +47805,7 @@ public: 'directorargout'. The director code does not currently use any of the other kinds of typemaps. It is not clear at this point which kinds are appropriate and need to be supported.

    -

    34.5.7 Miscellaneous

    +

    36.5.7 Miscellaneous

    Director typemaps for STL classes are in place, and hence you should be able to use std::vector, std::string, etc., as you would any other type.

    @@ -43259,7 +47836,7 @@ class Foo {

    If that is not possible, the user should avoid enabling the director feature for reentrant, recursive or threaded member methods that return const references.

    -

    34.6 Common customization features

    +

    36.6 Common customization features

    The last section presented the absolute basics of C/C++ wrapping. If you do nothing but feed SWIG a header file, you will get an interface that mimics the behavior described. However, sometimes this isn't @@ -43267,7 +47844,7 @@ class Foo { be missing or the interface to certain functions might be awkward. This section describes some common SWIG features that are used to improve your the interface to an extension module.

    -

    34.6.1 C/C++ helper functions

    +

    36.6.1 C/C++ helper functions

    Sometimes when you create a module, it is missing certain bits of functionality. For example, if you had a function like this

    @@ -43329,7 +47906,7 @@ double mat44_get(double x[4][4], int i, int j) { it works and it wasn't too hard to implement. It is possible to clean this up using Python code, typemaps, and other customization features as covered in later sections.

    -

    34.6.2 Adding additional Python code

    +

    36.6.2 Adding additional Python code

    If writing support code in C isn't enough, it is also possible to write code in Python. This code gets inserted in to the .py file created by SWIG. One use of Python code might be to supply a @@ -43411,6 +47988,29 @@ print("Loading", "Whizz", "Bang", sep=' ... ')

    +

    When using %pythoncode and %pythonbegin you + generally want to make sure that the block is delimited by %{ + and %}. If you delimit it with { and } then + any lines with a leading # will be handled by SWIG as + preprocessor directives, when you probably meant them as Python + comments. Prior to SWIG 3.0.3, invalid preprocessor directives were + silently ignored, so generally using the wrong delimiters resulted in + such comments not appearing in the generated output (though a comment + starting with a valid preprocessor directive could cause problems, for + example: # error handling). SWIG 3.0.3 and later report an + error for invalid preprocessor directives, so you may have to update + existing interface files to delimit blocks of Python code correctly.

    +

    As an alternative to providing a block containing Python code, you + can include python code from a file. The code is inserted exactly as in + the file, so this avoids any issues with the SWIG preprocessor. It's a + good approach if you have a non-trivial chunk of Python code to insert. + To use this feature you specify a filename in double quotes, for + example:

    +
    +
    +%pythoncode "somecode.py"
    +
    +

    Sometimes you may want to replace or modify the wrapper function that SWIG creates in the proxy .py file. The Python module in SWIG provides some features that enable you to do this. First, to entirely @@ -43432,7 +48032,7 @@ def bar(*args): class Foo { public: int bar(int x); -} +};

    where $action will be replaced by the call to the C/C++ @@ -43462,7 +48062,7 @@ public: class Foo { public: int bar(int x); -} +};

    Notes: Usually the pythonappend and pythonprepend @@ -43487,7 +48087,7 @@ public: class Foo { public: int bar(int x); -} +};

    Note that when the underlying C++ method is overloaded, there is @@ -43515,11 +48115,11 @@ class Foo { public: int bar(int x); int bar(); -} +};

    The same applies for overloaded constructors.

    -

    34.6.3 Class extension with %extend

    +

    36.6.3 Class extension with %extend

    One of the more interesting features of SWIG is that it can extend structures and classes with new methods--at least in the Python interface. Here is a simple example:

    @@ -43589,7 +48189,7 @@ Vector(12,14,16)

    %extend works with both C and C++ code. It does not modify the underlying object in any way---the extensions only show up in the Python interface.

    -

    34.6.4 Exception handling with %exception

    +

    36.6.4 Exception handling with %exception

    If a C or C++ function throws an error, you may want to convert that error into a Python exception. To do this, you can use the %exception directive. %exception simply lets you rewrite @@ -43690,12 +48290,12 @@ PyExc_ZeroDivisionError

    The language-independent exception.i library file can also be used to raise exceptions. See the SWIG Library chapter.

    -

    34.7 Tips and techniques

    +

    36.7 Tips and techniques

    Although SWIG is largely automatic, there are certain types of wrapping problems that require additional user input. Examples include dealing with output parameters, strings, binary data, and arrays. This chapter discusses the common techniques for solving these problems.

    -

    34.7.1 Input and output parameters

    +

    36.7.1 Input and output parameters

    A common problem in some C programs is handling parameters passed as simple pointers. For example:

    @@ -43844,7 +48444,7 @@ void foo(Bar *OUTPUT);

    may not have the intended effect since typemaps.i does not define an OUTPUT rule for Bar.

    -

    34.7.2 Simple pointers

    +

    36.7.2 Simple pointers

    If you must work with simple pointers such as int * or double * and you don't want to use typemaps.i, consider using the cpointer.i library file. For example:

    @@ -43896,7 +48496,7 @@ _108fea8_p_int

    See the SWIG Library chapter for further details.

    -

    34.7.3 Unbounded C Arrays

    +

    36.7.3 Unbounded C Arrays

    Sometimes a C function expects an array to be passed as a pointer. For example,

    @@ -43944,7 +48544,7 @@ int sumitems(int *first, int nitems) { other hand, this low-level approach is extremely efficient and well suited for applications in which you need to create buffers, package binary data, etc.

    -

    34.7.4 String handling

    +

    36.7.4 String handling

    If a C function has an argument of char *, then a Python string can be passed as input. For example:

    @@ -43989,7 +48589,78 @@ int parity(char *data, int size, int initial);

    If you need to return binary data, you might use the cstring.i library file. The cdata.i library can also be used to extra binary data from arbitrary pointers.

    -

    34.8 Typemaps

    +

    36.7.5 Default arguments

    +

    C++ default argument code generation is documented in the main +Default arguments section. There is also an optional Python specific + feature that can be used called the python:cdefaultargs +feature flag. By default, SWIG attempts to convert C++ default + argument values into Python values and generates code into the Python + layer containing these values. For example:

    +
    +
    +struct CDA {
    +  int fff(int a = 1, bool b = false);
    +};
    +
    +
    +

    From Python this can be called as follows:

    +
    +
    +>>> CDA().fff()        # C++ layer receives a=1 and b=false
    +>>> CDA().fff(2)       # C++ layer receives a=2 and b=false
    +>>> CDA().fff(3, True) # C++ layer receives a=3 and b=true
    +
    +
    +

    The default code generation in the Python layer is:

    +
    +
    +class CDA(object):
    +    ...
    +    def fff(self, a=1, b=False):
    +        return _default_args.CDA_fff(self, a, b)
    +
    +
    +

    Adding the feature:

    +
    +
    +%feature("python:cdefaultargs") CDA::fff;
    +struct CDA {
    +  int fff(int a = 1, bool b = false);
    +
    +
    +

    results in identical behaviour when called from Python, however, it + results in different code generation:

    +
    +
    +class CDA(object):
    +    ...
    +    def fff(self, *args):
    +        return _default_args.CDA_fff(self, *args)
    +
    +
    +

    The default arguments are obtained in the C++ wrapper layer instead + of the Python layer. Some code generation modes are quite different, eg + -builtin and -fastproxy, and are unaffected by +python:cdefaultargs as the default values are always obtained from + the C++ layer.

    +

    Note that not all default arguments can be converted into a Python + equivalent. When SWIG does not convert them, it will generate code to + obtain them from the C++ layer as if python:cdefaultargs was + specified. This will happen if just one argument cannot be converted + into a Python equivalent. This occurs typically when the argument is + not fully numeric, such as int(1):

    +
    +
    +struct CDA {
    +  int fff(int a = int(1), bool b = false);
    +};
    +
    +
    +

    Compatibility Note: SWIG-3.0.6 introduced the +python:cdefaultargs feature. Versions of SWIG prior to this varied + in their ability to convert C++ default values into equivalent Python + default argument values.

    +

    36.8 Typemaps

    This section describes how you can modify SWIG's default wrapping behavior for various C/C++ datatypes using the %typemap directive. This is an advanced topic that assumes familiarity with the @@ -44000,7 +48671,7 @@ Typemaps" chapter.

    in most cases. Typemaps are only used if you want to change some aspect of the primitive C-Python interface or if you want to elevate your guru status.

    -

    34.8.1 What is a typemap?

    +

    36.8.1 What is a typemap?

    A typemap is nothing more than a code generation rule that is attached to a specific C datatype. For example, to convert integers from Python to C, you might define a typemap like this:

    @@ -44009,8 +48680,8 @@ Typemaps" chapter.

    %module example %typemap(in) int { - $1 = (int) PyLong_AsLong($input); - printf("Received an integer : %d\n",$1); + $1 = (int) PyLong_AsLong($input); + printf("Received an integer : %d\n",$1); } %inline %{ extern int fact(int n); @@ -44043,11 +48714,11 @@ int datatype. You can refine this by supplying an optional %module example %typemap(in) int nonnegative { - $1 = (int) PyLong_AsLong($input); - if ($1 < 0) { - PyErr_SetString(PyExc_ValueError,"Expected a nonnegative value."); - return NULL; - } + $1 = (int) PyLong_AsLong($input); + if ($1 < 0) { + PyErr_SetString(PyExc_ValueError,"Expected a nonnegative value."); + return NULL; + } } %inline %{ extern int fact(int nonnegative); @@ -44065,8 +48736,8 @@ extern int fact(int nonnegative);
     %typemap(in) int n {
    -	$1 = (int) PyLong_AsLong($input);
    -	printf("n = %d\n",$1);
    +  $1 = (int) PyLong_AsLong($input);
    +  printf("n = %d\n",$1);
     }
     %inline %{
     typedef int Integer;
    @@ -44096,7 +48767,7 @@ int count(char c, char *str, int len);
     >>>
     
    -

    34.8.2 Python typemaps

    +

    36.8.2 Python typemaps

    The previous section illustrated an "in" typemap for converting Python objects to C. A variety of different typemap methods are defined by the Python module. For example, to convert a C integer back into a @@ -44121,7 +48792,7 @@ Typemaps" chapter.

    simplicity and pedagogic value.

    To learn how to write a simple or your first typemap, you better take a look at the SWIG library version 1.3.20 or so.

    -

    34.8.3 Typemap variables

    +

    36.8.3 Typemap variables

    Within typemap code, a number of special variables prefaced with a $ may appear. A full list of variables can be found in the " Typemaps" chapter. This is a list of the most common variables:

    @@ -44151,7 +48822,7 @@ Typemaps" chapter. This is a list of the most common variables:

    $symname

    The Python name of the wrapper function being created.
    -

    34.8.4 Useful Python Functions

    +

    36.8.4 Useful Python Functions

    When you write a typemap, you usually have to work directly with Python objects. The following functions may prove to be useful.

    Python Integer Functions

    @@ -44242,11 +48913,11 @@ int PyFile_Check(PyObject *); write me
    -

    34.9 Typemap Examples

    +

    36.9 Typemap Examples

    This section includes a few examples of typemaps. For more examples, you might look at the files "python.swg" and "typemaps.i " in the SWIG library.

    -

    34.9.1 Converting Python list to a char **

    +

    36.9.1 Converting Python list to a char **

    A common problem in many C programs is the processing of command line arguments, which are usually passed in an array of NULL terminated strings. The following SWIG interface file allows a Python list object @@ -44265,11 +48936,11 @@ write me for (i = 0; i < size; i++) { PyObject *o = PyList_GetItem($input,i); if (PyString_Check(o)) - $1[i] = PyString_AsString(PyList_GetItem($input,i)); + $1[i] = PyString_AsString(PyList_GetItem($input,i)); else { - PyErr_SetString(PyExc_TypeError,"list must contain strings"); - free($1); - return NULL; + PyErr_SetString(PyExc_TypeError,"list must contain strings"); + free($1); + return NULL; } } $1[i] = 0; @@ -44303,7 +48974,7 @@ int print_args(char **argv) {

     >>> from argv import *
    ->>> print_args(["Dave","Mike","Mary","Jane","John"])
    +>>> print_args(["Dave", "Mike", "Mary", "Jane", "John"])
     argv[0] = Dave
     argv[1] = Mike
     argv[2] = Mary
    @@ -44317,8 +48988,8 @@ argv[4] = John
      dynamic memory allocation is used to allocate memory for the array, the
      "freearg" typemap is used to later release this memory after the
      execution of the C function.

    -

    34.9.2 Expanding a Python object into - multiple arguments

    +

    36.9.2 Expanding a Python object into multiple + arguments

    Suppose that you had a collection of C functions with arguments such as the following:

    @@ -44331,7 +49002,7 @@ int foo(int argc, char **argv); Python as follows:

    ->>> foo(4, ["foo","bar","spam","1"])
    +>>> foo(4, ["foo", "bar", "spam", "1"])
     

    Although this works, it's a little awkward to specify the argument @@ -44349,11 +49020,11 @@ int foo(int argc, char **argv); for (i = 0; i < $1; i++) { PyObject *o = PyList_GetItem($input,i); if (PyString_Check(o)) - $2[i] = PyString_AsString(PyList_GetItem($input,i)); + $2[i] = PyString_AsString(PyList_GetItem($input,i)); else { - PyErr_SetString(PyExc_TypeError,"list must contain strings"); - free($2); - return NULL; + PyErr_SetString(PyExc_TypeError,"list must contain strings"); + free($2); + return NULL; } } $2[i] = 0; @@ -44377,10 +49048,38 @@ int foo(int argc, char **argv); the typemap code. For example:

    ->>> foo(["foo","bar","spam","1"])
    +>>> foo(["foo", "bar", "spam", "1"])
     
    -

    34.9.3 Using typemaps to return arguments

    +

    If your function is overloaded in C++, for example:

    +
    +
    +int foo(int argc, char **argv);
    +int foo();
    +
    +
    +

    don't forget to also provide a suitable +typecheck typemap for overloading such as:

    +
    +
    +%typecheck(SWIG_TYPECHECK_STRING_ARRAY) (int argc, char **argv) {
    +  $1 = PyList_Check($input) ? 1 : 0;
    +}
    +
    +
    +

    If you don't you'll get an error message along the lines of:

    +
    +
    +Traceback (most recent call last):
    +  File "runme.py", line 3, in >module<
    +    example.foo(["foo", "bar", "spam", "1"])
    +NotImplementedError: Wrong number or type of arguments for overloaded function 'foo'.
    +  Possible C/C++ prototypes are:
    +    foo(int,char **)
    +    foo()
    +
    +
    +

    36.9.3 Using typemaps to return arguments

    A common problem in some C programs is that values may be returned in arguments rather than in the return value of a function. For example:

    @@ -44388,12 +49087,11 @@ int foo(int argc, char **argv);
     /* Returns a status value and two values in out1 and out2 */
     int spam(double a, double b, double *out1, double *out2) {
    -	... Do a bunch of stuff ...
    -	*out1 = result1;
    -	*out2 = result2;
    -	return status;
    -};
    -
    +  ... Do a bunch of stuff ...
    +  *out1 = result1;
    +  *out2 = result2;
    +  return status;
    +}
     

    A typemap can be used to handle this case as follows :

    @@ -44406,23 +49104,23 @@ int spam(double a, double b, double *out1, double *out2) { // is guaranteed to be a List object by SWIG. %typemap(argout) double *OutValue { - PyObject *o, *o2, *o3; - o = PyFloat_FromDouble(*$1); - if ((!$result) || ($result == Py_None)) { - $result = o; - } else { - if (!PyTuple_Check($result)) { - PyObject *o2 = $result; - $result = PyTuple_New(1); - PyTuple_SetItem(target,0,o2); - } - o3 = PyTuple_New(1); - PyTuple_SetItem(o3,0,o); - o2 = $result; - $result = PySequence_Concat(o2,o3); - Py_DECREF(o2); - Py_DECREF(o3); + PyObject *o, *o2, *o3; + o = PyFloat_FromDouble(*$1); + if ((!$result) || ($result == Py_None)) { + $result = o; + } else { + if (!PyTuple_Check($result)) { + PyObject *o2 = $result; + $result = PyTuple_New(1); + PyTuple_SetItem($result,0,o2); } + o3 = PyTuple_New(1); + PyTuple_SetItem(o3,0,o); + o2 = $result; + $result = PySequence_Concat(o2,o3); + Py_DECREF(o2); + Py_DECREF(o3); + } } int spam(double a, double b, double *OutValue, double *OutValue); @@ -44461,8 +49159,8 @@ int spam(double a, double b, double *OutValue, double *OutValue); >>>
    -

    34.9.4 Mapping Python tuples into small - arrays

    +

    36.9.4 Mapping Python tuples into small arrays +

    In some applications, it is sometimes desirable to pass small arrays of numbers as arguments. For example :

    @@ -44500,7 +49198,7 @@ extern void set_direction(double a[4]); // Set direction vector

    Since our mapping copies the contents of a Python tuple into a C array, such an approach would not be recommended for huge arrays, but for small structures, this approach works fine.

    -

    34.9.5 Mapping sequences to C arrays

    +

    36.9.5 Mapping sequences to C arrays

    Suppose that you wanted to generalize the previous example to handle C arrays of different sizes. To do this, you might write a typemap as follows:

    @@ -44579,7 +49277,7 @@ static int convert_darray(PyObject *input, double *ptr, int size) { }
    -

    34.9.6 Pointer handling

    +

    36.9.6 Pointer handling

    Occasionally, it might be necessary to convert pointer values that have been stored using the SWIG typed-pointer representation. Since there are several ways in which pointers can be represented, the @@ -44644,7 +49342,7 @@ if ((SWIG_ConvertPtr($input,(void **) &$1, $descriptor(Foo *), retrieve a pointer from any object that has a this attribute. In addition, SWIG_NewPointerObj() can automatically generate a proxy class object (if applicable).

    -

    34.10 Docstring Features

    +

    36.10 Docstring Features

    Using docstrings in Python code is becoming more and more important and more tools are coming on the scene that take advantage of them, everything from full-blown documentation generators to class browsers @@ -44662,7 +49360,7 @@ bool function_name(int x, int y, Foo* foo=NULL, Bar* bar=NULL); docstrings to your modules, functions and methods that can then be used by the various tools out there to make the programming experience of your users much simpler.

    -

    34.10.1 Module docstring

    +

    36.10.1 Module docstring

    Python allows a docstring at the beginning of the .py file before any other statements, and it is typically used to give a general description of the entire module. SWIG supports this by setting an @@ -44685,7 +49383,7 @@ layout of controls on a panel, etc. to be loaded from an XML file." %module(docstring=DOCSTRING) xrc

    -

    34.10.2 %feature("autodoc")

    +

    36.10.2 %feature("autodoc")

    As alluded to above SWIG will generate all the function and method proxy wrappers with just "*args" (or "*args, **kwargs" if the -keyword option is used) for a parameter list and will then sort out the @@ -44706,7 +49404,7 @@ layout of controls on a panel, etc. to be loaded from an XML file." four levels for autodoc controlled by the value given to the feature, %feature("autodoc", "level"). The four values for level are covered in the following sub-sections.

    -

    34.10.2.1 %feature("autodoc", "0")

    +

    36.10.2.1 %feature("autodoc", "0")

    When level "0" is used then the types of the parameters will not be included in the autodoc string. For example, given this function prototype:

    @@ -44724,7 +49422,7 @@ def function_name(*args, **kwargs): ... -

    34.10.2.2 %feature("autodoc", "1")

    +

    36.10.2.2 %feature("autodoc", "1")

    When level "1" is used then the parameter types will be used in the autodoc string. In addition, an attempt is made to simplify the type name such that it makes more sense to the Python user. @@ -44741,21 +49439,24 @@ def function_name(*args, **kwargs): ... -

    34.10.2.3 %feature("autodoc", "2")

    +

    36.10.2.3 %feature("autodoc", "2")

    Level "2" results in the function prototype as per level "0". In - addition, a line of documentation is generated for each parameter. - Using the previous example, the generated code will be:

    + addition, a line of documentation is generated for each parameter using + +numpydoc style. Using the previous example, the generated code will + be:

     def function_name(*args, **kwargs):
         """
         function_name(x, y, foo=None, bar=None) -> bool
     
    -    Parameters:
    -        x: int
    -        y: int
    -        foo: Foo *
    -        bar: Bar *
    +    Parameters
    +    ----------
    +    x: int
    +    y: int
    +    foo: Foo *
    +    bar: Bar *
     
         """
         ...
    @@ -44780,16 +49481,17 @@ def function_name(*args, **kwargs):
       """
         function_name(x, y, foo=None, bar=None) -> bool
     
    -    Parameters:
    -        x (C++ type: int) -- Input x dimension
    -        y: int
    -        foo: Foo *
    -        bar: Bar *
    +    Parameters
    +    ----------
    +    x (C++ type: int) -- Input x dimension
    +    y: int
    +    foo: Foo *
    +    bar: Bar *
     
         """
     
    -

    34.10.2.4 %feature("autodoc", "3")

    +

    36.10.2.4 %feature("autodoc", "3")

    Level "3" results in the function prototype as per level "1" but also contains the same additional line of documentation for each parameter as per level "2". Using our earlier example again, the @@ -44800,17 +49502,18 @@ def function_name(*args, **kwargs): """ function_name(int x, int y, Foo foo=None, Bar bar=None) -> bool - Parameters: - x: int - y: int - foo: Foo * - bar: Bar * + Parameters + ---------- + x: int + y: int + foo: Foo * + bar: Bar * """ ... -

    34.10.2.5 %feature("autodoc", "docstring")

    +

    36.10.2.5 %feature("autodoc", "docstring")

    Finally, there are times when the automatically generated autodoc string will make no sense for a Python programmer, particularly when a typemap is involved. So if you give an explicit value for the autodoc @@ -44822,7 +49525,7 @@ def function_name(*args, **kwargs): void GetPosition(int* OUTPUT, int* OUTPUT); -

    34.10.3 %feature("docstring")

    +

    36.10.3 %feature("docstring")

    In addition to the autodoc strings described above, you can also attach any arbitrary descriptive text to a node in the parse tree with the "docstring" feature. When the proxy module is generated then any @@ -44844,10 +49547,67 @@ with more than one line. """ -

    34.11 Python Packages

    -

    Using the package option of the %module directive - allows you to specify what Python package that the module will be - living in when installed.

    +

    36.11 Python Packages

    +

    Python has concepts of modules and packages. Modules are separate + units of code and may be grouped together to form a package. Packages + may be nested, that is they may contain subpackages. This leads to + tree-like hierarchy, with packages as intermediate nodes and modules as + leaf nodes.

    +

    The hierarchy of Python packages/modules follows the hierarchy of +*.py files found in a source tree (or, more generally, in the + Python path). Normally, the developer creates new module by placing a +*.py file somewhere under Python path; the module is then named + after that *.py file. A package is created by placing an +__init__.py file within a directory; the package is then named + after that directory. For example, the following source tree:

    +
    +
    +mod1.py
    +pkg1/__init__.py
    +pkg1/mod2.py
    +pkg1/pkg2/__init__.py
    +pkg1/pkg2/mod3.py
    +
    +
    +

    defines the following Python packages and modules:

    +
    +
    +pkg1            # package
    +pkg1.pkg2       # package
    +mod1            # module
    +pkg1.mod2       # module
    +pkg1.pkg2.mod3  # module
    +
    +
    +

    The purpose of an __init__.py file is two-fold. First, the + existence of __init__.py in a directory informs the Python + interpreter that this directory contains a Python package. Second, the + code in __init__.py is loaded/executed automatically when the + package is initialized (when it or its submodule/subpackage gets +import'ed). By default, SWIG generates proxy Python code – one +*.py file for each *.i interface. The __init__.py + files, however, are not generated by SWIG. They should be created by + other means. Both files (module *.py and __init__.py) + should be installed in appropriate destination directories in order to + obtain a desirable package/module hierarchy.

    +

    Python3 adds another option for packages with +PEP 0420 (implicit namespace packages). Implicit namespace packages + no longer use __init__.py files. SWIG generated Python modules support + implicit namespace packages. See +36.11.5 Implicit Namespace Packages for more information.

    +

    If you place a SWIG generated module into a Python package then + there are details concerning the way SWIG +searches for the wrapper module that you may want to familiarize + yourself with.

    +

    The way Python defines its modules and packages impacts SWIG users. + Some users may need to use special features such as the package + option in the %module directive or import related command line + options. These are explained in the following sections.

    +

    36.11.1 Setting the Python package +

    +

    Using the package option in the %module directive + allows you to specify a Python package that the module will be in when + installed.

     %module(package="wx") xrc
    @@ -44856,12 +49616,474 @@ with more than one line.
     

    This is useful when the .i file is %imported by another .i file. By default SWIG will assume that the importer is able to find the importee with just the module name, but if they - live in separate Python packages then that won't work. However if the + live in separate Python packages then this won't work. However if the importee specifies what its package is with the %module option then the Python code generated for the importer will use that package - name when importing the other module and also in base class - declarations, etc. if the package name is different than its own.

    -

    34.12 Python 3 Support

    + name when importing the other module and in base class declarations, + etc..

    +

    SWIG assumes that the package option provided to %module + together with the module name (that is, wx.xrc in the + above example) forms a fully qualified (absolute) name of a module (in + Python terms). This is important especially for Python 3, where + absolute imports are used by default. It's up to you to place the + generated module files (.py, .so) in appropriate + subdirectories. For example, if you have an interface file foo.i + with:

    +
    +
    +%module(package="pkg1.pkg2") foo
    +
    +
    +

    then the resulting directory layout should be

    +
    +
    +pkg1/
    +pkg1/__init__.py
    +pkg1/pkg2/__init__.py
    +pkg1/pkg2/foo.py        # (generated by SWIG)
    +pkg1/pkg2/_foo.so       # (shared library built from C/C++ code generated by SWIG)
    +
    +
    +

    36.11.2 Absolute and relative imports +

    +

    Suppose, we have the following hierarchy of files:

    +
    +
    +pkg1/
    +pkg1/__init__.py
    +pkg1/mod2.py
    +pkg1/pkg2/__init__.py
    +pkg1/pkg2/mod3.py
    +
    +
    +

    Let the contents of pkg1/pkg2/mod3.py be

    +
    +
    +class M3: pass
    +
    +
    +

    We edit pkg1/mod2.py and want to import module +pkg1/pkg2/mod3.py in order to derive from class M3. We can + write appropriate Python code in several ways, for example:

    +
      +
    1. +

      Using "import <>" syntax with absolute package name:

      +
      +
      +# pkg1/mod2.py
      +import pkg1.pkg2.mod3
      +class M2(pkg1.pkg2.mod3.M3): pass
      +
      +
    2. +
    3. +

      Using "import <>" syntax with package name relative to +pkg1 (only in Python 2.7 and earlier):

      +
      +
      +# pkg1/mod2.py
      +import pkg2.mod3
      +class M2(pkg2.mod3.M3): pass
      +
      +
    4. +
    5. +

      Using "from <> import <>" syntax (relative import syntax, + only in Python 2.5 and later):

      +
      +
      +# pkg1/mod2.py
      +from .pkg2 import mod3
      +class M2(mod3.M3): pass
      +
      +
    6. +
    7. +

      Other variants, for example the following construction in order to + have the pkg2.mod3.M3 symbol available in mod2 as in + point 2 above (but now under Python 3):

      +
      +
      +# pkg1/mod2.py
      +from . import pkg2
      +from .pkg2 import mod3
      +class M2(pkg2.mod3.M3): pass
      +
      +
    8. +
    +

    Now suppose we have mod2.i with

    +
    +
    +// mod2.i
    +%module (package="pkg1") mod2
    +%import "mod3.i"
    +// ...
    +
    +
    +

    and mod3.i with

    +
    +
    +// mod3.i
    +%module (package="pkg1.pkg2") mod3
    +// ...
    +
    +
    +

    By default, SWIG would generate mod2.py proxy file with +import directive as in point 1. This can be changed with the +-relativeimport command line option. The -relativeimport + instructs SWIG to organize imports as in point 2 (for Python < 2.7.0) + or as in point 4 for Python 2.7.0 and newer. This is a check done at + the time the module is imported. In short, if you have mod2.i + and mod3.i as above, then without -relativeimport + SWIG will write

    +
    +
    +import pkg1.pkg2.mod3
    +
    +
    +

    to mod2.py proxy file, and with -relativeimport it + will write

    +
    +
    +from sys import version_info
    +if version_info >= (2, 7, 0):
    +    from . import pkg2
    +    import pkg1.pkg2.mod3
    +else:
    +    import pkg2.mod3
    +del version_info
    +
    +
    +

    You should avoid using relative imports and use absolute ones + whenever possible. There are some cases, however, when relative imports + may be necessary. The first example is, when some (legacy) Python code + refers entities imported by proxy files generated by SWIG, and it + assumes that the proxy file uses relative imports. Second case is, when + one puts import directives in __init__.py to import symbols + from submodules or subpackages and the submodule depends on other + submodules (discussed later).

    +

    36.11.3 Enforcing absolute import + semantics

    +

    As you may know, there is an incompatibility in import semantics (for + the import <> syntax) between Python 2 and 3. In Python 2.4 + and earlier it is not clear whether

    +
    +
    +import foo
    +
    +
    +

    refers to a top-level module or to another module inside the current + package. In Python 3 it always refers to a top-level module (see +PEP 328). To instruct Python 2.5 through 2.7 to use new semantics + (that is import foo is interpreted as absolute import), one + has to put the following line

    +
    +
    +from __future__ import absolute_import
    +
    +
    +

    at the very beginning of his proxy *.py file. In SWIG, it + may be accomplished with %pythonbegin directive as follows:

    +
    +
    +%pythonbegin %{
    +from __future__ import absolute_import
    +%}
    +
    +
    +

    36.11.4 Importing from __init__.py +

    +

    Imports in __init__.py are handy when you want to populate a + package's namespace with names imported from other modules. In SWIG + based projects this approach may also be used to split large pieces of + code into smaller modules, compile them in parallel and then + re-assemble everything at runtime by importing submodules' contents in +__init__.py, for example.

    +

    Unfortunately import directives in __init__.py may cause + problems, especially if they refer to a package's submodules. This is + caused by the way Python initializes packages. If you spot problems + with imports from __init__.py try using -relativeimport + option. Below we explain in detail one issue, for which the +-relativeimport workaround may be helpful.

    +

    Consider the following example (Python 3):

    +
    +
    +pkg1/__init__.py        # (empty)
    +pkg1/pkg2/__init__.py   # (imports something from bar.py)
    +pkg1/pkg2/foo.py
    +pkg1/pkg2/bar.py        # (imports foo.py)
    +
    +
    +

    If the file contents are:

    +
      +
    • +

      pkg1/pkg2/__init__.py:

      +
      +
      +# pkg1/pkg2/__init__.py
      +from .bar import Bar
      +
      +
    • +
    • +

      pkg1/pkg2/foo.py:

      +
      +
      +# pkg1/pkg2/foo.py
      +class Foo: pass
      +
      +
    • +
    • +

      pkg1/pkg2/bar.py:

      +
      +
      +# pkg1/pkg2/bar.py
      +import pkg1.pkg2.foo
      +class Bar(pkg1.pkg2.foo.Foo): pass
      +
      +
    • +
    +

    Now if one simply used import pkg1.pkg2, it will usually + fail:

    +
    +
    +>>> import pkg1.pkg2
    +Traceback (most recent call last):
    +  File "<stdin>", line 1, in <module>
    +  File "./pkg1/pkg2/__init__.py", line 2, in <module>
    +    from .bar import Bar
    +  File "./pkg1/pkg2/bar.py", line 3, in <module>
    +    class Bar(pkg1.pkg2.foo.Foo): pass
    +AttributeError: 'module' object has no attribute 'pkg2'
    +
    +
    +

    Surprisingly, if we execute the import pkg1.pkg2 directive + for the second time, it succeeds. The reason seems to be following: + when Python spots the from .bar import Bar directive in +pkg1/pkg2/__init__.py it starts loading pkg1/pkg2/bar.py. + This module imports pkg1.pkg2.foo in turn and tries to use +pkg1.pkg2.foo.Foo, but the package pkg1 is not fully + initialized yet (the initialization procedure is actually in progress) + and it seems like the effect of the already seen import + pkg1.pkg2.pkg3.foo is "delayed" or ignored. Exactly the same may + happen to a proxy module generated by SWIG.

    +

    One workaround for this case is to use a relative import in +pkg1/pkg2/bar.py. If we change bar.py to be:

    +
    +
    +from .pkg3 import foo
    +class Bar(foo.Foo): pass
    +
    +
    +

    or

    +
    +
    +from . import pkg3
    +from .pkg3 import foo
    +class Bar(pkg3.foo.Foo): pass
    +
    +
    +

    then the example works again. With SWIG, you need to enable the +-relativeimport option in order to have the above workaround in + effect (note, that the Python 2 case also needs the -relativeimport + workaround).

    +

    36.11.5 Implicit + Namespace Packages

    +

    Python 3.3 introduced +PEP 0420 which implements implicit namespace packages. In a + nutshell, implicit namespace packages remove the requirement of an + __init__.py file and allow packages to be split across multiple PATH + elements. For example:

    +
    +
    +/fragment1/pkg1/mod1.py
    +/fragment2/pkg1/mod2.py
    +/fragment3/pkg1/mod3.py
    +
    +
    +

    If PYTHONPATH is set to "/fragment1:/fragment2:/fragment3", then + mod1, mod2 and mod3 will be part of pkg1. This allows for splitting of + packages into separate pieces. This can be useful for SWIG generated + wrappers in the following way.

    +

    Suppose you create a SWIG wrapper for a module called robin. The + SWIG generated code consists of two files robin.py and _robin.so. You + wish to make these modules part of a subpackage (brave.sir). With + implicit namespace packages you can place these files in the following + configurations:

    +

    Using PYTHONPATH="/some/path"

    +
    +
    +/some/path/brave/sir/robin.py
    +/some/path/brave/sir/_robin.so
    +
    +
    +

    Using PYTHONPATH="/some/path:/some/other/path"

    +
    +/some/path/brave/sir/robin.py
    +/some/other/path/brave/sir/_robin.so
    +
    +

    +

    Finally suppose that your pure python code is stored in a .zip file + or some other way (database, web service connection, etc). Python can + load the robin.py module using a custom importer. But the _robin.so + module will need to be located on a file system. Implicit namespace + packages make this possible. For example, using + PYTHONPATH="/some/path/foo.zip:/some/other/path"

    +

    Contents of foo.zip

    +
    +
    +brave/
    +brave/sir/
    +brave/sir/robin.py
    +
    +
    +

    File system contents

    +
    +
    +/some/other/path/brave/sir/_robin.so
    +
    +
    +

    Support for implicit namespace packages was added to python-3.3. The + zipimporter requires python-3.5.1 or newer to work with subpackages.

    +

    Compatibility Note: Support for implicit namespace packages + was added in SWIG-3.0.9.

    +

    36.11.6 Searching for the wrapper + module

    +

    When SWIG creates wrappers from an interface file, say foo.i, two + Python modules are created. There is a pure Python module module + (foo.py) and C/C++ code which is built and linked into a dynamically + (or statically) loaded module _foo (see the +Preliminaries section for details). So, the interface file really + defines two Python modules. How these two modules are loaded is covered + next.

    +

    The pure Python module needs to load the C/C++ module in order to + link to the wrapped C/C++ methods. To do this it must make some + assumptions about what package the C/C++ module may be located in. The + approach the pure Python module uses to find the C/C++ module is as + follows:

    +
      +
    1. +

      The pure Python module, foo.py, tries to load the C/C++ module, _foo, + from the same package foo.py is located in. The package name is + determined from the __name__ attribute given to foo.py by the + Python loader that imported foo.py. If foo.py is not in a package then + _foo is loaded as a global module.

      +
    2. +
    3. +

      If the above import of _foo results in an ImportError being thrown, + then foo.py makes a final attempt to load _foo as a global module.

      +
    4. +
    +

    As an example suppose foo.i is compiled into foo.py and _foo.so. + Assuming /dir is on PYTHONPATH, then the two modules can be installed + and used in the following ways:

    +

    36.11.6.1 Both + modules in the same package

    +

    Both modules are in one package:

    +
    +
    +/dir/package/foo.py
    +/dir/package/__init__.py
    +/dir/package/_foo.so
    +
    +
    +

    And imported with

    +
    +
    +from package import foo
    +
    +
    +

    36.11.6.2 Split + modules

    +

    The pure python module is in a package and the C/C++ module is + global:

    +
    +
    +/dir/package/foo.py
    +/dir/package/__init__.py
    +/dir/_foo.so
    +
    +
    +

    And imported with

    +
    +
    +from package import foo
    +
    +
    +

    36.11.6.3 Both + modules are global

    +

    Both modules are global:

    +
    +
    +/dir/foo.py
    +/dir/_foo.so
    +
    +
    +

    And imported with

    +
    +
    +import foo
    +
    +
    +

    If _foo is statically linked into an embedded Python interpreter, + then it may or may not be in a Python package. This depends in the + exact way the module was loaded statically. The above search order will + still be used for statically loaded modules. So, one may place the + module either globally or in a package as desired.

    +

    36.11.6.4 Statically linked C + modules

    +

    It is strongly recommended to use dynamically linked modules for the + C portion of your pair of Python modules. If for some reason you still + need to link the C module of the pair of Python modules generated by + SWIG into your interpreter, then this section provides some details on + how this impacts the pure Python modules ability to locate the other + part of the pair. Please also see the Static + Linking section.

    +

    When Python is extended with C code the Python interpreter needs to + be informed about details of the new C functions that have been linked + into the executable. The code to do this is created by SWIG and is + automatically called in the correct way when the module is dynamically + loaded. However when the code is not dynamically loaded (because it is + statically linked) Then the initialization method for the module + created by SWIG is not called automatically and the Python interpreter + has no idea that the new SWIG C module exists.

    +

    Before Python 3, one could simply call the init method created by + SWIG which would have normally been called when the shared object was + dynamically loaded. The specific name of this method is not given here + because statically linked modules are not encouraged with SWIG ( +Static Linking). However one can find this init function in the C + file generated by SWIG.

    +

    If you are really keen on static linking there are two ways to + initialize the SWIG generated C module with the init method. Which way + you use depends on what version of Python your module is being linked + with. Python 2 and Python 3 treat this init function differently. And + the way they treat it affects how the pure Python module will be able + to locate the C module.

    +

    The details concerning this are covered completly in the + documentation for Python itself. Links to the relavent sections follow:

    + +

    There are two keys things to understand. The first is that in Python + 2 the init() function returns void. In Python 3 the init() function + returns a PyObject * which points to the new module. Secondly, when you + call the init() method manually, you are the Python importer. So, you + determine which package the C module will be located in.

    +

    So, if you are using Python 3 it is important that you follow what is + described in the Python documentation linked above. In particular, you + can't simply call the init() function generated by SWIG and cast the + PyObject pointer it returns over the side. If you do then Python 3 will + have no idea that your C module exists and the pure Python half of your + wrapper will not be able to find it. You need to register your module + with the Python interpreter as described in the Python docs.

    +

    With Python 2 things are somewhat more simple. In this case the init + function returns void. Calling it will register your new C module as a + global module. The pure Python part of the SWIG wrapper will be + able to find it because it tries both the pure Python module it is part + of and the global module. If you wish not to have the statically linked + module be a global module then you will either need to refer to the + Python documentation on how to do this (remember you are now the Python + importer) or use dynamic linking.

    +

    36.12 Python 3 Support

    SWIG is able to support Python 3.0. The wrapper code generated by SWIG can be compiled with both Python 2.x or 3.0. Further more, by passing the -py3 command line option to SWIG, wrapper code @@ -44878,7 +50100,7 @@ with more than one line.

    The following are Python 3.0 new features that are currently supported by SWIG.

    -

    34.12.1 Function annotation

    +

    36.12.1 Function annotation

    The -py3 option will enable function annotation support. When used SWIG is able to generate proxy method definitions like this:

    @@ -44898,9 +50120,9 @@ with more than one line. may be append depend on whether you enabled the keyword argument. This fallback is due to all overloaded functions share the same function in SWIG generated proxy class.

    -

    For detailed usage of function annotation, see +

    For detailed usage of function annotation, see PEP 3107.

    -

    34.12.2 Buffer interface

    +

    36.12.2 Buffer interface

    Buffer protocols were revised in Python 3. SWIG also gains a series of new typemaps to support buffer interfaces. These typemap macros are defined in pybuffer.i, which must be included in order to use @@ -44992,42 +50214,239 @@ bytearray(b'FOO\x00') immutable buffers. As a result, the wrapped function should not modify the buffer.

    -

    %pybuffer_string(parm)

    -
    -

    This macro maps an object's buffer as a string pointer parm -. It is similar to %pybuffer_mutable_string but the buffer - could be both mutable and immutable. And your function should not - modify the buffer.

    +

    %pybuffer_string(parm)

    +
    +

    This macro maps an object's buffer as a string pointer parm +. It is similar to %pybuffer_mutable_string but the buffer + could be both mutable and immutable. And your function should not + modify the buffer.

    +
    +

    36.12.3 Abstract base classes

    +

    By including pyabc.i and using the -py3 command + line option when calling SWIG, the proxy classes of the STL containers + will automatically gain an appropriate abstract base class. For + example, the following SWIG interface:

    +
    +
    +%include <pyabc.i>
    +%include <std_map.i>
    +%include <std_list.i>
    +
    +namespace std {
    +  %template(Mapii) map<int, int>;
    +  %template(IntList) list<int>;
    +}
    +
    +
    +

    will generate a Python proxy class Mapii inheriting from +collections.MutableMap and a proxy class IntList + inheriting from collections.MutableSequence.

    +

    pyabc.i also provides a macro %pythonabc that + could be used to define an abstract base class for your own C++ class:

    +
    +
    +%pythonabc(MySet, collections.MutableSet);
    +
    +
    +

    For details of abstract base class, please see +PEP 3119.

    +

    36.12.4 Byte string output conversion

    +

    By default, any byte string (char* or std::string) + returned from C or C++ code is decoded to text as UTF-8. This decoding + uses the surrogateescape error handler under Python 3.1 or + higher -- this error handler decodes invalid byte sequences to high + surrogate characters in the range U+DC80 to U+DCFF. As an example, + consider the following SWIG interface, which exposes a byte string that + cannot be completely decoded as UTF-8:

    +
    +
    +%module example
    +
    +%include <std_string.i>
    +
    +%inline %{
    +
    +const char* non_utf8_c_str(void) {
    +        return "h\xe9llo w\xc3\xb6rld";
    +}
    +
    +%}
    +
    +
    +

    When this method is called from Python 3, the return value is the + following text string:

    +
    +
    +>>> s = example.non_utf8_c_str()
    +>>> s
    +'h\udce9llo wörld'
    +
    +
    +

    Since the C string contains bytes that cannot be decoded as UTF-8, + those raw bytes are represented as high surrogate characters that can + be used to obtain the original byte sequence:

    +
    +
    +>>> b = s.encode('utf-8', errors='surrogateescape')
    +>>> b
    +b'h\xe9llo w\xc3\xb6rld'
    +
    +
    +

    One can then attempt a different encoding, if desired (or simply + leave the byte string as a raw sequence of bytes for use in binary + protocols):

    +
    +
    +>>> b.decode('latin-1')
    +'héllo wörld'
    +
    +
    +

    Note, however, that text strings containing surrogate characters are + rejected with the default strict codec error handler. For + example:

    +
    +
    +>>> with open('test', 'w') as f:
    +...     print(s, file=f)
    +...
    +Traceback (most recent call last):
    +  File "<stdin>", line 2, in <module>
    +UnicodeEncodeError: 'utf-8' codec can't encode character '\udce9' in position 1: surrogates not allowed
    +
    +
    +

    This requires the user to check most strings returned by SWIG + bindings, but the alternative is for a non-UTF8 byte string to be + completely inaccessible in Python 3 code.

    +

    For more details about the surrogateescape error handler, + please see PEP 383 +.

    +

    In some cases, users may wish to instead handle all byte strings as + bytes objects in Python 3. This can be accomplished by adding +SWIG_PYTHON_STRICT_BYTE_CHAR to the generated code:

    +
    +
    +%module char_to_bytes
    +%begin %{
    +#define SWIG_PYTHON_STRICT_BYTE_CHAR
    +%}
    +
    +char *charstring(char *s) {
    +  return s;
    +}
    +
    +
    +

    This will modify the behavior so that only Python 3 bytes objects + will be accepted and converted to a C/C++ string, and any string + returned from C/C++ will be converted to a bytes object in Python 3:

    +
    +
    +>>> from char_to_bytes import *
    +>>> charstring(b"hi") # Byte string
    +b'hi'
    +>>> charstring("hi")  # Unicode string
    +Traceback (most recent call last):
    +  File "<stdin>", line 1, in ?
    +TypeError: in method 'charstring', argument 1 of type 'char *'
    +
    +
    +

    Note that in Python 2, defining SWIG_PYTHON_STRICT_BYTE_CHAR + has no effect, since strings in Python 2 are equivalent to Python 3 + bytes objects. However, there is a similar capability to force + unicode-only handling for wide characters C/C++ strings (wchar_t * + or std::wstring types) in Python 2. By default, in Python 2 + both strings and unicode strings are converted to C/C++ wide strings, + and returned wide strings are converted to a Python unicode string. To + instead only convert unicode strings to wide strings, users can add +SWIG_PYTHON_STRICT_UNICODE_WCHAR to the generated code:

    +
    +
    +%module wchar_to_unicode
    +%begin %{
    +#define SWIG_PYTHON_STRICT_UNICODE_WCHAR
    +%}
    +
    +wchar_t *wcharstring(wchar_t *s) {
    +  return s;
    +}
    +
    +
    +

    This ensures that only unicode strings are accepted by wcharstring + in both Python 2 and Python 3:

    +
    +
    +>>> from wchar_to_unicode import *
    +>>> wcharstring(u"hi") # Unicode string
    +u'hi'
    +>>> wcharstring(b"hi") # Byte string
    +Traceback (most recent call last):
    +  File "<stdin>", line 1, in ?
    +TypeError: in method 'charstring', argument 1 of type 'wchar_t *'
    +
    +
    +

    By defining both SWIG_PYTHON_STRICT_BYTE_CHAR and +SWIG_PYTHON_STRICT_UNICODE_WCHAR, Python wrapper code can support + overloads taking both std::string (as Python bytes) and std::wstring + (as Python unicode).

    +

    36.12.5 Python 2 Unicode

    +

    A Python 3 string is a Unicode string so by default a Python 3 + string that contains Unicode characters passed to C/C++ will be + accepted and converted to a C/C++ string (char * or +std::string types). A Python 2 string is not a unicode string by + default and should a Unicode string be passed to C/C++ it will fail to + convert to a C/C++ string (char * or std::string + types). The Python 2 behavior can be made more like Python 3 by + defining SWIG_PYTHON_2_UNICODE when compiling the generated + C/C++ code. By default when the following is wrapped:

    +
    +
    +%module unicode_strings
    +char *charstring(char *s) {
    +  return s;
    +}
    +
    -

    34.12.3 Abstract base classes

    -

    By including pyabc.i and using the -py3 command - line option when calling SWIG, the proxy classes of the STL containers - will automatically gain an appropriate abstract base class. For - example, the following SWIG interface:

    +

    An error will occur when using Unicode strings in Python 2:

    +
    +
    +>>> from unicode_strings import *
    +>>> charstring("hi")
    +'hi'
    +>>> charstring(u"hi")
    +Traceback (most recent call last):
    +  File "<stdin>", line 1, in ?
    +TypeError: in method 'charstring', argument 1 of type 'char *'
    +
    +
    +

    When the SWIG_PYTHON_2_UNICODE macro is added to the + generated code:

    -%include <pyabc.i>
    -%include <std_map.i>
    -%include <std_list.i>
    +%module unicode_strings
    +%begin %{
    +#define SWIG_PYTHON_2_UNICODE
    +%}
     
    -namespace std {
    -  %template(Mapii) map<int, int>;
    -  %template(IntList) list<int>;
    +char *charstring(char *s) {
    +  return s;
     }
     
    -

    will generate a Python proxy class Mapii inheriting from -collections.MutableMap and a proxy class IntList - inheriting from collections.MutableSequence.

    -

    pyabc.i also provides a macro %pythonabc that - could be used to define an abstract base class for your own C++ class:

    -
    +

    Unicode strings will be successfully accepted and converted from + UTF-8, but note that they are returned as a normal Python 2 string:

    +
    -%pythonabc(MySet, collections.MutableSet);
    +>>> from unicode_strings import *
    +>>> charstring("hi")
    +'hi'
    +>>> charstring(u"hi")
    +'hi'
    +>>>
     
    -

    For details of abstract base class, please see -PEP 3119.

    +

    Note that defining both SWIG_PYTHON_2_UNICODE and +SWIG_PYTHON_STRICT_BYTE_CHAR at the same time is not allowed, since + the first is allowing unicode conversion and the second is explicitly + prohibiting it.

    @@ -45041,7 +50460,7 @@ PEP 3119.


    -

    35 SWIG and R

    +

    37 SWIG and R

    @@ -45062,13 +50481,13 @@ www.r-project.org. The R bindings are under active development. They have been used to compile and run an R interface to QuantLib running on Mandriva Linux with gcc. The R bindings also work on Microsoft Windows using Visual C++.

    -

    35.1 Bugs

    +

    37.1 Bugs

    Currently the following features are not implemented or broken:

    • Garbage collection of created objects
    • C Array wrappings
    -

    35.2 Using R and SWIG

    +

    37.2 Using R and SWIG

    To use R and SWIG in C mode, execute the following commands where example.c is the name of the file with the functions in them

    @@ -45116,7 +50535,26 @@ cacheMetaData(1)
    The cacheMetaData(1) will cause R to refresh its object tables. Without it, inheritance of wrapped objects may fail.

    These two files can be loaded in any order

    -

    35.3 Precompiling large R files

    +

    If you are compiling code yourself (not using R itself), there are a + few things to watch out for:

    +
      +
    • The output shared library name (to the left of the file extension) + MUST match the module name, or alternatively, you can also set the + -package NAME command line argument. See swig -r -help for more + information
    • +
    • If you do not set the output file name appropriately, you might see + errors like
      +
      +> fact(4)
      +Error in .Call("R_swig_fact", s_arg1, as.logical(.copy), PACKAGE = "example") :
      +  "R_swig_fact" not available for .Call() for package "example"
      +
      +
    • +
    • Make sure the architecture of the shared library(x64 for instance), + matches the architecture of the R program you want to load your shared + library into
    • +
    +

    37.3 Precompiling large R files

    In cases where the R file is large, one make save a lot of loading time by precompiling the R wrapper. This can be done by creating the file makeRData.R which contains the following @@ -45127,30 +50565,30 @@ q(save="no")
    This will generate a compiled R file called BigFile.RData that will save a large amount of loading time. -

    35.4 General policy

    +

    37.4 General policy

    The general policy of the module is to treat the C/C++ as a basic wrapping over the underlying functions and rely on the R type system to provide R syntax.

    -

    35.5 Language conventions

    +

    37.5 Language conventions

    getitem and setitem use C++ conventions (i.e. zero based indices). [

    -

    35.6 C++ classes

    +

    37.6 C++ classes

    C++ objects are implemented as external pointer objects with the class being the mangled name of the class. The C++ classes are encapsulated as an SEXP with an external pointer type. The class is the mangled name of the class. The nice thing about R is that is allows you to keep track of the pointer object which removes the necessity for a lot of the proxy class baggage you see in other languages.

    -

    35.7 Enumerations

    +

    37.7 Enumerations

    enumerations are characters which are then converted back and forth to ints before calling the C routines. All of the enumeration code is done in R.


    -

    36 SWIG and Ruby

    +

    38 SWIG and Ruby

    This chapter describes SWIG's support of Ruby.

    -

    36.1 Preliminaries

    -

    SWIG 1.3 is known to work with Ruby versions 1.6 and later. Given +

    38.1 Preliminaries

    +

    SWIG 3.0 is known to work with Ruby versions 1.8 and later. Given the choice, you should use the latest stable version of Ruby. You should also determine if your system supports shared libraries and dynamic loading. SWIG will work with or without dynamic loading, but @@ -45308,7 +50752,7 @@ slices) found in earlier chapters. At the very least, make sure you also read the "SWIG Basics" chapter. It is also assumed that the reader has a basic understanding of Ruby.

    -

    36.1.1 Running SWIG

    +

    38.1.1 Running SWIG

    To build a Ruby module, run SWIG using the -ruby option:

    $ swig -ruby example.i
    @@ -45323,13 +50767,13 @@ slices)
      if compiling a C++ extension) that contains all of the code needed to
      build a Ruby extension module. To finish building the module, you need
      to compile this file and link it with the rest of your program.

    -

    36.1.2 Getting the right header files

    +

    38.1.2 Getting the right header files

    In order to compile the wrapper code, the compiler needs the ruby.h header file. This file is usually contained in a directory such as

    /usr/lib/ruby/1.8/x86_64-linux-gnu/ruby.h
    -/usr/local/lib/ruby/1.6/i686-linux/ruby.h
    +/usr/include/ruby-2.1.0/ruby.h
     

    The exact location may vary on your machine, but the above location @@ -45337,11 +50781,17 @@ ruby.h header file. This file is usually contained in a directory can run Ruby to find out. For example:

    $ ruby -e 'puts $:.join("\n")'
    -/usr/local/lib/ruby/site_ruby/1.6 /usr/local/lib/ruby/site_ruby/1.6/i686-linux
    -/usr/local/lib/ruby/site_ruby /usr/local/lib/ruby/1.6 /usr/local/lib/ruby/1.6/i686-linux .
    +/usr/local/lib/site_ruby/2.1.0
    +/usr/local/lib/x86_64-linux-gnu/site_ruby
    +/usr/local/lib/site_ruby
    +/usr/lib/ruby/vendor_ruby/2.1.0
    +/usr/lib/x86_64-linux-gnu/ruby/vendor_ruby/2.1.0
    +/usr/lib/ruby/vendor_ruby
    +/usr/lib/ruby/2.1.0
    +/usr/lib/x86_64-linux-gnu/ruby/2.1.0
     
    -

    36.1.3 Compiling a dynamic module

    +

    38.1.3 Compiling a dynamic module

    Ruby extension modules are typically compiled into shared libraries that the interpreter loads dynamically at runtime. Since the exact commands for doing this vary from platform to platform, your best bet @@ -45384,17 +50834,20 @@ example.c, a typical sequence of commands for the Linux operating system would look something like this:

    $ swig -ruby example.i
    -$ gcc -c example.c
    -$ gcc -c example_wrap.c -I/usr/local/lib/ruby/1.6/i686-linux
    +$ gcc -O2 -fPIC -c example.c
    +$ gcc -O2 -fPIC -c example_wrap.c -I/usr/include/ruby-2.1.0
     $ gcc -shared example.o example_wrap.o -o example.so
     
    -

    For other platforms it may be necessary to compile with the --fPIC option to generate position-independent code. If in doubt, - consult the manual pages for your compiler and linker to determine the - correct set of options. You might also check the +

    The -fPIC option tells GCC to generate position-independent code + (PIC) which is required for most architectures (it's not vital on x86, + but still a good idea as it allows code pages from the library to be + shared between processes). Other compilers may need a different option + specified instead of -fPIC.

    +

    If in doubt, consult the manual pages for your compiler and linker + to determine the correct set of options. You might also check the SWIG Wiki for additional information.

    -

    36.1.4 Using your module

    +

    38.1.4 Using your module

    Ruby module names must be capitalized, but the convention for Ruby feature names is to use lowercase names. So, for example, the Etc extension module is imported by requiring the etc @@ -45416,7 +50869,7 @@ puts "Your login name: #{Etc.getlogin}"

    will result in an extension module using the feature name "example" and Ruby module name "Example".

    -

    36.1.5 Static linking

    +

    38.1.5 Static linking

    An alternative approach to dynamic linking is to rebuild the Ruby interpreter with your extension module added to it. In the past, this approach was sometimes necessary due to limitations in dynamic loading @@ -45427,14 +50880,14 @@ puts "Your login name: #{Etc.getlogin}" the Ruby source, adding an entry to the ext/Setup file, adding your directory to the list of extensions in the file, and finally rebuilding Ruby.

    -

    36.1.6 Compilation of C++ extensions

    +

    38.1.6 Compilation of C++ extensions

    On most machines, C++ extension modules should be linked using the C++ compiler. For example:

     $ swig -c++ -ruby example.i
    -$ g++ -c example.cxx
    -$ g++ -c example_wrap.cxx -I/usr/local/lib/ruby/1.6/i686-linux
    +$ g++ -fPIC -c example.cxx
    +$ g++ -fPIC -c example_wrap.cxx -I/usr/include/ruby-2.1.0
     $ g++ -shared example.o example_wrap.o -o example.so
     
    @@ -45452,8 +50905,8 @@ g++ as its linker. As a result, the required C++ runtime library $libs = append_library($libs, "supc++") create_makefile('example')
    -

    36.2 Building Ruby Extensions under Windows - 95/NT

    +

    38.2 Building Ruby Extensions under Windows 95/NT +

    Building a SWIG extension to Ruby under Windows 95/NT is roughly similar to the process used with Unix. Normally, you will want to produce a DLL that can be loaded into the Ruby interpreter. For all @@ -45473,7 +50926,7 @@ C:\swigtest> nmake install order to build extensions, you may need to download the source distribution to the Ruby package, as you will need the Ruby header files.

    -

    36.2.1 Running SWIG from Developer Studio

    +

    38.2.1 Running SWIG from Developer Studio

    If you are developing your application within Microsoft developer studio, SWIG can be invoked as a custom build option. The process roughly follows these steps :

    @@ -45529,10 +50982,10 @@ C:\swigtest> ruby run.rb Foo = 3.0 -

    36.3 The Ruby-to-C/C++ Mapping

    +

    38.3 The Ruby-to-C/C++ Mapping

    This section describes the basics of how SWIG maps C or C++ declarations in your SWIG interface files to Ruby constructs.

    -

    36.3.1 Modules

    +

    38.3.1 Modules

    The SWIG %module directive specifies the name of the Ruby module. If you specify:

    @@ -45566,3539 +51019,5413 @@ Foo = 3.0 $ swig -ruby -prefix "foo::bar::" example.i
    -

    Starting with SWIG 1.3.20, you can also choose to wrap everything - into the global module by specifying the -globalmodule option - on the SWIG command line, i.e.

    -
    -
    -$ swig -ruby -globalmodule example.i
    -
    +

    Starting with SWIG 1.3.20, you can also choose to wrap everything + into the global module by specifying the -globalmodule option + on the SWIG command line, i.e.

    +
    +
    +$ swig -ruby -globalmodule example.i
    +
    +
    +

    Note that this does not relieve you of the requirement of specifying + the SWIG module name with the %module directive (or the +-module command-line option) as described earlier.

    +

    When choosing a module name, do not use the same name as a built-in + Ruby command or standard module name, as the results may be + unpredictable. Similarly, if you're using the -globalmodule + option to wrap everything into the global module, take care that the + names of your constants, classes and methods don't conflict with any of + Ruby's built-in names.

    +

    38.3.2 Functions

    +

    Global functions are wrapped as Ruby module methods. For example, + given the SWIG interface file example.i:

    +
    +
    %module example
    +
    +int fact(int n);
    +
    +

    and C source file example.c:

    +
    +
    int fact(int n) {
    +  if (n == 0)
    +  return 1;
    +  return (n * fact(n-1));
    +}
    +
    +

    SWIG will generate a method fact in the Example module + that can be used like so:

    +
    +
    $ irb
    +irb(main):001:0> require 'example'
    +true
    +irb(main):002:0> Example.fact(4)
    +24
    +
    +

    38.3.3 Variable Linking

    +

    C/C++ global variables are wrapped as a pair of singleton methods + for the module: one to get the value of the global variable and one to + set it. For example, the following SWIG interface file declares two + global variables:

    +
    +
    // SWIG interface file with global variables
    +%module example
    +...
    +%inline %{
    +  extern int variable1;
    +  extern double Variable2;
    +%}
    +...
    +
    +

    Now look at the Ruby interface:

    +
    +
    $ irb
    +irb(main):001:0> require 'Example'
    +true
    +irb(main):002:0> Example.variable1 = 2
    +2
    +irb(main):003:0> Example.Variable2 = 4 * 10.3
    +41.2
    +irb(main):004:0> Example.Variable2
    +41.2
    +
    +

    If you make an error in variable assignment, you will receive an + error message. For example:

    +
    +
    irb(main):005:0> Example.Variable2 = "hello"
    +TypeError: no implicit conversion to float from string
    +from (irb):5:in `Variable2='
    +from (irb):5
    +
    +

    If a variable is declared as const, it is wrapped as a + read-only variable. Attempts to modify its value will result in an + error.

    +

    To make ordinary variables read-only, you can also use the +%immutable directive. For example:

    +
    +
    %immutable;
    +%inline %{
    +  extern char *path;
    +%}
    +%mutable;
    +
    +

    The %immutable directive stays in effect until it is + explicitly disabled using %mutable.

    +

    38.3.4 Constants

    +

    C/C++ constants are wrapped as module constants initialized to the + appropriate value. To create a constant, use #define or the +%constant directive. For example:

    +
    +
    #define PI 3.14159
    +#define VERSION "1.0"
    +
    +%constant int FOO = 42;
    +%constant const char *path = "/usr/local";
    +
    +const int BAR = 32;
    +
    +

    Remember to use the :: operator in Ruby to get at these constant + values, e.g.

    +
    +
    $ irb
    +irb(main):001:0> require 'Example'
    +true
    +irb(main):002:0> Example::PI
    +3.14159
    +
    +

    38.3.5 Pointers

    +

    "Opaque" pointers to arbitrary C/C++ types (i.e. types that aren't + explicitly declared in your SWIG interface file) are wrapped as data + objects. So, for example, consider a SWIG interface file containing + only the declarations:

    +
    +
    Foo *get_foo();
    +void set_foo(Foo *foo);
    +
    +

    For this case, the get_foo() method returns an instance of an + internally generated Ruby class:

    +
    +
    irb(main):001:0> foo = Example::get_foo()
    +#<SWIG::TYPE_p_Foo:0x402b1654>
    +
    +

    A NULL pointer is always represented by the Ruby nil + object.

    +

    38.3.6 Structures

    +

    C/C++ structs are wrapped as Ruby classes, with accessor methods + (i.e. "getters" and "setters") for all of the struct members. For + example, this struct declaration:

    +
    +
    struct Vector {
    +  double x, y;
    +};
    +
    +

    gets wrapped as a Vector class, with Ruby instance methods +x, x=, y and y=. These methods can be + used to access structure data from Ruby as follows:

    +
    +
    $ irb
    +irb(main):001:0> require 'Example'
    +true
    +irb(main):002:0> f = Example::Vector.new
    +#<Example::Vector:0x4020b268>
    +irb(main):003:0> f.x = 10
    +nil
    +irb(main):004:0> f.x
    +10.0
    +
    +

    Similar access is provided for unions and the public data members of + C++ classes.

    +

    const members of a structure are read-only. Data members can + also be forced to be read-only using the %immutable directive + (in C++, private may also be used). For example:

    +
    +
    struct Foo {
    +  ...
    +  %immutable;
    +  int x; /* Read-only members */
    +  char *name;
    +  %mutable;
    +  ...
    +};
    +
    +

    When char * members of a structure are wrapped, the + contents are assumed to be dynamically allocated using malloc + or new (depending on whether or not SWIG is run with the +-c++ option). When the structure member is set, the old contents + will be released and a new value created. If this is not the behavior + you want, you will have to use a typemap (described shortly).

    +

    Array members are normally wrapped as read-only. For example, this + code:

    +
    +
    struct Foo {
    +  int x[50];
    +};
    +
    +

    produces a single accessor function like this:

    +
    +
    int *Foo_x_get(Foo *self) {
    +  return self->x;
    +};
    +
    +

    If you want to set an array member, you will need to supply a + "memberin" typemap described in the +section on typemaps. As a special case, SWIG does generate code to + set array members of type char (allowing you to store a Ruby + string in the structure).

    +

    When structure members are wrapped, they are handled as pointers. For + example,

    +
    +
    struct Foo {
    +  ...
    +};
    +
    +struct Bar {
    +  Foo f;
    +};
    +
    +

    generates accessor functions such as this:

    +
    +
    Foo *Bar_f_get(Bar *b) {
    +  return &b->f;
    +}
    +
    +void Bar_f_set(Bar *b, Foo *val) {
    +  b->f = *val;
    +}
    +
    +

    38.3.7 C++ classes

    +

    Like structs, C++ classes are wrapped by creating a new Ruby class + of the same name with accessor methods for the public class member + data. Additionally, public member functions for the class are wrapped + as Ruby instance methods, and public static member functions are + wrapped as Ruby singleton methods. So, given the C++ class declaration:

    +
    +
    class List {
    +public:
    +  List();
    +  ~List();
    +  int search(char *item);
    +  void insert(char *item);
    +  void remove(char *item);
    +  char *get(int n);
    +  int length;
    +  static void print(List *l);
    +};
    +
    +

    SWIG would create a List class with:

    +
      +
    • instance methods search, insert, remove, and + get;
    • +
    • instance methods length and length= (to get and set + the value of the length data member); and,
    • +
    • a print singleton method for the class.
    • +
    +

    In Ruby, these functions are used as follows:

    +
    +
    require 'Example'
    +
    +l = Example::List.new
    +
    +l.insert("Ale")
    +l.insert("Stout")
    +l.insert("Lager")
    +Example.print(l)
    +l.length()
    +----- produces the following output 
    +Lager
    +Stout
    +Ale
    +3
    +
    +

    38.3.8 C++ Inheritance

    +

    The SWIG type-checker is fully aware of C++ inheritance. Therefore, + if you have classes like this:

    +
    +
    class Parent {
    +  ...
    +};
    +
    +class Child : public Parent {
    +  ...
    +};
    +
    +

    those classes are wrapped into a hierarchy of Ruby classes that + reflect the same inheritance structure. All of the usual Ruby utility + methods work normally:

    +
    +
    irb(main):001:0> c = Child.new
    +#<Bar:0x4016efd4>
    +irb(main):002:0> c.instance_of? Child
    +true
    +irb(main):003:0> b.instance_of? Parent
    +false
    +irb(main):004:0> b.is_a? Child
    +true
    +irb(main):005:0> b.is_a? Parent
    +true
    +irb(main):006:0> Child < Parent
    +true
    +irb(main):007:0> Child > Parent
    +false
    +
    +

    Furthermore, if you have a function like this:

    +
    +
    void spam(Parent *f);
    +
    +

    then the function spam() accepts Parent* or a + pointer to any class derived from Parent.

    +

    Until recently, the Ruby module for SWIG didn't support multiple + inheritance, and this is still the default behavior. This doesn't mean + that you can't wrap C++ classes which inherit from multiple base + classes; it simply means that only the first base class listed + in the class declaration is considered, and any additional base classes + are ignored. As an example, consider a SWIG interface file with a + declaration like this:

    +
    +
    class Derived : public Base1, public Base2
    +{
    +  ...
    +};
    +
    +

    For this case, the resulting Ruby class (Derived) will only + consider Base1 as its superclass. It won't inherit any of +Base2's member functions or data and it won't recognize Base2 + as an "ancestor" of Derived (i.e. the is_a? + relationship would fail). When SWIG processes this interface file, + you'll see a warning message like:

    +
    +
    example.i:5: Warning 802: Warning for Derived: Base Base2 ignored.
    +Multiple inheritance is not supported in Ruby.
    +
    +

    Starting with SWIG 1.3.20, the Ruby module for SWIG provides limited + support for multiple inheritance. Because the approach for dealing with + multiple inheritance introduces some limitations, this is an optional + feature that you can activate with the -minherit command-line + option:

    +
    +
    +$ swig -c++ -ruby -minherit example.i
    +
    +
    +

    Using our previous example, if your SWIG interface file contains a + declaration like this:

    +
    +
    class Derived : public Base1, public Base2
    +{
    +  ...
    +};
    +
    +

    and you run SWIG with the -minherit command-line option, + then you will end up with a Ruby class Derived that appears to + "inherit" the member data and functions from both Base1 and +Base2. What actually happens is that three different top-level + classes are created, with Ruby's Object class as their + superclass. Each of these classes defines a nested module named +Impl, and it's in these nested Impl modules that the + actual instance methods for the classes are defined, i.e.

    +
    +
    class Base1
    +  module Impl
    +  # Define Base1 methods here
    +  end
    +  include Impl
    +end
    +
    +class Base2
    +  module Impl
    +  # Define Base2 methods here
    +  end
    +  include Impl
    +end
    +
    +class Derived
    +  module Impl
    +  include Base1::Impl
    +  include Base2::Impl
    +  # Define Derived methods here
    +  end
    +  include Impl
    +end
    +
    +

    Observe that after the nested Impl module for a class is + defined, it is mixed-in to the class itself. Also observe that the +Derived::Impl module first mixes-in its base classes' Impl + modules, thus "inheriting" all of their behavior.

    +

    The primary drawback is that, unlike the default mode of operation, + neither Base1 nor Base2 is a true superclass of +Derived anymore:

    +
    +
    obj = Derived.new
    +obj.is_a? Base1 # this will return false...
    +obj.is_a? Base2 # ... and so will this
    +
    +

    In most cases, this is not a serious problem since objects of type +Derived will otherwise behave as though they inherit from both +Base1 and Base2 (i.e. they exhibit +"Duck Typing").

    +

    38.3.9 C++ Overloaded Functions

    +

    C++ overloaded functions, methods, and constructors are mostly + supported by SWIG. For example, if you have two functions like this:

    +
    +
    void foo(int);
    +void foo(char *c);
    +
    +

    You can use them in Ruby in a straightforward manner:

    +
    +
    irb(main):001:0> foo(3) # foo(int)
    +irb(main):002:0> foo("Hello") # foo(char *c)
    +
    +

    Similarly, if you have a class like this,

    +
    +
    class Foo {
    +public:
    +  Foo();
    +  Foo(const Foo &);
    +  ...
    +};
    +
    +

    you can write Ruby code like this:

    +
    +
    irb(main):001:0> f = Foo.new # Create a Foo
    +irb(main):002:0> g = Foo.new(f) # Copy f
    +
    +

    Overloading support is not quite as flexible as in C++. Sometimes + there are methods that SWIG can't disambiguate. For example:

    +
    +
    void spam(int);
    +void spam(short);
    +
    +

    or

    +
    +
    void foo(Bar *b);
    +void foo(Bar &b);
    +
    +

    If declarations such as these appear, you will get a warning message + like this:

    +
    +
    +example.i:12: Warning 509: Overloaded method spam(short) effectively ignored,
    +example.i:11: Warning 509: as it is shadowed by spam(int).
    +
    +
    +

    To fix this, you either need to ignore or rename one of the methods. + For example:

    +
    +
    %rename(spam_short) spam(short);
    +...
    +void spam(int); 
    +void spam(short); // Accessed as spam_short
    +
    +

    or

    +
    +
    %ignore spam(short);
    +...
    +void spam(int); 
    +void spam(short); // Ignored
    +
    +

    SWIG resolves overloaded functions and methods using a + disambiguation scheme that ranks and sorts declarations according to a + set of type-precedence rules. The order in which declarations appear in + the input does not matter except in situations where ambiguity + arises--in this case, the first declaration takes precedence.

    +

    Please refer to the "SWIG and C++" chapter + for more information about overloading.

    +

    38.3.10 C++ Operators

    +

    For the most part, overloaded operators are handled automatically by + SWIG and do not require any special treatment on your part. So if your + class declares an overloaded addition operator, e.g.

    +
    +
    class Complex {
    +  ...
    +  Complex operator+(Complex &);
    +  ...
    +};
    +
    +

    the resulting Ruby class will also support the addition (+) method + correctly.

    +

    For cases where SWIG's built-in support is not sufficient, C++ + operators can be wrapped using the %rename directive + (available on SWIG 1.3.10 and later releases). All you need to do is + give the operator the name of a valid Ruby identifier. For example:

    +
    +
    %rename(add_complex) operator+(Complex &, Complex &);
    +...
    +Complex operator+(Complex &, Complex &);
    +
    +

    Now, in Ruby, you can do this:

    +
    +
    a = Example::Complex.new(2, 3)
    +b = Example::Complex.new(4, -1)
    +c = Example.add_complex(a, b)
    -

    Note that this does not relieve you of the requirement of specifying - the SWIG module name with the %module directive (or the --module command-line option) as described earlier.

    -

    When choosing a module name, do not use the same name as a built-in - Ruby command or standard module name, as the results may be - unpredictable. Similarly, if you're using the -globalmodule - option to wrap everything into the global module, take care that the - names of your constants, classes and methods don't conflict with any of - Ruby's built-in names.

    -

    36.3.2 Functions

    -

    Global functions are wrapped as Ruby module methods. For example, - given the SWIG interface file example.i:

    +

    More details about wrapping C++ operators into Ruby operators is + discussed in the section on + operator overloading.

    +

    38.3.11 C++ namespaces

    +

    SWIG is aware of C++ namespaces, but namespace names do not appear + in the module nor do namespaces result in a module that is broken up + into submodules or packages. For example, if you have a file like this,

    %module example
     
    -int fact(int n);
    -
    -

    and C source file example.c:

    -
    -
    int fact(int n) {
    -  if (n == 0)
    -  return 1;
    -  return (n * fact(n-1));
    -}
    +namespace foo { + int fact(int n); + struct Vector { + double x,y,z; + }; +};
    -

    SWIG will generate a method fact in the Example module - that can be used like so:

    +

    it works in Ruby as follows:

    -
    $ irb
    -irb(main):001:0> require 'example'
    +
    irb(main):001:0> require 'example'
     true
    -irb(main):002:0> Example.fact(4)
    -24
    +irb(main):002:0> Example.fact(3) +6 +irb(main):003:0> v = Example::Vector.new +#<Example::Vector:0x4016f4d4> +irb(main):004:0> v.x = 3.4 +3.4 +irb(main):004:0> v.y +0.0
    -

    36.3.3 Variable Linking

    -

    C/C++ global variables are wrapped as a pair of singleton methods - for the module: one to get the value of the global variable and one to - set it. For example, the following SWIG interface file declares two - global variables:

    +

    If your program has more than one namespace, name conflicts (if any) + can be resolved using %rename For example:

    -
    // SWIG interface file with global variables
    -%module example
    -...
    -%inline %{
    -  extern int variable1;
    -  extern double Variable2;
    +
    %rename(Bar_spam) Bar::spam;
    +
    +namespace Foo {
    +  int spam();
    +}
    +
    +namespace Bar {
    +  int spam();
    +}
    +
    +

    If you have more than one namespace and your want to keep their + symbols separate, consider wrapping them as separate SWIG modules. For + example, make the module name the same as the namespace and create + extension modules for each namespace separately. If your program + utilizes thousands of small deeply nested namespaces each with + identical symbol names, well, then you get what you deserve.

    +

    38.3.12 C++ templates

    +

    C++ templates don't present a huge problem for SWIG. However, in + order to create wrappers, you have to tell SWIG to create wrappers for + a particular template instantiation. To do this, you use the +%template directive. For example:

    +
    +
    %module example
    +
    +%{
    +#include "pair.h"
     %}
    -...
    + +template<class T1, class T2> +struct pair { + typedef T1 first_type; + typedef T2 second_type; + T1 first; + T2 second; + pair(); + pair(const T1&, const T2&); + ~pair(); +}; + +%template(Pairii) pair<int,int>;
    -

    Now look at the Ruby interface:

    +

    In Ruby:

    -
    $ irb
    -irb(main):001:0> require 'Example'
    +
    irb(main):001:0> require 'example'
     true
    -irb(main):002:0> Example.variable1 = 2
    -2
    -irb(main):003:0> Example.Variable2 = 4 * 10.3
    -41.2
    -irb(main):004:0> Example.Variable2
    -41.2
    +irb(main):002:0> p = Example::Pairii.new(3, 4) +#<Example:Pairii:0x4016f4df> +irb(main):003:0> p.first +3 +irb(main):004:0> p.second +4
    -

    If you make an error in variable assignment, you will receive an - error message. For example:

    -
    -
    irb(main):005:0> Example.Variable2 = "hello"
    -TypeError: no implicit conversion to float from string
    -from (irb):5:in `Variable2='
    -from (irb):5
    +

    38.3.13 C++ Standard Template Library (STL) +

    +

    On a related note, the standard SWIG library contains a number of + modules that provide typemaps for standard C++ library classes (such as + std::pair, std::string and std::vector). + These library modules don't provide wrappers around the templates + themselves, but they do make it convenient for users of your extension + module to pass Ruby objects (such as arrays and strings) to wrapped C++ + code that expects instances of standard C++ templates. For example, + suppose the C++ library you're wrapping has a function that expects a + vector of floats:

    +
    +
    %module example
    +
    +float sum(const std::vector<float>& values);
    -

    If a variable is declared as const, it is wrapped as a - read-only variable. Attempts to modify its value will result in an - error.

    -

    To make ordinary variables read-only, you can also use the -%immutable directive. For example:

    +

    Rather than go through the hassle of writing an "in" typemap to + convert an array of Ruby numbers into a std::vector<float>, you can + just use the std_vector.i module from the standard SWIG + library:

    -
    %immutable;
    -%inline %{
    -  extern char *path;
    -%}
    -%mutable;
    +
    %module example
    +
    +%include std_vector.i
    +float sum(const std::vector<float>& values);
    -

    The %immutable directive stays in effect until it is - explicitly disabled using %mutable.

    -

    36.3.4 Constants

    -

    C/C++ constants are wrapped as module constants initialized to the - appropriate value. To create a constant, use #define or the -%constant directive. For example:

    +

    Ruby's STL wrappings provide additional methods to make them behave + more similarly to Ruby's native classes.

    +

    Thus, you can do, for example:

    +
    +
    v = IntVector.new
    +v << 2
    +v << 3
    +v << 4
    +v.each { |x| puts x }
    +
    +=> 2
    +3
    +4
    +v.delete_if { |x| x == 3 }
    +=> [2,4]
    +
    +

    The SWIG Ruby module provides also the ability for all the STL + containers to carry around Ruby native objects (Fixnum, Classes, etc) + making them act almost like Ruby's own Array, Hash, etc. To do that, + you need to define a container that contains a swig::GC_VALUE, like:

    -
    #define PI 3.14159
    -#define VERSION "1.0"
    +
    +%module nativevector
     
    -%constant int FOO = 42;
    -%constant const char *path = "/usr/local";
    +%{
    +std::vector< swig::GC_VALUE > NativeVector;
    +%}
     
    -const int BAR = 32;
    +%template(NativeVector) std::vector< swig::GC_VALUE >; +
    -

    Remember to use the :: operator in Ruby to get at these constant - values, e.g.

    -
    -
    $ irb
    -irb(main):001:0> require 'Example'
    -true
    -irb(main):002:0> Example::PI
    -3.14159
    +

    This vector can then contain any Ruby object, making them almost + identical to Ruby's own Array class.

    +
    +
    require 'nativevector'
    +include NativeVector
    +
    +v = NativeVector.new
    +v << 1
    +v << [1,2]
    +v << 'hello'
    +
    +class A; end
    +
    +v << A.new
    +
    +puts v
    +=> [1, [1,2], 'hello', #<A:0x245325>]
    +
    -

    36.3.5 Pointers

    -

    "Opaque" pointers to arbitrary C/C++ types (i.e. types that aren't - explicitly declared in your SWIG interface file) are wrapped as data - objects. So, for example, consider a SWIG interface file containing - only the declarations:

    +

    Obviously, there is a lot more to template wrapping than shown in + these examples. More details can be found in the +SWIG and C++ chapter.

    +

    38.3.14 C++ STL Functors

    +

    Some containers in the STL allow you to modify their default behavior + by using so called functors or function objects. Functors are often + just a very simple struct with operator() redefined or an + actual C/C++ function. This allows you, for example, to always keep the + sort order of a STL container to your liking.

    +

    The Ruby STL mappings allows you to modify those containers that + support functors using Ruby procs or methods, instead. Currently, this + includes std::set, set::map, std::multiset + and std::multimap.

    +

    The functors in swig are called swig::UnaryFunction and +swig::BinaryFunction. For C++ predicates (ie. functors that must + return bool as a result) swig::UnaryPredicate and +swig::BinaryPredicate are provided.

    +

    As an example, if given this swig file:

    -
    Foo *get_foo();
    -void set_foo(Foo *foo);
    +
    +%module intset;
    +
    +%include <std_set.i>
    +
    +%template(IntSet) std::set< int, swig::BinaryPredicate >;
    +
    -

    For this case, the get_foo() method returns an instance of an - internally generated Ruby class:

    -
    -
    irb(main):001:0> foo = Example::get_foo()
    -#<SWIG::TYPE_p_Foo:0x402b1654>
    +

    You can then use the set from Ruby with or without a proc object as a + predicate:

    +
    +
    +require 'intset'
    +include Intset
    +
    +# Default sorting behavior defined in C++
    +a = IntSet.new
    +a << 1
    +a << 2
    +a << 3
    +a
    +=> [1,2,3]
    +
    +# Custom sorting behavior defined by a Ruby proc
    +b = IntSet.new( proc { |a,b| a > b } )
    +b << 1
    +b << 2
    +b << 3
    +b
    +=>  [3,2,1]
    +
    -

    A NULL pointer is always represented by the Ruby nil - object.

    -

    36.3.6 Structures

    -

    C/C++ structs are wrapped as Ruby classes, with accessor methods - (i.e. "getters" and "setters") for all of the struct members. For - example, this struct declaration:

    +

    38.3.15 C++ STL Iterators

    +

    The STL is well known for the use of iterators. There are a number of + iterators possible with different properties, but in general there are + two main categories: const iterators and non-const iterators. The const + iterators can access and not modify the values they point at, while the + non-const iterators can both read and modify the values.

    +

    The Ruby STL wrappings support both type of iterators by using a + proxy class in-between. This proxy class is swig::Iterator or +swig::ConstIterator. Derived from them are template classes that + need to be initialized with the actual iterator for the container you + are wrapping and often times with the beginning and ending points of + the iteration range.

    +

    The SWIG STL library already provides typemaps to all the standard + containers to do this wrapping automatically for you, but if you have + your own STL-like iterator, you will need to write your own typemap for + them. For out typemaps, the special functions make_const_iterator + and make_nonconst_iterator are provided.

    +

    These can be used either like:

    -
    struct Vector {
    -  double x, y;
    -};
    +
    +make_const_iterator( iterator, rubyclass );
    +make_const_iterator( iterator, iterator_begin, iterator_end, rubyclass );
    +
    -

    gets wrapped as a Vector class, with Ruby instance methods -x, x=, y and y=. These methods can be - used to access structure data from Ruby as follows:

    -
    -
    $ irb
    -irb(main):001:0> require 'Example'
    -true
    -irb(main):002:0> f = Example::Vector.new
    -#<Example::Vector:0x4020b268>
    -irb(main):003:0> f.x = 10
    -nil
    -irb(main):004:0> f.x
    -10.0
    +

    The iterators support a next() and previous() + member function to just change the iterator without returning anything. + previous() should obviously only be used for bidirectional + iterators. You can also advance the iterator multiple steps by using + standard math operations like +=.

    +

    The value the iterator points at can be accessed with value() + -- this is equivalent to dereferencing it with *i. For + non-const iterators, a value=() function is also provided + which allows you to change the value pointed by the iterator. This is + equivalent to the C++ construct of dereferencing and assignment, like +*i = something.

    +

    Thus, given say a vector class of doubles defined as:

    +
    +
    +%module doublevector
    +
    +%include std_vector.i
    +
    +%template(DoubleVector) std::vector<double>;
    +
    -

    Similar access is provided for unions and the public data members of - C++ classes.

    -

    const members of a structure are read-only. Data members can - also be forced to be read-only using the %immutable directive - (in C++, private may also be used). For example:

    +

    Its iterator can then be used from Ruby like:

    +
    +
    +require 'doublevector'
    +include Doublevector
    +
    +v = DoubleVector.new
    +v << 1
    +v << 2
    +v << 3
    +
    +#
    +# an elaborate and less efficient way of doing v.map! { |x| x+2 }
    +#
    +i = v.begin
    +e = v.end
    +while i != e
    +  val = i.value
    +  val += 2
    +  i.value = val
    +  i.next
    +end
    +i
    +>> [3, 4, 5 ]
    +
    +
    +

    If you'd rather have STL classes without any iterators, you should + define -DSWIG_NO_EXPORT_ITERATOR_METHODS when running swig.

    +

    38.3.16 C++ Smart Pointers

    +

    38.3.16.1 The shared_ptr + Smart Pointer

    +

    The C++11 standard provides std::shared_ptr which was + derived from the Boost implementation, boost::shared_ptr. Both + of these are available for Ruby in the SWIG library and usage is + outlined in the shared_ptr smart + pointer library section.

    +

    38.3.16.2 Generic Smart + Pointers

    +

    In certain C++ programs, it is common to use classes that have been + wrapped by so-called "smart pointers." Generally, this involves the use + of a template class that implements operator->() like this:

    -
    struct Foo {
    +
    template<class T> class SmartPtr {
       ...
    -  %immutable;
    -  int x; /* Read-only members */
    -  char *name;
    -  %mutable;
    +  T *operator->();
       ...
    -};
    +}
    -

    When char * members of a structure are wrapped, the - contents are assumed to be dynamically allocated using malloc - or new (depending on whether or not SWIG is run with the --c++ option). When the structure member is set, the old contents - will be released and a new value created. If this is not the behavior - you want, you will have to use a typemap (described shortly).

    -

    Array members are normally wrapped as read-only. For example, this - code:

    +

    Then, if you have a class like this,

    -
    struct Foo {
    -  int x[50];
    +
    class Foo {
    +public:
    +  int x;
    +  int bar();
     };
    -

    produces a single accessor function like this:

    +

    A smart pointer would be used in C++ as follows:

    -
    int *Foo_x_get(Foo *self) {
    -  return self->x;
    -};
    +
    SmartPtr<Foo> p = CreateFoo(); // Created somehow (not shown)
    +...
    +p->x = 3; // Foo::x
    +int y = p->bar(); // Foo::bar
    -

    If you want to set an array member, you will need to supply a - "memberin" typemap described in the -section on typemaps. As a special case, SWIG does generate code to - set array members of type char (allowing you to store a Ruby - string in the structure).

    -

    When structure members are wrapped, they are handled as pointers. For - example,

    +

    To wrap this in Ruby, simply tell SWIG about the SmartPtr + class and the low-level Foo object. Make sure you instantiate +SmartPtr using %template if necessary. For example:

    -
    struct Foo {
    -  ...
    -};
    -
    -struct Bar {
    -  Foo f;
    -};
    +
    %module example
    +...
    +%template(SmartPtrFoo) SmartPtr<Foo>;
    +...
    -

    generates accessor functions such as this:

    +

    Now, in Ruby, everything should just "work":

    +
    +
    irb(main):001:0> p = Example::CreateFoo() # Create a smart-pointer somehow
    +#<Example::SmartPtrFoo:0x4016f4df>
    +irb(main):002:0> p.x = 3 # Foo::x
    +3
    +irb(main):003:0> p.bar() # Foo::bar
    +
    +

    If you ever need to access the underlying pointer returned by +operator->() itself, simply use the __deref__() method. + For example:

    +
    +
    irb(main):004:0> f = p.__deref__() # Returns underlying Foo *
    +
    +

    38.3.17 Cross-Language Polymorphism

    +

    SWIG's Ruby module supports cross-language polymorphism (a.k.a. the + "directors" feature) similar to that for SWIG's Python module. Rather + than duplicate the information presented in the +Python chapter, this section just notes the differences that you + need to be aware of when using this feature with Ruby.

    +

    38.3.17.1 Exception Unrolling

    +

    Whenever a C++ director class routes one of its virtual member + function calls to a Ruby instance method, there's always the + possibility that an exception will be raised in the Ruby code. By + default, those exceptions are ignored, which simply means that the + exception will be exposed to the Ruby interpreter. If you would like to + change this behavior, you can use the %feature("director:except") + directive to indicate what action should be taken when a Ruby exception + is raised. The following code should suffice in most cases:

    -
    Foo *Bar_f_get(Bar *b) {
    -  return &b->f;
    -}
    -
    -void Bar_f_set(Bar *b, Foo *val) {
    -  b->f = *val;
    +
    %feature("director:except") {
    +  throw Swig::DirectorMethodException($error);
     }
    -

    36.3.7 C++ classes

    -

    Like structs, C++ classes are wrapped by creating a new Ruby class - of the same name with accessor methods for the public class member - data. Additionally, public member functions for the class are wrapped - as Ruby instance methods, and public static member functions are - wrapped as Ruby singleton methods. So, given the C++ class declaration:

    +

    When this feature is activated, the call to the Ruby instance method + is "wrapped" using the rb_rescue2() function from Ruby's C + API. If any Ruby exception is raised, it will be caught here and a C++ + exception is raised in its place.

    +

    38.4 Naming

    +

    Ruby has several common naming conventions. Constants are generally + in upper case, module and class names are in camel case and methods are + in lower case with underscores. For example:

    +
    +
      +
    • MATH::PI is a constant name
    • +
    • MyClass is a class name
    • +
    • my_method is a method name
    • +
    +
    +

    Prior to version 1.3.28, SWIG did not support these Ruby conventions. + The only modifications it made to names was to capitalize the first + letter of constants (which includes module and class names).

    +

    SWIG 1.3.28 introduces the new -autorename command line parameter. + When this parameter is specified, SWIG will automatically change + constant, class and method names to conform with the standard Ruby + naming conventions. For example:

    +
    +
    $ swig -ruby -autorename example.i
    +
    +
    +

    To disable renaming use the -noautorename command line option.

    +

    Since this change significantly changes the wrapper code generated by + SWIG, it is turned off by default in SWIG 1.3.28. However, it is + planned to become the default option in future releases.

    +

    38.4.1 Defining Aliases

    +

    It's a fairly common practice in the Ruby built-ins and standard + library to provide aliases for method names. For example, + Array#size is an alias for Array#length. If you would + like to provide an alias for one of your class' instance methods, one + approach is to use SWIG's %extend directive to add a new + method of the aliased name that calls the original function. For + example:

    -
    class List {
    +
    class MyArray {
     public:
    -  List();
    -  ~List();
    -  int search(char *item);
    -  void insert(char *item);
    -  void remove(char *item);
    -  char *get(int n);
    -  int length;
    -  static void print(List *l);
    -};
    -
    -

    SWIG would create a List class with:

    -
      -
    • instance methods search, insert, remove, and - get;
    • -
    • instance methods length and length= (to get and set - the value of the length data member); and,
    • -
    • a print singleton method for the class.
    • -
    -

    In Ruby, these functions are used as follows:

    -
    -
    require 'Example'
    +  // Construct an empty array
    +  MyArray();
     
    -l = Example::List.new
    +  // Return the size of this array
    +  size_t length() const;
    +};
     
    -l.insert("Ale")
    -l.insert("Stout")
    -l.insert("Lager")
    -Example.print(l)
    -l.length()
    ------ produces the following output 
    -Lager
    -Stout
    -Ale
    -3
    +%extend MyArray { + // MyArray#size is an alias for MyArray#length + size_t size() const { + return $self->length(); + } +} +
    -

    36.3.8 C++ Inheritance

    -

    The SWIG type-checker is fully aware of C++ inheritance. Therefore, - if you have classes like this:

    +

    A better solution is to use the %alias directive (unique to + SWIG's Ruby module). The previous example could then be rewritten as:

    -
    class Parent {
    -  ...
    -};
    +
    // MyArray#size is an alias for MyArray#length
    +%alias MyArray::length "size";
     
    -class Child : public Parent {
    -  ...
    +class MyArray {
    +public:
    +  // Construct an empty array
    +  MyArray();
    + 
    +  // Return the size of this array
    +  size_t length() const;
     };
    -

    those classes are wrapped into a hierarchy of Ruby classes that - reflect the same inheritance structure. All of the usual Ruby utility - methods work normally:

    -
    -
    irb(main):001:0> c = Child.new
    -#<Bar:0x4016efd4>
    -irb(main):002:0> c.instance_of? Child
    -true
    -irb(main):003:0> b.instance_of? Parent
    -false
    -irb(main):004:0> b.is_a? Child
    -true
    -irb(main):005:0> b.is_a? Parent
    -true
    -irb(main):006:0> Child < Parent
    -true
    -irb(main):007:0> Child > Parent
    -false
    -
    -

    Furthermore, if you have a function like this:

    +

    Multiple aliases can be associated with a method by providing a + comma-separated list of aliases to the %alias directive, e.g.

    -
    void spam(Parent *f);
    +
    %alias MyArray::length "amount,quantity,size";
    -

    then the function spam() accepts Parent* or a - pointer to any class derived from Parent.

    -

    Until recently, the Ruby module for SWIG didn't support multiple - inheritance, and this is still the default behavior. This doesn't mean - that you can't wrap C++ classes which inherit from multiple base - classes; it simply means that only the first base class listed - in the class declaration is considered, and any additional base classes - are ignored. As an example, consider a SWIG interface file with a - declaration like this:

    +

    From an end-user's standpoint, there's no functional difference + between these two approaches; i.e. they should get the same result from + calling either MyArray#size or MyArray#length. + However, when the %alias directive is used, SWIG doesn't need + to generate all of the wrapper code that's usually associated with + added methods like our MyArray::size() example.

    +

    Note that the %alias directive is implemented using SWIG's + "features" mechanism and so the same name matching rules used for other + kinds of features apply (see the chapter on +"Customization Features") for more details).

    +

    38.4.2 Predicate Methods

    +

    Ruby methods that return a boolean value and end in a question mark + are known as predicate methods. Examples of predicate methods in + standard Ruby classes include Array#empty? (which returns +true for an array containing no elements) and + Object#instance_of? (which returns true if the object is + an instance of the specified class). For consistency with Ruby + conventions, methods that return boolean values should be marked as + predicate methods.

    +

    One cumbersome solution to this problem is to rename the method + (using SWIG's %rename directive) and provide a custom typemap + that converts the function's actual return type to Ruby's true + or false. For example:

    -
    class Derived : public Base1, public Base2
    -{
    -  ...
    -};
    -
    -

    For this case, the resulting Ruby class (Derived) will only - consider Base1 as its superclass. It won't inherit any of -Base2's member functions or data and it won't recognize Base2 - as an "ancestor" of Derived (i.e. the is_a? - relationship would fail). When SWIG processes this interface file, - you'll see a warning message like:

    -
    -
    example.i:5: Warning 802: Warning for Derived: Base Base2 ignored.
    -Multiple inheritance is not supported in Ruby.
    -
    -

    Starting with SWIG 1.3.20, the Ruby module for SWIG provides limited - support for multiple inheritance. Because the approach for dealing with - multiple inheritance introduces some limitations, this is an optional - feature that you can activate with the -minherit command-line - option:

    -
    -
    -$ swig -c++ -ruby -minherit example.i
    -
    +
    %rename("is_it_safe?") is_it_safe();
    +
    +%typemap(out) int is_it_safe "$result = ($1 != 0) ? Qtrue : Qfalse;";
    +
    +int is_it_safe();
    -

    Using our previous example, if your SWIG interface file contains a - declaration like this:

    +

    A better solution is to use the %predicate directive + (unique to SWIG's Ruby module) to designate a method as a predicate + method. For the previous example, this would look like:

    -
    class Derived : public Base1, public Base2
    -{
    -  ...
    -};
    -
    -

    and you run SWIG with the -minherit command-line option, - then you will end up with a Ruby class Derived that appears to - "inherit" the member data and functions from both Base1 and -Base2. What actually happens is that three different top-level - classes are created, with Ruby's Object class as their - superclass. Each of these classes defines a nested module named -Impl, and it's in these nested Impl modules that the - actual instance methods for the classes are defined, i.e.

    -
    -
    class Base1
    -  module Impl
    -  # Define Base1 methods here
    -  end
    -  include Impl
    -end
    -
    -class Base2
    -  module Impl
    -  # Define Base2 methods here
    -  end
    -  include Impl
    -end
    +
    %predicate is_it_safe();
     
    -class Derived
    -  module Impl
    -  include Base1::Impl
    -  include Base2::Impl
    -  # Define Derived methods here
    -  end
    -  include Impl
    -end
    +int is_it_safe();
    -

    Observe that after the nested Impl module for a class is - defined, it is mixed-in to the class itself. Also observe that the -Derived::Impl module first mixes-in its base classes' Impl - modules, thus "inheriting" all of their behavior.

    -

    The primary drawback is that, unlike the default mode of operation, - neither Base1 nor Base2 is a true superclass of -Derived anymore:

    +

    This method would be invoked from Ruby code like this:

    -
    obj = Derived.new
    -obj.is_a? Base1 # this will return false...
    -obj.is_a? Base2 # ... and so will this
    +
    irb(main):001:0> Example::is_it_safe?
    +true
    -

    In most cases, this is not a serious problem since objects of type -Derived will otherwise behave as though they inherit from both -Base1 and Base2 (i.e. they exhibit -"Duck Typing").

    -

    36.3.9 C++ Overloaded Functions

    -

    C++ overloaded functions, methods, and constructors are mostly - supported by SWIG. For example, if you have two functions like this:

    +

    The %predicate directive is implemented using SWIG's + "features" mechanism and so the same name matching rules used for other + kinds of features apply (see the chapter on +"Customization Features") for more details).

    +

    38.4.3 Bang Methods

    +

    Ruby methods that modify an object in-place and end in an + exclamation mark are known as bang methods. An example of a bang method + is Array#sort! which changes the ordering of items in an + array. Contrast this with Array#sort, which returns a copy of + the array with the items sorted instead of modifying the original + array. For consistency with Ruby conventions, methods that modify + objects in place should be marked as bang methods.

    +

    Bang methods can be marked using the %bang directive which + is unique to the Ruby module and was introduced in SWIG 1.3.28. For + example:

    -
    void foo(int);
    -void foo(char *c);
    +
    %bang sort(int arr[]);
    +
    +int sort(int arr[]); 
    -

    You can use them in Ruby in a straightforward manner:

    -
    -
    irb(main):001:0> foo(3) # foo(int)
    -irb(main):002:0> foo("Hello") # foo(char *c)
    +

    This method would be invoked from Ruby code like this:

    +
    +
    irb(main):001:0> Example::sort!(arr)
    -

    Similarly, if you have a class like this,

    +

    The %bang directive is implemented using SWIG's "features" + mechanism and so the same name matching rules used for other kinds of + features apply (see the chapter on +"Customization Features") for more details).

    +

    38.4.4 Getters and Setters

    +

    Often times a C++ library will expose properties through getter and + setter methods. For example:

    class Foo {
    -public:
    -  Foo();
    -  Foo(const Foo &);
    -  ...
    +  Foo() {}
    +  int getValue() { return value_; }
    +  void setValue(int value) { value_ = value; }
    +
    +private:
    +  int value_;
     };
    -

    you can write Ruby code like this:

    -
    -
    irb(main):001:0> f = Foo.new # Create a Foo
    -irb(main):002:0> g = Foo.new(f) # Copy f
    +

    By default, SWIG will expose these methods to Ruby as get_value + and set_value. However, it more natural for these methods to + be exposed in Ruby as value and value=. That allows + the methods to be used like this:

    +
    +
    irb(main):001:0> foo = Foo.new()
    +irb(main):002:0> foo.value = 5
    +irb(main):003:0> puts foo.value
    -

    Overloading support is not quite as flexible as in C++. Sometimes - there are methods that SWIG can't disambiguate. For example:

    +

    This can be done by using the %rename directive:

    -
    void spam(int);
    -void spam(short);
    +
    %rename("value") Foo::getValue();
    +%rename("value=") Foo::setValue(int value);
    -

    or

    +

    38.5 Input and output parameters

    +

    A common problem in some C programs is handling parameters passed as + simple pointers. For example:

    -
    void foo(Bar *b);
    -void foo(Bar &b);
    +
    void add(int x, int y, int *result) {
    +  *result = x + y;
    +}
    -

    If declarations such as these appear, you will get a warning message - like this:

    -
    +

    or

    +
    -example.i:12: Warning 509: Overloaded method spam(short) effectively ignored,
    -example.i:11: Warning 509: as it is shadowed by spam(int).
    -
    +int sub(int *x, int *y) { + return *x-*y; +}
    -

    To fix this, you either need to ignore or rename one of the methods. - For example:

    +

    The easiest way to handle these situations is to use the +typemaps.i file. For example:

    -
    %rename(spam_short) spam(short);
    -...
    -void spam(int); 
    -void spam(short); // Accessed as spam_short
    +
    %module Example
    +%include "typemaps.i"
    +
    +void add(int, int, int *OUTPUT);
    +int sub(int *INPUT, int *INPUT);
    -

    or

    +

    In Ruby, this allows you to pass simple values. For example:

    +
    +
    a = Example.add(3,4)
    +puts a
    +7
    +b = Example.sub(7,4)
    +puts b
    +3
    +
    +

    Notice how the INPUT parameters allow integer values to be + passed instead of pointers and how the OUTPUT parameter + creates a return result.

    +

    If you don't want to use the names INPUT or OUTPUT, + use the %apply directive. For example:

    -
    %ignore spam(short);
    -...
    -void spam(int); 
    -void spam(short); // Ignored
    +
    %module Example
    +%include "typemaps.i"
    +
    +%apply int *OUTPUT { int *result };
    +%apply int *INPUT { int *x, int *y};
    +
    +void add(int x, int y, int *result);
    +int sub(int *x, int *y);
    -

    SWIG resolves overloaded functions and methods using a - disambiguation scheme that ranks and sorts declarations according to a - set of type-precedence rules. The order in which declarations appear in - the input does not matter except in situations where ambiguity - arises--in this case, the first declaration takes precedence.

    -

    Please refer to the "SWIG and C++" chapter - for more information about overloading.

    -

    36.3.10 C++ Operators

    -

    For the most part, overloaded operators are handled automatically by - SWIG and do not require any special treatment on your part. So if your - class declares an overloaded addition operator, e.g.

    +

    If a function mutates one of its parameters like this,

    -
    class Complex {
    -  ...
    -  Complex operator+(Complex &);
    -  ...
    -};
    +
    void negate(int *x) {
    + *x = -(*x);
    +}
    -

    the resulting Ruby class will also support the addition (+) method - correctly.

    -

    For cases where SWIG's built-in support is not sufficient, C++ - operators can be wrapped using the %rename directive - (available on SWIG 1.3.10 and later releases). All you need to do is - give the operator the name of a valid Ruby identifier. For example:

    +

    you can use INOUT like this:

    -
    %rename(add_complex) operator+(Complex &, Complex &);
    +
    %include "typemaps.i"
     ...
    -Complex operator+(Complex &, Complex &);
    +void negate(int *INOUT);
    -

    Now, in Ruby, you can do this:

    +

    In Ruby, a mutated parameter shows up as a return value. For example:

    -
    a = Example::Complex.new(2, 3)
    -b = Example::Complex.new(4, -1)
    -c = Example.add_complex(a, b)
    +
    a = Example.negate(3)
    +print a
    +-3
    -

    More details about wrapping C++ operators into Ruby operators is - discussed in the section on - operator overloading.

    -

    36.3.11 C++ namespaces

    -

    SWIG is aware of C++ namespaces, but namespace names do not appear - in the module nor do namespaces result in a module that is broken up - into submodules or packages. For example, if you have a file like this,

    +

    The most common use of these special typemap rules is to handle + functions that return more than one value. For example, sometimes a + function returns a result as well as a special error code:

    +
    +
    /* send message, return number of bytes sent, success code, and error_code */
    +int send_message(char *text, int *success, int *error_code);
    +
    +

    To wrap such a function, simply use the OUTPUT rule above. + For example:

    %module example
    -
    -namespace foo {
    -  int fact(int n);
    -  struct Vector {
    -    double x,y,z;
    -  };
    -};
    +%include "typemaps.i" +... +int send_message(char *, int *OUTPUT, int *OUTPUT);
    -

    it works in Ruby as follows:

    +

    When used in Ruby, the function will return an array of multiple + values.

    -
    irb(main):001:0> require 'example'
    -true
    -irb(main):002:0> Example.fact(3)
    -6
    -irb(main):003:0> v = Example::Vector.new
    -#<Example::Vector:0x4016f4d4>
    -irb(main):004:0> v.x = 3.4
    -3.4
    -irb(main):004:0> v.y
    -0.0
    -
    -

    If your program has more than one namespace, name conflicts (if any) - can be resolved using %rename For example:

    -
    -
    %rename(Bar_spam) Bar::spam;
    -
    -namespace Foo {
    -  int spam();
    -}
    -
    -namespace Bar {
    -  int spam();
    -}
    +
    bytes, success, error_code = send_message("Hello World")
    +if not success
    +  print "error #{error_code} : in send_message"
    +else
    +  print "Sent", bytes
    +end
    -

    If you have more than one namespace and your want to keep their - symbols separate, consider wrapping them as separate SWIG modules. For - example, make the module name the same as the namespace and create - extension modules for each namespace separately. If your program - utilizes thousands of small deeply nested namespaces each with - identical symbol names, well, then you get what you deserve.

    -

    36.3.12 C++ templates

    -

    C++ templates don't present a huge problem for SWIG. However, in - order to create wrappers, you have to tell SWIG to create wrappers for - a particular template instantiation. To do this, you use the -%template directive. For example:

    +

    Another way to access multiple return values is to use the +%apply rule. In the following example, the parameters rows and + columns are related to SWIG as OUTPUT values through the use + of %apply

    -
    %module example
    -
    -%{
    -#include "pair.h"
    -%}
    -
    -template<class T1, class T2>
    -struct pair {
    -  typedef T1 first_type;
    -  typedef T2 second_type;
    -  T1 first;
    -  T2 second;
    -  pair();
    -  pair(const T1&, const T2&);
    -  ~pair();
    -};
    -
    -%template(Pairii) pair<int,int>;
    +
    %module Example
    +%include "typemaps.i"
    +%apply int *OUTPUT { int *rows, int *columns };
    +...
    +void get_dimensions(Matrix *m, int *rows, int*columns);

    In Ruby:

    -
    irb(main):001:0> require 'example'
    -true
    -irb(main):002:0> p = Example::Pairii.new(3, 4)
    -#<Example:Pairii:0x4016f4df>
    -irb(main):003:0> p.first
    -3
    -irb(main):004:0> p.second
    -4
    +
    r, c = Example.get_dimensions(m)
    +
    +

    38.6 Exception handling

    +

    38.6.1 Using the %exception directive

    +

    The SWIG %exception directive can be used to define a + user-definable exception handler that can convert C/C++ errors into + Ruby exceptions. The chapter on Customization + Features contains more details, but suppose you have a C++ class + like the following :

    +
    +
    class DoubleArray {
    +private:
    +  int n;
    +  double *ptr;
    +public:
    +  // Create a new array of fixed size
    +  DoubleArray(int size) {
    +    ptr = new double[size];
    +    n = size;
    +  }
    + 
    +  // Destroy an array
    +  ~DoubleArray() {
    +    delete ptr;
    +  } 
    + 
    +  // Return the length of the array
    +  int length() {
    +    return n;
    +  }
    + 
    +  // Get an array item and perform bounds checking.
    +  double getitem(int i) {
    +    if ((i >= 0) && (i < n))
    +      return ptr[i];
    +    else
    +      throw RangeError();
    +  }
    + 
    +  // Set an array item and perform bounds checking.
    +  void setitem(int i, double val) {
    +    if ((i >= 0) && (i < n))
    +      ptr[i] = val;
    +    else {
    +      throw RangeError();
    +    }
    +  }
    +};
    -

    36.3.13 C++ Standard Template Library - (STL)

    -

    On a related note, the standard SWIG library contains a number of - modules that provide typemaps for standard C++ library classes (such as - std::pair, std::string and std::vector). - These library modules don't provide wrappers around the templates - themselves, but they do make it convenient for users of your extension - module to pass Ruby objects (such as arrays and strings) to wrapped C++ - code that expects instances of standard C++ templates. For example, - suppose the C++ library you're wrapping has a function that expects a - vector of floats:

    +

    Since several methods in this class can throw an exception for an + out-of-bounds access, you might want to catch this in the Ruby + extension by writing the following in an interface file:

    -
    %module example
    +
    %exception {
    +  try {
    +    $action
    +  }
    +  catch (const RangeError&) {
    +    static VALUE cpperror = rb_define_class("CPPError", rb_eStandardError);
    +    rb_raise(cpperror, "Range error.");
    +  }
    +}
     
    -float sum(const std::vector<float>& values);
    +class DoubleArray { + ... +};
    -

    Rather than go through the hassle of writing an "in" typemap to - convert an array of Ruby numbers into a std::vector<float>, you can - just use the std_vector.i module from the standard SWIG - library:

    +

    The exception handling code is inserted directly into generated + wrapper functions. When an exception handler is defined, errors can be + caught and used to gracefully raise a Ruby exception instead of forcing + the entire program to terminate with an uncaught error.

    +

    As shown, the exception handling code will be added to every wrapper + function. Because this is somewhat inefficient, you might consider + refining the exception handler to only apply to specific methods like + this:

    -
    %module example
    -
    -%include std_vector.i
    -float sum(const std::vector<float>& values);
    -
    -

    Ruby's STL wrappings provide additional methods to make them behave - more similarly to Ruby's native classes.

    -

    Thus, you can do, for example:

    -
    -
    v = IntVector.new
    -v << 2
    -v << 3
    -v << 4
    -v.each { |x| puts x }
    -
    -=> 2
    -3
    -4
    -v.delete_if { |x| x == 3 }
    -=> [2,4]
    +
    %exception getitem {
    +  try {
    +    $action
    +  } catch (const RangeError&) {
    +    static VALUE cpperror = rb_define_class("CPPError", rb_eStandardError);
    +    rb_raise(cpperror, "Range error in getitem.");
    +  }
    +}
    + 
    +%exception setitem {
    +  try {
    +    $action
    +  } catch (const RangeError&) {
    +    static VALUE cpperror = rb_define_class("CPPError", rb_eStandardError);
    +    rb_raise(cpperror, "Range error in setitem.");
    +  }
    +}
    -

    The SWIG Ruby module provides also the ability for all the STL - containers to carry around Ruby native objects (Fixnum, Classes, etc) - making them act almost like Ruby's own Array, Hash, etc. To do that, - you need to define a container that contains a swig::GC_VALUE, like:

    +

    In this case, the exception handler is only attached to methods and + functions named getitem and setitem.

    +

    Since SWIG's exception handling is user-definable, you are not + limited to C++ exception handling. See the chapter on +Customization Features for more examples.

    +

    38.6.2 Handling Ruby Blocks

    +

    One of the highlights of Ruby and most of its standard library is the + use of blocks, which allow the easy creation of continuations and other + niceties. Blocks in ruby are also often used to simplify the passing of + many arguments to a class.

    +

    In order to make your class constructor support blocks, you can take + advantage of the %exception directive, which will get run after the C++ + class' constructor was called.

    +

    For example, this yields the class over after its construction:

    -
    -%module nativevector
    -
    -%{
    -std::vector< swig::GC_VALUE > NativeVector;
    -%}
    +
    class Window
    +{
    +public:
    +  Window(int x, int y, int w, int h);
    +  // .... other methods here ....
    +};
     
    -%template(NativeVector) std::vector< swig::GC_VALUE >;
    -
    +// Add support for yielding self in the Class' constructor. +%exception Window::Window { + $action + if (rb_block_given_p()) { + rb_yield(self); + } +}
    -

    This vector can then contain any Ruby object, making them almost - identical to Ruby's own Array class.

    +

    Then, in ruby, it can be used like:

    -
    require 'nativevector'
    -include NativeVector
    -
    -v = NativeVector.new
    -v << 1
    -v << [1,2]
    -v << 'hello'
    -
    -class A; end
    -
    -v << A.new
    -
    -puts v
    -=> [1, [1,2], 'hello', #<A:0x245325>]
    +
    +Window.new(0,0,360,480) { |w|
    +  w.color = Fltk::RED
    +  w.border = false
    +}
     
    -

    Obviously, there is a lot more to template wrapping than shown in - these examples. More details can be found in the -SWIG and C++ chapter.

    -

    36.3.14 C++ STL Functors

    -

    Some containers in the STL allow you to modify their default behavior - by using so called functors or function objects. Functors are often - just a very simple struct with operator() redefined or an - actual C/C++ function. This allows you, for example, to always keep the - sort order of a STL container to your liking.

    -

    The Ruby STL mappings allows you to modify those containers that - support functors using Ruby procs or methods, instead. Currently, this - includes std::set, set::map, std::multiset - and std::multimap.

    -

    The functors in swig are called swig::UnaryFunction and -swig::BinaryFunction. For C++ predicates (ie. functors that must - return bool as a result) swig::UnaryPredicate and -swig::BinaryPredicate are provided.

    -

    As an example, if given this swig file:

    +

    For other methods, you can usually use a dummy parameter with a + special in typemap, like:

    -%module intset;
    +//
    +// original function was:
    +//
    +// void func(int x);
     
    -%include <std_set.i>
    +%typemap(in,numinputs=0) int RUBY_YIELD_SELF {
    +  if ( !rb_block_given_p() )
    +    rb_raise("No block given");
    +  return rb_yield(self);
    +}
     
    -%typemap(IntSet) std::set< int, swig::BinaryPredicate >;
    +%extend {
    +  void func(int x, int RUBY_YIELD_SELF );
    +}
     
    -

    You can then use the set from Ruby with or without a proc object as a - predicate:

    -
    -
    -require 'intset'
    -include Intset
    -
    -# Default sorting behavior defined in C++
    -a = IntSet.new
    -a << 1
    -a << 2
    -a << 3
    -a
    -=> [1,2,3]
    -
    -# Custom sorting behavior defined by a Ruby proc
    -b = IntSet.new( proc { |a,b| a > b } )
    -b << 1
    -b << 2
    -b << 3
    -b
    -=>  [3,2,1]
    -
    +

    For more information on typemaps, see Typemaps +.

    +

    38.6.3 Raising exceptions

    +

    There are three ways to raise exceptions from C++ code to Ruby.

    +

    The first way is to use SWIG_exception(int code, const char *msg) +. The following table shows the mappings from SWIG error codes to Ruby + exceptions:

    +
    + + + + + + + + + + + + + + + + +
    SWIG_MemoryError
    +rb_eNoMemError
    SWIG_IOError
    rb_eIOError
    +
    SWIG_RuntimeError
    +rb_eRuntimeError
    SWIG_IndexError
    +rb_eIndexError
    SWIG_TypeError
    +rb_eTypeError
    SWIG_DivisionByZero
    +rb_eZeroDivError
    SWIG_OverflowError
    +rb_eRangeError
    SWIG_SyntaxError
    +rb_eSyntaxError
    SWIG_ValueError
    +rb_eArgError
    SWIG_SystemError
    +rb_eFatal
    SWIG_AttributeError
    +rb_eRuntimeError
    SWIG_NullReferenceError
    +rb_eNullReferenceError*
    SWIG_ObjectPreviouslyDeletedError
    +
    rb_eObjectPreviouslyDeleted*
    SWIG_UnknownError
    +rb_eRuntimeError
    * These error classes are + created by SWIG and are not built-in Ruby exception classes
    -

    36.3.15 C++ STL Iterators

    -

    The STL is well known for the use of iterators. There are a number of - iterators possible with different properties, but in general there are - two main categories: const iterators and non-const iterators. The const - iterators can access and not modify the values they point at, while the - non-const iterators can both read and modify the values.

    -

    The Ruby STL wrappings support both type of iterators by using a - proxy class in-between. This proxy class is swig::Iterator or - swig::ConstIterator. Derived from them are template classes that - need to be initialized with the actual iterator for the container you - are wrapping and often times with the beginning and ending points of - the iteration range.

    -

    The SWIG STL library already provides typemaps to all the standard - containers to do this wrapping automatically for you, but if you have - your own STL-like iterator, you will need to write your own typemap for - them. For out typemaps, the special functions make_const_iterator - and make_nonconst_iterator are provided.

    -

    These can be used either like:

    +

    The second way to raise errors is to use SWIG_Raise(obj, type, + desc). Obj is a C++ instance of an exception class, type is a + string specifying the type of exception (for example, "MyError") and + desc is the SWIG description of the exception class. For example:

    -make_const_iterator( iterator, rubyclass );
    -make_const_iterator( iterator, iterator_begin, iterator_end, rubyclass );
    +%raise(SWIG_NewPointerObj(e, SWIGTYPE_p_AssertionFailedException, 0), ":AssertionFailedException", SWIGTYPE_p_AssertionFailedException);
     
    -

    The iterators support a next() and previous() - member function to just change the iterator without returning anything. - previous() should obviously only be used for bidirectional - iterators. You can also advance the iterator multiple steps by using - standard math operations like +=.

    -

    The value the iterator points at can be accessed with value() - -- this is equivalent to dereferencing it with *i. For - non-const iterators, a value=() function is also provided - which allows you to change the value pointed by the iterator. This is - equivalent to the C++ construct of dereferencing and assignment, like -*i = something.

    -

    Thus, given say a vector class of doubles defined as:

    +

    This is useful when you want to pass the current exception object + directly to Ruby, particularly when the object is an instance of class + marked as an %exceptionclass (see the next section for more + information).

    +

    Last, you can raise an exception by directly calling Ruby's C api. + This is done by invoking the rb_raise() function. The first + argument passed to rb_raise() is the exception type. You can + raise a custom exception type or one of the built-in Ruby exception + types.

    +

    38.6.4 Exception classes

    +

    Starting with SWIG 1.3.28, the Ruby module supports the +%exceptionclass directive, which is used to identify C++ classes + that are used as exceptions. Classes that are marked with the +%exceptionclass directive are exposed in Ruby as child classes of +rb_eRuntimeError. This allows C++ exceptions to be directly mapped + to Ruby exceptions, providing for a more natural integration between + C++ code and Ruby code.

    -
    -%module doublevector
    +
    %exceptionclass CustomError;
     
    -%include std_vector.i
    +%inline %{
    +  class CustomError { };
     
    -%template(DoubleVector) std::vector<double>;
    -
    + class Foo { + public: + void test() { throw CustomError; } + }; +%}
    -

    Its iterator can then be used from Ruby like:

    -
    -
    -require 'doublevector'
    -include Doublevector
    -
    -v = DoubleVector.new
    -v << 1
    -v << 2
    -v << 3
    -
    -#
    -# an elaborate and less efficient way of doing v.map! { |x| x+2 }
    -#
    -i = v.begin
    -e = v.end
    -while i != e
    -  val = i.value
    -  val += 2
    -  i.value = val
    -  i.next
    -end
    -i
    ->> [3, 4, 5 ]
    -
    +

    From Ruby you can now call this method like this:

    +
    +
    foo = Foo.new
    +begin
    +  foo.test()
    +rescue CustomError => e
    +  puts "Caught custom error"
    +end 
    -

    If you'd rather have STL classes without any iterators, you should - define -DSWIG_NO_EXPORT_ITERATOR_METHODS when running swig.

    -

    36.3.16 C++ Smart Pointers

    -

    In certain C++ programs, it is common to use classes that have been - wrapped by so-called "smart pointers." Generally, this involves the use - of a template class that implements operator->() like this:

    +

    For another example look at swig/Examples/ruby/exception_class.

    +

    38.7 Typemaps

    +

    This section describes how you can modify SWIG's default wrapping + behavior for various C/C++ datatypes using the %typemap + directive. This is an advanced topic that assumes familiarity with the + Ruby C API as well as the material in the "Typemaps +" chapter.

    +

    Before proceeding, it should be stressed that typemaps are not a + required part of using SWIG---the default wrapping behavior is enough + in most cases. Typemaps are only used if you want to change some aspect + of the primitive C-Ruby interface.

    +

    38.7.1 What is a typemap?

    +

    A typemap is nothing more than a code generation rule that is + attached to a specific C datatype. The general form of this declaration + is as follows ( parts enclosed in [...] are optional ):

    -
    template<class T> class SmartPtr {
    -  ...
    -  T *operator->();
    -  ...
    -}
    +
    +%typemap( method [, modifiers...] ) typelist code;
    +
    -

    Then, if you have a class like this,

    -
    -
    class Foo {
    -public:
    -  int x;
    -  int bar();
    -};
    +

    method is a simply a name that specifies what kind of + typemap is being defined. It is usually a name like "in", +"out", or "argout" (or its director variations). The + purpose of these methods is described later.

    +

    modifiers is an optional comma separated list of +name="value" values. These are sometimes to attach extra + information to a typemap and is often target-language dependent.

    +

    typelist is a list of the C++ type patterns that the + typemap will match. The general form of this list is as follows:

    +
    +
    typelist : typepattern [, typepattern, typepattern, ... ] ;
    +
    +typepattern : type [ (parms) ]
    +  | type name [ (parms) ]
    +  | ( typelist ) [ (parms) ]
    -

    A smart pointer would be used in C++ as follows:

    -
    -
    SmartPtr<Foo> p = CreateFoo(); // Created somehow (not shown)
    -...
    -p->x = 3; // Foo::x
    -int y = p->bar(); // Foo::bar
    +

    Each type pattern is either a simple type, a simple type and + argument name, or a list of types in the case of multi-argument + typemaps. In addition, each type pattern can be parameterized with a + list of temporary variables (parms). The purpose of these variables + will be explained shortly.

    +

    code specifies the C code used in the typemap. It can take + any one of the following forms:

    +
    +
    code : { ... }
    +  | " ... "
    +  | %{ ... %}
    -

    To wrap this in Ruby, simply tell SWIG about the SmartPtr - class and the low-level Foo object. Make sure you instantiate -SmartPtr using %template if necessary. For example:

    +

    For example, to convert integers from Ruby to C, you might define a + typemap like this:

    %module example
    -...
    -%template(SmartPtrFoo) SmartPtr<Foo>;
    -...
    -
    -

    Now, in Ruby, everything should just "work":

    -
    -
    irb(main):001:0> p = Example::CreateFoo() # Create a smart-pointer somehow
    -#<Example::SmartPtrFoo:0x4016f4df>
    -irb(main):002:0> p.x = 3 # Foo::x
    -3
    -irb(main):003:0> p.bar() # Foo::bar
    + +%typemap(in) int { + $1 = (int) NUM2INT($input); + printf("Received an integer : %d\n",$1); +} + +%inline %{ + extern int fact(int n); +%}
    -

    If you ever need to access the underlying pointer returned by -operator->() itself, simply use the __deref__() method. - For example:

    +

    Typemaps are always associated with some specific aspect of code + generation. In this case, the "in" method refers to the conversion of + input arguments to C/C++. The datatype int is the datatype to + which the typemap will be applied. The supplied C code is used to + convert values. In this code a number of special variables prefaced by + a $ are used. The $1 variable is placeholder for a + local variable of type int. The $input variable is + the input Ruby object.

    +

    When this example is compiled into a Ruby module, the following + sample code:

    -
    irb(main):004:0> f = p.__deref__() # Returns underlying Foo *
    -
    -

    36.3.17 Cross-Language Polymorphism

    -

    SWIG's Ruby module supports cross-language polymorphism (a.k.a. the - "directors" feature) similar to that for SWIG's Python module. Rather - than duplicate the information presented in the -Python chapter, this section just notes the differences that you - need to be aware of when using this feature with Ruby.

    -

    36.3.17.1 Exception Unrolling

    -

    Whenever a C++ director class routes one of its virtual member - function calls to a Ruby instance method, there's always the - possibility that an exception will be raised in the Ruby code. By - default, those exceptions are ignored, which simply means that the - exception will be exposed to the Ruby interpreter. If you would like to - change this behavior, you can use the %feature("director:except") - directive to indicate what action should be taken when a Ruby exception - is raised. The following code should suffice in most cases:

    -
    -
    %feature("director:except") {
    -  throw Swig::DirectorMethodException($error);
    -}
    -
    -

    When this feature is activated, the call to the Ruby instance method - is "wrapped" using the rb_rescue2() function from Ruby's C - API. If any Ruby exception is raised, it will be caught here and a C++ - exception is raised in its place.

    -

    36.4 Naming

    -

    Ruby has several common naming conventions. Constants are generally - in upper case, module and class names are in camel case and methods are - in lower case with underscores. For example:

    -
    -
      -
    • MATH::PI is a constant name
    • -
    • MyClass is a class name
    • -
    • my_method is a method name
    • -
    +
    require 'example'
    +
    +puts Example.fact(6)
    -

    Prior to version 1.3.28, SWIG did not support these Ruby conventions. - The only modifications it made to names was to capitalize the first - letter of constants (which includes module and class names).

    -

    SWIG 1.3.28 introduces the new -autorename command line parameter. - When this parameter is specified, SWIG will automatically change - constant, class and method names to conform with the standard Ruby - naming conventions. For example:

    +

    prints the result:

    -
    $ swig -ruby -autorename example.i
    +
    +Received an integer : 6
    +720
     
    -

    To disable renaming use the -noautorename command line option.

    -

    Since this change significantly changes the wrapper code generated by - SWIG, it is turned off by default in SWIG 1.3.28. However, it is - planned to become the default option in future releases.

    -

    36.4.1 Defining Aliases

    -

    It's a fairly common practice in the Ruby built-ins and standard - library to provide aliases for method names. For example, - Array#size is an alias for Array#length. If you would - like to provide an alias for one of your class' instance methods, one - approach is to use SWIG's %extend directive to add a new - method of the aliased name that calls the original function. For - example:

    -
    -
    class MyArray {
    -public:
    -  // Construct an empty array
    -  MyArray();
    -
    -  // Return the size of this array
    -  size_t length() const;
    -};
    +

    In this example, the typemap is applied to all occurrences of the +int datatype. You can refine this by supplying an optional + parameter name. For example:

    +
    +
    %module example
     
    -%extend MyArray {
    -  // MyArray#size is an alias for MyArray#length
    -  size_t size() const {
    -    return $self->length();
    -  }
    +%typemap(in) int n {
    +  $1 = (int) NUM2INT($input);
    +  printf("n = %d\n",$1);
     }
    - 
    + +%inline %{ + extern int fact(int n); +%}
    -

    A better solution is to use the %alias directive (unique to - SWIG's Ruby module). The previous example could then be rewritten as:

    +

    In this case, the typemap code is only attached to arguments that + exactly match "int n".

    +

    The application of a typemap to specific datatypes and argument names + involves more than simple text-matching--typemaps are fully integrated + into the SWIG type-system. When you define a typemap for int, + that typemap applies to int and qualified variations such as +const int. In addition, the typemap system follows typedef + declarations. For example:

    -
    // MyArray#size is an alias for MyArray#length
    -%alias MyArray::length "size";
    +
    %typemap(in) int n {
    +  $1 = (int) NUM2INT($input);
    +  printf("n = %d\n",$1);
    +}
     
    -class MyArray {
    -public:
    -  // Construct an empty array
    -  MyArray();
    - 
    -  // Return the size of this array
    -  size_t length() const;
    -};
    +typedef int Integer; +extern int fact(Integer n); // Above typemap is applied
    -

    Multiple aliases can be associated with a method by providing a - comma-separated list of aliases to the %alias directive, e.g.

    +

    However, the matching of typedef only occurs in one + direction. If you defined a typemap for Integer, it is not + applied to arguments of type int.

    +

    Typemaps can also be defined for groups of consecutive arguments. For + example:

    -
    %alias MyArray::length "amount,quantity,size";
    +
    %typemap(in) (char *str, int len) {
    +  $1 = StringValuePtr($input);
    +  $2 = (int) RSTRING($input)->len;
    +};
    +
    +int count(char c, char *str, int len);
    -

    From an end-user's standpoint, there's no functional difference - between these two approaches; i.e. they should get the same result from - calling either MyArray#size or MyArray#length. - However, when the %alias directive is used, SWIG doesn't need - to generate all of the wrapper code that's usually associated with - added methods like our MyArray::size() example.

    -

    Note that the %alias directive is implemented using SWIG's - "features" mechanism and so the same name matching rules used for other - kinds of features apply (see the chapter on -"Customization Features") for more details).

    -

    36.4.2 Predicate Methods

    -

    Ruby methods that return a boolean value and end in a question mark - are known as predicate methods. Examples of predicate methods in - standard Ruby classes include Array#empty? (which returns -true for an array containing no elements) and - Object#instance_of? (which returns true if the object is - an instance of the specified class). For consistency with Ruby - conventions, methods that return boolean values should be marked as - predicate methods.

    -

    One cumbersome solution to this problem is to rename the method - (using SWIG's %rename directive) and provide a custom typemap - that converts the function's actual return type to Ruby's true - or false. For example:

    +

    When a multi-argument typemap is defined, the arguments are always + handled as a single Ruby object. This allows the function count + to be used as follows (notice how the length parameter is omitted):

    +
    +
    puts Example.count('o','Hello World')
    +2
    +
    +

    38.7.2 Typemap scope

    +

    Once defined, a typemap remains in effect for all of the + declarations that follow. A typemap may be redefined for different + sections of an input file. For example:

    -
    %rename("is_it_safe?") is_it_safe();
    +
    // typemap1
    +%typemap(in) int {
    +  ...
    +}
     
    -%typemap(out) int is_it_safe "$result = ($1 != 0) ? Qtrue : Qfalse;";
    +int fact(int); // typemap1
    +int gcd(int x, int y); // typemap1
     
    -int is_it_safe();
    +// typemap2 +%typemap(in) int { + ... +} + +int isprime(int); // typemap2
    -

    A better solution is to use the %predicate directive - (unique to SWIG's Ruby module) to designate a method as a predicate - method. For the previous example, this would look like:

    +

    One exception to the typemap scoping rules pertains to the +%extend declaration. %extend is used to attach new + declarations to a class or structure definition. Because of this, all + of the declarations in an %extend block are subject to the + typemap rules that are in effect at the point where the class itself is + defined. For example:

    -
    %predicate is_it_safe();
    +
    class Foo {
    +  ...
    +};
     
    -int is_it_safe();
    +%typemap(in) int { + ... +} + +%extend Foo { + int blah(int x); // typemap has no effect. Declaration is attached to Foo which + // appears before the %typemap declaration. +};
    -

    This method would be invoked from Ruby code like this:

    -
    -
    irb(main):001:0> Example::is_it_safe?
    -true
    +

    38.7.3 Copying a typemap

    +

    A typemap is copied by using assignment. For example:

    +
    +
    %typemap(in) Integer = int;
    -

    The %predicate directive is implemented using SWIG's - "features" mechanism and so the same name matching rules used for other - kinds of features apply (see the chapter on -"Customization Features") for more details).

    -

    36.4.3 Bang Methods

    -

    Ruby methods that modify an object in-place and end in an - exclamation mark are known as bang methods. An example of a bang method - is Array#sort! which changes the ordering of items in an - array. Contrast this with Array#sort, which returns a copy of - the array with the items sorted instead of modifying the original - array. For consistency with Ruby conventions, methods that modify - objects in place should be marked as bang methods.

    -

    Bang methods can be marked using the %bang directive which - is unique to the Ruby module and was introduced in SWIG 1.3.28. For +

    or this:

    +
    +
    %typemap(in) Integer, Number, int32_t = int;
    +
    +

    Types are often managed by a collection of different typemaps. For example:

    -
    %bang sort(int arr[]);
    -
    -int sort(int arr[]); 
    +
    %typemap(in) int { ... }
    +%typemap(out) int { ... }
    +%typemap(varin) int { ... }
    +%typemap(varout) int { ... }
    -

    This method would be invoked from Ruby code like this:

    +

    To copy all of these typemaps to a new type, use %apply. + For example:

    -
    irb(main):001:0> Example::sort!(arr)
    +
    %apply int { Integer }; // Copy all int typemaps to Integer
    +%apply int { Integer, Number }; // Copy all int typemaps to both Integer and Number
    -

    The %bang directive is implemented using SWIG's "features" - mechanism and so the same name matching rules used for other kinds of - features apply (see the chapter on -"Customization Features") for more details).

    -

    36.4.4 Getters and Setters

    -

    Often times a C++ library will expose properties through getter and - setter methods. For example:

    +

    The patterns for %apply follow the same rules as for +%typemap. For example:

    -
    class Foo {
    -  Foo() {}
    -  int getValue() { return value_; }
    -  void setValue(int value) { value_ = value; }
    -
    -private:
    -  int value_;
    -};
    +
    %apply int *output { Integer *output }; // Typemap with name
    +%apply (char *buf, int len) { (char *buffer, int size) }; // Multiple arguments
    -

    By default, SWIG will expose these methods to Ruby as get_value - and set_value. However, it more natural for these methods to - be exposed in Ruby as value and value=. That allows - the methods to be used like this:

    +

    38.7.4 Deleting a typemap

    +

    A typemap can be deleted by simply defining no code. For example:

    -
    irb(main):001:0> foo = Foo.new()
    -irb(main):002:0> foo.value = 5
    -irb(main):003:0> puts foo.value
    +
    %typemap(in) int; // Clears typemap for int
    +%typemap(in) int, long, short; // Clears typemap for int, long, short
    +%typemap(in) int *output; 
    -

    This can be done by using the %rename directive:

    +

    The %clear directive clears all typemaps for a given type. + For example:

    -
    %rename("value") Foo::getValue();
    -%rename("value=") Foo::setValue(int value);
    +
    %clear int; // Removes all types for int
    +%clear int *output, long *output;
    -

    36.5 Input and output parameters

    -

    A common problem in some C programs is handling parameters passed as - simple pointers. For example:

    +

    Note: Since SWIG's default behavior is defined by typemaps, + clearing a fundamental type like int will make that type + unusable unless you also define a new set of typemaps immediately after + the clear operation.

    +

    38.7.5 Placement of typemaps +

    +

    Typemap declarations can be declared in the global scope, within a + C++ namespace, and within a C++ class. For example:

    -
    void add(int x, int y, int *result) {
    -  *result = x + y;
    -}
    +
    %typemap(in) int {
    +  ...
    +}
    +
    +namespace std {
    +  class string;
    +  %typemap(in) string {
    +    ...
    +  }
    +}
    +
    +class Bar {
    +public:
    +  typedef const int & const_reference;
    +  %typemap(out) const_reference {
    +    ...
    +  }
    +};
    -

    or

    +

    When a typemap appears inside a namespace or class, it stays in + effect until the end of the SWIG input (just like before). However, the + typemap takes the local scope into account. Therefore, this code

    -
    -int sub(int *x, int *y) {
    -  return *x-*y;
    +
    namespace std {
    +  class string;
    +  %typemap(in) string {
    +    ...
    +  }
     }
    -

    The easiest way to handle these situations is to use the -typemaps.i file. For example:

    +

    is really defining a typemap for the type std::string. You + could have code like this:

    -
    %module Example
    -%include "typemaps.i"
    +
    namespace std {
    +  class string;
    +  %typemap(in) string { /* std::string */
    +  ...
    +  }
    +}
     
    -void add(int, int, int *OUTPUT);
    -int sub(int *INPUT, int *INPUT);
    +namespace Foo { + class string; + %typemap(in) string { /* Foo::string */ + ... + } +}
    -

    In Ruby, this allows you to pass simple values. For example:

    -
    -
    a = Example.add(3,4)
    -puts a
    -7
    -b = Example.sub(7,4)
    -puts b
    -3
    +

    In this case, there are two completely distinct typemaps that apply + to two completely different types (std::string and +Foo::string).

    +

    It should be noted that for scoping to work, SWIG has to know that +string is a typename defined within a particular namespace. In this + example, this is done using the class declaration class string + .

    +

    38.7.6 Ruby typemaps

    +

    The following list details all of the typemap methods that can be + used by the Ruby module:

    +

    38.7.6.1 "in" typemap

    +

    Converts Ruby objects to input function arguments. For example:

    +
    +
    %typemap(in) int {
    +  $1 = NUM2INT($input);
    +}
    -

    Notice how the INPUT parameters allow integer values to be - passed instead of pointers and how the OUTPUT parameter - creates a return result.

    -

    If you don't want to use the names INPUT or OUTPUT, - use the %apply directive. For example:

    +

    The following special variables are available:

    +
    + + + + + + + + +
    $input Input object holding value to be converted.
    $symname Name of function/method being wrapped
    $1...n Argument being sent to the function
    $1_name Name of the argument (if provided)
    $1_type The actual C datatype matched by the typemap.
    $1_ltype The assignable version of the C datatype + matched by the typemap.
    +
    +

    This is probably the most commonly redefined typemap because it can + be used to implement customized conversions.

    +

    In addition, the "in" typemap allows the number of converted + arguments to be specified. For example:

    -
    %module Example
    -%include "typemaps.i"
    -
    -%apply int *OUTPUT { int *result };
    -%apply int *INPUT { int *x, int *y};
    -
    -void add(int x, int y, int *result);
    -int sub(int *x, int *y);
    +
    // Ignored argument.
    +%typemap(in, numinputs=0) int *out (int temp) {
    +  $1 = &temp;
    +}
    -

    If a function mutates one of its parameters like this,

    +

    At this time, only zero or one arguments may be converted.

    +

    38.7.6.2 "typecheck" typemap

    +

    The "typecheck" typemap is used to support overloaded functions and + methods. It merely checks an argument to see whether or not it matches + a specific type. For example:

    -
    void negate(int *x) {
    - *x = -(*x);
    +
    %typemap(typecheck,precedence=SWIG_TYPECHECK_INTEGER) int {
    +  $1 = FIXNUM_P($input) ? 1 : 0;
     }
    -

    you can use INOUT like this:

    +

    For typechecking, the $1 variable is always a simple integer that is + set to 1 or 0 depending on whether or not the input argument is the + correct type.

    +

    If you define new "in" typemaps and your program uses + overloaded methods, you should also define a collection of "typecheck" + typemaps. More details about this follow in a later section on + "Typemaps and Overloading."

    +

    38.7.6.3 "out" typemap

    +

    Converts return value of a C function to a Ruby object.

    -
    %include "typemaps.i"
    -...
    -void negate(int *INOUT);
    +
    %typemap(out) int {
    +  $result = INT2NUM( $1 );
    +}
    +
    -

    In Ruby, a mutated parameter shows up as a return value. For example:

    -
    -
    a = Example.negate(3)
    -print a
    --3
    +

    The following special variables are available.

    +
    + + + + + + + + +
    $result Result object returned to target language.
    $symname Name of function/method being wrapped
    $1...n Argument being wrapped
    $1_name Name of the argument (if provided)
    $1_type The actual C datatype matched by the typemap.
    $1_ltype The assignable version of the C datatype + matched by the typemap.
    -

    The most common use of these special typemap rules is to handle - functions that return more than one value. For example, sometimes a - function returns a result as well as a special error code:

    +

    38.7.6.4 "arginit" typemap

    +

    The "arginit" typemap is used to set the initial value of a function + argument--before any conversion has occurred. This is not normally + necessary, but might be useful in highly specialized applications. For + example:

    -
    /* send message, return number of bytes sent, success code, and error_code */
    -int send_message(char *text, int *success, int *error_code);
    +
    // Set argument to NULL before any conversion occurs
    +%typemap(arginit) int *data {
    +  $1 = NULL;
    +}
    -

    To wrap such a function, simply use the OUTPUT rule above. - For example:

    +

    38.7.6.5 "default" typemap

    +

    The "default" typemap is used to turn an argument into a default + argument. For example:

    -
    %module example
    -%include "typemaps.i"
    +
    %typemap(default) int flags {
    +  $1 = DEFAULT_FLAGS;
    +}
     ...
    -int send_message(char *, int *OUTPUT, int *OUTPUT);
    +int foo(int x, int y, int flags);
    -

    When used in Ruby, the function will return an array of multiple - values.

    -
    -
    bytes, success, error_code = send_message("Hello World")
    -if not success
    -  print "error #{error_code} : in send_message"
    -else
    -  print "Sent", bytes
    -end
    +

    The primary use of this typemap is to either change the wrapping of + default arguments or specify a default argument in a language where + they aren't supported (like C). Target languages that do not support + optional arguments, such as Java and C#, effectively ignore the value + specified by this typemap as all arguments must be given.

    +

    Once a default typemap has been applied to an argument, all + arguments that follow must have default values. See the + Default/optional arguments section for further information on + default argument wrapping.

    +

    38.7.6.6 "check" typemap

    +

    The "check" typemap is used to supply value checking code during + argument conversion. The typemap is applied after arguments + have been converted. For example:

    +
    +
    %typemap(check) int positive {
    +  if ($1 <= 0) {
    +    SWIG_exception(SWIG_ValueError,"Expected positive value.");
    +  }
    +}
    -

    Another way to access multiple return values is to use the -%apply rule. In the following example, the parameters rows and - columns are related to SWIG as OUTPUT values through the use - of %apply

    +

    38.7.6.7 "argout" typemap

    +

    The "argout" typemap is used to return values from arguments. This + is most commonly used to write wrappers for C/C++ functions that need + to return multiple values. The "argout" typemap is almost always + combined with an "in" typemap---possibly to ignore the input value. For + example:

    -
    %module Example
    -%include "typemaps.i"
    -%apply int *OUTPUT { int *rows, int *columns };
    -...
    -void get_dimensions(Matrix *m, int *rows, int*columns);
    +
    /* Set the input argument to point to a temporary variable */
    +%typemap(in, numinputs=0) int *out (int temp) {
    +  $1 = &temp;
    +}
    +
    +%typemap(argout, fragment="output_helper") int *out {
    +  // Append output value $1 to $result (assuming a single integer in this case)
    +  $result = output_helper( $result, INT2NUM(*$1) );
    +}
    -

    In Ruby:

    -
    -
    r, c = Example.get_dimensions(m)
    +

    The following special variables are available.

    +
    + + + + +
    $result Result object returned to target language.
    $input The original input object passed.
    $symname Name of function/method being wrapped.
    -

    36.6 Exception handling

    -

    36.6.1 Using the %exception directive

    -

    The SWIG %exception directive can be used to define a - user-definable exception handler that can convert C/C++ errors into - Ruby exceptions. The chapter on Customization - Features contains more details, but suppose you have a C++ class - like the following :

    +

    The code supplied to the "argout" typemap is always placed after the + "out" typemap. If multiple return values are used, the extra return + values are often appended to return value of the function.

    +

    Output helper is a fragment that usually defines a macro to some + function like SWIG_Ruby_AppendOutput.

    +

    See the typemaps.i library for examples.

    +

    38.7.6.8 "freearg" typemap

    +

    The "freearg" typemap is used to cleanup argument data. It is only + used when an argument might have allocated resources that need to be + cleaned up when the wrapper function exits. The "freearg" typemap + usually cleans up argument resources allocated by the "in" typemap. For + example:

    -
    class DoubleArray {
    -private:
    -  int n;
    -  double *ptr;
    -public:
    -  // Create a new array of fixed size
    -  DoubleArray(int size) {
    -    ptr = new double[size];
    -    n = size;
    -  }
    - 
    -  // Destroy an array
    -  ~DoubleArray() {
    -    delete ptr;
    -  } 
    - 
    -  // Return the length of the array
    -  int length() {
    -    return n;
    -  }
    - 
    -  // Get an array item and perform bounds checking.
    -  double getitem(int i) {
    -    if ((i >= 0) && (i < n))
    -      return ptr[i];
    -    else
    -      throw RangeError();
    -  }
    - 
    -  // Set an array item and perform bounds checking.
    -  void setitem(int i, double val) {
    -    if ((i >= 0) && (i < n))
    -      ptr[i] = val;
    -    else {
    -      throw RangeError();
    -    }
    -  }
    -};
    +
    // Get a list of integers
    +%typemap(in) int *items {
    +  int nitems = Length($input); 
    +  $1 = (int *) malloc(sizeof(int)*nitems);
    +}
    +// Free the list 
    +%typemap(freearg) int *items {
    +  free($1);
    +}
    -

    Since several methods in this class can throw an exception for an - out-of-bounds access, you might want to catch this in the Ruby - extension by writing the following in an interface file:

    +

    The "freearg" typemap inserted at the end of the wrapper function, + just before control is returned back to the target language. This code + is also placed into a special variable $cleanup that may be + used in other typemaps whenever a wrapper function needs to abort + prematurely.

    +

    38.7.6.9 "newfree" typemap

    +

    The "newfree" typemap is used in conjunction with the %newobject + directive and is used to deallocate memory used by the return result of + a function. For example:

    -
    %exception {
    -  try {
    -    $action
    -  }
    -  catch (const RangeError&) {
    -    static VALUE cpperror = rb_define_class("CPPError", rb_eStandardError);
    -    rb_raise(cpperror, "Range error.");
    -  }
    +
    %typemap(newfree) string * {
    +  delete $1;
     }
    +%typemap(out) string * {
    +  $result = PyString_FromString($1->c_str());
    +}
    +...
     
    -class DoubleArray {
    -  ...
    -};
    +%newobject foo; +... +string *foo();
    -

    The exception handling code is inserted directly into generated - wrapper functions. When an exception handler is defined, errors can be - caught and used to gracefully raise a Ruby exception instead of forcing - the entire program to terminate with an uncaught error.

    -

    As shown, the exception handling code will be added to every wrapper - function. Because this is somewhat inefficient, you might consider - refining the exception handler to only apply to specific methods like - this:

    +

    See Object ownership and + %newobject for further details.

    +

    38.7.6.10 "memberin" typemap

    +

    The "memberin" typemap is used to copy data from an already + converted input value into a structure member. It is typically + used to handle array members and other special cases. For example:

    -
    %exception getitem {
    -  try {
    -    $action
    -  } catch (const RangeError&) {
    -    static VALUE cpperror = rb_define_class("CPPError", rb_eStandardError);
    -    rb_raise(cpperror, "Range error in getitem.");
    -  }
    -}
    - 
    -%exception setitem {
    -  try {
    -    $action
    -  } catch (const RangeError&) {
    -    static VALUE cpperror = rb_define_class("CPPError", rb_eStandardError);
    -    rb_raise(cpperror, "Range error in setitem.");
    -  }
    +
    %typemap(memberin) int [4] {
    +  memmove($1, $input, 4*sizeof(int));
     }
    -

    In this case, the exception handler is only attached to methods and - functions named getitem and setitem.

    -

    Since SWIG's exception handling is user-definable, you are not - limited to C++ exception handling. See the chapter on -Customization Features for more examples.

    -

    36.6.2 Handling Ruby Blocks

    -

    One of the highlights of Ruby and most of its standard library is the - use of blocks, which allow the easy creation of continuations and other - niceties. Blocks in ruby are also often used to simplify the passing of - many arguments to a class.

    -

    In order to make your class constructor support blocks, you can take - advantage of the %exception directive, which will get run after the C++ - class' constructor was called.

    -

    For example, this yields the class over after its construction:

    +

    It is rarely necessary to write "memberin" typemaps---SWIG already + provides a default implementation for arrays, strings, and other + objects.

    +

    38.7.6.11 "varin" typemap

    +

    The "varin" typemap is used to convert objects in the target + language to C for the purposes of assigning to a C/C++ global variable. + This is implementation specific.

    +

    38.7.6.12 "varout" typemap

    +

    The "varout" typemap is used to convert a C/C++ object to an object + in the target language when reading a C/C++ global variable. This is + implementation specific.

    +

    38.7.6.13 "throws" typemap

    +

    The "throws" typemap is only used when SWIG parses a C++ method with + an exception specification or has the %catches feature + attached to the method. It provides a default mechanism for handling + C++ methods that have declared the exceptions they will throw. The + purpose of this typemap is to convert a C++ exception into an error or + exception in the target language. It is slightly different to the other + typemaps as it is based around the exception type rather than the type + of a parameter or variable. For example:

    -
    class Window
    -{
    -public:
    -  Window(int x, int y, int w, int h);
    -  // .... other methods here ....
    -};
    -
    -// Add support for yielding self in the Class' constructor.
    -%exception Window::Window {
    -  $action
    -  if (rb_block_given_p()) {
    -    rb_yield(self);
    -  }
    -}
    +
    %typemap(throws) const char * %{
    +  rb_raise(rb_eRuntimeError, $1);
    +  SWIG_fail;
    +%}
    +void bar() throw (const char *);
    -

    Then, in ruby, it can be used like:

    -
    -
    -Window.new(0,0,360,480) { |w|
    -  w.color = Fltk::RED
    -  w.border = false
    +

    As can be seen from the generated code below, SWIG generates an + exception handler with the catch block comprising the "throws" typemap + content.

    +
    +
    ...
    +try {
    +  bar();
     }
    -
    +catch(char const *_e) { + rb_raise(rb_eRuntimeError, _e); + SWIG_fail; +} +...
    -

    For other methods, you can usually use a dummy parameter with a - special in typemap, like:

    +

    Note that if your methods do not have an exception specification yet + they do throw exceptions, SWIG cannot know how to deal with them. For a + neat way to handle these, see the +Exception handling with %exception section.

    +

    38.7.6.14 directorin typemap

    +

    Converts C++ objects in director member functions to ruby objects. It + is roughly the opposite of the "in" typemap, making its typemap rule + often similar to the "out" typemap.

    -//
    -// original function was:
    -//
    -// void func(int x);
    -
    -%typemap(in,numinputs=0) int RUBY_YIELD_SELF {
    -  if ( !rb_block_given_p() )
    -    rb_raise("No block given");
    -  return rb_yield(self);
    -}
    -
    -%extend {
    -  void func(int x, int RUBY_YIELD_SELF );
    +%typemap(directorin) int {
    +  $result = INT2NUM($1);
     }
     
    -

    For more information on typemaps, see Typemaps -.

    -

    36.6.3 Raising exceptions

    -

    There are three ways to raise exceptions from C++ code to Ruby.

    -

    The first way is to use SWIG_exception(int code, const char *msg) -. The following table shows the mappings from SWIG error codes to Ruby - exceptions:

    +

    The following special variables are available.

    - - - - - - - - - - - - - - - - +
    SWIG_MemoryError
    -rb_eNoMemError
    SWIG_IOError
    rb_eIOError
    -
    SWIG_RuntimeError
    -rb_eRuntimeError
    SWIG_IndexError
    -rb_eIndexError
    SWIG_TypeError
    -rb_eTypeError
    SWIG_DivisionByZero
    -rb_eZeroDivError
    SWIG_OverflowError
    -rb_eRangeError
    SWIG_SyntaxError
    -rb_eSyntaxError
    SWIG_ValueError
    -rb_eArgError
    SWIG_SystemError
    -rb_eFatal
    SWIG_AttributeError
    -rb_eRuntimeError
    SWIG_NullReferenceError
    -rb_eNullReferenceError*
    SWIG_ObjectPreviouslyDeletedError
    -
    rb_eObjectPreviouslyDeleted*
    SWIG_UnknownError
    -rb_eRuntimeError
    * These error classes are - created by SWIG and are not built-in Ruby exception classes
    + + + + + + + +
    $result Result object returned to target language.
    $symname Name of function/method being wrapped
    $1...n Argument being wrapped
    $1_name Name of the argument (if provided)
    $1_type The actual C datatype matched by the typemap.
    $1_ltype The assignable version of the C datatype + matched by the typemap.
    this C++ this, referring to the class itself.
    -

    The second way to raise errors is to use SWIG_Raise(obj, type, - desc). Obj is a C++ instance of an exception class, type is a - string specifying the type of exception (for example, "MyError") and - desc is the SWIG description of the exception class. For example:

    +

    38.7.6.15 directorout typemap

    +

    Converts Ruby objects in director member functions to C++ objects. It + is roughly the opposite of the "out" typemap, making its rule often + similar to the "in" typemap.

    -%raise(SWIG_NewPointerObj(e, SWIGTYPE_p_AssertionFailedException, 0), ":AssertionFailedException", SWIGTYPE_p_AssertionFailedException);
    +%typemap(directorout) int {
    +  $result = NUM2INT($1);
    +}
     
    -

    This is useful when you want to pass the current exception object - directly to Ruby, particularly when the object is an instance of class - marked as an %exceptionclass (see the next section for more - information).

    -

    Last, you can raise an exception by directly calling Ruby's C api. - This is done by invoking the rb_raise() function. The first - argument passed to rb_raise() is the exception type. You can - raise a custom exception type or one of the built-in Ruby exception - types.

    -

    36.6.4 Exception classes

    -

    Starting with SWIG 1.3.28, the Ruby module supports the -%exceptionclass directive, which is used to identify C++ classes - that are used as exceptions. Classes that are marked with the -%exceptionclass directive are exposed in Ruby as child classes of -rb_eRuntimeError. This allows C++ exceptions to be directly mapped - to Ruby exceptions, providing for a more natural integration between - C++ code and Ruby code.

    -
    -
    %exceptionclass CustomError;
    -
    -%inline %{
    -  class CustomError { };
    -
    -  class Foo { 
    -  public:
    -    void test() { throw CustomError; }
    -  };
    -%}
    +

    The following special variables are available:

    +
    + + + + + + + + + +
    $inputRuby object being sent to the function
    $symnameName of function/method being wrapped
    $1...nArgument being sent to the function
    $1_name Name of the argument (if provided)
    $1_type The actual C datatype matched by the typemap.
    $1_ltype The assignable version of the C datatype + matched by the typemap.
    this C++ this, referring to the class itself.
    -

    From Ruby you can now call this method like this:

    -
    -
    foo = Foo.new
    -begin
    -  foo.test()
    -rescue CustomError => e
    -  puts "Caught custom error"
    -end 
    +

    Currently, the directorout nor the out typemap support the option +numoutputs, but the Ruby module provides that functionality through + a %feature directive. Thus, a function can be made to return "nothing" + if you do:

    +
    +
    +%feature("numoutputs","0") MyClass::function;
    +
    -

    For another example look at swig/Examples/ruby/exception_class.

    -

    36.7 Typemaps

    -

    This section describes how you can modify SWIG's default wrapping - behavior for various C/C++ datatypes using the %typemap - directive. This is an advanced topic that assumes familiarity with the - Ruby C API as well as the material in the "Typemaps -" chapter.

    -

    Before proceeding, it should be stressed that typemaps are not a - required part of using SWIG---the default wrapping behavior is enough - in most cases. Typemaps are only used if you want to change some aspect - of the primitive C-Ruby interface.

    -

    36.7.1 What is a typemap?

    -

    A typemap is nothing more than a code generation rule that is - attached to a specific C datatype. The general form of this declaration - is as follows ( parts enclosed in [...] are optional ):

    +

    This feature can be useful if a function returns a status code, which + you want to discard but still use the typemap to raise an exception.

    +

    38.7.6.16 directorargout + typemap

    +

    Output argument processing in director member functions.

    -%typemap( method [, modifiers...] ) typelist code;
    +%typemap(directorargout,
    +fragment="output_helper") int {
    +  $result = output_helper( $result, NUM2INT($1) );
    +}
     
    -

    method is a simply a name that specifies what kind of - typemap is being defined. It is usually a name like "in", -"out", or "argout" (or its director variations). The - purpose of these methods is described later.

    -

    modifiers is an optional comma separated list of -name="value" values. These are sometimes to attach extra - information to a typemap and is often target-language dependent.

    -

    typelist is a list of the C++ type patterns that the - typemap will match. The general form of this list is as follows:

    +

    The following special variables are available:

    -
    typelist : typepattern [, typepattern, typepattern, ... ] ;
    -
    -typepattern : type [ (parms) ]
    -  | type name [ (parms) ]
    -  | ( typelist ) [ (parms) ]
    + + + + + + + + + + +
    $resultResult that the director function returns
    $inputRuby object being sent to the function
    $symnamename of the function/method being wrapped
    $1...nArgument being sent to the function
    $1_nameName of the argument (if provided)
    $1_typeThe actual C datatype matched by the typemap
    $1_ltypeThe assignable version of the C datatype + matched by the typemap
    thisC++ this, referring to the instance of the class + itself
    -

    Each type pattern is either a simple type, a simple type and - argument name, or a list of types in the case of multi-argument - typemaps. In addition, each type pattern can be parameterized with a - list of temporary variables (parms). The purpose of these variables - will be explained shortly.

    -

    code specifies the C code used in the typemap. It can take - any one of the following forms:

    +

    38.7.6.17 ret typemap

    +

    Cleanup of function return values

    +

    38.7.6.18 globalin typemap

    +

    Setting of C global variables

    +

    38.7.7 Typemap variables

    +

    Within a typemap, a number of special variables prefaced with a +$ may appear. A full list of variables can be found in the " +Typemaps" chapter. This is a list of the most common variables:

    +

    $1

    +
    A C local variable corresponding to the actual type + specified in the %typemap directive. For input values, this is + a C local variable that is supposed to hold an argument value. For + output values, this is the raw result that is supposed to be returned + to Ruby.
    +

    $input

    +
    A VALUE holding a raw Ruby object with an + argument or variable value.
    +

    $result

    +
    A VALUE that holds the result to be + returned to Ruby.
    +

    $1_name

    +
    The parameter name that was matched.
    +

    $1_type

    +
    The actual C datatype matched by the typemap.
    +

    $1_ltype

    +
    An assignable version of the datatype matched by the + typemap (a type that can appear on the left-hand-side of a C assignment + operation). This type is stripped of qualifiers and may be an altered + version of $1_type. All arguments and local variables in + wrapper functions are declared using this type so that their values can + be properly assigned.
    +

    $symname

    +
    The Ruby name of the wrapper function being created.
    +

    38.7.8 Useful Functions

    +

    When you write a typemap, you usually have to work directly with + Ruby objects. The following functions may prove to be useful. (These + functions plus many more can be found in Programming Ruby + book, by David Thomas and Andrew Hunt.)

    +

    In addition, we list equivalent functions that SWIG defines, which + provide a language neutral conversion (these functions are defined for + each swig language supported). If you are trying to create a swig file + that will work under multiple languages, it is recommended you stick to + the swig functions instead of the native Ruby functions. That should + help you avoid having to rewrite a lot of typemaps across multiple + languages.

    +

    38.7.8.1 C Datatypes to Ruby Objects

    -
    code : { ... }
    -  | " ... "
    -  | %{ ... %}
    + + + + + + + + +
    RUBYSWIG
    INT2NUM(long or int)SWIG_From_int(int x) int + to Fixnum or Bignum
    INT2FIX(long or int) int to Fixnum (faster + than INT2NUM)
    CHR2FIX(char)SWIG_From_char(char x) char to + Fixnum
    rb_str_new2(char*)SWIG_FromCharPtrAndSize(char*, + size_t) char* to String
    rb_float_new(double)SWIG_From_double(double), +
    SWIG_From_float(float)
    float/double to Float
    -

    For example, to convert integers from Ruby to C, you might define a - typemap like this:

    +

    38.7.8.2 Ruby Objects to C Datatypes

    +

    Here, while the Ruby versions return the value directly, the SWIG + versions do not, but return a status value to indicate success ( +SWIG_OK). While more akward to use, this allows you to write + typemaps that report more helpful error messages, like:

    -
    %module example
    -
    -%typemap(in) int {
    -  $1 = (int) NUM2INT($input);
    -  printf("Received an integer : %d\n",$1);
    +
    +%typemap(in) size_t (int ok)
    +  ok = SWIG_AsVal_size_t($input, &$1);
    +  if (!SWIG_IsOK(ok)) {
    +    SWIG_exception_fail(SWIG_ArgError(ok), Ruby_Format_TypeError( "$1_name", "$1_type","$symname", $argnum, $input));
    +  }
     }
    +
    +
    + + + + + + + + + + + + + + + +
    int NUM2INT(Numeric)SWIG_AsVal_int(VALUE, int*)
    int FIX2INT(Numeric)SWIG_AsVal_int(VALUE, int*)
    unsigned int NUM2UINT(Numeric) +SWIG_AsVal_unsigned_SS_int(VALUE, int*)
    unsigned int FIX2UINT(Numeric) +SWIG_AsVal_unsigned_SS_int(VALUE, int*)
    long NUM2LONG(Numeric)SWIG_AsVal_long(VALUE, long*)
    long FIX2LONG(Numeric)SWIG_AsVal_long(VALUE, long*)
    unsigned long FIX2ULONG(Numeric) +SWIG_AsVal_unsigned_SS_long(VALUE, unsigned long*)
    char NUM2CHR(Numeric or String)SWIG_AsVal_char(VALUE, + int*)
    char * StringValuePtr(String) +SWIG_AsCharPtrAndSize(VALUE, char*, size_t, int* alloc)
    char * rb_str2cstr(String, int*length)
    double NUM2DBL(Numeric)(double) SWIG_AsVal_int(VALUE) + or similar
    +
    +

    38.7.8.3 Macros for VALUE

    +

    RSTRING_LEN(str)

    +
    length of the Ruby string
    +

    RSTRING_PTR(str)

    +
    pointer to string storage
    +

    RARRAY_LEN(arr)

    +
    length of the Ruby array
    +

    RARRAY(arr)->capa

    +
    capacity of the Ruby array
    +

    RARRAY_PTR(arr)

    +
    pointer to array storage
    +

    38.7.8.4 Exceptions

    +

    void rb_raise(VALUE exception, const char *fmt, ...)

    +
    Raises an exception. The given format string fmt + and remaining arguments are interpreted as with printf().
    +

    void rb_fatal(const char *fmt, ...)

    +
    Raises a fatal exception, terminating the process. + No rescue blocks are called, but ensure blocks will be called. The + given format string fmt and remaining arguments are interpreted + as with printf().
    +

    void rb_bug(const char *fmt, ...)

    +
    Terminates the process immediately -- no handlers + of any sort will be called. The given format string fmt and + remaining arguments are interpreted as with printf(). You + should call this function only if a fatal bug has been exposed.
    +

    void rb_sys_fail(const char *msg)

    +
    Raises a platform-specific exception corresponding + to the last known system error, with the given string msg.
    +

    VALUE rb_rescue(VALUE (*body)(VALUE), VALUE args, + VALUE(*rescue)(VALUE, VALUE), VALUE rargs)

    +
    Executes body with the given args. If + a StandardError exception is raised, then execute rescue + with the given rargs.
    +

    VALUE rb_ensure(VALUE(*body)(VALUE), VALUE args, + VALUE(*ensure)(VALUE), VALUE eargs)

    +
    Executes body with the given args. + Whether or not an exception is raised, execute ensure with the + given rargs after body has completed.
    +

    VALUE rb_protect(VALUE (*body)(VALUE), VALUE args, int *result) +

    +
    Executes body with the given args and + returns nonzero in result if any exception was raised.
    +

    void rb_notimplement()

    +
    Raises a NotImpError exception to indicate + that the enclosed function is not implemented yet, or not available on + this platform.
    +

    void rb_exit(int status)

    +
    Exits Ruby with the given status. Raises a +SystemExit exception and calls registered exit functions and + finalizers.
    +

    void rb_warn(const char *fmt, ...)

    +
    Unconditionally issues a warning message to + standard error. The given format string fmt and remaining + arguments are interpreted as with printf().
    +

    void rb_warning(const char *fmt, ...)

    +
    Conditionally issues a warning message to standard + error if Ruby was invoked with the -w flag. The given format + string fmt and remaining arguments are interpreted as with +printf().
    +

    38.7.8.5 Iterators

    +

    void rb_iter_break()

    +
    Breaks out of the enclosing iterator block.
    +

    VALUE rb_each(VALUE obj)

    +
    Invokes the each method of the given + obj.
    +

    VALUE rb_yield(VALUE arg)

    +
    Transfers execution to the iterator block in the + current context, passing arg as an argument. Multiple values may + be passed in an array.
    +

    int rb_block_given_p()

    +
    Returns true if yield would + execute a block in the current context; that is, if a code block was + passed to the current method and is available to be called.
    +

    VALUE rb_iterate(VALUE (*method)(VALUE), VALUE args, VALUE + (*block)(VALUE, VALUE), VALUE arg2)

    +
    Invokes method with argument args and + block block. A yield from that method will invoke + block with the argument given to yield, and a second + argument arg2.
    +

    VALUE rb_catch(const char *tag, VALUE (*proc)(VALUE, VALUE), + VALUE value)

    +
    Equivalent to Ruby's catch.
    +

    void rb_throw(const char *tag, VALUE value)

    +
    Equivalent to Ruby's throw.
    +

    38.7.9 Typemap Examples

    +

    This section includes a few examples of typemaps. For more examples, + you might look at the examples in the Example/ruby directory.

    +

    38.7.10 Converting a Ruby array to a char **

    +

    A common problem in many C programs is the processing of command + line arguments, which are usually passed in an array of NULL + terminated strings. The following SWIG interface file allows a Ruby + Array instance to be used as a char ** object.

    +
    +
    %module argv
     
    -%inline %{
    -  extern int fact(int n);
    -%}
    -
    -

    Typemaps are always associated with some specific aspect of code - generation. In this case, the "in" method refers to the conversion of - input arguments to C/C++. The datatype int is the datatype to - which the typemap will be applied. The supplied C code is used to - convert values. In this code a number of special variables prefaced by - a $ are used. The $1 variable is placeholder for a - local variable of type int. The $input variable is - the input Ruby object.

    -

    When this example is compiled into a Ruby module, the following - sample code:

    -
    -
    require 'example'
    +// This tells SWIG to treat char ** as a special case
    +%typemap(in) char ** {
    +  /* Get the length of the array */
    +  int size = RARRAY($input)->len; 
    +  int i;
    +  $1 = (char **) malloc((size+1)*sizeof(char *));
    +  /* Get the first element in memory */
    +  VALUE *ptr = RARRAY($input)->ptr; 
    +  for (i=0; i < size; i++, ptr++) {
    +    /* Convert Ruby Object String to char* */
    +    $1[i]= StringValuePtr(*ptr); 
    +  }
    +  $1[i]=NULL; /* End of list */
    +}
     
    -puts Example.fact(6)
    -
    -

    prints the result:

    -
    -
    -Received an integer : 6
    -720
    -
    -
    -

    In this example, the typemap is applied to all occurrences of the -int datatype. You can refine this by supplying an optional - parameter name. For example:

    -
    -
    %module example
    +// This cleans up the char ** array created before 
    +// the function call
     
    -%typemap(in) int n {
    -  $1 = (int) NUM2INT($input);
    -  printf("n = %d\n",$1);
    +%typemap(freearg) char ** {
    +  free((char *) $1);
     }
     
    +// Now a test function
     %inline %{
    -  extern int fact(int n);
    +int print_args(char **argv) {
    +  int i = 0;
    +  while (argv[i]) {
    +    printf("argv[%d] = %s\n", i,argv[i]);
    +    i++;
    +  }
    +  return i;
    +}
     %}
    -

    In this case, the typemap code is only attached to arguments that - exactly match "int n".

    -

    The application of a typemap to specific datatypes and argument names - involves more than simple text-matching--typemaps are fully integrated - into the SWIG type-system. When you define a typemap for int, - that typemap applies to int and qualified variations such as -const int. In addition, the typemap system follows typedef - declarations. For example:

    -
    -
    %typemap(in) int n {
    -  $1 = (int) NUM2INT($input);
    -  printf("n = %d\n",$1);
    -}
    -
    -typedef int Integer;
    -extern int fact(Integer n); // Above typemap is applied
    +

    When this module is compiled, the wrapped C function now operates as + follows :

    +
    +
    require 'Argv'
    +Argv.print_args(["Dave","Mike","Mary","Jane","John"])
    +argv[0] = Dave
    +argv[1] = Mike
    +argv[2] = Mary
    +argv[3] = Jane
    +argv[4] = John
    -

    However, the matching of typedef only occurs in one - direction. If you defined a typemap for Integer, it is not - applied to arguments of type int.

    -

    Typemaps can also be defined for groups of consecutive arguments. For - example:

    +

    In the example, two different typemaps are used. The "in" typemap is + used to receive an input argument and convert it to a C array. Since + dynamic memory allocation is used to allocate memory for the array, the + "freearg" typemap is used to later release this memory after the + execution of the C function.

    +

    38.7.11 Collecting arguments in a hash

    +

    Ruby's solution to the "keyword arguments" capability of some other + languages is to allow the programmer to pass in one or more key-value + pairs as arguments to a function. All of those key-value pairs are + collected in a single Hash argument that's presented to the + function. If it makes sense, you might want to provide similar + functionality for your Ruby interface. For example, suppose you'd like + to wrap this C function that collects information about people's vital + statistics:

    -
    %typemap(in) (char *str, int len) {
    -  $1 = StringValuePtr($input);
    -  $2 = (int) RSTRING($input)->len;
    -};
    -
    -int count(char c, char *str, int len);
    +
    void setVitalStats(const char *person, int nattributes, const char **names, int *values);
    -

    When a multi-argument typemap is defined, the arguments are always - handled as a single Ruby object. This allows the function count - to be used as follows (notice how the length parameter is omitted):

    +

    and you'd like to be able to call it from Ruby by passing in an + arbitrary number of key-value pairs as inputs, e.g.

    -
    puts Example.count('o','Hello World')
    -2
    +
    setVitalStats("Fred", 
    +  'weight' => 270, 
    +  'age' => 42 
    +)
    -

    36.7.2 Typemap scope

    -

    Once defined, a typemap remains in effect for all of the - declarations that follow. A typemap may be redefined for different - sections of an input file. For example:

    +

    To make this work, you need to write a typemap that expects a Ruby +Hash as its input and somehow extracts the last three arguments ( +nattributes, names and values) needed by your C + function. Let's start with the basics:

    -
    // typemap1
    -%typemap(in) int {
    -  ...
    -}
    -
    -int fact(int); // typemap1
    -int gcd(int x, int y); // typemap1
    -
    -// typemap2
    -%typemap(in) int {
    -  ...
    +
    %typemap(in) (int nattributes, const char **names, const int *values)
    +  (VALUE keys_arr, int i, VALUE key, VALUE val) {
     }
    -
    -int isprime(int); // typemap2
    +
    -

    One exception to the typemap scoping rules pertains to the -%extend declaration. %extend is used to attach new - declarations to a class or structure definition. Because of this, all - of the declarations in an %extend block are subject to the - typemap rules that are in effect at the point where the class itself is - defined. For example:

    +

    This %typemap directive tells SWIG that we want to match + any function declaration that has the specified types and names of + arguments somewhere in the argument list. The fact that we specified + the argument names (nattributes, names and values) + in our typemap is significant; this ensures that SWIG won't try to + apply this typemap to other functions it sees that happen to + have a similar declaration with different argument names. The arguments + that appear in the second set of parentheses (keys_arr, i +, key and val) define local variables that our typemap + will need.

    +

    Since we expect the input argument to be a Hash, let's next + add a check for that:

    -
    class Foo {
    -  ...
    -};
    -
    -%typemap(in) int {
    -  ...
    -}
    -
    -%extend Foo {
    -  int blah(int x); // typemap has no effect. Declaration is attached to Foo which 
    -  // appears before the %typemap declaration.
    -};
    +
    %typemap(in) (int nattributes, const char **names, const int *values)
    +  (VALUE keys_arr, int i, VALUE key, VALUE val) {
    +    Check_Type($input, T_HASH);
    +}
    -

    36.7.3 Copying a typemap

    -

    A typemap is copied by using assignment. For example:

    +

    Check_Type() is just a macro (defined in the Ruby header + files) that confirms that the input argument is of the correct type; if + it isn't, an exception will be raised.

    +

    The next task is to determine how many key-value pairs are present in + the hash; we'll assign this number to the first typemap argument ( +$1). This is a little tricky since the Ruby/C API doesn't provide a + public function for querying the size of a hash, but we can get around + that by calling the hash's size method directly and converting + its result to a C int value:

    -
    %typemap(in) Integer = int;
    +
    %typemap(in) (int nattributes, const char **names, const int *values)
    +  (VALUE keys_arr, int i, VALUE key, VALUE val) {
    +    Check_Type($input, T_HASH);
    +    $1 = NUM2INT(rb_funcall($input, rb_intern("size"), 0, NULL));
    +}
    -

    or this:

    +

    So now we know the number of attributes. Next we need to initialize + the second and third typemap arguments (i.e. the two C arrays) to +NULL and set the stage for extracting the keys and values from the + hash:

    -
    %typemap(in) Integer, Number, int32_t = int;
    +
    %typemap(in) (int nattributes, const char **names, const int *values)
    +  (VALUE keys_arr, int i, VALUE key, VALUE val) {
    +    Check_Type($input, T_HASH);
    +    $1 = NUM2INT(rb_funcall($input, rb_intern("size"), 0, NULL));
    +    $2 = NULL;
    +    $3 = NULL;
    +    if ($1 > 0) {
    +      $2 = (char **) malloc($1*sizeof(char *));
    +      $3 = (int *) malloc($1*sizeof(int));
    +    }
    +}
    -

    Types are often managed by a collection of different typemaps. For - example:

    +

    There are a number of ways we could extract the keys and values from + the input hash, but the simplest approach is to first call the hash's + keys method (which returns a Ruby array of the keys) and then start + looping over the elements in that array:

    -
    %typemap(in) int { ... }
    -%typemap(out) int { ... }
    -%typemap(varin) int { ... }
    -%typemap(varout) int { ... }
    +
    %typemap(in) (int nattributes, const char **names, const int *values)
    +  (VALUE keys_arr, int i, VALUE key, VALUE val) {
    +    Check_Type($input, T_HASH);
    +    $1 = NUM2INT(rb_funcall($input, rb_intern("size"), 0, NULL));
    +    $2 = NULL;
    +    $3 = NULL;
    +    if ($1 > 0) {
    +      $2 = (char **) malloc($1*sizeof(char *));
    +      $3 = (int *) malloc($1*sizeof(int));
    +      keys_arr = rb_funcall($input, rb_intern("keys"), 0, NULL);
    +      for (i = 0; i < $1; i++) {
    +      }
    +    }
    +}
    -

    To copy all of these typemaps to a new type, use %apply. - For example:

    +

    Recall that keys_arr and i are local variables for + this typemap. For each element in the keys_arr array, we want to + get the key itself, as well as the value corresponding to that key in + the hash:

    -
    %apply int { Integer }; // Copy all int typemaps to Integer
    -%apply int { Integer, Number }; // Copy all int typemaps to both Integer and Number
    +
    %typemap(in) (int nattributes, const char **names, const int *values)
    +  (VALUE keys_arr, int i, VALUE key, VALUE val) {
    +    Check_Type($input, T_HASH);
    +    $1 = NUM2INT(rb_funcall($input, rb_intern("size"), 0, NULL));
    +    $2 = NULL;
    +    $3 = NULL;
    +    if ($1 > 0) {
    +      $2 = (char **) malloc($1*sizeof(char *));
    +      $3 = (int *) malloc($1*sizeof(int));
    +      keys_arr = rb_funcall($input, rb_intern("keys"), 0, NULL);
    +      for (i = 0; i < $1; i++) {
    +        key = rb_ary_entry(keys_arr, i);
    +        val = rb_hash_aref($input, key);
    +      }
    +    }
    +}
    -

    The patterns for %apply follow the same rules as for -%typemap. For example:

    +

    To be safe, we should again use the Check_Type() macro to + confirm that the key is a String and the value is a Fixnum +:

    -
    %apply int *output { Integer *output }; // Typemap with name
    -%apply (char *buf, int len) { (char *buffer, int size) }; // Multiple arguments
    +
    %typemap(in) (int nattributes, const char **names, const int *values)
    +  (VALUE keys_arr, int i, VALUE key, VALUE val) {
    +    Check_Type($input, T_HASH);
    +    $1 = NUM2INT(rb_funcall($input, rb_intern("size"), 0, NULL));
    +    $2 = NULL;
    +    $3 = NULL;
    +    if ($1 > 0) {
    +      $2 = (char **) malloc($1*sizeof(char *));
    +      $3 = (int *) malloc($1*sizeof(int));
    +      keys_arr = rb_funcall($input, rb_intern("keys"), 0, NULL);
    +      for (i = 0; i < $1; i++) {
    +        key = rb_ary_entry(keys_arr, i);
    +        val = rb_hash_aref($input, key);
    +        Check_Type(key, T_STRING);
    +        Check_Type(val, T_FIXNUM);
    +      }
    +    }
    +}
    -

    36.7.4 Deleting a typemap

    -

    A typemap can be deleted by simply defining no code. For example:

    +

    Finally, we can convert these Ruby objects into their C equivalents + and store them in our local C arrays:

    -
    %typemap(in) int; // Clears typemap for int
    -%typemap(in) int, long, short; // Clears typemap for int, long, short
    -%typemap(in) int *output; 
    +
    %typemap(in) (int nattributes, const char **names, const int *values)
    +  (VALUE keys_arr, int i, VALUE key, VALUE val) {
    +  Check_Type($input, T_HASH);
    +  $1 = NUM2INT(rb_funcall($input, rb_intern("size"), 0, NULL));
    +  $2 = NULL;
    +  $3 = NULL;
    +  if ($1 > 0) {
    +    $2 = (char **) malloc($1*sizeof(char *));
    +    $3 = (int *) malloc($1*sizeof(int));
    +    keys_arr = rb_funcall($input, rb_intern("keys"), 0, NULL);
    +    for (i = 0; i < $1; i++) {
    +      key = rb_ary_entry(keys_arr, i);
    +      val = rb_hash_aref($input, key);
    +      Check_Type(key, T_STRING);
    +      Check_Type(val, T_FIXNUM);
    +      $2[i] = StringValuePtr(key);
    +      $3[i] = NUM2INT(val);
    +    }
    +  }
    +}
    -

    The %clear directive clears all typemaps for a given type. - For example:

    +

    We're not done yet. Since we used malloc() to dynamically + allocate the memory used for the names and values + arguments, we need to provide a corresponding "freearg" typemap to free + that memory so that there is no memory leak. Fortunately, this typemap + is a lot easier to write:

    -
    %clear int; // Removes all types for int
    -%clear int *output, long *output;
    +
    %typemap(freearg) (int nattributes, const char **names, const int *values) {
    +  free((void *) $2);
    +  free((void *) $3);
    +}
    -

    Note: Since SWIG's default behavior is defined by typemaps, - clearing a fundamental type like int will make that type - unusable unless you also define a new set of typemaps immediately after - the clear operation.

    -

    36.7.5 Placement of - typemaps

    -

    Typemap declarations can be declared in the global scope, within a - C++ namespace, and within a C++ class. For example:

    +

    All of the code for this example, as well as a sample Ruby program + that uses the extension, can be found in the Examples/ruby/hashargs + directory of the SWIG distribution.

    +

    38.7.12 Pointer handling

    +

    Occasionally, it might be necessary to convert pointer values that + have been stored using the SWIG typed-pointer representation. Since + there are several ways in which pointers can be represented, the + following two functions are used to safely perform this conversion:

    +

    int SWIG_ConvertPtr(VALUE obj, void **ptr, swig_type_info *ty, + int flags)

    +
    Converts a Ruby object obj to a C pointer + whose address is ptr (i.e. ptr is a pointer to a + pointer). The third argument, ty, is a pointer to a SWIG type + descriptor structure. If ty is not NULL, that type + information is used to validate type compatibility and other aspects of + the type conversion. If flags is non-zero, any type errors + encountered during this validation result in a Ruby TypeError + exception being raised; if flags is zero, such type errors will + cause SWIG_ConvertPtr() to return -1 but not raise an + exception. If ty is NULL, no type-checking is + performed.
    +

    VALUE SWIG_NewPointerObj(void *ptr, swig_type_info *ty, int own) +

    +
    Creates a new Ruby pointer object. Here, ptr + is the pointer to convert, ty is the SWIG type descriptor + structure that describes the type, and own is a flag that + indicates whether or not Ruby should take ownership of the pointer + (i.e. whether Ruby should free this data when the corresponding Ruby + instance is garbage-collected).
    +

    Both of these functions require the use of a special SWIG + type-descriptor structure. This structure contains information about + the mangled name of the datatype, type-equivalence information, as well + as information about converting pointer values under C++ inheritance. + For a type of Foo *, the type descriptor structure is usually + accessed as follows:

    +
    +
    Foo *foo;
    +SWIG_ConvertPtr($input, (void **) &foo, SWIGTYPE_p_Foo, 1);
    +
    +VALUE obj;
    +obj = SWIG_NewPointerObj(f, SWIGTYPE_p_Foo, 0);
    +
    +

    In a typemap, the type descriptor should always be accessed using + the special typemap variable $1_descriptor. For example:

    +
    +
    %typemap(in) Foo * {
    +  SWIG_ConvertPtr($input, (void **) &$1, $1_descriptor, 1);
    +}
    +
    +

    38.7.12.1 Ruby Datatype Wrapping

    +

    VALUE Data_Wrap_Struct(VALUE class, void (*mark)(void *), void + (*free)(void *), void *ptr)

    +
    Given a pointer ptr to some C data, and the + two garbage collection routines for this data (mark and free +), return a VALUE for the Ruby object.
    +

    VALUE Data_Make_Struct(VALUE class, c-type, void + (*mark)(void *), void (*free)(void *), c-type *ptr)

    +
    Allocates a new instance of a C data type c-type +, assigns it to the pointer ptr, then wraps that pointer with +Data_Wrap_Struct() as above.
    +

    Data_Get_Struct(VALUE obj, c-type, c-type *ptr) +

    +
    Retrieves the original C pointer of type c-type + from the data object obj and assigns that pointer to ptr.
    +

    38.7.13 Example: STL Vector to Ruby Array

    +

    Another use for macros and type maps is to create a Ruby array from a + STL vector of pointers. In essence, copy of all the pointers in the + vector into a Ruby array. The use of the macro is to make the typemap + so generic that any vector with pointers can use the type map. The + following is an example of how to construct this type of macro/typemap + and should give insight into constructing similar typemaps for other + STL structures:

    -
    %typemap(in) int {
    -  ...
    +
    %define PTR_VECTOR_TO_RUBY_ARRAY(vectorclassname, classname)
    +%typemap(out) vectorclassname &, const vectorclassname & {
    +  VALUE arr = rb_ary_new2($1->size());
    +  vectorclassname::iterator i = $1->begin(), iend = $1->end();
    +  for ( ; i!=iend; i++ )
    +    rb_ary_push(arr, Data_Wrap_Struct(c ## classname.klass, 0, 0, *i));
    +  $result = arr;
     }
    -
    -namespace std {
    -  class string;
    -  %typemap(in) string {
    -    ...
    +%typemap(out) vectorclassname, const vectorclassname {
    +  VALUE arr = rb_ary_new2($1.size());
    +  vectorclassname::iterator i = $1.begin(), iend = $1.end();
    +  for ( ; i!=iend; i++ )
    +    rb_ary_push(arr, Data_Wrap_Struct(c ## classname.klass, 0, 0, *i));
    +  $result = arr;
    +}
    +%enddef
    +
    +

    Note, that the "c ## classname.klass" is used in the + preprocessor step to determine the actual object from the class name.

    +

    To use the macro with a class Foo, the following is used:

    +
    +
    PTR_VECTOR_TO_RUBY_ARRAY(vector<foo *="">, Foo)
    +
    +

    It is also possible to create a STL vector of Ruby objects:

    +
    +
    %define RUBY_ARRAY_TO_PTR_VECTOR(vectorclassname, classname)
    +%typemap(in) vectorclassname &, const vectorclassname & {
    +  Check_Type($input, T_ARRAY);
    +  vectorclassname *vec = new vectorclassname;
    +  int len = RARRAY($input)->len;
    +  for (int i=0; i!=len; i++) {
    +    VALUE inst = rb_ary_entry($input, i);
    +    //The following _should_ work but doesn't on HPUX
    +    // Check_Type(inst, T_DATA);
    +    classname *element = NULL;
    +    Data_Get_Struct(inst, classname, element);
    +    vec->push_back(element);
       }
    +  $1 = vec;
     }
     
    -class Bar {
    -public:
    -  typedef const int & const_reference;
    -  %typemap(out) const_reference {
    -    ...
    -  }
    -};
    +%typemap(freearg) vectorclassname &, const vectorclassname & { + delete $1; +} +%enddef
    -

    When a typemap appears inside a namespace or class, it stays in - effect until the end of the SWIG input (just like before). However, the - typemap takes the local scope into account. Therefore, this code

    +

    It is also possible to create a Ruby array from a vector of static + data types:

    -
    namespace std {
    -  class string;
    -  %typemap(in) string {
    -    ...
    -  }
    -}
    +
    %define VECTOR_TO_RUBY_ARRAY(vectorclassname, classname)
    +%typemap(out) vectorclassname &, const vectorclassname & {
    +  VALUE arr = rb_ary_new2($1->size()); 
    +  vectorclassname::iterator i = $1->begin(), iend = $1->end();
    +  for ( ; i!=iend; i++ )
    +    rb_ary_push(arr, Data_Wrap_Struct(c ## classname.klass, 0, 0, &(*i)));
    +  $result = arr;
    +}
    +%typemap(out) vectorclassname, const vectorclassname {
    +  VALUE arr = rb_ary_new2($1.size()); 
    +  vectorclassname::iterator i = $1.begin(), iend = $1.end();
    +  for ( ; i!=iend; i++ )
    +    rb_ary_push(arr, Data_Wrap_Struct(c ## classname.klass, 0, 0, &(*i)));
    +  $result = arr;
    +}
    +%enddef
    +
    Note that this is mostly an example of typemaps. If you want to + use the STL with ruby, you are advised to use the standard swig STL + library, which does much more than this. Refer to the section called + the C++ Standard Template Library. +

    38.8 Docstring Features

    +

    Using ri and rdoc web pages in Ruby libraries is a common practice. + Given the way that SWIG generates the extensions by default, your users + will normally not get any documentation for it, even if they run 'rdoc' + on the resulting .c or .cxx file.

    +

    The features described in this section make it easy for you to add + rdoc strings to your modules, functions and methods that can then be + read by Ruby's rdoc tool to generate html web pages, ri documentation, + Windows chm file and an .xml description.

    +

    rdoc can then be run from a console or shell window on a swig + generated file.

    +

    For example, to generate html web pages from a C++ file, you'd do:

    +
    +
    +$ rdoc -E cxx=c -f html file_wrap.cxx
    +
    +
    +

    To generate ri documentation from a c wrap file, you could do:

    +
    +
    +$ rdoc -r file_wrap.c
    +
    +
    +

    38.8.1 Module docstring

    +

    Ruby allows a docstring at the beginning of the file before any + other statements, and it is typically used to give a general + description of the entire module. SWIG supports this by setting an + option of the %module directive. For example:

    +
    +
    %module(docstring="This is the example module's docstring") example
    -

    is really defining a typemap for the type std::string. You - could have code like this:

    +

    When you have more than just a line or so then you can retain the + easy readability of the %module directive by using a macro. + For example:

    -
    namespace std {
    -  class string;
    -  %typemap(in) string { /* std::string */
    -  ...
    -  }
    -}
    +
    %define DOCSTRING
    +"The `XmlResource` class allows program resources defining menus, 
    +layout of controls on a panel, etc. to be loaded from an XML file."
    +%enddef
     
    -namespace Foo {
    -  class string;
    -  %typemap(in) string { /* Foo::string */
    -  ...
    -  }
    -}
    +%module(docstring=DOCSTRING) xrc
    -

    In this case, there are two completely distinct typemaps that apply - to two completely different types (std::string and -Foo::string).

    -

    It should be noted that for scoping to work, SWIG has to know that -string is a typename defined within a particular namespace. In this - example, this is done using the class declaration class string - .

    -

    36.7.6 Ruby typemaps

    -

    The following list details all of the typemap methods that can be - used by the Ruby module:

    -

    36.7.6.1 "in" typemap

    -

    Converts Ruby objects to input function arguments. For example:

    +

    38.8.2 %feature("autodoc")

    +

    Since SWIG does know everything about the function it wraps, it is + possible to generate an rdoc containing the parameter types, names and + default values. Since Ruby ships with one of the best documentation + systems of any language, it makes sense to take advantage of it.

    +

    SWIG's Ruby module provides support for the "autodoc" feature, which + when attached to a node in the parse tree will cause an rdoc comment to + be generated in the wrapper file that includes the name of the + function, parameter names, default values if any, and return type if + any. There are also several options for autodoc controlled by the value + given to the feature, described below.

    +

    38.8.2.1 %feature("autodoc", "0")

    +

    When the "0" option is given then the types of the parameters will + not be included in the autodoc string. For example, given this + function prototype:

    -
    %typemap(in) int {
    -  $1 = NUM2INT($input);
    -}
    +
    %feature("autodoc", "0");
    +bool function_name(int x, int y, Foo* foo=NULL, Bar* bar=NULL);
    -

    The following special variables are available:

    -
    - - - - - - - - -
    $input Input object holding value to be converted.
    $symname Name of function/method being wrapped
    $1...n Argument being sent to the function
    $1_name Name of the argument (if provided)
    $1_type The actual C datatype matched by the typemap.
    $1_ltype The assignable version of the C datatype - matched by the typemap.
    +

    Then Ruby code like this will be generated:

    +
    +
    function_name(x, y, foo=nil, bar=nil) -> bool
    +  ...
    -

    This is probably the most commonly redefined typemap because it can - be used to implement customized conversions.

    -

    In addition, the "in" typemap allows the number of converted - arguments to be specified. For example:

    -
    -
    // Ignored argument.
    -%typemap(in, numinputs=0) int *out (int temp) {
    -  $1 = &temp;
    -}
    +

    38.8.2.2 %feature("autodoc", "1")

    +

    When the "1" option is used then the parameter types will + be used in the rdoc string. In addition, an attempt is made to simplify + the type name such that it makes more sense to the Ruby user. Pointer, + reference and const info is removed, %rename's are evaluated, + etc. (This is not always successful, but works most of the time. See + the next section for what to do when it doesn't.) Given the example + above, then turning on the parameter types with the "1" option will + result in rdoc code like this:

    +
    +
    function_name(int x, int y, Foo foo=nil, Bar bar=nil) -> bool
    +  ...
    -

    At this time, only zero or one arguments may be converted.

    -

    36.7.6.2 "typecheck" typemap

    -

    The "typecheck" typemap is used to support overloaded functions and - methods. It merely checks an argument to see whether or not it matches - a specific type. For example:

    -
    -
    %typemap(typecheck,precedence=SWIG_TYPECHECK_INTEGER) int {
    -  $1 = FIXNUM_P($input) ? 1 : 0;
    -}
    +

    38.8.2.3 %feature("autodoc", "2")

    +

    When the "2" option is used then the parameter types will not be + used in the rdoc string. However, they will be listed in full after the + function. Given the example above, then turning on the parameter types + with the "2" option will result in Ruby code like this:

    +

    38.8.2.4 %feature("autodoc", "3") +

    +

    When the "3" option is used then the function will be documented + using a combination of "1" and "2" above. Given the example above, then + turning on the parameter types with the "2" option will result in Ruby + code like this:

    +
    +
    function_name(int x, int y, Foo foo=nil, Bar bar=nil) -> bool
    +
    +Parameters:
    +        x - int
    +        y - int
    +        foo - Foo
    +        bar - Bar
    -

    For typechecking, the $1 variable is always a simple integer that is - set to 1 or 0 depending on whether or not the input argument is the - correct type.

    -

    If you define new "in" typemaps and your program uses - overloaded methods, you should also define a collection of "typecheck" - typemaps. More details about this follow in a later section on - "Typemaps and Overloading."

    -

    36.7.6.3 "out" typemap

    -

    Converts return value of a C function to a Ruby object.

    +

    38.8.2.5 %feature("autodoc", "docstring")

    +

    Finally, there are times when the automatically generated autodoc + string will make no sense for a Ruby programmer, particularly when a + typemap is involved. So if you give an explicit value for the autodoc + feature then that string will be used in place of the automatically + generated string. For example:

    -
    %typemap(out) int {
    -  $result = INT2NUM( $1 );
    -}
    -
    +
    %feature("autodoc", "GetPosition() -> (x, y)") GetPosition;
    +void GetPosition(int* OUTPUT, int* OUTPUT);
    -

    The following special variables are available.

    -
    - - - - - - - - +

    38.8.3 %feature("docstring")

    +

    In addition to the autodoc strings described above, you can also + attach any arbitrary descriptive text to a node in the parse tree with + the "docstring" feature. When the proxy module is generated then any + docstring associated with classes, function or methods are output. If + an item already has an autodoc string then it is combined with the + docstring and they are output together.

    +

    38.9 Advanced Topics

    +

    38.9.1 Operator overloading

    +

    SWIG allows operator overloading with, by using the %extend + or %rename commands in SWIG and the following operator names + (derived from Python):

    +
    +
    $result Result object returned to target language.
    $symname Name of function/method being wrapped
    $1...n Argument being wrapped
    $1_name Name of the argument (if provided)
    $1_type The actual C datatype matched by the typemap.
    $1_ltype The assignable version of the C datatype - matched by the typemap.
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    General
    __repr__ inspect
    __str__ to_s
    __cmp__ <=>
    __hash__ hash
    __nonzero__ nonzero?
    Callable
    __call__ call
    Collection
    __len__ length
    __getitem__ []
    __setitem__ []=
    Numeric
    __add__ +
    __sub__ -
    __mul__ *
    __div__ /
    __mod__ %
    __divmod__ divmod
    __pow__ **
    __lshift__ <<
    __rshift__ >>
    __and__ &
    __xor__ ^
    __or__ |
    __neg__ -@
    __pos__ +@
    __abs__ abs
    __invert__ ~
    __int__ to_i
    __float__ to_f
    __coerce__ coerce
    Additions in 1.3.13
    __lt__ <
    __le__ <=
    __eq__ ==
    __gt__ >
    __ge__ >=
    -

    36.7.6.4 "arginit" typemap

    -

    The "arginit" typemap is used to set the initial value of a function - argument--before any conversion has occurred. This is not normally - necessary, but might be useful in highly specialized applications. For - example:

    +

    Note that although SWIG supports the __eq__ magic method + name for defining an equivalence operator, there is no separate method + for handling inequality since Ruby parses the expression a != + b as !(a == b).

    +

    38.9.2 Creating Multi-Module Packages

    +

    The chapter on Working with Modules discusses + the basics of creating multi-module extensions with SWIG, and in + particular the considerations for sharing runtime type information + among the different modules.

    +

    As an example, consider one module's interface file (shape.i +) that defines our base class:

    -
    // Set argument to NULL before any conversion occurs
    -%typemap(arginit) int *data {
    -  $1 = NULL;
    -}
    +
    %module shape
    +
    +%{
    +#include "Shape.h"
    +%}
    +
    +class Shape {
    +protected:
    +  double xpos;
    +  double ypos;
    +protected:
    +  Shape(double x, double y);
    +public:
    +  double getX() const;
    +  double getY() const;
    +};
    -

    36.7.6.5 "default" typemap

    -

    The "default" typemap is used to turn an argument into a default - argument. For example:

    +

    We also have a separate interface file (circle.i) that + defines a derived class:

    -
    %typemap(default) int flags {
    -  $1 = DEFAULT_FLAGS;
    -}
    -...
    -int foo(int x, int y, int flags);
    +
    %module circle
    +
    +%{
    +#include "Shape.h"
    +#include "Circle.h"
    +%}
    +
    +// Import the base class definition from Shape module
    +%import shape.i
    +
    +class Circle : public Shape {
    +protected:
    +  double radius;
    +public:
    +  Circle(double x, double y, double r);
    +  double getRadius() const;
    +};
    -

    The primary use of this typemap is to either change the wrapping of - default arguments or specify a default argument in a language where - they aren't supported (like C). Target languages that do not support - optional arguments, such as Java and C#, effectively ignore the value - specified by this typemap as all arguments must be given.

    -

    Once a default typemap has been applied to an argument, all - arguments that follow must have default values. See the - Default/optional arguments section for further information on - default argument wrapping.

    -

    36.7.6.6 "check" typemap

    -

    The "check" typemap is used to supply value checking code during - argument conversion. The typemap is applied after arguments - have been converted. For example:

    -
    -
    %typemap(check) int positive {
    -  if ($1 <= 0) {
    -    SWIG_exception(SWIG_ValueError,"Expected positive value.");
    -  }
    -}
    +

    We'll start by building the Shape extension module:

    +
    +
    $ swig -c++ -ruby shape.i
    +
    -

    36.7.6.7 "argout" typemap

    -

    The "argout" typemap is used to return values from arguments. This - is most commonly used to write wrappers for C/C++ functions that need - to return multiple values. The "argout" typemap is almost always - combined with an "in" typemap---possibly to ignore the input value. For - example:

    -
    -
    /* Set the input argument to point to a temporary variable */
    -%typemap(in, numinputs=0) int *out (int temp) {
    -  $1 = &temp;
    -}
    +

    SWIG generates a wrapper file named shape_wrap.cxx. To + compile this into a dynamically loadable extension for Ruby, prepare an + extconf.rb script using this template:

    +
    +
    require 'mkmf'
     
    -%typemap(argout, fragment="output_helper") int *out {
    -  // Append output value $1 to $result (assuming a single integer in this case)
    -  $result = output_helper( $result, INT2NUM(*$1) );
    -}
    +# Since the SWIG runtime support library for Ruby +# depends on the Ruby library, make sure it's in the list +# of libraries. +$libs = append_library($libs, Config::CONFIG['RUBY_INSTALL_NAME']) + +# Create the makefile +create_makefile('shape')
    -

    The following special variables are available.

    -
    - - - - -
    $result Result object returned to target language.
    $input The original input object passed.
    $symname Name of function/method being wrapped.
    +

    Run this script to create a Makefile and then type make + to build the shared library:

    +
    +
    $ ruby extconf.rb
    +creating Makefile
    +$ make
    +g++ -fPIC -g -O2 -I. -I/usr/include/ruby-2.1.0 \
    +-I. -c shape_wrap.cxx
    +gcc -shared -L/usr/local/lib -o shape.so shape_wrap.o -L. \
    +-lruby -lruby -lc
    -

    The code supplied to the "argout" typemap is always placed after the - "out" typemap. If multiple return values are used, the extra return - values are often appended to return value of the function.

    -

    Output helper is a fragment that usually defines a macro to some - function like SWIG_Ruby_AppendOutput.

    -

    See the typemaps.i library for examples.

    -

    36.7.6.8 "freearg" typemap

    -

    The "freearg" typemap is used to cleanup argument data. It is only - used when an argument might have allocated resources that need to be - cleaned up when the wrapper function exits. The "freearg" typemap - usually cleans up argument resources allocated by the "in" typemap. For - example:

    -
    -
    // Get a list of integers
    -%typemap(in) int *items {
    -  int nitems = Length($input); 
    -  $1 = (int *) malloc(sizeof(int)*nitems);
    -}
    -// Free the list 
    -%typemap(freearg) int *items {
    -  free($1);
    -}
    +

    Note that depending on your installation, the outputs may be + slightly different; these outputs are those for a Linux-based + development environment. The end result should be a shared library + (here, shape.so) containing the extension module code. Now + repeat this process in a separate directory for the Circle + module:

    +
      +
    1. Run SWIG to generate the wrapper code (circle_wrap.cxx);
    2. +
    3. Write an extconf.rb script that your end-users can use to + create a platform-specific Makefile for the extension;
    4. +
    5. Build the shared library for this extension by typing make +.
    6. +
    +

    Once you've built both of these extension modules, you can test them + interactively in IRB to confirm that the Shape and Circle + modules are properly loaded and initialized:

    +
    +
    $ irb
    +irb(main):001:0> require 'shape'
    +true
    +irb(main):002:0> require 'circle'
    +true
    +irb(main):003:0> c = Circle::Circle.new(5, 5, 20)
    +#<Circle::Circle:0xa097208>
    +irb(main):004:0> c.kind_of? Shape::Shape
    +true
    +irb(main):005:0> c.getX()
    +5.0
    -

    The "freearg" typemap inserted at the end of the wrapper function, - just before control is returned back to the target language. This code - is also placed into a special variable $cleanup that may be - used in other typemaps whenever a wrapper function needs to abort - prematurely.

    -

    36.7.6.9 "newfree" typemap

    -

    The "newfree" typemap is used in conjunction with the %newobject - directive and is used to deallocate memory used by the return result of - a function. For example:

    -
    -
    %typemap(newfree) string * {
    -  delete $1;
    -}
    -%typemap(out) string * {
    -  $result = PyString_FromString($1->c_str());
    -}
    -...
    -
    -%newobject foo;
    -...
    -string *foo();
    +

    38.9.3 Specifying Mixin Modules

    +

    The Ruby language doesn't support multiple inheritance, but it does + allow you to mix one or more modules into a class using Ruby's +include method. For example, if you have a Ruby class that defines + an each instance method, e.g.

    +
    +
    class Set
    +  def initialize
    +  @members = []
    +  end
    + 
    +  def each
    +  @members.each { |m| yield m }
    +  end
    +end
    -

    See Object ownership and - %newobject for further details.

    -

    36.7.6.10 "memberin" typemap

    -

    The "memberin" typemap is used to copy data from an already - converted input value into a structure member. It is typically - used to handle array members and other special cases. For example:

    +

    then you can mix-in Ruby's Enumerable module to easily add + a lot of functionality to your class:

    +
    +
    class Set
    +  include Enumerable
    +  def initialize
    +    @members = []
    +  end
    +  def each
    +    @members.each { |m| yield m }
    +  end
    +end
    +
    +

    To get the same benefit for your SWIG-wrapped classes, you can use + the %mixin directive to specify the names of one or more + modules that should be mixed-in to a class. For the above example, the + SWIG interface specification might look like this:

    -
    %typemap(memberin) int [4] {
    -  memmove($1, $input, 4*sizeof(int));
    -}
    +
    %mixin Set "Enumerable";
    +
    +class Set {
    +public:
    +  // Constructor
    +  Set();
    + 
    +  // Iterates through set members
    +  void each();
    +};
    -

    It is rarely necessary to write "memberin" typemaps---SWIG already - provides a default implementation for arrays, strings, and other - objects.

    -

    36.7.6.11 "varin" typemap

    -

    The "varin" typemap is used to convert objects in the target - language to C for the purposes of assigning to a C/C++ global variable. - This is implementation specific.

    -

    36.7.6.12 "varout" typemap

    -

    The "varout" typemap is used to convert a C/C++ object to an object - in the target language when reading a C/C++ global variable. This is - implementation specific.

    -

    36.7.6.13 "throws" typemap

    -

    The "throws" typemap is only used when SWIG parses a C++ method with - an exception specification or has the %catches feature - attached to the method. It provides a default mechanism for handling - C++ methods that have declared the exceptions they will throw. The - purpose of this typemap is to convert a C++ exception into an error or - exception in the target language. It is slightly different to the other - typemaps as it is based around the exception type rather than the type - of a parameter or variable. For example:

    +

    Multiple modules can be mixed into a class by providing a + comma-separated list of module names to the %mixin directive, + e.g.

    -
    %typemap(throws) const char * %{
    -  rb_raise(rb_eRuntimeError, $1);
    -  SWIG_fail;
    -%}
    -void bar() throw (const char *);
    +
    %mixin Set "Fee,Fi,Fo,Fum";
    -

    As can be seen from the generated code below, SWIG generates an - exception handler with the catch block comprising the "throws" typemap - content.

    +

    Note that the %mixin directive is implemented using SWIG's + "features" mechanism and so the same name matching rules used for other + kinds of features apply (see the chapter on +"Customization Features") for more details).

    +

    38.10 Memory Management

    +

    One of the most common issues in generating SWIG bindings for Ruby is + proper memory management. The key to proper memory management is + clearly defining whether a wrapper Ruby object owns the underlying C + struct or C++ class. There are two possibilities:

    +
      +
    • The Ruby object is responsible for freeing the C struct or C++ + object
    • +
    • The Ruby object should not free the C struct or C++ object because + it will be freed by the underlying C or C++ code
    • +
    +

    To complicate matters, object ownership may transfer from Ruby to C++ + (or vice versa) depending on what function or methods are invoked. + Clearly, developing a SWIG wrapper requires a thorough understanding of + how the underlying library manages memory.

    +

    38.10.1 Mark and Sweep Garbage Collector

    +

    Ruby uses a mark and sweep garbage collector. When the garbage + collector runs, it finds all the "root" objects, including local + variables, global variables, global constants, hardware registers and + the C stack. For each root object, the garbage collector sets its mark + flag to true and calls rb_gc_mark on the object. The job of +rb_gc_mark is to recursively mark all the objects that a Ruby + object has a reference to (ignoring those objects that have already + been marked). Those objects, in turn, may reference other objects. This + process will continue until all active objects have been "marked." + After the mark phase comes the sweep phase. In the sweep phase, all + objects that have not been marked will be garbage collected.

    +

    The Ruby C/API provides extension developers two hooks into the + garbage collector - a "mark" function and a "sweep" function. By + default these functions are set to NULL.

    +

    If a C struct or C++ class references any other Ruby objects, then it + must provide a "mark" function. The "mark" function should identify any + referenced Ruby objects by calling the rb_gc_mark function for each + one. Unsurprisingly, this function will be called by the Ruby garbage + during the "mark" phase.

    +

    During the sweep phase, Ruby destroys any unused objects. If any + memory has been allocated in creating the underlying C struct or C++ + struct, then a "free" function must be defined that deallocates this + memory.

    +

    38.10.2 Object Ownership

    +

    As described above, memory management depends on clearly defining who + is responsible for freeing the underlying C struct or C++ class. If the + Ruby object is responsible for freeing the C++ object, then a "free" + function must be registered for the object. If the Ruby object is not + responsible for freeing the underlying memory, then a "free" function + must not be registered for the object.

    +

    For the most part, SWIG takes care of memory management issues. The + rules it uses are:

    +
      +
    • When calling a C++ object's constructor from Ruby, SWIG will assign + a "free" function thereby making the Ruby object responsible for + freeing the C++ object
    • +
    • When calling a C++ member function that returns a pointer, SWIG + will not assign a "free" function thereby making the underlying library + responsible for freeing the object.
    • +
    +

    To make this clearer, let's look at an example. Assume we have a Foo + and a Bar class.

    -
    ...
    -try {
    -  bar();
    -}
    -catch(char const *_e) {
    -  rb_raise(rb_eRuntimeError, _e);
    -  SWIG_fail;
    -}
    -...
    +
    /* File "RubyOwernshipExample.h" */
    +
    +class Foo
    +{
    +public:
    +  Foo() {}
    +  ~Foo() {}
    +};
    +
    +class Bar
    +{
    +  Foo *foo_;
    +public:
    +  Bar(): foo_(new Foo) {}
    +  ~Bar() { delete foo_; }
    +  Foo* get_foo() { return foo_; }
    +  Foo* get_new_foo() { return new Foo; }
    +  void set_foo(Foo *foo) { delete foo_; foo_ = foo; }
    +};
    -

    Note that if your methods do not have an exception specification yet - they do throw exceptions, SWIG cannot know how to deal with them. For a - neat way to handle these, see the -Exception handling with %exception section.

    -

    36.7.6.14 directorin typemap

    -

    Converts C++ objects in director member functions to ruby objects. It - is roughly the opposite of the "in" typemap, making its typemap rule - often similar to the "out" typemap.

    -
    -
    -%typemap(directorin) int {
    -  $result = INT2NUM($1);
    -}
    -
    +

    First, consider this Ruby code:

    +
    +
    foo = Foo.new
    -

    The following special variables are available.

    -
    - - - - - - - - - -
    $result Result object returned to target language.
    $symname Name of function/method being wrapped
    $1...n Argument being wrapped
    $1_name Name of the argument (if provided)
    $1_type The actual C datatype matched by the typemap.
    $1_ltype The assignable version of the C datatype - matched by the typemap.
    this C++ this, referring to the class itself.
    +

    In this case, the Ruby code calls the underlying Foo C++ + constructor, thus creating a new foo object. By default, SWIG + will assign the new Ruby object a "free" function. When the Ruby object + is garbage collected, the "free" function will be called. It in turn + will call Foo's destructor.

    +

    Next, consider this code:

    +
    +
    bar = Bar.new
    +foo = bar.get_foo()
    -

    36.7.6.15 directorout typemap

    -

    Converts Ruby objects in director member functions to C++ objects. It - is roughly the opposite of the "out" typemap, making its rule often - similar to the "in" typemap.

    -
    -
    -%typemap(directorout) int {
    -  $result = NUM2INT($1);
    -}
    -
    +

    In this case, the Ruby code calls a C++ member function, get_foo +. By default, SWIG will not assign the Ruby object a "free" function. + Thus, when the Ruby object is garbage collected the underlying C++ +foo object is not affected.

    +

    Unfortunately, the real world is not as simple as the examples above. + For example:

    +
    +
    bar = Bar.new
    +foo = bar.get_new_foo()
    -

    The following special variables are available:

    -
    - - - - - - - - - -
    $inputRuby object being sent to the function
    $symnameName of function/method being wrapped
    $1...nArgument being sent to the function
    $1_name Name of the argument (if provided)
    $1_type The actual C datatype matched by the typemap.
    $1_ltype The assignable version of the C datatype - matched by the typemap.
    this C++ this, referring to the class itself.
    +

    In this case, the default SWIG behavior for calling member functions + is incorrect. The Ruby object should assume ownership of the returned + object. This can be done by using the %newobject directive. See + Object ownership and %newobject for more information.

    +

    The SWIG default mappings are also incorrect in this case:

    +
    +
    foo = Foo.new
    +bar = Bar.new
    +bar.set_foo(foo)
    -

    Currently, the directorout nor the out typemap support the option -numoutputs, but the Ruby module provides that functionality through - a %feature directive. Thus, a function can be made to return "nothing" - if you do:

    +

    Without modification, this code will cause a segmentation fault. When + the Ruby foo object goes out of scope, it will free the + underlying C++ foo object. However, when the Ruby bar object + goes out of scope, it will call the C++ bar destructor which will also + free the C++ foo object. The problem is that object ownership + is transferred from the Ruby object to the C++ object when the +set_foo method is called. This can be done by using the special + DISOWN type map, which was added to the Ruby bindings in SWIG-1.3.26.

    +

    Thus, a correct SWIG interface file correct mapping for these classes + is:

    -
    -%feature("numoutputs","0") MyClass::function;
    +
    /* File RubyOwnershipExample.i */
    +
    +%module RubyOwnershipExample
    +
    +%{
    +#include "RubyOwnershipExample.h"
    +%}
    +
    +class Foo
    +{
    +public:
    +  Foo();
    +  ~Foo();
    +};
    +
    +class Bar
    +{
    +  Foo *foo_;
    +public:
    +  Bar();
    +  ~Bar();
    +  Foo* get_foo();
    +
    +  %newobject get_new_foo;
    +  Foo* get_new_foo();
    +
    +  %apply SWIGTYPE *DISOWN {Foo *foo};
    +  void set_foo(Foo *foo);
    +  %clear Foo *foo;
    +};
     
    -

    This feature can be useful if a function returns a status code, which - you want to discard but still use the typemap to raise an exception.

    -

    36.7.6.16 directorargout - typemap

    -

    Output argument processing in director member functions.

    +

    This code can be seen in swig/examples/ruby/tracking.

    +

    38.10.3 Object Tracking

    +

    The remaining parts of this section will use the class library shown + below to illustrate different memory management techniques. The class + library models a zoo and the animals it contains.

    -
    -%typemap(directorargout,
    -fragment="output_helper") int {
    -  $result = output_helper( $result, NUM2INT($1) );
    -}
    -
    -
    -

    The following special variables are available:

    -
    - - - - - - - - - - -
    $resultResult that the director function returns
    $inputRuby object being sent to the function
    $symnamename of the function/method being wrapped
    $1...nArgument being sent to the function
    $1_nameName of the argument (if provided)
    $1_typeThe actual C datatype matched by the typemap
    $1_ltypeThe assignable version of the C datatype - matched by the typemap
    thisC++ this, referring to the instance of the class - itself
    +
    %module zoo
    +
    +%{
    +#include <string>
    +#include <vector>
    +
    +#include "zoo.h"
    +%}
    +
    +class Animal
    +{
    +private:
    +  typedef std::vector<Animal*> AnimalsType;
    +  typedef AnimalsType::iterator IterType;
    +protected:
    +  AnimalsType animals;
    +protected:
    +  std::string name_;
    +public:
    +  // Construct an animal with this name
    +  Animal(const char* name) : name_(name) {}
    + 
    +  // Return the animal's name
    +  const char* get_name() const { return name.c_str(); }
    +};
    +
    +class Zoo
    +{
    +protected:
    + std::vector<Animal *> animals;
    + 
    +public:
    +  // Construct an empty zoo
    +  Zoo() {}
    +  
    +  /* Create a new animal. */
    +  static Animal* Zoo::create_animal(const char* name) {
    +    return new Animal(name);
    +  }
    + 
    +  // Add a new animal to the zoo
    +  void add_animal(Animal* animal) {
    +    animals.push_back(animal); 
    +  }
    + 
    +  Animal* remove_animal(size_t i) {
    +    Animal* result = this->animals[i];
    +    IterType iter = this->animals.begin();
    +    std::advance(iter, i);
    +    this->animals.erase(iter);
    +   
    +    return result;
    +  }
    +  
    +  // Return the number of animals in the zoo
    +  size_t get_num_animals() const {
    +    return animals.size(); 
    +  }
    +  
    +  // Return a pointer to the ith animal
    +  Animal* get_animal(size_t i) const {
    +    return animals[i]; 
    +  }
    +};
    -

    36.7.6.17 ret typemap

    -

    Cleanup of function return values

    -

    36.7.6.18 globalin typemap

    -

    Setting of C global variables

    -

    36.7.7 Typemap variables

    -

    Within a typemap, a number of special variables prefaced with a -$ may appear. A full list of variables can be found in the " -Typemaps" chapter. This is a list of the most common variables:

    -

    $1

    -
    A C local variable corresponding to the actual type - specified in the %typemap directive. For input values, this is - a C local variable that is supposed to hold an argument value. For - output values, this is the raw result that is supposed to be returned - to Ruby.
    -

    $input

    -
    A VALUE holding a raw Ruby object with an - argument or variable value.
    -

    $result

    -
    A VALUE that holds the result to be - returned to Ruby.
    -

    $1_name

    -
    The parameter name that was matched.
    -

    $1_type

    -
    The actual C datatype matched by the typemap.
    -

    $1_ltype

    -
    An assignable version of the datatype matched by the - typemap (a type that can appear on the left-hand-side of a C assignment - operation). This type is stripped of qualifiers and may be an altered - version of $1_type. All arguments and local variables in - wrapper functions are declared using this type so that their values can - be properly assigned.
    -

    $symname

    -
    The Ruby name of the wrapper function being created.
    -

    36.7.8 Useful Functions

    -

    When you write a typemap, you usually have to work directly with - Ruby objects. The following functions may prove to be useful. (These - functions plus many more can be found in Programming Ruby - book, by David Thomas and Andrew Hunt.)

    -

    In addition, we list equivalent functions that SWIG defines, which - provide a language neutral conversion (these functions are defined for - each swig language supported). If you are trying to create a swig file - that will work under multiple languages, it is recommended you stick to - the swig functions instead of the native Ruby functions. That should - help you avoid having to rewrite a lot of typemaps across multiple - languages.

    -

    36.7.8.1 C Datatypes to Ruby Objects

    -
    - - - - - - - - -
    RUBYSWIG
    INT2NUM(long or int)SWIG_From_int(int x) int - to Fixnum or Bignum
    INT2FIX(long or int) int to Fixnum (faster - than INT2NUM)
    CHR2FIX(char)SWIG_From_char(char x) char to - Fixnum
    rb_str_new2(char*)SWIG_FromCharPtrAndSize(char*, - size_t) char* to String
    rb_float_new(double)SWIG_From_double(double), -
    SWIG_From_float(float)
    float/double to Float
    +

    Let's say you SWIG this code and then run IRB:

    +
    +
    $ irb
    +irb(main):001:0> require 'example'
    +=> true
    +
    +irb(main):002:0> tiger1 = Example::Animal.new("tiger1")
    +=> #<Example::Animal:0x2be3820>
    +
    +irb(main):004:0> tiger1.get_name()
    +=> "tiger1"
    +
    +irb(main):003:0> zoo = Example::Zoo.new()
    +=> #<Example::Zoo:0x2be0a60>
    +
    +irb(main):006:0> zoo.add_animal(tiger)
    +=> nil
    +
    +irb(main):007:0> zoo.get_num_animals()
    +=> 1
    +
    +irb(main):007:0> tiger2 = zoo.remove_animal(0)
    +=> #<Example::Animal:0x2bd4a18>
    +
    +irb(main):008:0> tiger2.get_name()
    +=> "tiger1"
    +
    +irb(main):009:0> tiger1.equal?(tiger2)
    +=> false
    +
    -

    36.7.8.2 Ruby Objects to C Datatypes

    -

    Here, while the Ruby versions return the value directly, the SWIG - versions do not, but return a status value to indicate success ( -SWIG_OK). While more akward to use, this allows you to write - typemaps that report more helpful error messages, like:

    -
    -
    -%typemap(in) size_t (int ok)
    -  ok = SWIG_AsVal_size_t($input, &$1);
    -  if (!SWIG_IsOK(ok)) {
    -    SWIG_exception_fail(SWIG_ArgError(ok), Ruby_Format_TypeError( "$1_name", "$1_type","$symname", $argnum, $input));
    -  }
    -}
    +

    Pay particular attention to the code tiger1.equal?(tiger2). + Note that the two Ruby objects are not the same - but they reference + the same underlying C++ object. This can cause problems. For example:

    +
    +
    irb(main):010:0> tiger1 = nil
    +=> nil
    +
    +irb(main):011:0> GC.start
    +=> nil
    +
    +irb(main):012:0> tiger2.get_name()
    +(irb):12: [BUG] Segmentation fault
     
    -
    - - - - - - - - - - - - - - - -
    int NUM2INT(Numeric)SWIG_AsVal_int(VALUE, int*)
    int FIX2INT(Numeric)SWIG_AsVal_int(VALUE, int*)
    unsigned int NUM2UINT(Numeric) -SWIG_AsVal_unsigned_SS_int(VALUE, int*)
    unsigned int FIX2UINT(Numeric) -SWIG_AsVal_unsigned_SS_int(VALUE, int*)
    long NUM2LONG(Numeric)SWIG_AsVal_long(VALUE, long*)
    long FIX2LONG(Numeric)SWIG_AsVal_long(VALUE, long*)
    unsigned long FIX2ULONG(Numeric) -SWIG_AsVal_unsigned_SS_long(VALUE, unsigned long*)
    char NUM2CHR(Numeric or String)SWIG_AsVal_char(VALUE, - int*)
    char * StringValuePtr(String) -SWIG_AsCharPtrAndSize(VALUE, char*, size_t, int* alloc)
    char * rb_str2cstr(String, int*length)
    double NUM2DBL(Numeric)(double) SWIG_AsVal_int(VALUE) - or similar
    -

    36.7.8.3 Macros for VALUE

    -

    RSTRING_LEN(str)

    -
    length of the Ruby string
    -

    RSTRING_PTR(str)

    -
    pointer to string storage
    -

    RARRAY_LEN(arr)

    -
    length of the Ruby array
    -

    RARRAY(arr)->capa

    -
    capacity of the Ruby array
    -

    RARRAY_PTR(arr)

    -
    pointer to array storage
    -

    36.7.8.4 Exceptions

    -

    void rb_raise(VALUE exception, const char *fmt, ...)

    -
    Raises an exception. The given format string fmt - and remaining arguments are interpreted as with printf().
    -

    void rb_fatal(const char *fmt, ...)

    -
    Raises a fatal exception, terminating the process. - No rescue blocks are called, but ensure blocks will be called. The - given format string fmt and remaining arguments are interpreted - as with printf().
    -

    void rb_bug(const char *fmt, ...)

    -
    Terminates the process immediately -- no handlers - of any sort will be called. The given format string fmt and - remaining arguments are interpreted as with printf(). You - should call this function only if a fatal bug has been exposed.
    -

    void rb_sys_fail(const char *msg)

    -
    Raises a platform-specific exception corresponding - to the last known system error, with the given string msg.
    -

    VALUE rb_rescue(VALUE (*body)(VALUE), VALUE args, - VALUE(*rescue)(VALUE, VALUE), VALUE rargs)

    -
    Executes body with the given args. If - a StandardError exception is raised, then execute rescue - with the given rargs.
    -

    VALUE rb_ensure(VALUE(*body)(VALUE), VALUE args, - VALUE(*ensure)(VALUE), VALUE eargs)

    -
    Executes body with the given args. - Whether or not an exception is raised, execute ensure with the - given rargs after body has completed.
    -

    VALUE rb_protect(VALUE (*body)(VALUE), VALUE args, int *result) -

    -
    Executes body with the given args and - returns nonzero in result if any exception was raised.
    -

    void rb_notimplement()

    -
    Raises a NotImpError exception to indicate - that the enclosed function is not implemented yet, or not available on - this platform.
    -

    void rb_exit(int status)

    -
    Exits Ruby with the given status. Raises a -SystemExit exception and calls registered exit functions and - finalizers.
    -

    void rb_warn(const char *fmt, ...)

    -
    Unconditionally issues a warning message to - standard error. The given format string fmt and remaining - arguments are interpreted as with printf().
    -

    void rb_warning(const char *fmt, ...)

    -
    Conditionally issues a warning message to standard - error if Ruby was invoked with the -w flag. The given format - string fmt and remaining arguments are interpreted as with -printf().
    -

    36.7.8.5 Iterators

    -

    void rb_iter_break()

    -
    Breaks out of the enclosing iterator block.
    -

    VALUE rb_each(VALUE obj)

    -
    Invokes the each method of the given - obj.
    -

    VALUE rb_yield(VALUE arg)

    -
    Transfers execution to the iterator block in the - current context, passing arg as an argument. Multiple values may - be passed in an array.
    -

    int rb_block_given_p()

    -
    Returns true if yield would - execute a block in the current context; that is, if a code block was - passed to the current method and is available to be called.
    -

    VALUE rb_iterate(VALUE (*method)(VALUE), VALUE args, VALUE - (*block)(VALUE, VALUE), VALUE arg2)

    -
    Invokes method with argument args and - block block. A yield from that method will invoke - block with the argument given to yield, and a second - argument arg2.
    -

    VALUE rb_catch(const char *tag, VALUE (*proc)(VALUE, VALUE), - VALUE value)

    -
    Equivalent to Ruby's catch.
    -

    void rb_throw(const char *tag, VALUE value)

    -
    Equivalent to Ruby's throw.
    -

    36.7.9 Typemap Examples

    -

    This section includes a few examples of typemaps. For more examples, - you might look at the examples in the Example/ruby directory.

    -

    36.7.10 Converting a Ruby array to a char **

    -

    A common problem in many C programs is the processing of command - line arguments, which are usually passed in an array of NULL - terminated strings. The following SWIG interface file allows a Ruby - Array instance to be used as a char ** object.

    +

    After the garbage collector runs, as a result of our call to +GC.start, callingtiger2.get_name() causes a segmentation + fault. The problem is that when tiger1 is garbage collected, + it frees the underlying C++ object. Thus, when tiger2 calls + the get_name() method it invokes it on a destroyed object.

    +

    This problem can be avoided if SWIG enforces a one-to-one mapping + between Ruby objects and C++ classes. This can be done via the use of + the %trackobjects functionality available in SWIG-1.3.26. and + later.

    +

    When the %trackobjects is turned on, SWIG automatically + keeps track of mappings between C++ objects and Ruby objects. Note that + enabling object tracking causes a slight performance degradation. Test + results show this degradation to be about 3% to 5% when creating and + destroying 100,000 animals in a row.

    +

    Since %trackobjects is implemented as a %feature, + it uses the same name matching rules as other kinds of features (see + the chapter on "Customization Features") + . Thus it can be applied on a class-by-class basis if needed. To fix + the example above:

    -
    %module argv
    -
    -// This tells SWIG to treat char ** as a special case
    -%typemap(in) char ** {
    -  /* Get the length of the array */
    -  int size = RARRAY($input)->len; 
    -  int i;
    -  $1 = (char **) malloc((size+1)*sizeof(char *));
    -  /* Get the first element in memory */
    -  VALUE *ptr = RARRAY($input)->ptr; 
    -  for (i=0; i < size; i++, ptr++) {
    -    /* Convert Ruby Object String to char* */
    -    $1[i]= StringValuePtr(*ptr); 
    -  }
    -  $1[i]=NULL; /* End of list */
    -}
    +
    %module example
     
    -// This cleans up the char ** array created before 
    -// the function call
    +%{
    +#include "example.h"
    +%}
     
    -%typemap(freearg) char ** {
    -  free((char *) $1);
    -}
    +/* Tell SWIG that create_animal creates a new object */
    +%newobject Zoo::create_animal;
     
    -// Now a test function
    -%inline %{
    -int print_args(char **argv) {
    -  int i = 0;
    -  while (argv[i]) {
    -    printf("argv[%d] = %s\n", i,argv[i]);
    -    i++;
    -  }
    -  return i;
    -}
    -%}
    +/* Tell SWIG to keep track of mappings between C/C++ structs/classes. */ +%trackobjects; + +%include "example.h"
    -

    When this module is compiled, the wrapped C function now operates as - follows :

    +

    When this code runs we see:

    -
    require 'Argv'
    -Argv.print_args(["Dave","Mike","Mary","Jane","John"])
    -argv[0] = Dave
    -argv[1] = Mike
    -argv[2] = Mary
    -argv[3] = Jane
    -argv[4] = John
    +
    $ irb
    +irb(main):001:0> require 'example'
    +=> true
    +
    +irb(main):002:0> tiger1 = Example::Animal.new("tiger1")
    +=> #<Example::Animal:0x2be37d8>
    +
    +irb(main):003:0> zoo = Example::Zoo.new()
    +=> #<Example::Zoo:0x2be0a18>
    +
    +irb(main):004:0> zoo.add_animal(tiger1)
    +=> nil
    +
    +irb(main):006:0> tiger2 = zoo.remove_animal(0)
    +=> #<Example::Animal:0x2be37d8>
    +
    +irb(main):007:0> tiger1.equal?(tiger2)
    +=> true
    +
    +irb(main):008:0> tiger1 = nil
    +=> nil
    +
    +irb(main):009:0> GC.start
    +=> nil
    +
    +irb(main):010:0> tiger.get_name()
    +=> "tiger1"
    +irb(main):011:0>
    -

    In the example, two different typemaps are used. The "in" typemap is - used to receive an input argument and convert it to a C array. Since - dynamic memory allocation is used to allocate memory for the array, the - "freearg" typemap is used to later release this memory after the - execution of the C function.

    -

    36.7.11 Collecting arguments in a hash

    -

    Ruby's solution to the "keyword arguments" capability of some other - languages is to allow the programmer to pass in one or more key-value - pairs as arguments to a function. All of those key-value pairs are - collected in a single Hash argument that's presented to the - function. If it makes sense, you might want to provide similar - functionality for your Ruby interface. For example, suppose you'd like - to wrap this C function that collects information about people's vital - statistics:

    +

    For those who are interested, object tracking is implemented by + storing Ruby objects in a hash table and keying them on C++ pointers. + The underlying API is:

    -
    void setVitalStats(const char *person, int nattributes, const char **names, int *values);
    +
    static void SWIG_RubyAddTracking(void* ptr, VALUE object);
    +static VALUE SWIG_RubyInstanceFor(void* ptr) ;
    +static void SWIG_RubyRemoveTracking(void* ptr);
    +static void SWIG_RubyUnlinkObjects(void* ptr);
    -

    and you'd like to be able to call it from Ruby by passing in an - arbitrary number of key-value pairs as inputs, e.g.

    -
    -
    setVitalStats("Fred", 
    -  'weight' => 270, 
    -  'age' => 42 
    -)
    +

    When an object is created, SWIG will automatically call the +SWIG_RubyAddTracking method. Similarly, when an object is deleted, + SWIG will call the SWIG_RubyRemoveTracking. When an object is + returned to Ruby from C++, SWIG will use the SWIG_RubyInstanceFor + method to ensure a one-to-one mapping from Ruby to C++ objects. Last, + the RubyUnlinkObjects method unlinks a Ruby object from its + underlying C++ object.

    +

    In general, you will only need to use the SWIG_RubyInstanceFor +, which is required for implementing mark functions as shown below. + However, if you implement your own free functions (see below) you may + also have to call the SWIG_RubyRemoveTracking and +RubyUnlinkObjects methods.

    +

    38.10.4 Mark Functions

    +

    With a bit more testing, we see that our class library still has + problems. For example:

    +
    +
    $ irb
    +irb(main):001:0> require 'example'
    +=> true
    +
    +irb(main):002:0> tiger1 = Example::Animal.new("tiger1")
    +=> #<Example::Animal:0x2bea6a8>
    +
    +irb(main):003:0> zoo = Example::Zoo.new()
    +=> #<Example::Zoo:0x2be7960>
    +
    +irb(main):004:0> zoo.add_animal(tiger1)
    +=> nil
    +
    +irb(main):007:0> tiger1 = nil
    +=> nil
    +
    +irb(main):007:0> GC.start
    +=> nil
    +
    +irb(main):005:0> tiger2 = zoo.get_animal(0)
    +(irb):12: [BUG] Segmentation fault
    -

    To make this work, you need to write a typemap that expects a Ruby -Hash as its input and somehow extracts the last three arguments ( -nattributes, names and values) needed by your C - function. Let's start with the basics:

    +

    The problem is that Ruby does not know that the zoo object + contains a reference to a Ruby object. Thus, when Ruby garbage collects + tiger1 it frees the underlying C++ object.

    +

    This can be fixed by implementing a mark function as + described above in the Mark and Sweep Garbage + Collector section. You can specify a mark function by using the +%markfunc directive. Since the %markfunc directive is + implemented using SWIG's' "features" mechanism it uses the same name + matching rules as other kinds of features (see the chapter on +"Customization Features" for more details).

    +

    A mark function takes a single argument, which is a pointer + to the C++ object being marked; it should, in turn, call +rb_gc_mark() for any instances that are reachable from the current + object. The mark function for our Zoo class should therefore + loop over all of the C++ animal objects in the zoo object, look up + their Ruby object equivalent, and then call rb_gc_mark(). One + possible implementation is:

    -
    %typemap(in) (int nattributes, const char **names, const int *values)
    -  (VALUE keys_arr, int i, VALUE key, VALUE val) {
    +
    %module example
    +
    +%{
    +#include "example.h"
    +%}
    +
    +/* Keep track of mappings between C/C++ structs/classes
    + and Ruby objects so we can implement a mark function. */
    +%trackobjects;
    +
    +/* Specify the mark function */
    +%markfunc Zoo "mark_Zoo";
    +
    +%include "example.h"
    +
    +%header %{
    +
    +static void mark_Zoo(void* ptr) {
    +  Zoo* zoo = (Zoo*) ptr;
    + 
    +  /* Loop over each object and tell the garbage collector
    +  that we are holding a reference to them. */
    +  int count = zoo->get_num_animals();
    + 
    +  for(int i = 0; i < count; ++i) {
    +    Animal* animal = zoo->get_animal(i);
    +    VALUE object = SWIG_RubyInstanceFor(animal);
    + 
    +    if (object != Qnil) {
    +      rb_gc_mark(object);
    +    }
    +  }
     }
    - 
    +%}
    -

    This %typemap directive tells SWIG that we want to match - any function declaration that has the specified types and names of - arguments somewhere in the argument list. The fact that we specified - the argument names (nattributes, names and values) - in our typemap is significant; this ensures that SWIG won't try to - apply this typemap to other functions it sees that happen to - have a similar declaration with different argument names. The arguments - that appear in the second set of parentheses (keys_arr, i -, key and val) define local variables that our typemap - will need.

    -

    Since we expect the input argument to be a Hash, let's next - add a check for that:

    -
    -
    %typemap(in) (int nattributes, const char **names, const int *values)
    -  (VALUE keys_arr, int i, VALUE key, VALUE val) {
    -    Check_Type($input, T_HASH);
    -}
    +

    Note the mark function is dependent on the +SWIG_RUBY_InstanceFor method, and thus requires that +%trackobjects is enabled. For more information, please refer to the + ruby_track_objects.i test case in the SWIG test suite.

    +

    When this code is compiled we now see:

    +
    +
    $ irb
    +irb(main):002:0> tiger1=Example::Animal.new("tiger1")
    +=> #<Example::Animal:0x2be3bf8>
    +
    +irb(main):003:0> Example::Zoo.new()
    +=> #<Example::Zoo:0x2be1780>
    +
    +irb(main):004:0> zoo = Example::Zoo.new()
    +=> #<Example::Zoo:0x2bde9c0>
    +
    +irb(main):005:0> zoo.add_animal(tiger1)
    +=> nil
    +
    +irb(main):009:0> tiger1 = nil
    +=> nil
    +
    +irb(main):010:0> GC.start
    +=> nil
    +irb(main):014:0> tiger2 = zoo.get_animal(0)
    +=> #<Example::Animal:0x2be3bf8>
    +
    +irb(main):015:0> tiger2.get_name()
    +=> "tiger1"
    +irb(main):016:0>
    -

    Check_Type() is just a macro (defined in the Ruby header - files) that confirms that the input argument is of the correct type; if - it isn't, an exception will be raised.

    -

    The next task is to determine how many key-value pairs are present in - the hash; we'll assign this number to the first typemap argument ( -$1). This is a little tricky since the Ruby/C API doesn't provide a - public function for querying the size of a hash, but we can get around - that by calling the hash's size method directly and converting - its result to a C int value:

    +

    This code can be seen in swig/examples/ruby/mark_function.

    +

    38.10.5 Free Functions

    +

    By default, SWIG creates a "free" function that is called when a Ruby + object is garbage collected. The free function simply calls the C++ + object's destructor.

    +

    However, sometimes an appropriate destructor does not exist or + special processing needs to be performed before the destructor is + called. Therefore, SWIG allows you to manually specify a "free" + function via the use of the %freefunc directive. The +%freefunc directive is implemented using SWIG's' "features" + mechanism and so the same name matching rules used for other kinds of + features apply (see the chapter on +"Customization Features") for more details).

    +

    IMPORTANT ! - If you define your own free function, then you must + ensure that you call the underlying C++ object's destructor. In + addition, if object tracking is activated for the object's class, you + must also call the SWIG_RubyRemoveTracking function (of course + call this before you destroy the C++ object). Note that it is harmless + to call this method if object tracking if off so it is advised to + always call it.

    +

    Note there is a subtle interaction between object ownership and free + functions. A custom defined free function will only be called if the + Ruby object owns the underlying C++ object. This also to Ruby objects + which are created, but then transfer ownership to C++ objects via the + use of the disown typemap described above.

    +

    To show how to use the %freefunc directive, let's slightly + change our example. Assume that the zoo object is responsible for + freeing any animal that it contains. This means that the +Zoo::add_animal function should be marked with a DISOWN + typemap and the destructor should be updated as below:

    -
    %typemap(in) (int nattributes, const char **names, const int *values)
    -  (VALUE keys_arr, int i, VALUE key, VALUE val) {
    -    Check_Type($input, T_HASH);
    -    $1 = NUM2INT(rb_funcall($input, rb_intern("size"), 0, NULL));
    -}
    +
    +Zoo::~Zoo() {
    +  IterType iter = this->animals.begin();
    +  IterType end = this->animals.end();
    + 
    +  for(iter; iter != end; ++iter) {
    +    Animal* animal = *iter;
    +    delete animal;
    +  }
    +}
    +
    -

    So now we know the number of attributes. Next we need to initialize - the second and third typemap arguments (i.e. the two C arrays) to -NULL and set the stage for extracting the keys and values from the - hash:

    -
    -
    %typemap(in) (int nattributes, const char **names, const int *values)
    -  (VALUE keys_arr, int i, VALUE key, VALUE val) {
    -    Check_Type($input, T_HASH);
    -    $1 = NUM2INT(rb_funcall($input, rb_intern("size"), 0, NULL));
    -    $2 = NULL;
    -    $3 = NULL;
    -    if ($1 > 0) {
    -      $2 = (char **) malloc($1*sizeof(char *));
    -      $3 = (int *) malloc($1*sizeof(int));
    -    }
    -}
    +

    When we use these objects in IRB we see:

    +
    +
    $irb
    +irb(main):002:0> require 'example'
    +=> true
    +
    +irb(main):003:0> zoo = Example::Zoo.new()
    +=> #<Example::Zoo:0x2be0fe8>
    +
    +irb(main):005:0> tiger1 = Example::Animal.new("tiger1")
    +=> #<Example::Animal:0x2bda760>
    +
    +irb(main):006:0> zoo.add_animal(tiger1)
    +=> nil
    +
    +irb(main):007:0> zoo = nil
    +=> nil
    +
    +irb(main):008:0> GC.start
    +=> nil
    +
    +irb(main):009:0> tiger1.get_name()
    +(irb):12: [BUG] Segmentation fault
    +
    -

    There are a number of ways we could extract the keys and values from - the input hash, but the simplest approach is to first call the hash's - keys method (which returns a Ruby array of the keys) and then start - looping over the elements in that array:

    +

    The error happens because the C++ animal object is freed + when the zoo object is freed. Although this error is + unavoidable, we can at least prevent the segmentation fault. To do this + requires enabling object tracking and implementing a custom free + function that calls the SWIG_RubyUnlinkObjects function for + each animal object that is destroyed. The SWIG_RubyUnlinkObjects + function notifies SWIG that a Ruby object's underlying C++ object is no + longer valid. Once notified, SWIG will intercept any calls from the + existing Ruby object to the destroyed C++ object and raise an + exception.

    -
    %typemap(in) (int nattributes, const char **names, const int *values)
    -  (VALUE keys_arr, int i, VALUE key, VALUE val) {
    -    Check_Type($input, T_HASH);
    -    $1 = NUM2INT(rb_funcall($input, rb_intern("size"), 0, NULL));
    -    $2 = NULL;
    -    $3 = NULL;
    -    if ($1 > 0) {
    -      $2 = (char **) malloc($1*sizeof(char *));
    -      $3 = (int *) malloc($1*sizeof(int));
    -      keys_arr = rb_funcall($input, rb_intern("keys"), 0, NULL);
    -      for (i = 0; i < $1; i++) {
    -      }
    +
    %module example
    +
    +%{
    +#include "example.h"
    +%}
    +
    +/* Specify that ownership is transferred to the zoo when calling add_animal */
    +%apply SWIGTYPE *DISOWN { Animal* animal };
    +
    +/* Track objects */
    +%trackobjects;
    +
    +/* Specify the mark function */
    +%freefunc Zoo "free_Zoo";
    +
    +%include "example.h"
    +
    +%header %{
    +  static void free_Zoo(void* ptr) {
    +    Zoo* zoo = (Zoo*) ptr;
    +
    +    /* Loop over each animal */
    +    int count = zoo->get_num_animals();
    +
    +    for(int i = 0; i < count; ++i) {
    +      /* Get an animal */
    +      Animal* animal = zoo->get_animal(i);
    +
    +      /* Unlink the Ruby object from the C++ object */
    +      SWIG_RubyUnlinkObjects(animal);
    +
    +      /* Now remove the tracking for this animal */
    +      SWIG_RubyRemoveTracking(animal);
         }
    -}
    + + /* Now call SWIG_RubyRemoveTracking for the zoo */ + SWIG_RubyRemoveTracking(ptr); + /* Now free the zoo which will free the animals it contains */ + delete zoo; + } +%}
    -

    Recall that keys_arr and i are local variables for - this typemap. For each element in the keys_arr array, we want to - get the key itself, as well as the value corresponding to that key in - the hash:

    +

    Now when we use these objects in IRB we see:

    +
    +
    $irb
    +irb(main):002:0> require 'example'
    +=> true
    +
    +irb(main):003:0> zoo = Example::Zoo.new()
    +=> #<Example::Zoo:0x2be0fe8>
    +
    +irb(main):005:0> tiger1 = Example::Animal.new("tiger1")
    +=> #<Example::Animal:0x2bda760>
    +
    +irb(main):006:0> zoo.add_animal(tiger1)
    +=> nil
    +
    +irb(main):007:0> zoo = nil
    +=> nil
    +
    +irb(main):008:0> GC.start
    +=> nil
    +
    +irb(main):009:0> tiger1.get_name()
    +RuntimeError: This Animal * already released
    + from (irb):10:in `get_name'
    + from (irb):10
    +irb(main):011:0>
    +
    +

    Notice that SWIG can now detect the underlying C++ object has been + freed, and thus raises a runtime exception.

    +

    This code can be seen in swig/examples/ruby/free_function.

    +

    38.10.6 Embedded Ruby and the C++ Stack

    +

    As has been said, the Ruby GC runs and marks objects before its sweep + phase. When the garbage collector is called, it will also try to mark + any Ruby objects (VALUE) it finds in the machine registers and in the + C++ stack.

    +

    The stack is basically the history of the functions that have been + called and also contains local variables, such as the ones you define + whenever you do inside a function:

    +
    VALUE obj;
    +

    For ruby to determine where its stack space begins, during + initialization a normal Ruby interpreter will call the ruby_init() + function which in turn will call a function called Init_stack or + similar. This function will store a pointer to the location where the + stack points at that point in time.

    +

    ruby_init() is presumed to always be called within the main() + function of your program and whenever the GC is called, ruby will + assume that the memory between the current location in memory and the + pointer that was stored previously represents the stack, which may + contain local (and temporary) VALUE ruby objects. Ruby will then be + careful not to remove any of those objects in that location.

    +

    So far so good. For a normal Ruby session, all the above is + completely transparent and magic to the extensions developer.

    +

    However, with an embedded Ruby, it may not always be possible to + modify main() to make sure ruby_init() is called there. As such, + ruby_init() will likely end up being called from within some other + function. This can lead Ruby to measure incorrectly where the stack + begins and can result in Ruby incorrectly collecting those temporary + VALUE objects that are created once another function is called. The end + result: random crashes and segmentation faults.

    +

    This problem will often be seen in director functions that are used + for callbacks, for example.

    +

    To solve the problem, SWIG can now generate code with director + functions containing the optional macros SWIG_INIT_STACK and + SWIG_RELEASE_STACK. These macros will try to force Ruby to reinitialize + the beginning of the stack the first time a director function is + called. This will lead Ruby to measure and not collect any VALUE + objects defined from that point on.

    +

    To mark functions to either reset the ruby stack or not, you can use:

    -
    %typemap(in) (int nattributes, const char **names, const int *values)
    -  (VALUE keys_arr, int i, VALUE key, VALUE val) {
    -    Check_Type($input, T_HASH);
    -    $1 = NUM2INT(rb_funcall($input, rb_intern("size"), 0, NULL));
    -    $2 = NULL;
    -    $3 = NULL;
    -    if ($1 > 0) {
    -      $2 = (char **) malloc($1*sizeof(char *));
    -      $3 = (int *) malloc($1*sizeof(int));
    -      keys_arr = rb_funcall($input, rb_intern("keys"), 0, NULL);
    -      for (i = 0; i < $1; i++) {
    -        key = rb_ary_entry(keys_arr, i);
    -        val = rb_hash_aref($input, key);
    -      }
    -    }
    -}
    +
    +%initstack Class::memberfunction;   // only re-init the stack in this director method
    +%ignorestack Class::memberfunction; // do not re-init the stack in this director method
    +%initstack Class;                   // init the stack on all the methods of this class
    +%initstack;                         // all director functions will re-init the stack
    +
    +

    +

    39 SWIG and Scilab

    + + + -

    To be safe, we should again use the Check_Type() macro to - confirm that the key is a String and the value is a Fixnum -:

    + +

    Scilab is a scientific software package for numerical computations + providing a powerful open computing environment for engineering and + scientific applications that is mostly compatible with MATLAB. More + information can be found at +www.scilab.org.

    +

    This chapter explains how to use SWIG for Scilab. After this + introduction, you should be able to generate with SWIG a Scilab + external module from a C/C++ library.

    +

    39.1 Preliminaries

    +

    SWIG for Scilab supports Linux. Other operating sytems haven't been + tested.

    +

    Scilab is supported from version 5.3.3 onwards. The forthcoming + version 6, as of January 2015, is also supported.

    +

    SWIG for Scilab supports C language. C++ is partially supported. See + A basic tour of C/C++ wrapping for + further details.

    +

    39.2 Running SWIG

    +

    Let's see how to use SWIG for Scilab on a small example. +
    In this example we bind from C a function and a global variable + into Scilab. The SWIG interface (stored in a file named example.i +), is the following:

    -
    %typemap(in) (int nattributes, const char **names, const int *values)
    -  (VALUE keys_arr, int i, VALUE key, VALUE val) {
    -    Check_Type($input, T_HASH);
    -    $1 = NUM2INT(rb_funcall($input, rb_intern("size"), 0, NULL));
    -    $2 = NULL;
    -    $3 = NULL;
    -    if ($1 > 0) {
    -      $2 = (char **) malloc($1*sizeof(char *));
    -      $3 = (int *) malloc($1*sizeof(int));
    -      keys_arr = rb_funcall($input, rb_intern("keys"), 0, NULL);
    -      for (i = 0; i < $1; i++) {
    -        key = rb_ary_entry(keys_arr, i);
    -        val = rb_hash_aref($input, key);
    -        Check_Type(key, T_STRING);
    -        Check_Type(val, T_FIXNUM);
    -      }
    +
    +%module example
    +
    +%inline %{
    +double Foo = 3.0;
    +
    +int fact(int n) {
    +    if (n < 0) {
    +        return 0;
         }
    -}
    -
    -

    Finally, we can convert these Ruby objects into their C equivalents - and store them in our local C arrays:

    -
    -
    %typemap(in) (int nattributes, const char **names, const int *values)
    -  (VALUE keys_arr, int i, VALUE key, VALUE val) {
    -  Check_Type($input, T_HASH);
    -  $1 = NUM2INT(rb_funcall($input, rb_intern("size"), 0, NULL));
    -  $2 = NULL;
    -  $3 = NULL;
    -  if ($1 > 0) {
    -    $2 = (char **) malloc($1*sizeof(char *));
    -    $3 = (int *) malloc($1*sizeof(int));
    -    keys_arr = rb_funcall($input, rb_intern("keys"), 0, NULL);
    -    for (i = 0; i < $1; i++) {
    -      key = rb_ary_entry(keys_arr, i);
    -      val = rb_hash_aref($input, key);
    -      Check_Type(key, T_STRING);
    -      Check_Type(val, T_FIXNUM);
    -      $2[i] = StringValuePtr(key);
    -      $3[i] = NUM2INT(val);
    +    else if (n == 0) {
    +        return 1;
         }
    -  }
    -}
    + else { + return n * fact(n-1); + } +} +%} +
    -

    We're not done yet. Since we used malloc() to dynamically - allocate the memory used for the names and values - arguments, we need to provide a corresponding "freearg" typemap to free - that memory so that there is no memory leak. Fortunately, this typemap - is a lot easier to write:

    -
    -
    %typemap(freearg) (int nattributes, const char **names, const int *values) {
    -  free((void *) $2);
    -  free((void *) $3);
    -}
    +

    Note: a code in an %inline section is both parsed and + wrapped by SWIG, and inserted as is in the wrapper source file.

    +

    39.2.1 Generating + the module

    +

    The module is generated using the swig executable and its +-scilab option.

    +
    +
    +$ swig -scilab example.i
    +
    -

    All of the code for this example, as well as a sample Ruby program - that uses the extension, can be found in the Examples/ruby/hashargs - directory of the SWIG distribution.

    -

    36.7.12 Pointer handling

    -

    Occasionally, it might be necessary to convert pointer values that - have been stored using the SWIG typed-pointer representation. Since - there are several ways in which pointers can be represented, the - following two functions are used to safely perform this conversion:

    -

    int SWIG_ConvertPtr(VALUE obj, void **ptr, swig_type_info *ty, - int flags)

    -
    Converts a Ruby object obj to a C pointer - whose address is ptr (i.e. ptr is a pointer to a - pointer). The third argument, ty, is a pointer to a SWIG type - descriptor structure. If ty is not NULL, that type - information is used to validate type compatibility and other aspects of - the type conversion. If flags is non-zero, any type errors - encountered during this validation result in a Ruby TypeError - exception being raised; if flags is zero, such type errors will - cause SWIG_ConvertPtr() to return -1 but not raise an - exception. If ty is NULL, no type-checking is - performed.
    -

    VALUE SWIG_NewPointerObj(void *ptr, swig_type_info *ty, int own) -

    -
    Creates a new Ruby pointer object. Here, ptr - is the pointer to convert, ty is the SWIG type descriptor - structure that describes the type, and own is a flag that - indicates whether or not Ruby should take ownership of the pointer - (i.e. whether Ruby should free this data when the corresponding Ruby - instance is garbage-collected).
    -

    Both of these functions require the use of a special SWIG - type-descriptor structure. This structure contains information about - the mangled name of the datatype, type-equivalence information, as well - as information about converting pointer values under C++ inheritance. - For a type of Foo *, the type descriptor structure is usually - accessed as follows:

    -
    -
    Foo *foo;
    -SWIG_ConvertPtr($input, (void **) &foo, SWIGTYPE_p_Foo, 1);
    -
    -VALUE obj;
    -obj = SWIG_NewPointerObj(f, SWIGTYPE_p_Foo, 0);
    +

    This command generates two files:

    +
      +
    • example_wrap.c: a C source file containing the wrapping + code and also here the wrapped code (the fact() and Foo + definitions)
    • +
    • loader.sce: a Scilab script used to load the module into + Scilab
    • +
    +

    Note: if the following error is returned:

    +
    +
    +:1: Error: Unable to find 'swig.swg'
    +:3: Error: Unable to find 'scilab.swg'
    +
    +
    +

    it may be because the SWIG library is not found. Check the +SWIG_LIB environment variable or your SWIG installation.

    +

    Note: SWIG for Scilab can work in two modes related to the way the + module is built, see the Building + modes section for details. This example uses the builder + mode.

    +

    The swig executable has several other command line options + you can use. See Scilab command + line options for further details.

    +

    39.2.2 Building the + module

    +

    To be loaded in Scilab, the wrapper has to be built into a dynamic + module (or shared library).

    +

    The commands to compile and link the wrapper (with gcc) + into the shared library libexample.so are:

    +
    +
    +$ gcc -fPIC -c -I/usr/local/include/scilab example_wrap.c
    +$ gcc -shared example_wrap.o -o libexample.so
    +
    -

    In a typemap, the type descriptor should always be accessed using - the special typemap variable $1_descriptor. For example:

    -
    -
    %typemap(in) Foo * {
    -  SWIG_ConvertPtr($input, (void **) &$1, $1_descriptor, 1);
    -}
    +

    Note: we supposed in this example that the path to the Scilab + include directory is /usr/local/include/scilab (which is the + case in a Debian environment), this should be changed for another + environment.

    +

    39.2.3 Loading the + module

    +

    Loading a module is done by running the loader script in Scilab:

    +
    +
    +--> exec loader.sce
    +
    -

    36.7.12.1 Ruby Datatype Wrapping

    -

    VALUE Data_Wrap_Struct(VALUE class, void (*mark)(void *), void - (*free)(void *), void *ptr)

    -
    Given a pointer ptr to some C data, and the - two garbage collection routines for this data (mark and free -), return a VALUE for the Ruby object.
    -

    VALUE Data_Make_Struct(VALUE class, c-type, void - (*mark)(void *), void (*free)(void *), c-type *ptr)

    -
    Allocates a new instance of a C data type c-type -, assigns it to the pointer ptr, then wraps that pointer with -Data_Wrap_Struct() as above.
    -

    Data_Get_Struct(VALUE obj, c-type, c-type *ptr) -

    -
    Retrieves the original C pointer of type c-type - from the data object obj and assigns that pointer to ptr.
    -

    36.7.13 Example: STL Vector to Ruby Array

    -

    Another use for macros and type maps is to create a Ruby array from a - STL vector of pointers. In essence, copy of all the pointers in the - vector into a Ruby array. The use of the macro is to make the typemap - so generic that any vector with pointers can use the type map. The - following is an example of how to construct this type of macro/typemap - and should give insight into constructing similar typemaps for other - STL structures:

    +

    Scilab should output the following messages:

    +
    +
    +Shared archive loaded.
    +Link done.
    +
    +
    +

    which means that Scilab has successfully loaded the shared library. + The module functions and other symbols are now available in Scilab.

    +

    39.2.4 Using the module +

    +

    In Scilab, the function fact() is simply called as + following:

    +
    +
    +--> fact(5)
    +ans  =
    +
    +    120.
    +
    +
    +

    For the Foo global variable, the accessors need to be used:

    +
    +--> Foo_get
    +ans  =
    +
    +    3.
    +
    +--> Foo_set(4);
    +
    +--> Foo_get
    +ans  =
    +
    +    4.
    +
    +

    +

    Note: for conciseness, we assume in the subsequent Scilab code + examples that the modules have been beforehand built and loaded in + Scilab.

    +

    39.2.5 Scilab command line + options

    +

    The following table lists the Scilab specific command line options + in addition to the generic SWIG options:

    + + + + + + + + + +
    -builderGenerate the Scilab builder script
    -buildercflags <cflags>Add <cflags> to the + builder compiler flags
    -builderldflags <ldflags>Add <ldlags> to the + builder linker flags
    -buildersources <files>Add the (comma + separated) files <files> to the builder sources
    -builderverbositylevel <level>Set the build + verbosity level to <level> (default 0: off, 2: high)
    -builderflagscript <file>Use the Scilab script + <file> to configure the compiler and linker flags
    -gatewayxml <gateway_id>Generate the gateway + XML with the given <gateway_id>
    +

    These options can be displayed with:

    +
    +
    +$ swig -scilab -help
    +
    +
    +

    39.3 A basic tour of C/C++ wrapping

    +

    39.3.1 Overview

    +

    SWIG for Scilab provides only a low-level C interface for Scilab + (see Scripting Languages for the general + approach to wrapping). This means that functions, structs, classes, + variables, etc... are interfaced through C functions. These C functions + are mapped as Scilab functions. There are a few exceptions, such as + constants and enumerations, which can be wrapped directly as Scilab + variables.

    +

    39.3.2 Identifiers

    +

    In Scilab 5.x, identifier names are composed of 24 characters + maximum (this limitation should disappear from Scilab 6.0 onwards). +
    Thus long function or variable names may be truncated and this can + cause ambiguities.

    +

    This happens especially when wrapping structs/classes, for which the + wrapped function name is composed of the struct/class name and field + names. In these cases, the %rename + directive can be used to choose a different Scilab name.

    +

    39.3.3 Functions

    +

    Functions are wrapped as new Scilab built-in functions. For example:

    -
    %define PTR_VECTOR_TO_RUBY_ARRAY(vectorclassname, classname)
    -%typemap(out) vectorclassname &, const vectorclassname & {
    -  VALUE arr = rb_ary_new2($1->size());
    -  vectorclassname::iterator i = $1->begin(), iend = $1->end();
    -  for ( ; i!=iend; i++ )
    -    rb_ary_push(arr, Data_Wrap_Struct(c ## classname.klass, 0, 0, *i));
    -  $result = arr;
    -}
    -%typemap(out) vectorclassname, const vectorclassname {
    -  VALUE arr = rb_ary_new2($1.size());
    -  vectorclassname::iterator i = $1.begin(), iend = $1.end();
    -  for ( ; i!=iend; i++ )
    -    rb_ary_push(arr, Data_Wrap_Struct(c ## classname.klass, 0, 0, *i));
    -  $result = arr;
    +
    +%module example
    +
    +%inline %{
    +int fact(int n) {
    +  if (n > 1)
    +    return n * fact(n - 1);
    +  else
    +    return 1;
     }
    -%enddef
    +%} +
    -

    Note, that the "c ## classname.klass" is used in the - preprocessor step to determine the actual object from the class name.

    -

    To use the macro with a class Foo, the following is used:

    -
    -
    PTR_VECTOR_TO_RUBY_ARRAY(vector<foo *="">, Foo)
    +

    creates a built-in function fact(n) in Scilab:

    +
    +
    +--> fact(4)
    +ans  =
    +
    +    24.
    +
    -

    It is also possible to create a STL vector of Ruby objects:

    +

    39.3.3.1 Argument passing

    +

    In the above example, the function parameter is a primitive type and + is marshalled by value. So this function is wrapped without any + additional customization. Argument values are converted between C types + and Scilab types through type mappings. There are several default type + mappings for primitive and complex types, described later in the +Scilab typemaps section.

    +

    When a parameter is not passed by value, such as a pointer or + reference, SWIG does not know if it is an input, output (or both) + parameter. The INPUT, OUTPUT, INOUT typemaps defined in the +typemaps.i library can be used to specify this.

    +

    Let's see this on two simple functions: sub() which has an + output parameter, and inc(), which as input/output parameter:

    -
    %define RUBY_ARRAY_TO_PTR_VECTOR(vectorclassname, classname)
    -%typemap(in) vectorclassname &, const vectorclassname & {
    -  Check_Type($input, T_ARRAY);
    -  vectorclassname *vec = new vectorclassname;
    -  int len = RARRAY($input)->len;
    -  for (int i=0; i!=len; i++) {
    -    VALUE inst = rb_ary_entry($input, i);
    -    //The following _should_ work but doesn't on HPUX
    -    // Check_Type(inst, T_DATA);
    -    classname *element = NULL;
    -    Data_Get_Struct(inst, classname, element);
    -    vec->push_back(element);
    -  }
    -  $1 = vec;
    -}
    +
    +%module example
     
    -%typemap(freearg) vectorclassname &, const vectorclassname & {
    -  delete $1;
    +%include <typemaps.i>
    +
    +extern void sub(int *INPUT, int *INPUT, int *OUTPUT);
    +extern void inc(int *INOUT, int *INPUT);
    +
    +%{
    +void sub(int *x, int *y, int *result) {
    +  *result = *x - *y;
     }
    -%enddef
    +void inc(int *x, int *delta) { + *x = *x + *delta; +} +%} +
    -

    It is also possible to create a Ruby array from a vector of static - data types:

    +

    In Scilab, parameters are passed by value. The output (and inout) + parameters are returned as the result of the functions:

    +
    +
    +--> sub(5, 3)
    + ans  =
    +
    +    2.
    +
    +--> inc(4, 3)
    + ans  =
    +
    +    7.
    +
    +
    +

    39.3.3.2 Multiple output arguments

    +

    A C function can have several output parameters. They can all be + returned as results of the wrapped function as Scilab supports multiple + return values from a function when using the typemaps.i + library. If the C function itself returns a result, this is returned + first before the parameter outputs.

    +

    The example below shows this for a C function returning 2 values and + a result:

    -
    %define VECTOR_TO_RUBY_ARRAY(vectorclassname, classname)
    -%typemap(out) vectorclassname &, const vectorclassname & {
    -  VALUE arr = rb_ary_new2($1->size()); 
    -  vectorclassname::iterator i = $1->begin(), iend = $1->end();
    -  for ( ; i!=iend; i++ )
    -    rb_ary_push(arr, Data_Wrap_Struct(c ## classname.klass, 0, 0, &(*i)));
    -  $result = arr;
    -}
    -%typemap(out) vectorclassname, const vectorclassname {
    -  VALUE arr = rb_ary_new2($1.size()); 
    -  vectorclassname::iterator i = $1.begin(), iend = $1.end();
    -  for ( ; i!=iend; i++ )
    -    rb_ary_push(arr, Data_Wrap_Struct(c ## classname.klass, 0, 0, &(*i)));
    -  $result = arr;
    +
    +%module example
    +
    +%include <typemaps.i>
    +
    +int divide(int n, int d, int *OUTPUT, int *OUTPUT);
    +
    +%{
    +int divide(int n, int d, int q*, int *r) {
    +   if (d != 0) {
    +     *q = n / d;
    +     *r = n % d;
    +     return 1;
    +   }
    +   else return 0;
     }
    -%enddef
    -
    Note that this is mostly an example of typemaps. If you want to - use the STL with ruby, you are advised to use the standard swig STL - library, which does much more than this. Refer to the section called - the C++ Standard Template Library. -

    36.8 Docstring Features

    -

    Using ri and rdoc web pages in Ruby libraries is a common practice. - Given the way that SWIG generates the extensions by default, your users - will normally not get any documentation for it, even if they run 'rdoc' - on the resulting .c or .cxx file.

    -

    The features described in this section make it easy for you to add - rdoc strings to your modules, functions and methods that can then be - read by Ruby's rdoc tool to generate html web pages, ri documentation, - Windows chm file and an .xml description.

    -

    rdoc can then be run from a console or shell window on a swig - generated file.

    -

    For example, to generate html web pages from a C++ file, you'd do:

    -
    +%} + +
    +
    -$ rdoc -E cxx=c -f html file_wrap.cxx
    +--> [ret, q, r] = divide(20, 6)
    + r  =
    +
    +    2.
    + q  =
    +
    +    3.
    + ret  =
    +
    +    1.
     
    -

    To generate ri documentation from a c wrap file, you could do:

    -
    +

    39.3.4 Global variables +

    +

    Global variables are manipulated through generated accessor + functions. For example, for a given Foo global variable, SWIG + actually generates two functions: Foo_get() to get the value + of Foo, and Foo_set() to set the value. These + functions are used as following:

    +
    -$ rdoc -r file_wrap.c
    +--> exec loader.sce;
    +--> c = Foo_get();
    +
    +--> Foo_set(4);
    +
    +--> c
    +c =
    +
    +    3.
    +
    +--> Foo_get()
    +ans  =
    +
    +    4.
     
    -

    36.8.1 Module docstring

    -

    Ruby allows a docstring at the beginning of the file before any - other statements, and it is typically used to give a general - description of the entire module. SWIG supports this by setting an - option of the %module directive. For example:

    +

    It works for variables of primitive type, but also for non-primitive + types: arrays, and structs/classes which are described later. For now, + an example with two global primitive arrays x and y is shown:

    -
    %module(docstring="This is the example module's docstring") example
    +
    +%module example
    +
    +%inline %{
    +int x[10];
    +double y[7];
    +
    +void initArrays()
    +{
    +  int i;
    +  for (i = 0; i < 10; i++)
    +    x[i] = 1;
    +  for (i = 0; i < 7; i++)
    +    y[i] = 1.0f;
    +}
    +%}
    +
    -

    When you have more than just a line or so then you can retain the - easy readability of the %module directive by using a macro. - For example:

    -
    -
    %define DOCSTRING
    -"The `XmlResource` class allows program resources defining menus, 
    -layout of controls on a panel, etc. to be loaded from an XML file."
    -%enddef
    +

    It works the same:

    +
    +
    +--> exec loader.sce
     
    -%module(docstring=DOCSTRING) xrc
    +--> initArrays(); +--> x_get() + ans = + + 1. 1. 1. 1. 1. 1. 1. 1. 1. 1. + +--> y_set([0:6] / 10); +--> y_get() + ans = + + 0. 0.1 0.2 0.3 0.4 0.5 0.6 +
    -

    36.8.2 %feature("autodoc")

    -

    Since SWIG does know everything about the function it wraps, it is - possible to generate an rdoc containing the parameter types, names and - default values. Since Ruby ships with one of the best documentation - systems of any language, it makes sense to take advantage of it.

    -

    SWIG's Ruby module provides support for the "autodoc" feature, which - when attached to a node in the parse tree will cause an rdoc comment to - be generated in the wrapper file that includes the name of the - function, parameter names, default values if any, and return type if - any. There are also several options for autodoc controlled by the value - given to the feature, described below.

    -

    36.8.2.1 %feature("autodoc", "0")

    -

    When the "0" option is given then the types of the parameters will - not be included in the autodoc string. For example, given this - function prototype:

    +

    39.3.5 Constants and + enumerations

    +

    39.3.5.1 Constants

    +

    There is not any constant in Scilab. By default, C/C++ constants are + wrapped as getter functions. For example, for the following constants:

    -
    %feature("autodoc", "0");
    -bool function_name(int x, int y, Foo* foo=NULL, Bar* bar=NULL);
    +
    +%module example
    +#define    ICONST      42
    +#define    FCONST      2.1828
    +#define    CCONST      'x'
    +#define    CCONST2     '\n'
    +#define    SCONST      "Hello World"
    +#define    SCONST2     "\"Hello World\""
    +
    -

    Then Ruby code like this will be generated:

    +

    the following getter functions are generated:

    -
    function_name(x, y, foo=nil, bar=nil) -> bool
    -  ...
    +
    +--> exec loader.sce;
    +--> ICONST_get();
    + ans  =
    +
    +    42.
    +
    +--> FCONST_get();
    + ans  =
    +
    +    2.1828
    +
    +--> CCONST_get();
    + ans  =
    +
    +    x
    +
    +--> CCONST2_get();
    + ans  =
    +
    +--> SCONST_get();
    + ans  =
    +
    +    Hello World
    +
    +--> SCONST2_get();
    + ans  =
    +
    +    "Hello World"
    +
    +--> EXPR_get();
    + ans  =
    +
    +    48.5484
    +
    +--> iconst_get();
    + ans  =
    +
    +    37.
    +
    +--> fconst_get();
    + ans  =
    +
    +    3.14
    +
    -

    36.8.2.2 %feature("autodoc", "1")

    -

    When the "1" option is used then the parameter types will - be used in the rdoc string. In addition, an attempt is made to simplify - the type name such that it makes more sense to the Ruby user. Pointer, - reference and const info is removed, %rename's are evaluated, - etc. (This is not always successful, but works most of the time. See - the next section for what to do when it doesn't.) Given the example - above, then turning on the parameter types with the "1" option will - result in rdoc code like this:

    -
    -
    function_name(int x, int y, Foo foo=nil, Bar bar=nil) -> bool
    -  ...
    +

    There is another mode in which constants are wrapped as Scilab + variables. The variables are easier to use than functions, but the + drawback is that variables are not constant and so can be modified.

    +

    This mode can be enabled/disabled at any time in the interface file + with %scilabconst(), which works like all the other +%feature directives. Use the argument value "1" to enable and "0" to + disable this mode. For example in this mode the previous constants:

    +
    +
    +%module example
    +
    +%scilabconst(1);
    +#define    ICONST      42
    +#define    FCONST      2.1828
    +#define    CCONST      'x'
    +#define    CCONST2     '\n'
    +#define    SCONST      "Hello World"
    +#define    SCONST2     "\"Hello World\""
    +
    -

    36.8.2.3 %feature("autodoc", "2")

    -

    When the "2" option is used then the parameter types will not be - used in the rdoc string. However, they will be listed in full after the - function. Given the example above, then turning on the parameter types - with the "2" option will result in Ruby code like this:

    -

    36.8.2.4 %feature("autodoc", - "3")

    -

    When the "3" option is used then the function will be documented - using a combination of "1" and "2" above. Given the example above, then - turning on the parameter types with the "2" option will result in Ruby - code like this:

    +

    are mapped to Scilab variables, with the same name:

    -
    function_name(int x, int y, Foo foo=nil, Bar bar=nil) -> bool
    +
    +--> exec loader.sce;
    +--> ICONST
    + ans  =
     
    -Parameters:
    -	x - int
    -	y - int
    -	foo - Foo
    -	bar - Bar
    + 42 + +--> FCONST + ans = + + 2.1828 + +--> CCONST + ans = + + x + +--> CCONST2 + ans = + +--> SCONST + ans = + + Hello World + +--> SCONST2 + ans = + + "Hello World" + +--> EXPR + ans = + + 48.5484 + +--> iconst + ans = + + 37 + +--> fconst + ans = + + 3.14 +
    -

    36.8.2.5 %feature("autodoc", "docstring")

    -

    Finally, there are times when the automatically generated autodoc - string will make no sense for a Ruby programmer, particularly when a - typemap is involved. So if you give an explicit value for the autodoc - feature then that string will be used in place of the automatically - generated string. For example:

    +

    39.3.5.2 Enumerations

    +

    The wrapping of enums is the same as for constants. By default, + enums are wrapped as getter functions. For example, with the following + enumeration:

    -
    %feature("autodoc", "GetPosition() -> (x, y)") GetPosition;
    -void GetPosition(int* OUTPUT, int* OUTPUT);
    +
    %module example
    +typedef enum { RED, BLUE, GREEN } color;
    +
    -

    36.8.3 %feature("docstring")

    -

    In addition to the autodoc strings described above, you can also - attach any arbitrary descriptive text to a node in the parse tree with - the "docstring" feature. When the proxy module is generated then any - docstring associated with classes, function or methods are output. If - an item already has an autodoc string then it is combined with the - docstring and they are output together.

    -

    36.9 Advanced Topics

    -

    36.9.1 Operator overloading

    -

    SWIG allows operator overloading with, by using the %extend - or %rename commands in SWIG and the following operator names - (derived from Python):

    -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    General
    __repr__ inspect
    __str__ to_s
    __cmp__ <=>
    __hash__ hash
    __nonzero__ nonzero?
    Callable
    __call__ call
    Collection
    __len__ length
    __getitem__ []
    __setitem__ []=
    Numeric
    __add__ +
    __sub__ -
    __mul__ *
    __div__ /
    __mod__ %
    __divmod__ divmod
    __pow__ **
    __lshift__ <<
    __rshift__ >>
    __and__ &
    __xor__ ^
    __or__ |
    __neg__ -@
    __pos__ +@
    __abs__ abs
    __invert__ ~
    __int__ to_i
    __float__ to_f
    __coerce__ coerce
    Additions in 1.3.13
    __lt__ <
    __le__ <=
    __eq__ ==
    __gt__ >
    __ge__ >=
    +

    a getter function will be generated for each value of the + enumeration:

    +
    +
    +--> exec loader.sce;
    +--> RED_get()
    + ans  =
    +
    +    0.
    +
    +--> BLUE_get()
    + ans  =
    +
    +    1.
    +
    +--> GREEN_get()
    + ans  =
    +
    +    2.
    +
    -

    Note that although SWIG supports the __eq__ magic method - name for defining an equivalence operator, there is no separate method - for handling inequality since Ruby parses the expression a != - b as !(a == b).

    -

    36.9.2 Creating Multi-Module Packages

    -

    The chapter on Working with Modules discusses - the basics of creating multi-module extensions with SWIG, and in - particular the considerations for sharing runtime type information - among the different modules.

    -

    As an example, consider one module's interface file (shape.i -) that defines our base class:

    +

    The %scilabconst() feature is also available for + enumerations:

    -
    %module shape
    +
    %module example
    +%scilabconst(1) color;
    +typedef enum { RED, BLUE, GREEN } color;
    +
    +
    +
    +
    +--> exec loader.sce;
    +--> RED
    + ans  =
     
    -%{
    -#include "Shape.h"
    -%}
    +    0.
     
    -class Shape {
    -protected:
    -  double xpos;
    -  double ypos;
    -protected:
    -  Shape(double x, double y);
    -public:
    -  double getX() const;
    -  double getY() const;
    -};
    +--> BLUE + ans = + + 1. + +--> GREEN + ans = + + 2. + +
    -

    We also have a separate interface file (circle.i) that - defines a derived class:

    +

    39.3.6 Pointers

    +

    Pointers are supported by SWIG. A pointer can be returned from a + wrapped C/C++ function, stored in a Scilab variable, and used in input + argument of another C/C++ function.

    +

    Also, thanks to the SWIG runtime which stores informations about + types, pointer types are tracked between exchanges Scilab and the + native code. Indeed pointer types are stored alongside the pointer + adress. A pointer is mapped to a Scilab structure ( +tlist), which contains as fields the pointer address and the pointer + type (in fact a pointer to the type information structure in the SWIG + runtime). +
    Why a native pointer is not mapped to a Scilab pointer (type name: + "pointer", type ID: 128) ? The big advantage of mapping to a tlist + is that it exposes a new type for the pointer in Scilab, type which can + be acessed in Scilab with the +typeof function, and manipulated using the +overloading mechanism.

    +

    Notes:

    +
      +
    • type tracking needs the SWIG runtime to be first initialized with + the appropriate function (see the +Module initialization section).
    • +
    • for any reason, if a wrapped pointer type is unknown (or if the SWIG + runtime is not initialized), SWIG maps it to a Scilab pointer. Also, a + Scilab pointer is always accepted as a pointer argument of a wrapped + function. The drawaback is that pointer type is lost.
    • +
    +

    Following is an example of the wrapping of the C FILE* + pointer:

    -
    %module circle
    +
    +%module example
     
     %{
    -#include "Shape.h"
    -#include "Circle.h"
    +#include <stdio.h>
     %}
     
    -// Import the base class definition from Shape module
    -%import shape.i
    +FILE *fopen(const char *filename, const char *mode);
    +int fputs(const char *, FILE *);
    +int fclose(FILE *);
    +
    +
    +

    These functions can be used the same way as in C from Scilab:

    +
    +
    +--> example_Init();
     
    -class Circle : public Shape {
    -protected:
    -  double radius;
    -public:
    -  Circle(double x, double y, double r);
    -  double getRadius() const;
    -};
    +--> f = fopen("junk", "w"); +--> typeof(f) + ans = + + _p_FILE + +--> fputs("Hello World", f); +--> fclose(f); +
    -

    We'll start by building the Shape extension module:

    -
    -
    $ swig -c++ -ruby shape.i
    +

    Note: the type name _p_FILE which means "pointer to FILE".

    +

    The user of a pointer is responsible for freeing it or, like in the + example, closing any resources associated with it (just as is required + in a C program).

    +

    39.3.6.1 Utility + functions

    +

    As a scripting language, Scilab does not provide functions to + manipulate pointers. However, in some cases it can be useful, such as + for testing or debugging.

    +

    SWIG comes with two pointer utility functions:

    +
      +
    • SWIG_this(): returns the address value of a pointer
    • +
    • SWIG_ptr(): creates a pointer from an address value
    • +
    +

    Note: a pointer created by SWIG_ptr() does not have any + type and is mapped as a Scilab pointer.

    +

    Following we use the utility functions on the previous example:

    +
    +
    +--> f = fopen("junk", "w");
    +--> fputs("Hello", f);
    +--> addr = SWIG_this(f)
    + ans  =
    +
    +    8219088.
    +
    +--> p = SWIG_ptr(addr);
    +--> typeof(p)
    +ans  =
    +
    +  pointer
    +
    +--> fputs(" World", p);
    +--> fclose(f);
     
    -

    SWIG generates a wrapper file named shape_wrap.cxx. To - compile this into a dynamically loadable extension for Ruby, prepare an - extconf.rb script using this template:

    -
    -
    require 'mkmf'
    +

    39.3.6.2 Null + pointers:

    +

    Using the previous SWIG_this() and SWIG_ptr(), it + is possible to create and check null pointers:

    +
    +
    +--> p = SWIG_ptr(0);
    +--> SWIG_this(p) == 0
    + ans  =
     
    -# Since the SWIG runtime support library for Ruby
    -# depends on the Ruby library, make sure it's in the list
    -# of libraries.
    -$libs = append_library($libs, Config::CONFIG['RUBY_INSTALL_NAME'])
    +    T
    +
    +
    +

    39.3.7 Structures

    +

    Structs exist in Scilab, but C structs are not (at least in this + version of SWIG) mapped to Scilab structs. A C structure is wrapped + through low-level accessor functions, i.e. functions that give access + to the member variables of this structure. In Scilab, a structure is + manipulated through a pointer which is passed as an argument to the + accessor functions.

    +

    Let's see it on an example of a struct with two members:

    +
    +
    +%module example
     
    -# Create the makefile
    -create_makefile('shape')
    +%inline %{ + +typedef struct { + int x; + int arr[4]; +} Foo; + +%} +
    -

    Run this script to create a Makefile and then type make - to build the shared library:

    -
    -
    $ ruby extconf.rb
    -creating Makefile
    -$ make
    -g++ -fPIC -g -O2 -I. -I/usr/local/lib/ruby/1.7/i686-linux \
    --I. -c shape_wrap.cxx
    -gcc -shared -L/usr/local/lib -o shape.so shape_wrap.o -L. \
    --lruby -lruby -lc
    +

    Several functions are generated:

    +
      +
    • a constructor function new_Foo() which returns a pointer to + a newly created struct Foo.
    • +
    • two member getter functions Foo_x_get(), Foo_arr_get() +, to get the values of x and y for the struct pointer + (provided as the first parameter to these functions)
    • +
    • two member setter functions Foo_x_set(), Foo_arr_set() +, to set the values of x and y for the struct pointer + (provided as the first parameter to these functions).
    • +
    • a destructor function delete_Foo() to release the struct + pointer.
    • +
    +

    Usage example:

    +
    +
    +--> f = new_Foo();
    +--> Foo_x_set(f, 100);
    +--> Foo_x_get(f)
    +ans  =
    +
    +    100.
    +
    +--> Foo_arr_set(f, [0:3]);
    +--> Foo_arr_get(f)
    +ans  =
    +
    +    0.    1.    2.    3.
    +
    +--> delete_Foo(f);
    +
    -

    Note that depending on your installation, the outputs may be - slightly different; these outputs are those for a Linux-based - development environment. The end result should be a shared library - (here, shape.so) containing the extension module code. Now - repeat this process in a separate directory for the Circle - module:

    -
      -
    1. Run SWIG to generate the wrapper code (circle_wrap.cxx);
    2. -
    3. Write an extconf.rb script that your end-users can use to - create a platform-specific Makefile for the extension;
    4. -
    5. Build the shared library for this extension by typing make -.
    6. -
    -

    Once you've built both of these extension modules, you can test them - interactively in IRB to confirm that the Shape and Circle - modules are properly loaded and initialized:

    -
    -
    $ irb
    -irb(main):001:0> require 'shape'
    -true
    -irb(main):002:0> require 'circle'
    -true
    -irb(main):003:0> c = Circle::Circle.new(5, 5, 20)
    -#<Circle::Circle:0xa097208>
    -irb(main):004:0> c.kind_of? Shape::Shape
    -true
    -irb(main):005:0> c.getX()
    -5.0
    +

    Members of a structure that are also structures are also accepted + and wrapped as a pointer:

    +
    +
    +%module example
    +
    +%inline %{
    +
    +typedef struct {
    +  int x;
    +} Bar;
    +
    +typedef struct {
    +  Bar b;
    +} Foo;
    +
    +%}
    +
    -

    36.9.3 Specifying Mixin Modules

    -

    The Ruby language doesn't support multiple inheritance, but it does - allow you to mix one or more modules into a class using Ruby's -include method. For example, if you have a Ruby class that defines - an each instance method, e.g.

    -
    -
    class Set
    -  def initialize
    -  @members = []
    -  end
    - 
    -  def each
    -  @members.each { |m| yield m }
    -  end
    -end
    +
    +
    +--> b = new_Bar();
    +--> Bar_x_set(b, 20.);
    +
    +--> f = new_Foo();
    +--> Foo_b_set(f, b);
    +
    +--> b2 = Foo_b_get(f);
    +--> Bar_x_get(b2);
    +ans  =
    +
    +    20.
    +
    -

    then you can mix-in Ruby's Enumerable module to easily add - a lot of functionality to your class:

    -
    -
    class Set
    -  include Enumerable
    -  def initialize
    -    @members = []
    -  end
    -  def each
    -    @members.each { |m| yield m }
    -  end
    -end
    +

    Note: the pointer to the struct works as described in +Pointers. For example, the type of the struct pointer can be get + with typeof, as following:

    +
    +
    +--> example_Init();
    +--> b = new_Bar();
    +--> typeof(b)
    + ans  =
    +
    +    _p_Bar
    +--> delete_Bar(b);
    +
    -

    To get the same benefit for your SWIG-wrapped classes, you can use - the %mixin directive to specify the names of one or more - modules that should be mixed-in to a class. For the above example, the - SWIG interface specification might look like this:

    +

    39.3.8 C++ classes

    +

    Classes do not exist in Scilab. The classes are wrapped the same way + as structs. Low-level accessor functions are generated for class + members. Also, constructor and destructor functions are generated to + create and destroy an instance of the class.

    +

    For example, the following class:

    -
    %mixin Set "Enumerable";
    +
    +%module example
     
    -class Set {
    +%inline %{
    +
    +class Point {
     public:
    -  // Constructor
    -  Set();
    - 
    -  // Iterates through set members
    -  void each();
    -};
    + int x, y; + Point(int _x, int _y) : x(_x), y(_y) {} + double distance(const Point& rhs) { + return sqrt(pow(x-rhs.x, 2) + pow(y-rhs.y, 2)); + } + void set(int _x, int _y) { + x=_x; + y=_y; + } +}; + +%} +
    -

    Multiple modules can be mixed into a class by providing a - comma-separated list of module names to the %mixin directive, - e.g.

    -
    -
    %mixin Set "Fee,Fi,Fo,Fum";
    +

    can be used in Scilab like this:

    +
    +
    +--> p1 = Point_new(3, 5);
    +--> p2 = Point_new(1, 2);
    +--> p1.distance(p2)
    +ans  =
    +
    +    3.6056
    +
    +--> delete_Point(p1);
    +--> delete_Point(p2);
    +
    -

    Note that the %mixin directive is implemented using SWIG's - "features" mechanism and so the same name matching rules used for other - kinds of features apply (see the chapter on -"Customization Features") for more details).

    -

    36.10 Memory Management

    -

    One of the most common issues in generating SWIG bindings for Ruby is - proper memory management. The key to proper memory management is - clearly defining whether a wrapper Ruby object owns the underlying C - struct or C++ class. There are two possibilities:

    -
      -
    • The Ruby object is responsible for freeing the C struct or C++ - object
    • -
    • The Ruby object should not free the C struct or C++ object because - it will be freed by the underlying C or C++ code
    • -
    -

    To complicate matters, object ownership may transfer from Ruby to C++ - (or vice versa) depending on what function or methods are invoked. - Clearly, developing a SWIG wrapper requires a thorough understanding of - how the underlying library manages memory.

    -

    36.10.1 Mark and Sweep Garbage Collector

    -

    Ruby uses a mark and sweep garbage collector. When the garbage - collector runs, it finds all the "root" objects, including local - variables, global variables, global constants, hardware registers and - the C stack. For each root object, the garbage collector sets its mark - flag to true and calls rb_gc_mark on the object. The job of -rb_gc_mark is to recursively mark all the objects that a Ruby - object has a reference to (ignoring those objects that have already - been marked). Those objects, in turn, may reference other objects. This - process will continue until all active objects have been "marked." - After the mark phase comes the sweep phase. In the sweep phase, all - objects that have not been marked will be garbage collected. For more - information about the Ruby garbage collector please refer to +

    Note: like structs, class pointers are mapped as described in +Pointers. Let's give an example which shows that each class pointer + type is a new type in Scilab that can be used for example (through +overloading) to implement a custom print for the Point + class:

    +
    +
    +--> function %_p_Point_p(p)
    +-->     mprintf('[%d, %d]\n', Point_x_get(p), Point_y_get(p));
    +--> endfunction
     
    -
    - http://rubygarden.org/ruby/ruby?GCAndExtensions.

    -

    The Ruby C/API provides extension developers two hooks into the - garbage collector - a "mark" function and a "sweep" function. By - default these functions are set to NULL.

    -

    If a C struct or C++ class references any other Ruby objects, then it - must provide a "mark" function. The "mark" function should identify any - referenced Ruby objects by calling the rb_gc_mark function for each - one. Unsurprisingly, this function will be called by the Ruby garbage - during the "mark" phase.

    -

    During the sweep phase, Ruby destroys any unused objects. If any - memory has been allocated in creating the underlying C struct or C++ - struct, then a "free" function must be defined that deallocates this - memory.

    -

    36.10.2 Object Ownership

    -

    As described above, memory management depends on clearly defining who - is responsible for freeing the underlying C struct or C++ class. If the - Ruby object is responsible for freeing the C++ object, then a "free" - function must be registered for the object. If the Ruby object is not - responsible for freeing the underlying memory, then a "free" function - must not be registered for the object.

    -

    For the most part, SWIG takes care of memory management issues. The - rules it uses are:

    -
      -
    • When calling a C++ object's constructor from Ruby, SWIG will assign - a "free" function thereby making the Ruby object responsible for - freeing the C++ object
    • -
    • When calling a C++ member function that returns a pointer, SWIG - will not assign a "free" function thereby making the underlying library - responsible for freeing the object.
    • -
    -

    To make this clearer, let's look at an example. Assume we have a Foo - and a Bar class.

    +--> example_Init(); +--> p = new_Point(1, 2) + p = + +[1, 2] + +--> delete_Point(p); +
    +
    +

    39.3.9 C++ inheritance

    +

    Inheritance is supported. SWIG knows the inheritance relationship + between classes.

    +

    A function is only generated for the class in which it is actually + declared. But if one of its parameters is a class, any instance of a + derived class is accepted as the argument.

    +

    This mechanism also applies for accessor functions: they are + generated only in the class in which they are defined. But any instance + of a derived class can be used as the argument to these accessor + functions.

    +

    For example, let's take a base class Shape and two derived + classes Circle and Square:

    -
    /* File "RubyOwernshipExample.h" */
    +
    +%module example
     
    -class Foo
    -{
    +%inline %{
    +
    +class Shape {
     public:
    -  Foo() {}
    -  ~Foo() {}
    +  double x, y;
    +  void set_location(double _x, double _y) { x = _x; y = _y; }
    +  virtual double get_perimeter() { return 0; };
     };
     
    -class Bar
    -{
    -  Foo *foo_;
    +class Circle : public Shape {
     public:
    -  Bar(): foo_(new Foo) {}
    -  ~Bar() { delete foo_; }
    -  Foo* get_foo() { return foo_; }
    -  Foo* get_new_foo() { return new Foo; }
    -  void set_foo(Foo *foo) { delete foo_; foo_ = foo; }
    -};
    -
    -

    First, consider this Ruby code:

    -
    -
    foo = Foo.new
    -
    -

    In this case, the Ruby code calls the underlying Foo C++ - constructor, thus creating a new foo object. By default, SWIG - will assign the new Ruby object a "free" function. When the Ruby object - is garbage collected, the "free" function will be called. It in turn - will call Foo's destructor.

    -

    Next, consider this code:

    -
    -
    bar = Bar.new
    -foo = bar.get_foo()
    -
    -

    In this case, the Ruby code calls a C++ member function, get_foo -. By default, SWIG will not assign the Ruby object a "free" function. - Thus, when the Ruby object is garbage collected the underlying C++ -foo object is not affected.

    -

    Unfortunately, the real world is not as simple as the examples above. - For example:

    -
    -
    bar = Bar.new
    -foo = bar.get_new_foo()
    + int radius; + Circle(int _radius): radius(_radius) {}; + virtual double get_perimeter() { return 6.28 * radius; } +}; + +class Square : public Shape { +public: + int size; + Square(int _size): size(_size) {}; + virtual double get_perimeter() { return 4 * size; } +}; + +%} +
    -

    In this case, the default SWIG behavior for calling member functions - is incorrect. The Ruby object should assume ownership of the returned - object. This can be done by using the %newobject directive. See - Object ownership and %newobject for more information.

    -

    The SWIG default mappings are also incorrect in this case:

    -
    -
    foo = Foo.new
    -bar = Bar.new
    -bar.set_foo(foo)
    +

    To set the location of the Circle, we have to use the + function set_location() of the parent Shape. But we + can use either use the get_perimeter() function of the parent + class or the derived class:

    +
    +
    +--> c = new_Circle(3);
    +
    +--> Shape_set_location(c, 2, 3);
    +--> Shape_x_get(c)
    + ans  =
    +
    +    2.
    +
    +--> Circle_get_perimeter(c)
    + ans  =
    +
    +    18.84
    +
    +--> Shape_get_perimeter(c)
    + ans  =
    +
    +    18.84
    +
    -

    Without modification, this code will cause a segmentation fault. When - the Ruby foo object goes out of scope, it will free the - underlying C++ foo object. However, when the Ruby bar object - goes out of scope, it will call the C++ bar destructor which will also - free the C++ foo object. The problem is that object ownership - is transferred from the Ruby object to the C++ object when the -set_foo method is called. This can be done by using the special - DISOWN type map, which was added to the Ruby bindings in SWIG-1.3.26.

    -

    Thus, a correct SWIG interface file correct mapping for these classes - is:

    +

    39.3.10 C++ overloading +

    +

    As explained in +6.15 SWIG provides support for overloaded functions and + constructors.

    +

    As SWIG knows pointer types, the overloading works also with pointer + types, here is is an example with a function magnify + overloaded for the previous classes Shape and Circle:

    -
    /* File RubyOwnershipExample.i */
    +
    +%module example
     
    -%module RubyOwnershipExample
    +void magnify(Square *square, double factor) {
    +    square->size *= factor;
    +};
    +
    +void magnify(Circle *circle, double factor) {
    +    square->radius *= factor;
    +};
    +
    +
    +
    +--> example_Init();
    +--> c = new_Circle(3);
    +--> s = new_Square(2);
    +
    +--> magnify(c, 10);
    +--> Circle_get_radius(c)
    + ans  =
    +
    +   30;
    +--> magnify(s, 10);
    +--> Square_get_size(s)
    + ans  =
    +
    +   20;
    +
    +
    +

    39.3.11 + Pointers, references, values, and arrays

    +

    In C++ objects can be passed by value, pointer, reference, or by an + array:

    +
    +
    +%module example
     
     %{
    -#include "RubyOwnershipExample.h"
    +#include <sciprint.h>
     %}
     
    -class Foo
    -{
    +%inline %{
    +
    +class Foo {
     public:
    -  Foo();
    -  ~Foo();
    +  Foo(int _x) : x(_x) {}
    +  int x;
     };
     
    -class Bar
    -{
    -  Foo *foo_;
    -public:
    -  Bar();
    -  ~Bar();
    -  Foo* get_foo();
    +void spam1(Foo *f)  { sciprint("%d\n", f->x); }   // Pass by pointer
    +void spam2(Foo &f)  { sciprint("%d\n", f.x); }    // Pass by reference
    +void spam3(Foo f)   { sciprint("%d\n", f.x); }    // Pass by value
    +void spam4(Foo f[]) { sciprint("%d\n", f[0].x); } // Array of objects
     
    -  %newobject get_new_foo;
    -  Foo* get_new_foo();
    +%}
    +
    +
    +

    In SWIG, there is no real distinction between these. So in Scilab, + it is perfectly legal to do this:

    +
    +
    +--> f = new_Foo()
    +--> spam1(f)
    +3
    +--> spam2(f)
    +3
    +--> spam3(f)
    +3
    +--> spam4(f)
    +3
    +
    +
    +

    Similar behaviour occurs for return values. For example, if you had + functions like this:

    +
    +
    +Foo *spam5();
    +Foo &spam6();
    +Foo  spam7();
    +
    +
    +

    All these functions will return a pointer to an instance of Foo +. As the function spam7 returns a value, new instance of +Foo has to be allocated, and a pointer on this instance is + returned.

    +

    39.3.12 C++ templates

    +

    As in other languages, function and class templates are supported in + SWIG Scilab.

    +

    You have to tell SWIG to create wrappers for a particular template + instantiation. The %template directive is used for this + purpose. For example:

    +
    +
    +%module example
     
    -  %apply SWIGTYPE *DISOWN {Foo *foo};
    -  void set_foo(Foo *foo);
    -  %clear Foo *foo;
    +template<class T1, class T2, class T3>
    +struct triplet {
    +  T1 first;
    +  T2 second;
    +  T3 third;
    +  triplet(const T1& a, const T2& b, const T3& c) {
    +    third = a; second = b; third = c;
    +  }
     };
    +
    +%template(IntTriplet) triplet<int,int,int>;
     
    -

    This code can be seen in swig/examples/ruby/tracking.

    -

    36.10.3 Object Tracking

    -

    The remaining parts of this section will use the class library shown - below to illustrate different memory management techniques. The class - library models a zoo and the animals it contains.

    +

    Then in Scilab:

    +
    +
    +--> t = new_IntTriplet(3, 4, 1);
    +
    +--> IntTriplet_first_get(t)
    + ans  =
    +
    +    3.
    +
    +--> IntTriplet_second_get(t)
    + ans  =
    +
    +    4.
    +
    +--> IntTriplet_third_get(t)
    + ans  =
    +
    +    1.
    +
    +--> delete_IntTriplet(t);
    +
    +
    +

    More details on template support can be found in the +templates documentation.

    +

    39.3.13 C++ operators

    +

    C++ operators are partially supported. Operator overloading exists + in Scilab, but a C++ operator is not (in this version) wrapped by SWIG + as a Scilab operator, but as a function. It is not automatic, you have + to rename each operator (with the instruction %rename) with + the suitable wrapper name.

    +

    Let's see it with an example of class with two operators + + and double():

    -
    %module zoo
    +
    +%module example
     
    -%{
    -#include <string>
    -#include <vector>
    +%rename(plus) operator +;
    +%rename(toDouble) operator double();
     
    -#include "zoo.h"
    -%}
    +%inline %{
     
    -class Animal
    -{
    -private:
    -  typedef std::vector<Animal*> AnimalsType;
    -  typedef AnimalsType::iterator IterType;
    -protected:
    -  AnimalsType animals;
    -protected:
    -  std::string name_;
    +class Complex {
     public:
    -  // Construct an animal with this name
    -  Animal(const char* name) : name_(name) {}
    - 
    -  // Return the animal's name
    -  const char* get_name() const { return name.c_str(); }
    -};
    +  Complex(double re, double im) : real(re), imag(im) {};
     
    -class Zoo
    -{
    -protected:
    - std::vector<animal *=""> animals;
    - 
    -public:
    -  // Construct an empty zoo
    -  Zoo() {}
    -  
    -  /* Create a new animal. */
    -  static Animal* Zoo::create_animal(const char* name) {
    -    return new Animal(name);
    -  }
    - 
    -  // Add a new animal to the zoo
    -  void add_animal(Animal* animal) {
    -    animals.push_back(animal); 
    -  }
    - 
    -  Animal* remove_animal(size_t i) {
    -    Animal* result = this->animals[i];
    -    IterType iter = this->animals.begin();
    -    std::advance(iter, i);
    -    this->animals.erase(iter);
    -   
    -    return result;
    -  }
    -  
    -  // Return the number of animals in the zoo
    -  size_t get_num_animals() const {
    -    return animals.size(); 
    -  }
    -  
    -  // Return a pointer to the ith animal
    -  Animal* get_animal(size_t i) const {
    -    return animals[i]; 
    +  Complex operator+(const Complex& other) {
    +    double result_real = real + other.real;
    +    double result_imaginary = imag + other.imag;
    +    return Complex(result_real, result_imaginary);
       }
    -};
    + operator double() { return real; } +private: + double real; + double imag; +}; + +%} +
    -

    Let's say you SWIG this code and then run IRB:

    -
    -
    $ irb
    -irb(main):001:0> require 'example'
    -=> true
    +
    +
    +--> c1 = new_Complex(3, 7);
     
    -irb(main):002:0> tiger1 = Example::Animal.new("tiger1")
    -=> #<Example::Animal:0x2be3820>
    +--> c2 = Complex_plus(c, new_Complex(1,1));
     
    -irb(main):004:0> tiger1.get_name()
    -=> "tiger1"
    +--> Complex_toDouble(c2)
    + ans  =
     
    -irb(main):003:0> zoo = Example::Zoo.new()
    -=> #<Example::Zoo:0x2be0a60>
    +    4.
    +
    +
    +

    39.3.14 C++ namespaces

    +

    SWIG is aware of C++ namespaces, but does not use it for wrappers. + The module is not broken into submodules, nor do namespace appear in + functions names. All the namespaces are all flattened in the module. + For example with one namespace Foo:

    +
    +
    +%module example
     
    -irb(main):006:0> zoo.add_animal(tiger)
    -=> nil
    +%inline %{
     
    -irb(main):007:0> zoo.get_num_animals()
    -=> 1
    +namespace foo {
    +  int fact(int n) {
    +    if (n > 1)
    +      return n * fact(n-1);
    +    else
    +      return 1;
    +  }
     
    -irb(main):007:0> tiger2 = zoo.remove_animal(0)
    -=> #<Example::Animal:0x2bd4a18>
    +  struct Vector {
    +    double x,y,z;
    +  };
    +};
     
    -irb(main):008:0> tiger2.get_name()
    -=> "tiger1"
    +%}
     
    -irb(main):009:0> tiger1.equal?(tiger2)
    -=> false
     
    -

    Pay particular attention to the code tiger1.equal?(tiger2). - Note that the two Ruby objects are not the same - but they reference - the same underlying C++ object. This can cause problems. For example:

    -
    -
    irb(main):010:0> tiger1 = nil
    -=> nil
    +

    In Scilab, there is no need to the specify the Foo + namespace:

    +
    +
    +--> fact(3)
    + ans  =
     
    -irb(main):011:0> GC.start
    -=> nil
    +   6.
     
    -irb(main):012:0> tiger2.get_name()
    -(irb):12: [BUG] Segmentation fault
    +--> v = new_Vector();
    +--> Vector_x_set(v, 3.4);
    +--> Vector_y_get(v)
    + ans  =
    +
    +   0.
     
    -

    After the garbage collector runs, as a result of our call to -GC.start, callingtiger2.get_name() causes a segmentation - fault. The problem is that when tiger1 is garbage collected, - it frees the underlying C++ object. Thus, when tiger2 calls - the get_name() method it invokes it on a destroyed object.

    -

    This problem can be avoided if SWIG enforces a one-to-one mapping - between Ruby objects and C++ classes. This can be done via the use of - the %trackobjects functionality available in SWIG-1.3.26. and - later.

    -

    When the %trackobjects is turned on, SWIG automatically - keeps track of mappings between C++ objects and Ruby objects. Note that - enabling object tracking causes a slight performance degradation. Test - results show this degradation to be about 3% to 5% when creating and - destroying 100,000 animals in a row.

    -

    Since %trackobjects is implemented as a %feature, - it uses the same name matching rules as other kinds of features (see - the chapter on "Customization Features") - . Thus it can be applied on a class-by-class basis if needed. To fix - the example above:

    +

    If your program has more than one namespace, name conflicts can be + resolved using %rename. For example:

    -
    %module example
    -
    -%{
    -#include "example.h"
    -%}
    -
    -/* Tell SWIG that create_animal creates a new object */
    -%newobject Zoo::create_animal;
    +
    +%rename(Bar_spam) Bar::spam;
     
    -/* Tell SWIG to keep track of mappings between C/C++ structs/classes. */%trackobjects;
    +namespace Foo {
    +  int spam();
    +}
     
    -%include "example.h"
    +namespace Bar { + int spam(); +} +
    -

    When this code runs we see:

    -
    -
    $ irb
    -irb(main):001:0> require 'example'
    -=> true
    +

    Note: the nspace feature is not + supported.

    +

    39.3.15 C++ exceptions

    +

    Scilab does not natively support exceptions, but has errors. When an + exception is thrown, SWIG catches it, and sets a Scilab error. An error + message is displayed in Scilab. For example:

    +
    +
    +%module example
     
    -irb(main):002:0> tiger1 = Example::Animal.new("tiger1")
    -=> #<Example::Animal:0x2be37d8>
    +%inline %{
    +void throw_exception() throw(char const *) {
    +  throw "Bye world !";
    +}
    +%}
    +
    +
    +
    +
    +-->throw_exception()
    +  !--error 999
    +SWIG/Scilab: Exception (char const *) occured: Bye world !
    +
    +
    +

    Scilab has a try-catch mechanism (and a similar instruction + execstr()) to handle exceptions. It can be used with the +lasterror() function as following:

    +
    +
    +--> execstr('throw_exception()', 'errcatch');
    + ans  =
     
    -irb(main):003:0> zoo = Example::Zoo.new()
    -=> #<Example::Zoo:0x2be0a18>
    +    999.
     
    -irb(main):004:0> zoo.add_animal(tiger1)
    -=> nil
    +--> lasterror()
    + ans  =
     
    -irb(main):006:0> tiger2 = zoo.remove_animal(0)
    -=> #<Example::Animal:0x2be37d8>
    +    SWIG/Scilab: Exception (char const *) occured: Bye world !
    +
    +
    +

    If the function has a throw exception specification, SWIG + can automatically map the exception type and set an appropriate Scilab + error message. It works for a few primitive types, and also for STL + exceptions (the library std_except.i has to be included to get + the STL exception support):

    +
    +
    +%module example
     
    -irb(main):007:0> tiger1.equal?(tiger2)
    -=> true
    +%include <std_except.i>
     
    -irb(main):008:0> tiger1 = nil
    -=> nil
    +%inline %{
    +void throw_int() throw(int) {
    +  throw 12;
    +}
     
    -irb(main):009:0> GC.start
    -=> nil
    +void throw_stl_invalid_arg(int i) throw(std::invalid_argument) {
    +  if (i < 0)
    +    throw std::invalid_argument("argument is negative.");
    +}
    +%}
    +
    +
    +
    +
    +--> throw_int();
    +            !--error 999
    +SWIG/Scilab: Exception (int) occured: 12
     
    -irb(main):010:0> tiger.get_name()
    -=> "tiger1"
    -irb(main):011:0>
    +-->throw_stl_invalid_arg(-1); + !--error 999 +SWIG/Scilab: ValueError: argument is negative. +
    -

    For those who are interested, object tracking is implemented by - storing Ruby objects in a hash table and keying them on C++ pointers. - The underlying API is:

    -
    -
    static void SWIG_RubyAddTracking(void* ptr, VALUE object);
    -static VALUE SWIG_RubyInstanceFor(void* ptr) ;
    -static void SWIG_RubyRemoveTracking(void* ptr);
    -static void SWIG_RubyUnlinkObjects(void* ptr);
    +

    More complex or custom exception types require specific exception + typemaps to be implemented in order to specifically handle a thrown + type. See the SWIG C++ documentation for more + details.

    +

    39.3.16 C++ STL

    +

    The Standard Template Library (STL) is partially supported. See +STL for more details.

    +

    39.4 Type mappings and libraries

    +

    39.4.1 Default primitive + type mappings

    +

    The following table provides the equivalent Scilab type for C/C++ + primitive types.

    +
    + + + + + + + + + + + + + + + + + +
    C/C++ typeScilab type
    boolboolean
    charstring
    signed chardouble or int8
    unsigned chardouble or uint8
    shortdouble or int16
    unsigned shortdouble or uint16
    intdouble or int32
    unsigned intdouble or uint32
    longdouble or int32
    unsigned longdouble or uint32
    signed long longnot supported in Scilab 5.x
    unsigned long longnot supported in Scilab 5.x
    floatdouble
    doubledouble
    char * or char[]string
    -

    When an object is created, SWIG will automatically call the -SWIG_RubyAddTracking method. Similarly, when an object is deleted, - SWIG will call the SWIG_RubyRemoveTracking. When an object is - returned to Ruby from C++, SWIG will use the SWIG_RubyInstanceFor - method to ensure a one-to-one mapping from Ruby to C++ objects. Last, - the RubyUnlinkObjects method unlinks a Ruby object from its - underlying C++ object.

    -

    In general, you will only need to use the SWIG_RubyInstanceFor -, which is required for implementing mark functions as shown below. - However, if you implement your own free functions (see below) you may - also have to call the SWIG_RubyRemoveTracking and -RubyUnlinkObjects methods.

    -

    36.10.4 Mark Functions

    -

    With a bit more testing, we see that our class library still has - problems. For example:

    -
    -
    $ irb
    -irb(main):001:0> require 'example'
    -=> true
    +

    Notes:

    +
      +
    • In Scilab the double type is far more used than any integer + type. This is why integer values (int32, uint32, ...) + are automatically converted to Scilab double values when + marshalled from C into Scilab. Additionally on input to a C function, + Scilab double values are converted into the related integer + type.
    • +
    • When an integer is expected, if the input is a double, the value + must be an integer, i.e. it must not have any decimal part, otherwise a + SWIG value error occurs.
    • +
    • In SWIG for Scilab 5.x, the long long type is not + supported, since Scilab 5.x does not have a 64-bit integer type. The + default behaviour is for SWIG to generate code that will give a runtime + error if long long type arguments are used from Scilab.
    • +
    +

    39.4.2 Arrays

    +

    Typemaps are available by default for arrays. Primitive type arrays + are automatically converted to/from Scilab matrices. Typemaps are also + provided to handle members of a struct or class that are arrays.

    +

    In input, the matrix is usually one-dimensional (it can be either a + row or column vector). But it can also be a two-dimensional matrix. + Warning: in Scilab, the values are column-major ordered, unlike in C, + which is row-major ordered.

    +

    The type mappings used for arrays is the same for primitive types, + described earlier. This + means that, if needed, a Scilab double vector is converted in + input into the related C integer array and this C integer array is + automatically converted on output into a Scilab double vector. + Note that unlike scalars, no control is done for arrays when a +double is converted into an integer.

    +

    The following example illustrates all this:

    +
    +
    +%module example
     
    -irb(main):002:0> tiger1 = Example::Animal.new("tiger1")
    -=> #<Example::Animal:0x2bea6a8>
    +%#include <stdio.h>
     
    -irb(main):003:0> zoo = Example::Zoo.new()
    -=> #<Example::Zoo:0x2be7960>
    +%inline %{
     
    -irb(main):004:0> zoo.add_animal(tiger1)
    -=> nil
    +void printArray(int values[], int len) {
    +  int i = 0;
    +  for (i = 0; i < len; i++) {
    +    printf("%s %d %s", i==0?"[":"", values[i], i==len-1?"]\n":"");
    +  }
    +}
    +%}
    +
    +
    +
    +
    +--> printArray([0 1 2 3], 4)
    +[ 0  1  2  3 ]
     
    -irb(main):007:0> tiger1 = nil
    -=> nil
    +--> printArray([0.2; -1.8; 2; 3.7], 4)
    +[ 0  -1  2  3 ]
     
    -irb(main):007:0> GC.start
    -=> nil
    +--> printArray([0 1; 2 3], 4)
    +[ 0  2  1  3 ]
     
    -irb(main):005:0> tiger2 = zoo.get_animal(0)
    -(irb):12: [BUG] Segmentation fault
    +--> printArray([0; 1; 2; 3], 4) +[ 0 1 2 3 ] +
    -

    The problem is that Ruby does not know that the zoo object - contains a reference to a Ruby object. Thus, when Ruby garbage collects - tiger1 it frees the underlying C++ object.

    -

    This can be fixed by implementing a mark function as - described above in the Mark and Sweep Garbage - Collector section. You can specify a mark function by using the -%markfunc directive. Since the %markfunc directive is - implemented using SWIG's' "features" mechanism it uses the same name - matching rules as other kinds of features (see the chapter on -"Customization Features" for more details).

    -

    A mark function takes a single argument, which is a pointer - to the C++ object being marked; it should, in turn, call -rb_gc_mark() for any instances that are reachable from the current - object. The mark function for our Zoo class should therefore - loop over all of the C++ animal objects in the zoo object, look up - their Ruby object equivalent, and then call rb_gc_mark(). One - possible implementation is:

    +

    39.4.3 + Pointer-to-pointers

    +

    There are no specific typemaps for pointer-to-pointers, they are are + mapped as pointers in Scilab.

    +

    Pointer-to-pointers are sometimes used to implement matrices in C. + The following is a an example of this:

    -
    %module example
    -
    -%{
    -#include "example.h"
    -%}
    -
    -/* Keep track of mappings between C/C++ structs/classes
    - and Ruby objects so we can implement a mark function. */
    -%trackobjects;
    +
    +%module example
    +%inline %{
     
    -/* Specify the mark function */
    -%markfunc Zoo "mark_Zoo";
    +// Returns the matrix [1 2; 3 4];
    +double **create_matrix() {
    +  double **M;
    +  int i;
    +  M = (double **) malloc(2 * sizeof(double *));
    +  for (i = 0; i < 2; i++) {
    +    M[i] = (double *) malloc(2 * sizeof(double));
    +    M[i][0] = 2 * i + 1;
    +    M[i][1] = 2 * i + 2;
    +  }
    +  return M;
    +}
     
    -%include "example.h"
    +// Gets the item M(i,j) value
    +double get_matrix(double **M, int i, int j) {
    +  return M[i][j];
    +}
     
    -%header %{
    +// Sets the item M(i,j) value to be val
    +void set_matrix(double **M, int i, int j, double val) {
    +  M[i][j] = val;
    +}
     
    -static void mark_Zoo(void* ptr) {
    -  Zoo* zoo = (Zoo*) ptr;
    - 
    -  /* Loop over each object and tell the garbage collector
    -  that we are holding a reference to them. */
    -  int count = zoo->get_num_animals();
    - 
    -  for(int i = 0; i < count; ++i) {
    -    Animal* animal = zoo->get_animal(i);
    -    VALUE object = SWIG_RubyInstanceFor(animal);
    - 
    -    if (object != Qnil) {
    -      rb_gc_mark(object);
    +// Prints a matrix (2,2) to console
    +void print_matrix(double **M, int nbRows, int nbCols) {
    +  int i, j;
    +  for (i = 0; i < 2; i++) {
    +    for (j = 0; j < 2; j++) {
    +      printf("%3g ", M[i][j]);
         }
    +    printf("\n");
       }
     }
    -%}
    + +%} +
    -

    Note the mark function is dependent on the -SWIG_RUBY_InstanceFor method, and thus requires that -%trackobjects is enabled. For more information, please refer to the - track_object.i test case in the SWIG test suite.

    -

    When this code is compiled we now see:

    +

    These functions are used like this in Scilab:

    -
    $ irb
    -irb(main):002:0> tiger1=Example::Animal.new("tiger1")
    -=> #<Example::Animal:0x2be3bf8>
    +
    +--> m = create_matrix();
     
    -irb(main):003:0> Example::Zoo.new()
    -=> #<Example::Zoo:0x2be1780>
    +--> print_matrix(m);
    +   1.   2.
    +   3.   4.
     
    -irb(main):004:0> zoo = Example::Zoo.new()
    -=> #<Example::Zoo:0x2bde9c0>
    +--> set_matrix(m, 1, 1, 5.);
     
    -irb(main):005:0> zoo.add_animal(tiger1)
    -=> nil
    +--> get_matrix(m, 1, 1)
    + ans  =
     
    -irb(main):009:0> tiger1 = nil
    -=> nil
    +    5.
    +
    +
    +

    39.4.4 Matrices

    +

    The matrix.i library provides a set of typemaps which can + be useful when working with one-dimensional and two-dimensional + matrices.

    +

    In order to use this library, just include it in the interface file:

    +
    +
    +  %include <matrix.i>
    +
    +
    +

    Several typemaps are available for the common Scilab matrix types:

    +
      +
    • double
    • +
    • int
    • +
    • char *
    • +
    • bool
    • +
    +

    For example: for a matrix of int, we have the typemaps, for + input:

    +
      +
    • (int *IN, int IN_ROWCOUNT, int IN_COLCOUNT)
    • +
    • (int IN_ROWCOUNT, int IN_COLCOUNT, int *IN)
    • +
    • (int *IN, int IN_SIZE)
    • +
    • (int IN_SIZE, int *IN)
    • +
    +

    and output:

    +
      +
    • (int **OUT, int *OUT_ROWCOUNT, int *OUT_COLCOUNT)
    • +
    • (int *OUT_ROWCOUNT, int *OUT_COLCOUNT, int **OUT)
    • +
    • (int **OUT, int *OUT_SIZE)
    • +
    • (int *OUT_SIZE, int **OUT)
    • +
    +

    They marshall a Scilab matrix type into the appropriate 2 or 3 C + parameters. The following is an example using the typemaps in this + library:

    +
    +
    +%module example
     
    -irb(main):010:0> GC.start
    -=> nil
    -irb(main):014:0> tiger2 = zoo.get_animal(0)
    -=> #<Example::Animal:0x2be3bf8>
    +%include <matrix.i>
     
    -irb(main):015:0> tiger2.get_name()
    -=> "tiger1"
    -irb(main):016:0>
    +%apply (int *IN, int IN_ROWCOUNT, int IN_COLCOUNT) { (int *matrix, int matrixNbRow, int matrixNbCol) }; +%apply (int **OUT, int *OUT_ROWCOUNT, int *OUT_COLCOUNT) { (int **outMatrix, int *outMatrixNbRow, int *outMatrixNbCol) }; + +%inline %{ + +void absolute(int *matrix, int matrixNbRow, int matrixNbCol, + int **outMatrix, int *outMatrixNbRow, int *outMatrixNbCol) { + int i, j; + *outMatrixNbRow = matrixNbRow; + *outMatrixNbCol = matrixNbCol; + *outMatrix = malloc(matrixNbRow * matrixNbCol * sizeof(int)); + for (i=0; i < matrixNbRow * matrixNbCol; i++) { + (*outMatrix)[i] = matrix[i] > 0 ? matrix[i]:-matrix[i]; + } +} + +%} +
    -

    This code can be seen in swig/examples/ruby/mark_function.

    -

    36.10.5 Free Functions

    -

    By default, SWIG creates a "free" function that is called when a Ruby - object is garbage collected. The free function simply calls the C++ - object's destructor.

    -

    However, sometimes an appropriate destructor does not exist or - special processing needs to be performed before the destructor is - called. Therefore, SWIG allows you to manually specify a "free" - function via the use of the %freefunc directive. The -%freefunc directive is implemented using SWIG's' "features" - mechanism and so the same name matching rules used for other kinds of - features apply (see the chapter on -"Customization Features") for more details).

    -

    IMPORTANT ! - If you define your own free function, then you must - ensure that you call the underlying C++ object's destructor. In - addition, if object tracking is activated for the object's class, you - must also call the SWIG_RubyRemoveTracking function (of course - call this before you destroy the C++ object). Note that it is harmless - to call this method if object tracking if off so it is advised to - always call it.

    -

    Note there is a subtle interaction between object ownership and free - functions. A custom defined free function will only be called if the - Ruby object owns the underlying C++ object. This also to Ruby objects - which are created, but then transfer ownership to C++ objects via the - use of the disown typemap described above.

    -

    To show how to use the %freefunc directive, let's slightly - change our example. Assume that the zoo object is responsible for - freeing animal that it contains. This means that the -Zoo::add_animal function should be marked with a DISOWN - typemap and the destructor should be updated as below:

    +
    +
    +--> absolute([-0 1 -2; 3 4 -5])
    + ans  =
    +
    +    0.    1.    2.
    +    3.    4.    5.
    +
    +
    +

    The remarks made earlier for arrays also apply here:

    +
      +
    • The values of matrices in Scilab are column-major orderered,
    • +
    • There is no control while converting double values to + integers, double values are truncated without any checking or + warning.
    • +
    +

    39.4.5 STL

    +

    The STL library wraps some containers defined in the STL (Standard + Template Library), so that they can be manipulated in Scilab. This + library also provides the appropriate typemaps to use the containers in + functions and variables.

    +

    The list of wrapped sequence containers are:

    +
      +
    • std::vector
    • +
    • std::list
    • +
    • std::deque
    • +
    +

    And associative containers are:

    +
      +
    • std::set
    • +
    • std::multiset
    • +
    +

    Typemaps are available for the following container types:

    +
      +
    • double
    • +
    • float
    • +
    • int
    • +
    • string
    • +
    • bool
    • +
    • pointer
    • +
    +

    Containers of other item types are not supported. Using them does + not break compilation, but provokes a runtime error. Containers of enum + are not supported yet.

    +

    In order to use the STL, the library must first be included in the + SWIG interface file:

    +
    +
    +%include <stl.i>
    +
    +
    +

    Then for each container used, the appropriate template must be + instantiated, in the std namespace:

    +
    +namespace std {
    +    %template(IntVector)    vector<int>;
    +    %template(DoubleVector) vector<double>;
    +}
    +
    +

    +

    Additionally, the module initialization function has to be executed + first in Scilab, so that all the types are known to Scilab. See the +Module initialization section for more details.

    +

    Because in Scilab matrices exist for basic types only, a sequence + container of pointers is mapped to a Scilab list. For other item types + (double, int, string...) the sequence container is mapped to a Scilab + matrix.

    +

    The first example below shows how to create a vector (of int +) in Scilab, add some values to the vector and pass it as an argument of + a function. It also shows, thanks to the typemaps, that we can also + pass a Scilab matrix of values directly into the function:

    -
    Zoo::~Zoo() {
    - IterType iter = this->animals.begin();
    - IterType end = this->animals.end();
    +
    +%module example
     
    - for(iter; iter != end; ++iter) {
    - Animal* animal = *iter;
    - delete animal;
    - }
    -}
    +%include <stl.i> + +namespace std { + %template(IntVector) vector<int>; +} + +%{ +#include <numeric> +%} + +%inline %{ + +double average(std::vector<int> v) { + return std::accumulate(v.begin(), v.end(), 0.0) / v.size(); +} + +%} +
    -

    When we use these objects in IRB we see:

    -
    -
    $irb
    -irb(main):002:0> require 'example'
    -=> true
    +
    +
    +--> example_Init();
     
    -irb(main):003:0> zoo = Example::Zoo.new()
    -=> #<Example::Zoo:0x2be0fe8>
    +--> v = new_IntVector();
     
    -irb(main):005:0> tiger1 = Example::Animal.new("tiger1")
    -=> #<Example::Animal:0x2bda760>
    +--> for i = 1:4
    +-->     IntVector_push_back(v, i);
    +--> end;
     
    -irb(main):006:0> zoo.add_animal(tiger1)
    -=> nil
    +--> average(v)
    + ans  =
     
    -irb(main):007:0> zoo = nil
    -=> nil
    +    2.5
     
    -irb(main):008:0> GC.start
    -=> nil
    +--> average([0 1 2 3])
    + ans  =
     
    -irb(main):009:0> tiger1.get_name()
    -(irb):12: [BUG] Segmentation fault
    +    2.5
    +
    +--> delete_IntVector();
     
    -

    The error happens because the C++ animal object is freed - when the zoo object is freed. Although this error is - unavoidable, we can at least prevent the segmentation fault. To do this - requires enabling object tracking and implementing a custom free - function that calls the SWIG_RubyUnlinkObjects function for - each animal object that is destroyed. The SWIG_RubyUnlinkObjects - function notifies SWIG that a Ruby object's underlying C++ object is no - longer valid. Once notified, SWIG will intercept any calls from the - existing Ruby object to the destroyed C++ object and raise an - exception.

    +

    In the second example, a set of struct (Person) is wrapped. + A function performs a search in this set, and returns a subset. As one + can see, the result in Scilab is a list of pointers:

    -
    %module example
    +
    +%module example
    +
    +%include <stl.i>
     
     %{
    -#include "example.h"
    +#include <string>
     %}
     
    -/* Specify that ownership is transferred to the zoo
    -	when calling add_animal */
    -%apply SWIGTYPE *DISOWN { Animal* animal };
    +%inline %{
     
    -/* Track objects */
    -%trackobjects;
    +struct Person {
    +  Person(std::string _name, int _age) : name(_name), age(_age) {};
    +  std::string name;
    +  int age;
    +};
    +typedef Person * PersonPtr;
     
    -/* Specify the mark function */
    -%freefunc Zoo "free_Zoo";
    +%}
     
    -%include "example.h"
    +namespace std {
    +  %template(PersonPtrSet) set<PersonPtr>;
    +}
     
    -%header %{
    -  static void free_Zoo(void* ptr) {
    -    Zoo* zoo = (Zoo*) ptr;
    +%inline %{
     
    -    /* Loop over each animal */
    -    int count = zoo->get_num_animals();
    +std::set<PersonPtr> findPersonsByAge(std::set<PersonPtr> persons, int minAge, int maxAge) {
    +  std::set<PersonPtr> foundPersons;
    +  for (std::set<PersonPtr>::iterator it = persons.begin(); it != persons.end(); it++) {
    +    if (((*it)->age >= minAge) && ((*it)->age <= maxAge)) {
    +      foundPersons.insert(*it);
    +    }
    +  }
    +  return foundPersons;
    +}
     
    -    for(int i = 0; i < count; ++i) {
    -      /* Get an animal */
    -      Animal* animal = zoo->get_animal(i);
    +%}
    +
    +
    +
    +
    +--> example_Init();
     
    -      /* Unlink the Ruby object from the C++ object */
    -      SWIG_RubyUnlinkObjects(animal);
    +--> joe = new_Person("Joe", 25);
    +--> susan = new_Person("Susan", 32);
    +--> bill = new_Person("Bill", 50);
     
    -      /* Now remove the tracking for this animal */
    -      SWIG_RubyRemoveTracking(animal);
    -    }
    +--> p = new_PersonPtrSet();
    +--> PersonPtrSet_insert(p, susan);
    +--> PersonPtrSet_insert(p, joe);
    +--> PersonPtrSet_insert(p, bill);
     
    -    /* Now call SWIG_RubyRemoveTracking for the zoo */
    -    SWIG_RubyRemoveTracking(ptr);
    -    /* Now free the zoo which will free the animals it contains */
    -    delete zoo;
    -  }
    -%} 
    -
    -

    Now when we use these objects in IRB we see:

    -
    -
    $irb
    -irb(main):002:0> require 'example'
    -=> true
    +--> l = findPersonsByAge(p, 20, 40);
     
    -irb(main):003:0> zoo = Example::Zoo.new()
    -=> #<Example::Zoo:0x2be0fe8>
    +--> size(l)
    + ans  =
     
    -irb(main):005:0> tiger1 = Example::Animal.new("tiger1")
    -=> #<Example::Animal:0x2bda760>
    +    2.
     
    -irb(main):006:0> zoo.add_animal(tiger1)
    -=> nil
    +--> Person_name_get(l(1))
    +ans  =
     
    -irb(main):007:0> zoo = nil
    -=> nil
    +    Susan
     
    -irb(main):008:0> GC.start
    -=> nil
    +--> Person_name_get(l(2))
    + ans  =
     
    -irb(main):009:0> tiger1.get_name()
    -RuntimeError: This Animal * already released
    - from (irb):10:in `get_name'
    - from (irb):10
    -irb(main):011:0>
    + Joe + +--> delete_PersonPtrSet(p); +
    -

    Notice that SWIG can now detect the underlying C++ object has been - freed, and thus raises a runtime exception.

    -

    This code can be seen in swig/examples/ruby/free_function.

    -

    36.10.6 Embedded Ruby and the C++ Stack

    -

    As has been said, the Ruby GC runs and marks objects before its sweep - phase. When the garbage collector is called, it will also try to mark - any Ruby objects (VALUE) it finds in the machine registers and in the - C++ stack.

    -

    The stack is basically the history of the functions that have been - called and also contains local variables, such as the ones you define - whenever you do inside a function:

    -
    VALUE obj;
    -

    For ruby to determine where its stack space begins, during - initialization a normal Ruby interpreter will call the ruby_init() - function which in turn will call a function called Init_stack or - similar. This function will store a pointer to the location where the - stack points at that point in time.

    -

    ruby_init() is presumed to always be called within the main() - function of your program and whenever the GC is called, ruby will - assume that the memory between the current location in memory and the - pointer that was stored previously represents the stack, which may - contain local (and temporary) VALUE ruby objects. Ruby will then be - careful not to remove any of those objects in that location.

    -

    So far so good. For a normal Ruby session, all the above is - completely transparent and magic to the extensions developer.

    -

    However, with an embedded Ruby, it may not always be possible to - modify main() to make sure ruby_init() is called there. As such, - ruby_init() will likely end up being called from within some other - function. This can lead Ruby to measure incorrectly where the stack - begins and can result in Ruby incorrectly collecting those temporary - VALUE objects that are created once another function is called. The end - result: random crashes and segmentation faults.

    -

    This problem will often be seen in director functions that are used - for callbacks, for example.

    -

    To solve the problem, SWIG can now generate code with director - functions containing the optional macros SWIG_INIT_STACK and - SWIG_RELEASE_STACK. These macros will try to force Ruby to reinitiliaze - the beginning of the stack the first time a director function is - called. This will lead Ruby to measure and not collect any VALUE - objects defined from that point on.

    -

    To mark functions to either reset the ruby stack or not, you can use:

    -
    +

    39.5 Module initialization +

    +

    The wrapped module contains an initialization function to:

    +
      +
    • initialize the SWIG runtime, needed for pointer type tracking or + when working with the STL
    • +
    • initialize the module constants and enumerations declared with +%scilabconst()
    • +
    +

    This initialization function should be executed at the start of a + script, before the wrapped library has to be used.

    +

    The function has the name of the module suffixed by _Init. + For example, to initialize the module example:

    +
    -%initstack Class::memberfunction;   // only re-init the stack in this director method
    -%ignorestack Class::memberfunction; // do not re-init the stack in this director method
    -%initstack Class;                   // init the stack on all the methods of this class
    -%initstack;                         // all director functions will re-init the stack
    +--> example_Init();
     
    -

    -

    37 SWIG and Tcl

    +
    +

    39.6 Building modes

    +

    The mechanism to load an external module in Scilab is called + Dynamic Link and works with dynamic modules (or shared libraries, +.so files).

    +

    To produce a dynamic module, when generating the wrapper, there are + two possibilities, or build modes:

    +
      +
    • the nobuilder mode, this is the default mode in SWIG. The + user is responsible of the build.
    • +
    • the builder mode. In this mode, Scilab is responsible of + building.
    • +
    +

    39.6.1 No-builder + mode

    +

    In this mode, used by default, SWIG generates the wrapper sources, + which have to be manually compiled and linked. A loader script +loader.sce is also produced, this one is executed further in Scilab + to load the module.

    +

    This mode is the best option to use when you have to integrate the + module build into a larger build process.

    +

    39.6.2 Builder mode

    +

    In this mode, in addition to the wrapper sources, SWIG produces a + builder Scilab script (builder.sce), which is executed in + Scilab to build the module. In a few words, the Scilab ilib_build() + command is used, which produces the shared library file, and the loader + script loader.sce (and also a cleaner script cleaner.sce +).

    +

    An advantage of this mode is that it hides all the complexity of the + build and other platform issues. Also it allows the module to conform + to a Scilab external module convention which is that an external module + should be simply built by calling a builder script.

    +

    The builder mode is activated with the -builder SWIG + option. In this mode, the following SWIG options may be used to setup + the build:

    +
      +
    • -buildersources: to add sources to the build + (several files must be separated by a comma)
    • +
    • -buildercflags: to add flags to the builder compiler + flags, for example to set library dependencies include paths
    • +
    • -builderldflags: to add flags to the linker flags, + for example to set library dependency names and paths
    • +
    +

    Let's give an example how to build a module example, + composed of two sources, and using a library dependency:

    +
      +
    • the sources are baa1.c and baa2.c (and are stored + in in the current directory)
    • +
    • the library is libfoo in /opt/foo (headers stored + in /opt/foo/include, and shared library in /opt/foo/lib +)
    • +
    +

    The command is:

    +
    +
    +$ swig -scilab -builder -buildercflags -I/opt/foo/include -builderldflags "-L/opt/foo/lib -lfoo" -buildersources baa1.cxx,baa2.cxx example.i
    +
    +
    +

    39.7 Generated scripts

    +

    In this part we give some details about the generated Scilab + scripts.

    +

    39.7.1 Builder + script

    +

    builder.sce is the name of the builder script generated by + SWIG in builder mode. It contains code like this:

    +
    +
    +ilib_name = "examplelib";
    +files = ["example_wrap.c"];
    +libs = [];
    +table = ["fact","_wrap_fact";"Foo_set","_wrap_Foo_set";"Foo_get","_wrap_Foo_get";];
    +ilib_build(ilib_name,table,files,libs);
    +
    +
    +

    ilib_build(lib_name,table,files,libs) is used to create + shared libraries, and to generate a loader file used to dynamically + load the shared library into Scilab.

    +
      +
    • ilib_name: a character string, the generic name of + the library without path and extension.
    • +
    • files: string matrix containing objects files needed + for shared library creation.
    • +
    • libs: string matrix containing extra libraries + needed for shared library creation.
    • +
    • table: two column string matrix containing a table + of pairs of 'scilab function name', 'C function name'.
    • +
    +

    39.7.2 Loader + script

    +

    The loader script is used to load in Scilab all the module + functions. When loaded, these functions can be used as other Scilab + functions.

    +

    The loader script loader.sce contains code similar to:

    +
    +
    +// ------------------------------------------------------
    +// generated by builder.sce: Please do not edit this file
    +// ------------------------------------------------------
    +
    +libexamplelib_path = get_file_path('loader.sce');
    +list_functions = [             'fact';
    +            'Foo_set';
    +            'Foo_get';
    +];
    +addinter(libexamplelib_path+'/libexamplelib.so','libexamplelib',list_functions);
    +// remove temp. variables on stack
    +clear libexamplelib_path;
    +clear list_functions;
    +clear get_file_path;
    +// ------------------------------------------------------
    +
    +
    +

    addinter(files,spname,fcts) performs dynamic linking of a + compiled C interface function.

    +
      +
    • files: a character string or a vector of character + strings defining the object files (containing the C interface + functions) to link with.
    • +
    • spname: a character string. Name of interface + routine entry point.
    • +
    • fcts: vector of character strings. The name of new + Scilab function.
    • +
    +

    39.8 Other resources

    +
      +
    • Example use cases can be found in the Examples/scilab + directory.
    • +
    • The test suite in the Examples/test-suite/scilab can be + another source of useful use cases.
    • +
    • The +Scilab API is used in the generated code and is a useful reference + when examining the output.
    • +
    • This +guide describes the Scilab external modules structure and files, in + particular the files that are generated by SWIG for Scilab.
    • +
    +
    +

    40 SWIG and Tcl

    @@ -49173,7 +56500,7 @@ irb(main):011:0>

    This chapter discusses SWIG's support of Tcl. SWIG currently requires Tcl 8.0 or a later release. Earlier releases of SWIG supported Tcl 7.x, but this is no longer supported.

    -

    37.1 Preliminaries

    +

    40.1 Preliminaries

    To build a Tcl module, run SWIG using the -tcl option :

    @@ -49190,7 +56517,7 @@ $ swig -c++ -tcl example.i
      that contains all of the code needed to build a Tcl extension module.
      To finish building the module, you need to compile this file and link
      it with the rest of your program.

    -

    37.1.1 Getting the right header files

    +

    40.1.1 Getting the right header files

    In order to compile the wrapper code, the compiler needs the tcl.h header file. This file is usually contained in the directory

    @@ -49202,7 +56529,7 @@ tcl.h header file. This file is usually contained in the directory

    version number attached to it. If this is the case, you should probably make a symbolic link so that tcl.h points to the correct header file.

    -

    37.1.2 Compiling a dynamic module

    +

    40.1.2 Compiling a dynamic module

    The preferred approach to building an extension module is to compile it into a shared object file or DLL. Assuming you have code you need to link to in a file called example.c, you will need to compile @@ -49210,8 +56537,8 @@ tcl.h header file. This file is usually contained in the directory

     $ swig -tcl example.i
    -$ gcc -c example.c
    -$ gcc -c example_wrap.c -I/usr/local/include
    +$ gcc -fPIC -c example.c
    +$ gcc -fPIC -c example_wrap.c -I/usr/local/include
     $ gcc -shared example.o example_wrap.o -o example.so
     
    @@ -49227,7 +56554,7 @@ SWIG Wiki for additional information.

    ", the name of the corresponding object file should be "example.so ". The name of the module is specified using the %module directive or the -module command line option.

    -

    37.1.3 Static linking

    +

    40.1.3 Static linking

    An alternative approach to dynamic linking is to rebuild the Tcl interpreter with your extension module added to it. In the past, this approach was sometimes necessary due to limitations in dynamic loading @@ -49262,8 +56589,8 @@ $ swig -tcl example.i $ gcc example.c example_wrap.c \ -Xlinker -export-dynamic \ -DHAVE_CONFIG_H -I/usr/local/include/ \ - -L/usr/local/lib -ltcl -lm -ldl \ - -o mytclsh + -L/usr/local/lib -ltcl -lm -ldl \ + -o mytclsh

    @@ -49279,7 +56606,7 @@ $ gcc example.c example_wrap.c \ performance gained by static linking tends to be rather minimal in most situations (and quite frankly not worth the extra hassle in the opinion of this author).

    -

    37.1.4 Using your module

    +

    40.1.4 Using your module

    To use your module, simply use the Tcl load command. If all goes well, you will be able to this:

    @@ -49371,7 +56698,7 @@ $ env LD_LIBRARY_PATH=/home/beazley/projects/lib tclsh

    Finally, you can use a command such as ldconfig to add additional search paths to the default system configuration (this requires root access and you will need to read the man pages).

    -

    37.1.5 Compilation of C++ extensions

    +

    40.1.5 Compilation of C++ extensions

    Compilation of C++ extensions has traditionally been a tricky problem. Since the Tcl interpreter is written in C, you need to take steps to make sure C++ is properly initialized and that modules are @@ -49381,8 +56708,8 @@ $ env LD_LIBRARY_PATH=/home/beazley/projects/lib tclsh

     % swig -c++ -tcl example.i
    -% g++ -c example.cxx
    -% g++ -c example_wrap.cxx -I/usr/local/include
    +% g++ -fPIC -c example.cxx
    +% g++ -fPIC -c example_wrap.cxx -I/usr/local/include
     % g++ -shared example.o example_wrap.o -o example.so
     
    @@ -49393,8 +56720,8 @@ $ env LD_LIBRARY_PATH=/home/beazley/projects/lib tclsh
     % swig -c++ -tcl example.i
    -% CC -c example.cxx
    -% CC -c example_wrap.cxx -I/usr/local/include
    +% CC -KPIC -c example.cxx
    +% CC -KPIC -c example_wrap.cxx -I/usr/local/include
     % CC -G example.o example_wrap.o -L/opt/SUNWspro/lib -o example.so -lCrun
     
    @@ -49434,7 +56761,7 @@ $ you will need to take steps to avoid segmentation faults and other erratic program behavior. If working with lots of software components, you might want to investigate using a more formal standard such as COM.

    -

    37.1.6 Compiling for 64-bit platforms

    +

    40.1.6 Compiling for 64-bit platforms

    On platforms that support 64-bit applications (Solaris, Irix, etc.), special care is required when building extension modules. On these machines, 64-bit applications are compiled and linked using a different @@ -49451,7 +56778,7 @@ $ that software. This may prevent the use of 64-bit extensions. It may also introduce problems on platforms that support more than one linking standard (e.g., -o32 and -n32 on Irix).

    -

    37.1.7 Setting a package prefix

    +

    40.1.7 Setting a package prefix

    To avoid namespace problems, you can instruct SWIG to append a package prefix to all of your functions and variables. This is done using the -prefix option as follows :

    @@ -49463,7 +56790,7 @@ swig -tcl -prefix Foo example.i

    If you have a function "bar" in the SWIG file, the prefix option will append the prefix to the name when creating a command and call it "Foo_bar".

    -

    37.1.8 Using namespaces

    +

    40.1.8 Using namespaces

    Alternatively, you can have SWIG install your module into a Tcl namespace by specifying the -namespace option :

    @@ -49475,14 +56802,14 @@ swig -tcl -namespace example.i name, but you can override it using the -prefix option.

    When the -namespace option is used, objects in the module are always accessed with the namespace name such as Foo::bar.

    -

    37.2 Building Tcl/Tk Extensions under Windows - 95/NT

    +

    40.2 Building Tcl/Tk Extensions under Windows + 95/NT

    Building a SWIG extension to Tcl/Tk under Windows 95/NT is roughly similar to the process used with Unix. Normally, you will want to produce a DLL that can be loaded into tclsh or wish. This section covers the process of using SWIG with Microsoft Visual C++. although the procedure may be similar with other compilers.

    -

    37.2.1 Running SWIG from Developer Studio

    +

    40.2.1 Running SWIG from Developer Studio

    If you are developing your application within Microsoft developer studio, SWIG can be invoked as a custom build option. The process roughly follows these steps :

    @@ -49525,7 +56852,7 @@ MSDOS > tclsh80 %
    -

    37.2.2 Using NMAKE

    +

    40.2.2 Using NMAKE

    Alternatively, SWIG extensions can be built by writing a Makefile for NMAKE. To do this, make sure the environment variables for MSVC++ are available and the MSVC++ tools are in your path. Now, just write a @@ -49569,11 +56896,11 @@ CFLAGS = /Z7 /Od /c /nologo TCL_INCLUDES = -Id:\tcl8.0a2\generic -Id:\tcl8.0a2\win TCLLIB = d:\tcl8.0a2\win\tcl80.lib -tcl:: - ..\..\swig -tcl -o $(WRAPFILE) $(INTERFACE) - $(CC) $(CFLAGS) $(TCL_INCLUDES) $(SRCS) $(WRAPFILE) - set LIB=$(TOOLS)\lib - $(LINK) $(LOPT) -out:example.dll $(LIBS) $(TCLLIB) example.obj example_wrap.obj +tcl: + ..\..\swig -tcl -o $(WRAPFILE) $(INTERFACE) + $(CC) $(CFLAGS) $(TCL_INCLUDES) $(SRCS) $(WRAPFILE) + set LIB=$(TOOLS)\lib + $(LINK) $(LOPT) -out:example.dll $(LIBS) $(TCLLIB) example.obj example_wrap.obj

    @@ -49581,13 +56908,13 @@ tcl:: first). This is a pretty minimal Makefile, but hopefully its enough to get you started. With a little practice, you'll be making lots of Tcl extensions.

    -

    37.3 A tour of basic C/C++ wrapping

    +

    40.3 A tour of basic C/C++ wrapping

    By default, SWIG tries to build a very natural Tcl interface to your C/C++ code. Functions are wrapped as functions, classes are wrapped in an interface that mimics the style of Tk widgets and [incr Tcl] classes. This section briefly covers the essential aspects of this wrapping.

    -

    37.3.1 Modules

    +

    40.3.1 Modules

    The SWIG %module directive specifies the name of the Tcl module. If you specify `%module example', then everything is compiled into an extension module example.so. When choosing a @@ -49608,7 +56935,7 @@ couldn't find procedure Md_Init % load ./md5.so md5

    -

    37.3.2 Functions

    +

    40.3.2 Functions

    Global functions are wrapped as new Tcl built-in commands. For example,

    @@ -49628,7 +56955,7 @@ int fact(int n); %
    -

    37.3.3 Global variables

    +

    40.3.3 Global variables

    C/C++ global variables are wrapped by Tcl global variables. For example:

    @@ -49689,7 +57016,7 @@ extern char *path; extern char *path; // Read-only (due to %immutable)
    -

    37.3.4 Constants and enums

    +

    40.3.4 Constants and enums

    C/C++ constants are installed as global Tcl variables containing the appropriate value. To create a constant, use #define, enum , or the %constant directive. For example:

    @@ -49751,7 +57078,7 @@ proc blah {} {

    When an identifier name is given, it is used to perform an implicit hash-table lookup of the value during argument conversion. This allows the global statement to be omitted.

    -

    37.3.5 Pointers

    +

    40.3.5 Pointers

    C/C++ pointers are fully supported by SWIG. Furthermore, SWIG has no problem working with incomplete type information. Here is a rather simple interface:

    @@ -49822,14 +57149,14 @@ Foo *IncrFoo(Foo *f, int i) { style casts. For example, in the above code, the C-style cast may return a bogus result whereas as the C++-style cast will return None if the conversion can't be performed.

    -

    37.3.6 Structures

    +

    40.3.6 Structures

    If you wrap a C structure, it is wrapped by a Tcl interface that somewhat resembles a Tk widget. This provides a very natural interface. For example,

     struct Vector {
    -	double x,y,z;
    +  double x,y,z;
     };
     
     
    @@ -50028,7 +57355,7 @@ _108fea88_p_Bar

    Note: Tcl only destroys the underlying object if it has ownership. See the memory management section that appears shortly.

    -

    37.3.7 C++ classes

    +

    40.3.7 C++ classes

    C++ classes are wrapped as an extension of structure wrapping. For example, if you have this class,

    @@ -50054,7 +57381,7 @@ public: % x insert Lager % x get 1 Stout -% puts [l cget -length] +% puts [x cget -length] 3 % @@ -50079,7 +57406,7 @@ public: % puts $Spam_bar # Spam::bar
    -

    37.3.8 C++ inheritance

    +

    40.3.8 C++ inheritance

    SWIG is fully aware of issues related to C++ inheritance. Therefore, if you have classes like this

    @@ -50111,8 +57438,8 @@ void spam(Foo *f);

    It is safe to use multiple inheritance with SWIG.

    -

    37.3.9 Pointers, references, values, and - arrays

    +

    40.3.9 Pointers, references, values, and arrays +

    In C++, there are many different ways a function might receive and manipulate objects. For example:

    @@ -50150,7 +57477,7 @@ Foo spam7(); allocated memory is used to hold the result and a pointer is returned (Tcl will release this memory when the return value is garbage collected).

    -

    37.3.10 C++ overloaded functions

    +

    40.3.10 C++ overloaded functions

    C++ overloaded functions, methods, and constructors are mostly supported by SWIG. For example, if you have two functions like this:

    @@ -50233,7 +57560,7 @@ void spam(short); // Ignored arises--in this case, the first declaration takes precedence.

    Please refer to the "SWIG and C++" chapter for more information about overloading.

    -

    37.3.11 C++ operators

    +

    40.3.11 C++ operators

    Certain C++ overloaded operators can be handled automatically by SWIG. For example, consider a class like this:

    @@ -50312,7 +57639,7 @@ Complex operator+(double, const Complex &c);

    There are ways to make this operator appear as part of the class using the %extend directive. Keep reading.

    -

    37.3.12 C++ namespaces

    +

    40.3.12 C++ namespaces

    SWIG is aware of C++ namespaces, but namespace names do not appear in the module nor do namespaces result in a module that is broken up into submodules or packages. For example, if you have a file like this,

    @@ -50359,7 +57686,7 @@ namespace Bar { extension modules for each namespace separately. If your program utilizes thousands of small deeply nested namespaces each with identical symbol names, well, then you get what you deserve.

    -

    37.3.13 C++ templates

    +

    40.3.13 C++ templates

    C++ templates don't present a huge problem for SWIG. However, in order to create wrappers, you have to tell SWIG to create wrappers for a particular template instantiation. To do this, you use the @@ -50398,7 +57725,7 @@ struct pair {

    Obviously, there is more to template wrapping than shown in this example. More details can be found in the SWIG and C++ chapter. Some more complicated examples will appear later.

    -

    37.3.14 C++ Smart Pointers

    +

    40.3.14 C++ Smart Pointers

    In certain C++ programs, it is common to use classes that have been wrapped by so-called "smart pointers." Generally, this involves the use of a template class that implements operator->() like this:

    @@ -50457,8 +57784,8 @@ operator->()
    itself, simply use the __deref__() method. % set f [$p __deref__] # Returns underlying Foo *
    -

    37.4 Further details on the Tcl class - interface

    +

    40.4 Further details on the Tcl class interface +

    In the previous section, a high-level view of Tcl wrapping was presented. A key component of this wrapping is that structures and classes are wrapped by Tcl class-like objects. This provides a very @@ -50466,7 +57793,7 @@ operator->() itself, simply use the __deref__() method. features such as operator overloading. However, a number of low-level details were omitted. This section provides a brief overview of how the proxy classes work.

    -

    37.4.1 Proxy classes

    +

    40.4.1 Proxy classes

    In the "SWIG basics" and "SWIG and C++" chapters, details of low-level structure and class wrapping are described. To summarize those chapters, if you have a @@ -50517,7 +57844,7 @@ int Foo_spam(Foo *f, int arg1) {

    However, in addition to this, the classname Foo is used as an object constructor function. This allows objects to be encapsulated objects that look a lot like Tk widgets as shown in the last section.

    -

    37.4.2 Memory management

    +

    40.4.2 Memory management

    Associated with each wrapped object, is an ownership flag thisown The value of this flag determines who is responsible for deleting the underlying C++ object. If set to 1, the Tcl interpreter @@ -50658,7 +57985,7 @@ public:

    It is also possible to deal with situations like this using typemaps--an advanced topic discussed later.

    -

    37.5 Input and output parameters

    +

    40.5 Input and output parameters

    A common problem in some C programs is handling parameters passed as simple pointers. For example:

    @@ -50791,7 +58118,7 @@ set r [lindex $dim 0] set c [lindex $dim 1]
    -

    37.6 Exception handling

    +

    40.6 Exception handling

    The %exception directive can be used to create a user-definable exception handler in charge of converting exceptions in your C/C++ program into Tcl exceptions. The chapter on customization @@ -50849,7 +58176,7 @@ class DoubleArray { $action // Gets substituted by actual function call } catch (RangeError) { - Tcl_SetStringObj(tcl_result,"Array index out-of-bounds"); + Tcl_SetResult(interp, (char *)"Array index out-of-bounds", TCL_STATIC); return TCL_ERROR; } } @@ -50866,7 +58193,7 @@ class DoubleArray { $action } catch (RangeError) { - Tcl_SetStringObj(tcl_result,"Array index out-of-bounds"); + Tcl_SetResult(interp, (char *)"Array index out-of-bounds", TCL_STATIC); return TCL_ERROR; } } @@ -50876,7 +58203,7 @@ class DoubleArray { $action } catch (RangeError) { - Tcl_SetStringObj(tcl_result,"Array index out-of-bounds"); + Tcl_SetResult(interp, (char *)"Array index out-of-bounds", TCL_STATIC); return TCL_ERROR; } } @@ -50894,7 +58221,7 @@ class DoubleArray { $action } catch (RangeError) { - Tcl_SetStringObj(tcl_result,"Array index out-of-bounds"); + Tcl_SetResult(interp, (char *)"Array index out-of-bounds", TCL_STATIC); return TCL_ERROR; } } @@ -50907,7 +58234,7 @@ class DoubleArray {

    Since SWIG's exception handling is user-definable, you are not limited to C++ exception handling. See the chapter on " Customization Features" for more examples.

    -

    37.7 Typemaps

    +

    40.7 Typemaps

    This section describes how you can modify SWIG's default wrapping behavior for various C/C++ datatypes using the %typemap directive. This is an advanced topic that assumes familiarity with the @@ -50917,7 +58244,7 @@ Customization Features" for more examples.

    required part of using SWIG---the default wrapping behavior is enough in most cases. Typemaps are only used if you want to change some aspect of the primitive C-Tcl interface.

    -

    37.7.1 What is a typemap?

    +

    40.7.1 What is a typemap?

    A typemap is nothing more than a code generation rule that is attached to a specific C datatype. For example, to convert integers from Tcl to C, you might define a typemap like this:

    @@ -50926,8 +58253,9 @@ Customization Features" for more examples.

    %module example %typemap(in) int { - if (Tcl_GetIntFromObj(interp,$input,&$1) == TCL_ERROR) return TCL_ERROR; - printf("Received an integer : %d\n",$1); + if (Tcl_GetIntFromObj(interp,$input,&$1) == TCL_ERROR) + return TCL_ERROR; + printf("Received an integer : %d\n",$1); } %inline %{ extern int fact(int n); @@ -50960,8 +58288,9 @@ int datatype. You can refine this by supplying an optional %module example %typemap(in) int n { - if (Tcl_GetIntFromObj(interp,$input,&$1) == TCL_ERROR) return TCL_ERROR; - printf("n = %d\n",$1); + if (Tcl_GetIntFromObj(interp,$input,&$1) == TCL_ERROR) + return TCL_ERROR; + printf("n = %d\n",$1); } %inline %{ extern int fact(int n); @@ -50979,8 +58308,9 @@ typedef declarations. For example:

     %typemap(in) int n {
    -        if (Tcl_GetIntFromObj(interp,$input,&$1) == TCL_ERROR) return TCL_ERROR;
    -	printf("n = %d\n",$1);
    +  if (Tcl_GetIntFromObj(interp,$input,&$1) == TCL_ERROR)
    +    return TCL_ERROR;
    +  printf("n = %d\n",$1);
     }
     %inline %{
     typedef int Integer;
    @@ -51011,7 +58341,7 @@ int count(char c, char *str, int len);
     1
     
    -

    37.7.2 Tcl typemaps

    +

    40.7.2 Tcl typemaps

    The previous section illustrated an "in" typemap for converting Tcl objects to C. A variety of different typemap methods are defined by the Tcl module. For example, to convert a C integer back into a Tcl object, @@ -51057,7 +58387,7 @@ int count(char c, char *str, int len);

    Initialize an argument to a value before any conversions occur.

    Examples of these methods will appear shortly.

    -

    37.7.3 Typemap variables

    +

    40.7.3 Typemap variables

    Within typemap code, a number of special variables prefaced with a $ may appear. A full list of variables can be found in the " Typemaps" chapter. This is a list of the most common variables:

    @@ -51086,7 +58416,7 @@ Typemaps" chapter. This is a list of the most common variables:

    their values can be properly assigned.

    $symname

    The Tcl name of the wrapper function being created.
    -

    37.7.4 Converting a Tcl list to a char **

    +

    40.7.4 Converting a Tcl list to a char **

    A common problem in many C programs is the processing of command line arguments, which are usually passed in an array of NULL terminated strings. The following SWIG interface file allows a Tcl list to be used @@ -51142,7 +58472,7 @@ argv[2] = Larry 3

    -

    37.7.5 Returning values in arguments

    +

    40.7.5 Returning values in arguments

    The "argout" typemap can be used to return a value originating from a function argument. For example :

    @@ -51178,7 +58508,7 @@ double *outvalue" argument. The numinputs=0 specification tells %
    -

    37.7.6 Useful functions

    +

    40.7.6 Useful functions

    The following tables provide some functions that may be useful in writing Tcl typemaps.

    Integers

    @@ -51201,7 +58531,6 @@ int Tcl_GetDoubleFromObj(Tcl_Interp *, Tcl_Obj *o, double *dp);
     Tcl_Obj  *Tcl_NewStringObj(char *str, int len);
    -void      Tcl_SetStringObj(Tcl_Obj *obj, char *str, int len);
     char     *Tcl_GetStringFromObj(Tcl_Obj *obj, int *len);
     void      Tcl_AppendToObj(Tcl_Obj *obj, char *str, int len);
     
    @@ -51230,7 +58559,7 @@ void Tcl_DecrRefCount(Tcl_Obj *obj); int Tcl_IsShared(Tcl_Obj *obj);
    -

    37.7.7 Standard typemaps

    +

    40.7.7 Standard typemaps

    The following typemaps show how to convert a few common kinds of objects between Tcl and C (and to give a better idea of how typemaps work)

    @@ -51238,10 +58567,10 @@ int Tcl_IsShared(Tcl_Obj *obj);
     %typemap(in) int, short, long {
    -   int temp;
    -   if (Tcl_GetIntFromObj(interp, $input, &temp) == TCL_ERROR)
    -      return TCL_ERROR;
    -   $1 = ($1_ltype) temp;
    +  int temp;
    +  if (Tcl_GetIntFromObj(interp, $input, &temp) == TCL_ERROR)
    +    return TCL_ERROR;
    +  $1 = ($1_ltype) temp;
     }
     
    @@ -51282,12 +58611,13 @@ int Tcl_IsShared(Tcl_Obj *obj);

    -%typemap(out) char * {
    -   Tcl_SetStringObj($result,$1);
    +%typemap(out,noblock=1,fragment="SWIG_FromCharPtr") char *, const char * {
    +  Tcl_SetObjResult(interp,SWIG_FromCharPtr((const char *)$1));
     }
    +
     
    -

    37.7.8 Pointer handling

    +

    40.7.8 Pointer handling

    SWIG pointers are mapped into Tcl strings containing the hexadecimal value and type. The following functions can be used to create and read pointer values.

    @@ -51338,8 +58668,8 @@ $descriptor() macro in a typemap. For example:

    }
    -

    37.8 Turning a SWIG module into a Tcl - Package.

    +

    40.8 Turning a SWIG module into a Tcl Package. +

    Tcl 7.4 introduced the idea of an extension package. By default, SWIG generates all of the code necessary to create a package. To set the package version, simply use the -pkgversion option. For @@ -51364,8 +58694,8 @@ unix > tclsh

     ./example/
    -	   pkgIndex.tcl           # The file created by pkg_mkIndex
    -	   example.so             # The SWIG generated module
    +           pkgIndex.tcl           # The file created by pkg_mkIndex
    +           example.so             # The SWIG generated module
     

    Finally, assuming that you're not entirely confused at this point, @@ -51395,8 +58725,8 @@ unix > tclsh

    As a final note, most SWIG examples do not yet use the package commands. For simple extensions it may be easier just to use the load command instead.

    -

    37.9 Building new kinds of Tcl interfaces (in - Tcl)

    +

    40.9 Building new kinds of Tcl interfaces (in + Tcl)

    One of the most interesting aspects of Tcl and SWIG is that you can create entirely new kinds of Tcl interfaces in Tcl using the low-level SWIG accessor functions. For example, suppose you had a library of @@ -51461,14 +58791,14 @@ proc Array {type size} {

     set a [Array double 100]                   ;# Create a double [100]
     for {set i 0} {$i < 100} {incr i 1} {      ;# Clear the array
    -	$a set $i 0.0
    +        $a set $i 0.0
     }
     $a set 3 3.1455                            ;# Set an individual element
     set b [$a get 10]                          ;# Retrieve an element
     
     set ia [Array int 50]                      ;# Create an int[50]
     for {set i 0} {$i < 50} {incr i 1} {       ;# Clear it
    -	$ia set $i 0
    +        $ia set $i 0
     }
     $ia set 3 7                                ;# Set an individual element
     set ib [$ia get 10]                        ;# Get an individual element
    @@ -51484,7 +58814,7 @@ $ia delete                                 ;# Destroy ia
      requested, the Tcl code would simply return with an error so there is
      very little danger of blowing something up (although it is easily
      accomplished with an out of bounds array access).

    -

    37.9.1 Proxy classes

    +

    40.9.1 Proxy classes

    A similar approach can be applied to proxy classes (also known as shadow classes). The following example is provided by Erik Bierwagen and Paul Saxe. To use it, run SWIG with the -noobject option @@ -51594,7 +58924,7 @@ delete l object wrapped by SWIG and requires no special compilation. Proof that a short, but clever Tcl script can be combined with SWIG to do many interesting things.

    -

    37.10 Tcl/Tk Stubs

    +

    40.10 Tcl/Tk Stubs

    For background information about the Tcl Stubs feature, see http://www.tcl.tk/doc/howto/stubs.html.

    As of SWIG 1.3.10, the generated C/C++ wrapper will use the Tcl @@ -51606,7 +58936,7 @@ Tcl_InitStubs() and Tk_InitStubs() with -DSWIG_TCL_STUBS_VERSION="8.3" or the version being compiled with using -DSWIG_TCL_STUBS_VERSION=TCL_VERSION.


    -

    38 Extending SWIG to support new languages

    +

    41 Extending SWIG to support new languages

    @@ -51683,7 +59013,7 @@ Tcl_InitStubs() and Tk_InitStubs() with
    -

    38.1 Introduction

    +

    41.1 Introduction

    This chapter describes SWIG's internal organization and the process by which new target languages can be developed. First, a brief word of warning---SWIG is continually evolving. The information in this chapter @@ -51692,7 +59022,7 @@ Tcl_InitStubs() and Tk_InitStubs() with

    Also, this chapter is not meant to be a hand-holding tutorial. As a starting point, you should probably look at one of SWIG's existing modules.

    -

    38.2 Prerequisites

    +

    41.2 Prerequisites

    In order to extend SWIG, it is useful to have the following background:

      @@ -51712,7 +59042,7 @@ Tcl_InitStubs() and Tk_InitStubs() with an extension of the C++ type system. At first glance, this might not be obvious, but almost all SWIG directives as well as the low-level generation of wrapper code are driven by C++ datatypes.

      -

      38.3 The Big Picture

      +

      41.3 The Big Picture

      SWIG is a special purpose compiler that parses C++ declarations to generate wrapper code. To make this conversion possible, SWIG makes three fundamental extensions to the C++ language:

      @@ -51740,7 +59070,7 @@ Tcl_InitStubs()
      and Tk_InitStubs() with matching rules also play a critical role in making the system work. For example, both typemaps and declaration annotation are based on pattern matching and interact heavily with the underlying type system.

      -

      38.4 Execution Model

      +

      41.4 Execution Model

      When you run SWIG on an interface, processing is handled in stages by a series of system components:

        @@ -51769,7 +59099,7 @@ Tcl_InitStubs() and Tk_InitStubs() with stage of compilation.

      The next few sections briefly describe some of these stages.

      -

      38.4.1 Preprocessing

      +

      41.4.1 Preprocessing

      The preprocessor plays a critical role in the SWIG implementation. This is because a lot of SWIG's processing and internal configuration is managed not by code written in C, but by configuration files in the @@ -51833,7 +59163,7 @@ python.swg or perl5.swg.

      probably isn't too useful in general, but it will show how macros have been expanded as well as everything else that goes into the low-level construction of the wrapper code.

      -

      38.4.2 Parsing

      +

      41.4.2 Parsing

      The current C++ parser handles a subset of C++. Most incompatibilities with C are due to subtle aspects of how SWIG parses declarations. Specifically, SWIG expects all C/C++ declarations to @@ -51905,7 +59235,7 @@ foo(a,b) { interprets the above code as an abstract declarator for a function returning a foo and taking types a and b as arguments).

      -

      38.4.3 Parse Trees

      +

      41.4.3 Parse Trees

      The SWIG parser produces a complete parse tree of the input file before any wrapper code is actually generated. Each item in the tree is known as a "Node". Each node is identified by a symbolic tag. @@ -52151,7 +59481,7 @@ $ swig -c++ -python -debug-module 4 example.i | sym:symtab - 0x40194788

    -

    38.4.4 Attribute namespaces

    +

    41.4.4 Attribute namespaces

    Attributes of parse tree nodes are often prepended with a namespace qualifier. For example, the attributes sym:name and sym:symtab are attributes related to symbol table management and @@ -52162,7 +59492,7 @@ sym:symtab are attributes related to symbol table management and assist the generation of wrapper code. The convention for doing this is to place these attributes in a namespace that matches the name of the target language. For example, python:foo or perl:foo.

    -

    38.4.5 Symbol Tables

    +

    41.4.5 Symbol Tables

    During parsing, all symbols are managed in the space of the target language. The sym:name attribute of each node contains the symbol name selected by the parser. Normally, sym:name and @@ -52238,7 +59568,7 @@ example.i:7. Overloaded declaration ignored. foo(Bar *) example.i:5. Previous declaration is foo_i(int )

    -

    38.4.6 The %feature directive

    +

    41.4.6 The %feature directive

    A number of SWIG directives such as %exception are implemented using the low-level %feature directive. For example:

    @@ -52283,7 +59613,7 @@ public: recognize. The data stored in a feature attribute is usually just a raw unparsed string. For example, the exception code above is simply stored without any modifications.

    -

    38.4.7 Code Generation

    +

    41.4.7 Code Generation

    Language modules work by defining handler functions that know how to respond to different types of parse-tree nodes. These handlers simply look at the attributes of each node in order to produce low-level code.

    @@ -52378,7 +59708,7 @@ public :

    The role of these functions is described shortly.

    -

    38.4.8 SWIG and XML

    +

    41.4.8 SWIG and XML

    Much of SWIG's current parser design was originally motivated by interest in using XML to represent SWIG parse trees. Although XML is not currently used in any direct manner, the parse tree structure, use @@ -52386,7 +59716,7 @@ public : by aspects of XML parsing. Therefore, in trying to understand SWIG's internal data structures, it may be useful to keep XML in the back of your mind as a model.

    -

    38.5 Primitive Data Structures

    +

    41.5 Primitive Data Structures

    Most of SWIG is constructed using three basic data structures: strings, hashes, and lists. These data structures are dynamic in same way as similar structures found in many scripting languages. For @@ -52416,7 +59746,7 @@ typedef Hash Symtab; typedef Hash Typetab;

    -

    38.5.1 Strings

    +

    41.5.1 Strings

    String *NewString(const String_or_char *val)

    Creates a new string with initial value val . val may be a char * or another String @@ -52477,7 +59807,7 @@ DOH_REPLACE_FIRST - Replace first occurrence only.

    Returns the number of replacements made (if any).

    -

    38.5.2 Hashes

    +

    41.5.2 Hashes

    Hash *NewHash()

    Creates a new empty hash table.

    Hash *Copy(Hash *h)

    @@ -52504,7 +59834,7 @@ DOH_REPLACE_FIRST - Replace first occurrence only. Returns 1 if an object was removed, 0 otherwise.

    List *Keys(Hash *h)

    Returns the list of hash table keys.
    -

    38.5.3 Lists

    +

    41.5.3 Lists

    List *NewList()

    Creates a new empty list.

    List *Copy(List *x)

    @@ -52540,7 +59870,7 @@ pos
    . The contents of s are shifted accordingly. The insertion at the end of the list (appending). If t is not a standard object, it is assumed to be a char * and is used to create a String object.
    -

    38.5.4 Common operations

    +

    41.5.4 Common operations

    The following operations are applicable to all datatypes.

    Object *Copy(Object *x)

    Make a copy of the object x.
    @@ -52556,7 +59886,7 @@ pos. The contents of s are shifted accordingly. The Used to track objects and report errors.

    int Getline(Object *x)

    Gets the line number associated with x.
    -

    38.5.5 Iterating over Lists and Hashes

    +

    41.5.5 Iterating over Lists and Hashes

    To iterate over the elements of a list or a hash table, the following functions are used:

    Iterator First(Object *x)

    @@ -52588,7 +59918,7 @@ for (j = First(j); j.item; j= Next(j)) { }
    -

    38.5.6 I/O

    +

    41.5.6 I/O

    Special I/O functions are used for all internal I/O. These operations work on C FILE * objects, String objects, and special File objects (which are merely a wrapper around FILE *). @@ -52628,9 +59958,9 @@ filename is added to the newfiles list if newfiles

    File *NewFileFromFile(FILE *f)

    Create a File object wrapper around an existing FILE * object.
    -

    int Close(String_or_FILE *f)

    -
    -

    Closes a file. Has no effect on strings.

    +

    There's no explicit function to close a file, just call +Delete(f) - this decreases the reference count, and the file will + be closed when the reference count reaches zero.

    The use of the above I/O functions and strings play a critical role in SWIG. It is common to see small code fragments of code generated using code like this:

    @@ -52648,9 +59978,8 @@ Printf(f, "%s\n", s);

    Similarly, the preprocessor and parser all operate on string-files.

    -
    -

    38.6 Navigating and manipulating parse - trees

    +

    41.6 Navigating and manipulating parse + trees

    Parse trees are built as collections of hash tables. Each node is a hash table in which arbitrary attributes can be stored. Certain attributes in the hash table provide links to other parse tree nodes. @@ -52699,7 +60028,7 @@ Printf(f, "%s\n", s);
    Deletes a node from the parse tree. Deletion reconnects siblings and properly updates the parent so that sibling nodes are unaffected.
    -

    38.7 Working with attributes

    +

    41.7 Working with attributes

    Since parse tree nodes are just hash tables, attributes are accessed using the Getattr(), Setattr(), and Delattr() operations. For example:

    @@ -52784,12 +60113,12 @@ int variableHandler(Node *n) { copy of the attribute is saved as with Swig_save(). If an attribute is specified as "?name", the attribute is optional. Swig_restore() must always be called after using this function.
    -

    38.8 Type system

    +

    41.8 Type system

    SWIG implements the complete C++ type system including typedef, inheritance, pointers, references, and pointers to members. A detailed discussion of type theory is impossible here. However, let's cover the highlights.

    -

    38.8.1 String encoding of types

    +

    41.8.1 String encoding of types

    All types in SWIG consist of a base datatype and a collection of type operators that are applied to the base. A base datatype is almost always some kind of primitive type such as int or double @@ -52859,7 +60188,7 @@ int *a[30]; int" and the declarator of type "a(30).p.". To make the final type, the two parts are just joined together using string concatenation.

    -

    38.8.2 Type construction

    +

    41.8.2 Type construction

    The following functions are used to construct types. You should use these functions instead of trying to build the type strings yourself.

    void SwigType_add_pointer(SwigType *ty)

    @@ -52927,7 +60256,7 @@ ty is "p.a(20).int", this function would return &quo
    Returns the prefix of a type. For example, if ty is "p.a(20).int", this function would return "p.a(20).". ty is unmodified.
    -

    38.8.3 Type tests

    +

    41.8.3 Type tests

    The following functions can be used to test properties of a datatype.

    int SwigType_ispointer(SwigType *ty)

    @@ -52951,7 +60280,7 @@ ty
    is "p.a(20).int", this function would return
    Checks if ty is a varargs type.

    int SwigType_istemplate(SwigType *ty)

    Checks if ty is a templatized type.
    -

    38.8.4 Typedef and inheritance

    +

    41.8.4 Typedef and inheritance

    The behavior of typedef declaration is to introduce a type alias. For instance, typedef int Integer makes the identifier Integer an alias for int. The treatment of typedef in SWIG @@ -53016,7 +60345,7 @@ p.f(int, p.p.int, int).int : End

    SwigType *SwigType_typedef_resolve_all(SwigType *ty)

    Fully reduces ty according to typedef rules. Resulting datatype will consist only of primitive typenames.
    -

    38.8.5 Lvalues

    +

    41.8.5 Lvalues

    When generating wrapper code, it is necessary to emit datatypes that can be used on the left-hand side of an assignment operator (an lvalue). However, not all C datatypes can be used in this @@ -53038,7 +60367,7 @@ typedef const char * Literal; Literal y; // type = 'Literal', ltype='p.char'

    -

    38.8.6 Output functions

    +

    41.8.6 Output functions

    The following functions produce strings that are suitable for output.

    String *SwigType_str(SwigType *ty, const String_or_char *id = @@ -53073,7 +60402,7 @@ q(const).p.char" and id is "foo", this fun identifier. The resulting string is used in various parts of SWIG, but is most commonly associated with type-descriptor objects that appear in wrappers (e.g., SWIGTYPE_p_double).

    -

    38.9 Parameters

    +

    41.9 Parameters

    Several type-related functions involve parameter lists. These include functions and templates. Parameter list are represented as a list of nodes with the following attributes:

    @@ -53120,7 +60449,7 @@ for (p = parms; p; p = nextSibling(p)) {

    int ParmList_numrequired(ParmList *p);

    Returns the number of required (non-optional) arguments in p.
    -

    38.10 Writing a Language Module

    +

    41.10 Writing a Language Module

    One of the easiest routes to supporting a new language module is to copy an already supported language module implementation and modify it. Be sure to choose a language that is similar in nature to the new @@ -53129,13 +60458,13 @@ for (p = parms; p; p = nextSibling(p)) { language module from scratch. Since the code is relatively easy to read, this section describes the creation of a minimal Python module. You should be able to extrapolate this to other languages.

    -

    38.10.1 Execution model

    +

    41.10.1 Execution model

    Code generation modules are defined by inheriting from the Language class, currently defined in the Source/Modules directory of SWIG. Starting from the parsing of command line options, all aspects of code generation are controlled by different methods of the Language that must be defined by your module.

    -

    38.10.2 Starting out

    +

    41.10.2 Starting out

    To define a new language module, first create a minimal implementation using this example as a guide:

    @@ -53216,7 +60545,7 @@ $ make

    Once it finishes compiling, try running SWIG with the command-line option that activates your module. For example, swig -python foo.i . The messages from your new module should appear.

    -

    38.10.3 Command line options

    +

    41.10.3 Command line options

    When SWIG starts, the command line options are passed to your language module. This occurs before any other processing occurs (preprocessing, parsing, etc.). To capture the command line options, @@ -53266,7 +60595,7 @@ void Language::main(int argc, char *argv[]) { Swig_mark_arg() to mark the option as valid. If you forget to do this, SWIG will terminate with an unrecognized command line option error.

    -

    38.10.4 Configuration and preprocessing

    +

    41.10.4 Configuration and preprocessing

    In addition to looking at command line options, the main() method is responsible for some initial configuration of the SWIG library and preprocessor. To do this, insert some code like this:

    @@ -53301,7 +60630,7 @@ void main(int argc, char *argv[]) {

    Just to review, your language module should now consist of two files-- an implementation file python.cxx and a configuration file python.swg.

    -

    38.10.5 Entry point to code generation

    +

    41.10.5 Entry point to code generation

    SWIG is a multi-pass compiler. Once the main() method has been invoked, the language module does not execute again until preprocessing, parsing, and a variety of semantic analysis passes have @@ -53346,7 +60675,7 @@ int Python::top(Node *n) { }

    -

    38.10.6 Module I/O and wrapper skeleton

    +

    41.10.6 Module I/O and wrapper skeleton

    Within SWIG wrappers, there are five main sections. These are (in @@ -53357,8 +60686,8 @@ int Python::top(Node *n) {

  • runtime: This section has most of the common SWIG runtime code.
  • header: This section holds declarations and inclusions from the .i file.
  • -
  • wrapper: This section holds all the wrappering code.
  • -
  • init: This section holds the module initalisation function (the +
  • wrapper: This section holds all the wrapper code.
  • +
  • init: This section holds the module initialisation function (the entry point for the interpreter).
  • Different parts of the SWIG code will fill different sections, then @@ -53423,7 +60752,6 @@ int Python::top(Node *n) { Delete(f_header); Delete(f_wrappers); Delete(f_init); - Close(f_begin); Delete(f_begin); return SWIG_OK; @@ -53476,7 +60804,7 @@ functionWrapper : void Shape_y_set(Shape *self,double y) ...

    -

    38.10.7 Low-level code generators

    +

    41.10.7 Low-level code generators

    As ingenious as SWIG is, and despite all its capabilities and the @@ -53571,7 +60899,7 @@ virtual int functionWrapper(Node *n) { /* write typemaps(in) */ .... - /* write constriants */ + /* write constraints */ .... /* Emit the function call */ @@ -53611,8 +60939,8 @@ virtual int functionWrapper(Node *n) {

    Executing this code will produce wrappers which have our basic skeleton but without the typemaps, there is still work to do.

    -

    38.10.8 Configuration - files

    +

    41.10.8 Configuration files +

    At the time of this writing, SWIG supports nearly twenty languages, @@ -53702,11 +61030,11 @@ Lib. Use (optional) file extra-install.list in that check-test-suite politely displays the ignoring language message.

    -

    38.10.9 Runtime support

    +

    41.10.9 Runtime support

    Discuss the kinds of functions typically needed for SWIG runtime support (e.g. SWIG_ConvertPtr() and SWIG_NewPointerObj() ) and the names of the SWIG files that implement those functions.

    -

    38.10.10 Standard library files

    +

    41.10.10 Standard library files

    The standard library files that most languages supply keeps growing as SWIG matures. The following are the minimum that are usually supported:

    @@ -53717,7 +61045,7 @@ Lib. Use (optional) file extra-install.list in that
  • stl.i
  • Please copy these and modify for any new language.

    -

    38.10.11 User examples

    +

    41.10.11 User examples

    Each of the language modules provides one or more examples. These examples are used to demonstrate different features of the language module to SWIG end-users, but you'll find that they're useful during @@ -53736,8 +61064,8 @@ Examples/python/class.

    types make check. To ensure that your examples are automatically run during this process, see the section on configuration files.

    -

    38.10.12 Test driven development - and the test-suite

    +

    41.10.12 Test driven development and + the test-suite

    A test driven development approach is central to the improvement and development of SWIG. Most modifications to SWIG are accompanied by additional regression tests and checking all tests to ensure that no @@ -53788,8 +61116,8 @@ Examples/test-suite/python/ret_by_value_runme.py.

    is therefore essential that the runtime tests are written in a manner that displays nothing to stdout/stderr on success but error/exception out with an error message on stderr on failure.

    -

    38.10.12.1 Running the - test-suite

    +

    41.10.12.1 Running the + test-suite

    In order for the test-suite to work for a particular target language, the language must be correctly detected and configured during the configure stage so that the correct Makefiles are generated. Most @@ -53822,10 +61150,10 @@ make check-[lang]-test-suite

     $ make check-python-test-suite
     checking python test-suite
    -checking testcase argcargvtest (with run test) under python
    -checking testcase python_autodoc under python
    -checking testcase python_append (with run test) under python
    -checking testcase callback (with run test) under python
    +checking python testcase argcargvtest (with run test)
    +checking python testcase python_autodoc
    +checking python testcase python_append (with run test)
    +checking python testcase callback (with run test)
     

    The files generated on a previous run can be deleted using the clean @@ -53962,7 +61290,13 @@ env SWIG_FEATURES=-O make check-python-test-suite make ret_by_value.ctest SWIG_FEATURES="-debug-tmsearch"

    -

    38.10.13 Documentation

    +

    There is also a special 'errors' test-suite which is a set of + regression tests checking SWIG warning and error messages. It can be + run in the same way as the other language test-suites, replacing [lang] + with errors, such as make check-errors-test-suite. The test + cases used and the way it works is described in +Examples/test-suite/errors/Makefile.in.

    +

    41.10.13 Documentation

    Don't forget to write end-user documentation for your language module. Currently, each language module has a dedicated chapter You shouldn't rehash things that are already covered in sufficient detail @@ -53985,8 +61319,8 @@ make ret_by_value.ctest SWIG_FEATURES="-debug-tmsearch" process. Provide as much detail as appropriate, and links to other resources if available. -

    38.10.14 Prerequisites for - adding a new language module to the SWIG distribution

    +

    41.10.14 Prerequisites for adding + a new language module to the SWIG distribution

    If you wish for a new language module to be distributed with SWIG, which we encourage for all popular languages, there are a few requirements. While we appreciate that getting all aspects of a new @@ -54026,8 +61360,8 @@ coding style guidelines. of runtime tests. Runtime tests should be for existing testcases and new test cases should be added should there be an area not already covered by the existing tests.

    -

    38.10.15 Coding - style guidelines

    +

    41.10.15 Coding style + guidelines

    The coding guidelines for the C/C++ source code are pretty much K&R C style. The style can be inferred from the existing code base and is largely dictated by the indent code beautifier tool set to K&R @@ -54044,7 +61378,7 @@ $ make beautify-file INDENTFILE=Modules/emit.cxx this style as close as possible. However, tabs should be avoided as unlike the SWIG developers, users will never have consistent tab settings.

    -

    38.11 Debugging Options

    +

    41.11 Debugging Options

    There are various command line options which can aid debugging a SWIG interface as well as debugging the development of a language module. These are as follows:

    @@ -54067,7 +61401,7 @@ $ make beautify-file INDENTFILE=Modules/emit.cxx

    The complete list of command line options for SWIG are available by running swig -help.

    -

    38.12 Guide to parse tree nodes

    +

    41.12 Guide to parse tree nodes

    This section describes the different parse tree nodes and their attributes.

    cdecl

    @@ -54290,8 +61624,8 @@ $ make beautify-file INDENTFILE=Modules/emit.cxx "name" - Name "C", "Fortran", etc.
    -

    38.13 Further Development - Information

    +

    41.13 Further Development + Information

    There is further documentation available on the internals of SWIG, API documentation and debugging information. This is shipped with SWIG in the Doc/Devel directory.

    diff --git a/Doc/Manual/SWIGDocumentation.pdf b/Doc/Manual/SWIGDocumentation.pdf index 7ea75c33a08826ba03c893e54580b4c0a2bb725f..572888c4d23c129a1f37c0fe3f19679219ad02e9 100644 GIT binary patch literal 5109520 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

    o(!V>p(T2OuI=NDPU>lk!f~%FCRVf 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%0AkGm4S%HDb2IWTndo+d&7(|vT{u98U1qdPt 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 z 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

    C3+A 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

    Su)y1kFMRDhWGGpyFU@C8V0 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

    P;?fl_)^bhO^6*cRtYo$WuxPW&xTUz>+~1 zo69iy3Bfr7d0Vyo#h1v%g~IBTP9Nd4sS(jh`jmsIerzd$T(QawuwaQ zX_a|^wji}Zkf~QAhuR5L_$X4J$hXm2{(?Jir#6w#=hO?;_L8DW+lU;^EzU*_= zldx9$8G1P>q-GDgKhH86a1qoz7oTAQyF;rRFzkz|Wc9aRvPJg9BRwc^dUvPw# z1vsJJYe6=FK%x3kjMb)i$s%B7f(Fu5In~SSwL0R?S-Ux;fQ2?MV3EFp4Mvt_PX*6C zvQxroQ3$J$CZDA(ef6p;ay*sL7c@MJP>JWMxAk4JGL>tpRcLmy3>pjUQ`|<#(hqKo zb1AsL%O6lk3S#eB*-dK1G{7+TupVYWF+sY))n(`(6zdJKoskx7buydef$eED@EVO5 z6O+iBP;QBdB@vT|9s4{0n7!WPprf3Ur&jrBGJ^x|oJ55ZNA9_$F!gS}iJf8e5b zmA?TFTCu|}8h?8`*_SHZ<6_Z$C5)0+(>>g>toWWmDD{JjX+2zrso1oICB^8#;5PTd z!g;x#F!(DVCO}D=>3u)TZ-G5H_oY^-67674$wdVTMC+HNKqGo|sBw-Aekn%kSoUR% zNmF4^$psWnBrF%2_nTp1H(HDw2OI@dpWK3GAVsrDA&AJROCH6U5yFS(k) z;S0KRdKBc}gV!!;^|Kmsg(CrxST$qZ?D9`S1}V9iBgTL})Pf42{h|+jz`bY|uvdz~PXIu2%>k2E!_DQzBXKba0Rpk^~~<((7@1o8+jl zYmP;yw%IB7mUS_SIV?_mDC_EV5R^&{6AueRDDt0Ls7vuEmEYAgLA6^yq%iKtICTSE zc^qYJ-VhB(H>QXBVC*8;pK5OLn>xkUHWt$seBV$EN&NmjH>G`$pBZj1s7v!2V|cH_ zJgf4Sxnjk~8ISii_l)H4sr13Xv_*m$3BAY{VPB3nBU&hc95ba=7Y+*j3v^c)lHbnD z!U6Nl`Je$|t`uea<`Fj;U&(T5+zZ!HJ)EFHh(0?e_7n=I$n_&lBN&DD#RD596%?r` zR33clJ=Rc}-Xq;2PH||asxB>}%-#5zxae|;OSbo=vTwoM`>MS$Whq^{Ih%xg(_J_I zXAVEdPPReM+!qX^ud@f`?pA}`s~kDA8bPFfCR1X-1C*yhqIlXn?xwYz@u$1y>xq

    01lQT0|!F!&wS?4y@Oy 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

    ;&YO>_-_wevm%mg%p^@S>U2G6y;u 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⪼$-KhJi^nDi#znlxClT;t0(Ykd7S5 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%0AVq)G?|;4CFG$hT_pjt% z|BTCTzan9bz^as=C5^v7hkvg3`4@;5 z<4>^aSFJ(754P+t9Av-`*6hEl2{s&1Dsa z{y3YaRAk7;%DK?kP;ae6Rif(~zt>(?g4SQJaho%G=Ol*;Ur_VUd?|xXuZ;~fsXe;l zn>ngAP8CUO^_L))CH-b*Axe3}q1+Q}9~-cH`FAc(GEuxkT4urC@EB(HLf#zE8MnWhKBQm%Wmrv^h` zpFWCPXBdgTNL1vU0Ezh7>a+y+k5;9eWQb`U0S@ax2AisA$K3Ko^W2m-e2LH_5&N1j zFcbVsr%Xf^7F^mKC@2?AI4?*(w@bvcMVlv+u$2V8yf~77Lv_~d9=oE&3AgOE;NgO* z>hRKGYe8y5G=gpPVq>9U$?)qa*O$oG%1o{2P4~Bj(dI1E7gK=P7{>6Rf*S;m z6i-1y378dzjyYEr-Xxe~A@UpXK*29=j09^zrfcT#mY`fYCj%xB%nfz>$1n91Brv=` zM>|=+MOsX63$JHAw1i#N{o>k`L}*aKJzFb5nR0F*Svb>vD2(%V_X8$3&q88meb$(~ z=+*j?*%w3Cy77rzBU0iBLf%h&R)o&PC!A+IBahMdV5LTPw~jRm1MPTy$7g>=C?U9$`j4=z~QbT@Y~#Idy@IPMP9eq zeO|nM(eoD0aZMvPDjaqkv@4uhJ*W=x)uGI(Sr|T2G2V-)O5+qn=MJ4W9H7K70-w>T z1d|Z6P3_&@;R{NHS)sRY5n>lFHm{k#)?)x6>s`DrBD&-w++6ThS%;IQ&C}|fkrkp{|^;$4l#EQ4c8WG9Jn><0zbiMvWy;%^* zwYAcSpVqIbkGnd*SVI#J93p=i7FA8fHVbc?zu5iQ#4}phcN3kYW(Q>|>3Buxc29z) zFBf4d-uU*Dfs~9P5*4P)(F@3zComnELGb#7jQA{wI#ao1jx?&W{9hDi z**F45^J|Mj`%Z#KQfB3Y!}IJJOa)CB20!K3bx6nBA$+Jr&4QsaF`1{0rW2>#oSc4Qp7 zHTpW_jTY{zuv7m~!+`09er%3Vx1I~Dm>k#1G~{UF(8JN{Y={kB7Q%DqDZ;P5Yv0gN ziyGebxx%CJEbron{&|9lwW}4!Rz$j>U;|@v^ zh>np}HdLU!EONG~7j4dJ??-6bXQ%#2iIByPmp?4-YK?^gW0|FnmyPZnLXW z@Hdz+Cs)qC)(NF*L>L{*TF($fSyy?_qSF(IiXqh+RVsbmVJRc%l4ULy1Z#M&?B+iA}=E8?{%6y&*VKZrmo;NNSsM+bDhc4vT z#HK44qLd_%lckKJ+@;4_x1r+U>}OWg0E0S2W$*c6Zd(y*NZ&_DS03FbY9AApjQ*bD zGMeu+?;4B{G*rETic|^7r{3C~DMO%qMa+ZF>TcInw)Xw=soZG1Jc(zjYGiDWgW4V+ zg>AD_t}m`m(jF@AgW1z++I2sP7K-j&`;?Je+UWEoPrnY{rCe|=B35m;DN#qa$!Dg! zSU-p*HNx#$49}`px_8gUyCd5QJn*QSZ%)dEo=!8$a$~-R0X* zUG%OL5=tn^wry?rG^!&2BA_`)7?3LRF}j2IOkdACb_#D`BUS_3ONGhh{L5Pe%(ox6 zTLmIzj+S2O6_mjztxS%uzhR+$OD>5|aKc*NaTMI=weEAJ`v7ntJNp`eRL1(wyC@>5 z;G3$iAdx0k$#DLvdAg}3x@Dv_f7f-#D?LCNrVzT!3G&Hplpw7=9zW;h3`A0pPWViK zRC9hypfwix)E-Ce{j0UY4ix-T2zBp*Hli{Vks^`cW2Q0)5oNU^(RZR3XAl03nX{Go z-XE1CSkHr~dc}wubuuhbeliU_Qr1LD^uyH`dvE6Y`Cy)2=tA+M5$ad{IB(qiSi8d& z4NmJw`ID_)U`OVn+NdIk$gjb+2SGO*bb3bIzJhlrAH%1@aO^L84@fMk-}79{TuIs= zl3|V|RwX5QW=I~xf#9z4At{c+X;3FFQUtuaContAFVKOV8LO|`5H=>XUw(_MYJ-4} zg&313EB zq;=Z+wrNEEfm0G#IuC zd%2jS9zie)QKh~sbr<3dVj0HCGa>DLD=9qz-YwmkxgmtUld-ez88q?4Zs*o5;y$Ry za1Q^sR$Y&zh~MZIO-pFC5fHHemCntEmwIya9Q8O@QN#gQ;6h^LUH-J`QXNMRppFx@ z#|Q^8!tP$l!8jqBa}KR1{S5lifc5177tIjgfwFfHSyazHPFnX~?z0SnHOo9-^GMfS zHzeQ{QCWc05h24Hz+(1YEe%7V5pFVE4iX-dSZVM)gN5zxwN^jUz!<}&VDn)sFvz!I zc^OzfC^yMPfEvbNnMS&jYR#U!f3Ma2*#UY@Ic(^D7UXWY?7Em)_LCfwAt&?HN2Tf1 z>eq)ZwlBcz)2Qk7Y@=sr64>o1@FS1)h}#TohBmJ$0o|`vTO0(pB%sMPGRX2fTb{QD zH8de##f|fYXW|lrQ^q?~Zyy-qx!!*WbfVGgR7gMR3erae6&Q$J)M#OWI>OUsP}=d$ z)eE(ROl;>AC^ll&5Oxb$z73g>>RQw}Wb~vx#YbzRS@nd@uieS>gmh*q*yojSt}a-4 zo`vLBaNK=PFP!&)l7NbxUanhMV;$H472q;T%e)TZjh5&1l4DD^6)^9qXmDn4wLEw# zcd$baN*UblKQvDACO-uu`ndRdw|Hn9|G`*sk_;bB5&4^fq5$_bsi}S=sGhbTsrP3w z@-~41n9PQkNh8wa{{0ok5T(!JBr}MD*|Kf98xX?f5RtmK;*to@cQ;e1@uhUIFE9F* zv&))#FPaRd1BiT6OendETjda4RpXbJ$A5GWF#?3H z)$t$pOzT3>Dc+uhZr}M=?H*Y2&3uGYzVKYm{#p`JBBZl@!U67wgizx?1G^I?w4+MR zro@qs&s$^4i+jndzp;^!Catb-!+KuwHa@N6auFp(fmECG%cg8^BQ{IyOQV!Z!%>&P zpf!E#7E_=peR_A%7VU~ecPe@+{K_QwXq(IssrW!v*T+gS;#TW)L@Mk6yDl;eJAq?8 zQnVR9j7H1YhIbxt1*V3PTgz-gNSoF;wE0Rb?5N%L!3ha-^{Hku&JFMjtW@Zc0pIuo z&X7%@&_bMbOU`Skl|@dQTW-izP1bs{ljK97dn>~zH7Vy7*(Y7LR)TdPwq3v1sns=%A!ywcQPLJfy*j#*NpDRO~WozNUzJF(E`PqswB)~p4 zsB#FgWXMt%%7_F{EUPT(MQw^w==#*%?i^zSh*%L&?Q6m3`YqRMejfbE`PtmBt%8@DhIz7L6SQEfbJLbDGlO2bTZ!PO zSd}IWR)BvU(1+Qu8SL;5B&tE54M#-)JsmY%Ssl)Rf6ZD{bRS~SWDQ=Nm**x0re-o* zjI~dfkQpORqXAL`!+kICQX8E3*$s)B^Xl?2Xj?&NKJzSh_j6{^jdb40`p$~pqL&xx zCjv*wCHGT{7_zv%k!Un!c?W00d|SK^wUgBMYG^f*3K`0?YPZbAg?ii?=hh4)dGns) zVxWt!4CmlIsoR-|K@*Alk4)niRSxp$dhb#OXrj_Q=$LPt!rWmfv7|0RKS>hx`Ug-u zAh)zBf_v&`4b9&eROP#A*@&yYYUOqfiazajtFQfj2EjR-v#a~-&9~5(?~mvvt@=*Z zIU$a7hFBR7HD9wVfO9&*A5N0Glz(YlkEsl3FZ?@ ze~9T8SSmC5;K+7S9}U}95I72bf+1%srC6nS>}ImkJx7wu{kL>Fck0$SoqZMSJ00hD698ZU?Jcau<)thuh*jo z%G3On>>S_^x)vRW%>zA|7*l`325qq;B~FF zwgXyll7cLaEL_zLekZLR4Sr|6%NM<0%c2guw9NPTFqp7eEAl98!#`-N2pQ#|h{~FJ zi~$>n`|ax%?!DJT+vCaYkk^$~U`9s!fpRzW{^J3hmlw;UzjZkBgV4S`;XDv>ov~`3 zdDuU4xn6v@Z`#;35j z?eZGbienid5U%|Sw_&x*0f@NTJKr2Ht$eF^EPdXI-N*U${&`|)l`hWf@&cvX)8pG> z<0@FD;@mHuCr4=NPP;e9Z=K#c<)n2OtA1<*3|0-~sM5hMs7`onc4l_YlfVL;@J66u z?0e=~@@(?W-3xnx>Jnc$3<#XmT}VM&QmQsmbdi}9ae(x}vH|`bmT~hY<*h+z`*%U3 zs&m3xEQlD#bvau)(WU9(WjeWYyS5hOpg1@7(}RL7-O>HdR`C=)#~Z?SV|f^F_&c8S z8{A+=@PBMJtecsi|0I}5o%0Al%ZCSvoK32(0y%ajqF-*THMn_T95)BnwZB5B@GXRB z-vFK`Q5<#s+6H+3n5M9FR$lpll{I1TC6dwxKTEkzlN!XlRt5`a@;z*!_Y&?Cs4>gH zE9Ig^@b@+Yx(N(~hldT)1KzVslV2Y|AY|0nAe?tfj|%AOo}wbP3u=D7sJcJtiLVJn z?id=yCOTl*JM9yzS6_N40GbNyJZu#_;9|r|dCj+ftun(}8vHbig9P`0Wce8>>oXF` zna~C-SLF$$AGayQLcv$kXqP)D94)px#RA0wE!h+4bm5>|h_d56JRfA%zW|1SSq@cocTFwaieKvqaI1RrS1udo4_U(mcSlhmVPH(hW1&-{2WdTnvn z=t|Zq@_f|2FGGF4j;?WF+OoRgt%kqz&AX`TZ3w8)3Deb}SpeS>uPu&FuEK0CDM*-n z9FiVtV7u{9wubqHno$cbN8y+%TRcXs^OYsfOnoTqGro7DrE+9iJt=4Cp5Uv#H!FK0 zqb@n@gZ6K3MfqD*rXo*@TZt9JzXT&%>rKaM>rOK?n}9jth*7fi6ROj_sO!rJriU$TT^mLqd)^bgYVZQ> zF(|!4_Y`Fv3*Wzw#rJq*^oEEVjD(1!GqcEfq2}mD7EB32khQ!2HpV4tWM{(qW3`7p z;neP0n0Lx$9v{c;AVEclvdRevc8+1nx)@k@v)HG-%Fb@rw+>WG46@8GZ{V6KuD+rH ze`t|k0Pr|-y|WJ94O7;EuZGy>Q#WvaKFe+BoQ_eP{D}!+$lrq5uyD^tO+O1=O@NT? zbT@X^$fw_(*!}q{9Fa~i2$?SdjQ`EX9V#gDbGi?H6JS{?*qbnL-ckmw?DgwqMI4fjgUjcPFcl*!v0p_o zUPy)J%S<{o%{SvAmV;&-;+;e;3Nan5=~Y@tF&B@1M_|gl>i6tgKwX5Fg7hLP)b$O| zE)or?u#=H7A?TbitZ5yb;E<`#v+;>VEl{fLEW%1gWr>F+mK+0HgD$+fZmCxVh731v zx}C_nG&+(Ch1qCIq}W?_v-7F4smSXL*?7i35cD0sFKglD#JM?y>tpz`r(A$AWzTtAAMCTllg%5_6vL_4~KvqCE1UbO7;R)SZNysqfkNCAM$ z8N{=)9`&T_Opu@9@C}~tQ2wz~U|B=CZ1-5b>^rr1Q1N~_81#188bEiD0Wz!rFKbIN zvUwCd{lu5bIPv`bGb#qc+=l!rV*&P}X|z$_eH;w;t~Dg}eW>CB*0O_u_|FZn7(45P zD4Txotssj^f%YFcuV#{DzsM><*LK`f#<6)e$a-%TBndI{utRX_f|X+phIQ8#pa?_G3 zJ)bc;`=TME<(A<6@&IdreIkd&my7WN3G#wo^coN3r6$lr5WuDEtjd{tYPH>s0iDNu zhz;|dA%GsCbvq$P$*ga}Kn?jm-MwI;&sPn3ND=pA-C@$keD`RX6Fgnse2l-Dg+#zn%_c_*DJSFo2&zzHCR4$zOIsQAza**7gBZ2qeQe( zaBDhnhq9xQZ;#tXWN<>=HWxJ#5G`Mp&;7n?~AAr_&yGEK2XlYBhL+AI7R6S&v= zrlQi%lE=GJB4ciZ6^@~GJk>U->|id}e*awxKvzR2GKZjVA8k)?o=u7dT+&cpN?r7b zPfnywbk|44LYhIc%_#LF6fL|pbC#6>8NyHogPh<^7~M{smEgkXJ?uWRzW1cFv1|oQ zv1{hJ)PfZ!7=f~cMvn}VFV`&w58+o`;XrijGr4#CrX2A@(Dj&mV~c5fCGS2@&YVk{ zdP(+&#(ld-7y%tQL$ZSNr9WMIZuI=LK`wd)!H1MLK@H;u_cP{Pm!|Sf}vKdZ?-@r>~LZ-|L zcomrILh%pNwT&pc35zqlWPv{%s)m3|@&~-itHF>s9?I1nzssXjO*h>i2eRm>!fiUO ze4uiD%#s2KaaA$9f*;si1BI~?@`q3avjOQK=eSKD^-CO5ipDCa5(lF zhnECP`}sj7T7$y}a0l=vQFwi@Qn@JV>{jIEJ%hAdo=ucCj;_(c9~@ePHl{sS4^12Jw2oydomL-ONE?&aAP>4VUNAG3(nTZt)B zhE09aSe;B{t`hQJDj86S=btl}*wO2?A1aDisV${oE>6o`*M?cs?by~sPkvg(q|!6I5G*eF#XS}&!t<6G&@mqJ#RBZ$uvP@`xq&7vvwBynbR$0`!S z$VaFFSc$94ehq+^M{0pP$1=wklrZ4^z@+< zjS^I#a%1MPN}2#LUZ?IY+Dp)BoVUu{x9-2=7aa_# zsgpK#F{=N`K3n0J)cFh~J5;WT#XLD!Gijms*}%bItEeQYZMW^Sr0?Ku0Z+CpRD2w3Ge`$WR2kP!Wu?DkX5vJRrx z^r)Dr$T#)ocYEODB%epa=M?7VTL^*0V1OU6k~&+}RyS|kf^d#~TvH2K3 z9-jJ=SYt1FjDKf+ur|ce`3KGtBpV&j?dQC=-kIiAh=te#G6>t9ss~(Rv=wPs<{Jcx zi#GAS1UxHcB;&0N*cDqvIpbhEBAOd*VT=PnuMxD%VDL?Y5FA1cbrG`n3ttyT+NqCM zEIoI&oh&_#B39-emf9UjPG@1m4+C+v+6Bz@jn(H;Y&;^~&+HcO8LAnMHXEo@YMV5g zM9j^#ax9gyz)vRis!K`Nf7qi#YEbTCx^mqicH0t(lqAO*)1+n`Z=&;fb$l4?f6nrQ z?>6F(60Uugy+7X}J0rNS^5rWt+(~nHTW359SC-QY2d6_wp?&m8jb--dA8n_(IvkPT zVW>OZP%&P!8R*NfpTXu{MS-<;&3py1CCH6^_Z1a`Idf09Kc#ODjnY zR}Og`-+%H3wmMM*J}^aC~f(d{eD4m{;D4XEz2Kj|G(13n0`TWe)jvFp2o=Zmq-=!6Osd@nLS
    hFh3!Gf1))1 zH>B!UOe#yclcxgn6Oj3zhk=Qe zqhnyAVfiV4%?y0PfPY|^e>=eL&oD6jrculM^fmu`Vfan?8(6XY^g`1C%cAjqA&UNu z$Itlt_@8E_|6=?sKqr`=xGf$1ugd2@YmI-XqyKHgpr>PNtK;%Je9Qba(f${qV5a}m zBLL_)Li=-KU;-AW|6M%-{`?|-w@P4sS~vcSFaVdZKkNa1vCv=whUf2U5AbIges@V= zd0Gbly)gW`OfUiE-k&T1=;(nn{mkF?eXz4P z*V41L)-wM`a{c?O@&Axf0xNh}o@Pv-TOaGwR6+NLiP_&cB>Gyw9W>Ah;`eC$_xUA& z6}WUh<(CXV--n;{2%zKP)Ar+U9SuhVJ^TORh{5vTrFyP)BUl;0)W0UKP}Au))CQhu($f>c>HG>=&y-5 z09axA1gX){0d>iK&aD98fBLBz_P31(&|~QLeHrV2pMnB_kmS$(*AKwv$3zNbSOEZk zc$WU1nSdsJz`uTsOYq+nZ2J+2C)U*uu=KlG&JVco$H9;DeQ)``vj1rLzNq~;_&%3^ zKlrhC{&Dbw-}b%b2P^CQ!H;M0{on_y?fb!xC-ME@>C7xoXa2EV{y5LmnSV@<-&C9#<8ePdoU)ZbBP<4 z2Uc+5Q%67g-py*e)gDr9Yk^QSa#5Z-XNNorv5m)lZ^q-{J}&O#`E}nYZrit&jpqB? zH6TwwdF0M3@~Ayy8>UNM_M)9hP^ruD5og8A?e_HM^lWQO?EVq=O^c`Ju4fHgApRZf zm2p#;gAAx6QkK&6~rIvrYF~UiVr+T3C(O zu-87$x4W~9cDJvkX+ADj3lEQ^Wy%(DbAU+Pje@VYD_`YID;zDunVLMUY35fPnz0`r zcM{ucTEiy_OV(S86uN!fEcj+q-GYa^ z?3g5c?Q_pbUv+2$hg0*iaa?9kLwkY-q8_T7V^WWca%%jbTxs!6b=sv4$I*Uzy8b-L z;^DkJ)bhczP>a0->1ydJbnLKhK}Qg6(auM35p(_J`s1Se^-SlzR`UD~ zw~GOhQjv4P;?PB&n;MCq@tGmhjnJrLzy{3aRrX4n)QalYg+Phzu@797h5G49`n8yX z2U(XzmCY!Z1*Z7{IH}HZfI6l_zXH++-udW`Q(GBw>c*t@1>b1t_{tJZ4)5n|!nEBf z5TY~b#-=eXZ}H10IuqnA43 z>^VFV)k!#6e4hG2ex>gK5>rZc<22w)kBn0oGI?>w%6RNCc^b}iXq1Nqhph+f-b^pP z(dw?@Jnx>;TGlEjPg-;!pOmJ%PixHmUNYrv_)QDIq;KhqsP%JK;y$rtNRMswB`&ID z%mN5~Qa?vBi`U+9X^;-4yF@qiJ-JxMA`&d?A{RK(v`3D*Zfn|Ehkglam7g_Yk|OlQ z@(FJ-C!!JQ{p!H!(&|PkQD%lt(A4O$b!L(xXsyG(w;oZm9vd`9#3n~fiUp@vf3Uof zW%LOmcMCFgDOBVR$&RM-cGgDZk@L&ml(QC9)I$KW29e(9a3BA`p{45;gx=b5I zf(X+%K6*X%ZcWeEBU`%oE8C4%-IuFCL|CzagyTb@#kKJZR5i!$?QVOmhJfv0fz0O$ z-8%CLM>!w$)2;Rlm|a&8u1tsR$P|LPMM>^>;epiQD!8YB1l$FrNo# zXO@^fi*u-c5m)Q~dAtrU)4lCu!cxU8Et2%KD-4;Le}D`+S;o)v6>-m9}zZrEb*;+bd@Dn!_W zn)w_|3LFEl)g2t&Wri6&0AKrHWqio;!ZwM)JG$ENeiJ_`*H{auVF^k(HC#6pa2~J} zf{7+35FQE;2!|>xbfA`&*`GIMI5xO3D=MtbC?PXllGcWfK&jnPvt1st#onPXr49^J znnW+H|LlW1QqjF7x?_A=B%cf0C}byAX(tm4HGR6-J_Uj*L-vc@wO%f#M^V^SK^RY#ynRK}+S2w>h4 zm}eH~(cWz`1+kxS0U&l`id^_;w@ouGZCmp#ZDFQH%D{EXaHd9zu$XWSyVU<@ z0@}sFD@Ke+1*{Fy=^5KoVt#-p$FYDjk~qyKxzVQ+Ab?>^Cm&nMv{)cWSd$-yrYNx= ztPHMcQZ{y|ELKDdEunGz_(hkrI8;MbgQ})!R-rglKoPB3*P$|Y>LX1l%@rc>UltCH z5wk5T+=5u5;fbLvo8MdxSSG zoGg=3sI*6FWEZGC|7LR+4$U0+{&&1WC-YNfkcI$*t-A#n)q_uiiMmGGuj0}1br5P3M+;9@5;K%I&UyR=y zfuEF|&N5?44O?$yw5}Hq7_O?h-m~}V+zmTq#9X}$)(w066j`BbEEc^$9Rc9?%0i8y zwqB#}4qjlORI2N3t^w7v_l>&l;QMV`&(8x=k7_cBCDnXw?rsw_9lwu0cp_#`!dl?d zEQHPu_FF68jF|8&wCQ0i$A#X_q;~qR7E0!Nvew%5UsN+KO3e04wfNq2Yx#00x!!;$v*?ysQvi!CI`V$RycOp zi`1GQh-4+00u7hp2ccv|k)#W9mA!-=;T4QOx-RTvMPD33>IwBVU^M#p7lQG&q^YAl zZzrb*&zkKMU@=dDB1l~%!+Qzf??EJK_!93Y1dqUSuWz0D8>C>e4P^pXGE1Ne6RdBZtXges?$`tDpKaLYsp$Q-R<`qU<6@wLBgNq zS@xs#N7^Mt)P!Xqbz>}L4uhy_!)^KTH3LdeHklP|`>hCObx=**n%~LsVoE}X2z)Ns z{k##A&0Ee(!4)u+N*voh7o&!7Cg`VKYoSokF2Dg(8lZWTo^6V76f=ab$GHegO{$Je zfhle+Fve7%tQz%Nv>Sx8=lvGWJEy53D;0HF`El$xSGgrA-d6M? z0%B2XDGCeGt$Yh<*mAb0+6&b^yzBks8b{}g5HtO~={cX0tV#fKd^e@5Ye^GAM0uQE zn|Eqb-lA>!_v(%swMmj%~2ZCY^6&AEC!65lKJ)Zg7Q0`VC(8hFT z?Z6v1o^8>hc<{AIHOOZt?n8uLBeka0-VT@OC42PWl%OTc_l4SIUw3FQ^CW^LXFVrf z6O2hI893UrGChNQfMI3!zUt!5)t!7j#x>sEkS$C}n-emjw@mg7bG9ajOgR{maeyFB zAPK2nlwl`=g;kimO`EKLE`8+Lbba^!J0rmW#E-Kbb?@48Ar$R`&e-wJ1a&`xw}$h` z&2JnD4`@O#Gip~db12dbXr@Sf zOZ914+cg)p2L1U|vWe?OatoU7E-7A+iZBX*UfcHe_}y&0d0i26%huqx8i~GudrO4p zA7vQ2rnvu_T)!Z&^eBWCvi-bUqOygc6k{cI7z-i9w&|8vRBu;4nn=cp;d1vAW#h1oAHRkcH z_n*Z>$j}!+aTJ&*gOIwg!;D9nKhqo>g?$5fAC;HRay~YQ#N*lBZ_`7`D#^!1P9rXs z*D3ihvkEaPOY0(@n8#jWC_}UVBz|BD`+PU!jR+pP<7`&1}cL<6d z?v)qK4&8l37miuEU z%5x<34J20MN1~BHt2?IOi6@RSLqpazGb^R8#5F-}1tZj@C?W-bdFqo@z zOpz1ln5hqWD~GWdxAe7$Q5qK767!7X#mgP(1eOLd{(Kqis1g-P5i`o-0n!@mE3}vw z(UZY-OXC~;ckaTL%yZO-=Q2?oFfKSmk#;QQP1~2CQdj)^A9IUHZ0c=45D=8$W5G9l$P`idHezaJr(YcE;<-fQ@-TO%2+o>PZ^H83C&UYJOi;;B)Y(* z3)(m>J)fmu=ne-WYe!H}55m4 zc$)x-ME&Gfm{#NQwiS%z@-TQ3W5~z+BBG3#!wiuLHqsawoXIsalm~ZA@(XfD=I5E& zvaft@WV-qkm3Q7tb5r*fQL*0&Vo$Y@yyW`Y+~ zyy?8WP%S(+U*}U_DzEHfR>0^ZtbIJP$;(okIC=I`&DmXK``tj0cFExxDLcegx_p&J zy_r8;to?-SjmDZvzq~jR!WnobH2?eOLR3(a%kim^)v(;%xal13IhkI4Xf5kiwTAju z{YM`|uu5ONI)k(bEU*KYFwwQbgjMtyKVtV9HNPH6TO97Aa*=w&;C+v>K6wrgJHPGw zSs<3kyt)pV8m1R{IJkddj_RvF%b1An2?#}lWx^&A#UhKC`v^)nu~CYaRY%}4N}yDv zTw6~`!n3L6CN|qPL(h0Os_W#;^W5lkOTh+&_#A3ItI$RNBsM4^YZNAI+@p9Zmv+Sg zJd9#IrzX9i+gk^Qi1YVzS+DYRiN+$!QQvQ_uArvwEeXlHocD%tpfC=`QMM|CbmPp- zx^0U=tGto`%of19DbLd>#V?UMDOX}j%Lrl4P-W!S#>G1FNY0z>QE{`$jxt2he6kD! zV@J`G=ch&Xq~q;zfO1ai0)Y&o=rq`(UOH%8g1u#t>wl=TNFcdp<&g1DI%QX0#-ysg zv!uflP)c}%Feq`?6;R?I{PqyOJr)#q#fqt^g8#PHyf4sXL=bvPWpI+J`MNQ#Y!3O; zc5HvQ8^R}EC%x_2QYv5>QBta&r5}xKI;9!LmL6p}+H`9pNKH~1GoDFWl4Nq0TTZ)3 z{{q))7k+W4;etGBCqpY15uHHJ-35*wte?%6#h?0~YCFO69N zo&>9lCoq6?D3ge$fxZzDgrjkM)B)Ho5z-*^{n(SgmLJ1if=)C7lz#ys=Qg2UYb|zfTh$lV^ zfh7^Gni5iHKtgc8x6!AB(X#76b)e;Gi^&Zpfrk~xsZu|QmNvi6)E|rUSPHQpKvu`l z5e{ldWag}2O(gl589V7q6P%MDM69`Ejl{vdHHkI!LrJi|4YiA@Y_3F^e7N)WR$kQ+8#PWceQieMxDa;~!zUz83S?$n2IM^q%yyprL!GKuh6u zmfc~aPSjooc0mgr{k4I)uX|sV>r{{HlaZ-qYHF>KlfDVZE({(_tZpU}1~!dBnlZ3? z@p{sbq_~>MWk%M05pvG#qE@oR`RL`b6?yvM5qO$0yLpeu7E1N*sfs%~`5wNpU0F*1 z!_j$*Puo6CP0HB2p`)&YOoGit2=`A|85lZ4l>3oEH;EV^y6M4Hj>R z(o&kEmytyCw-!mVa&sj=Wzom%l=V?vW2O_0pI8WZ?ce_O?5;GV1`|tMsR3?lv>iJ_bN>r%sErpvAdY zC)E&Mqy*VIs+6~|v`S8Ay5xBK9XrHdr3v`F`pPt}6anuB*og9q;tk)S z*hP+B@0pY?rB<%Jv+pp3Yf;@VK6HrV-9u>E!-&$27qZC{;F3ko*&!M5i2Z2hW36&c zYSsB_I+YqSdcGdMwaY*}678(Zg!rYx=)9gQdyg?OnBOI$d|57Qv7t4%0H05+EkjlA z?U6{Nix~a10HH3UkU3%JHGI^R;7V#ksZvbXLE-CY_DVmhqp3LK7GM6rcdEHoyZOO_ zs_!z=leATnhz}prNo!vEq;@8QR`A3fP<3++Y_*xtHr2Cx0fOgTibQ&lSWo z+nPzowr$(CZQHgxwrwXJcc-I{osQM9PChN|RcEbT=f~N9QnNDauFCTyHQ&lL#yy4* z|HZ*=GjoY1O70-pIBCXi%ul5sWFexa0i^pZIc6gAU)tKP@RH0m+gHdD`sy7#ZRP!8>ky26{0-rgK66-GT{t|N0!yQZ5)VR(jxWrL}zN=1$ zqI}k}=e?WK=1aQZl4@)moSkQvBhdC9tZ?PH#=MW^Zpdiq>fl8-fSh;jgPk5w)mAJ! zYi~JhW_=pHTFO$d_GdvRlDrekLxop8CjmF6(s;<+w{3 zNE~+ag0MKFygaQfT<$W%8MBBfanHpI=hK~qIl3WoUvDC~#!V;1Z`IF`n`5Cjq@(r_ zG-m8sC0&vzs4!APbBFY039E{77sC^v$mLkxqDg(}>Fs_&b#5ki{CBA% zzpG8ZX;5tJ48Jdz{Py}owfdiKnE#|*{w}WlQ@PZKwe$~3@2_$xc81@@u>U3@;*Z(C z#IgSq+U5Ue#qy8i|8}N-3gqSdN3YG_Wx(H+L>T)2CaQI`_-L34gx^EjL-J^X#<(I$=H0sx$EjdtF6N7(NlckfgZEe&!ceVduZkME_kVf0 zKjHW9`Yj)Vf2nSF7BQdRRh9kr@^Izd_x=fUO(h7CutgEw{`uqGO*;9dvdP{3hUfdE z!K_2bF~aq&GxVX5KHt~dYd?=i(}(FpME`TX*Ncfd|Kqp&$=f>r6TcUhnI-@2)sbe| z_wCIg$Wd(eb$>noW5{>c$H|M@J~yI_L(gabO~!GVs%%vU9@+TD!@fE~QTh{u?^+gq zrZMjMs^M|(Z@bsd?5kj63sR#l09Sk-YE)T%d+~&-#Dj^ImCOZAou4{Y=5wX8EXs(e z+HIYSQ13FSi9xPlN{wYA^5CX$7kt)?Z;^q^Uy!4t>hxY&mX0%5(#WzZ!Xs<6*Cmj7 zP&El;YHn}1JlAV=k64zhax-#KfwQqt}hAuF91Zhe?ye2|l&jxdKFUG6|B~5no1pJ+65kcGD-HHF`dv&?)w{9tAuQ!{FluPUrcDcLkt0aK!<5y=7rdo|h1mW5g|t7f=rb16xqVh+($g zryiuRH>>1Otiu#xvT*gjFLOtqU2#glkBgV`diWA^);BmE_>EJOWXs_2BQ2?BrmAVC zW6KYbHOCDt5jLhL)mvU+c}~JrJgzK0B+m(ZMP(@+9uU}2BX*mdL`~5e+NgR$ScX9h zrxGi-qO4Z-4sM0GGDBKRBCR_N95wY=Gkf^q0C(MmnMyJi(3YB8$UDWYLDU%+Gfv02ghWs?c$iF-4!2cf6X#wsmS z)02d(Ex)7;5t*SuZLr+ID1A-w*V>VJa|~sKN*^{A;2|;MpIjkfV9xG{zHG!>xPm1& zar9-rZcMStOK<9JYH0`?Asd7eD5W8jm{BiK58XUmCXf1l07HY|!V!dO*vL4#{mes0 z#8!$$YI8QISbrL|cQwnqiZB?YI~G>I8ELSMwSRiqOuInv2~mIXCk*DDd2{1yX3-Cz zb-E{Jjgw9g18TJN<&3gxO~+;rfGz5IB`9R2!{Zgl@l3Tw`Zh96NP7hr#DAdf5Xc8eocWm+uLxtWjNueA*6C^8nDkPz4#}Ndb__B#`AmG|hgO(F7 zk$fU^~(o%vS=w60f?ud$b|8!*axT*0k1ys?pmOnS+*$HggO?4ST3x z_9-)qQ$Um}gX;BO?54QDAql7qY6s^>U&K7(%abdKbtq&t5knE77E(1D$kj$dIvL?` zD_~^NRpvVR?%D6FpmHs^@$X9g;u;b=*nB-s0`od3vyw9}0liU`+24x`9}Re9O;Y&`25=qf@a& z0efQ6ZIiji!h=wv5|WA*LdAh3*XG@?qYSk4Qw+z{8Gy5^w>qpDdY&s=%x zLj{tuWDnF%)ygh2%90hphJ<@xFwf{nAV;wtpR0sa_!7*H9}Bl?cW}2zDTE{iC`R#z zE$HstBdM5t6Of=TOIj?HGc}ge?UYJavSO4(QgB=1j%&nInM|82;p893yH1avBkU`U_H!nO$!bH9_wi1+Uk4`bEsBjgFP+bG@f}= zm0GUSOU5a~6N$CpYC4Fa;h~YWvKF#npdmo==cbL2pr>;|dQTYJU~UZ#B*#H-BDJ={ zsK7N{h%~YMvzfLgA&i^?6qU?8a!JczQkwvS$Yu>dlW>+svAD^oD=~`iDZxa zr*SMZ78zHB{NBzPlN1FY^s7V#FmlLKf%6_7=Q$LgPq6rTEzVKK;p3&(oZe-i@sspH zOF}`CStt<2)InJRm-tL#ZcH(&N|)qnPS`OwlS=Fi363`(vFC=RM6u2f?Pobmh()k;#*!_1?K9us!H*%F(2Jp^1M) zM9N!=H2V5RmTi)V=0N%8#8=GU;Ta9H(C+`tC4M_dlz@JpchT-F;XM|fz8IkT<_SdDUpSdCcy zK4>x{rV|~THm!FJ!CCJ&(lUih)$kN%mIs|u-z2cxiD{o9B6c?ZGnPhRc_p^ko*1^YuljOt|sRfLj)ePJc8|U3f+$}8ll4&tFJoXmb2#}Rc?qjElL}9%r zmcaw_Kz3AVSvTjM&W1|z}*1@qr{Olt6CR| z&25LgakVaV9#WnSDlsAAZG2w0(L#x<+-Jt=B;|(<9h9B$Vh=Kty;@0c65+>dX^djP z>}g8Ni=^XhBVx5aSeP}#%dZ$p~zEpv$OjKb-L(!>v+e;9Fgy-BoMH%jh5gFvT6II(vAAhY7|c=x9zf znyWdu>U6fWI2RR$|0R8s%wRrC1A?vQRNO6UeGtY zR%3pKC9_{Tou7?ea*V*cUmpV2U8~G+&`X=+j-8i{c32)u7SPa=Cq`kn${Y@ffhgh3 zC5H^mmOzQ1H!MR$oDZJ@TR^hM`cMK)wUsw>2-dpCzYC&GvfD)Gw7!2XYe366`;3pz zZf+(|4;}$3KdU3R?4 zther&MMFN4O@tNPjAXE(Y4bxz0tiR?9K{plp^;gtZPPeyytqdrXnqstM8CT8(yJb) zaBHhM9bo zhQz#uBeY6H5F*nh;)B@;;Cs62&CC7M%WFeC$VW*JH}y^#ycCK06rv6Uv08p&X)HBf zoxy3s`SDCbimj3MR|AUJLC1W~5P+eKBZO%sIN^?`s7><7!#rY}CPpT6cNRbL9ps3WIoHKBCsa0ap{dbqwvpKI ztR=LlhKEgAb8$KNwe+GrhlmnxEd}UG?{Wxw_3h45cf+g)NTP)98t(qnl$< zUo^Bgi!C&jy~RuGj`Fe^WB<8bT9NfgVNP8YNEBD}#kJ%R7vyJVBJmrg$jIssq&_88 z=3!;q8oql1(0t2n=HM4gy{o4V`D$B*Lo-~Dms@*+E%!0wMrP`lkUVVRJ7)k~jd6_W z7%#IDjoBH%W)`GA=;Ucuhw)YIyNIIqd^~{_^R<`QO@B&O(z?MydTt?Ms6>Dt8 zX*bd+XKCl8{Vs-moKphokFgZ$;ieA;0#t%8yj7h$IJ+BaZM_s@3MWl7%H@MtT5BGf zL4b6UciV3+a%O*WVw|SQSrFI) zvA62a_l!CH4nDm%L?}*i-+#+L{#xr`=HOucTcid%!(Z!zADImte`II;Qziu)3*%p_ z}b$f8{Ozz*ks4 z8oqw-_Wr{W{y!YzM1P*^zx9fLu&s}q`B(Dt#~uE4=D*0xM>xbExA>pQ%VgX~71H`M zbvFWo)fFWQ6o^X?hzauNuOITK3Gy!!6u7xy6|=<6c$;yz%wGk=li|fU?x4C0rJ{-H z_tTR@^8PQ^_pki^>;7IZ*ZHq)SBJalx~t8d_;0`Ea(cW2v&U`?)#WO}w}taR+i$wt zKew%)oVUE++m8LZ8n_bQ^za(_x?Q*F_rn)QuNRl^@%rKLt?jpFZ~51Ezm4}>``38F zu{Q+$hhAniLchoROW56*>^J@ke{PnK1kd!%GykJ-gSc0Mx7R?)0S)Tp(JME<6#VyI zf3%)zLT&RWe(zC__pamdt4;q?zhiH1#G;0z2D!=F+;wWy&WokiYWpO!I<7ipdpqVX zqa$9++$wUn&k_@R)yM;JKZ`Fk*r$}P_B`{RrOwAKk}JxFGBj3B#ddb{e$KZ|nH9Zt z)D7p!th#lW{A4KQnIGd-tgv6vTSd4*Bgr&7>`n6Ckuo_xV)&HC)&;l~=KWSdKiprJ zQ)2Zht$)O#EM@xVdx=ka@^zX%AbwZS8z6{$KI^_-4Uq4LC-SchadPvQyC?U$W6$p{ zqpd#gw_~ptt7((`r+shT#?^{S*>d=O?9D%oqmOmzhT5&@Y0q{WMD_TvxDsR0d=byO z>aNe1jp+3E#}GS9TZY^vd;G+L?OLAs+SEtG%pWUOrC|xO0%&IwBsL_bu0Yov%xbw4 z2Xh}8eje8G9u{8-&RXFcfG>84$>(dj}k3&lWOeOU$YozBMI`jFv@%1Mi__qX0ZJA2VPnMHa z3y_EqAkyZa0@4!koi!m&*zKk0_QeeIM5W@7GnfHfnI!wBNA>FwhENw(H~PEDs8Y!O zS@JaYvL=H_SJouMM2`h7>FVX1+|9*#%wcGeosN>NFenZ@#pn#XqxLvABrnD20viFy^p5g1JR9 zY8`n7B@vjJ>i`;YM$=)E-ia}FGm>!j_g4a$r1D0YFV$4&xDv?2IbRYx?0AE<`Gz(e z5b_5$93b!yF16Qi@mR+=eIDS3xbfQACGereX)mp+O2lK`l_-i3E^+nF${rNsD;tEm zZBB0)G*^Gd=^m;=b4Ccb2s(;2iZpA2NJgb6u)f0cez)}Q?at@jOeALf`hq^w#T^13 zl2=UG6}k~WpXzV%!l9xJJOmfZsa~R*{j-_7?J*`|f&qp;{5DL-k`s)+2Ty6DV*g7Q zI+`Kyfpu>GhNo1V#}Us^>ol})Uu`wVN$-BvK4_@$az$v|F2xLZsG9pk?m%(OgyR5? zu{N)wB1WQa&=k!;<3(1m)O;aAafd$;ZPFnhSIqG#Qa9utGZ1O zw8^Q==hMnxn!&T7rN%A@?DvDifaKStcBIH&QLrh z2}PsSn{3U{=Yraw{e1;?ehz_OYKVy;(cf72FC^%&c|GMbi`zM<6eJTVQUZmE(%| zMjQx79p@P&8O%g7xZvqO-&~AEey2Tn<#4SS8;g!a8iNQp|AN@Tw<n#Dh&?Qy_?O!cshbUB z@kJ!PSj^HuirN!M%shRnA}T<*2nCzGzu4*ENcqa66_>#=V6B@boV_)nu*N4Wu=!pb zis|~4^pnjVI0<7=$u$5l%X9z-0K8!8GXWrkfNe9x=KIC_sM?PvzO84+@ZCh%V(1VB z)r;WC=^vMmV$j%N)CZ0;Q@vS}#Ee524L?eTU}x3LEgFbeQ4ZOGM`}=t7Lul5yK9h=piVP~KxnC!(9#H{yL3>aW7q=^R1#1~WMblWGLr z5dp%JX}|^UNpxC^LyAp1Na3{J(b#VEwF0D>Hsn+0&Lt!gU%}TDfg&os zlAHkhL~~qvNGMAsPfD_t5j_WGR{PTZi1aO(Wq%#sg#$mj6+ zl0mH6aB*3R45gQrWG`^QsH6-a9N+h^#u@UK#D&iqgZvrhYoYWP5up#b+q7X=J}K9m zTC2(Dl#bkTVM3A?rc^5lKxpxR*nmiVZm&iO3ldR;5=Zd}6TqL4X*i$7hOlPbfe3g!fAsP>FUB%sWf*J;YGpc%tpd7@HMiRscY^NHU~-+(Hi!7G-6^?D zuCTNq3PcG5YM_%;E6!+2X%8Un0X=eVr+xy~EDdtctF_pPNw9z<2+AnFQn|TH^U}Z^QK}_tF8;G^%G%_hDaX9Rc z5}C?1&riupG(@g}*^T2$qJHL3&ppz(%2J9m+ErYd6!>-Zi#2>5rjZgHfqF_nMr(V- z=U2;!cIY;^cuX_w1$e7(J>TH9^jBK+fG1LSvRWAvwYjLxb^Vy0!nIr7mfSjE@uCb@ ziN@lx+K?Z;Kx&Rfs$B%^ooTDs{ly~^2VjYCM5U<1ShK&*#p*!(c~874AVQ6Ye_08R z3f{zBn0)!F3=)nemP*CigX66vwO-WUm~H6e5=2Lxr(W3bUf<1=dT$WIg5X-^ z1-_0g4Qwq0v%|G*7mw}%p0akgPTlSeZha3!F|V294uTU|ACKJ*fG$g`^i=NT^;QO$ z?Z&3qsu3aiw{fjxQ~4lgnIc&FIopZnRFajKPLQb0#m-G^r}@~;i)8ll5%SlCv}v{Z zn07qZU<^fSS-_eOOZ$z<<5F|&X>~DwX((kzkSsIsGZQ7D)V#^Mg|gd@O>TAOFtk?R z%|oi<(W85kJ5hpT|39&=aOLwdECb3Zz|5aW~@P8~3iv}YK4aE*LyJ(vJihk$&PhuM6_5lFye?u6?00=q3WdUnWPnezc zRyn?@b_PQb(9S?1W`=gSw%I%mB8nN#?gr=f^Z56KQsl4iAF+|njirXx-Fzh7>1dD* z9zLHroMord9NbBilsHUx*EQ1tV~M8BqGmUf!rIM7NH@XkjFo94RS}nO;{C&WHDJUU zjap&IxS>E^I0GgyI%6UnaLCKQKIIS|ASK5OA8)~X2A=%5Z1s+X>1%SZ;^rihn!Mgu zCee00z+=Ku4v7ggc1i(t$vC7iFxHHgt#^SQgrX?I0P9q27TtKHc!0Ch>``N~RTs;- zK5pO7g|;zjXds#I-nJm%hFGYacPIs(QQ5xlSM7J1)Yg+Zirx9Sg{-iaS-H6Az$=L& zHR(YqSt2Qs`r3l}sAnucL(rRV?X_8P3C_YuX@o^4KQyubWf6=m;XqyO8Q51u5W$dA z;{N1?jTuud*9{$148k~MH-t8huR%SZm8mo(SGke_gl=x$hl;i#cUv6Er&ZuQUx`?r zgC7Y#VpE2cP{XANasH z&Jg>urHwYZb8Ye;;I`S?<3}?;97c=2r=Vk2D#)ak0Uz60h9O? zkb4f*CnI;FbUte?x39d)je;@v^_3(Y#>;aA_x`ZEwl{v<@5%LC$RtZD;khP z)Y+Q=k^-{|sd-uR3~!kvEFDN;Z#T1_y{0>?pr}+i38<3L@>>y*9t0avSx}$Uv7C&z z6?J>wP9AV4^-=t?kfJ*n%Su4!P$jH0NgBeuW0KJVf1H1z|DP6nw_(%h)_K%>lG z;p{RWZdjY}`-LOGi}b*^YJ!|#&Hcvyou6mMrKO}R)hOrH%9XSfSjWgniIgLF4?8YW z*kHh7ems3nu$ANBaAZC0C^l+pH43oBl|&wZ;R4mEL>iy0a=2gj;ra{544OCG&{)iM zG|(r6aAiz=Id)_v?1j5apc808+h`Ca0e;|^)HT}{o_#uLvdJNHjW4E0sYL7&sro52 zB%$LJBoXq#GO0v$%)2i3#=^22HCN2UEf{cZC{^qtNxZqgskcE8TH#wSK^njwS-yGot$I}Cqx z;?jb4!G3e_zQGDniY4ftl$M6vG~Qyy;A5t-7{lFwBzk#eMyziOblmX22J7P%t7bQQ z2+G5T<*;jEV2S^R8SibT(~!{-Z_EuN0J4PdcNmqc=*dvCZ52O3RKGIeZN}1{#d`MD z1=$AJJNP7|!)nR^>$}I#!h{2l1z$g0dF6F2&M%RtoQH6Z_JP=Zf|g@|%LBRXLu4*y z*BOn``eCEWq5G``_$j11$YL)8zROI%0DszVkQ4S9oEFe*>WYpbft<2o^?`zZ-Da8UG5` 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
    j$0+8+CE@m=MFaPt2X)}v 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

    s>^CTr=r1(HHx;7j1q zW@d)bJ&SYxdQb%;KiqcQ-x!N=9vjkdWc%p1wK21^EVy?JBf3N7pTkdftnzkgx_M?f z2bs!Sa>!I6rrO?&e%V^e>6^eaHw`lG9zKn1kDME7I~3Tlho2JVd`vJTNn=zrI3#el z4h0oL#y41xjE7_S)6wbGW-`(2wrtEYzH27q=ihb_W#$exY(dMGCT1GskBW)-O4mk1 zK0OU9DQJa z8frjmE^<2(Mwke=)EtAz9+ zcbmUI)i2ca^2{X9F-6Xynv@hwGqqu+UKm9jQuQ*6yoMPwc4ZXEs@`tbPHSG>Gaa-a ztbdU4R__*c?o(8*ina)KceTWlW(vn#BCdxkYKf38>JZ7Jq3iD-XDj58WpL}5?B3N% z`xtUSSGRKQ0cqM*@i36pmIf;6@u1pM^6Bnfc#W6(L^6IHRUt)!hSsZ})9aq6W(9td zg7f6KL9pS33V-h!BrEv`0=H)c&dQC)97<4MCOYRhQ;)nFozBK#0`yNq8z>!lic=4~ zL!q(n>G%)?-4-8SFN*z4$3y2HU20#EhH1gabgwS)tRUqJe?roM&hD@iHyHqFJ2}5K8E9}nujQ?s5FYMv*I__J#2&5_>v5vt-txxVczgUHP~mi z8B`%{W_iNOY|36IJz zL{&sIGgNo>E44>Jg{}6XquTebYYn2X5e86%eUhMDp<{TmN5b&2upB8#A%dzXYsqLs zVNF0md1p^QB3_hGP$k;bX{D5f+l$LaJM*^A;2Myvq_B-}^gC@)G!r5Kq*c+!c&80- z2J-~K@GK0!yQ=#Q@XpX-QP3oeJ#Ry8-5vD`qr3ewPj^P8>I;=@N^%Bw5@`i%g;a$J ztSp2IM^NJ1+uNXMle$gVjT;7Byn1z#Rt)(?N8^&(aSSk5>t6FtTEQEH3fHb54{ruO zm+bIhlB;-~t^WEG_vR1dNCn2YId{o)iFXr(oE8a8Bk!~3G3EyDq8dKL*OfvnZ|>^P zMdU{?3ckU@t-uiaTGYpXpF_v-Ai5)bz5SXLM>ZA1V4D~2+B}M5%C*#~NttejOf#cI zE96Q!SsVpYsK#oG+BbiZwc-AR{6M@)>eAc)bVp@_>ep~hFY#!uyf z8}y_O)>aroqvX!$Me~Id@n)pLM`NgJx`UJTlc(S5gP$MxV?H37$@L3D>B@UWnz5s7 z|JKz>mob73_c}SQ-@*)QWbp0A*2xcV9Xb}uqjvg{HwTwKw?8tY46CP57@Jc|eK4UY z>XXE^@7uo-fyE0Uw?uz{F;{!tHT6EFd=8qChj)_6?x4P5_}BSEBiwtrT+)INW>ed@ zayf6oistA{GURvSZ!|-~k>TZCpSn5)2PEAK_6IX6vb-zbe$kezxkSHee6=VXJ&A1; z;o+-;@^H5e=mH)5uCaO7)rQQy5K^l4rVuCw>;)VnWw=ig;yROybY+L^{X3KX-*3n+ zURS>*{gV1d{%GNFXJLr9hOsa;nV7WCp2o|Nh0X=$@yIftg63?k_DH9(P&N*{d~Tzs zkBs!T!k^!=fQ;oxO}DxL`N}7sco?PSE7`iu=68Y;$~XpSMRFpzdv?QM^qp?%uQ0^0 zUR%rPF>eG2r$V_RH^{9>f^NKc++&w#x>y3 z+GmK+N;^o&N+_IpnjU0UoBrZm0&*bQC@GR?at)q@<6nRN;JOJVdL18LB!{)NfXTbMV6I=jp#H?O z^QvB9=nK7X;~itBOSU^G4-;bo9SjrZUPjoOPoT%*n#fqN`{N7{S+57^A>Fd&oP6;r ztkMbP@WZg_ngD%e#a(ro2(E&@himF-rVVDXb}!fa%(yE^8S~_pX*4B*d~KV0g%0Up z{@V`}$f8L;V354c>!9ThG--MZ^Hw&+Qm+c29c=LlMl?@lq8Nd)2|(%Y$eD>X)R1^t z4J^k7Ro=~($*X-rF|?tz;tSn=>Zqwm|3F}oox_rM+(T2%XCX9 z3JN~gA?|b1tQN)R+;WRt%Su>Ut8RErDj$h&LUTzze%?+SkW2Bse@uhqX#Ry!nvYmZ z@}O6;z6RRlF%WQ!`R!4S1((V~s3x;2H0|of@*S1WRKxvVHDBvkZkrI11b{e=j6+g} z*LCs38if`#K!zl?+oXavql5aCd7*UN3AW3HoT8P@bdc*rILksy!<{?RZ7Rx3i=i`b ztiFjpc;dqLnW>`Zo1sezq>3#8p9AIX)>Rc)ZcCD0$eXfsnH4unl2z{z969Z|a$NX& z>EkXRgxix-VcXx{H$U`|fq&Lhm?-Dcle(bxm1uuXj!zibe-b0(!>3m~dBZyV9r48I z?TS}C*yMeZQG12T!ZA~>2eaN@D{bxg;6AX}j)RMI`ymnvt-$`ZJ4YlN_7Hr=F}^wb zZU-i+>6&CP6zBSl?>f;18A3r))%S+`t{1fDow`kEpm`D5u&%Le;kOYO^?Iws0W?A--aII@A9||XYazFgY zZKftP_^?f!wh6VGHJun6mLWVykDweMY%@9e$WnE<*#G`&7ToZaF^;LJogz+bmEb^&%V&(h$ZVprF zPhFqL*NmW*cp$uwuX$%to4)1>`)-F?pZG>@k4m#B7{Nop@Am4b&odE+U2DcH=eS9j-sAgtZxP3(c=lf=WQ=^p#LZ%7*C z6q&lG`F?P*Kv4ZeloPm|FZC)3Z;v<|WJ;v5*{GbZmE{X^z5!32N@=`QG*iYrN0NG_ z`RJu=ZIyvl0(ZOPjXHz~w8SIm+*OToeF6MjC0u7DjYGQ*);TzYR}7%rDK{ipx>$vu z!Gho0XZytq&G1b@R+Fb8vK`R=&Wl!o#N)*q1 zCwW~y|2yZmb~v5d0EWF=E`(x)Ng`;682wdPq!OfE0_(y8l@%rWhLOu3)qpZ6#G^J9 zbI{Ddf+g59nMd0yD^xRq+9S|Fy2mtxJ(0D`9qGFa&3^J@MNQ3YN?^**q!y0$`t+(L zZG8O?w2*PRcr4X4SVf31EedO-$lQ9%@UT5wxVeOgwh%Z3SF+`A zq$BWV=7tIS;CvLq3QVEnb2>%6;V{QhdGCHi^6f2I^|5y^NJs6&0$YV-3xmRpQ6;Pr zQB`x@G7EM^G~o|#Og}Ter8!8q*pw+)Bw9*Lj3D^xRW#YllF#vOtmYCp^ly2rb%|Ie zF=#p>`9EPlAtqqq(P0%tYluAN)$_k$gk`Mt>D66_Wzy(}QsInLO{`mTl&UCu z>hO%X=w#u+OR=b+ALEZaytBsi70F}8F_VA(h57#J-KYy;Rb`$o!?|n=F*x3 zmQYV9jT-g6z9xwTe&5j$VaF}NGOvWc%&jb)8{G08ELtgv?Hh?@#XX|5CjUCCOposy zB+42yMBbg?z3VFIlOszYkRv)`bLbRLU9y4L( zuc(C0RGAZGN3%%{Ix+EkYI)G>^%6egFaY^nClbvtZB5U_cg2n^CicUL&p+XXHm0*{E!?mFN(C{nc9@CBf&#-|NKUtrKW>%tx;)PUC)QI z0oeBu|>;Vb7q$I>&#EK-$8e>`ntZ7IQe~%)2Y4a;YJFfSmgDY#JD7` zXuhj736N8fXd7licn>jXEw3+MleSF_`MjA+>HpX~%E-pvF3`lKGOyUA zTyJPu)}=iUvHbDm>&H3Fxnl>mGvksKId9c-z8>1P_Qc#yk`3;wGI|tKv~IY<^w50R zmbgoKyh64Qw_?Hc@jH#@dMixDBiFxaFDwxpaV7D5HGHqe^l|1bi)RkYu~U0?(Tehj zI!OIklEZZ>3*|Q!AS#yf4!Lw<@7at*gelRF0!V7x(jsb@V%% z>+|iFYzT3Spm7G`vUIyIQJ)#5Te!r`1B|2NV8j`vzC(sYp@tEe3C0^c+|A!&9Byp- zvc}dvLCujC+g--TKB#Us=PhuoKHPTSY!1u8S{pWDnf!G0S-0YA&n!`HX9MO*EsS6W>xJv5P611<0IemKXscV!$mO=-S>?p3j6WMM_`693~4pOvWZTI z!ia~(^-2cM4`v3iUb*i?59#qnv=HptKoBX)as*h)N%S*Ka!pSnj==+?Hmq1gM&#>7 z(3|6LM^aQ{pX51OwhV#P#<7g_Eb0Yc@anfvjQI%TPE9}yy!FVI2#^N?IKLToQbl7k zwqnJ2a*Pi6skrVMj^;Brv{r8_fx4q#XHL!2q;l|Akse{ECdCr`orCw(J9OeRV&{PV z7G}cnn!a0gYeYL_iySL|DI5agOih){VY)qm=&n6 zeCE&P0Gyvci#uGt^g$<8DonL3tp7_b3yyQg?0;s5-zyhzaB!X1tT;(r{+As%&ucqe zYCBvkWx?@Z9mfB^@o>Qo?66-s(g5!^GxU5saGaNRxYTyISjmF(Txj`&@c<|RKTB3z zEa}0)4pesdX_HHrOzO9Jaj}pE=ecn72X+9olk@sOU=HYC;{gH`cKBJ{<1*XfVjT<4 zb0O>x?7#*&D_B8E$;JxQOggJcI*-=P3Wy5HJv! zL)8YP#SVgLfpoY)Y}z2O9!OgUq{}J-(gK5^S|FG{NSj?4#L5QzDG2&6qx#Q5A_N%8 zXH1Eb4VcouKq3$w`roCp2XW|uU{H`gyTQp@)q-hpfna(dC_B)u1On@TICMd}Y#?ng zh*b*&(F5snf^;r=0=WJh&q07}^XJjB!0h`~(GsX(aE|`}t+n-yO!PnyEfAaj&wqyI zrh34Yy^)EDk(McNWo>U{0DLnrvN5#P{_AH&b8{2xUq9+Xn1R4sR^aEm<~qRtGFoP~ zS|-4Sg0h4d&~#eqSL6O#+P!u4v~3LxfJIuvT2ISL$M6Ek<@#sX?)ME0 z0;JtPqd33@2CUC#8R<`qby>5}|1t_t68U24b?BdCI|#5*oyTB<*}%WnY6wvI^|B_R z|J@K5(LVIgu^mw8^_<=Sn-=>o2MGia9L`w4<(($Lh`5OMq5llq{k}RwIDXNa3&o)! zfH(EhD=a6DA|ovm4LdC>BQ0$cy^EVS^v}T^1n`fX)d&ZmKPNNz4Dmt${o#xfT;AdF zuT}w|ua1@Zzu4v<;=SKcKjh@}!Z}ff0XoE4{d%Cx$60ypOH7N-ZF6c84P8BJ9V;UX z8*{4*I}P+7qQ2ja!}g030k8q`3+zBnj}>a5IRF9i*dk@l*Y0 zaPxO$#RmJuW`OMjSQyT#KS2Po{{MjB!gkR|0{v$Y^Y?v}4XFBcuDAeafPT3H*Z}q6 z(km_iptwjtV1EuVff6<61PSnqK$!tYGVld(U_gF2BPRcL9RIHq5Wo-@86@n_AtoEw zFUCa)W(R7tolR(<8vHpKxzvWZC`Q8m9AdI@{$g3c8o|X3JM)yW0n)>z*IR%QanTb3 z`*T#u2AqKXOKbTnS^+qJdrn3!^N4_4tc3>qhY*q#*d5Mf1vd6yEb9X4U<0Iwvv99V zZHS9}9QF_4;_rrl{9;*vA^zI**#PO`jDK8eLtNzJus=tKY;3=X6<~ z3;DX#hPa3<0R;3jk{*AGc(8qWC;V_?VlRr z#7}pws9abq0fB+zvU6*|5EqaojP=ivB^dgPTwPc!Pt>xxKZ<-#8Uu ztp5yJ{!Tx^Ck2PkSIZMM`h3B-#07_c^JhaYKuZ|wpF_(Nrgbj+fB_%&xl``Md3jk2 z4*zBd_6yJw#`@>b63qFFT>)+;=t~r>UsSR-fO2JtF8K%5o2*3@)dgh#F1H`WLz)vtBd2s#QP%p0`%q?t;OtnmY z_tU{x{~4^jU<=@|1p9eqcHoe}dG%>95F8BtS(W_GZJEDIQC}<^Nwt4F*1era*?m-_jVuz$Y*S zXgg112xuKY8~*z=hClB;Px1GEJ&obd2mhJIkPXUlf?VYR4e;~~^y$T^U4WL;Q?Ms3 zr^i4~FHV;B(~Fa(?DXQ~vpKyu8MLPtr?x-2>%3>qQ_G*UocDZs2IAz8PtO3HUYz%Q z8uxwLa^CZ4r0;3VdCy$uJ)cHnp8o2*=hFzhla|v6w9||8o==00PFv1FQD#eMP}O`+%hxNxoyr?s+PIDbTu(L*YsiB@{oDhr$0@)CFBvFOiZhI%RxWsqnQ*87hOFEZ)EZ>$ftEXj!~ExHhXBi?L&{05>osA_8F z*qk=RK0CkS+~wX^k2yy=>4mc=P5!hXWm-a(OVc@5QwRT>lMg8m3f#K;KINv`w+gY> z^rQ9~;6uFzhd2CLjr$vE)N@~5;>J{8EaZtSxs<9(>*tJ2$;Ol3G zc;lg9M|N(%@S{F8uY{b#Sq{$18*1yl+u=Q`GW`AZKy$><$hQ9zmsNz=?lm(lUnxkQS8-SUaPrup##$cY8}Vcbqj+Y==k{%DK7oQ{CVsIw%$$JZ z(SB`;+z`w2iX##o`Qw9~b`6#_eRe}QohkNl9Q_I%gcn|cnr0mm2#oY?e17(dH^uYQ zn;xNq?QSkaP2J$lyands0L!c$vQNCAsw=qTgf6R0EN&(eYFKNdXBlN7%trNu`dJ;v z@K)j%$Y+C&s{H_aeu5urm}9MjGZ;RWdnkGjTK6VqoqDCo^P;ytEEH1?czoT&B52RP zk&-s*_Ev|&0w*q&J3oq3=V4AE>QO#JnQT?#TLUyq=4!0Y(Egh=mI_k@%pFy%o}oD$ z;Dg2XZXfb~PeL#5KpC|MbXPl*>*-q8^R|9S>|&DpKC7-H!#9>0+Ie5#)Uv#`^?}@B zGygfwL!m?HQ`Bb&DU%^#bdxz7aN7l|!X)pPG@c+I*CH>vp@S(mpxg6LNzocMQtZUc zN`%`Y9;^y98^Oq3zGCl{!E-#%jk0B=h}-kE$6CkDk}tVOY5Q0^^r5BO7lG7zkR66( z|2>w(LmdT7DpRxf9Hunu9d-{(llZFAD{The6zP2@nie;s5I1}4>`?`3;j!`Qt@6s+ zksNO!&MKr+e^O>^_k%C`nW(uTm;B@cv3Qw?5p0_)W#`S8TZ>#NlVa8JIdXF!b_!hh zTm$XJnc@&S-sgNs%uBAya?s8nj2=Y$PSo3rZyHr7M)lCMFV?512D56;xjL^=ET<4I z+k6d?X}s?`ZD{fwx+p?yOnw=x#F?K;v! zO7_N8(bV3DKQ2KH9;a!Y`lOU3la|E0-lerG{gQ$WQnbZn_;io904oBHaU?8qkjExg znetdeO|G2fQ(^;yhOgb8C%3ytR&W7hRTjg?kDr353sd$O`v`W!qhRStOby*Kc?rc6 z23M_3jAg}`Ykz!`bbS433ai!IB;xI4qeqcpy*D}~>{U3;k|MbaIW0xHYw!>fJX`6>3$_B{T2@oG@U;tRp=QggP@ z*~d}f$`?;d!=iPpNBH&#jy`tx{iv#}l$0Y|-(SbVXpnD*F+FH@B*0Um#O=#OeHI+7 z?4Pp>$IqB5Iy zTO^c>Lx=iI<&m47(_^xVPdRjI^TML&HCRT*q4srZRo#U$rHsnKz6pmmolVW}7mW1t zd|zzsyfpqS)fysoM6SV7{h05N`3dghLR51F-icsU*b@1?*5hL_E0kV1*6x{bYEgO= zk+{m`E1up2FP~aVu6v{sKa}ipZ2lmP`iyGw-GmjQ&QmP{B=p)h++5oj1$DlPt;pWt z1I7u?WaOU!VLi^f@x$huc2C#lBqCE4~++u~=oLLXRw&aG*o~ zwm>T*JpBO8xGYDJN;I^L|Lx0Y%rDxq11?jZOGlDH&Ifnevfi&oB5C)qQz-})q#C)i z%LvQ#71rKny^khCB9#}7Db;varY}F$NDWW>ZibN#eao-_^PHkgpVWfHJvp(pou*&S2-bd~Rawj4)K8^LVKorjW+!Za zf&}3U^wCPG^-ZBPKqw7Yz-&UAvQ{c>v(g>$s#@@_NHVDVxG1{9Hh9CjkONmOTZr}T zLwC&zZG7P@-~IuG+y~MrDjz*kv=bjdl?%`e@*Y4Rsx|&J8m#ZO$8(rRt=6~g!sW3q z5ph@InLWPjr4@{n<}jL1^;SCMZf~%iUZm%y~5ek$5DTQ9N=-NR+h+=m1f^sf3{%yjVkYM zNpD+7_loCDcpbN_7hoZ6)+Pls{+kGdxF-+2Eu4?kgyL08c#r-t07Fw+_vER61gO;z ziW+RLmF4xOW~DOG2R_W*RlnX%(c&7Dwr1=%Ul?6h2fLl`_mEGaS-=iqMQB#2(240o z4aRj7NtKGhqoPH`*`m@Qtx2%ugR8wHR!vIZLztqnOhp5`oA>SHB!{X#j`Ja2Te%&N zRE}1Yo0*2^f_C*2M?NqvKBWm@+TpuuDc__2j)#)_yFNcw=Dxt* z-2)^_CrNIcTT`Fp)7<8s4Qr8(KCm=Vp8E9urB3;4opRDS#MuWcEfsY5X*)Y??K^jVeR{E>l3}Z`tdcD7{e`9g zy)kP%9wE|ph){xvD;$XAt+y8%)4#N}G)BMcW~*`C=KEs*AmLHSkF_elu5t| z-$HbW(3ek=hGaYezRyTQ?$Jw2dP*0xoJ<6XMYYt3erR8Z0$Ok{RUc#ii$@(9w^9f; zG-)`j+of@MgNE}3T*6wt2wvjcqcFGoh%8lk^;VFeqyyo6FsFtwjj3ryXq@{;F!Ww6 zG%n33%1ZV9R*F(@|64VQS7B;T(VD(B$+OJ{RX3MH<1ikkR~g6^LnF!Z(}!L{9edw@ zayD$QNx}xYipQ->b(^ai(6Xr;=tga1<({T5F^`cvT}v9O1|IaFD#zo#e<@q?TDF8V z#v%tU=Dvv_ZG+hD@KLM7F22!wl@F)=l%V!0-iXqTn<3rC9^N2nkxk;%L}-)ZofKAK za@Nq3Cw@tE`*FP@UURs2nkFP#Qt%^^6*w(20qPL*5NuR{SU#!enFbUaE;E{K#pOx1 zdrm3T8zfJkFiautMoq6O9N3gCXeAs<zC1a8oDzJyUnoge%XN<-gKS%Fw|Kduz z$jQ1*%_ zkNwD@5@Nne7LJboDn$wvnK>^Q%V-Oi3K27NX3LIrVhA7epc{k7jhE)_6NLyZXp(Dp>6J5|+s%Cexwx0^d1?#0y8Ya9;bS3Tx=5wVR^e{Qu}_Yo42x?a_6RHRJ_ zb}F9kvoP!X2-G!Sw~dzxI)agjSkaK_6I3Pegj59w?kn9V)Y}OWl28;-J)QKDiNC`WjR3fMhbEf?;N$M>(SGhWDsW}@= zfj$VchujU&(*Km~rk|6DV}n+P6!WsFJ0lJ6u?X@4`^l=j@E{&323~WaUjZ!#9*+CX z=^#|@ffG%FFvd--3~}j8a!hAI2lm!B1idXthgzW-=bhJC>Gn`p#%5GWg}%O%=f;tdFqmNcR=q2psYu zLEb~C26AbV%?7^kX5pYooABZ%tR?0xv6$N7_mCCu(8c>d!~QH1bNIx>pP8I$Q4NS`^x^ zU{?Cy>B9PKC!X2Ec5AgX#6q_>R`^|i9?c$Tm?_QvJueTg$!0GJ-p;egy1Z{JrM;N% zV})hV*UKCQ9AZ3(AE&|1*v872IHEYH>jKEDXCM=3!*5!?lVY)Rd&>6o^R(UB@EdYb zeoxMBwPWFcH2Zl;YY3xlOWfVB@*BB$wDTqc?#GeFuj6a6IAg;4KUU!@a=&_RCD?pw z*DbXRb*3|gwmsOwi^iTcQfTU{(<@cGvO7DXxRp>isNyjw!q=}NnfhpJ56VR$8Fl5e z{TE@=|3}?hhR3xeTcQ>-Gs|LTW@fUOnVFfHnVFf{VrHUw_rdR=awB<0) z)SE*+3gNxgFl*?)_9bBL&COAM&8}ELvgDxcES3iFKj+|lZ?%Ro^nA(ZIS_V^gJPMk zo;FjGn$7uDutXZ72l8x0b(9sl#BCE*>fUL(% zmZC;x1r6EFmRF61$aDQQDE$9L_VZg%kFW&pUepZ%Eb0n!@fNw$1{zz~vSqt0xNf3c zbyN)8&1^x!qIjy1DRXZ0{Y$N1~}&VpPV`B_6P;e81iUt&iE?p-W+*-_jpltc&WY|l- zU&d^9{JZR@F|EeeL%?8VxIGFMbqTn7-VYzls=#on8UbLHgO|SVn*Ij$X<&Reg?u5Kfh%A*6@$}&^{Oe zhxWVF?honLKW{|V?)6CbDQ}L2q%MZ5-5eX*l8GcaNrQJ?!{@r4Yh6(^nOwAq@20^? z6AJZDU>52nk0f)In29U%CHpmvIT_RhkuwKE{Y#K>(x5{Hehqg{h9-PSFr0?wJqR@F z!?-G4-!qNO+scxnG|T1bCe!0h7*|cUZf(^R#B?iY`1PCwN#}b zSw)|Z1pz}>dq2qx;p0R7TGN{7aahQH#Lb5pXnmgvc|C12GJcky%1(e{rLxhXe~xDA zKNBU&Y8ALeflG4N%Gd7G8D#9+v*TB_ZPFB^rlA9kS&1Uw^Y>$kc`>0GPa4|;B($*W zg}>6p$d82bBu}#+-P-%w+CvpO_bg^;L?qBXST{U(hD6`^oaSX8(|j5*+qGgp{e$6t zdat0VcCU#;kO9k?CS$5Y6+Gs7s5aQ-{}aY*AmC=lk%?9>mVt3<*1W;Ar-wT{y5C6_Cq(BviaP;e)yVw z^ur^vOf-d!Op=Q+sVHzbN_}~~RM?0Vf0Aezlr$pCS7g<)xvxls+R}PHzaHre--2o| znKNLz#4ntI6syS-)VAA;t^p!=%jxKg87V{V)kI<7@EH-+j8-)zDLAZRh?6P`DR^|_ z3Sy%8nb7e&oUsqw>sJnmF$m$W@Q3*gIRSn|I@f>P=maukYx6i|A_f=t-_w5a`@&XN zls1(B3?@J9d3`s+fS|EP=Wrwm1 zdpb9QmQnF!T~&z@iQ$c}IFK-=IOS-ZXGuHn)_b1M-UH#Xcz?t>&Bw9K^{ima$x#_! z)P(Xl8wjNqtX{b7P&0i0=b+@^&=9}JF0F)DDD;^6^VpA*#k>_#V3E_c>U8lE%`MC^ zMYj6*#cs9O>|)_$#;OM~NDKl@KTH50#e0%%z~Msib)XY&cK98vrC}LCzRe3wYQV1E zuLNDP58hFi?M0~gSF*c}grh`*DN5({19M-{p`(qrhT{AU6X+9V{#Juxte=FFw8MGhf*XAqX7DpLa^V zFQab6%pSSsRKaLvD-M4^0u%hCXnJ_}7fe>SO^)6-N0AX9mi)ybCYAA->jBlovvEsd zD@v&1OAi0A`3$5Xv738txqwt07kA1ZpiC1WO6|%hy>pf4iEO#~5-Q5BWeNf=9);gn zh=klIB~B?QTvF}`C63w6HaI>G1%I*%ho;K41XwwlA+lT1pCjOF9-^m?ThTMFxyryi zn}wkQ5AwzW@-;`a^tbF*3)~+^;Ek(^+tQCW`#0ZP_@TgvvEC8%E^mu^JLT|~NT#;E znIW1Oq>(JsoW-o=fS-jAhui zIm1qFr{5NSc*t1%s(Otf%EK6y8`%oMQtcP*!V|krVjxbQGg9y1t-KH8Q=FYfShk8I z(>ZKO<25~@Q+c>?*cJtP>$~{41rk_wYur%Tg!d{f&Yg;sqjbPx{_E}nCXAM;pcM(c81?Xn)k|fEdM6qHS2qD_U~-Ef2qL7&hXQX z^~;6%Prdgbrr-Q9NY;0L)Stw2{J-h_reOTDy}woNV|i!s|IRM(H@%-uvcI?YpXvQ} z<^ONm`$?AnxBdI+HvIo+?|-ZJ(>M21?>`G>_$$4P^(SHbHxKchNAR1Z#QHyju+8+h zph)(2e)0dcA>OU>2U+4LMfop=_#Z;p{(CS3!%tuE|K*7IN!b1!-tx}Gd=HO(|G~#+ zeK*km0Nyt9-$LNn8UK4+!@o_9ciuMZFIvs}hpvfU^;3k61^@l`=ks^#(yGepo4@Bq#(!UU-~auqy?+_zXKyv$ zi5LvO$r`^FsGt0cUla7_lV1Z={+-A7kGtb9yZ^S+Klm4nzbG943I9SPX0I8=J4a{d z@WWL&vJ+4^ASYu6pch%~GRTwMZQe2yj6cZ{3*75-67{G-!jo8bzo7b^JIhEUaRdR} z^y`p|&(m$pMz{A?r^n-M&PK}P{dh@j>k$;x+8sFZAx5xaCu+rpVzjA zb$F-taJnu}6nGm$cz7UHW`SG-I-eL#&YPa71)~!;7A+ z$?3)A2buc{cxAbgR=a{k%#Edp?aO_REH9375);1{4}T{kr%U|#-cisi+i3B(1-5+c zVo^L{a-}Nh#IC7tR$1=ahu0*XoIW+UtZ#EpJxkx3Q2=td<#;ZmY`!@kUYu2fbvd4D ztOZilVig}R5*`KbXQ}vM<+el_Y(Ct8_B|(qU*95w`_YcZ>wpzR9tP3L5`uh zp&JN_X;K)k+}wi`JrL}{D>dSjdoy4}BUsc|p@v)VbkT_txRKz&9Khkg;R#d;g^O)r8EQeBacCbXSiVg(8 z4?4o6=0=d~DLJ!m+4e98)jX?RUJW+o0asm~*7sgIXBrldR*?Bm*DGg8GxDQc--Yda#@hPQPc(J>G zOd&P8Q~$2z;5aAcQhw)J;?sV)HGUP%t|fO_@f7gN z;{jM+->p|Xb8n0}exp4nds3OQB03=ka|fIWg_G|4qc_`vi>Q3cJE{TYYP`a{m5a@- zBPUy2cI|%WW&~i<)+H!g6q!puH~m=ce&aDn^%=$Ni#*^D9&XXy^4fr{l4GzbC_T_1oc|b zXQ2%K&n05{+HP(@PckJ3GU9C>A9(+oceHR~@ zM^#|64eWCcQNpUY?GfIPrJS@fsLY(z_tqdKD?T?XptWlA;$1*Le-i!tmGvQ-5>3a1 zWo};d-F5SV?ca+HVNX9DfrGn`-${7Br8^ z@!`FNxTqy#hIG+1-pLC#1htKt_rH}3^cprH=Lcmkp0Rz7YAM4ZDl9I&RP*G{`)zk{ z$=P`yICoGdO_fzJycz0D#@;qN59{39|TYbV%F0`yDOXu^(hKSgWYPGz~8aM z(`g6ni}6vEX;7jwdn!NW$%|58uehi{ob$WWU{Io0$B-`|=Q>s`D9W_# z;)D*?gBbmF+4jB`)=~*!9S%C%$UMV@y>i(uG;o8{?eO$kZ3rJ%gM>c<3adG7LFL{H z9t(o)+`P@xidjVN5aCU)PPmudgKjz#g3Xs3oIguE8Ip?(6_n7kxwm>e<@B^0gX#xu z?YGO+ENV}I=Blt7*as)pBsN9*CV zX~blserJyEKmq~qJ(+Oj?G>VI;suhJsJ}2<4BLsZ9J`;A?R<^xQ8@lbE}`I(WSS~Q z$b>v=YQ0_hE-UC>9jBuSq!XkC36T4GUyvmX4tOqOwHHJ!;nY0GPl28t=KBaLz=Z@v z!0@dUnV5b^?j)UQnjkV?^ao$R+nT(h0&i#1>hZih(icRXcI3S zh@FwV-54rLi2&f5y3Ze?hvg`51nVclmTA4ptjPfqfT+0V3R@RR zf{vq-=(F00YL{sI8QDaBIS9LknuOhrPQ>0B;|2oZ85E8-qkvz|T|vO01)2UD9b4ur zw)w_)%5?4uP?Cs-xLp;QJfYzbS@_}12e^=a1bLJkD>@F6C#XKiduCukE;82RB0Y>C z#S%*xnub_N4@9AOwD|JVaMOJro=nz?ts+OzIQe{H89PI5Qpw_pvP8{l0sjRryG;U2 zfN}0_J99(i*Y9n>k^p_(R>ZRliU&U5H*0DT{(q10`#D|E*BY1(^4F(DcYnIR2@2_k;w%7a%TAmoiHAt9drROr0WkcVh&FZ7Liaf*E= zRoCNW!aCZ9woaM>PGd-{69z9A!(1{HzIKe6ocPJOc9$YjYihP69;GLo_9Q;)!}w5{ zyuL+RMwkhC?ATnE3FqW^LOGt0JP~~oy}nr{?tP~Fz_x{ELQ1UJSdR$u@+5|uxrRph zHX|%Ja)>YzsZgI7&Un0^LvkHTv`~WJ4hXbdRe%QR+$T!xp`ORKiyiC3$*ZE$&HAL7 zjG0S!BCl0Au$wFK&Qu$}_p^}-z&={50{mx~>d%Z_5ltLn-!pXvv zimj^eZamdj1&2$L#RZ)n0;?xFI-%%Hgil!S6-8lN4cTf4Oz_f&HtAPFKOs2Cs8@BX zFme_7vwuuUR{DmlGwY(mgRf@NO+?**i8Xj~O8)v9zblDtz^L8YDx&7;mtgs_wm+z^ zB>&NAdmakO1v;#hVu;Roz{aSa9kPfD;~xH$Rt4kL~pXhS?-eCuyG;y2>3>W=~_9)X5s4#(w-Fx+9)+41(;xZK~(qg`cA|A-1Q4jFVdyAAmhl>fj!W z%jgC)?Z<+wYk>vN4?2J&Xa^ONXW34^6*VJr!!u-+;Una)%XmAn>6>tjL?Kcnai1~Z z#E_Cs%Jwx zMuW;<9T=2wU}uGfB@q8bu|Pb$)lQ2;sz4Dse_1u|Q6 z05jkkf(Mno-F8xtlW_dj`^j2BW+674JDTs5%X6dJvc0P-pT3Bbf$f~SW`<)eh`8S=*-@_>;Z7r? zOuFS5IeiciqYAgO1yAN_REiCWxn08fqOF5!!Lb7hdjL;ZQ80tm^=e_2ITh8UKBQq` zLv!76<-DFj-~bKmk04@mfq>``dE#8f{nKN;Na>WV&`l9>H8LE(_GTVI@o}m-Suv5M z(8&b~UAK%mH!wJ>Gn&RG{Uiu47Yaq>vX~^cx3X9z&x9%n8*%n05t%q6voA$)I)&c* z!L~M(tIo&eQI(?AoCJH`kb=Qa2wToa5vYPg#DsMI5e3UJ^=V)v*>+&F>vWa$$_uuK zfek1ZRz7q?22Z_qjv@dlq~m-Oq2aN3(ylyx7#Kz2-&o!!<}=fTT^uE1WKW^9tFFA8 zR9`xHG9x?(rUeR{9LPs?4kILnfS=nD?rUc;Dv&UBU% z+cCy5?ki^vAG25AB%M*tg~uT&KZ48N!@(t3xK})KMS*yT!oy)rf*YyE^ zN--gcD(LI^cekDv{$qffzSPA{?HTPc>pMu&Y=0op%+0>Q6(kNOd;3y!fQK{SCe4aD zKV?sfP!qMC>XFFx5H2;P#9I(9F*;I!L#h4IIfUbFFO&8}2r*%XTKn)MWexkFg>kHg zZrgy}hrQt&L+?POk7W8mao4-W1`@`;uD-_IDYF+Y9#!WUpPiRDaQynP{YOSdQN|OP zuwwwJlnFdirSg!q7~03(T7@s@Jo;u-vG>t{*t03Q?N`xBzii)&U`OHGWrp_ivbECH z94%_Y-a zDM~!I$RME)0A~~kJ{bTi4K(0Mh-QnZ;oY8(4a1JKowJ9C>A=WL1r$!onI{jKTp67LbD<~LdHpjfVk)$a1(V6pxK$q zu(_F9P(rjCc^Lywgfcwt(DVhdpLSwj9>VgWX z_MBpgwQ0$=GxKYQH0Wj->g_koFca+^Mj+22s&5Ha9bG|VXEO)R;sw2&LAleLj1?#z zj7V9XVdX2bocr70$K2(L+nwxA*jKkA`14EpJS6&7l5KaAZWY1>xCAquiTJE00T4S< zQ;*SsWLn|Xt`Q;f$=AaOj`(rj5J6Fkq2FHXv) zKQ@C*92xuGhF)o~fMq4@3c$ufX5_nZAabvkxviF=P^DWZbqS%$V<4Akd?+yunM+<% zfTi%D@VBIAEEx6+3ETTY{7{HC^h2{7XyD9w-Rz_&>rooYR$UygfGE@HR5?!s9t3V2 z_bdk7n%I4K?hbDZdWF$UH6&pSwOzn^pS?NG4msTx3RcX|RaT8DU@O1~Kkz%t*y`Hc zr`^M-AHzQFHG7wP1tB%l-CZx=+;TW)zFFntbt-)4!Gy(XX`hkO)X?WHb>;;TJ^7Y+ z!WOpCywP&v{;GQyjmT-$aelYqp3UE4Z=#Rs)Vb7e{vgsXmJ)TaFVKqeU|1nOlFaD=uG4bT*>)T zg=LgwX~l8x6&wwgZ9<33cWQJtL^)sqy#i;uh~ADZwf^-Tt6Df;_?Tzlw6=r_I{L=7 zv|B)Qzv1Qi#M_po$ocR5kH0|EpHM0@BkN!MkH5g)U)bz>^_)NakAL&)F}(ZdewQcs zt3UAl&HwPv{kQaf`vd>!pZh;y@4vzY|Bk&g{Y3Ep8p_J_CqVxngtGq9{f#OAKf&Jr z6<24+{}rzI6LJ4ngdP9S&i}_)`!7TMx}JZ-(SLr-?>_$%NB`ZdndN&KB79mAOFc&; zAtM7D!(ZXp4vzLldRCCGnP*xWHtTH&-dj3#(;)Q-^XRMC)Fr{FHdZK(#o)N@Ib){V+i;B!?~j|7z329tH+JtFpG_}r zrjlZd;+nn3=ZzcQk)8Rm<0bDeq-Ik(!xy};aKj<}Dg7x|TOk2QxH_3Wk#H&G#Q;9f zKTdXDnI83?#+TZ8W4d22$YOjj-|ok+YJ9MKUYKHBe)Poj>$cs{zGZtO$dBl~Oy6ux z!M!;>j9)}|M@ypP4s*Xf%Q$9zu}W!-4jHf5y?TDEFs(;WmEOW|Ll%fWnI~lX@f_1X zy=R(Ylo^Sbf1$V~6tg;hQ`^QWI_Dxv?qMQlVq+&5Ht!cKa)@!%K@iu>JX5;Ki;Q+F zNJ!#(tT>`0A_1~Ycg{G+w+mgJm^JA;Ojx%=W60X;Wh&qD89E8Nh6ibkw_2>w%F2%m zHyq|kFLj$3E1_-1s8lgDZK#whm$&BUivZlX;ZW{`ZDtv>M1qzW6mIxMj4+Pcabjz$ z(C#j!v}%bT9t(lFT(w^w&Mtp6$XWR;x^=yBRe$|tm+tL})lw02A!0T!>Gg6qcXeNI zSNLZ8ayQPXg$=T{G$7iku@xi_e-3m~=(vxFy&k zRX2koL2PCVFof{guzG;e9AywJu-{5a!DW%FWUH{HxzEOCECM|JFQi;&vI^0uIzn}3 zrK@I6tK+}XbnqvC+6)mVI)hIWU9Z`LE!txF#LR@B6q@tm3s-uO4ya%@FnLVQg=K48;F_mgJ3?V?HcK!(uJ0l`PT(hMm; zBYE(owDAUqO6iLnZhsKb1fNn%6-I#k>KUq(hzwqEbtO+A*NR{egB&^0cZyEgOEk43 z+hDw_M_!$2M;49$NV2CkvfqHK9!PY7>(ueZ9!-`_bz;vSd6ULjcCjqNMHP+xO>y|1`u=)wH=-JsXnWW;{G1o24do>KgsQSZ=_jwa!o zZ4-T!4v5*pzRF#gxq=f+ZQ5PD!=C;jT<*jD%fClsO{8hY;nIBm>T@Z zPkiC1i8P(3RLAmSa-{I-V9SBvV18e)yUCSjvRp8_S{OFV7Y3z2=EV!L8=ldM0*4r! zBAkBcsA)@-?}a@}S++0A#p7>ulVgf#)R}Q07P1M*$xX72WR5;a%$2g1D-eV1ftMi_ zj-n~hmRYxCgDG|^3!7lK7N9NQ;(q)9XCz-;4Z<71j*5IfYNud_E&>?uvD<@9ZV2V= zpU?m0J9(a~fV(7u@MeKq&ceY$fg+uA+)koj0A`Y_p~ z!<|_j?i$NZ+hNmZ;-}X4GWHMWPIR)x_=IM{CU%G^lx$KT%F&UBSw61E#eZ!=wb(%y zBWKm-x-_huVIP@2D0D!NjD&%0x7r(2mapZ3qLmh_or~_ypi@nbn7=HTLTKd&^@l{7 zPSwJbDDw5uBPD)olpvvX37|G{wk6jVXQSBZ1MZdms>>rG5@LIby!;DH686+<`eQ~GwSC4$hzmJP_UqKy^&D_}U^ zcs|VzSgLE(ALxSBNY9`1mu$FvF|z{kWBA6wS}6hg*wp;_gG{%+VQo#erp|NqGU}X; z4u6jgo(mneCgE4L?GXUdJR+Nc)Jk(DTX087abZp16l?wzr4O7&)ZBR)x}$5uuaMJiTG$QpK1kMRnh0e&e%YCa}{ft1U!{p>$mS9m z8`;>fZr_xeg%&5bahNuzBfAaiVV_{EXM}a|jY7k%LbrW0ZzcsXB1t`T&v^u~CRbFJ zOL~R!Otg=b+LEE$o6u!_qFn^btXqU9lq5gzhML&fs`v9MPnb$nzl;C9ma5G zg4Lm_%^|*dX|(oGkH9|D!s( zi{90W>MU)?N-hzNYOAvW%6p)^wg@f$i&KZ0oN?X4Ll^m z&Jb2JBc%S4E47&(#9->3zZprYw4cb(>(%fTdBCSK%=MNj@(o&Ys~_yjo9=F>X~z_B z=-ML~IN+vM9`gF>2c1=4mj02UjJYq{*la<=h7+>7(@}C&9O{a`02B{-`+QKZqt}x} z4T2qyi?=IW08M?!gluhXKPam4XF2i9ObBJeI*veYEMReCr5x`2g`&=xPS{ic_d zn2ZDyt96n9yMF%q$a{W=t1ev@V*IO$(i(y3icuAcRQhU1KdTX2 z=Ba1#gK4NWeDcCLvm8&4B279eUg`Ka3A)!S!i1$T^sTgP<)~R|+j^XzGG=}C`ZYzJ zT*ozA9YO}hx>86^q}w42Z&s>y?E55UY44dbT#Bw&FAyu0TisM(Q%sZwy!&!D$PBYb zEk2hs-~kGo8CcB+(lg!j45bP$PL@bfV_oiu-hEcxdrNeW7ClNQ`?qHKC94r-buEwO z`k9Z>){?pN(PGr!Lmci5phkpbG1$KRX~V>owUx=6oob!^+E-s)bE2@$RWI zHok+NItn(j~VEX~qq zJRLT%_Qtf&C<48*_4wAnUbcaT(V+0AX8X?p+(-me>O_tP<2yrJxgPOy47jit_Q*0o z5Hc2I9ffpF^H(J*_O)%2hK=Uq>x2oqFG!aOx+e}tez^?nQ+?G;OBz%s+MulQ`G}vR zh`~ii&79&}!ku1Q!%fcuR^rN9rd`8_>2Vvs9B>s=dfBLX!C%#}%k7DM&j_TU%8Ljb zi(lQak&}%yY1v6cN4*9?0Z1{?U8bWd%G_LzKbw30s4f}`-h(JsYfITX_DbasfUMmZ zmaA5E_Tw6ur0==xo!&P({*wO;@L@-UE@9XM3Z< z+-Z#UAqna9FUMJ&4~1%ux8$LS4LKM!fjrWtNzFN+)mBq4UG>e6#gRPXoOc2DjA&n} zE?Cg#XZ!o+l%lrZ$Pz9U*|?-by9_^>)&}a21b{EJMGB6r)DmvgTBYWfAWb2-?&-ha z25zq;8z>tA_CqWNwB?k{R87V>SfaySobP(?bVU!Bc+NUiP~V-HQ$aU`+{i#iEBB>+ zN6XP|o9`;>`$j24#}BcIZV67TI&8fpH-WR;g0h3JEXPam(Am)HxYhB2pw*e1Act>W z1Ck1+v)(YoBxdS*myj137&=UTdghFOO37a5FfS@FR8KpDSkT%N1gQ0-&)1-kh6F^O zes_3HmE1XA)OV)`UC&JIT98eEg*$;T*a1$=P__ei_C}CBVsg++iBX$GxE)?D# z3d0?WG#J$m%xUw`j7~a5x;C1Ac}IdKlR`YZEjqpn zPcv?e5w3)Rr63C*3bd6Rt@6QLy#BMnbAihR3VK># z)BU9=Tys`t5Jsl~>y?4#U>0S#RC=bsD39T0jg?ZY!W5S&gVK3LFqKui#pr=eiZRu` z^mK|!opiMD#S+d%drBVW?0U^^Q;8@A*0!DwKaowdL~s!|4!y>-epnRrmrZUV{pt-Fef5DRa) za++;V$3B3PlMG=8r)SfZxQ{B7BJ%C<0~3A@H>fuil}Zc^^<`WT^Le*Bkjh2o5&0{W zNFoU9k$w!7;bxf<;t*j=(a2P))iW82JKI)8h1jRh*BuGeRX`*Iu$>@qh0e*Efirh` zl}fmo^2@Xq9ImQsvgV}lGCkAzoe1Yo@Qo~76wgZWVlMB4AG;+4sVs z83p%H?6}nrglI|X)^fihaZ+x(C9qA+njyhhvw!YhW$?zs6WK*aczf}C9KOfHHMbkB zbR%e>)fTwv!mKu0!WnFhvKYk>aV#n8Q(M!luR3fq-6(6D++F72 zQ_@!RNG(_r>+8mlyknW&%yj$j%QaTe@o$>A4hKCLpD(V)ci!5eg+KmVjPf^Cn~8;; z`JXIMroY52u>Bj1l9BGcNamka|Ne?mGW{iH;lHK#JGSCK#weM7We)onjPlPcVgE?C z$Mh$b_n%;tztPp7-{Aij80EhrlmEml|M&di|CAs6%P{{1v;1Y#|AJZmgM9pd#4IIk zzP2KC-PasB_|9As%LDp%QZHTF=WcIHHU%%VI!^y-!O@EF z>1z7NGj03Q>&dy>J=e=~+uqaV_KN{JSC@YJWy?kPIgc#umUNEi^Y!6Q%iG!D583`V z@6EUGHvKVphmS+FFZCzx+&``_j?rjZkAmMcf3U#*u((gzI`hHdJA%E5e)Ha46{}K0 z#I7k3ecZX&FE}y+s#m2|Z8_A0wrvLDcn2&uWcw{i>C(0BtQ#4qT$Krj%pNauHjg@w zJ~NgzG}o5Jlge8ahlzx`uFkS44Dq61e7EAIR-lM$`?9Avihg30VUmwPklox!`0Yy3 zaQ;3kJ9&kq;0Ke^s!*n#8N-<#t4w_3uNQ^p9Z1sHsODM)s1Wsr)8grArBNqj;japl zq(ko~gofG?Ux|)F(1>Vm*pwK$8b=ANNPadNo$6BTKBW&F+JJER&Fyl>=>CyXC4dY) z@nu{VhzP9T?CFYus%66mGYa729WC#<&vfd`Q^@Q1bbFVXhuP}rY`RD)AK@<8L!=O) zX1@vU&WOT`2NAX&cVJaO1Np-Q)AcRGsm-o+lSIG<=Bb87I~O>M?G6c6X=?2N-<=Kr zKD^6y9w48ngo-Bu?pUa=C!u01zaM8%$~>(BcHmTsU6c_&VYVDU$gCr%3Qb+h1H zdT%CDm@jj`8e)5 z2dF4)OafdW*l6%pE-rr{G3?+@I!wFelSR$as3>@q~|cC~u0Hm|fTt z#9L<=^34JiDN?v{i!J>|tHPsJQ?1vv73HA%rYiIK#^?wf$84(^6_b@}tlstt<%z*( zk}FG0Q0KR?P!sou$oRVm1?6b|h}7>D%#;@aI{lA&ff0L+0ICipF1nNTc@GuvC=Y}0 z$tak2eUbf;?txw~BdK3_qz`$MFD)TK+8u9z2P0tgfyF(HVYXzsMycj$`3&yBVoSLA zI9&(VS_TA&nT05=Q2fLjp|oi87*eOEHI!h2!(Mcw5-oFx)bQ0c2}ix*A`Ab3>cn#{Lc z9u+e%uUB>#vD7>k4IU5$EwpAGW`yJs&M%%mMq-LMOmZdK4euTKj3;r<}^Y5 z4q@38G7(4})iYu41h_>q07kiIe{}WZT4NvfH`rhZYtGPrpNyIz7J;xV@hgQt+KNwB zG}72aUEMqapWd$x7@U~f^kIZbb}u14WWP3=2!JrA>+OtwkFP$kuxpighR(|F$Znh) zzM6iTzW|@(P%@ya3!!GPkq>f$3h+T+mHrZd#@z@V^Wm3(Wdqwu2r=XFr|hox=R!l+kk{w$R$PY{QDPB+(T@kPk>wW7i!0Ba5>b zOI68U zm+&r zyzd1tgDwy`4CL4$6Hc#QH;KnzqPnnqBMlk9ZRt?vjcTMLZ{#?(hyjuBz)cQ~&}#~3 zia;Ftw@fFGW1(sBTbJi2k`%pYltb6LLeJ9cKMPCY4)~2=yMD=v}(|SX2H! zg8+3jHEXl6k>%^;*wk7O|94<7U5wO{WhjDig%6SKj-LdS9@07nM{Bj$6o8{R^{zmc z$Ld>{W=T?&n0#l-rGQe`S|Sx%;~;2=hn>1V$FasBCe~%D2Ud2)*&Y#FXu*ty6NFG zXX%Z@?3_Cc6u3Ze%=b4vaHq!CH{+@V#+5Unere5SkZ(|GVP|fyd0K2YgSVD}>EqV> zoFNJzc6LT~r7ux4h+<%JM$O;uaB}%PK-+u(vA8SZl~i`IzW73O6+vEB^kBi3u2$4! zGJPt&GBwuRz%Z?rmWw(`R5fH1MiQ(Uze`}pGj%y)qBOW`DaeF6j12^CL z5@74vF23Lt^EGL6;rvrEwl5OmsJOf(&g@zyqFs5BI-Jd!YzsjZ$3i;el#)?;QDKRD z_$qkqg7_rey2vH!((*25c5ARaYA@BMWS2}g09wD2nCuma7xc)&#@fc_`Fm;+IEW?f z!AvNU+XLbaj>cprnEQ9q^t!TtEmt3iNf6CaC|hQDtMv3r!X@LqFK0_bW3$fr0j8Zi zrXMD>=RlnP7{I-uqQjzT|JI!xRZir`B;q;Vbqt5IcAJZx+s6Z#_6_Xv&b!;p_eR4HF2>F(YeWPlKZBw#CtR3-6B6}yk#^X>&HR`<1c8@x&tRSdw(NpMa zcq6mM94A#ssTPFSnKzr{ar)w%`I89Vt!WOes?Z{iYBt%7MbwZQT#2+|7n#S4fTH^m z{(4N<8|PD01pKHrUF&zKbmBkG>s1hYza-ha^e^ajK_$1nrj|MoUs>$J*_~5(gm>2+ zPh+67^+gl(H)3S7qdBrq-yWs0$Ayj?+xyaFr#akX5ue5-EHSB_MT1yknvq7?vtN|g zO24l7x3a7)J$#=q=V!g<<4jq0<7=1{olwEQ+}6#P-(*3G;}{a2_i(NHkpHFRi0ZEM zywo(n5KUwmESejUrb?`|hh(6=)z`yI828>wSSBxHBRn199%H}Uvr0BVc=U)G)aLr+SGpwEO24^PsiC8#Z6e_^BWB$)11rLD_(?u$0Xu-sA`i}xAF_xb1Jfa7_E`?7Qn zCCNwU7{*Z=S)T<&gi1|ihGxo3eo$|?{T_tr;F#cTKh$G^CKnRBi#dYZMw|jU@Ssf! z9F#qpocj~BZ!Gx9s;ooZ#u;xwUy1@}^Xz38DU$YrkDF$EMm;a5)E%V&`4%On679vu zHvH&CMYUM28404iHgXP%?fX1BkXxKE9%88pxdMl!>mzUhIBcc2u<+O3gQjkZ)c8_^i1W(2!AXFrb{5AT$FnL{&K&@8& z`UvJ+yKii#n#%!ZBJ7q{sIA(d&nk?zx}KFzp0y*W2!nvx-!0L#pc? zB;-ZGc+>!>j+N>VGgQN2TiU9mxO1Dep0!~SmRA;=`vO~OnyYH+kfu$Rado6rXmUNm zt5Vf$b5yqT?54lP#ql;Hx959UMU*Kpr{ft%3|G$ziTmf5uL#~Q=d-p(K{_*x4ai+A zeKQ=!R|xkL9R~CkIeMIQe1Hp4-4V$ehi_x87YbL7+isw90EODK)?5N@L#bZ=at7b* z$?THaH=LwcJx{M(oYrcnq3hp_90m_FXI9PEyx(WW@a#b+@#$o=u?fnHW`tP*I^c#Nq zk8z)0g&E#?Xn!rU!2D-;^gnQ)KMD-|M{(i5bbn(W|4(qAf8sj-%2N9a&hxJ~~n|8mFW;(Q{@^Lgk- zt4nL6{po^xN$O?FiCc3y0&Vfd$>P<6+XJUG4RNiiah7>2^{q0CORH18OPx!dYyR!c zcB}BE`b`D}M!_D)>+O2=yQI=Xf!pOyTi5)1Wg1zfSLNH|&0|y761V5!0VB10r~D*C z*K^y`yS{$uW7L6_Om#5Q9g(cs@ti|gaCv!sM7jx60qzk$A*EG*iva*zc6r{t^ zmg3bCGspMY-AP$yrh4?2Uu-NRYRwrH$W?2U-{gzNh}PLW@@KDEdJixm{st_>ZE{@aYOv1%p&Z* zFcaE6D8BaL)Rks!(n$#{5f~wWDYQ_~;2ul%QCeUc$%*%FY&^({TXVhLDMI?~V!sus z!f^WK{{A8Nko&WbxZ+Y2x5k@v8R%iuQdF1byrgKEn?f%6r$)+>K~RZ$*yD(n(>1q| zw#MBDy|p=ulRXD|p1BB!RH}`}hSoHg)jlLLoko4|N@1>qZLrTHs+HhDwdlYOR+*4O z(L0~qEye9C7!=iin1H9_ zxh=7Fhb905dXms)mEQWafNKJ)6D%Ws;hgLRMP3-|vl8X+wZ|#I-~(>rvwzecrW}j^eHmM2(Qfrmsh9sZH$%8)JQATT|Olx{s#OZ zJ$Y~wp*obl(s@#>7B{)kEnlxzI~vL=6K*UyCf@_qv6RXbD85Q!e0(*oK3vMzc3anW z9W`7vT-7diazF|HIeCg;bx{EIsbFRBMUZpmHc0KkW^Zhd3<%hQL#3$-+i`P&d{IVg zThRvBhDmSw8I#S~Zb}*35N2gKm3b2)vjB<+LDGa-Wmubbu>@JC^yr1`fby@x!QlzG zAh&w0)W^$~cIEyaoW*g5*f!^B5T1Z8G;*+oAZj?-p>^dsIUjW=lbwxEr zuM9G~pKzP^MKhg>URe!SG^*#hp5L7abdT!*Q?mNj*&Z?k8g&Z=i^KTQ1xEk`HWQSz zB~D~%98O)T3x6dIs=#Idc9tg{i!;v;!k{ll3U+p@-4)J%HN0Q=8CZ0E*ZI5rvSrs~X zAF?zDLXJ!g+Rc<5QolQPoVAuYq5T1gC;j*df{%%aUUU>DX zC)u4&)a~As7_KQtSn!@LGKxHbL`cw5BMvt0T)|-qjMX^1OA#ac^a8m)Kvo15z!Gql zduK9Q49WmCjd)NNypSEmz8`pzE+5pgajH~ky}HMHlN4A|2)Wjoz++VH{A1?SF$Wom z30*pBnBneRp4HY%Lp35SJe4QQPD?sJ)88uw5@%5fZLm1y+LXaskw%54E?ykaJx`=f zRcZlng-O;RGbA@ZnkcVg|xq9^I=icLstX*y)IOs z9ZOd3xHB0nWSH_mc%pa2`tbdPU{=3R=zqkU^`q~jo>2bH2M^z;#O!qgrL*vk$AX^5VdIKm(4cf~8(YdR zj??x-BQS}4>E)1sP-R(g>E`RQSV)W&di^7(b#TN-z11*+HnlE)Cg~%K$xt6&QE}Tx z=n&J)ozwzzjsR^a&!XnXY#Mb^>_Bo%zpc?gI2CSOns4m|9Au`dLtuRg;XT%bBAC9t z)>nyF#VlQsfZENr#84>STXZwiXf-V=F)S==eu49vM7j5$1b%n~-TL1poKq#AaUf9a zy)X8ej8c5gRvUjd%iF0(capw`Z$CwQ-es}#I|tchm7bR~in)EJ13iJGIo{6s(D=A= zR>*nT2EpQxj)9L_h#Uty>@K*aS&!uXIvuX=`@(0Xa^>%xhT3j`|Ff?^%vkRgv2l#$ zesWeSPrq8(Et$Svi&ty*m1oi*48M|^xQGNTJ{_-3*>+`Od^JSnfY46`_xRpz(B| zB7OsvUOJi?I!{mD%(&X2M`F0y{BevT!9$`Q(r*Gn>vYb;hXpo{i2(+6hLj9GKgi+D zyTr-?$0Cv12k(9a08=qY*`4=cfAS;kAk zm`*kbW@%5fc%0gyssmJK_J9J$Y6yCptje^z+$_aIhpRDepd_~B!b38!xPd(2TOjiNl`lhS`N zWZ=KeOEm+YNvWa6?W=^}BNPuMl(V@`YlgM_7x;W|w1Pv>AbuM~b!AxhJgX@}UvV z9!<#l-#ILzq{s?Cn06LuIIl+5Z5qnhRv(F^+eYQr_-Dc&7ypQpCNK!6b3=N4LZ*n0#Td4T(n74P_w11#MI z%!tKxG`ZH9cjr5h8Vx^ml72lUIkUpxIt`$|Ga^=i6}whCTk-2oJZCpxX@Qry=GbzL zOGU5V)kNGh(_H7Dw}N)s44vcqq4Q<;D}wro-`~XsQ{IBJ`8sdJJ5A|gHLBccrFiO} zW@;BME8oUGydQq$m^922>p)L+s-@C5hRkIt;-tx92W6tl_o!n`#wv*#Ac4A~nk7|( zwUsTdEBeE=ew4$z#IQeL`&`bP8Arf+$41Qt(V`~IDJcS02n4R)ZB!8^U;`}%E-`pS z5-3fd9zlRN*%;9uR|bv<9$06P1Z+o;HyH<_S0E1uD#Vv2h6IdWh!>R_q89@dSm#s* zPMT><^qAAGI7Ng&0FnJMd>o|5($Gq)eF(RwjNk5J9|L*=P9xS~71PlVu|-uIMaR%6 zGo4kqZiX{BlxC(FY^?WvF_stjHAeAUh4b*BLPBX`ir+6Jh)PZNejy|sW*&VSL<^0_n-8eq1Y}i??y;CYR-WI4IvdG zBj{z&CxOl5L38;CL7uYxBiD2@8%7^P6v@%W>s7y=f77}mh(B9xiWe4?JVM=lQiY2g zzDt0fqGpofd+7A|^9lKS=`p8mh5F@4GWEuAf7N^mGHJf7j+Z>uMsN#mCw@aqbFa+{g!fU!be>IXHpyi+|!j5Ivka732z7USv%ouu*YRc0F& zhcCrWLaT^S5s56hw=4sS^V_$Vp9Av(B2?)wro@Q~7+!lnDWW-b?O}ZAz8N3qGXL0X z2GU4*^aBJ+UFIG=+$0$k&9LP~lET-7ld)#r3*A(=Bnw1Tca_*Dq`>XZ+kU-Y_N}5g zq`;F*6qAmj#{SnsX{{eG864SZJRmiPy3={`MRIE#9UkjD>IeATKI{kAjJzFNSgeBd zi+ArB1oZ~=*$*6WON&cM(MYe?&Q?s5*Y{_EA4byEkZWgU&w$0Bek5QT zy9B@GHuOMUPgFpfMWJecmKi)7+1qsE<%{R^QZ>3o{yp)FT$9xEun@OD@)Zj z@)b->|5!DKskA?WhxCeA$9mCEQ*85`%G5drb)!m;UkWa|HXI2ZhIB5>oe2YW!>i1C z97GLx0E12%4LJ=c1erPp2xp8{DNAonrO~r{{2)#CBay^#x`H^7&0uF54-AvSoIW&1!|~{>Y=$#QkAMG0Hkh)2h=rARnP=;9Ha!M({k(XrRUduZeP|v!izEb@9Wi?&_QYXB!=B zV+tG0Xe;KiWYb>ccYo!?NO5>uLkARJo@OkAbhqP<7U{J4k>&|^#1)DDmJE|CPALLH z{r>A7RsdV3x^&OdSAlsUYW?T0`!w4Z0c0Uzy_2|=MbK%X!voHj7{w`Rx4`-J!aIf{ zV2@r+Dl4Yl28n(2Ok8>n?|GnIUTn?uLBGtUN5uf6n9cIun``!tj*;o+E7%xTe>!RcCvWKwwZf=uRZJ-3%xMdYV(Poysi`Jqw&m^@(iT zZF#_l){b>f_rv0sk;YDku6-yg*<`S5$9HR*!-!4*J{;S`eA zjavEjog@3@I^!GdBt{tAb6%ZZWUopM1+VztcINgKj8;%N=WcZp&+4+M(EY~~mezuy zQtZFke;!e&rKPJ^a-W#!pXn_@uik@jtF!4@5E5&}jlLvG4|xEt?@Y0r?lZwGEAri7 zxtDAbR<%Kpa3y_qr56rYWj-jB%G_-0=tMr)a=Vs<&8>lte4Nn}U15F+F1YqcWz^{_ zH}gbEh21}POA4y3=Stv$HSFxU`Y^d(KI80r_1W$gt?}~|6&(V$ZGBm23c8hj`j6@% zvca*gR6J|m>kiN6XY3qyY3hH1G5^4je&S6GOtdV2gE4=@d}_4sb3v(px21{^17t2YmI>HRC8@9y+}NfFc2(*0IT{Wo}*=`V@j-`9H=JO0zK_ubGKf}Zxb)$xC6=iiIt z?bPwE=Q^MZtVJ(l?Fstlk~x4JCCf9dyj!SLBpLh2M8MSQuE^|KY7pWo&Qpet`b}Pa=Nb(f?T@Xla?K zn0|MdzYef9M)L{rj`&mlgK^QP=S04Q$`LXk~6?xLqz5HpN{5MHn=Koxh_m9}$E%-m7Uj8fL@;55xzXhX?NiPA+oziKw@)?eFQ4kaN%H=Y_uqN?7hS{rA4~FzN8z*D zb}m&-yZFoyU_Ssr0j?=%fVk64{{V4UzSq8X?NC0Z__pr%)+v{eA{#Our4QsMQ6j|I zEuSE(fB6Y&@G4B}?fa@1*6R~?kXBaL%hcA;<<-NgoSk{A;j0tN%iY)$?6oz6>uUq{ zN*U;^K&v*WmPi!^H5Y5_X}Isv&rl3>Q$Fy*UJVk z_N&9=QPsN;@6h#*l(<(B_46%5_}W2I*F+ad#Wl^##cR`CUl+&A6E=)jRv=CLjoafJ zbt(Fj%znhqeoKk#)0v0db*)KF{G#LM+*B^08aL_4!#>*{_%p8PdWxsJ!G*T z;O!Hd@%_WoTvgR*>MOya=i8OZ{)Xn`?amX!+U@z6DAd8k)>9VD+dMZYF$;)eo!2kE%QCQ097j zH69OKGiF#f5#HBCBXhTA-2H2WntLxXA85)^)IWl6B9F7zh>otkS_&64s6Cp&Yi zpkkP6tI%`NR2FkVE92tkQI4;LO$q23{Y5B07>g*eWTI9!iC@DOIO=z3m@+J1;<8t6 zCX$G+u1440$aayOeeVhka`nc=!${62?L6Lbx+2yll$D%Qr@ZFQ& z%Z95u^;MIji=?X)YC=`uq1Df*H;smi3++xudk>2+LIxZZX2$GD%4#oSO{PpIZq5?= zQ&Wf>sOH0uen7P?Q6In6#(<(pHTZi4E$s#wojFcujLb>a7NAyzx(`LyD_#(K-4?S_ zaJqTGRiQSI%QI4&5+tdRnj}#IEM{am$;-&KAycO{H@uhpqH)I#FP!jRH4gO=x zsh6^A5(15S)t=*;vk#`oR@W=G$zYk*@=Uo}5C#s_2Qh6Ku$aey2imSb)?RKz=p0E1 zNvfGKQFBb{+4&T{H)K4io?R}k-ih~|(5;{&seFAVNv{nJARl1(+*Aj0z0$0bghPm6 z{Bfh`UbM9kQ<{|QXw%1{&piUCMqbvQ6MiST3)Q0CPK5Pcdo;eX2}YP=dy1SrM6<=| z8y^L5Rjj7looW0HfwjS4&i1kj02wS|@=j^GO2JI0S=Ab2eBW5L${6aJ_FdQ_N-`_2 zDVViKl(^25k5P->kI`Do4xm1VR#qr0W9>3Q(a`P0itWa7ZMz>UBoU9uy5k^=LSycq~pt*g7~FAA!PvlH7Afxse1x zH1hN2{Se|d|K)D07WKsfeGOBHcWL zdC;nIDBlV$x=f(dFOyneod6#8q+DzJB{@>$kbqn{Hs+qNhjV1VcK3y*6$L1$Wef)f zk<}QM_W6!9ut~!LciA&HEZe6U2^AQ@89+Ejb42#4c?Bsi}O+qvSS0NmR5+PtKRwKD}t((C70|blcU<(e|Grsk;;H>^x z3VdC;Zu-51P`+=L=EJ$FZk2)HOWl#8AH<|lupz>^aJb8;sGa@CuhTWcm~<}TWJ%{lsbBhp;b z?0k>17sN!2>Vz?r- zku{B;tIkLFb(#b-5gJHSagM7u`}2*-muCIfRn{x77wxEVuQvTxtz;QW^H$CnHhVVE zJ!yZD1!Bc*f}Wgr(f!^TM^2tc#tX1?#n(eHd&6%}VCjLIBED_>O_v`cl>VF)GDyrlpWBd{^|DbkTit_Y|Id_-T)h1WxH|Gk! zlm;y?!U|OI#IW3k=|=J+WKFQRoL$HuB18IVSgJd%~gceo!%2OIJL3 z;O`C&hFMnGhXIJJ^8~IQf=8~1>TiO$7z#O}dICJ)np))S72|}Na#>_ABtU~=Bq^XJ zz3#bMP2h@aqf1#}pCQXuq}aCKZJtZ1Q+MVPV`jwAwqc}+P3@C02UlUE87=Dqmz*dJyx8;e{#CEwTiO)4>!S}k_48=E3>dC{uWH|$z9sC-oMm|lLjX>*-P8+ly z+u-d*RuM`a;Y(-5IOmQ=_N?X<0b7}6we_El!0_)fI}=Fehg|^bCkW zTm>~nSsf9gl3~RdI#oC#SsSeDu>9Dh;eN$vulae8CQm6gEh2Pt7bqXWYv%9K*h2f0+6R6Ys(AU{-G|=T;w#$*NXM}xW{V?*aO}c3 z{oB4x{Er|X#LuY9_n}WfWhoU5Y{+u+nzyz|0youeip~80_H1(3$ z9Z9g9GrI3If&76Uv*=#8=qy=8vq++~S>U2DH*+WUOX*^Bn;QG!=Iv%40YvY<^7T#< z+(0qb83ka#l+nFl9nlzK-1aweuB6hPys=US(QYlowL!f2Q)q%r20Nv0B;CRnYZ>sl z`hA++moTyLYG^8->g)nj?lkzsG_ZK0?lYG_3sgc(mH-$4?ah^k!4V#aX^GQx|l#}pq+d;%wc?o#ADo}@J zaskIzTcjnLl}|YZ^=n7D=tZ3}NK8ICmGgLNu`HSAAc2?xA<$`jdAH-7E(oDWb+~}7 z+k!OKv}?HuQddIw49rfk{|jccdtRjI%u-K7Y)ZJ!H_%gEYwl*};FoV1U2ptrf%LJBCDxEk1 zzg7X>ai_LD8t;-O*Yus?O$D&RY~#U9o2t<3WHavh#2iOLoSZ}(*-@gE(+J$*QE?pq zCA(6T6KFFO=G~`y#izo3?FZXNwmkLJtfF*WOdtRoG>kZ;W4~3A<=avvt1ejQYy_dF z8$tZISE?N44P60M!l;h2s=DeGa1U$6AY**w_wN*NE9;q9Lfzu+$*i-n3tP3NQ%Wl za8M-5G7fa3{YjjA6w#jrlGepmn^A%-W)z9iO=J+TKThj0yT|%7;_9ngU(eWg!GYS< zOs58`CWEaDZq+}~IWb{Qg!8lbFC)9_N1Lk8GL|NgU)rj_`pczY<;gc=IDWAP9@x}q znl%cR>gM4PyVT%lA}IRM;>}8>tuYcz7FHL5ArFpxN|Z;p0)QaT8-TUwdK7?@X$9ke z57{OH&@Tky-p)}hQH24K)4kK&E9zUt+IMT9mFQuTw0l0rOBNRiZ3QHjPlh|Q)E3TK zkXGH@O*3kjZ3n#)wi?zph=|lBwOzk%`pC%F!_%i|>I7^XZ9FP=hjI;e7H)&b0bZPp z5tcykLk81Q@%-=y+u0!ry3wU}Ei94vh)-;AdmaIqNb*Nk!b8?CcmO+i{xdEDF9l27=Q4)g=-w2h$Bj2WwN6~iE0XK_yzXGjx#{&A$0aKrkBn`WXfyhC1 z)X5?Nun2u`pW7EnzGu~~CV9Vcc0Z{bre6v}X$kZEs0fI0<6~=vrzoJY)k3v6ccYm- zEK=A$n5!|vEj0fC+^Ax}3SdiNc_o%bIvDgFXUjCWIc&xdaJe^Zc>@b{$oP|B10{7# zs--%0rXWsHaxypDuEt3?oNxCSM7BhdC%mr-*j_nX^<@*$w}Vcnsb&6Vz?{5Al@baK zIDGA3fDemud5pat4+)PpSV?dgWtNA$8O1I1I7>vd<{et+AAG~@t#DjU`$1NDBS98rqh zx&@F<;SouW?ADT*3>FGt^DP1>_1J=@+P0!qE{{9iqmBg-su0ry3!0bBf+WBZm zo5Y#kb|Jr{{K3dHO?H0h^p3zuI6xzey3yrRqy`qC+XYqY!LidAi;ksj29?Q@a+{8o z89hqtvG$?0WBv{CeEIib5<(1m-zG4K2^1D3H z-#;8e8eyG9_&aDtH{M2v?r5O6V0VE5Cg z_Igw(5mgZle#zTHD349l+R3r0Y6sdyw%s-R`hu32$|?Hfm+)+KzuR~GuKgcRp>`MB zt;6X-!ugf>MsW>k=srxQu-R zO*0w6>A-|tg^giQo+Rg(D!eK$KZ;ll>v_8R9)i5qGXcYCs6x~2z>do4FlL6|VV~$s zQcZ4Q8e1u_0MeENg)GrB^lf!EaEvUcV{naR4Fk*$xHXh-r0AmBEBfTJc0F+7<3;h9 z_)DXi-tn#D=Bybh0sQA)&w<+67M3z0n!X+d76q0v7`D>{xodCljCd?w6AnmLP(lOY z_`G$!r>N4Zf`iA*+3C>Sype1XI3Uu<*i>G^HifXN!1k3DJNc`Zg*>AcTG9(}Rt4m_ zoC5L?P4>+IvjPn=^7Nz8nQi*R{-?>IVjsrn##lfLQeQ|rsU{@;W<=WY$CX6m8{g8z zxt{+0bNElgoS$rt%J7f5h{|>GB}LE7_baE?Wn!H4_sAl6ZfHw^<-#j46o*=j=t~C_ zqqsXLyFtQvqbE(Q&ThZUV;L0Ox(4wt=0{tyu253!d{j8^$%b%jtHO5v0L0;)YSNdX zvLjVW2)c8vpN@%49xO6i5bps$4E_CD(F{db#i8C@v>nnJh^8ODEjTQnh}+Sp88Ql~ zBLrz67$BV3CoW*_qbWh}pjGucmoY_{)A~O2U<)JwV%S}L-71U62mUx92nRCLtGsDV4+zvuJ4Gw81iL`yjd05y!2tQ3g?Hln$<{9 ztP>keG%J1wuj8hjzQ+jSI+gk4JS^rh_okDYw2F)*Vovv|53AwT6YkY+9`h4wHr``# zQ`JqtgtPcv6=zgF5a{&of)014{u^~n`%e@;3lkO1FIMmGiZIN-spEI5`hOMocm3r5nQ~^Jp{HW{sti>kX`|laL|H|e4 z#n}C)4Ba1z_|4EU{~;apcSUdJzf<1-qTyJ6>7xJ7v!+Df)p3yCX}DrLZ<(+(l8?OJ zx3eE@!L;jrFhE#=I8%W9E^sC>F7NOYuDK zF}<|YFB;#zUl!?{Z?tv2=)9?Q`QOrqft_nZn#ZR}=j-}=?bl&h^pv?)dThd@TG z4bf-CeqYBy(~=5$g$#WOX4$1lXU=lTMRg3O5?0u6dnTpQ&Z3k%A6~2RkQ*DoFB40K zv#l7}&E@9l?DK|7_;3r8BY_@u1S!nTgr|2(inEp4(L@u-`I8^`j#(6Feju6cNHCNK z2Uu7Dbg(XnBWCnZu^p^kZuT9W&Lvq+cU5u2itU{b_BAavWgL5r`?)%xDu==%Ma2{_Npv?M0D)w74Y2#_9#u)wJ_0<472~K;OEN4Z$Kl0c}p z1>Ow$LS908yuttyDAD9;kxLTej%twVH2nnr5J{shMKi}(q1_CULw7~-UMgU#rd3#k zQhxUn5_q*WjX^TT-X{S+_b^@^HX_&>kvNl?WsR7`t0Rc?VuDrZxHNc^}QS=C=bbLMHq8U&G3eA(Mf)^#MvNy$433M7olLI zmS648d-US<89ZY1S(#{2a`c{47Zmcog6fA(S%coE1dU8qeI1`1!cXy^vQ3_4V1mBb z-5N+Dwgc+{mnDEdONXN$r-J6&J*y?kN+Vf+pzG&(Zt5XL`dRbC`k>|#0>>tTz9%FRTV z)}yg1p$xH#`4Wnh5TbS1x_xkSb>Q z`#oM;C?M($hc~bv0WCLs5*CUZVNUoRHg6zEMO=+K#_#k6#^cj`D8- zci)p4U%pJ~-p4mwDLpw<2^lxUDQq6^K5*y59Z85gpq0g=w=zQqJLHj)WHjHjSYpKH zx_7u^d@5k?gEv&1&=oQcUDlj~M$|zdWQEsrg=JFaFiZY6lEf(mhmngKG%lt%aZ1QY zuz(@W?dZmuz(qQCoz9@7a4I!|L(E#EB@p>#vGk!iiJVsQOK|j;%*_U8@=0K>o=+cz zwFweq3DbXEeTLGe0;+

    aLwL>UE<*24j^MuSD)$sXY|#rH6w=Ug`Pji_8TmOd~)` zE%6)|WOhS(A7xW3riz?AXX6OIEhAlf;eV&COl^36H7!n@WB{z=&wschou+Jv&m+Uf z=~t4zbtg>&MVQ`S3)?BYjU-Kg;s0@uK3opoX!EZ7MO#_V6Ip}HQuo;S(XiY;MgoIe zgDIs;F(r!Jlu5KzbT*fu1m(ssq4Q8VqG6<`VYJ7)w2FhFFzK%P>sVU6R!96)pQJ_8 z_#GOh$>hx^TN%AfcstV`)uCMIa|mk;n4wct-q>vtLfk;{5JA;!{ty@4Cu}?B{zk%H zOa(PH!#fijo8#0!xe+Q)-v zjwj0~naA|SXqF8=q=nD$=V)P-_`?cel(tqXdVHO+cuJIYGWz->a1;8XNjhC%ErOGa z?;oMuz8ip?)Z6F|$Vh&B~Ixs%{%Z99JBgDY6WK!ZGZ6ux{YS{&ddtY9}i^F>`(hb;r=| zQ=OZ#)TiwT#I`}(QomTFf^T*HPGTcE()Q@_QZ`d=%Gvxr==tkyVIdnTj_w0keFw;s z6MDgzHx0_v$$&NtiQV)Bhk4W7>K{oD(?%YNM;HJCg2Ra&7aVs?YGWKO>$(+e5s!eQ z;L2-q3ji~rhuqFRaqI;KIbzw?6w>N+g-aNoou5#lOEj@IJa|eZ3#Pl%l93z3Vli_q;o^FPp$SSnUBU3qSB`NoT$<`hlhd8 zlSHQ3JO($ko$#BcvXDTF$?P|n#t3u#3t>wy-A(q`CgvaqL(z2M^~R!b_d(Q-%DG)= zE9^X_<;p2RPBcBC)GRuV6xRt+k4{VEMqrvs$*6DJKvA2kGi&TX=qOF>47|9Pqj8b{#1RUzpdaXOgPWJeaK}WMvNK_ zbR=D<5RFnc+|a36u5AXaj~~i)IKsP<%*1vr4;- z7;HQ$r<3L4_=0pS0i1J_k!`NjH<-ZeVbYE=Wd@Y$wYpQ&q0Bv;?`n>rml@9muFp=I zP#7gqo5@g1VMdv`Tys4}yPr1X^p@YXlC!@OS;a0aEK8qmbH?E+h;p6LvFC=CnD)o} zXm;IgzStwwfaT3>;;W;36diQ*-`dk&#iw@?ndl~q;ZCrLG8MN0FeuiVS19`rK7Nh@ zZq@fsxX+&G8-h8&mcZeHRFSneK+K{LRhwp6+k&jILl~8xaiGsRoYTzIUWhhN(pB9H z$Yymg@8g6p(fR0f=ho6h4zpdUx+87KxMPAlDUOJ#TuB)x?$QhjfJZJb=BIOaZ{}Js zbJ;SB6OcgSC`eR-HOsUN7=)`+{+&i=C76}ex~7QTm#5o9lxk zGKa0z-N9ve!T{!mrD(IVT94CCqK&Wzu~btbif5VoQhyc7JD$2^FxdJ1RAiVjQSQYb zeGG3ST&VdS+F3|h6#>UjyNO^9@`ZD(uqy0zb!|v$Xn5fU@Hnwa-0EKiI$9L zAYsFi%#RZpH7k8R6e%W^(zNh6fcQF%(-8|;a~0Wg{~fImF%rnF^!mVj{WXbp-6@Jw z3(a`+autR!EYq~clpg$i)hA6zGz6^My6HpfvVEa4BWDKP7)45vTexE(V7MGIvzE`) z0-Ld@-nphY{As=(58v1;!~2ETVo|nCDvabCz}wXw{iak>o1+JxAd4-pOY-y51D%*X zNEvgm_VdKKjs#oE3BEB5!@+G1Ez@A@jGON06N*afAR+U^t{>CD^}vI%KBHJmli{9J z7p8oYA~mXEdc%7Y6@H6-tcQvGQF4jz;JNX>vYf7l62nXTAxC7gYV;n>)UMCw* zFL$fxuiB5dCldg02(dS4vDAvns@NKxjOAbJJkggrf(+Y>9jPbxWrazYBp1|C05i&= zvLoQ5kHoa56pzU9@$tcAE=~_6^JEvEYz&6T2jAhy&emU?i zA!L&tq~E^Ibj4tcnzu8zlQ4oSN`|4?qd4=q9*0^Xs8~z}o*T6%&cOCax!Nz-FvE|M zA!)NXD%9ooe<2Iea-&6bINoj^5|@yy^ZNRNjl={^@lVLnAFskc-=E*Bxc{bM!}7OD z4s`#395FGzYuNmPX#S2IvHXTR-jSn!ile7zq@wv%VEu1#e?zMNDUSC2dJMFG)S3U= z;@yPh*WJl_GIW3{`hi=&Y55_PxaW}Vy}ZviA%eD&CpCAKn*T3?&aikgm3 zu5DdQ-aOcCJWiKiiqYTQ6TG{;o=&b?FrVjN_l|b7j-=kk1a6Zay}AtF;hxtEInb&H zzq6v+*@+;pChX?T-14`pSGl?Ss=1BV=oiI2>C7#rcO_&YFiU$lEUTo-=jWGB^3UZ& z$V$Dz;dU}RC8oCT5;;X#X2vKCmtvQXRRubAIg96?t6PUlA5r+e@>H};01ohfB-I@J zIIrE`S2&o$U@5IXYc@GGCr@Ob$(gV1Yhr=-aT}VF&u|d|iw|#Z&HfnaixWbaOhin~ zhXvGu9Cm+!LN`)*c2O$+BA1Uy5XEG8721BEVAE8kT%bZF9!quiO;WW9H~1k4lMUGx z;T547|2$XjY{#Mo5zHEOwC}+r`6qDc2pPmyJrVuZuv&vkv4F|iAVi7EUU{1jjHnmc zDL3{((Zlvhz)}5Y@2#>WE!_EFN)y_51_z&Vs@lM(5ij_I!A&~nnyx%}XD*#~TSxAQ z)XK*-q_z)X33ELyZ>R6*;EFyez=Wy3ihC)!`YL-LyXwYX;kM+fX}rUc)K_dYgaz2I zM^!~+RWFEnD;D;vy_q^=D9f^sP1Yf*5WqQ{_f0H=CQt4z6-%ZjqbL%R+wX8q;I~-A zb-vqqPv0YH!hYefcZd6ZfQDf19xh;YcIYRbP!OZR;jX1sP%#T4a*m3W z+O}`3(7_)%a9UtYKK;8`SQHfO)4AfVJeB?G!AdV2!>dGc6wbAYLhdA_r;zrfI}J43 z43!;eAfm-Ud|CUhUkYD&n++a~EpWbAZDI`htBfPdRKolORN!Y3O)p&b)KSIP^{q9T zEw%yE^RRcbg>)6uLJe3d*J^&Yh?|;jwPrGZvwh?r?P@ej{*eAW#O{^gdO+v(fzp)W z{YgDq%JEID_V7xRxE}_;LhX|i4+YHG*PQJw@Bh~^YCLui) z!%%V^)(4J4&XhufI`Qp>;fi9!`WILY&wS%K_1^rRWS{Aqm_)yYekHfW?f3m&z{eKC z=Kw^hX9o1F;M@ds%b(y>RDvVRp?ChMl$!=xmTCD`Ej3o#RqhZxkE(MjhZu%)W*l*L zC5IQ)yhjGR-H)(8V|$Xg(h&jf2%w57(ph@4?o7BZDT$yP5Q{y*HkWpHF! zmNY14W@ct)N-;AtGcz+YGo_eP%*@QJ6myE1rPQiws-}Bp+ID+>?YC>DAJTns;_03U zduHy}-H&6W3&b*aE6nietA1XG^E~NZnVOYbKJvn<4rgK2yn)-*=;fAX#TMU3_`oHe z>l4~Vb>Rjwp)H?={GMqelSus@n%sJHtRBzLnzaXU%+fbckm?`eMW{J_J`P1`iM~<5 z%FE72VuiTifL2B4oY}f`5B32qdk=J@OMzp3RYIxp&gsTExFVc%5D4GIBB=;BPMH~! z0nWSwlRIz^$@*x=eHApueP-I=r8K|UfF*O$>D%om2UD|6b%-^Vw7}?gz({Vz8pTQb zy9(!BTFS8F_;6`9Zz8dCQPfS^46WZ3!VUW?#-}406&z#=o;st*>>F6qACAgZ8eYgy zNJ)*sl&CY{zz(p1qYr8Ka0D3P^d})X*b&Nmmj_j5({|A0?_z)p4T#j-c-w!6gL)#n z#Ujq*7sPXUUJU*fJzuezR^Yp{`RiA*SQwL~5}6K^FIucR|I~TUPVO z4)bnevJp=|<~fl`h`5Q4(cqAowp3ORNbEq-i;GiX>T1(>v95#TzMK)rNitb|C|~8K zjD3Y_zrvUB0=o`UjZkU>zqC`vY#&Rg5z7&uGBZe-gkeb(H}w&VJk>y?ut6(Hk5lk! zHb{0JxL7e{W9F1i-l{=e)}iVjgWo9)ts+@m)i#A~k8xKwwI=RFUT}<6FqYTArzDFZXoQliDjSK zVe^G*9yddk7i9YEA%r-U>M5(6zATr`6obE>a6F0cYDn>Z-0K-qw;t)*&uneY)mut! zgrkuk;BvW^aFk+<{J7>wR#&UwA}lWe0KqyZ;7c7oN?u?kyc#*$&>l1%xLM39bZHDj zl5)!y(}CkNN$cWF+G+AUgg-k!rs@>gxoM6}jLL`vgquYd$Ara^j}jkjImC$Ds_Eq&XNJPd))4$uurjkR zo&Bw21OT1Nv&R^qq%73a;e)|qGFdOqJXeTU!wyzGTz#z9;S6rdPa_$LQvRUZh{(7|(^q21;#)4|T6~L{ zdH>5*JqMbb`HjSiM@e3EU3{EY;nY6G#H~3^kRc)d{^V@H-u;45mIERCGZoSyV}bGs z_GzM8(=4_Ax=S4|n-ZKf1YWjSCg|7!f-(OAEEjklg1z?LiJJlRkoT3o-U)e<9l$FG ze(N=5hz~CiY3h`3_z)2?E3ER8-t(4#3^3%|j@H|Xzz%_XI5j#)1#sgAi>p4?FkiVLo-sg)ckUhYH7sp zr&B_>@)vAxHD$n@1HF1|_TH3t+$k0%Zt~O0U2x`g85CdlfJS8V)X^Tu#QO46l#&v0Mp(WoG z<9+{@uEjvCUJVL40!mLxQ(!&;w_y9|ZIbFyGvD*%AV=bj?? zm7&6e+oLMIUsvN4zB7NfkK1+7l=%6$IK8Z@qiYTv>RI&40)|g|nRaAfL_91ksb%m=7m{qeiqiQ-ya*AFs~TN6b%fEe!x5_BwYO6t;X+ zz!v8>Mf~{otV7`Ar%Kwx1~v;#A+Ty%`g}oFkuLx>*+w{{GaGv{NX=*{lhispTX8+s z&lWFkRfmjFW@)4goOX|Ag*1F@45}_yxw;+^78dns3!i|Y`PS(F3UdF6NB)G|Uuf|k zVhzrJg3iqU0lEKcJ^%~bzl7YJ{{)@?s{5}w4PO@RzpdN<47oY~2|E9MzyFde!14vT z|Ajb&^Piye|LT5!Qwsk+1pXgN2xbO`|Eh%eTKIRB5P#MF4G;fcQ9}H82>egL_kTIU z{I8AwPYC=sLGeeI|AN3@ul;ug54aPt2hBHIdfyuYmLlztAb{M>T!9V{^y{Dx5DpNc z_c275M+d{+eT&eFQ^ivTTNZgWfpakx_6pUj+)(*{pPcbm_gc+ykbv_I=a{)?-y(>OH)E+^TlzbZd7ve)@F~_Bg$m&lS{tz&$fRNVsdO?VmJ7e0fx#cqxGd6bnES4gO zNZFCYZE67>wwwbgNS#E9>N%QLPG?Xet|VB3NzTqWh>==YmSyT!R4DgAtVMdJ>nMi*{E`495)7xtvj98A~!*a9#emh%Er`rXp4S8PL-K zL(-uDV!_^uTQAu%fW*EBB|}Ek$N7lTL63CD5_Zo;jMBu^)uSq>m&m~5ZRBo8jqm&F z`tlq|fr#t(`RK%*P#Hh_`MgY*s)DaMPK~YY^H%;Uv_SAWa=KoFuEHz=a#kFPLwf*f zX~D1<=m*k6xC6uSJjJ|vyXJ=j)XV~vodx0r?QahJ2qx6%A<20LwvmU*^XzQ%^8SMt zeXS0suwPxbq8PD{)`UP#N+_5IT^m=)E4tz<8@R9GXRk6^iNo~^n3k$*IOrrmk>p4| zafQ|94)`-Nhf+FmUkB*r_4w98AOc|(%MdjQDM7q%wKwo3Z)a|bPp}s>M>)fWsy;3e zG)VLS&_Nh*FKp^}eJ->>ZiY<=OmJ;V7=>2$0;qW`Q8}HVkf_jKR0NNG?=Yd?!qJ>^ zkBPI7gGMz1aYP5WSUJ1MD_V=ovSmrJf{zMK4_%?0z}RW3GkG+TGv7CZU$-1pYPRLGUTkMi{u;snqdcZ0TC72a-{g{>y4>>7SZ?8S z3JF+hFjhsTLCn2OH5Ka|7PkdV{|3ZMDsd0q4yOn+h3J0?U5dU%pRKbD4Ay#u?WPK{Ccrhb|*wLm~7$1b6oaPD`YtT z>AHY3Sk-<43TvS3s=Km`kSp5XNDnh5^V{NZ$3+{Un70#DVoa`x8Kk=m*p zi!Tp=!rJ_EdcMf(2f+7Cg)Q7}60sSwJ+z9pLdxRV14^)jSuA@0z%_6%Q5yudXHM_R z8?$3Owb}WgzJN_7FrUJu15~)8rBzat2Dp{Doyyv0!c9P!>WzRnGM-6H4Mizr=~QPi zAisE)U58$tgJ_yYuMmIrQj}C$0|0Vna%;-gMC%|FG=<3~&mEm)0SKj68BPLm=o^25 zV2Wm$0I`wc9cwzKX96dH_0g%6L`55n1fJ2*kyPMFZ$u|dq99`LArN?O3IXKxNDCZ1 za92xzW^pSlct^J0%R}Py9Z0(;JVTn5{ibe=uC1wiF*uKai# zDHIHz#%e@l6fb4iugYmciHcCL@x|;-lJrV7HhV27RBrssk!ZW$-#ygnErQwHXMQiU zoN5v>yQ8(1Fwg#&#hh0!OLt(@U1!UFhZDD~rWihI z6#T`0VYIBE`&|eR><#8IMV#9PO-#;|8TCV3){{th>glDChBw_Lfq=g2N z5XxxCLW7G|3i+p-xYYD-TG;gA2;k?*^0MGv3K**{eiQS?y|BIsvBoGx<)6o@^K_Ds zn?}k3Epi7PbL0@&$?&Bwpw}abuOKSLQC``vgEtS5p^{E%N_iX)5lVR!m2yRgW~F>{ zC`;rRs(-xCA~^=FjRh^`8Z%vDTsxv!-w2l@HKsz=+VTh_6`Uj)EsAUoOZ)~o5V6P; zHFStla&rZwHmNqb=I{V(gz>lx_EE!b7 z2a2!1igS_izNBWI^XBU3tb=&ULDlFL&;52K*e-r9gY%pAIY^d?^vsWa?k zhyxxxvP34Qk%`(WMm>U<-e3*s=7kfu9E!L-kl9OlC-bS|vkd|{jZ+XO87N?I-cs!OU zT&6FuYzTolRk(S3)$S3K&wYIt{*JP<^0i_MPUbk&y_8NM;WI*KYRP+1*bS@A+P!-< z%5b?*^hE76sKr|J=et#35o$Twhr5neYd38ck( z1XpenkYz+~|06&TXwMm9UNmzyz*}Mty!WY{c-#1I^1G=>3JQY+?`TcX-=5>`poV&k z;RI!>SliVw^x8IvZIV|m$u7en&S_Kt-i@t2Fty~fKglHD!orLX5EU7N#8!V>S#=Wz z@^zM9E{)(=2Qbnxo%x4hEX-4}P|_&}4K@H_mEuf%jfTnC7$LU-+Ac9jB_7jMQ4F^Z z<3610R1$ZfzTXm>^rXS|r(Ga#j38>VcJ0BtqDxnU=QN#U`{-FW?oBmamFk;ByZoFQ z=YVJUuI34hq6lzl17JvHsan-#dCaxwYJa;d zwZ6RdYnXem@n^DfHoWTG?$}vK0~TQjcRZ}!oCdu!m*|`Cr(0qB4AuUbXr@u4+)ukB z=94YO2Hi#PXg#_--_b+sOUiDn%6k6LfJWzwU=j%n!r0R?BKeLCk0_D?^SfEtriNc# zoMY@v@W&r2=tL-(R;}!tc@QR51h}RBmeb|p4TI$nY;EFigL}%GTF%SRIkAk6R5WQE zsAxwR7sydcE_US_^p5fj(j}amP9W9Gh=&bmK0HCJEtAe#mLnXvC zR}u4wjV&2l>j8r8u5%#E9V>L>36}fHfHZcfag8Tf5q#R|A7 zmnG`@Sy(^QA^lh;J^C9l7R6QNr4TXWdTCxgPDp6d z(GV|aJrga~_n!UrrUJt$Y!=S)#vdaVQ+vKXT~NgD7eOs8&z;zOxFv6b{P}7V`D=i6 zp@b`OM@bgjSf-U788syh48AT*?PN`1j6V#@74A5@_~Cd??tkNKy$MmU%5!g~DCGBq zW*BW57zY>+V_nkL`x_co>2u2A7&F%EtVIts!lzFe{wy_=eXEg!K`Y$eyR&_EP7nB6 z5C3C*6$>njro_)Goi?L3eT;#-KHU{ic@2fxGo*i65WU~iE$zX#F%JBriXxQ zm;-0&V=A3-!OO{y+Axrd%#OS$yCbC_rHCLVMc;qQpvplA>I!7z5G&C(Ww5#_(e&y| z*(zs2%wgoQAfbQ!>bY7d_zYn!JmW+up{Q#{%G*b|%cum6NW@fc5RXq~Jlhz?`(Ek= zr5kb zIY%T?hm9{$p>}S+QEEf|sgoEn`c>R*Iq&)? z*>`dkMMgOtrlo_|bbS5fU3afYDIJmDQOpL)Gxahbxbq=`7i1#inJdf{>Vp~mMZyol1+644UPR}5fVj#zuM`7a~ z(+TIpv>9^yoiOE4xd>Hk1|KQ{GE&|mPFU1B%2(>k7;sZ?kks`PYf${)Wwg=G7P<}; zBj|7bwlHv))u(DF?;%&XJsvR6=x5SK)*cUwm{Qd{)+swOEtyDUjx6mhajqpyFJ8vLa*Y(kMi z6<%r(jHIi{|B^2TkS-&HP&WpG*>JgXKLzkHpBhGp26&6}hk&-Sv&rSVh6 z?xN3PM&v2*_s#2O<;L=0$i2w}LbY$ZhbL)`d`I-5Ayj8~b^R$_X8N4Sv{kovFzOFL zC1SKD_32t9Xj)!DL`5T${7g|#)jQuFX=N=evA}JL>nyxA&}s*vcCw^Q`iJGh+xs!* z=W4ihUG-h)`yL+8#yIA!?FbvF-bpF1VC zZsBxISNN+GaFBVG77M!MXg~#h+9xnSyPN3$B>(XP8vd{9{+D``uRHxgGyWG_(%0Ibew+Uc68u{Di?REE)T8`W z`~M#@?r+*n>mTl;zk2rf9{)kc{Xx8bb@JcPqr`2r{xO?-meb$lhVW}PH|X*mM7)rH z0Qe~3DB<-bnfhRq^kaMvzDtziQ}`=Iow$NxoOSO49-E%ZP)+2J;muuM_iy62Am??nz;O)-QEHm zhAWTwTk@tuKDj;~;MeS?5GtfPj{W!Hh`?d9n{hN%`VK2mvd`lDU3Ya+ zov^8+yfZc0g4BgEtI0GorCqwg+80xjaY314=#&WUWQN%AOYk8cmsOD1Z5r9KKqDmK zXG7IU*e9I*CCvM}##}TaBjTT{S$4~0U;~)Nej+W^SCmvAJ~(MAOk-|}3oS3j$U$I* z7Xhpz)fY^yf&yO5Q{P=?{B14fiCutVLv34_b{-7Nabn|0vLcU_?0$(D$FMf z`hQULL+nW3WE#nf;%fJvq15D!lre|=;1uVtOyjL;nye*(^}FN!n4Jo9TFQsE3rjAvCMkrp770p(_e1iDG~FTpf4S=H$%cf0-R-f*o9 zNAyM>YvSe$8`%%oBK!0-APda^Rn(!8ql7T-u<$O9C|y`1vY9oajP%yZm{56Z@Uaog z-f-Y9%zkWa(+0r9L0Ze|jI(sr{+1eWPe>CKci#^W5rik@A_Bkge%b zGI2^`O!2NmJx&as`GyLH8=abrT}mNqvqXvfw--}){o!=NF!Y(V;a#81Ld`T=v; zo?Ewfm){cQUxisY@gyYz;_@L$&%l`nbui&1sE}{F&jV$LjQVxY=;Zf$JKhF5Z1OV= z9UXbVD~g3!5vSU-`@9HM1z3yM0xY4w|4a>XTM^Ta4XSAl7;=Hw!&ArE>{mW?-@Hs4pTUs`K=z#_36vNIyWD)ApU>q)*2^R7 z4^n(^dq!&#k6l?XrTe%1IcoTnZH4cIcdgBzL!`@II z=iIipnzmV>PpW%{szz5y8%jH;?bdjkb1EOI=#)LNzr5rlCbb%z&-aYwuq3t?2T$#D zL8b0+*;{WEh;$fUfG|E{&~okBPQK!_+0z$FfQ_^DHsXYb=F|rCarQU54aM2l>%|{r z#5XZwdSJ{uer02+1F^rr=54U!QO?*OK~QImIirzhs~Gvlg5`NrCtK`JIwY-8@=(~? zvnn7pk}h~L@T%KyByM6@)G*jccx+OXD;}8{Mq~jd5^V!&;1m`)JF+n8&Ei@m#B*4P zW-?V_Lb&fH4J;DrvFhnk0G%8RTFsC**)BWOg;I*TjYy zSecgB6VcP3_Wit7Zey|Tdb|@ZD~yQ_pGeGP&jVk?vapV;1$i`bz8x)_(rub-qY`sV zF{)R}N5sfjX#;p`Ar0xdPR(0#qnq0y(j-wI8UNr9j zD>yPx5t-V-t#`;wP~lH7W75ET#eUwFU0&h9bV2S~Ks-zce_{BQ^sqV5(J|_I>p&vI zosc%i9t9yH9{7rR=^SbAF3vLa>sB6wdv9Mb?pi+AIse(MlXjPMVft>@bzngDD-E`U zO$xn#KYpRvB(=ZDPS@F&(B=i9fV4U5=fq=%IZm~Cpw#NfHRWUb-uuM3&w z#{DfM@yKF3n}Q!{jwNaf2U&!0v$?t|?muMl8s0FVlJ5dXMD9yK(?E{J`;W0KU5n^j zo?djnWuAcxl1Xc+-Vvj|K-KejK(fMKt%!^0-tnP&P;GJc?>XRl`#89G>$k!c_LU@|R}KWz1aLQ7LueP=A$fu?acIak!BSP>+v(WU8mLsEppjB5^T6cgu- zt+^b}X^qCFD)}_gFgI$#gILX}J_B8$s5$Tt&EmdjN0fO_HB;`HcGb)Oy|ZO#QJ&1} z5#>W9K%sbcb8k}+9=DXTPR1i&P`w5JF)If`m3vir9vV5JwN&qhm9EuqbjmTv6bpsO z9r-)U;8TCz{nr%*l_^u>-euueW-pPc1`euWI1V>}BEL(p6OsV=9MSZI2=M))e-xy0 zES}^vVx5byHSOTY#f8?tW+F^Zaw!nDzi2eGUX z)QGCQ>`>f-<eBvqml5vK55er zW$505*Ob$=G;!E@fC+=pImQZXGK6ZyX>+A`gzJnb-{SXqhL?GZu;WM^Fc@rXLACG0 zk(j%QVe8iPvD~36m4&*HNx=z+=!F<7C}lnDBb(l*W$G?@v0)k=Y|%8<8Txextj&$u z(2aDl;o6;qM?(#?h=R+A=XZDOM{Jfmak7iu&4iEwrs1OOA&CHZ6M+L=mJYYRpE&6``I>&m?BKSRQDjP1 zl&;=CJ>9CVrc&w2``pxq8Ti|{is3SO1*4s?pt9xk z0VY*VMZgF-{M;&{_jj@&QGIwSL?+9bRY^PDo6VLzk3^f}ol2_sb(@Tv$=rOjaSUgZ zD{J%H)Gh{qt>5K$;LFWLhY*pC0$p{%`yPs^+0qHf2bIwj%kX9CqV%E7rMJSpLqFMm z_xMt)S#zp~6lT;}>zsuJ{L73eMy^KWJ%ft^YZE7*KsP$i{}QkMtrB5o z|zW2^tqi#h(>_#eCZ zFZl7#p8dVY|HO}se<@!64gC0(UhyCJvDaK!v515~ouGN-kNAq{030+T)030l&a?WZ>8Pps#r6KNZdW?9IU%>H*Uk64>Epr=bLRK_@2i#b zk)D>XslRXBemigFwu>)mer`Ps)9#zUk3Z~=hy8MXKZc#RxI#P>Z{I!1RV6kl`|i7A z%jM>4*suk+H6mCAUKvdJT{OZ+4<1_9p5>2Q}k)DN5jPzkepN_bIP|7#eUFFvN%P zCY05$#2EF{iq#w_=EHG7Gb~COw@D5rymGiwj$w^p&9;u9@57CaaW9 zuzVba=%SY;f>nDi)c&?g7i%w$4g7d9IadYCW}`X<-Qbc!UISZ?cy1rmvw~j)JNt8MqH(+=%Y@en}|Y;7>DW>ht8xO{rZbl z*!&iOusQ z`7+ri&mD1s1`_jRc!tA5I%3KauxZ38#tc>G`AbE?E=#AQgA*1m0*l*bX^QGz-10B=%^<2q=wzac1bZx=p`%WqQtn#DA*!gMY6T&q_HTEh+NO~F$7 zIpO)`Dj-7Hx9MIGD~tO@5Zd(3{OmD(y?Rbd9XDx!q#G_XdmGH{OMi{2Gz$2Q#w+@iSSy`s_@L z@#}1;R+>my+h`C=)W6X4noBAeDu`ypK`|I{N1QfV3eL!qqbLiouKBrmRTg&(=?zOe zS`O)AOChN5P#@qWo22Fmpsx=@XVgBHnsMfZ4L`vZ0*U?`k^%*UYK;3~Jy;#RX=l?M zk4y3nM3_<`rtOq1fD)Yz#>`5VkSu|;9h9+!bco`T(K&~>%%sW2 zSdz>=-WF&lh}#iER$V_Oo zJ8H(Q^Nl^}>QF80l08~vKL;whxEG{YfAnk2bnw*VIHBdoTkj20pD=CN(2oTWJ?5dB zxCT_t$2P@NYMNM**qcBth^w`uwa}3N%2ZY|7mS6n;=FN@kqsm}ykX|=7iC6!bn z#xVHtr)0JF%jIPQHTRuj(@KqUaC}63T8D7O(KsdOZ0%E|O@UEL;vxEwm=yog^R7pG zNfK>6(+Vj~T(S@}CX@o_)PQKh+hkxfrfT}9wD_1%u>$Zhh0&JwKs~VNr8^0`nR!_C zBg5~SI)~zUI3}P+#!3CxYCgPcLOU#F2;&hai29m5S-jU$XF^dRcXR&ks&@g0iH?`? z0Z|E}3d{yc=g2A@nlT>vXQF|E;+W^;VF%4!q?UMNy&-*T2}}Wss7tbpXdJl6+$Sv& zjNZ`=V=wW76@f&9_ONqQip8isp|SLNR5ES#z4GyRw_EYTT^v`iVP4Mwfxe(Z-YefL z#H74b$rKFVXr)tV`}r&>Yo=uz4v0`^OOwMF+qcz3_2MV@V^(;cu4Okw)&R8!WTTY_ z$QG897R};)ra!qgZPr91!l~Ahi6x8g$CX>08@Z2XU^F)syO-rESy0+WNPe*1@u|En z@5Z$A+bJVOC^i5axkcB(YJxt{s$2@32dplwnm*7bocdZf$Ph&s&s;Ek6jz5i3Pg}t ztR{H{1+QZowp9Me(rVucsOvJMflUlmt`_R4#+C^4y+GtH>fMYxhvp81J?kROx!Cb> z+!BjZH5iId*Kck2a`_Iz-Iiy^+6M-vyA#;W&=2}lLM{_b5HK^e0rp#DOteu?7m@t; zm;m4;ElvaA2u1EJGhLhZH`}wQB*fD`I>k<RIBZBSVhbuDyC{{3 z%`1o=Zc-07HyeDe?eE#1e6^*9lw2!}Y@ zl3vf-IieMV2nVK<465U)N*RKt4Z^ae@edFu9Zvgpx8{u6<}`^8sQbjz>rV8nA7#*8 zFWBF8etd*SS7hK&7fywzY0{ADHn*MEVMI9|VL0(`M-NT(yNzXf7k{f*0+p(6xX7rq zY80_tF-pfC5kd<*t7MbLW#U3%E!=pLHy-)7=C@!iMh)yeHfX4xU=`1 zD~@V<%sttU_G`!rmwU}Y%35(>k{I{HeQPcSj81U};9Hq|ti(BX>7?s@_`X??7H>lYL%AVi9%%PW5l~Xr}>Tjks^?$ zx1_1fnuiS1F5V5-HxZ8_O=~^{oV&F$8Jrq8Tt2CkS=nYtI|vjPdw2cSj&R+`>@_pW zPhILka4_s@&4KO+hJa1iJ6+=J0nA(>fh4(B!GiHCFsV?-J!-7{&(Ld9HGokRlbT3rD(A3rr zziV$=Icxy%*y=QHS(}#{lArq_shLLXapo$>kAM60GPqI9J|*5p(gS5` zVKiPEDYDjJZ>WcD5=X?+!5^%YV@S7dk{5f#l6suVBA!SSFREe$T%Qyn%LyH7OevT$ z{@kIcYR{SJ8ohpjbY6)X71OICWF~>&C>ohZ1Op@x81AqRpGh9HN6-W>4H6~m z9igoD+uZcJP>^GkxqMB(}mun*1UqJ=Wh>CCW)K1y02ux(|j+N=dL zed|`0#rSnN=38j*8Qxu6kOAg+axbCnOfj9k(-Ue@@%bedlJ5~_Zm*%mhJc6ATb4Ud z5UYaag@g>h<5KE?)*@U8q}-6f_FK54Al+|fmnBTeL*JCVq;_tXAE~{pI_&Uy{W?Ft zVD+xgt3cGcfL^o^E1zXtn+m2?1bb7CUHa)XIkN%`m}tv@DwWzo$5_c^la5r2xOfAfQ>?~Va_}Ug(<*v^O_ z{b;}|d9#|m?hHFvd$COTxHsCpx&#&1JRAn0>ALQ$k84*-;UnH2FoDnQbjs6Is%lBI zd7g~H4t75tG%51I#&u;s!Kn%1ss9z6{u8_Xf#{f7{^9-j0<-_*;b8k0$G`0VGXCJJ z?r(Jdb!_~ zFntAh{+}Au`Nyn8JzHBQrhkg&{A%9cXXpQD!vAeF=U2tQFr+a3cS8!(zi&wSv-WR% z|9=FB@s9w`f3l{q5q!lm{BdN>#|K5PE@x=@$H369rhWbS^%;m?i#@v9cW zSF8S%2K@73_@B-Dd$a#ZW-$G`&J>;h2xoXxyXWkEj4a9(K+w0D0U0Ii)d&0IFg$&V zO#PgWX^ha1-%{#>VGVzXich$l6KvRZq2Re}L~Y1$>B;Z?{b_*z)9d;7;av~B-tiTE zUS5UKlIlXwz{y$1I=r!;vg2#rSymyA>?fR_pUK+n2+ceYsEW(Sf|-ZC}3k2fO_i{NvxUe%EJ8{Eemfz8Ss%){R>(8*=iCg=m+ZRbeTo zi~4cCWv}x-I>B~g=5ye}+Ppk3&*NK_H%&?}cRmX|(-iU5m`eq$a;>*v<_k3RJ>xK_$)w{^8Miz7P6i2+VPI_7504W2D zzAhhsFMXOS#$OpW2QMMMg<+K@wv4)tA97|t>@q-g12Tr}xXv)3qajCpNU|>}3rDgH zqvw21rp#h`%Gyn~%sNWYfPqOZjbc7lu)ezmuy51`2C#avRM36&L z%0apw706L_MATKMd_F0;(g|~;6EGCV3P^6|jlh^qZRJ5x(!)^=3*!koOc22w?geoA z47<7=YK!J>Q$zYv2d zA&im5hC^jY)XuA>a+kp!Eu$2WQQMCwbrr|=Ep?$R~v{Yfc*GhZ<6;6tp{)8cI(wZ>~q7gfD?K7?c;lAIi4$tp2c#}laT zMB`Q&)@f2lxqrTC2+{$JJ<%55G2&lHt6mt^H3s%LyylbV9_Bp_=<11;dqlG~8wy4+ zCT4@7ED@iDGe8+xNl|jLO>HKW7>J$f!EY`Pn31=ibtFUjmG+3cyW?dA}$j@SckhwFIY`Y5=s7|_3YR^8bk-Uq%k|@Iv3$D>7 z@XZMTY{i~uWnzW3_LaO$QF=T=aNq_2VnRIpbgKjG+7a9lBBk~bY{#`HQ=$K0Yq}Da zSYOJ((P0>CFvm_fMk5*Jc!OEL*0tdIJ4kAkcCH4WgZM<4LEP@{=*zf>XnK-2J(+EE z;5m2B@wEfL>{?I|ihVkw>^o4>kh&;>tM!~v{$hTk3w_w>SqMr<_yPnD1KPdd=J+1H zy~DKm!hW^5oQWzY=7#~o z*3OJ%RK->d;DwI3e3JSfmEW)Tf%qdUmRBq%-Z7F|Jipg0I#CH;(z%5}I2?bQW-6iW zIbO^{(`GTFYi;h;4q;C0G)ryk$ftPnfLX~k2s5k|=77ECaL}B-Xbc(ckTGF{a(KMZ zrv#V47i|T`GIqiv23A|_^o}8`r@S8LE$E;8CIC@K_#DYIt)!&4f9*JI;DtWnC@M)h z;RPXqwZiu>NlHTP3;?$~8jXB9Eb;NnHzgLyGC(X&=NU&YA@=*^)JQUR|Ki{=K(@LD zawQ;NIA*Q`9BSvUw2`Uxy7Qk9iBj~I`iemN4y%F$@VnOZvJkzxb%F;QuF;j>P?9G& zlVrU3qwUKKGhz&akwMTiPL05b7jx*GH|Sdx`WGP+-9C_?M=7-wOHq3JP_xxnYEwA8 z4cD(vDiIgZM%MZn3{UmHCr^;B{A}km68QCfWaJGAU1FekR`Yq1+BzU)^xDgwkxdo` zn~utqGB1@vwYo8yCx{Xe?Q_4e2&%ac6oK~r4k@vMCglCvTlF}kwj-vTN}KWo5bUL~#Z1)puBS0Z)CObi# z5x?1}gn>tZ1$$sKDr+bWIrj^=(S3&4e{Y3`J5yK_ORMv_2DPX#H@FY4F z$r7nLdT^En5wN#n>Sr1*T@jC{bXR3jtN`|^8&s%? zk7!Oxba+70Wn>0tk7=GbTOyZ;M(E1Mvasw|^6x_%?>b1bCX-Ci$h(7FR)0~!YB7j8 zXSO!I&{RfTl30Mxtf`+D_C;TKRWM&VMi!_R@ zBy#Y@vBeDoL+O2nm7wO9fB#MtU$2@H7BZ9amk-nv(y4)4WQuPQ4G%eBV#s0@!Vsr zMUBa5)%RiI6ehNz->F&2pxEw*LhDDT17TaDVC#x{i6OFzlY+>hr>Qw=8qe!Vk*ztB zf3ksM4-bTDm|0G?7V8fL!nUn4nB`KpvU0GerfxPF2f!Xea6+-stlE#P+Gibaf?}gt zw@O*7PhUav(LK9kuU;pf)&5a;v06LaM4eBPdd-_!$2fbkrRg{vS|7lT-dsUd1RUYD zf1o}@9mz_HhrN7-gA+iCUu_bk#Q-;wh*OxDJtx;EQf$&do1s5YqRdLSItz=vm!TmI$V~p`!)su=s0_Fy2@Y$qHeEiv1TAewp!cK*`z-(yBhE08Sp@; zof9bgw35iowy~LUJD`ski)2(O0P@(ZbzAI%EFia9n#k-^+z3>^FM_@Dz6 zJ9IddbL69nz6&3`#gPaP`j7o~tk#P2QFo=JPXunV`@@PXp<81>V)Mbh_F4TP2wAlM z;c#DIB4QvF!ijsvHabJYMd3TpS+_fVS)hImCG<$uSxR~*%lVy-ma)hWZ&lv)kIwyy zfR&mcHV~5a&JAf{%o994bfq69HvwR0BvZ;MWt*(0G(}U=h^eYCu>q zyucPD#FZqSvzP-$$7{H6f3NaFmC8#rPImN5vOJ0VkZ-zrav|cM%l4WBedE=17hPAC z`$~;ea-c&t2kO<1N~XBTpNPc? znSg^TI2qCw-ufsD!`-NEp6fszSj=t=c^izVpdSd?cnM3;u24nPm9!>Giuv2oKZ4Qz zFY4Yhs;+J8(hhD3?hYHf_gLd#%ytnzPYh@2B_CN5Z5(wT7gbfU+RmNsF8y-1|%OMPoR4nv|@ta})Vl(!F2Q z_$>|YUnZ@#&JgkAPP{Z&0i=V0LX8j<0~mIGJ%MJJrnCgA(IVhIb96ksDiq`6snCr!pnD# zR-a74ZboiR)&m*s?;?)PL+^~&*Q^K{t6GhBqa;qYC`=!4J!Emc>8>V1y0`G-<-S80 z$yN3^vUkiN)to(!Z=ejj--aW7csbE-A9m?JY!=})RPUS&rcUuoHM*=CSRoP>FY>xU z^Z+Luij4ur&?uGCZ1G?qI`!&f;I$iO3}cx$9Y$vavb%D)RBV}69b>6-_E|=0ciZva zABfW1%s7f7vI?QN3{swy^wrf4v2>;f#mvR6<`#>TBTRQKCh~V_kmz%n2~7mk5}(Z< zl084E7s6T-fwvl#@&=+wRB=jwmX!l@T^uhZJxSE#%6EC(LDAbr`p}p?+0^JzQ{jZw zao8A{GF&wsR4OFx#qZs8qjplC!)1Sm$_5;8jPI9a#aDM)5Ej*GqeSkL$Z;yC^;9JI znr(KM5|5AV{c|C^Y48&&2H|!u+myNCIQ*CHpFQo{cQ%kCh3>R-NbuSx`A_bCk8sVN6jaNv!0r*dv4ghX7sAsU!I2O zK4$@}R~8dGI;_kDx@0{Y@aJLn-z3{B*^g9O6j5e(RB8y>J&&x9|yyOShq_`8RiBzgW#LmT#gzg z5PQg-A8H=UWk9LiAhr-cKnCku26=S3Q{L734YpQi`_jsGDyVT29Db(|pS0}%!Lc${ zd72k>6hsj_K_gy$UZ3a?%Mli5vlp+_3*yyW_!<%ap@;E<=!I#Gu&DDoZG@M{+DAoQ zEN@JPJV<0F*_8`qx{xMp>_kUHzf0*!w=DJMRjDfJ#s+`++|NsBR-%o%^o+W-Iod=m z0)|L*aBRIipQO@3h|&mUnsvenMyvXx7O8bbuI&P79;vLW$-xY`Rk)#`T%nqpLsMs7 zPLjWOCd0wAXzuA_%2f7H%i@x6 zb7yR+UN!PqgxcU*AE;UcWgSv#IYeNF^EF=Xe=kP5>#g zc6EQNuQ(gAT@V;)=#9zjeu5789+wftcBHlYv?azgO9>_f3H-U$lSTc8N<Vc7k=Vr?`R2GKQ-R--V%3oqK8snXX3jhu%+jE&{6=LyLs*`wXS z!QV7H&gf5~Yj0{6-}4FT9#Yb-?`t{u4~tm1w8b6D^`EpzIeyZ2G$6Mvp3MIEi1MJD zLPeJeVUlT^T404cs+FMosy|5RI)T!5CI&0rgX1e3osgp8SW<9+&u%?~UC-<^9Hu&1 z*P!HIwaOb?>%}Xe;SRNnv1rr$}WmYvsIap+l#NNADFQ#b9%k*JakDd+X5+4Z3|7_g+#w^oC)y+KAq+NkGiiaA8Px8s^V*RG6hq>U@H0e#+l>T2#W;Ii5Gb9C zTJ}+bag9C75;TYeDOIF|&m2i(kedX=#kTRuH|=IU-3bF_C`l0yyL99uCV(=oI|Swj zs4am|of03zx5tvt5ovX(X--g*y>qCXWS71XcDD)>SD=SsLcn=mdZKe++DE6#PBY2J zC0k-iu zMP71%_8{d4#g(@-64H-Ia!aUrZxfS2NYm*Wl18S=5ANx6e~x%CpvEsUzMdzyE&Xg@ z6fI{oQ&X@K!FmvU-LCXw-P3tSYd^=71*iU=U zfky@@_r7M7*8Ex)0=?P-oOYBn1HJs=t(`uX`F41q>UF)0g7JHLfpQrta>_O)Pz89v zEFO+6dl#`LEm?2c6H0uNC8i@1eyinQ+R*zQQ@f%-AxOo@yzLkQ*25SJ&khxqp~AzxNa5I_sJ+<_&7I$WaS4G z!}xJ#sV(AZ!rbZi3M>$E^_hl&+t=ztIRd}e_|@u`N|_cen&}Flb3%_c#^-6=Ecro>2#p(K8tXo#3$y4&m3tQ8yt_&<6;fc{_yGoJo?xQC%o+fJy z!z=sMZ4ACpvl%`~QH?W*sT@^I>#9r#AEx2+0ysWh;)R=*Q(IM^JW_2zNF$&(2RjX< z#z3f4ub2w@F~hb8Dre6QF26FTJIZb*4Ozdu_uIVr(xbx&r1wa(a0@ z^6emSTKt^^^P4#T!J%1L+5Zv0#YE5eFCBPneXvT<<@Vd>Gm3X@8GqqbDSMmw0I3#{WqI`h9qRZT24$5YvAs0o_#|IQq_p{+58OV!(C~J5xX$)OHX@O;D)k zBG^3#*JGOVeNtw`zV;DoS~x;tdZy8YQ_p?7x&O6a`L^(OeD_i~Q2Dm_CCi7`XEjk| zF=0FFW%C?io?x&-&f&TK^hoeFgzxFRvgOCi@|p1+PJjbUklAi*NULn**Pxy+Y_(&zjpgp0AGYBVq+zdcIVA;rjUM zdG~|wvLwryra3*~!V7c4>h-tpQ`RaU z9~;N!xMe52GfiM2)p)G@jsLhlIWFrP!t`}>P27IPXf^okidm7qF|ENkO&nhjsiqcX zWmDRy@rMJ+@g_f*t9u#{Q!7J>8wF2=#NWlmpDR7=<6T90%KfN$fu7wB+B^t6)z&7H z9U0|HX^qhq(|)R8mvSNtLKa6wXwbw)>YyD4DM}W{1nNgx^{b22?QpgGkC|Z~U6on6 zz4o}@7gib&W)DHDzQ8gpz(B_l(y@wU8wo&Icgf0p3gEdp-PcDG%e8vGJatz6^u~dS zJx2dH{TdTsO!iv$b~{o*)!c4nwc>26hoTnXULqRVse~I4Qr;!%;kwTIa>Ea(r4bcf z8u2b`#Esa)GZT|rS_=7Y1|6dkdhBP&iBG1l;XR{1-x5+^f2^^XLr6Alro&jjKf9Xb;F`8Dgjv61pqtJ!rcFNnGi18Md&g`~n%nHd30W^01w6 z7-wk>l~Jn?1elZhS|ZrX?DV)Rt>Q z*@a}fK2G4RvjV%5qXGy~e3hrxiM>!3HSmqZkq4+5(LaBl1QR^bhFjjHXTb#r*<l7cQEe;C>#(% zRh9Oth5CsR&82Ksi*G8NSp-;7jH{mnzeb7{yo^VRA6RAD0f=!9^Cvf}%c=vlV3APK zVj?(IhQy|VBvvTfv*js^@f=G$hlUOb)>Y0&j`FId%@`aJ&bl%$qN^$~qQQ%|7bU7Z z$h%I@_-$;kY(>|`Dw zBu_8WXZ)*$?YI=c2F1Zu5^{34l*{WGIB$HlCOww&-Rt)~)MqH~rfroV&eI#gd4QYA z$vDh{=&#Onm*S1ESv!wsX)v)1COhk&z9N;|nqhNhok$%8UZQ3y%33KPJfzn7*};CD zM?2_N-yUD^uklWgW(s5^?_^T)6F#i?R@J8j8_phXeb@>IZhdO*1JZ#fTTYfM`EC;` z(|+~vzkg=0MAu?45GtYd=^^*&d5n zLs9B>gAeLUc&O&p1HX3p4W=(DIL)=~=Zz3rpNLziBZUITYZEnObV8xbk9yvp_j~{d zuV9)g7{A<8W;^KyU$Y3Eb_{n6efD9Np8gWJ;ua4w2Qye_VZd}X>-A{hkmH27n^HWQ zk`jufwrD1i-KLLh`$#ip^_#^GR(oOKWEcGbIjnrAN4fwy_ct$ot_v?V|Sn%FNPwTTo`aCq6S&FZiS4C zqxZH2oUgm`B(Jgg@G?j5laXAAyjUEyum_Z_l4s$`SMJz08XfMtf2ouq2zb<7(25_U zQ}>+{MH;(Oyr!<`|{1=k}4>BowL8kbBceJ=25K*fb>@{E>kXi(bEX3VLrRfht z<-(T>Spk%OB@d2Zgvp1+@}L{M5uyeGKG6z#GlhIh){lJUew$@E zoGjFR)K1q%Jbk=g{zWjrYt&EUxpme%3Rr8xah<)1`wC>#H%~m_2eirE`=J$N5Q<_$ z3C;&lO=_ocBG_@g!D8Gk?Pl>GU<#c}Qce71Q0-e~@`(k+j2B26<2X(2KO^o;fz2zH z1_A^#y9>ELhAP4AOR^Mhq@afsKG)MvhKj!m;@Fyo@~e59s^|j~>_1%>tf{jzOU)12^a`Tk>+m&|6>nACP&niAOS3TdKdo3yxSWx0j z46>D7!_!5P7oKLlk4PAJRNCO1%5E+!c)T_(q!!luqtX`gLbD!^#!u;#3B(UTDkOhJ z23ji8q?fy3l)Gl%2{%u#c7Fm$!PgFa`Whnry~qc|#|EIZ-u3h(zzHsz!0rrW{_3a; zJHOhvSHp-Qk~)$BXHwt_{hevcQ|(BW`U#6oyqAINr9pCkE%mdoi?btZYM5qr)j8*C z`VI}7EKpRELPPaSw2WAe6?R7KNBh{S3@L9}y}E>}T-4eAzGI-sE3{=TDq&#$mI4~! zhaOEZNFWOYWC|~xwZ*Dw?j$ztLWtCfIy-njV&f5Z#p7*0`nk2RK74dmlY6SBbX21e zjqRd5M6ph_@f?SESc!H)Ej4LP!o8dVs39~&4$fr6i;7HVthFSJ7WI8*UT?RIfg&s( zZrLGRx;%t_vaiYQ=fTwhGHn1aO*=;g<_~Xz&bajYpyoWb3Ddjc!%_J_phATKe|wWy zALCovXZe;!IGISfGd4w!@wCUC&h1%5#rjS0{OMgJD&b3LtKzQZ_P`o{WQ!qrZnDez z`3CO!OHEy)U*Qqtj&tUrS|g4k5GYvH#1%#Hi9ZJor(Yvd)Z-M)Vuz6+q}=m4kJ~(J zIh=(BB%K?rWjPF%l|t<4s%EPy5x$og8Y>ALwaa_7bIh7V z8?ewa80RtCUIyLZ{d82#oZy|lE-^P51Ei!;u7t25@ob}6#bjcvD6cNwaepn7I%PfS zSGPs=A>Fjhahlz*AFE1u>ZgJM&j0B1T9GNpw{BC zq3>1(0@O14$sksM?IT4S=BjSiWfo^?VifXet!nj{FsZ>@gJg~&qj)*?A=b^@ypXPH z^pj6E>NKz=IM!x$_@b<~VVqv;X;Bk{{ibnI4OZRU`;Oy9H1n8ihEGI^|Kaa+bd zQ^(#&3!FIR{sayGlJiexkfrbuI^?zKNm)`rn4pS`puvFX^4!zL3w^)bN>iKb1-6;6n8KM6ek>17D>YD?oi6bdY&58 zorf1mWt9sV=QBwGb!2pq)(=!1RFcu!noPN7p!~7bzU(Q84(V`!ay7*|YIk1_gY$R8 zor(+U`3frgNFz}*{Xp0KdU33RVx>199ioPkb?t%x;s~}_|Qg~@tFzJXsFZXH13Lw<_x&!0mdUY~-a)HIew0PkN z06jHie0k1Hl^r!bpI(XvNAz_LSvRIxy313m-+Q72#n)T$bE8*YPVaIVCm%=_K}WEh8+j3hCLTTb_v}KDz>N0;0?LF*TPq)Z$BO`Kn&qpRG-Q6WDqvA zPqeu02KwF7wY-647tN9W9SZ$TUjE=Q%*+g||1|P4{R;|Z{~Hwg&H`x}{|0F?{R;~H zkLvzHq5m{u|L@%BjP$Iu?0@1&Mh?b*&{alOR$8V%o$2q{TeK{HP)hoD3-bS~XwvDO zQ5qSW=sFl1IU72e+uAt(7dXlEAHzweKiKep%V=Zz6IlME$Da95-1cu|wEeFAi`V`C z9!~z=_+N06>9?c(U;XL75AUzd{u56AhM50JSlfZ)hxexOBM@rPGSia}9N?I4zPSFl zpth`C25o~z@52M-rH%$dU*rv{#fw|a!7}Y@MbM6iJgV+5KkL3#zs;XN#k{|$ePey~ zdTd4sD(by3{c``bc?C9$nvd;Mj-yy~dtv%^`gCUf*5J9==JeKnYBbBo{(1lzQ;A9T zN3VTLOwWjG54mpE>(7_lj<%(@rl)nfr;eAlr^{*f^-Z{SR~bz_p9klA5z6AUGrr^w zJjl1Ur(=TK4rfB57W=i*=y zNxbIKX{BrwENeG1PJWV}B$r<9%UkQcXkx4^LlhG>Mv=O zPC5Mv?K#L_MNu@Vy>crb2rFDyc_APn zjBphY=jx1fQ8th{WelYHBblVQi1P?Dni-4r_N0avDAcp&SZ|!;!?8JcT%0BA;YKS4 zZB@m^4eZ<^4prsj73<5~bZ_|<)q-8^xm`>jpKT}KZdkRwuJ}!PTJ^-tpSO&Yd9zy$ zaQe8vn7;)eO1{~@J&wo@cOR4#%e=Mu2+zETJ3jKm6C4O8uiio0+NJM|?38Yq-yc1I zeagyc7cF`XXhuA}&>kq8{k0f7L?1f6JCyW_4TK6T-S!*@xFJKQQA{!Mx>-MdEs?9q z1^~ft5I+z|3n@Vd`1Vr_j7FO(LJIn>8&+R9BygGZNwbPj=um_a@Pxv5XdD3}QFDYa zd48q5u6((8s8`(7hizJ}nB^y*H<=tt=L7fsYCCc&1|YAvCwomq=ctTAI@Eir(&lAl*B#*kHWJDpr+l9vbk+ zy`6D71~0+h8}T9|ognQi`xG7^&&l%&y^aTK2+rnY5RgsxuIL6c~_j)Ov8=5gT;0dka#R zhNFN)Y^VvYC6%^TDdFi3`0?bn{ZSh~{7GjW%4q@yaFsL>9b3}Ie&1rP@ zUBBZHdo;FQmg1{#gk3*UamR`!WJegc?U)Mz1KT;358o731LO8Dfyg2H)enu~fXpaM zYaV|lc||#Vb+N1un@g{ndB}szq)WUaaj3|8lSyD1KYyJ1a$MQd4iAxf^6kX6WfmaF zC)DzDrEC-VmErv~520~&7zV`T;H_i^A6hLu(@q1*<0(9Q?Kvr~z7oV7iAbWs6%g(BAr+Kwe(%1IMX10t+y>|XT@~f`*vbyW#7es+x(YDJk`)#S1W2$oRw4+ zY5q%b|GmB08~amJ>$l2qX@ zUD{rf3A^7fxAQf*;Rk68HO0kaNvRNlpo8{}qvLwi=g({eoP~ANDW6xV4}ctrGqKat zc@$31BvQs?tN|P}qj8#qza(yBoix2nKaX+6<=Mw{+tPhI*Ea_f-teoX!Wnk5CmY6- zk>MT()EdD9&ShYD%y6T~D4<>euC@~EhlOaTy;cuJ5O6x(=6*^q%LMIyN}ykwGHmzl zm-Cg`s&EJZIv;0jZfn{^t!M8l*h;tyxORYAq``cqdK;nawC$|ZUx(kYg0jpvJ^R62 zjpY$2H@O+llwixr01kwasC|f#&2D>G@4^rwms=h#+PAd+Z=&DMZtx=m zMftK96a3kI-Eh$AnftyM()itYB4{D_Kz2ZFe~4jc-+_tdABJfty^bABQjj%D5=4UH z-6)ZQ0SfM4-WNzK7qTuQpgi{B@Od%2&q6acOt{F)~+8aNa@036O#H)+*aU)7Jn{j4Sn6)_|<`|RG-D-tmWPSkgcFc7AQ~CgB`(Avf zq^iV24d0oce`5`a3+bWUe3rVSx=+buC0Zdt5td1-3n_WN)CKf$yXp~8WJr1w*uK2j zR_RTap8q!I&s2hIo;ZehsPYWQp**zMAs(MZeuJCa+s}=B8~E$K(cCUUAOw#2~YWA9O;o*xkbLId74Zta+MN_F-6Nx~Fm4q8N<3p;|!)A}%;u$D>;`s@7x0Rfr z+2=QRj){CaztB3@n$c*|OK_1>MWkMP%&zTLL&^|Ov>l$I5SS_#B@2|l#!30^1rRTuA#+w`*X6=#whxSU866&_P17C z({sr`Wn84cR1<~^_<_Ucaws3$*ntsr>~%_4Z&Z7#Wg=xwh*!+^z3Eshu6b8g(4nz; z1PU^gp|)F{*Xy$-ddnv(Gc(j(%>8;$?SYOP!!Zp*kejhDK6c#s%;d!o@e3)B&4lH<*(n^z z*7yoZSE4-SW1b&!*H1b<0sW6`T;k6kcX{qVvbHxt@_~IeO}08+M!!(YKTjC2iNB4$ z*>HSqv;_&|?`iR3&WqW`qL`3yZ{lESAzUHcnUqK|WT?OJga(i%)e38EPVP2>L4ts; zfPh`+`@5O|L)oAPx)ZN1ucR^iozh>=66X~H@F99FgA{BCA?-#6j?smqFCj$Hy}@kc zHqFTp?LLJ90>;%%H|>dgK&EK+^M757lPJnIKYQ3U7{-BX3|nOiw9AIA{}Pe$wd>_oHD0Z~-aSOpJVRY$N4cgZktQPxxh>?9lpgcJSJD z&aOGXBcF0}I|9rJmB-qC;#{?Ma>8_kI9OLNRIJ2t(wXY4CA`ir#028zWV6L7q*-LwG8>yWyV9x}?_JT@KV&5G zmD~EcjYxwIm;D^9Rk`L)+T|EwlFzJ7k8)5MqBd0@KU=U7U7W5!5Wqg2q~2I4!>e)8 z`_Zj#0hZTbz0U!ZvSuunabB_V)_hX)+!tk4AIFy)XMBr!*4^Wb65DyZIh9_+gA^|x zN+gb(R5m(HxRBj-ViJk^ySB%bwIbWieVbC>Lp!cpp(-EUv6@W>(2_k!D*%w?;)pXCb1@VWU06OEUNoPIrJ!okF&tjNxi6_}K^ z&(+5cuFTc;nr^y-RCxhyoUdkhx&Bw4CV43nOJWNiAkZ7lJ?F!NVU9(XPu^*rP${m2 z1PLr#ZpbE^p#et|;^_2z?DyDLc*Z=e12J9UmbLs9-N$l)Xa-*T=C}x2I@@m2$>iwK zw%GD$HAynwi8qyPm^GKiKUOhh;p)CDz7Ry1rZ@gA2Kvhy#>B?L{7($T{D+I_uP?-Z z_^Al#{&!gB-6Tf;7k**n_-9-_1IxQ(?DvIt_ZU6PU*Q4&ODw|yU|>;q0_ZaXIP?LA zYyd_B0E02Wzz|?WF9OhK0I=%=I7|Qr%t8Qq#`jwR@3Dmc+J(;ihZ*a?KK1{htDpJL z6vBT^CS?8tWxbP>e^Qg*ya1N&-=HSHYyWzJ|0~qwzZ<#!Y4Q4Zja=_(693~A|LEoa z{fnURudL+vk^QyBf3TAG$pya;?cWF{tlVxuTYFM(M&;~0@4iK zOhG2|?g;tC8u9uvoOEIt|44CpK{T|drB_i2{2CInFLK4b_Pl$|7xVVIeZRN5|AyNU z-LdY?JEOch+taaqxc{_F*H{8hz$-bcqLuZE*Wts}imMBs1)uf!rVC%j)xrLHghMCv z5%2Z#=C0?P{zcEl*uLwRW4@R3!I&?nZ;vsh=#xIgcJ z=euju?kZ9mFrJ>%=$eocJ$gG2vCwp%so}aMDDx|Opgj(UaG7D~&v9}J4h@otnvHUD zRXz-6SY)ZuX&vlg7U9{Fn$N~;aY0*>&uwAH%OHFYug8%;KM0R}Y``fPQl^;IZGr7i zu{i$oTFZBQS2RUv=d?rpBN~K^=lasl=tn+cngJMMbk_P2hm8sY+7Kg$1Tw)ugUcml zGqIfLx(f18wS}4fT{|ZcG-(AVuvr%G_cf2V5UZ4kqXW5wdbt`K9a z4I8S#db6|JkIIfP+k%9}y&3&26YoV)D^q>jYtVEup%*KY}Ttxz#Fv$^AY!tg7OK}NYp%3Pf z`o;J74PF-nVx8!)6(XBUr;g>#Zo4!0d9D?tpn2H7i!-M5>W+)Z(Och3*%cuTKXp<} zC%L^C81eL%G#tv>cJMA`YNnN7nV8AQr&4(^jec*yR*aK&GVx=Nt0=P|j4mLA#jNb# zPHnqF7+DXp++u(;sX)h%L5OKc+z7v%Lx(^)kM!S#yg~Ng1NlXmfZ4%~(@+CCzMvr< z0lk5}z%*a0tGA*j+Ew&J#U*L(eqiwdK1DV0r?aaVSZ;~IDFm|O!{^B{vjkZQNK3s) zkWomWI%|2R88{n>o%|GoGP8nLxm>~CH6d}lH#NMg9hE@dBIr&zOesw3WbF2wey&MZ zZuiU!e1aachqxxf_vr2rQu=Ie zCW+ve8--7n4iFWaSg*|0RDKIA)VNx(hw|$YDTNBcG#Y?&oE6mNywfl(0G~VahE^%_ z>#1&Q-@^rER#NX6BiE@!;RKM|Njrn=;`EWNG@&FWgZm{evUpR|{-pWnqqeqg`-8{9 zQaHm{qQQJ&T8mEFGQ;D3NJk=Xn+x-r$}n#3Tfvuo{J3ew#|jK@zJ9upAM5#CjtaR* z1$6QVyDn90x2J@-10XoP0-s`#s?R?Jh&d-{4r(25H$wF>hpXDypmmdCRo-NfY?o!m z8l~F{4X3v=kS;zH?^Pu4xkN^gY}cp78nq_vVZN{xkZ|$kpLX4IFe-*YzI)z2_s^2>>y3h{*@}A=B94si$Us+j=@Q=>#~eek@BzjXDIm@U3lM z5^MC4jrU{&TrpJn>_HS=PTS5Sy-CpfmW>}cw$KqmL8HCBZQw7kzPq~`R4ROoVHuDx z`A8@7^vJyPO5N)@>BL$~*G$cZaC}R7G?qNTQ8%z?>3b|1I|2y1g<;ejdJ~4W%D4&{v!A6%V~rep zlK5!$HzUDqAA1%_d)5>r8Xwi_-QDyyWy=yrc9wB=kXz=7~cv zBDwvMP>|Wsc02WtDL>iM&5z+e#mxl}UsQ)2IjFiLSGBkZ%WQ#U8pW)B{Cr{IYdO_E z+QSyNGbD;=Zf;<0*c*1w9(NYni}&cYCfe&yF^n{D1-M{HnHqsz(yCJzlp$H3n-mTM zUE2HPziWREujIj>FhIO{!Q7R!3-T2f-RB#+pWCs{H>&~Of+obV#Ny0>#IU#;2tod4 z!9JK0dY6mG&NcRQplo1JhJSzUx;VTVsm5BO&bmEKG%z!c@{`bqY%)@j0o=&=Z}NFk zN~Ubl_A;?hBm;o(2z*`-QWB)mVEJ&s>~dsU%_oWNhFz8+(lD%Ezs~gNjKZpl{`Wt{ z{R+_IsFpAx+f4l+y*LADS;X=e>}pb-4{|$t5vpAANu6?rT3o+~`~s?t_fmj9P|M9J z$S{YZz*3p6BEtey94IaVWRiDMwMg+enSEm?)ejyf7@R=kEKcj+LY-XfpE7s z`Rq0U>N*jfVW(8uE0FB84BrtSGVCnQ@L6Hx(FtZg(~u+h0ZS2C#8Q8ZzX}zPy>khC znF5n_us(%tz7R}n$uzaeKz~*098LHS#)QNgN0dz?!=tTnJCOLgCS<>JT-fBAPtO>sgmqK ztHf6jH(u1m!%2^pj|i*2Yh!_6uy}G+Or9kH3~6FtLSq${L64Wx9nFM>;S4o;*|zO% zEyP{HOC4haYA&Ox=Vdy{#uadYXAdOadV(W#P@22~=lBnw%f*=x1_UKr@kvp+NEGy& z?()T;Zyh~0xiAB3=Ll65K-$cFKn*@Qgk1veH5( zw+NxX8plmnK>MYOBmAv5Vto_7ox5BTv1{N$NtbW_Dl-@D7MH87XfPa##UM4Hm`^m# ziHbT46GUcg(VWv!NC3tvS^>zA92gz< zXz6ZN5wnor>wMaU9hm|{*|XMs2&&dqy<$0=np)Yz_zg%cY&cO^ERIXgndR9X%?2-r z4qrkPI#iSjN8vI^omIG!TsmhobV?ZpHNlrWNKzQ8=KpYL$Q_cGEuC&^F!8kNP$2!2 z?6Z48B&uLxVm2aoL-{SEoA@|S)*5@S4ew9Zqq|O# zm6=4~?6J#82~l8e7t+<=VBymSWa$=eaCB1)wG8LIPIP2oru!-y?;kUewIsw(_#KwW z>-6>m1)&~DASy2WI50c5eX+O7{ZRc6KZMBYg^^UDu(-r$2Xb!vN{_Vq#TmGY~u31A4Q(|XyYJH;fjeSb?qK_X5uZl}?6**Fe2 z4ww4S(It(S{A^51LPsd~#|v5ISDF!P{e&cP3wshmKaUcU&_#cfA!i)_2zEW#u6^{z zi-24;@H!aWw!|HlfY(@}pZYjMmU*z0{D||k>O7k=wC%2WD_t%CfpED-&yg@^@u!wZ z^4gNMi1jd!v6*-(j#vc@$7Oj-?|R942IAi7UVirU^W+dBh49|!giVYd|81Qz!uK(= z>{IMFfIC#G>huHg$W0_<2Hn6(06fhlYzS&20(7+oVj&J2iwNqGcos}ieDFr$MX+HL zPp{`_$}MqhmK>p`u$}}&%*GJKbHp~M{Y-m(w>;o{p9$M-XOf6ixQi)kERyLgry%lY z><5*YJONbLXn9*s+gNYGpj-$hSL|925nK|(O_zrju8%R}_zb+I@k~|{l?)|Qz-M%N z7pR4cu^cRh7{p)w>GCt>bwU*z#*ts~N-#CQM$*LK;w4bH`Lk?wXtziP`h8g#Bb<@45O8!`d^^{eQd-8U8Xj$* z%1Ky7(!4fnS46A=^zf!gXs%!NI&wept!DR~VB;^yV8V(C3j7c|&8<+v{)Oxn6Qr{# z2_LnE^BDfzXjh6|Pw1&7OjcYW;Z5XlTks%wJKN)@5Oxw|(rYoY<^pjHaKg{rw8yIXwnZ>YbNnfv(K2^;w{TUR)P&V#weZ;n%%A01PtXtS zc`V%#kbXIBh1<$o#9E6i7QVM};%ko$aEaz;Jk+3)v@pVy!Hef0$GVoMC7>bIn8XeTDq5uGrwLOXkU}#OsddAa zDqQA)BO@A!v!z$#s749(opT2>N3=799A{T2GbVx(^ti6S&hVtu6g6j<&8 zfg(r9B0sc$3Nd@GsX*Gabb-OQ2s5NVOUjB0{glS84o-m%OC;!)iJf!rAS^3>&HXLA z!PxQ9O@K9abw#hPnWa$Eh93U_Qb=QO*W|2zAHku2*Ti{N!i7LcrdpU=ur6M!iCkfp z6h&H89+r(XgYm%%3MOuDIF`vWz-Ynt2O~%j4WkhQmx7ikXe4V)?GNtEFi-JWIF@; zppeog*<#mt#dB7Rr2g9%ERa8u<$f?R$551SrZ=>u_x zJI}BfQUz*^eR1xLQvKCSZZelcc1o^DUYt5*aSJL#*OOh>YM3}2BJ$eRJmII+z-1x1 z8fQcJyp<3IlkjUfg>ialcZcdZDr}AhQJpW|adr|OA*@qczMb^Zo$N}>uuM=P61S8z*{rh-S2IQsi z0aJ7;(+?cN-{4wGwi3#P%gD=XJqCGS^Jp`Le0;Py*vf6bg5s_{h)ofMUoj&D6t z9PRnIPC6^Ioi>(!8#agl$? zhIV?kXjr50t;^=t2*FFqS?xYqB)j-LK9;ILarqw_6giNbKAg`4Mx?vNe}^}JW2rx2 z6*C(>!@uCozo@4s0}K8CaJext(lY#R@qKS}g=ONPr)B$-TfXoK_WnyRlhn4ML*JJq$X#Vp#|E=}jyOIAx z5X$mr+v>l9P?kTL-akMn%b#TQ-vFV%YyYBz|F3~i!oQ4N|1J{!z41SG^It}^{64e4 z_V^DH%JL^t{y&pY&C2CQB%iy=i)&E%UM>h!h%`+`=B21>72p;dK z)aznsj&ggEBu3yJeQ^mCw~WuyvEX&z9;W%C-yUD?A5RP4IcVd$Eg#-e!R+b%Is0>K z^Q-@|=*4Ajb;;)H#rgg2@#ga7^5*uY;oI8}u<1gK)ynou?%svXbKQ4BiVwvXx$foh zH2*sN7X5sm{936S!}r?ub`yVW>$Y*+<>GOFaefK59l87(bNpFon=Yi|#qPO0%b(|l z>-jBQeeOnajXB0PS#|Mn|52G)4T0Lm=q;6D?XA$m?%gmJlJ&GkJ8i}}lrr_RuGEvo z>pSx?)C(Hi)Z>MtH zuJzS` z@xoA48p=jDG46zeTadl9jOJ~$_wq~2@vt(XFM1*u8uBxUVp@m;)-a*yj<4mZd!>md zT_s7nvpKpfM}CffziWO>>3!XxyB+w^8DYyypz}pfA*E~O@!63tK7Ne#^>Kwx6;Jn* zODN*N1RvhpWW!buK}^;c9;c|IK>6IS`x2Hz{-#l$DAtmX zG<~anSp4n#cKIJijGy6?xG(VFcOyvZs3pHLwhoG)x1raX!du7HXl5jqy%->-`yhAF@k>AG(!2N>TbI z9`+i!p+<0Rk{u*+h1gb;z6a3)9qJcka|GSCklof0H5Zjp(tcc#Yp61UGCt_c7T>7a z?S)=m7y2a~(Q=<{u^SxKA!X@(aJ>s7JI@9+--BTZ<(_f;w{x))g#*T_j@%P;1~vgT zMJw^}J^;NBeNg8b1t-)N#SjIp`_?yDs({joQIU6hzxQt?`;f>S_D3PA_fWrhaE<`mg zZc|9Y$W}3b?4-5d*+A9rtYi4IWlh-YL#N2aozym`h3A7{I~{onSG#{$wOVhPB(#`a zE8cf2TRU6!1K$Cn(KO`o{$)S@N$hUU5Ar8wLCf8}<{u>DquILz@D@IxfZBmb_WGUq z2kVkI?+0&b!KqXQ%FvzBRN-|x7!Hi5e}FQ;ie(P6g&LalWc^A+hwAv=ZP*eM*C-_+ zSZ1?cm>WP@8a`6Oh#p@Pv7$s%V8NgqambY@SWHdkZ?o*zrhuYpX<(U1>-m)yBEUVP zsrO@vw$f>i1%~oa;s7n>4wCz5-TME>+&e~DvMyW0)m_zP+qSxF+qP}nw(Y7e+qP}n zw$;V2_C9-`d+vSD81K2izV}a#9Ajlgi{6nw{FO5@XlrGn02i_TyQ90`i;8gbS zQ0nbcn7`>3NlPq0@5l1Mop!Mheqmc^aZO)jCOO?IFlVf&wx;`Ux&u)f6KF}oIr~Zb z>w~%s^>QZc9k>{eFX51F*->wjFow8A`-o28nE?3He^Lj z3i^EcVg|((#Q73R+Oz#|N%cL?3y?5Fkb?wZ$K~cbb5ZUwV}C^TA-I;_qz&##8VYEvDR z$Ec-8(zW&`HsFSHMzZ85(pDM5x?TFWY&i!>WX>R)*cB>QW^uYEQv?san^#!W1O8Lnh#lGC%NC3EzSbU8KP1Fb6t8D5wsD%tI zpgKGNZsx=oRvFh!^w>Jgk~v-E%(>5S=UXW`%l;g+mxlZ+M<`DLarT#BMD4TzS6Qf8 zr&ew!RzsxQS<@&j$zR&p`eFA1ppWM6>V6L|oZ0wflV;_D@&XT}oB8!SsT(iC-{+e# z^){EF*{i8wg{1a-<2Om-=VWt=Y8!m)1>9ZSEliPXsMI4ElbPblZWmDS;UEU1dlQ9I z7TFhfPAr58tSyD}4lRWB3!OASBaPXi|9+~qnGn{s85?WJ%eAOJ`3=dR8yBcQEQIZ; z53@#`Bx;0Vo_CTXV%pP^MCk)}owt4VD$>f?dUqi-%H!tSq{M7iVDBL#g7?7Wk*`^) z^uC|P(|HoOpVqJJLJk}Xc3+FMrH{b3KlVI#qeZLgd+3p4I~hL}EHHjZN+i@rQq3Ga zEQzq1Q&fv4L03jzsAW=LYG*zON+Rr$ooN0FT)$EDbioW$CyId-Ep|X)S!+y2&_-jF zBzb7ZOS6|?++ZmX#dGKJHjhw>^a1LDgSSRQ3OROUg0T8Uq0As;DW}wFa?uPSXMD^F zz$h{C)H=-&?*5Y)Q}7z-#gu9d2Gwxid}sDS8}*fyE&zWX zT9fMi#L02`$xPw~{1U(DhLDWa;tACbA+bnmhEr;=F|E;#9p7p6OP?=*wtghoo*b657=XLpH~>`$7It)zu{*e%e&)YitVz5~ zw!YJ`ceZY07L?c{qwpF!hh0KY@bL=EOm~?9^kVG_q31fIsP7N(WK#H&SuHq<$Y8Zn zbGomRrWJ{gM8!*3#3{c1!Ms_pS#mhd55C2h1bl!EH2VWGF#3nm=VW_~_NFdrh1Cvr zVl02F64+CaG0zA=@2iPMc!t~+299k{C&{QH-H#5I(b0k5`IcZB7LD_AK=`dl1$cf{ zIs`85Sr_0;a$Nhf7eI!jp?AFr0xb-6jU1NZXynNj)@M=iouXA7m9$~Pk+L%6b6_SF zdTh(W?Yw8R9!j^j+LpKd#5l{P7hyxm5v|Wi+I0I+ZH_{)v#o&C8K7G>*f>0qQ5&3W z$gw|yL@9ei1#xTYd20xNK;Z*q)cWz~g!F;KIL4C0md##}4j|x*p;NWk)gfmbAWT#f zs)9R}l)w@xUn`T8iY8st5lx<}GhbCyx~-eNd*EHD0sNuQIX=ZWqXxusXNzjTO&G z4C6FppZaLzkY10mTLK(_K~4FR5X8*3lNd|UyShZ^@`i}=kP|c8O)*i+h-1l=!wKYB z3LLW;6y&LnW>}e^pfE@qNB9kMOw8AgeAdmgk25rl7i8-ZEPD<>su(WlWs~&dP;z`q zhK&YPRt%G@Vt{|v5|vG*X$O8Vz+Ri3g+M?hy4T5p48k9`3^53UNG!4dH2^vZFf$W;YN@x-}H}foBew_ZY|uJdLw~E;8s1Y=$-O(MLNw9* z93FO`@)O_0cQ3i1;z$b5x!wgl-=}WWrHv$h4G+G*+&V6B+8O(Gv5&UGG=L(cb7EPj@#} z-WXnQEECQzy+4C1t);r&+}{LE3)*(Lt-aZyKF+R_x3IjilBP3{INx7+9feYN*lEvP zIyg!vy|=i+w3qKb1dEZN_V*K|*% z*yGvUAu`CFayyym5HgkWcN+^wOCO{Met2pxPBc$2Ipr;t=#k8-ndHueDXcFNPrDcD z`ENSByQVv0v`x7dn)oOxQqj+t3X+={({Jxc2r5HqTRCcG+SvGcZ$M?pB3Gn-$S`d( z^EIa!hXLzqj)~OXg&EjZjnG@mtBL9bWn?pdG3*~;oVYPa7}NuWn{I@ zyHkjTr7s{41X}sJy_Grr@r{DSG|bw$Ih?6|CK>u|s}dh6rV=5ZB?o=Y4%hO_kt7qK z7(o-OG!j%*CtMBv5K>8V#YBvAp&J~l|M3~x{=(gMUvl4&bSd4%$?(HLkuK4Z{o3>1 zSoOxs^NvAw`i?g@wzqcD;R(#pPi~y7F37V8cXJpm)xB)(&Dm0^Rv6B z!Pr9%IT(;Jsgu_BsD$XF*wYtZR_|$KL+c>2O)tlc{5Fqlu`~Z$w9Z2IXof(gOvW;y ztFnj=2KNeZF7?L6*?SWAib;da4o(jCO=HeUHHAF_!)}Y06))Rx;-2nXfaM;Wz``Y_ zc@A8kc$O=B-Yy9dXuES^ju;=Hh@DYBMz29%mVEGFDNdLEd_e$c-#}0YeSMXO9tt@# zL^Zc8CLPnu`vA)uxHP#W`Qrvj)7-JvFM3pKwb4Q+9gF?cD z6HWOQx(y~;&Y*97&@r@xeTGpGmPac#9y0y-g;>D=mb3%8B9Pzw1Z?NYcO-;@)Nb{S zx!X;(`e5>2Y@#z!^MMBVWDJ0MyQiHEzh+yOuh10eNENA*UJ~qJXlD{NS@c<4z-Goo zN|sP^4dUKoa$1@X7o^$<`;NInR>@L}V^UA>TcdUd0KR&*l^{#9=w9hE4Y*l;2fDEmMu2pS%H+Ijxs`k5DX9=?hv z5h+A0)%6g;OAxQp{xFV!=~~z|)E!$JY<{+Ff#d-kWwYt88@VOVOKB1!uQ|7s_q7i? zsn5H1XR&b)F!v`Q@{kTxzV23G4ER>46(Nt@vGdgZuA`z)O>1MB;#Oo_JIt%-)P~t^ z&l*B&+&_8yEg^qR^W}2ZIeeBG=3RM$jyudy5V*Xk#CZf8e`N=}+T%usDPP+^$NvV< zc+RE>c#JE;k~EpQ;>pge$vo|*a>ME3al@2Z6Wtc85f*3m!9qq$z<6zbtF@n$c6@zC zK`Jac#GkDKgx)y`g9KVI6g@zAcUIs$xsM3HI4ZQ?b$ulxn}I|e^e1wqCAAvRtciA}K3?$zD<08Rh-56Mw zXk7c=J95%nTh=}Vc`#pH0hN^a=mFIZfgk;LHmQ1|;XXgx708mw@Y02owU{3Yn;a2_ z$_I%_D34i+Qdeqqk>A??ynk|yC*w&XB zn5}62fG0`-thGpXTq6+p)^jek3juFR2n#?^`;)*hP;hAlp2}I4rYFBgLagdmTy51! zTWgf6s4zI463DCYsN+)bZlw&6)UZaJIH%rQAixoYeH;j}vfwA|FBqm0q<)doCiqfe zHkk*GF~@xn&@~VfL&`Wb;bl2uFlR==3}3(1C>=*~Ec>ckj)5>+&+M*Al+oO)}8se#Fp6kxC!}w=Ls}NDDwZ_ zdsqiQWwaL(FXXug&a?_}VIJbA#(RDu6~u%l z%tiEUPI3@9){CL&?r{JK+%B_a-`bT-1;{oN-zeWKB`+KU%Q0syupG>#T;2Og>@TRz$adMUwA2V= z22mzvSy5@B=jx|>NeVwA=VV5kP(&}Y$-&d_m$#Wvb%glULp0zLP~!)WQet=QA8uv4 z@-ygL-j7fXykoxsgBSNpAlk`qJ%K&~ z8NNv5>H<;b9{SW@zdqga_z|hxj%8+PHlDCj}&Ym%mwDTM}4K|`R8s9RG$}<_#awr#KS$N{>%4{mA zw3jOKaPsnyi^LVEQ2;LW)%v&;v!raB5fJjk(?Hn5zG0m+`Iz@jLQ8)xJ;1y;I-5QL zQ4F%G+U2T+5TnyBrmY@e{Q;*fWf9=g7$_8=D+N@^!mfDcB*ijJM%(iOSyzUXTdBYZ!9_9LMt@ zJe-FQYdi~)8^nA8lV;0DB&2KR&}IG+?RFy3QHGMQCFe$2D1aPYYI7%l0VHY>Qpd){ z_XuV)DMWbuvq?a5Ur|C=qljCOIeE;m$s(U!#n=Qa?3e@yM2~?a@7gHURbUR=z=g>B zURoOLMEQ2}x`w-(2^LQzR4kd)O*$T<8f^f1Ztd37ja>EJmI&PWd%4dAW4qRv!;05y zK|oq=iJG{4eq};pIa4koGktk8D$(GrByDkMVmna|_!VoB#{sT`{1u9KpbNB$vib!! z%8tj=2^!cWDg$`fc*>|AROASZG4Qq|kB;dufJ;Eb_Xv;iM$Fy-=Zu{OUB8`>;1LTk z3bC`=22dl6rD;aXhGy&)I1j^AVZLoRQfm&mACo~3(8L!HRaEzc5IgTWR7p4R&4tV@ zB`|Xk$Z;z5{G2J~+$-CIB|pbRL@Q=f@%)~sGMvETv7tHv5J<%Mez+DTtLkkgB!-ET zC8U4#6SV_GHVd-9FM5uDY^}Xt9gk8+AItoqbDOg$c zG7R2?>)?QZ^p&k0XKa3JOKM(%Q=RB-k>FTciO*X@4J2>LA3Hp7%Y26n6mP~&9Lpjy zJ7*aaKx)HW7lzM3WeN1f6wlfL>uv3}-wezcs1Z|PPh4PKHtM4pKH%JFFbBVIGo3Zg z%HM2_!CW)FqZ<36m|s4(!CYG(Kl2N&z`LLTxBzQCUneG@zub17xX|Gj|B6fCgl&n|{h_l<&Q(2wj6M zn3!A0B=8YSgTs*b)1+A!)bDIr`O3h7Hnqt%K^aG!DZA+&FMAGqvheS|jydTg@=d)^qy?hxHsFGqEeXF5Y&-8BuHLz6&pGUQ=zi zD>OF>Pb5CbYpfKgD=q@WwyQIsVCYoGCuwa+~t0{SlPgm+(zWMTK zW9~?GWt2TtbF+y@ESX?zJ|XW}VuitV*oDHHLBZI#SykH>Q%)>kh#MT8rS^wj(yY!^ zujU7W%y9OMq=ZPs;pVL+P2eF&8OIXVR72)y9)MOzDEnREDMvguT$#gN3>KYVlZpF> z8^qD_RVHu=!zBY#X)8jwI zkSH>&x5J47A;Aq{XA-S(&`SQ~&hQ>uNiK$xZr%vciQmDL_IppsCsS4U)n+(yoArWK z3(vLz0e~49P|$f-Zt{7UIOi!J_Sssq|Cwowh)~|gKFWw}McJ~Ro}7cBiUMkV=+i-x zKKR@}t98=IksADn8d;)D;x&Sy3r`+hsho7{Qq>t{QxW%*b}d0|%9nTjIZRP%l#FFE zA*F+aG`aUe*A{{-qr93V#<(A*bHHh63i%qaruv1d&p+(=FoNI1SvZ%@Dpr)vbx^O} znKlZa8E6Ddf-NzP%J`43S!vd({o&!A{d(X z3PpKCkq{#83y8+-H!QHjkZCgyGYnr;K-d}OKz*kuqgbo(N2l)|?)nCZii3!)U9O;| zXSrw-hi4)XTXQ|eZqMT)Ko!&urc(S%u^=pKB68N;u6|pY8iLGD&tRPNSfy5xr1jA! z>w@k^y{Lv?%2<<-u)K~%TaFdw@Qova*n-DxUxHXN7d8N0qQ^~I>%FnekL%(2ovfXhA21GS z?2!KskopsS_yei<(!=_fPDrNz62$uAd;C;URm1&n6dXDhCTg0014uFbmmt>v&hCG$ z{KWJJg!Mm^pP2q)xcrm4!}J$w^&e1o{mu)ur~CI;oDa{JnYZ_k;N;8o z5vfn-*0IoeJKi_Yb zlCKzVP~LxXw|~xQyljR3`e5OH_jno8KI;0gI&FK~J{!y5FSrh;rkQ+Z;O?G1IOx*) zcuSwFvPUR1?@0di9wMFz=S6PVOMgw!{Op#d)uXR_k-C5DNByA0V4cErU}BAb;DD_a29=&4vU8QEG{=wAXpBXs>`7z&$RWMkYTt6wXm$T9-kIg(ZLjs!rzEBTG##N5%CP;=#6&Z;S$l~NsI;Y;q*z>i~g?=9-Z!toaBao5HI zRrDDRaTyxN0W=3hueFf)oy#lb_2=u84kpRuT$cu2h-4H*!jY?viWJo#t7z~5Gm@V6D8Z0)Y8dZ*Z-ICwS^vUH@t9Rk#{>p&Mmx(jsd)dKKa56$n78sCb zJhsHDb}|Lk8JiW73H8$?R{+dUbCB%iC(*LZ3j$a%m-#NEzK5m zpgIov0Q7clFFOM@cs;eI351|i&Jr+$D^IA{@-?P^wn#`#=g6#pP`T$h)^NM#RUL7{gRWcwl8G^~2xnzl?^zjDis%UKIT@vH^4KVALM-)3xXh><%v7 ztModqlL%doH8Cwl>r>oyIB==d`hAL|T5QK9q;$Cx!kc+5aeOFS{^3c(JoeH;z6{v> zmuwha+I3!$5Oc86z;S~15Natt|id~G8;V@<+Q2N~uu^Ku{3U z>8K9jNE!aIy2+TMTv1(?VSwBofRI>mt$j3zfz8e#(F@t zz1V0yTm3%H#+H(8Sv;LtX?e!2KfPWomuPR==8}JD&%4UJvmEcC-flS{yaeSnL>@D< zV9g>sT+J|pTQW)=J)wE@wGhl$b7fn*okQVNGjm2IDDWw{_%uf5!TT){Uw^m;&+@uX zdkSoMh$Z(UU2coWvZ|OeZZcuQltQ>bD5*t0IRzOV97_+;T^mgA6ff?rrWCBXOzk+x za5NjCS-w3RK58#?#9~5Q-vf8ZM$gi27DwJs_;>QZY-Zit);A{2GCO!;o%9izo=IY? zXDIhN&}#T>#G-iaC(wjL_&5i!Lk--cdyMzTyIDn2l~;YH7ndlg+2#qSWUi8|&QO z%MVHtuD#LC=Mbl-8{}vv+_~-g>ImRi7+pTSOxsj=d0{ihdJhgl4Pv7=pvog+T}(A* z%`FfPP0BB&Pqq~h7p|XIOA=Nx_Bstog7khp%3^Q(L?3~p>XpERbGIC9*)Hij>bxZBCk*o#%YY_`2Nkk*13N=RfYJktCS;yM#cE?k#bO z)7j}WBa1-IEpuj;;psk<+PG&;7Us8vkW0xFMa;B37As}`^5m$e3t#~R-n zr?43Lq~syYD#F#TJBDaB?{W#dMw{WzRU=45v1L+*|HgeRsAh}&k{lZzYdl#PDTXTb z(+`0W;C;~r_1ZEzj+a80yj&pL$5v^$Iu17JImD~&*WO_9#_4o1JfdJ2fZ#jJkF81v zN@@>Mu6CvmT0)N8H;I^w7$g_Kl&nOZb@=hzU~|Y-O;yZ6L6@${G%WFmOc1=E+?#nI zU~{rD*7ry@PesZ^4-UNIBh5BaKuWTe-un#*wC_5gK|)UlWqKqm|ahi+|LponJ8` zGr|>Nd?a+NDSY3EoO6}iuron_VBx~5oUu|ZJb6QYOr36)iaCVka?I+bSxiAiQTof)4=1%*ZghaqcVQVzT3gT@41I=tk#P4aOcy)NvfUe~Xv#NGrMyRG> zXla57gez+Z{l!vP%i?4jQrCkXiBTWD&vH4jaRtY9J_1C8@JV%AhpD+XBHc+R!De_1 zCqHE6C$926yd#_BS{!|jwydsIl_hBn=oC%5ZPb8`rK=m>K>XjU$}`d5v|I3>Dx;rE?wwzuQ^>QEhIjg&YdT~G*L{ERu4NgP9Rq-bNgfRV?8h9M=|K` z8$7{3G?#gg)`ct6ZPPm)Y_pzGxRwvGR;nH~TV<_E<)GO&hqA6~0hRXH-t;vQ?&8WA z*(!XyW>%%@X2(%p!|dsYDeqO!tV@OF-px`Pr+4XqS2s*yue(-QS(Eb227sxlORceT zuhQw+{8qZb%-RH--B1BE=K_#b*Y=?5tWPtzu^1xMMvIDZLHo^RRGq_9G>+t>TYMHQ zohuhtkDa_|ym5T>BaQ|Kn+i%Ga){Xuk~B4-0nFo;cvns6`?lCal?9)9mk5M!BNyvU zh)W`VEu`&F!{bk<3RZ+mLNp1Lxl*ax;c0pfF*ld*zxsVd51kG(S2*0w@v5Xg$VH*O zh0^q*aJFJun=;>0D6gt4mt%0TRLc&WXW3RMYe+Wf6zGoxteO2ETXgU^iAoTiA6d_4 z*392tJ8ag+*3gc?^izi#UMTb%0wjDwREIkwfp?1I)-pVZ*}Jq2=AL3N=n@q@4ZKTy7T3|%c0OF5J6W#AN|5nraT0+*9bH}(#c~G0o&0zlc-Z1>`nY`@7~DC+ zMNx*-707txH46O>{E!B?qLhiHwZ8F9G@N}*ItQ~y7$P{(0|+A3(H_hcTX%8;t~sJI z;%m$Hyp#3gswHD?ie9ZF&b!5t*bC!z|I(SLacl_mwOZrMqwfG3iPXX-v>_3`&sx!^zVB9qfMos z>)JK1H#Y-#+v7-7_I8NIF26dnJKNV5;2>i_zC(AXR}}X z>s7D06~k3q&`q194@r_4Ys8mG(Z%D*mo)O}?@=AJ^5k=>DfK}zu-5ImYG}dqFjsxI zZR-S`qURWx(pA%|Hf;43*fgCL+q|r!!_;kS!;F~E%?6i|8vJSQ{-v0TO>x)N-0}Od z_8(%mVoL6OQkb3QLJ9rT zmG30Gy6&9jtzoqHNMuVIapyn<#e{JSSnltQO<-5j{u86Gk}RP$glC*P&jGDXDh8S7 zzhd&!2t*Lww!xrc2n_WeT5s!$jD{3VdZ~oPUPbZ$y4D1#fFUGh}}AcJ|Q;{u<+s(_Q^U z+V=uw37B}S)#<2PDUd4R^qq7N+5L@VJ3O_fi`F*$(lENmiBu&+|C!mqf(NTU33_D( zK|d%ej1a^9{CXz`rr2o#2GjopWfU|xo_tNQ1(AHgbGB5BVo^f^xBcP(O(`955p#+MRsC{^B1plp?FdfW@R~e1GGfZG=>mm4_$RPL~EIn|#+b+O8 zwJLksz?cY`nChNX3Ri^EZ~7o;)~%Q<-4w63bA$>0hr?OR?1*!wkFePddN_vM6^EYX z6{Ps2!YO%6qZf{m;roM(= ziGe7>*b383Wb_N3H7tc)%!{DXP+Id`zy0HjM4N3(G>ifM#J0Zfe1seht4UZ00#EkK z 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 ^eW$x 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

    y#-OTyI(QQ>6Pbk)SNIj&WM_>9;JPWe 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%0A2w46`j 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

      O0n?eKp#{v=N-{60 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�()Ev!gg>6KfBf)=_nzc8Rm~sm{?(rUQq^$%<4xor*7g5URipK3 zttHMUM{jx(bVfYC7{6Lw-xR2;PYj0hJ~mXJ7;C~ba4S>4-F;~DQ%lD8Y^t9MZ^m-P zPbT2m_FqLW70dC+Lecue@dq0m~2|HGEs`PS7jpkKT_(NwmH#=ViZU;5> zd`=(si$iB~dT%$geF%Jj-tG^qFOR#D^#{aZt_RysuD&KmD<}$9oc7&HxazP^2_<+dbT3%0&ogi7MxU^ zszy>BJ1h9Ev-sGv7E3rAhbomF zIR8{)I^Cw%AcjzD4IMWXAWy5+Z}mMT3r zdfcqu?`EehMCd+R?mD<`S5mk(9YuZZ)r*H{{Q>F8lPM~)PMGmM-&p4L{FApH;mX-{ z9*<=GY?0|xKCky>`SX%o2Y>yzLW$sQdyCKLn zOU~tO)pTsqf;<_nR0vbQ?Rl%t~7NR4>5sy9%6~2X5Gr=~!8ceKm0RDm^9&2f(L1W7m99Ppm;XpYyiCJ3+y<~hq$+>dsyZEFYdJ&EPL znC;trbn#CR@y`bE+F5X)J`Q=`ltU<(rc$l9URRLrmf+HtWSI?&Q&fMErQQx}HDjJS zMkCJJ9ck*%DCRW3#cv6g-sUUg4hh>I1NtCei;~beTg!M3ez}ajU@(6@e{97c&j@E(8=8bq%m1XnU|J=T69MfUif99cj`}KMhA5hc& zjAuYj+xzaRV!JYB`-M>S+F*XMl}}rpxPh8h0sg1Qd{_yv=Y=*H$Kx{k8Vf4}{mkW_ zEaPi7(Wh&u^ADL<>3iMS%uXI%+26YXPbFwd7Z*I92U#wAX4WMSLX^)n{9MQ9hxH*M zfUaI(6Fc<`EKteqdcio2+@;aeGsqMoWPbB8OmLUw;XF|IE45S1&?Q?XOF3{utD7N) zxUP~!&1JJ_UFGWmQ=TN7rotKR>N@Q383Zq#&P}Euw7^f;di_NZmp5`^VePYceXGxw zv&*i&X|FhD@fkYQm4;V=q43<#U@-PJ8Cu*~t{P5BQN&O#R=gfJ*7q)P($aL+>bZE?m~69ACKUg~0OP!eB{&j&V}epP zo^6q*;!upgn*B*2U1Wx8Y&Jo06u;c@DqvV*&bx=yusHyx)W1;{Vb&{6NECsOhMp!W z5ydsi6~2n8ch6u0u9!)QKy1Ct1l;6t0}$UFXtp9C?%T!P&kz-s(B)NK3bTpMe2?Ra zSABa437bv3F-r-Vl6UB(5rC`JRDR6#+xP1CRA@x2 z;DmzjXq#Ih4$Qq&dun|Io3}QAOO~LH4LaExw4T-lQ3;Au#ARtut(Q_u1b|E}+c^i_FYqRjP zuqh?SwORMnvs;x4#vBn?9MK`kxdBw>!o10k9HFUWsH;+4gV2|X57KYTQK$=((67ks zQ;r9iXqDBsosuWSC6`Cwgq7M~w-$@4@^|uC?*y|;Bw%=D?MeIagAzgMJ-L#zYBo55 z;6!Cy#-GeUnFKh4KYg>u6nE2tY&MuM_r;fY*Q!SDvD@3Be&`+Q-A_JK6swp=S8S}k zM1N>79CtIz;Ir55qg2&A!dq1YZ((GJT)#|3Px!TkA#mvsu63*g^ z6NF!>8OrQ_?kO_~{sesO zysNSWJ!2WCr}wU`;i;GT15KSSqIS{=%!z7golcNo>}O(;rd-&hMbYbfGO`YGW>8Xg+f3F~(7Mxq?D;@y+_Z7NVtB8Y12Aby}% zNA|TyAx8*x`pU#f8R9=zc)uq4%|UoICjMw9>xlKkVL&^~Nx??W4)-sKO8PNEGd=Z9 z+@WzE4SbG1Acw(ovL=(gLs|fi^j1;B0&p3=jcNlusG4=)un$hX7jbu-n^T! zFS86p_{ksz73#HD_8k!HB&atAV@V5yE8O1$%`St*&l;26_-(@h;w|*>I$;w1- zHOxujSV0h_qXrCjPY9&1KScXRL7>cVevsSu@l=%Z&m=vBxCeJ(6gcG>9I9PH9R(RS zFLnnmwdE>JwXvf#at4S@-bz@j3B8Xng8Uk)Or7*I!l#)VG9XO4XHK}Ii8~$xXWjwg z-lvc30X$HPCtn{Nqu@hTe3eBGslU~v++>>|0o)-(nM5hXXu7jcP(Tkydf_;$h)fs| z%(dOG6fj>fUcPOx(Qnp7r25mcM7Q>Oy+gXfl!tZj_zIs|xfs>G{_dY^Ccs0K=Z za_)CykR9VZ7c?2aPu-e7xTpC=5W}6T?a~*xIMNs?U^3UeKRm;tkw71R^A~auB_jdP zLaDvV{IZ6FVoFiW#;XHr;B@s8r~+c(w2Q|CTU~z4^W!#5gTfQO38n><(Aq$Ws{bR5 zjse+_cZcS7v;?y3KmDk6)WlkcKmM7N4Sr?Mk7UCwt2=gK=gWo zW4Ms&L0%30%GUx zIq^C8){|U;kbUZ-`kn5U=2YK_pjUBiRUtZ>D_}5j>jZVXk$7&C(vzP_VN$v;Qmn*N zT7BTDIls_RMJXnQtOJ-@T~r;F=gejK4&{9VS`2Kz9{G1T3`u+K3MV@$P%EizDKQP* zh>@JP+55B~t-cVlJBunzKc(a9Anbx6i^RdU<~9>Ddhh60?PR6GC?(Q!9AFinrGIfF z82q|PQcf+GaTayNG0F@krQsK_F@L4p)UR>00_vI0#uzGQn5~wFE49>BWZGg&+E}7; zhWCh~7sNv*)(#^uauVgbu#C41eP7`E?dxis4Adw|?&d|9_QB36`(7hGwAqSCGu*8* zmt&hs3wmV}azBmzf%iEr5q^&~lx-4n5Bl8+&6myE9`U&aZQs(994Ow}xw3nILK$By!Z#c2Cz$*2jP4xCCYyntE{NSjNdT zhF+bz_CVVX;Whv@1l1%jQO+9ctNYo$rnZ61qnX!Y<)pbWJ$$^_v+jKVo zY{KPWG%LUDVv8nTU{8BjL!N99v0-%^qoaR~zvM>qXA+0L-V3U)cUx@i*X1=mB~>DA zP*R}(1n+Qa_0x}!Ed2_5n^dC#Omsf`G@MEHO9}m!JE`&5g9!5MyG8MVAaWQIBTXsh z1mV^7Sgt4OV-0@1MLA-DfxdR{ki3_ujlcsVK`&+RlQlEu?1TLGR_7}O4G;q%YT_CW z^# nwED&!0)AD=^XKQh-gTGZ_y<|tg`dt-9$>U`_=cf9<6jo@u*;Os|X%(5?sQv zc3rHQD#0NZ0!0a!NUAtfME+~g#$UN1{86p z4j63eh{khg$!n^kgNOb1Vj>YcrnNfY58;i}m#(w5EUuZ%TpFK?VD$WhD98lt3fJlOfexS8 zCBoS6w(KFo(J7lIM3prHnkI7!ohrZnd@25VEgc>K(eu**CM+-*yyeZpPmskscpIJc&)1w~hc5za3ECA%-6NTo2Ws_9e=Xl-qG@AULeb zM1b}$_u1Rfqbh>Fb61z;)Y{0I(M^XDC+e`2WCl3(W z^^KW+l8!W)3TjN&B;u=+^J zxwj7%O2m<_JLj+>WBl{Gn1g{1r5T`WitFSiZZ22Gl_lQP&JVsnMa!%iv*sZITApPO zsRQLD#CDY#m^I4XG!TwV3;GfqS0p+DS!;t@!$-DVj1s;!638B3-=MAvqqrv#2U5eB zVi5^_fdW~w@pA?d?7|G~GANRLI*qA?8%}+pMQ`Jb-rxta|4>pWyRd)9d85+$$Ai5D z8gBW-GMf|>Fgu*p%M=u4>Tq?c2nceTOo&rI19`9Ghjl~>KGW|ehFB;rdM3~hXk=KL}vWQ7_OVAMnZ7(xv4u)?_yw+my9 zJR7fq*cXYtMUrlB1G-budP*o96B^@y07Tsb^AuSdK~EiVv@zvRD=ieI4iLx<$`2ir z2#!*I5D!RXwY_|x?|q8xW1ll!U~RA&+fJW19)&(yy-0iv&(iXI9NGHEr+Y*Axl-4h zHg{wl^KIqjL1ovWAS_SY!hW!aOauYPssgQ}S;Ekbk0lI7A9cohBz+ed)5fmPKTLB+ zDEmUx-+gIOv8^r;?HxdeYb#2;{jjL!Xvd%xxkE?gcA^Ro!l<8Ed|5G-QMex6E|lWY z_ECUgo_fx(TkJqna|z#zYU)Srh0Fvizw>!zuHOj-;9g@M1U6+DmIVoQ0J|GWw``-Y zl$3FRlu@XTGm;dw9C7#=#s2b6Ig44O3}xS>Yn_ruSP$IllzAVp|D8cio3g53V8WX2 z?Q^L(NR9$rgZWaxCb)RC8D6ZGJRGA`5tqdyg1FzF9nvsYBe$)U5}6H)-FmgD(l&3u z72;;zrKSz|79%Fe)+)dp;n=lEBZ~Yep=x73K6xtkeVP=SGT{*%r|S z5Jv0lg(wPAYb}Y)Dj9aHF0`a)O8&P|cXJLjssCf>U^p=hME$5-5@1;J{G-QuA%z5A&E1orqGGv*@NL8 zLTRPp_&$32DG)N=2`fqvD%>SBMzrp-hm(z^h#@l;zCQ+fj*0vNsis zS7e)W4tWHKNp~k(jy3g%3If2}d*U?~dT0Z!8~N_>CWPPlmL>(}PS30cDpmIqT`1>( z?>sZ_fLxbSWzLb=bKDk}mrz$0YFE4B)H22Q_d^S08uW$sg~ylY+k+BaX3FK?_1{MS z(Gcs8NSJrh7t9dEI$|hR$d;J{^lM?3pAIyL#K7;eaqCWNvJS=qxjZ6WNIljGTkjvn z)@4Rb9KSylhiaVc7jiYEFgQzkobmE{nfgs?Pk0u6YAHP@E!NYw#YXda9j3n18Pzv6 zy~E`-g51-N6uPR0_PdE%XBk;LU7CO);t8(ij6?z4BAg(eOY6_s6=v2Woe<+r3gLH3&k5jUWc`EE{>w@LPUhdJ`QO!Xysc*Vn-vS3%)hAln+oCY>exA1|86rm zC-W~}_*)$tBg-#-4EJwV9&j@MLa+a(j)RN+?>2>VGXJKs_;sAW|37w4W=8hE>&q|o z!e6NO|IRfzng2v;zi~}Y=07p!uay9tEPw6|_@BAvKWl%1yZ;rg`4_GH_eAr*bIkwF zLjS|n*#B(IKe^^#@baHM{ndkC@RF1HPg?w+z{}Mp%r|(seE_+D%JhZiGfnKU4BU0D zKrDzi&4avgs}6m-=&bkQW|gs|QN|!KB~e_RH5(`^y28%Si#4Y6m+O1tR^R6i&)e-Q zUl+Z>9AZ9xmB$g~-W;9R+re4rnX@DUpO4n@W!BM`p4{A?_8?cI{=O_(HpnR&kH%vyVHe%!2T?R;*3yqsOqd+lkYUQK^V@kQ>0 zq0K*iaeUC)yc?a>^Idvg_|Q%CaQgbJU{RsMpfX*~0 zSQpj6MLhsK;D$R(XT$_L{iKDfh!fYmTEE)9N-1(BK9&8xo|4mQK@fIzu`A6fTJu;# z4PLn6eQ$9aT8hTxyXJlWQ*x-|`9cKlR&t&oJ9YQn`S81ns|YtD-DyuHd=28Jpqjnj zDaF(1%7;QD>dAbqr!(<6GTl(DdNoasB677igvUk=K+<6)0vH?E#m_JKw%VTNS`3>i z+YR@!a4MNmGt6XF9O!UZ_c)DoaC~xff1X(nb)H(k(cXnTT$l%K`7ke=fCEy0wxsZG z;YA761O^rOLPQ56z)FHwql7Icz5(Gd16BG=i+d8Bn>9>-2fwv4mfrNxyc zwy-Y8g<{c`vRoe23kGehQOEd-_i+&T79+{Y6ly1jmfUrgdWUo3=2-Ba8qZbL1B8hooG_1;g|h`+ zGVV!~1nAGBYD>IStT>PcUICpo~CKySt~!#Z>rUep)a(rE=ZiRKK!dgnt{m+dEp2SC3P1aTZr1SSl}oS z!8TCmC_;r>%QJZtq2pai77LAHiTN4*X$pyulePFF(c7eu@<@ej0a^52ddIGO+s~>! z?OOyMqtnYG2K{-}%0yUR_ip61k>mpSVbQ^kntAlDU^bY6evNFIZc)oZ31KmrW&TE{qyT4iiwxjR!h zKjyX0;Xgs$?rTiKTe}A{OtUKxJ?4Id*`25%hPy+oqldeTHVagNTCz!UZlGu%ubDqf zeGrk+-od6SMy|E+{3JI!;{6G_v;A4`w4%bL@W_{4XldJ`oz2u&;Jpe5@BM@E_jZ(u zI@PxJf=Q3*A|t2sPp{a|W<0mY5mEMc18I`Cs-6qdo_qsLa+Cb|JU%?SVGUdQ5za5j6wdp0&QfMNkNP1k#ke@GP`HF(uDOPP9DwnJw{dCnK*H}EP5bEUn{4( zcI(^c@C{I^Wp@jm;6YViRBAgmM%qlm|o^FUTM>g%cSt z&esFoT{iFB?xTM?bsR1F3LRu1ozQ042DzBqz4jGcg*IMmFg-X$g->vPX%RTcD0Ln@ z%x-dex%lUSi(zqZURO9ez~wI!oe@f7z2|yPTF}rUl@6xItgV9?u?;nKduU=wXkO?M zR40-PXfg-eoG}m5P&o+F2$v4hpiMD%k%KWf+nh0LKb&RRfca|8gt{NY2rzQ`<6+B5 z4~xmcA>mXNZyyf>GPWD@9P%*&6MZSeN_;bZIF{Rr)aiCImxVnnf0Q2>`s%v7Uk2@9 z+aPBt_tS?q>=15@yZgvFx^4o```gIvp)9ppao$IC`(l}f^Y^Bc^djmWa4=$n?g;zc zxi-PH4pCfwHIcW))D{Q>ssW?bxAf%Z$E~@2~qt=lSE)DT-x?o}R!)62eYuJyJI; z7YSy5o}{7yT%YTR-yOEBu(I zpIU=l>aWW9Xfa))BfT3WEX7OJ?uTKHgIDts0UDfbKU3BubBYFnK;Bp0;Kjs6rM==E z_4)puCnr_i1Qxtfe17jzyDEbQyE_Lpnn!L?6+eC^DQB7N)IL>{dvq=}I>frDXN)pA zv66`VC=K8Eg)(`k+7fos4}EuBK52Vsg6>|lR*p40G5+{SVnSjzs7ZcTGAjKSr zI*w>q2#~P4W~V3ugnjN8q<8<}wkOmV^hl%Ll0hndo?z;6y97($=r8R=1B(5&b8Zr~ z3VspFpCNl=Ya-%Xs*Sux7?L)%;);NeKH?0i7nvATz6Xr`$*!@0X53jqo|eREQ4<-@ zB9s!=hAP@?U9{2g11sD?cl=g(LsWY45&e%*U+r+uQ+XfPn|eLs>4fc(eRrq9wl*A^ zv=>K2@w1DGPjE-WxGv1`tM~m3zz*&@Jr=-SsoR}w5Vk=R5-^QmG?qm^w@suSbU-LoF!F`VXutl@fqAwT`C#2Bpp;<$`46XSGAe9_B-RI>zD;)aB_ zs*1ELQGWUNZyjRJ6jf{z*j8>~WG{+sFxK7Rvt@@Nv~C^GsSk5jCYkFu$~4QBJ*mRX zysAkcIgKDcNkAcFbN4Z6a!m9C7${cu8|v;{zeCrr0pdajWscVM(1qegTL|WnQhJ!R z2*PZ~`~m79qa+_!8-dua{`fUxDL9x8J${^i)ecL!K}n3|yiL&W-geB|WMxV1;xw5Q zMsEc}hB>?ELX422BBjLDaY`aZ(rje7d+is%H@H8+Ci0x*?PBJ9(8h87TA6xz@PT|= z&?%z~U`NdO1^)x<`B!gF#;TS*jCl8xA0t?EjZ1Wlme@Xq-0H&3 z%&XVF)Dje`3?re_K}(jW%Hh!G<-?mCfjeRNpM1%oe;AHFqCS@5 zl1~?vs0!ve3HqWKqw zM5ln@f#rC5F?`ZBgWdh@)p8wC1m}_X6HWxSy0g^P#Isl)@jvUq&aIte2-csqEnMaCWHcfgHyH^mC}_?~0TK z8tWseBkLi`M>5(>1e8#fP%wQ_segNlFn>(_@r~so$p*w*qSB&;vpjLH zNk)|MCwTrcyI8rvpktJs=4o=8wd-Ir`YBd%s&wL!WF&w6S1p3AEesMVmJxOld+`aC z2Q>+<0^$SCgGm=na=ORZt#p0+K_YI(TdUP?ePrxn32O%Mit-S>wU+I zB|q2uQZBow52dK=aH<{YSd85pd@KnVr|a~PO|HO1g=&m`6+(hs4Fs&X#MJUg)vsMd zST}!4RYGSGc>ItQU_3*Bc!~Gu?WaH`S>Ko14RB55Q_NVP#6oGGWiVDxzTE%5?X>3u zKq69&#T(DYA*nMaQ5vYfgdpf0u4NVn8Hwl?pKTws9&pHm>F>*Qut9h&Z|Y~=R-LjF zjiHULaY!5lhV@=)Gpz-5gEeejuU>_7R`NfJ^hZ>s!hcDcp+q0WwKOD0q(vQXCPdh$ ztC=v^_{56rK0@NW;!YfTy48h3y)2_U1Q332&(W1|P>l>)6As}9-nKM*vQn&Hc2kJ@ zB2`Pjp)$7v7p?fT_~F^D~KyA1l;Gk$WRAcU)8HP~tVM{aNw!?x9-(5X;M2 z!%U<};$-=nk86Zj8k<;+u%AL^)Grpl+b$GQp{*SGL?*mW^!SW>|BNe+#`w{!-%IBG zPFRWtm^BtCn5>C}3j=KYM1QaCCw-5J%)F$`qLL?wXzD{`wB7#|~GAk$uhG%xR2%u)$ztF7T{^SdGdvGhqM3Ug`$SSydziA6easXD203&W5r z+Onh-ltWV@O;WZCL7cEQ6KnJvrW`e`HphWLr^IdFGFH-9~Hu_Mu(aN7!wGs3ghPL|3!$R0g?4?bvA68mUTk6#pfGn zB~Q5U8E=-zWoiVOAmsv=p=s2&kD765)W+ST40>0fL+=11iMbT@((GUIWy##@fIF`a z#Is(isrwZY@_yV5eu$kGi${=S-|8tUk1fbk%p~FUV}J(@LUr`%%xfB9qXSU)4O%e< z66u%~E*IQ`+ev#A@Nz+g=~3S;GL~~BKB!JhH5oWnn?!C&!$^U!MoOo$WJCx?R2vB3 zeV7zHD$SnoRishkPiF6+QK*`RvVTGx+DE{UIvC;FE>k476=d7ihCfN%VZmze!m{@F zmn4*eQ`wSYOXdV*tMHYVY$gxOMQ1gMDV>g8zX!!Fdb;?gygdd&Mc6H-w6?RX(5AQ+ zpyttkOzph85jcQFHDy`~*oH zUZN4X>9;}?gDZB`cTi8WkGxh7Ek26yP!`CbKh{uV+$@a~n2B1yJj|~wP-^;>l3#sZ)# zd%n{kU?SA3wb2v8yL8BY?X=h0>3IVnj%(~QI1gKZ2=LKNTat#I6C|?*xE#4Unsmqu z+m&$vE@)k{UdoUN^LtC|%<%e*<$J_T$vHz3+cQ{Dr%B=U3lEZkxBHlLL?$DIgEY{= zwlG9zgaqsj1*DCOi=`%gz=0QY(AL$kgqh6z*u=pDL$h(@5P*TvRh`+mJ9e7I_&x0Y zLn_XB_kw*L``4?qELyX5ch#a}ja-A9#|V77feV;VFfC*h!__7_Lu*I`L+1#)fe6l)PU=M`p_6T(RE7EALAfwk!p z^}=(OjFvdbx;Jcr**4}aux-1w*aM{oqoy^!B^A2BVe9qqs5|sK2jpSJ_3!GhwOX8m z0gjv6D*7xSFV{#2wlq9lpl9j5_~g0!kHgi7UAwa^7TntVk~kq`e-2fXyV*bm8vR%k z0D==-hI;nKGws^cy0BwE8MXPF`3-j8rjhTmeWoiit+a6TC|=pk1aw85a6WI?3Cz*F;EfVM@~qLhgu#(=-Fv)K zbEkDUV+-O_l|=|?uph0x_}Tn@kSj-_cEWM;nr>2QfOpqCnK{bcnh0l*)mRx>SzAYn zQ5it2T=DtF{p@R68{=0+E1rAQ^^ARP*77)`^LqnJ=}2-!W;syOfvCpU7y~g-;ThVfvwR5S_Fe6o**{Zi_sA`=K=HJR6DO z=BucmdoEgdtu)fJ3(S^r|JX4Uv5c>tKVB-4v5~CJvV)((YRqpF#~P8SkRKI%yj-2A zaB-^R0IUU1aF2n$!Y4qcmo?@j_Z?2Qcd9A2!Ou%1Z09HNj!?M}apr~|MhC9M^;ADJH1hHZRnMXLb z-uh;I53YDTI2ja}xH7shoW*A9Uvg_I@y^cLVhe!fGuvYeWoP@XBhSz~0X`(f13#?i zC;|KKOx<9o2af-X?SM8gMH51EF!hA=B;&GAXn}9y)DBctK!lVDu>PrD76osU&h%>s2hDKwy>e(PDwV7wSOCm_5SycikzqOpjq!=$f1l+q1m zlCKh%abJv)&HQQx{||F-9T4UAwGB%N2+|GG-7s`_cb9ZZcY_krB`poo4N6OQBho1) z-JS1%avnX;@A=;6obQiUV%Y4N`<{EQS$pm4+H22RAG^D{&IY==oV~BE(>9yDmG*eN zZi_D&o4l?)OgD2ZbJAX2-|U`1HWWgn&2P$#HQ;#{(CNU_jrD!o*k`)-WG_2CU%X~y zN`0HaalPDE8sI#-7_b3ct-oVvxT;(lTL`%GD!Dz``?eZT+jIb<1OIX%+}bN~o_^4U z_4?>?Zt}dTjrUIBhU4|{i>nuRUSuC$8KFaV^dg>kQz1#n-jR zi|d8u#_22XtU#Yp`>yS(F}6hHqC5z1@w%SB!}t5U@K0!VXKO|!~fHYw|f@{t{x1lpH!Sm*+>3P1E^)Fj9GhD`RP z)dhFzlg%)_2)jQpB@WD4`RpA7H*K3fA{+lip*R%m3OeVAqG~w?a?ymD9Pj-poCLUc zDM`p+4O!)1SX=s|1a>H@j`U?H6mLNxh9pfl;5ezuif=#jDyP!Mf%kIZX}J0t!SeM; z77RmF(8A62)-AG)H_K_q_2gRcWFklJ`fBsyyKhO7wkfl^m7-);1kKz9*fh{FE0P(j_1!~dX3tM?qvY{uIc=InZ`7@QPF=3~p0k*A)wtahvBQ{a6ftlj zBZy+SlLjgX1mat{z@#PCd3)fRQiUr_(o^E2cAY}`anh&1^9S9plH1f>1mAbKImce&oJlPR?xRid1hb>OU&pwW+y34n=Em;5RRmnF!>=kv>5|eUbx5gwbRpYJR%$L~y4W zP6goNIUg`2+8xR@N=b)Cao+LuI|k%Z!J8qrJRJL{E#0;@_-~(JiNLwNL0}`6&Xrjj9(%E9qF~vTICklkF#eg&*3O{Y{dGai_%@*a9J=mc}c_T7Lph5z2@blMd z3CZB8{FW$4TNT>S4RNt!oJz2ci#8gybAELAYPNp({(=O5JMgC3^-$rSjTXBeJ9Anw zHI#flX#YL-&C1Vr=T74$;RLJSDp{)i#ey>QvFt6n^~`+`!ffR_)(+D3t=F;&pz2xR zdAGb^Ea#ka<@YQiNXy4ta){!fFsx&syuNe?zAj_WEK>{7$AhtZ(RGxeOBNm5M(%_b z*M~3xYCj(Cd<))!WV@aiY9~kkLQk4~y~6a|12LPBK(TMoeddNjBU3)I#J;5}IBrtI zJJ5Z=k<#g-q9pN{Wp%!Nu(Ed1VeE$j4GL_yQtnX5khl1souyEN&UB%s$!7?HwUV_P zny-#PL%isCvNaXau)ptI#Awb4f8Mv#Jzz;%vgFVt{%Ber>a#ND^<2 z`j~Rjp;F=3>~g-9GzCIBVP!ngm$cSVrI^g>{j}LKX11V7;gb|Z#GZ;i%`P~>WrXaB zNmNfEoouXQeB=DS;DsX)5KP9MBCJ!o^tB~jRw;(#e0ihW%LZCU;!qth{DQ|+bh0)%OgPF)H4hro^2Yt%}Za;b0O8kpfd-;hBQT2BGfMjSfA?E0)2d z;e>r_&3Jq*9;~)$8Y*S--RxlfF1X1I3))#jeSvQpWD`rulm4Dluhw!KcW8q2b=I|C#QGUwDpoI8@mDhd8u%jwkS3(PQ1FC>Iqc)etC3l?Ecp`o;# zleC>PCT~Opxy5r+csQY>6CHQF?Mw9y#P;%J>AZz$*lFjhD}kS%!b78riCx{R8FjDCtJ<5q z)m2D@uy1nFx;nK6MW3=uvthXK0U)V)8FD1+6S%QU&_6jy2x5<@CFUtv_~ ziWz?D4^<|Nge-lC3<8I$X8|#pe8t*k83E;sp*w;k)r63)XVH(?t+pHbHo#_F2~f;( z96E4>FyrEnV;;{kYcfJgFumhEv&tnkcOt#zR3b2mDnMLxPV*EOxe)b&m|heO%zA!i ztNtjQZa#}JMxm`%CFUh#a3No>Q5$>MMFCgfnw>m#dtmxXqXBYiWS>aw{HU!SF$pU? zC!$LL(*}>JFCfUa1Z7nMQVJ3tbED#zrGMU7W&0qLu3#Y?7de zJ`X_*Vkbz-$BDru8`bH^cSPvOeMSqee)N<>;(gykq{Jr(6xZ?k^mQcBLd$BXo&$Pa zooczv(cJ)L737eeYoG~xJhWXM%-YMR(&``A!$K#L$KTE}EV9{iz|A*JY{zu7K5hZ?< z0BIup&twz0fw3z{2!n&41ks{8gHgA&GV;R%vSevKMr@koBha( z8aG*XDIP470PZchwzU>?V;#FnH&ie>=+YMYd?B(y_Xun%OIu#cLKs&sY!x%W!k$c0 z?BrtS`!lnSOX~6Os5#Hr_jXH%%CDJ@eQI2SU*V8Xr;?nAmnlk+XQS-TD=zuf?PL~* zx2}TM56j1)=jhAB=|(=Qm`k)w#(;E@X0ToY=M^A$)r=rj1=));x+adqC?&DZW^j!%=QlWU3{@HI4Pr zhk>*oz#R3(mxjAeL7CA)x!Ps6U*w_3ztk+(!%~%_a2p@*vIvw&rrIBp@tzsqIRVer z9!ECT{v@UEyQQHsbT+Q4L8?b4G;mcI#go11^bF&@q>W`V9M5Q*38{RR>i{+bOQOJu zhIKTC$4w8|^=`wcgVEcxVSv5dkp_(5QNr?=-cUak8siye6%m+_+}wF;VPC!yL>JL8 zNE;R8hHgobxBt=<*oP5>XDx*{Q0{M(R$oJh`+nbjoxb1f#x?9HtqB<5_?&<_-xjBu z_)(U^QQ^eloOk!VsNsJSZ4cVuUNHdZnHcXMaNhaX2pj6YTC|6+I9!?BN2?GF>B|F!Sz@4LzVzT517D_0+Yxqr2q zzsl7IOdm1$ORh5hl>h&Cxhh_IUvQ>LC+a&0ho;s?1PqMzY1nh!^kIl|`u&!?0~dOm z=US=0ca5B&O++-^4Sl=1KI>Xo zcyBPu49tSD(WJBMO%RavZZzU%7&n{!hTY@t;Phz!XlH9?;^2;VLCE=b>3V|A#kJ$O z`93kmOzCLfLe9eV?E!G3+U*`b{2k-%mURH{&DHrt+V}4%Jp0R*^m7{lcd1?o3f+3w zT{p71ElrI#Gk9>`c)9e+Y3`SIbP~>j6R`IMXD*d(Z})Bs*Nq1Fsm4y{_@USbD_>ME zd*2=H&@GRajIzOLK#%pQMDQlboJn)S+FjSG9;M~6o*W)ij^_Jf>P*z{*~Vd?5tr}t z*U5wR`3?e*LR3hx=G@a9m^1=!9iEPmQGetqR)F@z=ya{R@!9z7{nh7rJ(rml_uT14Ti*jq1L`#RS#jcLwUzN8kM|8j8LP#R|h)10ee&5b~scSb~3nW>4RHLlsWK#qvxu1+bzYD8$!9Ey!V^uGD`S^b}f= z&Nfy;P1Jfp2MDU?ej#{e$W8)U=F|3a3}=jY<>`pqxRJoF;kHJNFA}15FL8%o4m!j2y5$N^XGWmA$>qnV z;hLkvN@5pl9hsU{aF!M+PN-_LTLErr2V~Nt)+){$KZ&$kuXDQi9ezwy!SgT~C->tx zjZU?3fA1%oB%}JVE2wSOQ*@wTbh>wzdQ8|p`RT4muz*eE@67zy+I%!X8wFeo7osi8alg&FjRp=-BF%jy~>G$?pz35V{7Cz!4D8pp74#y3$Y$Y3DZ%*E$dpg0EA4_ivxm4v_OBmmGcIE| zUx?3sJms7~8c&S)>Y3)*iHqBmY>RFK4LfH97v1$eO7h7edGUpj-W%~xag{Zy|P#ISb<#xd0EF!3c$d1e~@#Z!4-(L|w-NRa-v-JAB8uv|oJ z?XYK0O1qFz-crSK)VDKt8q-hti_VZ=rG%4>A@+~KfJO+88m!8N-a*KOk<_xgh~UyZ zpLtdFPN|ou(a0zz6PDDaAgyCH)<$`G84?j!FxVBYDLRrH`J=R*#+-n~6p|PewPFHJ zSFw;^EW83)D@z=a(zKprY z)QpZsP6?wh!_H{cl8B#iY6U-d=JzjqW4ShkG&GWIJ9Xo!4-1+X)07e>1|cgKrgnno zI?pkrs=rg%ca~vUIBop&X+b|ZbfOx5ON1+2V_TyGl@VAY>Xb6(fOaZQf^7|EG?beO zt5i_Yzu+^}S^Wx&J zc7SKe9@4?)90bB{@G-g_WsQ8$+AbdcpgAJd?WCz3NY^gZnAgNyPtYWdLnwJelHwuX zzeZLBL$uIFoC#KqDM#Y#`_5B4*#H|wGP zCKFfSw*4lY`ngW&I%6Etr&+jxX( zY~WAGP%iD#Pm7jhp;p7^RwRQ5eS|@?_unbVy-)Wp4fpA&vs3YQ>tI)M)n`5V$}iMC z@;&t1eonAuJp$aW#w2S?Sr|LFpN86!f7eLI8#pBmywhY}$vBjNcoOo#XKHnxLv=2Y zNF!AOc732-W zBan=}Oz%cdn6W2S*4cTKHBV7&VZ4msf<43>|AhN1B*1@_J}!H5o`{VC=kxeUi}h=G zS~1D)9kJ@5JO2c1r^BOhj@CJOziH_PT-i-XkBD3(luEA#g@kTD^`>5U^XXS1oeaF9 z^NY!&TW;oVoOU9?Oa=^uXOZZ_RO($2+SJ&FJlUX5B^#UEx2+anRPwavgp$;4j z*NAa|l`wiWpWr+k5L=lMw6ShSN)XwD-6=lo!DuAS-LXoRO^OIwIifq~?6EP*^+`p2 zfSgO=P~2XBU)v9`qVOJ`w5AOizXX~ES~3FcZSY6J4l&;vVhMK*oH3+r@k6&)Y)cf| zu&(s>Dl`Lm-qpxGE4CRQh4d&C3SX~~NkWV})zl4)kqbfs z_fK0@*H5SU=Bp$>i7atg8*8Z>M7y9vF)S6%@1K6su2NC0Rq_6e7B-x(JF_`ATNJ^D zLd-MvzL@mo3p+r*d#q_)iOrRbj634G-FnR*B^2GzEehOD>$H$?7?y) z3wj?jL_d9g1}QtM{XOp$E6ny;88r(QF&vTKi;weC=F;? zqCgdU+V5FDC5fS4*(7cKvAC^dCwjrKbr>yUg8OAM;Hp23dlRY3pz?!13caIdE%!)f zasJ-BRZ8`Dv(3*m>HRbcui;9fil>A$!(a$Ipv2$}%Y}luscrkx6^EV=mVAGk$NFAp zA-a;eF+)1iT4{Yhog7%lcrFk$+y$96+sgO#*C;Y?XIaN|`Y9TMD@&w(SOdMm_b;cR zs-zFZe7b37tZ7X8l|IFpPRc_Xz(o%)Q^fFUHc##dpVz5|%2wec((s?@(0FK(BK2jI zoD~QLtq7V#P50ZRWVsk-N?c*=ynbDnj9GIqRo~uI3pPLZ$?l`+{B@9qBEY`W_`6e^ zbCQ-GjiHB?iBKqvdpYvu#*#A1s}y-15`rorE%&zapfaZ+f$*Y0%j|l1&Lscu619;q z1+!_Pszqzr`HfFWs1#Jq3z;|(l(=b=g5RVUG%;hBdKLN0z^LuEL8N+!W)hl`e`*$5 zEm~wL7N*FK%F{-bC$}fP%FbJLE5UA-=-z-|kNJd`BzJk_Ln2JP^^Me!%GNw?JbHJx zL-eT@iCYJoRN=PyEioUU6p4Da%{avG;?l^*-G-u{DbB^c+$8wx1`~m83iDF{FHcjC z$p`;F{PzYEA)+9a#3UW|yU?JvquS7Mh0W@k)x>+~i87u40>Qgx+h?juz-rCPoeMQM<6bd`xNWFFr&mU-fisb~tX zDqPkEt|5uQC##|=Zks1x6c1s0VpCq&ho!P^Pi0w1Xpc}Ixf#zlCdnv^T*02aXZN9j zy2b>8TDcgCDYh8`i7O*qk)41%mdp$@pgCn5*Cj^JKfzBWZZTPcd`(JB=ehd}7=Jtf z1`a!NL|6swe2HBLIhA|gYdK=FQtla9if3!nHp2W_W5^z)Pu{uquW1OZnNf8_KD7}& z=)Qy)lih4^Ieq~u<^OuJ>$wQq+pDz}$xf5tzUgn;?xv7KVSE#~>xd23Hsh&Zyjthh zvR#IH%0YAJ7Zll8VJ`wV(mRIV(X|Qg7kAB)uqg-}Zi#%XU-9PeX_EZ>a&t$4F63)l zZkRJ<1j2f;iWw7*pX)l;2C4j4og{FrQehxxdlAb=G|DMgG<`u8;5q2tOkrN#dx10VlC&a#W)|O zp$CfvP4W@;=_1)z!&niI0^Z&#;*#A&jw=MOjreucklam-mj|HL- zaYkid>>s!uO4vR0xiU{-jFemMsI5!Huy`0JC zzq}csQqbuCa9p{VX&Fy4ss^7u->`jidN8SmUy`gF^tl{U2=_R_kMb1U zTm_mTd4@6`HI`Y;7t$`+wx`cXkRiSgE!Lhuut>7>&QpihkuAnGYp!SDHH2AUmBL$< zA&<98u5307) zoB3msNuw`xLkB`mb%*1U#|p)R-`78*O)v+oG?G4!96 zCl=D-5_($>0^J=2eTMB!L5>?OZL=)*Brm>%;@dD(U76$iPsJ6G`8ybAMd zaVc#S&C*Bm5{ZW8Dx;6!fvEs%n#!4jCHne9TiNga6-H|8{uAkz8>pQC_wd_iiG%?t zu7b_e(&91w7z0a@)r)#geEV=iipk_wADKdg zJKnwK8$fq=t7(2~+2S4(5JFa?j^rjB(8J5G)~=eOY>KIf^%4>U@<``7MJZ05&0F18 zR~J)MbW9HAPtcdvWp#Eil(-$Qdy}f97#(-FRirknISJP|zs&B6nZS`rOqfuIwng+c z&8)G(4rFY}dY=fuj#{r~Y|*A;#xHnyZ%t<*h`{;Qcu6$52RC|monKrmv~8F}Zq3wH zFEHF1Uk_d-Ci55pOYk)SQ!FmgI` z%P69dZfpqF)sbkBx~VeIvgOb<;_4I9Y4jnVXOw-Ad)_?HUz!RBtVNFy&%^F>yLA?n z!vvwfla+*P*}F++Wr9 z0;leob-27xueQ&Zcadn48!xa#=nL_Lb>Rz9V-zH?w{VXRC45$#2N%Y4kouP_&2w?M@zY~_f~J-cI;tpc|0+g8Jrin_6`*C3*teJA(bcvD zm20Dn59dcVxu38LH7OIW-j`VrfQcrKLL<*8FtQHnln{h}{_2qgb2N|gVIZy z^tC@h!G6iiQDz9TrL%5Zx9j{@l+#Gjv6? zVgvgq;bO%jR}LuNN_K~$U6&5Tm6P0?HsrMYT`Od@9U5@UY{ig!tknxT!M}fgBdN&M zW7Ux!o}i~|EsB1M<>o{HQb5_#qz!F6rv0I|3->xklk{|7YVvvUFxs6f#P-{&_^Rf9 z_>c+baZVjb+{`$v#TU9((NF9-kyH}WC5ZG6Vz)1!%$$6!Qrg&z^#5Yh_pJ!^DFS>( zI@z}}ca>)#?c8Gf4N>^p<9@Qp`zZStE`&_yC{Ve@3?%yT=8|lRINYsQBDF9s;H8jh zpdMKBtY5U-FvSEMWD)fJaj{6+pK$|TSH`)BLdzD`nSif}6`?c@c(zr8v(n&;SITNh z@HdaLiJiceFBnH&T@n2VU=9 zUE|JbGWS^?Eq9)~JAu&V)a`)rUEPu~?sq;`GV=KiP&M{8QUH^8d1Cte<6ONnzpm~M zQUL$zSwaG8VF`+JNB|tAHih;OC^9Kg0PEmQADwb2?zS^2xi8xVc0^g6n%$EFltT0g zMtx*T+M8xM0*ifB#1iwl!jP}ciP@2DE;SI17vKR(Wwslm`w9_9$x9+cV(TZ)0fdUK zbEYJ2Mj~2+Dq8J+lT0MFJC6xhMdf>mp*0vv z=er8yqX`dOvL}VZWZ^13d?t?q=^LyQN+?idC%4>>?B(zLWsdhQ=^XT3hP^YQ!^W_` z9b?zuwO%M*&M6+>aMIqObBu7WHw_1kdv%@vxMyunvH!|>Wv^+thpJ+3-uv6sCEa#0 z@>0W|9sRhGm}v?=NJPDSHtwtFfT)lzOEk$JVOj8s?{J6Yy2QY4~s?^vzKCng{oqxB(S&N7l0#v?2`M*l>EE@1&K2U&7ADr_Zi41>jEAtr?+9 zsg-)+Qp+0A^&w>gpUAq9l7R+gitl_>6*ZkL*|e#kSO`Iu4JPau&m}JYCKU%NcfDCI zHgQUv3YS8$T_;;sK+YWl9ONiERszUssW30J7m!G?hqjQIlKS~pdS*15hj&^ls_OzJ zToYzc-@^ozRLYvt;9relM17Cr6duJ%C?zfqX}+Q;t~(G@E1hR~$45~E(OJ>{2}P^e zvZ~R<%((ZHG+zXBV&t3D?#z@S{Coxqu@tNz=UgU6eQWCv8@!dMBcFf)Z+rega<(9pB=Oj zJ*xF2o8>^jn*)W+UMbu;UPc1eoAWBnFA+BK zw8V3neV9^lo%7+~#%a3B#W5Q4mS|?$r7>SqJd2!2zV7Bu-zX8l`yjHQ7RQ=Ys)&8~ zXrE;|Q`0ynS7ok2?qyA0oy9!w(vlVRqS#i{{CL6t;V<#-%qdoHM;?qP_>mt`st2(T zeRF^SXck!+3cO;QJrM#abT&3vCV~>cc-Wm*~pO2#R!9~4{ zi{N>t5o`;t#4F>GdhDyZuLri6$AhXf98g&#Lp@ zBBJR#zrO-^{Lzj_}qEpY}tIa`~GR#j9Cm+KHdBs+96C-6pW1yQxZJOiPq1?QQv_yqa%8GhMZu zlUX!TVsmh(o0+zBPBVRvW;p13u+q^JD6&$rGm6d;9h)FNk#5JauokuHfMTwzYEh%K|!|J-V;P@WHSXqcP$SYPjk- zQ`@2;$JWn)m8in!49*F%B1Q+aw!ip0QgU zaesRL0;~xTWknZJA-@L#%hQ}I9a`0jZ0xdRx)64cW;VF;# zG-S`I^BO|Q`BJ@V>AmN4>lxxY-(s|{1HJQr7vI4W@`n+WXDzumm^=^)u_iM6+%7w* znA^_y3okI<=5PjUCv((@YQJ4r46Kcp3}xKdKiRnhG2e*B{Z9ebhiKM)jEjYh{$bnf zeH)mZ<1qjU3|zAQ2(SVxH!v{&jHy2RrC!5tfl|g_0<-_FHQI8QD3R89D!2FM*Zu zG1B}mfBeZnfK^7U%&bgw?48X_elrcgf8VM8|20N_ z1A~Q~mgQ#_8%BE8zY5d@4d2fKgszr4FZ;SFg_zM#w2ZwvZuro6;b{mdDqoMF=or}iR=tT8@JQ$W1u(yqnPUJZ zQTxlGFf!9J{mE`t-_gv%@ZMCM&4Akto&RPj|BR`m1(f1o98IN4E;RgNf}2We0MyM@{o*qM)y5Z)Tw5VD0!@0X$Zwe@{_? z#VQ}=8a^WvGcDs|0X%m4M^*D@Lh)mw)v?htFxN9Nvez-N(6hJyn~q`n_jHw!^)K~? z&v0Ko@u#^kvN1mDn?Dm5V@E3k2QzD{-yJB^zo)2-EPpAt`;Vm3(mz@VE0C!D$qv-S z!df5bK%Id4Ru4!%{szduXQ+(Kth9i8hXGve_{}tcH6z)7c#=QUGz@@N;h<;b@HZs> zJv{{$+r4Ud1wM1REt@Rwl2X8@)-2Cj5I3>hE+d(PGp)nk%+ki< zKMfV;f6qx7fXU4tOS3aD0)@#V81z6+cJD;!|InpE8*4Kwhrh25GXHxL%D@JE@ju-r z0{}qF{&UUr-hZ(D2s8YlR^edhXz<@En6onfdlm{5r?kuuL8g1s1zcADIlJD^ER2kQ zuuc3YUBdkD$>;r=&R@|cW}tKU@!IhjfN_^UI@)ArWol$+2Be<`zsq>$e@{OdSpL#t zKR&t{t}L4U;=8gzgz|2uLv9iFz)h4N1g7Y)E3sjSd*d7e^&I& z|B#CQ3JQSbuOc7}z;%wtCDD7Z{^+2Sp^>qkqlE)-#Fzl}+uwyO^FQRHzaql;mqr7w zaR6g3KZPs%C3<5^V#+8JM?nwd9zV3qAC3cX`+}Z{rQYA{;@`7U=0~k|Zx{C!*?!KkEWq&e zPkZ?@$H~v2+kZC>#{WJ@{x5aeSnm1j-!kX0-qV&})48(V&)&d}|3&7UhhrZ%Vf{bJ zoWsBb+_&*?^Ki`~|CKN2mqf3u0A}D@4!rsK7#4hBvYh)i56?3?HCg>vMg|V}z-=GE ze}O-LWnOv!;{MfX;sbXHKR|cixM#cyz{bOd&4$Paj@>a87;A*U4Gi|< zz3&d2CYr9dF8i+N?rIvJH!XPAMqD|fcSsxwup(Omp;Vti+&YiQ-#GOsrt=rAsoo&-C+sBE| z`zQKEo44nhcaTOgm}f0_h3@B9t4&^Yw{wmyvokxlcL4OarX?&V%QMHyZg=0kQ3XXx zd?fX!VinddDdrrmk7VO{>&J7fW-7yh2@jyDZ5da z#^$9^_4AT6kB01=ZT#9LZqCSoZTe52Jh8HKisQylf~;`n$_QN)S;g~^Yo?)&_i%)A z+A_mzDOI7oy8<-=e}J&f%mhywVqhGbt`8ztBw0yJj1KES4P&Z zE1M^v=^jya3gYQ=`g${1+naLlq*V;!6g*A-8kz@kd*Tq+!x|uQfUCr%o-X9!xxY6V ztlZqx*4xxZRTH&rAEt?Yd8X^0t#h!XUxNa zb)VKV>p1!HRtHmeXT6q9YyoezVt2jFB&6Y$RkQ2R>(dYqo#YQi@{Kx&H)s$)5_;h5 z-h2aWH9Gk(U<}u?So~>#I*=DZqI;!a5tcyZM%Rnen(?a5e0h3Y?h; zpeRymoRm~9#DJ-2xzxiay+nGs8u3+udnqhWrT@L!kbcZ;Oit%#F4m#)HHwxxruEJI zK}NPE*(dZ4b#G)$8T^MC%LJB)IQ;iogrwKrs4(JSjoJ_+S$;x)zS+5J|JkopoXGd( zcgL`dm=Rh323uoOwno$J%*G{d0a1Q4Sr-eBn4=eAJoy-^T(ECsYBiETUlDjNbGMol z8soymv28MOq``cJ%un&`#=S@fQ#x^^-=O#`o&n1LX;{^P-yk(?&A8Z{^BJYyH+US> zo*uFVe-WDswRmqf9x*lueKfLf5U1@)T@Vn1La0Z9yy^=Ql0t^WZImo61+M+^(Ho?$Yj)3g%;hPEF zw1r&{hS#)zHA~J*EeFk`dj5W~h3@N>B6333x){2TYYil9mwo&6vQL;T2paE@{HF-Y z0b1xLcHMuX_sOP^c26X<%aev)bgpj!`Yei|hKNKXzKYZm8Qo3F_(Bmc zS^|WbHAn~r%FF}nNc7Et2$87g8(#>~O1+Rm!XZ->lfoAyJc)T=&+`pM->_qqd-Mr@ z6l~heya84gRbY|S{Uu1MIJ$q4lyrgzM)Mskh+_XzXQokm&sw_Jjbbjq(1j3}gr&lq z1q<@srReh}90Nl8dM_LtRn}=-R4w}Vjg{B$D2Z+y<*v(omqdvX4e4_i^@T!aw%It9 zO_w6JpSSf`x6qaxu%&qMnZL258qcN4qWK^N5XtM{h?RpLeMCpJZHCeAt4yK%yuX?(LgUX3Z+i43u1OMHMb` z==e$w0sIg6gE>Q0StxYscKG;>BdhI?60g);?2l4y*`qeXH)6t1*(ws_NlXx1;lK8z zd_E(J<68*&L5Rdi^Ox6PW*_YGbuU`^335EP9S5WHo)T)S*ql}JD3O=JamGIN$R2!i z!prNptE{4{3Ae)o(ea8>v=g%e5sNDthwSjv${x2p-6s&ce0=!2oLg;b3CaR0S`U*O zU01Jyo7VGZaIlNXPEx@i5m2$cq}5w;rq0>m*Cb0!cOXix8iY>bp3y^2(DHanXrKv9 z%Gb?gjDMk?lLQB7S0eF(ph#QwRlthIuX7g{Z21)6q`aA)bHJn#tCATBh$%Z*Cn!Le z_0xl4dKyzR9p^aL&SdkBv9~x)_)J!f!usr4$5jmXR8zkWF^dG{q&31c1erR_CdG?l zI5g7(L|@f8*s_k13M=~;4&#o3pUVq04!4Bl6$?uiPhmWo+4McwqMV8D_U&pr50}5{ z7uIqbrhG)RNC)NJ739eN7-h4Uryk%_?Ebw^`Ou$gH>1184^+8DB79?_W*LqW1_K)I zqo_}*j7s#2bxulYa~h>d+_mm?kWQMkide50fsbA7ny0Y&b~R3%s7RLbNn~y0o|*c! zqRR1e^eOez14HBswFs|Y;$B3G4fKqR*(bU05{-!1OkhfU zCEvQxuWxp)+dMYUAV_vv-j$gTt3>hftqg$+bddz+U)_)&^sFE^D1?%Q5=b<93E&>k zE;$S>8JfO)9U)^q6Tp>b=4|H7JTQGh#hKEizrJ=0q6qbrJs?e4%&dLAhq|-(0M=wz z5&TJnBMmG)N7Mw+x1 zW7Dc=%ofPKlL!ux)_Sd)_X^W^X~S$ELSV3w$;{H{AQOwZ%Hb6kwMNFK-BL8H z*c$8#BJ}W2Lb&c8Oc1+4&olSvun4?In061wKxQmEu#+ZznB6xyTYcCD<}95(O}xW)KV zNg}(8=QJF{!)$Fm)le{qzG6aUoQ%k}VsV>_3r5o1Iiv402`gsyd>4l* zruk23R~0 zFty&00kreqGC33-)K%KQ*{y}L=Et4mseP--bU+%L zVhd5gC&`~HkA_qIN*-#XZwlQ7sttyb6iMU`}oy4@o#2z_$_JZL{-z$(2 znn=4cTDE+2@^(&TWS-(}KL7VAwoeP1ISTUiMhG!(Ib5pgS!YJObWTV0P8B;r01YxX z1zmascX_Rn6{*L=hR*ExC(r3pz|T?&4CBWnAj*6Ek;V9Z)&Y1XG~(N8u?Cg}Tr4q6 zkTo!0)reQ$RQkWYdZQR1p5#9;5L-!Xy^z}zm>=&Op)=r%jv$bkkMlOidYTme1LrIs z*m@5C;XdIUE+TSPZy*s)P4m`hb3za;YzLk~ithj%%r{nS0xT+9k-b@TXdQpoi}f-O zLv5ac(m6^s`>pl;t>dZrPy$uydY$(Qqx>`(s?t`@74~%Sk<}p;tP(VUx8d|g*D9T| z+;C^N`|8d*^=}tgR6uZEtn472uH2%XX+n1$I9=Qv?&j*sm@<(uMSL)8aTYu(jiJ0GQzDc*i{U%aJ|Y5udoVUA951ik7>0z?im zA-@-Tm`$+<(f8e&^rQlk!hV86LN4ARSH*tIY>7})F~{LEZK!KbVYi>t&rp=yEZvmo zc)#0(;bCB3@T=nuAG8sUDH81M9VKQwechl)jp~74ja%@-@3|1W!2E3dI$zz9Cb7la zbJKZR(NMhlU*re2VTi%`?K6%k~U`ClpV#OTQE@xKtleC-Xc zYj>~7AJ4B!%Cve5j+qzk|JtG=7B;eYg`y%B=}WY)kfFPGh~EGL-hfoqyPR&7cTmrR zdQNZSV3VQ<-YfQ~08{Rgpah&;k-?QD$SX_J^S0%R4|Ju3PN3oDP9Ao~cKTdxRmJo5 z#FN;4#H~T&!Pks41vL~eHRD%bI;Lt~fkWzfclG1ijn%&tddkJIjUlAlMvBGFF1*tN zFbdfhP>(RqV)X`Bee+Wmw4*6JwdO!mQTz&W%Dl_Re<|^XtPZ~?Yu?pefW;->VI)hv z8{!0H>PrU({>xBladb(78BHw7_{XQ%(07oi!+;pUK)vsKz(yvP*2%&4<5W#nSn=Bx zjovgLm}i7ep`-XPN;z1HnDCaV*l)VO+ftF@!aqsmD$zOv!*zc0;;6=VI`U!{p?SIO z$JL7fdoh8%!BAnZxp*2#+KdeY*Mx9Y4LN4nan!`j5NO~wjZxrAYsS+TFP8!gpRwL$ z`OlF!xxTi@(FLW4kaUT|Q4)M*6lG%O@&oXG6zXs4c5-MLL0pn;Kd;s38O!RpXKTVz z)T(#LT(sxpDBWrEw=V)?%7{GEpGvlP@RNKYz;LLMWLO|$BR>hP7-G*8>H*qC0rq8L zY*RQfLZ*adGy6Z^K6bTGnW`@Nm)Lk``85$+-x7DzmFhj_(V|B~6!GW}o!p=8B7i)b zU$y!;8dlo27sL+%f;YMX4KWtvV$}>0*)jNj;zb=2(A~4S0Gu(y3 zaflKGkBTkF&)-ansOZ6P2tOOsO%mHvW>MzYzwU{kaQXTvta--;tYlAHP1m`55!m@R zHm){4#%<^cBVs=2q-~uou&T9ZloFy#SiF5~s>A$_30=+sueDk@rS6C9=(-IS@6mm~ zx}R^0R?98TZZ%T)@>ebXu@jRp$||j_x(;?tuWqLdH9lqjuV`M?5HQQCA1~Yri4Q)s zcTayuI@Aw}PxQ$rPqLe$J_4!DL0xSg5OM7t5Mg(ybVM-KII)f@!(7Trl%ncYv|{Pa zNGkT_8!hmbd^^yMFpvm*cvdv%g0BqkNsR3Uyxo%z>%^8T^w#zb+YB!ZVr0V^Bs`kK zfw%Yrp5G_fV6#OOI-kx{a?vP6F7Jbnbpg0+3Aml!LdznqZ#ogYAq($~Aq$sS58A>X zaUvj-ot=d}80nw!7js?8d!1SXhh&Maf7m{7|J3<2{y5yW=MbrwyAe5`^xm8F*2&Ar zP`~ozW7(hp6O$#en?e~w`QjIDH}$q!Z1Vm*A99guE#M09u~1hlo?G{nVPa;o#~vTY z^u2Zafc7=~#6}IqS~h6EMBJ_;0Sp4VkN+j^AqwgDDq6shQf{{_mZJ$sYW8R(bejpI%`(t4QWXE#(}6? z_I)YE0NGFt{Q&&?W<&J__!r%~AGR3u6jMA~$I)??;62;TU+6M*cdz7Q^~DIEb+(gA z8w!nUInSt^@yc!JI@m?PN{XADb+d?a8LW5!Z?lM%O^93(vEF;qg=k(IYKqbWiW{BEy!B=tS{z`l&aBRD(tHI}YuH1$yF2z*c#+a}IPJ`AvK`DEVQ|Bs5zAONKi%{@gZvs1XTzuIdbV0wKMggXxNEg;yS?YB zGlx);o$z{=^v#X}nG&{3B_uZWdK%6&nqw3;`F2RdN`H_y z$W{u#U){wIzCspyIn6x}gTX@YZ=DYYhh|(?yX>m8P!ReV>qSm4=Ew?1&wI|z>JNZ% z*j&Ox)ObEMnAa;I=$z`~Z6)S{eQpuH)j0I>qmtYbc2edjsbe3{Pu#I#W?Lc9XN>l! zb+ena{p4&ms@bQ(U0;jk;Qt@$zB(?du4`Km6cCVB1nCA51{j8tmXHRO?vU=1Mx-Q_ zPAMrR1*Ahl8Uz7@?hd8H@65n>!~NXP_ucyb@$vF=sr^PNQKMa z`yv@zA~SOJ%@;HO=OL807+@o_lf<^u9fq#V+duYzV%xF>>0 zL~icVJel0#+{uLbYL9$q>e6Qw#!w+sX|(0p%%2?e00oax#JAclGnFE5>3TgHR{`*4 z+c9z+-f40i#K-=?kgM0-!0Lp~^Bwg-qs>o2cHS+lP53B&(j-WdiU?NG_CDCJxaL&Z zbU1cJ$l#D5Cyuw|5Jd4bhGJ1<$J4APqHdI0zipJ7>W8C!nE&nRsns~xFurZ@w?=66 zu&Z!$deuasF^@(krwO~tK~pQma69S;!e{lDUM~0MB3$l0nj2Xl!@f4xTFt>J?8?q| z?eC4yDaFRC^s=>Jr*#bhA(px9bpqV#*!(Nxz)U!IOWX(x9N9(2BxN*5hTZ#>K2ZnO zWm3zs?Jnu)a0_1!@E?(xN4JH>84SH&Hzj?|{YmTz9}d6ko%r&Zc0+fT?X%q#QnqiG z%^WQyHZE`tJ~y0Fw=5q~;McFddVdG)P3jb+BMLMP;-eg${9DKO;? zUVB0D?peQ^%s0`6mt)Kyd5{LKEo!&zya`J7t`r}hZPZA|WS}7K)kr^7`({Z^+)}>T zluqo1N8NOjA**J(Wa~ajYmQPvoJ~9OEGlE*`xTqrfo+u+v}NM42`laTQ9GW8?8%t& zAKdec1UcfR-)UMD%X61_nlfW$dydNHM2yNZ%xy1{^&o$&6>WfyP#Z7t$c=rjN=6~v z{X_T&okt8e$+=t*D&ZW(pfo9Tn{Gxe%`DFdb$kN3+ejtrs#_6z>(*CsKCSOiZ$EeXmLXHVuzi`-l~nw4hEW!@a700S?=2!NrR<_LoEjnByq2)!9Y0nN=@)aSNY# zZ55*epwUqq=Y^w3azeLL-=&G6s#&;=Ccug&v1KwwtaSy zQ%oboX~lfAcBIB|d5o%gmr%~6{$X^D6YctngZAKZMA=sb`^8))M+xrtyqkEb{n8no zl#CYsWiRIAWh%AoCM0U{ZQS(;%mjpAMO9_HyNwehH|X`OD*xa)yqozs7<+^-F1bor zZLxLG&sAXbrot>P<$;fz(O6+WZeXz9m~YW4I^zS-R*Iz~<`)6`;ZZ3CxpkhW`QDgx zH8ylN(Lasj;PI<3KTqw&L92hbPx%E+^8OV!q4hC6t-1PVm$xPnGB0EkEq}aS6gxf` zNxRMLW>HS7!LM~hs+e_m{hyeKU|B3^ZVP}nozmyzgri~rCL+i`FcF=`Ap=AmeO0Vo-G_8*NE0E(Ox$(>;^;)JH*;3>9$!J%;qg~JK3sen&#S|FhQACQd!e#po; z0mQ|*M!cTRrvD?vfb%yY7pGu+P>CD3omm0A0ptX{#>ojj-@sR(+{nrKAFFvee-m(V zx{CmGDr_g!10bM^1YTZqN(ktj0xk^9Ep42&05Tq+$QcTGJ&Ou}roR7h&;WEQoW~%> zGY}MjHsO3DUQg8#Xqg+^*jU;Cq!DMW0?o_+p;Z9#894YA!~xWE!bc5oe6GQ-XGV>d z(OD=T7WzY6i}%0-e^`;e!PP!1|8+ z%=vVx&>~JPM;je0XkF_+)n`HA!O!pW?*Mw|@ESz`3kD1xxKRMQnR89B0uID)Rkjv;29$3I^zBPHGm(K&$|b=81y^ z13a21wSDK)ET>Ds|Jf+N8L*!2D*&+y2fVxh@GNjH2{1rJa}0_-r&#H~mxTYbVSY1q zJ>_P>0M827ugcfIm}tNdR`{~#eD)StEwtf()FuJT$=?ajP8Sw{0V*0e^9l&4K7n(5 zfdLHlxn^F`H?{$Ay_SFDjfDJWpnAGf01PW9^@~8k8sKG53f8~?2Myct@%ii&1{MGp z50vKZpH0H`o1yAylK_PUzxY>9G0%d5dcG4v$@6KFUzYes&%yPZVe4s&0Cn;w)r-Iy z4=C${cM^b+=7d%9yjuiX1`DNJJ+r{$`tz6-46v=7EacAcY=GH-`1L%;tbcV911B9Q z<;Gcy{CU6%26$;ssu|CA5)j~DkAv6q-bs!ZIDg*;;QGzD_4L32SXWLe8v%M67G{o< zdRQ<(Pjjx>SpMoIz|zLh(gxT!`WxK>*KdZcr>z2PoI&9Au%`&Fz^p*zcAo2D4V?50 ztYDmYT81{3=KpQ#`MucnbX>v#5Z0V5?#NhytwvZF3$Vk10qdRcOrFm%q+@0V#PoJR zY+~>?7yEnh>KS7Ij4Z#HTA?J$qX_OLODLFm|}JUiSAQ z*V9b!9MD}OI6Vol1rM))z8xYdUUK9 zaAq?e!t&?gD+j>Q0#9LqfSm$(B{eV`!`D9N)2o^r*gdk;*V54gXgSW*3`1CcFLFKO zR)Nh#cnXUZh|S={Pf#nJYtj}wV=G%NV2XKUVQg)GmYoB_^5=0Y2SCjNPhhdJ{-r0u z0iVCnq>F&Kp9_kz?jGcI()>?9Ur1!fia z1}g`2v-LdFxY%3hTH0GcnXvxZB)=D`o;As@^&GJF1?Xx|h$cCJB+j|cVCh0tn*fvq zz-V(e0QvI>l^q~yfhz-m0KyJHfd=>i0uX@9=3FPPfbAhGEnp#IsrR3J&JdR0i%?Hb zxa>i~eSxKaW${0os<6H5?fT*k6RB0|54m^PRbZ+XvwP z2HZSpb|9H^uJr><9L&M&XWT36pNFgLfJo8F zIu5YHUu1IZKqBXapz?e!W*i^s*l8I95&W@NIctwU4^vMoS%Lr?{PM0)%EA8)-W3Q& z>@2lRpo)@E)BMew{CT{}4v3BXN@D?@7nYO&HUfZf?R=-PPCAH|j-8#2v9A5!h!`QP ze;&EAgMKaPfU)ye$qpoQ z&UG5=q?6cc0m%tyIBx+2^=HM;Agup`7?$PNn(nNV1@bxPI+vwqsec@t{O82`djag} ziI)w?(VU;G8Ue&gU!) zcdjSN-?Os~=+9$UHejn6p1C?b4YL7BoO7MII^HchmL>To+yvy8!uG#}EuKnrvH@EG zCo4QM5P-6R!;FA!MfgJKeD;#R_To?a%h_@B=g})0z_brfU!4X(vjJ)Z=Q@35p<@B$ zYEII>{}{u9{yc_d1Juw?powH4=(g+0jLZh)a?W=S%hCeC)xcDZVF9cy5U~M}tp5}u zfcyim=f9RV1_Z(2LIfZHaRd)!*#LopbDq(%0^$;=L14xKDoKF+_}P*4=dmmsz`YL_ zB!H?Q!J#E=Kzip~3lbd58^b4LK)C{tcd__qCVmL$&m&tlK=0>d{YM4@ybj07mMqk6 z=Q_=$qYvvcfOM^eo{sHVjXemAvGq4fl1@)X03SbG4;w0-1_z6?0S@O}=ebS{VqguZ z*xG6x=S0trqW?i?3ncvDy4Yuo0wjA*)iOdJAh0S+#c}XXF3VnpU1W!fSw;-wZ#S`x!{6~Y=Dr#|Ep??Qb(7P z)qoPhN@>7J31QKr)M2A!Wus(gq2vNl>VSY|uni>(t0kqbzAmLcC#5dO*{A;V?NSg> zwG6MS0-pF6vKs{CXU=s_%KY!8s#?c0=h?Li+n)!aAfRi*GgPND{vbea;9O^@^Z`{8 zpoG^35TG!FV&BhpmEVg$Pp@X7X}Vt-Dxg9YP#}e+>_EV_;knLG{RLAs)UiHmjo;fi zJ!1`^4B}X203g+eZup!;4j>>sbFR}=miqco=~ex|4U|8RF`<>q@PrgpBMnZ700MXb z&UGmjG~U*?)YH-fkeGj$cY?r3>i=wl1hM~GkO3LGzf!p%ASrVKx;vlY0vvV;>>>ZE zraC)b{(Q3(1QajBi>aWBn{W{dsE+ZuE~YwOi2!l7mWhS&KO<9ta;QHBP=SE*Wq4^7 z2nZG6Ks#v1IoFw~{{s1kz$6_0aNqz{%fFIQzzPhWr2_#One$y!WuR+sWc2sB7N%kG z?=5j=b^%J3f7Mc*o?U?Y-E*CT`llUZPR{>~Pyg?7Ef99-6=&sIAnef4<&<0t#{=dkz{3Xirmrx6!#qw|DSdKp^^y#5;EHLUKsBj33t_OAi-T#0cK;1L! z0P2sR2QV%U*a38513Q3O7J3RA8pB#(c7?V;qaj!eG#G##!0!yJqJ_1=gW&;aWS#3w7uz*wPes0DorK z;s(|Nf97MMALt*$?+n-4fv~~v4AP}SD=9$EAada1sV;B zd@4?xnp&;(u8VU4`-s;sRj5&3ymK9ks_ydp%fgfE+G8ZjNl$*(yoiid_tvLr)u$=W z$+*<7A^+N6{rZ(!luNZgGn0Q#9@ZWm9UVp||C~J>oL;@nUz>83s^?&|a`$_pEZM@7 z=ex-Y>sM1dJyvVo-S(Fc%gT~R+~baZekCFZC1v)I*2<$W^!50;X=ypy-7sp{)~$79 zus8U#`o*?K(w)Q2!_gzRy+zq8{A^>3@gExwCTnLsw7mo3?(F;oX&p^3YyDh1Dx1gY zf0DoZ(=oz06^Y00X6@(Xi5AkInOr(^iSp!Ok6U7-23s>*)@y(6ZW-A=^kWX&xh6jH z*~K+{z1tS?lU=wvDxWpg;`Arm`s-;(X_MOl-`t*0-?=97Q3{RmVO;dj?=da3_!$}` zr22LvlkrrAj#|t_+dCoMHU0M>)1T*^^Ty|U=kL#i%|`W>#dlZD^KV~>mK{zW_rq!T z`0R15n_l{ZeiioOrnc3RD$VMq748e$vA$%9j#*Fq5asc@d)O@tWx=HGz{lAqEm{9i zd*HmcFg`F_>%O~pm*(c>boT_N z1j9(h6kymF1~UiRkUK+x)rh zN(nE5Nbz>8L9O+BhHYNXngEjLzPEpbUPVlv;C=eUv35P`x~uAEv04`%j{}2`AkJPz zZsC4mBb0rX=ANXm7#mG7T1-e5?mL)-1>)!~2Xs}}*#iB{oakn5*ClA`2(w%(#?Wz! zD2ElpEiPf2BW396@!>)aFJ-NSVMPllF2C! z--3#NdW%-+MXS%qy9N=?VXNIpvIoYU$f`4B_+M!4VxIIZSRD{Y*tmg`iyTnzG{!w* zv|M%q+vs3KF;t|#CRb-Jbwv{|k@0FmVD`aO)ZQqZ%=DaDbV=lpa-$1w*x8GBR25}4 zeJU6vW!K0Qs6k{Gbg+&tT%~SWjyTWp(%>25Eguew75=i|msS>*Lr)%sM<(0d%6(Hc z_B!!vL2z$l_|w}LdH3fDQPH%TSxsqrF?tXKx<#*;Ozir~849<5*TnWlycPY!=TcUq zSCx;AWqAN|A9kMQ;>88qmExf$@hWfT1hQnSq-U(&LQin3pAiIqmJ5s8ls#I0>$7CF zg)L7^@WASDi|hsSvy}tkHnb4p@#ZDd!g%K^Sg6bz(H9So_Gpm3&^%az$d@kZplcx9 zi_nU=&p$Ha{N%NL0Of0fvWTBFMa=lZ0Oxq2U?|EhTYgJR)ukQm+m%M)ZHKotQdE7j zWg*r9oTz9V8H;=ScWrqp-Y%K8+YYbwW4y4i&Ov_GWd)AO3P^v|qA4QEF-Mhjg|L zBgbMJ2Ju614QB`*^UpW0zP~!on^d$8~8~M>!q*vtA07FEK*!*h4(FV zctwIW*E4+)Gy8j#)Dc z&2(`J!-h>^-PZia{S*;)R7TwrOSimy)>75*{eW=UIhMgqj4+p{56Ir!BiTr>8e7;% z8Qn}*mBmvXL{rjBwo;eHt3hB-_kUwhNn;WE{ob@d!>YxU!-Amy{i`dulGhLdy-VJu zW&a`E>6W;=i>nPBu%8 zFcvLfO)wf>d!xMXb8*I%nfAWxC!fvlRcMh;v0UGgCJ!`H4ct>AHx}c2+L;;|rRkE} z_l!04@{(t%=?*vo^MB%7LyycZF&{xAZEDTZL@Svt5qjLSWL`u_89&F7>ktWGpJ#>n z6~io=d3-eCVoKTRjwF)@HB*6)?~_+E`?pSo@Cjw386!EknnZkA&&K|?ZcHcl^rVYE zc*-uhywi`evcry-CG`Ec7lkvVuLnNIj#5mCs~9|}D6fh+5bqTmorns2Jinok3mMlM zucs_`F`#c+$Sy>#V%bJ*T9CLfmLY+*_7MqD(-$Y3w$L+L4;TS5d_db{JC6&xx^<=} zU%e7v0CLrh1tQJ`Jw}Ef3{eyLSU6D^Xm(A5&~nw#J}r*Qlt(F6$~*d^J`^g9Vw3xt zs*+PG%BK8Pmo7YtP3`N%5Sdm`pG{Pbc`y1v>2=BU>5hR?2y|pAwZ}FgX>o*9%f>$H z=CHaFQs%WLTA)!jq{fDvz>|B?`|SmRFamlq@hd1ugp%o74TypvfTM<#%mQt;$8F!B zZNOJ^-=$tleYp}Z+U_&orwo2EMUwn)cm#M@2?dIeO0XKDq~(`!18?~tU5JjN_q@l5 zVnryaPac8%ju`0j)&xSYE->FBuQQ+ve;P(GW&^l=!>p%r4$)iYXgR4UWulC_?^z6I zWqL_E19dB^i8ac(8LmXlds=B0b)cZp4&Qq{i^ky2?lcvFyYu1deYrqPp}5=sWvR?|G#RE1w5|>EljPxF8>(Gr z3fE(@KuSxOk*|kdhP_q5ZnNH=l-?w(yad$~fl1cT)H~5@cPIR)tyJOQpuk>!L~}H{-#^DOeUk zE?9no_`s+g=G0>B?ZL2C(eN0QQjL>gqMj)Iuu!W_g5SW%>4-C#baXDXRopK->438k ztTd(eJp(Dz4D$?q?xZNob0G${;R-B@WXL^nLVC-bCimge zu5LnV5mFDgJU-rgikJ3;$6i@Uo@?}eg^qNPNmx{rTn!@b{6g?|4fGq_Uz!Kd+w{Jh zOOwy)-uLAjGbmTI0KF5{jNL$Oq7kOk28kd#NA``%MH~23!SCOSg*s)Qibi)= z*?J4e?fI6wPQ5F_c*hZHJTp5K`x%p^tYcmSQKnRQ9y6%H?(*Gi;KeemLkGMb3GJ#6 z$m&#FOjD}3NEx%jf)}&m6a?!G&98V^zF2C$ljkQ9#eO2QI~V^xsHC#0D-g?Rofgl$ zD~7*0FYV$MYDONr5wa3$(|9*OW*)zu{xOpXB|* zd(tDoC|^_c=m(}3i6I0%%Vj026}`8$n3TsiHWaJJQ5$K&!x$CBgP2Y~c<9Ph8eU=H z1AZ2K&l?>zDjRsQ2m}7G^Ep@;<`0WiK#}D2IELcr)I};E4aJFxNCF8>iX(=#1&SZz z+}t9@Ph7qIW?OiSvSl-Bc3l_LKNxA@yNUtZS=GIhxV8B2lO99}N(#K80P4aj(=24^dHV_u;Us z1!|aKqoGe2HeZlEe3j=al;y0?4R8c1k{ySIPSDsQU8?1;KEF2$mT zSUu;OVERL9FG*jeS9#?*-|}RXv)f~|g$BYaG;@QTr8^MU9i}(s`kq50>WfARbZ%r3 z-bF~lUKv+?X(GA}4&Umgw;QG6W?Y>?M<;udmGxu%#EGiy3DA+U-*UW)G%WN+^-I(J z2(N)iGAxr`WO_FtYu=U%>5|H53e?0xIleeew%>$upp(fvr;rS?`we92CUo+=EllYP zLu+y!Jx(Fl?D#Ci{mrG)=BWItzVn1_c)U@va7Jk~&%GAl))4SC{skFJq)ed-elUrz z;9*l_=y-eVgm}H8rRg9Qn&%KsxR6Xob{>6s5j6u_8Ly zYAwEgy1sED0a^`IBm6dyA<5i|Xzg)X1byncIQgg^mR&r~H< zPl^}<7Q8G~_?NGWm+=u1um0@?QEOFrRH#rwR}{JQxh)}1dIDcw=HB2E8rD%jDuZga z1Ri~^L_aN_DGmaDazr}A9eOYPWMF{d6yhht=5XnT>_FK-ou|z^wxxvOVX$rk|vI5Eyk>r$E7V_3j=ule_8!E6^ z-3|^jL9DGJoKxk*Pab?wxL!CI&fI5KD8P<}(!|h#fW`OOHv-KTMTAH)z2O^TFYL+j zXXwe|Y)-X7qYoV~v23d&A-7T$ zjwL3NN`J*Ispc@N84669y|`kF_U$Z-n5iiD%0Y196H7n&=Z|?Rn^lF^RB7u?Z+Z=K zBWRjl)?CD@8UX%Dtf`8PmB@GwegRG(jBZgGOh9#;#aA(Zn?`Q zBe5DAy6|W;raK)uBbqvp_hv*A($l^T(SfyS(%>%{L8S?;ZWJw(GT?xevx3hsMyhDGZVR+GsQsz{gB!qoIJ!84E&@(ju?!U?3eBTECkn)W-Va|_MaQvHl+k3?BY+e2y)$;6D*#I8Va$h2PnE)NpHFW-wJ^({Oe}dFM_i1tTAk7_S31`4tvZvv9m=yk(vl|s{I)}h!2YZD_hS}UW#6cNLOp+tJ)r0HhJ(UBZJmqLGsGiKN>=gw;>EVholi9cxC&iV zW^S}c0wcuFGrKxGVEN-x=0Qx;9okCvnD65DCZGs>Bg$z~1y&k@t{1IpK5W@TYI1T| z^~O15-ipdtfYHldmXb9PWm1?Aj2U zd6$w!I<8IPyT%@4#p=?;i+pp@dLGWqp1FRip^{W$s#z{s>RB$oR%hXW*K}pA&M*&! zKb<|rJIlglNf(Yk4dz;f&OvgFZOiU&U2Tr)dM9K(%^MwYMO${cQ#URW#@oDfY2*Bo zcO|}t7U;s)<#ADIR*uHKcf~okx}D=yLT1Gt;zftpXZP0T3lj}{P$dK_eyedJmXB_q z!I>&5mzpjr_bE36I&#R{ax>Tiw1j7?gQHoZ&FR8h!oktYum=dGG-uvtCdotu<$Sn? zTSWA-Btr9n(y$$0NY%>&ds5mv-mDMRRm$?_)xT7|)4nqKzDE^m}@cMO_@4g@7^*Rl0qe72Jm{{pO+%=jQ?bFgFx%0lF37|m@gc7kJjNa z%&nTbEtHtNNUHVJ5;4q;u9Z|HakuDwCa^1FrG-x$E#4v+Apjz%0KBv*y5uN^X~5XC zuvM-3bIC?jL|kiMoOy6z00cIrFMu`Jn24$mh>FzlJ=N-4J1|<`1`4O?1*J^;R_Yrt z=%EUlKe(imY-Q+1dd;bmoOHI*3n}<|~&P5#2 zo7#^M@^lsLTuZLleOThqqtE!V>5iD5|5Q99|EcG^sc=A5a>2YQtk-PgX8$O`VsQg{ z%{DIB?YP&h(k^)!evXQgPQ1>57NzQ{CXAS>yV~VDqh5TKQ!@zT_9374?1p=eta}>b zr(6sqAL*ETE4VV~NK}4t&XbRqGB>p{=$$oOv{D9$ua6^)zcc93;WtZBJS?F0J}kgMR=p&w zW~a4(Sn!Z=05qoroB~b@2QWR++}Fv6F4;{9sZ?!ed<-7m*yo6Ovhd90M!#WRxt-8G zeL>A^SD|@s72PoWC`crJ)OEwB7|3}qP8_L2B9k=(BNJ-}8WEa0ZFic}2Oti-oA-jc zd?Bc!3OnClD?iV<((d9&5%@*pazi7qDwd`D@Jc+c?UguMF+I@JP)k1J!R(*ZqXZUJ zh>>QE5SPvBe0991B0GnsRXp9<5-Goqm`aiRSkj}MxrG&zF|{pI9NZywZ)9)5bI(b5 z!$z;ctl5aUSRIuXkq`Z1WWac&YZ!X6biaflfA-D|BFcur&CTG>`026zulARSsjgAU zQeUI;Yeg0gNI)oSMTR{A+gSFLcP}*^jSO?g@h9=+zG$(15VT^9ZTh~(Iy+01uc)bl z7(6uRx}UwH%30O4d|+cQ{^6E-cepHFDI$(p=yOmBpGnbYIX;6bK9l1(WAe49xOwPv zM2k>R#0NB#O1`#2sMmcUkQYYQdad0N!^LE)berz=JdV_Trrteu0a52!vYw1r-E{$r zQpRc)XiI=RO&}tVRl4MIUHFZaI@X8}S&u3&w!q?WB_)%~Axc)4LsCTUihjNcflb>S z3}062S})Sze@gDv+{(HskEg5TM?1|X^A&e7O8Ws1(i&F!8?&^Y&0;BmFKEUWIEm1F z-eMf@=^!r+bn_w@Gd5BXGI_rxP0Q-0t_m#-D{Xk_-9Wz*Zan8um_3K)Fwss=%~Wyk38-khY6v}x4ViayVq3Ho^{s_1=7le zznuR#RC{kUF>uMODeawjIhly7_ceLMci~ZPCby`yIkX=<5!APnrN_Jyl-UVh3Kz z6+u>U6~j=g!Cm?rsr6wTpEB-HcnXX0YhnrfARnUCwezl-stG7(+HBLs_ea~owR?=h z#hC37+mA+;s(W>Sc1;bf((Nu1SXNkSkT7mGseAuNfTG_uP0k+~bH(}P6uv87lEYc; zBVN3HpEbzu8f`Hg$kq#4lrfm54WzUnrZ>BgqH1@|wYYfm_aH%hUQr8#PLDLZjq3<1k zq4vkNtKZ%nIru1`p-Uux>^bCU$!g|(=u#T^O|*T!8h`O;Ryh8CVz?hQzOO^skf7u{td!JT*cK z{J#HwwfOPZ7`5A9sHtl;mn-``cD{V4s2%EQ8_$s@UgiMP?jZ>xuc6|%$a3PdY&LOS zPC2|i;LTI{VrgpTTd%0)k}=Q59tDwHq2+jNDUyS6!>9hy8Zl4D^pc&`+-07;Qv9O$ zvF-o{G)cTl;0N-_q)`%SR*y_`K;xOcq?vG2X=9 z-fzj%?-UWFE3N&)TR@#*SgY!8tx_mh;fm&(>vsWtaopa}nKiX8HsLMDZiGe$$LB~l zx<^VChuJwZj-9&FwO=(Dhm1JzGXg7KW$bTOeNoc~aXoJ9XRqceZ|S7xdy*#;GyKj= z+;4g))}T2-IB_nX%8~`!ucy-29TJ_4{%$qfL+hm*;}!PQVwp6{dBvs%y4yPx)z6sf z+~<2RzFWEFU^`Zp+Rv-?6l;wHte6y;^=RBg;A9;8K(c9+n0phG>Pg7Ep}ei5uxQtH zy0MMKo&5QU{Y!TT-zW^r6&8BWs?tzWDer|0K$xcV@?!Boon z9+z&D4k!Mc_`O$l*QQ_3Q8}i+7(A-VMj0>-A#7`rTnns7=z1^?-isPg$CI`<#yIMi zUvKSH&&S~E{&ug8eT`>-WV%VHJdbU1;}(TRspK-vcbPm;Nam0z&yUAa(GV+(dCzZY z0cM>9pQDnz@dGB^93PAaw2@kMg37ot-0O8^IhN)ub9^4r?`Gv?bCrm4IBCn;V@(=+DOZ2;I>lPS%XtfupqoR4{t_4+NAFDD1=cLwnys60Y+75QS_Zkvt|QT!KMHP~ z!Y=gHkd|hAdXdk_G(>B;uyZb!8~IMjevW?!Hzz%h71`tHn%-^WPap>(mZuhr-}Tt|tgubRE3qG6j27c+3vN6nOW!hiS=F0Yn6&x%)le9 zxHdMkmWmXqcP)LiTgBpg!WKQhehc$`{Q#Z=*6sMFPw6%F<@?HZ#VefcM7iaTONnT1 z+5@p3xEAKbGb+wS?j%e{WhNwJq_(zp>#PQrD}LWxL(0u~51D>a>+|mYh!mQ*7>^{d zZn_h3*!+IgeZd%G)Z_8K2WQ}ytbdS*JBFD+!6y(-cCKGiZxD7U`UVDq0s&0+x0O{? z$pGl+F+>m`tUzP^OXcIV)Ek5y3Vbp8*Kxq>#sAB796-4*T#n<+b@0-Y|8m`b`+OWwIMCV8cg8ON_5Gl@r2orx|Ml}h z!A57V1E8wM471Sh0VX$cA~AC2^FdKh(ChwXg)~sl3FnOCJf)|`3Q*X>5$5MvPfhWm zgxDGEGzS!t^&6ib;46Ytka7Z?8*nrz2;et@*BWp_^}~+q4$dc_Tvx}|7)o4Yf0j3n z13r}hT~`1>nORTDD*(-wU##G4Kp`5O{fYyiS~#z);DQ$VHb5cX+1>#6O8?FTY)}ma zc)d5ktOzgJVgp#NVLZ>k$YTT0)91Bh3pyH3NJ!6`0q$h~r5S*4AI_)=0toZq1vsa* z;y?g{{<$u|Inm*?($O;oR2FUjkxqjBKb^(@12GMTAyCn7D;U@U!wsMU27sMl7*Z7N zHmrso)&Rqz{wu^Z>{__HIyZ=ER(1f;3i}TLC<92;e~X|7|C;Oovv9!iw=kCsMZm%w z66^qulI1u?_MXDT!VC;I$S+JR7=|SNSD4t)DQ=sZ!Tb-!Uaho&st9_Xnwo@b^#W-` zYdT|3)|=Uy$2RMhxpr37VilN0XT(6>*bxyL_XQr>=TKRrHt&fx-u}6<$$!=3uw^`2 zR_o{N+SiTmeS^^p%J!cQ>>+MH$B&*ohJ1N^R6_bik1wePv)0XH*Lr7tV|u#%$7<-c zzC=rPcd2W)^J7SNLPw8|Hrfw1qIX~9Cm)&bE&s&a90%mv50}?6f5x~UI6IHbU#+P{ z*K^#P-rl{Y82>ot$oA*g`3aBOgMI#+M|UuEApF}uR!Pm&I3|^if+t%xAJ`t%)Z$ma z=4N+bvA1P;mDK!MrX9e=Zf-=+8xQIb`&sOI*Jf53L#kU#mw&vHk z`Q_2UOd|(rm+Si$H>!ThS)$^SM()3KU(zSByAj?R|K;sBw;lPV4AQu9-pWfOE?o8*INV78HhqIp@rt?jSJXE=t~idvVx}&!_O*BD zU4}C)Q!YzW;;1+tP;FH>ZaO9Db53<_Y@{zuFZe(XoJD9%4WsQHlYfYcG-X*bG>6s& zlh#%rY;Y&_XIpy2-nAZRogp2qsb%l;ka_HT6La*)b!XN@m%xM9b^q%wZuU8w94Ne zsT*6r@NGM`?Pjml(Mz5IL#w2~Z7S|J757G7)NMIGd)k6lc6)7y;7y#Yu9MfeFoWgK zxS^a_k`RE#i1{^tlx8L4{j;U?3p^bk^thbx zS?sOFFDVq(`VlLTC$R5i-nqD58pLX=*Y!}!tvo`=3rTbD20n$)AeIQS*odnGDMgzu zN|19fY?e?};spo3A z(AhP#cUsWdguSl^-d=o-aKqLte&y|Zrq*6l(vfG0UmOTsS*=#8?4RRpW@NCnJRn24 zu)2n1)**C{H92w|67)&!m2&4ohVgCLa*g^|-C}lBKb|UST*XY;PoH-aV0i$!@u0$_ z#U^O%#f)@6&*QJS(epH@^?d}&eAq;66+Ic7WPw!FW|(4zRvj)O%ahEQM&j0okr}y@ z+t}Cnx2`m2hrYK$$$9AOa=$L{VFV2=Qk|Ny_owO$#uJpDfP_PejW_bh=Q_Pjf>>>8 zr%YOt9<2WP3xYUysqYNBd)zOMgb+V?!Hfb?=penILr7iXf?AYvJvRQzC3#|@si(KK z6}LJK&<#5MtHrVPOpH<v#AD)dad<2TG6teNCkhZymg2${BZ4{%da;M{1CL?cfk)7v-7Qsv6~Nvu|$ zO)lE3SGrTpuu{4Ch8FvU*O+JEZ3!v*kAr@T3pk{1j!83u;}8o*%piKVr}s!%y!|+} z<8|e|GGB~)OlT`U6*NTGVlujTaofsH-|L+a!Ib!?&hIP4PE70-&EYqYmXZA^4=3At z>K(BfGsj#}^T*e~zA;jAPf#1fRw}v?z__{(aFR3tB4*E>w08&^uDJ>mUS0GNb*k1@ zZ}2?tavLC%;LvI#hCS4H7ZgmZZUb_))3{*mal0vy-03A-gayKud>z@F%AF3BHIADo zH{SQ%|2FzOuVO!_Rq+GWi&gy>e3b)eSEvPnvo>erxh=~4o=-G zzq6|=NNGvH7Vn1DQbam7xz1NS!%MOWe&DqL9VeY0Hb z?+-7VHhz;4wvuUMZjzD-L74nNwX-|^MftYaVA@^G3lU^qC|zG4HDJ_}#$|{<<7TE8 z5nM^hrstZ`2|-A z$cb~%3wHLpJ{471AS{;Uwl8!<44S=4SD3%vQz5a(2&uK-a82$@EQ>>?nD~);!J*2Q zJbd-WhoV7=W{M%g`IVtW^31Pa-c8I@%f!5vImAP~yT8>*fTn7c;?Z{vQisV}jdh)R z+$vIDy6oyE_JdD2=*&d}uLHs?_VvjrIxeEn9ogLn=Pkr``%^q@P{Lyo_d^P#A-jXJ zc27nZ$-(s5gN{l4Yc^=#otY#>3Zq}IcQIHbhx4fn_NI}Kn>={Kh_5=AnN4F#w8(;m z_8?J@(_e^{PJ)HPPa%Eajv(s`IyPzsb$WbKs-hre9G#NKm|q3SB>Ma1C|ZQTL|zN1 zo>)Sn#6>O-aIKaY1Nq~N!Y0jBrF-R!U*KJ!$8uGr7#dFyS?zoYQWlfIQ|-DCMp@>J zpl46qbN#{g&y}9|477_Di8tHnKXzhA68og9-+VhR#~HdfoD|&z9$ZRnnpPS`$+qTK z0l%#b?yEE|B;j#nc*Rxmr8JiFr%&jkF7VtkdH!5ms-s=B->^pETw77CA#ce0*t@tZ zD(M-8VqdE`yra`>I1PA1>tfc>TZDK!LI&$!Uot-&1ECB$eLwPUSoug@tVL~DIX%OI zi7;vK^+t$w=&s`H023@N8Sm_+A2^1%=7v4&kBIKg(lIeb&ek#&KbDSvJ!^h5wfEhI zHsdmu3N;0*@H62yJN?!#I8OvTP&L#I4ihNGu(6X#T5dicZ%DHHxD6QVCP23u;r-qw@z3UOz+Yq4Htu+cZ#W6v!pi|DcQuqzz za_#98p-8Z1T~Vx-BI#`Fdc&0lf>uedp-)wWO~F(`$o=T`6n$vCcb~@benQ7o+`RvT z_<|)Sg()LV>z1~7?)Rz-muxi=`qV8bK0HA(sXuroS0YA0gEq*PCv^MH+GVLEA#rBb z9hE7@dYt071)bNV6sOvRC#?+<9P3`%YMFM>SE{0`=u0&8n#aQ7DWJKl zjkdlptn3u!UBX!g%Iv;hNJvw*UqG_01G1lZ0J@EM=_+Mf;C;H(x0saSM`|L|10u0% zlS#7)3TyMCR%jd&Lo!B1NG)WUNf*FT4<+qC+azC>A-Slj-SEsd=QEp?WkX5kbqt^D zqE2*ek9bps*4|56;Yx};S?Yf%n(T=Ab2f%Cf;Z|%k%tNg4K=&ZM+9?&4GN~@LnNaR zjkbC01}DEbr#E;qWuHDh&vMXMwBhnY4r)^?`5@F(X~%ehKE=6oWqQ!3`szRmG$N2O zupVq!Ppll$P`Wf(sp=%sBx`u>{-I!i0yZ0-g_n5aE8q3-2?XVCmS771L7dkSkC|~| zFk&ZCpL;2VqbV}o6i#1V2%L7Tun>=;#=CJpkB-S}nlYhmK3M@VTB~|R3iC&+TG|gK zZJlLJC0D&U+LSO*3r_f40n?XuAu0pENh5#m3urN>gB1oD5mw>MqVYvWIrS=SpT@Ez znH_gB-M8<`+(!zhKyYC|YaTM$Cq#Q~cl9P?IvIAHyon2C%AkLkk}<6J1y-`Db3AKIXO3ew2-uzaEQE zF>HP7<7@4wC2RBZ(-T;aH9mQQl8{RTS4F%6#aZ>-mTp(3PXu^$<4mFi`5-tg;by2>x z1Pv_DQ+#r61>Y5utI7@M30^6EWw0g_&P+^E_!4sGMVkI&RukWSdIYS}i;G@le30c= zlDnc`469fUv6K4Vp~+ZjO$w7<3&QyVq{y)GGee3*m?LK2dSfyT|U0uxW0|I^?%jU-w_{82F;jMI+>r+c);IX1K(?VP>=|k(cqgPjMw& zfkxnEdcK3BsEniDQX}nDze&RchiL%D@C@|}{d=TrcT}G~R`D7CGCzmbkUNwAmHbgp z{5QNte3W?^3>%XUjv{ z!Rol7I-}^T`GrQNHu*|OW*MQ@r)0 zQFTP~hh(`CH8L+xEXdD&x|Q#=9pI_P&SCFxg=R%{x+PsW%7k}Bb^G<@4UZHj^eGxW z2YN%QhL4knV;#YY{Fzd`x#_LE=rk5@$K2j8@DtR_-PE5>G3^tUdMc##R@{!7pq!1~+(EQSdGBJmyQFCt!q(iP?xu;?BTTV-)3C}wtL&k~R z^tU(s?wM6I^Io+b#%M1@FLH@a=P#$aN!#V|IqYMsYeKUzaY2sRCdiwP@Ph7!0z=#`R>T(2hd}E1j>U4xGa>| z&mv1H6n+$;XWi$TkL#4mFDr|@}x zbOmaod)%*+pARu)3!t+u#Y3UOZNQ-cx{-dU&x>tOlPUHkuc?j3RK+nd zmyqfMb&zHF4-Q_@#bKw&#Xigg&X;OA>f0I~KkI?%Nmkfj!v7;nc!L~Gq9pm^r0~5# zEBD9hbO`UF`^H~Cn#P@0TFEgc&3$j6PPnBIdS!6&iqiD^`zhBqu{MJXt*vM@&{1?M zOtEclHtv48A1&z;ikmP2x#c;A*A$3NOV<48NhQ8=5;ITEHM@afuFvkBKoBcG%)J;c zhyK*_-gsG#bGo4wHx_QpF!yy2=@jkY;>xd~CBwahg0r)BNYPTcE{}tWTAEEP z%p>U(N|Gih>t&m+NRkQHgFoduHOLqwj)Le2xQxLfJQ(Zj4K)=NflG&%7vBZGt~6Wk zp^(A-PUl^m)IFcOH@}pKWFaQ^6Xix^nFLZ!M~_@&?~h4aY}D>IUSV;SF^6?h0e8^(GT!5$CSZEi*qVT9h=uR2w<{ z(f~pS=>iLN`uYeUjq6aDAF#8g#A8xXKZ;%j`J_qZnST<~!QQ)MqM^YZ=uZ~;?CH?r z%$HqZ>c%7D<$I{#q^~o_P)hVk`v@^SuA`vs*TF7K?CUFawQgedH`q=hFT7~Cyt@EVcE= zzM~EZuivnHj;I-B%q!SepWM<}b*Dj7W}g(((AA$fL6~*Z%555-M7dL|Y#KVrfaYuL z^Tsj@R|tFgo_TZ+O{z<;t{Ag%#V$aI*d!h<6|I+;BHT*I<@v%UNHuKxm7)4H z?EbYR%$m!2U8yQ7ev8FcANob;v>Z<0oDUPKDNC)XqLl7mT9B3(B(WFVZmmp<%nBC#Ddqq<08 z^Ft7xI`&Q8%Z?fh1SPKwG`2BGqXHPMDnAy*JCO%!q`78uMw zCsvvM$tCC?R5D(-+2(Wy&4Dy2sx!8oh6go&w1v~N+Dq>WUUXwXFjlKxV_XRa3-z)T zPB5!wbdTP0*;OY0$*ar(PS{zOjSLILNI#9Z1s8;i5qI6Sdm`4w<#g3Ol(W7Giv(w; z;_hS&SdN(mG^XJku@rG@x1ZKrYVcr7k^cj;0AkonL*dYu)7qdd78z z#3DY)0gLCf4A#CEN*uNyk6W`jHlr4q4B=oWvym@nNNYt!Hn2~On4p16OCMi z5zUxddl#}9#1+Hs^;(fn=d)(cfj`Ve z+<>@IS=;=aRc~0{UD(C?@$OB+$i=cqw%&ZT=G50gGu1?S|A)D^jEZYbw{UTHcXxMp z4IbRx-Q69626qzNNpN>}cXtWyeo1zxclWuw`*#1hMzN@uRo_=j80&fGoSWAq zgn77`H5mbga$b_?k+PO_q@2bKTp33ToQU{BA5#3+^dEE`wj7cCU=dYOhCgiX41L&{ zXUO>^nc0j{5HlbqnMYHW)hWtIf^pB>)kn4fk5f;y>77oI4Qt%L0R_K1CiWzq6?qf| zSwAweDevSmhal~lI(7nOBYTDTNnmyd)%d1HtwMNNryHhppKIluaE%usv2Ef3Sc$8z z0sP}3Op6CV;;UpfJYHvjHlolKz4sGdIb0TH20R{imK?#fALFz@9q33g1P^RQwAQqW z8v}jZfeVu-nDW*L2G6kp+EPl#0%jF>zZJy8AkxBOMv`VPvdDb23@z(@A@I^DraHUW zIUpR?x}yaCcTDM({K;9NR7hgpn_+E(8$H02bxl3yf29dOWmZ zfZJ#SVwxtkiT1&BY}6xQw}rK}N3S4F0^MNL{&lj{r!J~d-&YGbv?06%dn_9~;`js; z6jmq>VI?U;6+sFp{WWq$z+6#^HKn7#J=f!!n^wL{S0%BT7l3DaX>kIl z2UU`Q&_hIDy4@7>vexXfI8gh^r_$cUb3}fE)N-1E4W(X8gSmV1wpqFMzGtMJtwAc} zSMzzk&78T~t;ifn-lzh%jq;3Y3QR4yC>mWhYuf%X@qLyx?0ds{li?jl5d)hzfz|Qr z0zaDKOCa?Xnwn=>e`u!Z((S@%`YGNI@iWW~Ug8$hIp)VlHC0po#gifN`r^YY%@e_%#y*pL?*{Q+yoAhhGv$((L)L?(_zxbUL@Q)n=Y`>w` zzo=t&uFz@Ju>gnYVTghe@{n#_iX$>-8t}g=jVTyd-E5*Qvc2_{HH_f zZ&y~<_nwvC>Eg`q$ytBzBY5wf`M=snAo(->$H?7A-}=3&;@#QP@~3I|d!V*~m9h0d zyE(G|#-0D!9`nn0?r$wS?>T(G{rKL^3;&G4WqS`P{MU}*f&~AtCBvWL=TP*D1oX-Z z5>P)E1QcdYPIg@M^scV1bVm9H#`+#~@2-pVhNkAU@8N>2D=|95YziNL|-~Sa1{y&lTUm1xp zvcDTX{aXBYSp3&S{2bl8u^7j%)67o@{_C*%_2gH(0Kq>%@L$vWdpiCO!T+!%`_CZw zY6D{1U8UPT0C7YF8v(?IO*8NgLdQ3MoB$jkIkHYYp0Ie~SD$MQ52^Ua29$_|8DeY< z&oVS+8Z=AYwU>*lb-B0av%}Ttec$Z1F<(A!pQ6&H@&6eZTRVSFQ3P&`}()cokO|p zw->L+zkW5=Fbn!Xaw0v`yY;biW z5}}p2(u#_Cua7QU86AmLN|Dl$SPXVGlKrfpE2>X=?8yNcNJlzfz1Z4L4s{(DDm^W` z@_H~2+7Y!+d%b6}spovLOA?Rb^M1Ivev9x*1P? z58@*Zc|Rt84;KQ^7D!kGel5~*_TgUk1t&&+vXlH|I6g*KjB7|1HIu8zKu!rURNf2f zUK$k;=o!}wD((v9=>*4UKE(ekUO`y$EDoh z27VqBX%tdk6=|w>#oM$%Mh!1W3p;=dI4ly;mVp{vb)AuRpPErNF}6H}^eGHkcPHBr zKw5hUBZx(?g)3qNL72zjzKS}brX6Jte(GHBbn>%jC>@mI4ld-y)_p)dXlqlOa7Qt_ zi45wrT7{HnZQ|u`roH4-19m8yOTwuGQAK0!=$!ek)#I>0F6BHB`eNZ8Bx#T{sbW7m z&S`|Eq(@oBD8zrO7@8l%<@6mws49#>Yq`HhPy3@zet#P$q6Za^xTa&smtDsFnvfzl zu`&s*6)Cj%9=QV-BiY+^Sg^P3-c5>Y6Bh7lr2x-N63}zMFzkSe?rEmPOC(=fEjlzK*R%AnMe$*NjkvQmr5huS#UR4|iPE33M zz(!01$=Y^f;_O_mF$ob&DKaJOTNl#3yg*)H2LsUc0t90VD={#1qdk+jp;Z`vtnfw(LI>34>WO7XyMS?6te?i+p; zLENQDliGj~44A6LF&113Y3DpoykZ7&qhMf&!HIaIN{K!cH>N@d1}Xx#5kG_2rLI== z4KQp%h{ng(c(qIs$d|lt<0QJXh2IwGj0`9f=SWc60Pd@SLv7?PYR?dX5n6RXY};Ti zWo3qEN+CCF+a@EW0atUh1DpKKgA@!<)ZHEz1zCpsXN3%+9-^;9%wKI5?AM_NUEoxO zMLcLIDQl!}c*p~;JZ^WTJTso8=Rxg_Uy%@X)}qkC zlr+>_?d>VWh`l)xxMjVN;e1@e4DamNX3);ZL%thaWJ$SJDReDvzshCC_BEP)4{KW# z$s-*B7yK?+Q0l=JKkJlI*4d^Gz^nBDI({PA55jUDDJ58h*2|KjCF=L9A<@DOb8pTBmI@lIdu;!l4 z{iNojfbZCIq&q?}d(l}0f)H+aND!(|ouDw^+lUO20Jl+{kTOAxuhi!Z{A1rB{HDktcKF;o9-UhkGxEi zgCHKx1nISet?TGjP^{zQhq*yiOS|abmydfGkAqmnBj6ct{y)6jmj;-#h9< z!|qUJbcZg+8@hiQ?2_k5pv?B}CIg9?Y{nek{20d0XW~*b5941Y-ftt&#u~kcte~~7 z^D4Za{t2|sVc$eeswR59k;T6_c$1(*j^ips|FzqFoBpY7haaY?{Vmk-RTwWJoBtYX zH+oWU)5UfqEHdHqI7&UYPrpVRJP-eNLt9i&VZOUxFR~ihcn9Z~6XS~(QEEzqqL0xs z=5iuI4zk4uMzc{5RSI5t#q@X+(l6<1V*95}Wlok?p;HPcs`zjy2n;>*^PlcQ+OfOQ zu0n2^*vrGh^~LNgpyXiXTGw>)clT0^=4?I=#gb8aaX6mLYCNnor%|AeeYggvJ90>P zsMo*(sSDJ};#_6D(c3WO3#qf1fev2#0y%)b#HhNQb(G9(t6w4Cwq3nB2?-vv1G{-& z3*rkBH9PNRwo!(4Pgf`$lUy)+0kWyetI)U5NAjtR$Tc{Y>@+%h1^Z-xcHg3LSzSMq zpuH%rTJ;GIi-(G_GwQ%>Bh(^IXhFGwJu@%7a0VsxiIF(tCSR1P6S{S(L03}qA%$&c z^U>IkNDh+TiV1F!Mc|yKHnEl>u=n!Ijw6bNNtZjSH5p=7mf0bFUR(7&gixTbsf9aX zk_p_av%>0IH`e!dW(Y9Q_R)?d+j)*kO;96DteC@rbS@O-UGTH8U_%xX&NUC?ZGl-Nv?=qAdx(j5@c zdGZNA4lXU!tsl;vjDK{%(Kh7iEZua)S;w5_stg57e#oddbm8Q+AZ0k`-2(m>S&;h6!!N65L|2*{F z>cvD?;Ei}hmqs@B%bba9`=Sj4TbCPMIn4=^YzsB_;`#=Ot-M&AV>WRzGBL+SUbU0S zaFjidPL2R!RyWdQD??sif0l;UF0L z`%Hndtx^pbtv-!vA`2L1o_B3`5D6OEXE6ALCelT0xt@1-KkrQN+?Bi22?9K{hn)Rj zmPbDm-+bapXdZ9ELpm*>`V8pfujC3Dd#bp-P|S0g|3zHT&pjL1_TI(thaSX+4+DO; z!mvG5$`g`aDIP)GlU{2Fk0_N9HMOPct#XG{haiXc`bN({tBvIQy-p z7;I(qA328TZt%VM0=|HA)7ZH|!D%CVDBv_LveneRY6P{}mzOt=G3`B-kk72LyjT+H zTEw)ieuqrps!TCyRHr(TYHo~hZlheP;Cyd0!ab<50D@|ATDH{X3=al25#iKYlopHZ z`P7T;G+JM>*2!tp_oBTgecj8N`^6!5QH&6*WBRtzoTQ!NY=_mLXNo(531c=J4}WqF zF#{hr+b)4+l!8=#l8)f&G&%pp8&8xbr|ol|tj0i&)5yNn zm+IY$S_F2+*#|_@*N5gGgKHbZjJ-nlF!ocDA{zL?B1AJ!qv*xpCq!~UcPf_9uAi@4 zLr0DbK-slDN7vQbHwuE!Hsaz^_m@H08&-PdRfq{ezBz#=pUngzVQMuAQ6i^#f0yDO zm3K;r*AlgzI9~ZdS-}E1Eds21g^En;4Xy}{UEo!)V)q@-RQw@s2xF3m>#Kj3u<4DQ zm1OF6qG(kw1sS4=dIJ$oZf+}ND_?v_)onukXu?}>UNb(ZBMhh`XQMAQ?CqIZm)pSs zWoWpkpnaY8__2kJhoa_!dED^l*Wt`psW5c;A&eHtX7%(^c(R*n7kk6hr2ubd#8H#( z)wz+Yic5CO_%4p_DPiN*{n+(|W6`_E67WTh{Jt*+ti-lYY+omoWz2g^xEiR8SA>$p z7N`uEyhP{^nfCB(4dn1{Qzv@Y*Y9%@oKp>M)knGXYDmCT5o_>QLs-bs=a%%kNlL?z z*sgRdZ^&hDM|(|6Eh#de>jQHAJp~MrBb*&b@behb*@yPr)0aOcD8?xU#sl}8WrEz4 z7#SSdjdJrNVI4=2u)x)ud}>&Wo$&75Z0f9~3DWo=ZmKNV4<=Op*^spbUwSyU4+n#k zqnKf4VNszZV0zO|Ba=IJCF0%-A~6R8DBL_@Vm_$eWO0%|Siv`vJL_AMF)pkB1Zea_ zQFmfQw%(5oR|@CSphvrYi{`Qj8d7w&(NZ>?9D-R?#Rj!bplCscVRhjmIBoQ+G~)ANoO|AbC^6e!H`KaeeP5YyR_1#+I_DkecJL2FZ21uz zN!d7YaheKHS}w8|Gx9&Q=U%HqK^!F*!bvesSFZXfjJ#8Gy+JReH7BnCiz?I9y((ZQy+{LzrnoxUWw}`>Tw4_)oBgZU` z<)ZG37)@iI6J1e}Bb0~N@BpTt*yYWlvdml)pPd}g>8N;d|FC@WNd=_8Dbj1+Y#>bS z<+yU`hn&s5%FAVtF5_ogTeUts2RFvtH-0`-C)?N+Q8I-@9rhG4fAmjefvZv6 zleqW(>^Mq$dZ$7FZ-7uqUu;G{G&$NN^qsq^3CGhvsKfSU#1*(t*^5+A%7*_(4oUvJTCgQ8tSFu@-7CW zX*UtVP~By8^A_fP1ES`QULQOBQ13Uk)Qek~8Umf>9Pu(s4|+@5nH0syr3Fw?H?faG zMYLk3pFW^3>ttQJG_}5pG2Oy#Q+Bu+M8%!y$B~MAct)~)b8r{(_u5Sl(vv@NE5VqP zeEs&Jx5@vNYz|RpF)Xqn?A)PAe9{@%bq9c?7QS9A(NP54u!zL85JK$=E2eC+P^R(SG*}&RP4DNzgi}!GKYZAJQ>%!ZT3>2r&zyqh=o8shUhreYRnl z+b2$Bf7T(4!W6AK89VH3_tL1>{gEoCYG<}kiC!ax-Pxq7rUYgkdd_{t)zwPjWXUEy zuO!jEg9U=9`1)!1!q#hL{+T{K_X9(vxk%QAfymVSVb5aX?+%YW$X-CEjhn7B;vng* zuqh^C{5+lp$#q%0z{T==y?ix^(x@G_0>cBT-?<^;5#UA1Dv1J#1#UaK%5+ww>%#&$ zXGjgoz1MM>Zcm2Pb-6svxAS^nj9~i@N?E5d(B1^ z`m}&=v!Nx*Osdc)-{e(H@9s5E)G0UP&|x|mYcE4)R+Vy1gQQe=)Snv}m`f@bI<<2Mg`=Wl;i_b<2ir&9Va>lpvl_Wnzn@*ZaWJ2sQ$J$?4~5SZTsAP89ArOf|Y zr1}37Mq&RAI{#yg!toav-h5t94o4gAr|;uq&fdHpm*3zX&kLvDUL5Yx7gX!g7CbHfxkMGg* z6Hn#dt{!doJAHXyc3nf)Wi=1zud?2r0?n_#9P^pu>sDr$47XSEi$*AiHmQ`D!%H4c z^Q9wmyk5l=X3JG;*W2UBwoleNtBQ^<9bVNm&4zxpgnx8$@l@EivR5pg2|x0QO+9EK zPIO^Wp3U^7VmnBmMx^g&A-nl9U#viWRH9>&v&SScHEA-jUA*uGUxO7-akdz|RW_01 zb48N|*!4bcaZT>%mwrWi!AfOqX#ZC>J(sy=azZc50v8Qht(;;{WP15@6>O>unyGh(H6-`~bRP2R- z^F#fj{#HjB_oY0*Q`w@0fH(UdL5yr4g$|>0ca3k7o^VE9na3;xwzIYQc*{^ot3&k+ z(DWHk+fGtoT#&axIg<9YX>5$3b6Z{8sx#L0OPDV!MDI`sZZIO&x=x_WPL&iQTEJ&S zW^XVH&pIREe#coieV95vJgY_HfyLK*l@PZLTjo0wn;3Z5$rPgMZ%5~2WZ2li$L6Vq z{7U6-C@6SvcNSKi{fM@wyLuLoo9Q%$WZy_lnYB9Z$ zEw@9QVXikk9@Pbgd)D*JP~4_bSozu)KS6&qH8C&83t3N67zOBl|@pei0N!+A!|g?HA#{XC$z9gmlc8x6Z*aVG|Y;~qkc z6V_5{v~R7=7ZX$$YNgnXdP5~e5?nzaItpSB-USS*Es)rb zBM5TvTSrcI(eqM7I*RME_hTB?S$x;URqPs|cF)zW4llaHma1iJdBv@QN;_2Tg5=BT z_xeS&!==8GsDG*C52zXf7T^D9- zn8l10t}!Uv6m=L8gn`{dejU|1va%D4>^qZDINw5*gAxWY=q6B5GjA3s^iiwrSVaBy zFHDgPs1)$(sxeN2_AP&8ToQb2S&|8dUl1bsAcPap4;z*pn{hXNzh6;%4|0l|;&%gc zn5a8eBe|Rg(7jmVeC~2_$T_ABBo_hiN+7Z)A4xB5?iS>D>6Q|vQIE6XcUulcsDLHTakFO*Vp>bi~*pe0# z5b%E}SbpM&8pr*x<%}e^+PHlus&$=O=qepVpxq$p4@{%p8@rMIX%G1&@fCwxq|yGrgzGeoxd z_ErlfuM}axKBT?RI%b-!@lES~2UZkDu$bL-vA^xsJ$4K5b4xL19c&?5;}8*=WE z?c#jvv|!jqq26ql<2Ho>4mAxnyuU3*b||wZ#cgVkAzqk)RtO@Q+x(3tSD(jLJ0?Oe zw^|mr5<(6~Pp2cl8~8n%-3&sXdm^M(30ON4*b%yoMDiRbskzDIY?t34M`i@Cr9v-}P_|Uy`IH4Iev3N!@ zH_bG{WrifrQ#?gvU}~OvQ1d?IJo2O#414k@xNMtvVw}SUOZqlkjAvLwTfFF~8(FyI z{e!iXTs>&yE&*W~5tYF1`;hVO$wr=MG)tcQJd7L|oEyCyiV%#V`Lc&P-sdP`Xq;or zV>ygD(zp#1_l4rw58t%$PA~16FYVm%T4fdsz8ZBhnf8m|ktJ;zgj^(THY&o%N8^Jn ze}#dE?averQf1jMwiz}cj+jZC5D=yvpmy@tKzEcz@VbIH(D9ZLXbm`zREyY!n$Mat(CR~ zD>R{u;dinbOGHoAU1hd>D90*NnKBc<2^$#NCAaM(sq;93La-1;9IEV3Hgq|jWc=i| z@!3u}L}n-VQvzs&9HH?Eqf{cz=TjzG4OgMmq`W4TAV~xaUj|f;JduN-lnM6uS$x6_ z9BbA6BGy12J0RbKAxFtib+sa(rEMgI5}K0r>OgP0x{FlsC*cB?&Z0U@&ZdavJ@Q2a zT{=*7@G_za0n|P7U8D{(4Ou0o2GJax`RwwN;4nVg~2iH6uUH1p)-3smRZ^;HS+m4kb>-us0Y6m%FN3w4orZRFWeP+L;1Zfm)y znV=FYY^=Y=2@^(}$2U_~kzA;Y-8wGV@m#y$>ZNlDG|alOtf4R@rXMfg8o;7g9Uyep zH8b+67(GD_vZxQz-6)mP&Ya_*<${4xfoGEROg@gZ^ixFZRGm6{j`A-b^Qlr7Kdr1e zAm28Pd#>)|-!+ZdUaXym zb-HSN>#}V&wfW&xhsm{ETByQ@>$E$oxNIrgf4QQ+&pOp&;(mH=W~a%AF3oP28LOih zl6x(alE%h)`LdIlbSeAe;mZ_{z;+h30T01>!dz;pC05houv6XG@R^4pF1ujCo>!m3 z(psTj{q&D;_Q-wavGhDMs%Uq?VQI*hJG?AAC+TNPbrD4;S-5O7)77r<>IhLP`L!z2 zhObss*GN%^QB|0;Ny5o@A8PaN^_U6H-RC0Ys>vYIXbWo~O&vHsP+*~pglQu|HfZSg z(QFsg!mSaTs)FVC0C zcsB}Q@ji#ipaU$+s?NY=*s=(?nRj>uFW8C3USZxvVnivkn~Q-!)?gY^n;!z>M}aE) zrcA@WQ7)FZDCHK(aikshNiNnp`eJM{K?KUTllyLgbd$>(a!I6s2lU4Q@r>+H92RLj z;gG&>u$IHM91%`bh7?hPL^qh87vDTkf%G!W#g8>I!${%H94ee7thv%c@n=sY$_V35 z2M&Z3gs%(0h0;2bpzUt!LE;r$YMThq?`Rojp4JemIVd2XLilnhtl;J${}Kz}0|2U9 z>1h)|B=3%qlpwMfR)YOk6LdvkTYqv;a!7bj6dw`aWZDYDPc6=p2ezKQnGmqNQgyt$ z9T@u@_RuiG1YZ***02yz>Ldu76oT(P^7mFZCj!oI5RTf0n>M#D__eP6k-+5dqnsi{ zSDBA)GYo9L4rIq{Z6xT6G6yI_@<2P*gRAVI7-%THk(v|xl z49Hqv)nxUVYLZyg$C0h@M(k?YfnwB`%BeI(=K#}$S=?n&&yo=Bs^^b@x4D=-kH zg9fxDGp20f2Gfi#f&(BbW>9XxIhPzg+@#U1(@-h~no4UD)oT4?^-Dqt0B{QnLMgVK zTUKCQB?~e2Qa7~d_IjeF$w3mCi3EtYc%Y2sL>gd4V7kPM2TDUbbJi^dfyuklWl8zbu1!ZF8Ky(#{h^5icu_DH$NYn;;s5zm$W8H0so)V@&Sz<_28i$;`FyJEa zIC)$x^-sR}c&RQg?J20ICXmzhu@0Ni(4KV>@icFm8E9fj&H2(LcaS5_XCOtRi1Y)^ zZIv_Nf-@VZ5_i5yG!S%=5b00gaOoVe%7{=e$H6JlJ#CAr!-?A^VgW^SF_2yd5OZka zkVqatW)&wQkqd^zW<^AaK5@|XBI;euJ5i`ZkKj+th1u`fwaIoo=J^15#FgKI-HLp#Y#W(VdW9uSm1DBNC z=fqzo0)!3L+q$~ju0g68N!>`2UN5v>2H^qyO5^mi9wlUAoCldybXh}tQe=&86M%tv zZ}irCPMQoa3+a}=uGr_1!6t0$tJ9IMiz(2EMwDWBRwayCGrY$rRNSO#rUw8RmKJcw zPS3s>m!DEVM6wt$E{2KnaUm)uGA=d!WUj$kSDYbY2w#Pj$E9?jJyf^(*`@jKRPjm|`^b)>G_9bq$Qvxp{+YFYBn;@lm$)+sk6>zb--%G2P; znS>*&GLJD?5g6gR=RvMpTVxGM-_Ii!z3E?y4!r#F#lKqcK>CE~v>f=%bjx*h5^;PCb<}fQWFG+CdjGDf|&^DlDqii z)*1V(vQ97WPdDK>JUv;o`WQO)CwD#EkA@C#-&~*NdVE0%k0ue$+3$JW<~b=oLY1j0S0bf*w!h@+Tj9|o@t}EQ9 zSdN$te(L9}&~TiSX2RS&Qdey5!2uP>tw*=BS%T4zC!KwL55@q> zhXFHJrs!zXDXbp3$bo}&7rIOq;&uvtRU!oXy|$!6J{A)6J7ttC#O@=Mvo_VtMEs;Z z>2naB!d{HxH^P<0$a8{}IQ#?$&maJZ`wsE2I43z_x4<=o@b5&&>^T0P<7HxI1$8eD zS;5@%SQu$mPqlMi{m9G7UO882`>Xl8w@vTu7%<7<4Jy;P$D5RhA=I7-a;o#0)uRcr zBS%_ou{0sqop9tEVkLTTw+t|Xo>9j3R7eM}m39i5#mvKaM8aGr8oqtmH_jcG>1{f;Vj9y;Dp#FLqal(0j?U!i zHWZv};cQLR6qn)4Ns*3%w{n5tSsFVWB&G9 zApgl{Z7;BHqgH$Frh(WSXLYL5H*q2=@Vu!voP8VRUV_3(*4&8>X~KUyBcs2X0SK{z zR!X2BtR%pMYL6bvtIBD|c8-sWlhb`wqb%bi?J{hQ-Fa+Bw&>EA@DOl@HFBvN(P7Oj z%6zzQ&F*3#!jiU=@9CP59O!7NeLc2_IZ+Xn>)O0M&dRD+ZWE6Mb*v^Dj@S(Fwv4I!97@hTfZipwOQx{-e-Oo@$7{H&hRRNdGs#0O22Nr9RRd2BsD zVB(x0O}KPMik$2hh_aakdUMIKO;RUmS9YSjrN~4S%N9Qkgw=f17KgrWzh%)0;5)6M zMsQt(RkLA!yz_yC0(jj9BFpCeA947jEbNd@42*cAcy5mIMI4L`?fFP3?}nu;@`3d4 zaMUaas+2wTQD@*jx%wDU;Faj`x~K(Z3dcWCS`-=L17Kksr`$lsLM-DwOuC5?a#;I- z$GGfzP^86}gz;O-t)n3vxpAsg!^RlI)pZnXlme_TW#>n@Ek~yDVqND-px5Tu#3juo zEDNeLUHR5BE7Dwryt;|8_c9A$fBtGt`Vj9)bH+gSK<^uYxOz3cMSo_0cP6V;?ymSJ z$=p2+u0|y_ZN*V|(X3E8p=TcAaY|C)5;vK>E=<)_rfi7s%=ai625pg4r9p8yvgg~- zD_a~6iM??MnHQ+@M)|I+G#`#_B_=sZX9b4JwYqRn5 z0;H=nuSV>~_B?u`KKyaXFGw9{`2Z7qMTnv}a)PK>1)0muHTbDSCz9p*-ovg+wl+vMqDawgaw+CS` zJCYGqTWzO}mXSwi;Eq5>h=OE)y`>kYo5iGpC%v6VHRPg?G)gtHy)W~ThxZd~za;TJ zB&7B>(g?Zi4a5-buIo)L8}zv1GFi^NA?SSmQxRI}kw1C?N^2a21^VPAb-tw1y(~wb zoLwVltX~Y{{HH0|8z`QthQhh{+srs4T-zRbEk!t{4?IeucDhe2h#Ep@i0XTb1i2U( zC7npX@tqR!Rw=%E>>;_NpID}|MixBUK4VazS7fNv{g4Hu{#Xj49kC4*@6ATikjC5| za_YegCfc=qYLJ;{AEEn$&kwYbT<)Wi+2C9`vf@0NWoKmOt~R-zmzO)OO0xmDI_D)j zUxl>DkV%CBcd%lW&JJ%O0YQVG)UjZyd(aEH0(BO0Dkck%LfIE^d*&oWSibcp2+Sb3 z3}!V!YRwaEnQsAQd{}HsJWEi(%;(fLhZOTPwM`;r;K_rC2NFt+u$%D}=`Zce%%*MPFq z&5mP{>RY%Fv#*QBAYX>N$gf&HrrgC+>zCWe8RX2*x7*!Kw})1ev-xaI?dztz-aq$t z&ujaCTm|U@ul#WCg9Ybo1%Koe>FLubSZfH~8d$tn&=sFvZ5?ysUHSGA-``T!wg0rO zw5*w#Nhh6AoOea}GHq`mdfxD=$n*I6JRQ)78A+@#rip3)>+%3M$8uP*jlgc}dge2- ztL%M1TPny@D`M~%<7c9i^us<1)9hOpLO+l)?l*1rdM;5|t;*bOz%1D9cXOCNxwU0a z4k%kYDCjm|b@&m&f(=`qlz>^RH*6w?$)F`(`~I6iY38lL5~U=bMLb z$)M23e}&?H(S)CjfsK)kawGsoz)_S?Jz9 zo!=ktQb1<5-(oHT7S4A=<-hF`tSl^a?^4d6ulYYW7yr5XjpM(@ot(cMLI2r2mGf_O z^Y7-VoWHz5|0C7duiD=P@P7q&{s}ez4ftdu_#4xG*WA&o$r)G}8#?_I^8F7L-miiG zIyt=KPR>6xVee0VA>w}&hy9wx-=qFJ_vHMk>iy}}YHsCZ>_9*-W~J|BEMjbEYh?U$ zLyk@k#`@M!ZW$-q5-~d*E^YgjVOIdSv~(H}7{E%#%0DeqzheEgNR{7C?fhc7af$PM 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≦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 Ajd}#y{78Mr< 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�c2Miz60Adql*bKrKGj!SJtNZxaJQeeWH zC=^3~4E|v@0TTcAvw@OsxRcfNX4m;g^O2itN>ak^0UR7UqZ7{7vWQw-!oke|bsb@5 z*!?%e5v~{FwS~N*#6#$+-6v*{T|sulk_5YW-w0BJl`4X-5d4#PvAEX`X*JeEh-$`> z6~*hLgHUf`*t-E+vMTDF`>>(+IstUOxk-|A6BzjM2qHhe>LnwISdxm0N^6_5$U580 zU|-BN%#r8bWaKDaGh^7nag`MT0-YaLDmG2*OXK<0e5)to%{ODiVo1KW34hmZEge&+ zs4?t~-+m1b5qPG^rraPl2flsuQ*0@K?{c!~BG2K&p)hS9v*9C^Gry4DHhDjI3fXeCdM%cu27k3q%&AM8e< zZrU?kY$r;L8a}`u5nhtw6nbG3n}5W1-DE5*s*l?h;Jl0g`;LOXy!(w5KemJ7o1}16 za_gzSi4^dZaobO)o1kTL8FZ(*%{Sv0VxZUIgD-ta$(W047B8UpOER}Ndl8zobF0FB z@4>aKM6p6XT)FtKGMnM3UBIKR(yJs-F3W;`vZG>3;X9p@TO2p@X`>(Np0n6}K6`y^ zP`EtyOkjvh;NvtPkx%+oz~n9wNS!}qfM7uGzv^GyouUlehppzqCB|Y_#QUEEi^5!B z71XK?p9$q;pI2n{IR8K~3+kN22I)g1NGF!R6dKIkqbNhAzKxRD5KqLf(ZdexqN9-R z)F3sjkW$b|+RC>31VgJ(lUh6c%kjpGz+`5s5jZOpGDd8~`i$e0zJv#scVN1hddJv9 zZ8W1p!zRe$4(a~UvAB@IUK1I`P@F!hZ88-;(9|IMt6vcaYBH1X1f^&SS@vYu-eG|> ztqQ3up(Lpy&5o&hr5!PeajM+0{7YWsm(Z8ay>N|XZJQl(XZ=t9|GF5y?B zb*Cs}TV4S_40X^uqvEL~#rpX^^w;atm@JO-r6f(2r%e z&_lES=GF*i+^pWPvplDFqlM~OQA3F*c}6UovW5tD0+6@m-JBG2PQ@2*E3HA- z^(z%6lsaIcx4~6CjH~Vnd8J2X+fnWJ>(N6eMWr&l^lz898hp)+%6gnRjF3+r>_&*?)!sP)qU6w-d|?h zD&R*uew-z)Kg&R@A8vB`@2(yBSBx2I*OQ%ZntY0GeMy49Fz)C31K$=pkAO=2jc*ra znVv`dfo}uqe*zKPtR9{>smw36V|rEQU-NI^3_$1uZNuS3B(&VSpePP*BfM*a*jJlq zgEYgsigc4Dn_oJE)>ejFQve2e*y6S;Y1i1{+=ns!o)($_D40#hm(ex{}B|QwR%(NeYS-(#Z#*d0^=D$tl z|J>i?|22uf_^^LW;=ki>{*C(y@UQMCz<=(3`n~oqZsUK2zxfAW^RG+}1KUR>)bF?7 zY?R3VyhHoTB2l6C;k~3(gK^x35#e2G^(x~Ydd?Ip$ zqsy_d^cn5JmJHr$)LwtRyk5V5e>s0!4IY1A^UipCyKq&-q5Ky4ej4rV)%3>a1VPe| zw_L$K@b<9&c6`4Y{TjVmxLUaR&g&$Q)dqNFq0ZE1;JIkm{;1u?(r&}zeSFy*@0NXE z9)8UV@_uc4KVA=N_sYz4ehEBpu9)w~Ym4NCq%dH6*?ubA-fDO9eq4R42M##9S=oN~ zR`{lh(~b<%A3dzvdpLfpIyqe8xym8{hoAX258Hp4<$dCXk?91yJuxrvtI4W#QPy(z zu)2KdzI?6p>sR>NJJxe~!W;g`qHV4N$Ug$9ijL-9$?qoN-*M}Ul@3JcqM<#$R|G`Z z--w0?EzFIHM&tEzyM1$S=55k^$hEzXn?iUq$27aNbu z*QC|v=vVp8$E#tWK5=u*_opjQRrq&67@_ic`%BCF>kkg@cis2hdEgs=E8%(8!gVaw z8`FIE*B>lA2pNx9S2z6bMQ$uyB~5M%!>0KdD0MOedv5tWBvTyN=tee3Rmy=UF}} zLdxd(Je1F6sa~^@BE9_eTnw98TVNn+G|ri_D7E+O!LOUUmNLEDL7Rww6yJVxQNJ?n zk+3x}JKfCLR@82TRUkl&K9?f3#-rc@D@M%iqoS^p?Vyz+LR;%}?^vMby($(}x^Bl( zOl7B!k-|cxmxt8>GMFi0imA?Mu+;~i=}v$*F%&q(qC(=8?n=0KfGlYK(Fxw}pWP>$ z<^otV6)>8H+snw7*UFx~6%5Q@3v-=-gl1my3F@xJj)kAf7=`jEJGZ0QW`JCtbzT`Y zWg6Xlcs*~HQJ%;1SoR#V;=|^rKY08ocBQtu1&t;Y+6yuPhGnJcA=lV(J#_4yIU+@K z4xiUYXAryI&FW69*7>C*A5m5Cw1JOMB=dD%nF?=BZiJ>RLZd@tNY0MbwXO*(@J1h^ zPio4Sw#R+0^XmS1Kk)_)9%8qT^K_z(#`-$a{62yE~8x~ z>0Dn~wOp{jZ@KTRaPP4s^D^WGbgg&VL3{Q4qDB<5kNMbhsCnrWVLU`%cGy~d2SL@0 zvEfA$1aj@Tni?Q@WWWn3B*JgodH)U|gFJ_dJ zwe9tSNVegKhLWbqat)kT^{)plYC5ES(`5JF4EU9@VAqO2Z4-c^m!j+u$nQcxm?eIO z@I+59%agW`8l?%pw<_ZKS!ZLt7CEr!jjmsz(yJYfG=UUW)qewBx>Mca? z1yQ=*6vqC7M3owJ-{Zp=9lp&(jvy)yy&(|6fgeiL?h=S-=xh=xZypRtX@y&&ZEzyD zt8*IEjQGToJ7-i{re{WyLRqTD6OoQ7vJ7qlbHq-R*Q&Kqervu=Hqy*E+1EPhhJgz0 zh^&z9<2it|4kcJJkM5^A>l5MbaG@;|$wF4rTeNQP5-L$AUB^X}=-gpjC|@eTrd=Ob zXRi(}pHv)A0>7MfiE+_$WQtXux>Au0%w<9GLv}hfDa|dBBvD$5d$Q7J8e_~h)-^f@Wyx2+ z=emErnz~P7l?ee{#op~9vx9H;1b}Kb_I@gcZeD{NfSi&mgZv=yUj)AqIiLTUpC2{(2*%2O*q zbuU$({TQly*AT>Tq=!zzF9xN_L;dw(#ctwacX}?OK-;O@KN&MRUzbc+h)+zV3+@;7 z!A4>=EJ#U=(H-7^B9f;-wHSI36}pPLCXTj)c)H1ygL;1n>ItPI!$Wh}t0~8dk(nPD z4m4aCid>M?-R9A!ys(lSMFsh?Eg4K6_6peFdAEmwjXa^@K6)Pa!my9C^2Ym$TF$1l z6zeqG{@gDKz7V|a+Od+Kdc}6Y)IV^_G586Vd#wjRzb4!h1txd198nT~+9aKO7s1lj z#*E}$;cJa2FZpHLL^W{YfF7(Of?j|jz>2>o1SLNgirESG=@x!R*`@HU{-b}kw`-i zED4>Wt;PCymEr9(U@!^;ME(10vT&76KcKA%h(Mjxg)63N;7}3V4 z?|Fxy2bn6)$R%uNX4ey{X~Aor9E039CDi~(0&~BZq_YVX>Z5(7CgD(LaC%Zv(oiry zJ~h-YUZ6YuV0Fg$dBHmrgZB8JR4TK64$#HRC4HZ{jYsh!@d+E2AIWbYAJ?#D1d=a3Ss|*ftx!jJayt<0LQAx zgg&_!LX!#CafsbH=m5och|p+F(5kJ8a-g9(Qb1r}q{u}P&;#n7>a~LTiOyW_5LzqV zs1}ad(ObX^Lb#xU-&2oyN!%Y7s?|{rpShI+5zxx-6;!)kv#I^$Za@X zy+|zBN1r+xV{RtbBtD>^IlaoU2Q-??^nBFSO_3o^L{X)}p|1crzYz2n%IDZFgL8g~ zcR4a?*xY;ajIPr9sfK=k-H{Zb2M>FYx}15|d>4YbZUN)L zpTBf{f0?lwNiezXA$CdJymj+)U!&J`!6L+ga;wBXyFnpqH`p3zQx_Ny@6=6j{mj+~ zLv?kYEXvnNS-{`w?#h(&6COM)my;-*8jWhE;;i5vuj_S6C!#{$6WSUP4ZPNT{B}Ud ze@ZhWV|vdVX-gCuAq97xvhG7u;Y~jX6fRV=P)cUsbss+zW~WamZx5Gv6r4N&H*j1m z#-UWgg1$h>XskzB(MzAJEFxoEHNyoy$O`J?*O9+tpFf+#xtO+6zTsD1j#__RR#a>)-V;fxoF}t-%cF^T(QFB_ldSYhT@6sD@K38{9jEu?t7SO1 zyi9Q>Nm`;?Ti&Nd$IG_z{`^&#Pn5^+GA7aczJ}$&Cs!S^Tg&mn+JpfnX!PtrCt?>= z>dJxdyT?>%k(r_9pps?$T9uXX=`6G*YhTg)Ref^=vcb)<9xx6BWGZz(7Dui`FW&Js ztfd}`ZNBLRYJC~KnG&hYcFPuHBig<7XjPBPbXc zd@jITwVY95Yd8SgS87ZWq&gYA7goU_0PI!T9LZ1;fzkl|@FAW*4s?a8f;3<{d{p4= z2}}<{QYqCd`9Gx z1bW4uDT)7Vah`Lyxt)Ee1w`SvIDXvoQ=&q;!nBkX@YuM17UD|ORPn(2TqJ`0&Q1%- z!8yj#e4=73JiUOg_D95xAp1N4UebVev~Tv^-(FR zS}D(0F^#ALHmWcmqP7gojp4CR2o}&8+$3f2=?sn^2rbc8P%m`LhcMgK`oK#dm*auf0YE zkuk#wRAf>>h0-De=Pd|GdsXM9qA?m=ja8x2t-5-0}`M?E=q2ic|3GpLl>x@pX6s@@ibOg7Bb)1v0OEXzJ34O74&?dV8<2Es*BlnC@RTqJ`db@9^bq)s+orJ8eV-OWud~Z-cg9g{h zA%dPj^T5M(2veLn%jt`Wp4NQU@BHJWEMCDZ} z*Cz0$E8rE3@FFhQ=i`@|g#rCZj9=}!Ma z*pF*B<%y!gMNCnS8*eTGUcnS z7n%d8h(O2-A3UlGvm3NiUH`&E&Dv|u9m%Xv=aD9o*rJD;JvLcQ;@4VF zx{EJve9vV^TyCr~JJmsyU$#8K3J_X)Fp%qLJcuJ%(71H2g^Anc&z;!$@mw58D!T3Q z{+XBV7tnhw=z>+=U|GPy@Qis>#=IH?78RZS(!6nWSBD*N{)snFZo4ma6vY@{NSwb%D`G?yf@Mc~>b!Nt-DQGP)=R$>g1iK&U#}_!1WmI9eP)POA{?R%rDX-3#T%fXj#=+hqaQDo z`CWsY;$DhD9O}zwR>-q-u4`oSZt80U^LV4;0NVNVMj`b4U|?lJvM={q(T_U7YkFJ7-dZ$1(h=*Q!`w39-OAfmtmvb$%|35V~`o z4hr-KPFR2M3}7dS830bGFNEzhHt|Yy4+59eRRqx_Y8J58rj17sbC*JN0%i;yut2zo zD@E?kR9x(%;$~?5*Ixv^!i{+seV*60+JTCa><&RR=u%Ai*TX!{H5`&`&1_T_uF@Vb zJJqHlVJq>~V^h(w!=Pp@)5>=75V40Edfu$9JcXo$hUeV9U2#jbWzE+bNwQ|Dvy0dg zGyTl6&DPC0j08o!A&5Vhw7_g#~ugp-Y+u&6g8M+1(!vFlAkQT!pW~^;XEK z!}hAGr1r(;WT)Ibp0zOZ!gJf;WGyI0N0`)VZ(%jB#FqnfSj(YEJ9z^(`{IXfI28&E z)_iGfnof_8QLHQMUkuQ2Lmpl59gOk)a$7Y`$BLEfI+_t~T~hR#MviV7qn+)VVmHNt z&f!&DRJFY?EbkZj??SPGzkLMVNOdRInvKu;YY+vIzm#u?z%oTNDK}n+UtjG|S5_K6 z-({K}t^r<7GzNb*e}y<1n+(o~LF+W5@=378UfVwjj`2E6?(iGO)CZGk?K6EwHhL9qMFMBTX%d5pwr|*8nH~F0iO+X%5>W`V;5sT|MNr4y(O>hk_mr}({EApYHqM8Q(ciS_^UXCG z8p~TcXizZ~se7aymTK_k(_b4TAegA$EUC~F?HGBP#&ndVZQ}|m8TWSVvyyPEm@IY%)zsk6!?z2?G)&V{ifs=t&TI3Z?>I8axr}C9EkIF;thMi_2cOBOF?^^7nvcS z7Ky5tU2M>GsaERIjTY>3!(sB5Cz~3WyOO3nrYOjgTmE%i{keGvNgTXr#k%0TI-12b zHH^<7`EWJ!^;4v2dp|^XUmf!U&kr}8-5xR!KWn&tpB>CLBfKpyj3jq_9b|f09VBh6 z?v6g-jPrCc7yjWXb%$}vIUOl~$J6OV=mS*7`9_UpJJ@Bu@%)to7tr?UQb#X`?ShX> z5WBa~KsV$y^iv|{YWQ{{!I)TsUo~2L|0Q$CcvOa7SfFvZtf=xFhW=5vGsHQTAQh?y zW?nTGx^H&x3(R_Uq(3?u+#O$X56m_*eS&UFjWeVx&VE~OLO8e2yyLfg_$@WGi^M}+ z#C@IM+uAoo`TGU$rB}Q$JVm5`M;iYo5B?w{SQ(iA$rA z)j{;S*WTO*u@zE4qS%nbUzGln)dAdO58Qsmb_*`JpYU$Kl2|(ldkfkU4NJ5n;d9bY znXv)18v{I^3&*|J->>gqmp^!&MQ*K+Zl>Bd8@w~JdZ{pR@}v<{9|8y3&w%SF=LZzIq6>$}(D`$PR( zzwEY0Kix}{{WtfQ-SzGdAJ6I2d&|q|!-aNp`ixqx);5PCdlG1W{eJe* z;rVd(f#GbMlco7mt3p%o&%?>f^$%L-%-9`#dtz2%v950RM7^9xW|`S)ebK2h;fnNj zj@7zkC)6U%G>1rt($ch~q?`*i@~HwdX;HZt#xs-BmQcfy75*q1q4-yRhFo-^p1id( zC-u+jVo1)>_z2f>>CDh5gbyQ5WJo{LqzjuP6SYE$QtCU8>XuMNog?lD9)UurIp^kD z*0Ca*VO~2`u60+(Z$D1S(n9Xp>yoGJ3nr77iMSGf{k8saBUo%je#j-4g%alrC@qRUIFINcedazaE%+Xpd?@UVS6drz z>hx1VE(>&s1i~u+>>wAW9(T}_4Kf5y5aZ6pD}@%HNr)||JW8&hPMOd1{`V-;mayxV>?lzF*dp}mLP*)$rH-5>!M$pn8 zu0;PC6(`y}!;Q()$R&I8xmOk~iXfmZ=?n8q3zvOJ3|CRszJl^fC5@yR(K@TEV>I`X zrjH`nZ=bDCo8}$zO9agmjxXtVk=alcZnJSOb}_!($+;F`L;he#KaIEYsMdbgv|29k zd{qXtS`plwlTMWS;w<}nJ#Cd8a-(ynN0e-1%M|E~X1e>z!Vs8kl$|=n-cQ4GC2wBM za6aS(l6MX;ULS&0juUZMcdk9rV{(VkQ(pKHly$9bGdyrB`hA1+MAyL8;|?M06WDNM zaaZ&}yaZrqz{gS8$I`90KOsV8x+Ne64}CgUJoiw;3fBSY=s8r1?_`q?`&7&KI=1fa$*yt&=arG8ZL%I zHc=4efNot=BL&Hy2{zMF`DK(861w~(kXS@mGvM#!)2&3Pw=UuIKcd~b;xODMK(k@{ z7XG8Hre@fa94N|`sAt`S0C}a&a8UIgPxfHGTU{t`ucUP!h8xW8 zlRyj5Un2M(h~_ffgs4`j)5y!UOj#(CaOIPVr#@haq>fz@(IJ%(hChG6Bvu;{8A;oM zL*_27Lz5zanc|OBf$Nvcwdoy)XN1bHg29*zP=hUOpkmvb6KxR1wQ5J9>i z2?v5nc(PcfoFvHAzW{L^IUAzREseX4t6BZwZ~*1W3hIg9qKnbhOxLNEr=XAaYQgtY4fVjsaR0Q%gM ze!}`bqB=o_5`y*xM;A9;fzHXmn4Sb22pc3$U_XKe6%Q;#F5ZD5G&y&Mn6QzA$}Q)RtyFU$IW54oejQLuYUU; z?$j+h*8DZYfN4_s+7(pfVg+LrDf1~w>eoc*Mh0o*KvwSW6_Tvd zTv{^-e(`1k0a$yQErU@L-{GP=6+%q*azhs-YOxW2^o?RbaSSYrh;-kYz;;>&-H&s3 zT6#0UT_B5WeLR?&bC=X=bOy0!d@De;EUtSqPn0#c7F=}r!er-vmj;9s%+J@C-hXdWcMesIZ0f4+;sGuNJ@}bK06k<@8faW4ea3B(2 ziQmRRbc9wf?jGJ^xP8fwGY+)dU@!IFT257VnPk%tfwxhrd}R?pFx zwLL%{XxSkPhF#tCnT}^Bu%D`w<68Meh`bB#%OoQl2EP%@K@8%)$yib$zd!YE@_r^hau&%>fjc0b(oEB{Zm}%4mEF4ky zS~Z$UY{2SywiOTvO$AAULzX2jJtwHhU6#)L*UtRkberKhd@{<|q_m8Icbxp~Q~c`q zJowmdkA=s@e~4iBYVX~g3Z(E7vh43e*kPBV5i(|$x2JBnDBPz*mW|5(gghT!#y;=r z1e=$3dE6`Eo!3UL%PV3vqAX2<7rU9cd&&@yfww2_l=6}TNVW$VruGU2U<`xO)b!bt ztB0^9iZO`x*d_^YN9IlGQ`bxG?Oy3rhgGKEtf z=ss!hs+$PNCZh*a<+On1wka_k3Ln$QK5-fzmY<1(Qm?9Jo&+!|FNVsMP!PoXrddVw zYjqp0s788*(Wb+Ykfld9L}T%D;)ft8t%un1GOXy`8n=x=w-hvZY8TvxuAoW6v;IKr z7f!SihI<{*?l;6bo;6cady(R$kZEMB_2BF*TOi+}4e|-)<)hFp#Fd}7XmO&D+yXZ8 zqMxChGGc^e2G7u%ZuSdGY%91hzYcijmv9J#zJNrPTlv8>P!1O&j3yp)m_>S8!3Dtk zbQ0=hW82}cZX(BLBZx)ObZtAy)xA@}(=7B;Tvw<1 z9)QBuJi@2GrOqYWs?%@X-;}IWxeDj~i}Q18^n22z&Yrq8k~2=3Iu;ZMihxd4Mc*B~ zMT^fm(F8j7G=g*3#-bUdW8^JoBGv*@@HwItc30J=|3$LMrPVyxN0f-4hYF+0#4m9+ zWQO3k>pGkcR{Q{;Y8J3{cu~P>_-I2gFFyiuak`3|axPbWhJ`Ji6Uk0OYT{RQV$p)fjVylW+qJ6*!-AC-Rem^>BbMsX!0~T7#UZ8l z)hFF{5e@kGm9I)e5;-|GfsA8P#P3(GvYQc-1WSk&n)oLgL*|6^Zsu!0`5?e@hvx#0 zJ(J^1^C_(ZxO$C3t*6rB*Oa0fl(fq7985Ax&+8F}kd?v%^OX6qdWJoefjUQZlSK`^&29*5FNY53*^is^BC8uh{*%#ZR zhG^!K=P%-2OSxwsER{s#sR$n`+2%-oq0m8AF?gLiSqX-<7#`1K&wy2Yxgm26C;B4P&rZri z>M%kGKv>3VfZmzQ^S7yR?)6BlCt`@>??ZDco`zH+E&d+p>n;wHz%Qj`w%Uj{|8t0x zlWnnaa7@~1EHT6AGmBA0Nq1{3+hDDD#c_gWuLXfrD9Phu;P~q5QgK$=_ELDid6h_O zZR*|g$HgthvOu<@u8?X$k>J`*-@VBYyf;Hbu->Gwgg$R(^otOhcoiD`H$9nt&Ipf@E0VF4{EIPRH-Dj$8nmY=XuHc zY`%(v%KA)I{~FkcsBz%R38R_mB(QY566eR@Y1qY9+s?H;_rB_Vti2-Z_R{sReOw7b z{DxF=F8M%AD}aru*=l|-tNY3OvOw{)6Gyd?ZML{YPwCmx-DK6ZQymX{#HCAR+22uu zt*xutI1`p~CE5QhbB$R!NZQ_{v`{*kaisAc04VU+2S=)Z`r*D=pdIB3Z;Z9@vP%|y z(frB2k%{Uhq%VTBtC0-4T%U^rfz4>8I=MEwikpECWERJJKGMyqZL;Hj(S-w{kB{S{ zNSn#w2QERR9X_)OLaQ#O$e}pZTPViB;IA`^g@ofXX{iZjRx(Tubvc75_NBbjiPF zXmMTuz7)WZ%}RF~9Z}c+HhuQaEm2$hZ;`3Ld<)Es>@5GVGXVb5z-lltGX9$aVx|u< z_Mf8b|58BA{#U2NKdt-c0^$$NHZ9YiBJO`q!D0VH$NU#M^S3UD|CfD&jp0vEz#mF@ z2Kv7T05LMN(=z-Svct>(_^X)s|C}!TcLA}Xi@u@FZ~ugeu9bm>sg?16k;()9|5Ew? zMj+1qr}q1w>oM5>1PuQU4zmA=c>M$7-X|5tq6dw-<+h zln|RHTWa+cCq>joT2Sq)Yw$=dL#yLG*I^W(C9sy(vG+HEkR2INXtzWk$Y7ssL`Y+On*&Ukn-|;y z50$CiwYIRw;E_r;V5lpmVC#yy62x)|=*~|!jvMVWD?JdORU3+Jrso<%XG=FoX`$Ip z6Vm_%JX|2I;P&`?q}>+DY4i>o7G>YS*jP@UR3b!Mti|5Z34<2V`6>0re9+MluCVQp z3k<r1r4-x#I^j>Z-ETh}%mvGg1ba|NMz;szZ8S9Yq?D*&CWH@rW^x#u5Ue2u< z^hy-zJ%D6TR?TfrP$H<6AU;g;C1JD@$+H2=>mGn#c3&<_zZReViBy zMNlJ8?mS~l(*kHOsm+v|t>^W~N_=_+6}dbBtT0@Iq|sv~XF04@!3I;O@&vYUm%6KH ze}gIRZBU=(ZmMZYj|Hvt5=35L#a|bFnjcfMdS!e)657 zK9*gaahz=~97qQxHRG4E1r`2F~^^4MC*P zT5$`dvLlhKT|lOh(>j+%Zl%o4Qaa%HY$z!0J`!{#lk#&fb|iX1|9F4}^JtkYg5-ne z8CA-!Vwfh<>zgr&ix6Fscu&&~Uz-_LN?zF+x$xm*X8*2GJ&N$4Jae_yI^vft^1Qq@ zYXzf-470`b#(v*Y`T);^cXjnalm$Rn1V_WzH% zw~UHw+t#�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

    P!@r_Ri{wcC~G8o`hW!Be1@(;ErnNF|zrS z2LC+diw_>HNW$Phax3!I(EPv6ucC&5K{SquX2i?caVHTa5@E*>TrP%-m!7c&#IfAW z3RIzHSi*tT*cN~_%7G%!L1t71#)g5on04GxArKtgexsyhsCtb+O40-#>0e|KzJi!l zudFF7hcQK7A*=*e9`lel&gyyX=ReVAa?J7;ip6x$^%pegf1`O8DqM`S`hVolzhImn z3dX($&pfIpQc_8%J7RhqV>RtK$aeFkUxw*&Y}a~ERpCLnEarC#I0^8W5qV?*z@o9odIjDuw_41wS!_(iC6oE2-D6vs1> z^*4)W4AFjKghpB|hX`pw`3LsyfBcH}n}DtXNJi`c@23ov2ntOX*U^!0Kbisj_+*mL zzlZ#3F%Oh{CwsNU&-c-;dJb5|E&$_Kt((F^I0MjPD65lZjaD`Xrb0p z$Nm=glbDdnCUZZSu~hEP&;4w_M)uEO!AL>*22xn;SHC_q0@uNjsQM2xhbVKu`~HgQ zfll2vmS)#!!68JB=-`u8ZvdaF~QnCr!lGF(INY{hlUCYQT7w+50EU79gTYhT4bN) z2dQ#)8-E^u(40i=REMe5CI0!5J?T{LbDYKL@kx-@y)a3r1#M($-&iK4ad2G%S3c}U zpEiCB$Yqi|)WhplFXy6wsz6|)&(6AtO7t*F4Qi-wC0@>yMYlDKv3z%QQ>@&$Yr@iP zKdP?(l165K)Pi`gW_9P&Fm;Q2_$qC&J~{#J0Gvqpyhfj*)^~~lJu$iBzTDYXV5yD0 zE=ux&PP<4=@8U`Rp*EdnbL*#R9*HQCz+k*!A`F0qr00=ySKYG4bd9T2%OLJ#2(rh1>0;p_0x7whlka&i?bwR& zlGm4Cqhz~`jIFVQdy8m2iqt(DoA|i5diF9$&Dw9C=!y(!!?XVRyEexf3bQdojl*fb z#Zy;y!DG}r@}tP=6^+m#ZpCvmh6w4fV3UBei7)9)>BL*5SW_#^O16=SOoTC<>QEd^ zuXF>nhT<-;pr()njjL?(e9c6~3%&Vsk65o5|GO>Pc5u9_kI~Hzh>5DlHDfk2lt8N~ z{9(pkTJ>N;=Gg&_*A=r+&;x#I!sReQyUTIKo>m%p7V?zaH4$-6i(-~|x6fU>OQ+=b zYrGqxssrkEogLPLUd@8}KE}XR<^q56l)0S>fRB|HdzrPRY9t%;LC?Cvn0$>Bx)bgS zg)~1X8sT)&SKr^&+Mvn(M5BY^uCi?H*g?A^-5!%-_*hXsuRmVsi#*jL!T{y>{^qt9 zplj>KVo}FUPNutN92{B}31U%>F!8{6zqnL;&e#>)eYzAbHz)a3(y( z$K&3-ZQm9>!7-y-b>Z&S=H9V8LNs!g#eGxJx(;kR(H0unKTiiP^tVy0vxAJ}R&`it z+9+;2ps#Apte?ig+bF!%(-#8}KGOl(&FU{L?A~6CvoQNkq(=80QKH5T6c=cMsx13c zw02fvsXlWKZTvJ(opl8*LD_PfvBG|% zS}bN-Snd79LCDkr_du|vMjJXyL@*bUY~R9uV=*w75elLU z)n(3hwQHw{^a0$xM>g1nE(x8C(cB3>nv@;e>FTIl9Z?DgCgcuRBhG*v6S8^LF+N-rK$)aqHdLbN?mg?B$)>_w2 z@hihM zw!PG42Z1!#WH7NO9A2Hk*P{9gMYL-yArd}4EEjc{AD@Q!3D#i&-v|~ghsow^Br>Ec z$O3PpqoaHn8Dm94t~4FN6j7=~%7IdO_fS6)X>>f45?e%tnTM%aDJU`2*hsvzSH!=G z3^&qmg&XP`(_B545{jNcQ~7&K$mXf@TIL9wM@#!X`bA9k-2^pQ>oKnDs0Ayj2U|fp zu;cCNuzSiN?CpZ}E}1mj4zpVJBJ|l+gsX{Y?L4wi6Ik+b%(HUv=kI4BZHcz)uns(t z)L8G}2uu!#wx}UaLNCamx&Y!$;n=OC*PdS#5$iUuRTz|A7XmCR`_N}{ugk>YehTC-!?2({&_;>u$t@E9&Cfr$bHeoF&!?5h$rD2$6Lha9RIO7Jg>smFE z;WVVOvCw|Jf^UVY?%H?4RzB3$Y|pMaJtATf{d%p>KwE(?(2$84!!{<;nA)QuJu_TkgXv8n1=C z>s2ZS+-VZ8c;Fz06k~B~T7p^UhdT^8@8+ixfkc|Q6)i`NGs)#&<+ZizA6~_aD#^(z znjkjT`Nn0Zw2uY!#8K%KfFfJ|OuTul!lD=`bX*s5?-{$vL^`z%hHazG`+f=mXS?kW z;HyBsJxGVgr{T*kJ}RSUk7s6<G-O{b%%n8IZr?Z)9lUZC@ z8|yyMZMM!_l(ww%kl@~TGGrk|^77ru#){w+aeAG}$;wUA_wIuSJ%yA-aYIy<9Pr1^ zjK7v)r*XX6&SrqjL8-E~w$YQ-@T)bKni~;~@kLzw?0tqeBo3ny0sT2#H?N?hOP_W7 z$jg5vNBNUN{lTW#IJnsU0X|v&(2e|sto|)I3d^6)ssGh&#`<@c)PK0mSpRN6`#0QX zfA0P34*sWs!GBYZ@@Kh!)bPK^QT{xszbg9&4*a`Y@858g{gE2=H%D301FFRgm z#8{CJegEKral-_^@A7R+JWM6MJQJxJXX*dW1J%54$R5uB;(@M&ozDmNHqQ@RqkinN zbz765>${KzLYNgv=4VUmmC*CQ@xX_B&-cgb+mq+!& zj_1SW!RtE@8~`c2{EY{`#N-UV%In{IS7!;l{Jz-w%+Or@;-mNGV)?wV#n{FBx{TD5 z{q#P8GXT}UL3$i#=;}t%`}OHj@tVcOI>@4d-;v?bp^=~a^(m%r(#vkakS%L_)!anG zu}VC%b*@6dMVv5dqlmMiKKp((I&#2uAQ)Nq`YvF5@&5YaBcEzM06I|^+F+#+eBQdhNdZ5QE30Qed+<2G zES#jjee}CW@pe8GE$~#$)RyhzS@M|x%d&r-D+0)@&?#DVhrSs!%yg73M^Vdl;I`bPQ>_OZX{Vliw=gYM1)*DQt&F?9hf@f+925z0K$ z)r3zeEbAd@NL6CrJ!C83SO}GJvuJPgp9BkfyaUArW^PLfSq#^DSSb>D!=5B%`EP8bIQbCY(q)PBr?V zl(kmW{&G5sRB;=!GeWZ$ytgn)0S-ytfhi%@_SSFBE62U`LvtZM*Q$%1MC6n$95IHq z+la)R19zRhm(F3yoyI-9bQ~P;< zp9Hjgo^%?hrx+HN(13h*9HxKz2_{;DVXr!sCcWq{;Tz{E`bNVu#Kaqrz$7LqNe7Dx zv-1u0w$aosm;^iiJ5rMr_;dD9uFwZgn%q126Zc0EBTWsyT5g_oas4s{14|B^3WhAS zYdlUo;vSJQ-HkK1i^Oa2=uaLKtUc-zu;QzYY%#9Ah6=C+H#GoLVb@Bcq65tx;`k4& zD95A86Q?6Pm(}AT_&yni5ETkD%;ry)9y#VQc5%=}wyFtvLu<#fT8?5p8Dj-#%1Y$m@O&p3-#O%p&wkA;xS}`miKVd!f-0Pw z!g%Mgf`j3k3WJC2J|dan9eoHB+dNMFXBQuf9_Ql=6mBcigbJ0=}=8L0) zolaB5I^Quvk@=B+eK;Vc0V>1NTK8)+kB1u=J#ME;8Z=xkE3+h;Tur4Wz>s!p9`w#Z zSEqxGruo)0=u8Ube$1vO)>bI3`yQDdk5RBI!`x-q$&h|Gi2BT>nblx+V&lq;0?w1w zTO;N{YT~j5^Q{JKhRcgL+c$+N#rG`egBTMds?!+<`&VCD%gT_4MD%{my+umOC{afEEf}leG84tk6Bf4Z=<<&&sFr3pwc!iHp z4Ndjz{M9wR8EmLMpd^2>D3QGgBV8ov*BsN%?* z_|iHkmd?_2@kS01**(VjUqk#EfO5ox%9b3X)2-10-{uuV@hHPK`)g45?6=`+gL;i3 zunWU$%yduu5}|b>5KE0M8b}!Mv53FR!vi7EHED6XXtj3S?b!J|Dp;eC&d2BbK$+bW zu`3={&K(&%ST?}KH)=q)r_^$vaLqOqUc^EToimlW1PFz22td=?7lIx~UnWT7@Z4dM z%&tBjcj_#x7rGr|$I9#AfroI&P5Sa6 z;(3UPfm|RxP$2P&`W&8^d!TbbH66XZgInG3w7sLU@btKw3+oqMB2aKpyIj!VJjGE! z`~xUrx+3UzoqJZkv(tKm6C!zl5=UduUJIT6`C~w#V70zZvWRU}5g1RAH3dRfNbRS9 z+M()VlSWjP1{)id4p#jr6)8XCA2A~MBLY;#D_|gbVHr7C6?U7SF=h_ zohy-)VNpW4Rnw33)IpNY7)U9~6#+VHJ9GAsu@TifW<&M(GcK~)XoU^W?v)SG7C(+} z@q=8@!_B38M-&}P6XD)UHD(4UrQGq#VKW84gbANE-10i2#C;l~T^Q>yp@lBpHc;R6 zY%DRekL)}}w11YJdP(*}ONHTdRGPRcZJ4pk(5hNSywrN4x5}bYwHjhuN0Q;v&MmK` zIFr>Hke454eCYSZXfu*sp>M9xvUe1$Fz>1`s;e)|jE%m~Do>+aaO^rW$8B%la6ylx z7Jx@^d2#TmFI;s|k(Y7$B1Xkg4C8@dgJeqb$6J-NkSmr3zvkP$0K?T%#lC8On$+Nr zIr8LAEDU3#Ph961G2aHC98H;vsU~o2?r}?Xqx1%~>6fVii&mgkLVotOP{2VIZ_g+QMasiaZE;T5(gAI&JqGc|?_T0J?oCHBXAY42?0g-Eq3uU| z_FZDDTX&C%0wDPK=Bll+7bpUfeWn<5z&GqFIi4FTnRl{D_&J3Ft{q~2-5Bjl1G#f( zLo_PvFSgd=R0D3Eq)KE*Q6nfQ$ig}DE6WdBW}%8G-!wJAF=KrTY<#Dda+I25<-&gz z!hhaQ#{R)*^lA6QUT}9`f=4`_np!zb*Jl;RERITdY_%nhM&oE}c(%PWlX*t^MLh2q z*+U1bj^046Wu_rK5Cm@z{rWOLy)6#>c|prL#h^wKct>+W%#n+J=V*;Z2A{}hh|pj^ zKVLL(Mzwp&^Iu{sFe;R^wL zd{68&<4I#RdL!c=c~2cZGU3!2D;`Q^oqNc&%P+kOaO#N*cnO~eCX^+9QdBtP((Cr! z69f#|E`qdJB%6QGe4RJ>4$lagC!@JUvWL&~+r+>jtlHGyaKD41uU;yozvkX@M5M$| zHC-xXj-vy~Rw#FNp7j?WdY_dPinPN1%vnC3UV*5=r4wHX@pnMH?-(aQ=J z`CFNhy4WEQHRUh@8U3>dGUHUJtVAbbzLzCxcI)kwx5@#-nKx=VN@KG~xvXxB)B*Zi z@dRFFI#e<-3W{|8nTMV{d_YJ^lfKc9VJ<}?)YKXrygqg9=7@ocEM#KN{VwSDy@n8m zI$t!5u6p9nJ8X-HZKhmX!);_7el-W+|E!TfE8r?3yhNM<@!6Ja8OTRl525u&eEFGt z|C17yTu`ka`X(64c?$1!Sn+7IzcocsTV@tq)qW@{npJ@ORf7%Sm?3L=5C>z2L8%iM z&?KeKONC9?@*{a)(6&Kl?a3d69qgPIsz<&WVTM@a_`ALQ+U%gY&JT{(?nBvV^|!?Q zxLb*qEC@EY;nu+*`t`lFG__{m{h{!gQ6n$^Bzo)66riGeRNuEHI=Q9ak#l5CDmCec z_dW1xJfvB*JTU6EUn@6A@%=@)d{GFG(W~?9MMLa8G5XXe=p1wm@a3l$BDuFTgrsr6 z0H^|kNsbQY6`$4@#%iWWlS(f&F0>_vM0il42xCIju>_S98Ox^CXFIRs9d9u9em0h> zs5CG#kTq=5l2WHc>~KNvQORX)Q|K^7nP3%7gD;@(7@vYAkHJgYIn=&AhYRMq;R%Xvr0 zmjc1Z+s4V>XZM5if5tfb z`ShMQBO_TWYur_}>Pu?=?s?7m<@Up|0PytBbEDGS)#2;CJ@^^=s}hJW!G2Y>o32~z zM`hr%u#Ie)JHTZ=(UFRn#dJ`-DSdUp`~*8TV@pQK8dNeFZD4Y6XxIol6M>8T5i`ju zmqP7mBMq-J1awFsLYM7{6a42p5AQwyOyJld%yz8ZI>_*j5SEvJ{iJ|A3@?_5(D&H( z+`$>v;+W$-Z4dh-I;f6fYQ9vy?_Qq#OBh_GJfK^iN}VGA-%a1|O8;?^I;oy(2C zgu+9tJf%B^dd)Z=#=5OVnFF$$(%XJA&MtSiR`ESTc5$6KW~6PB-;7ZlDbe7J8&L=R z@G{k|$!du;;)3b^T*>uHtLdxKP2-*WV?R*AyCf&vQT+Iptg55t>tRuFi#LJ&yL|&g z=mraHJA~sCqz*D8k17>u2WBilYm;SM~lQC;IJ#V`kv^7lRzr@3Ey1;~B?)GRU#~qucP`4024r(~SPxb-#^ne>(+< z=`VBIzosBD{WTT!PcHQry!ty_>R-v&|0i7P|Fo(7)4=xM8`hY98vy@}Q2qIy{SQLL z^p~se?+~i(4?^{@7j!ukWAj`{7vQH^Lew941U#m8l-4p86y6$XKd&HUGo0 zhCI7+4&8^z!LDJ z*I;33aIg2fPp{VNu(Rvb-OJtn;TLR7)dBg->#|+jbB{-wVCAuD7pG6(Bu0d#ir$g+VA4XptN4 zT)ZRj?-L(pH6s;bYNoO+ZD)H{T+X-W>$6nbMq-Qxm8@e`3p5_9`wm1=Egg+j)v`4E-OO5QAMq5bLm`WIO_63pH6XJ>(opMhTbDmyWsx!*%q)iyb)Ezxn$qUU!=z`>B6DkT9;Bhv z@uvJ5&rs?6P1kRAv9(5#ts}H;Fl@$L_$5qq2A#QgBkT)tZEzh=-)*sS`b;Q9gx z$Sz_(C@%@#!()LvX*opICZks~xz4%mFkZ8Knm*NtCg@gFweq4J!ivzG^lAwZ+ZkME zV52tD$O0;>9Jfy4Et4J%>;hOl+*D{+gqEpcHf)3OK-vD-fA-q%cTBmO2-meU!1fJN zg<)6aMGKl4Ik9WlNRGhO1avxw;94^%JEfFt0V)xEXO%d9#Gf?#o)8;ihH{CQ>yX~*0l2shB0Zg1LOy9m`eTm% z3|h`3-wy}f$Y$!nf-&!)UW+o8YM_< ztz6TZ9(94g$wcPE>YrQlF-%+CT+YIFUXFD>kW|-dG2qp^jmTkc`Rh(dNrvZs%!zXb zsWJ(MnaJje2?IDPFwyGN9x|{wWC0T;w=_A87vw8mc~@nT2{Pr)*8JR+zF0xd<;JIp z5Qpwsjz)1~QYGYc+<<+FdaTbqpUGj`8%ur(ovbE(yXSv0{08BaMdFth%Y8F2$t_gb z&wUB`b&xw|H=sK?%@Oaz5ivga!=EN>%P1@L5(on%$l271@ubcyYu_KR&uuUS!UiG> zLE_GBZ+5(SCV~@+|8&3L;rjZ7CYx}XJ}c)P!-OUky^|G2a=3e<@V5 zYPKi>YgE?jO9W2k8=Iq2S@49$Z`9$P4K+Im<0f*ieJT`&Mz#-J4J!?G<*c!-AL;{wUlMC3C&Q$7L2}qV8_q)SM{J!js&Y4dV@dACs zr0gX$<1ueLNHc@BRJjVw+RIEdq@ZUk&I&Qa+v1fdoTO*7=5_Cjo@M{Gj7fz8KZj5s zaT3!`>^7f`284UwAZk4YubOJ*6@N6b6#HFMG*327g_Wcyb;#n>_vPAP@&iX`vqVNK z$Tu7jysG(U`g~`Zv$lJII%E&G+|>JY@z&xvZaYnQr1mWEqms7wx(HR3f#clN8^5K? zD3{}s=|Sf6ODBWQ>Me}Lt{Nr*f2MPa->l|2T};8^zkASJa}=U~FOb=q6}q<|H; ziUCLAI$gK=O0T^ezyE!vOr#-B5nmQqLiIR@-oYRe3v&CyDA!T$bT{*qf+*d5aCmV@ z;YBTbUOj~BCcZb=bI?7>O4ax4j7Y*mx?ocz4}$z!U<-U3WzY&$EMQ<0h1x6#r^+9G zWH<_t4bVJ^Lb+C-(_Q|4^F?x+CFw0NXxT5xwjy;%mO<-_3+zcskv)Eeb(053Wg&M8 zb|Nu!wq`jXxvehc%30Pbi*ZqDl0{pRc{IIfS&#_QtJ>IchCyEtB>15cYZ>4nRYs80 z@YE&L_%MCpG7%(K5xLaqG#}1hU~A${RPDZ_$TBl}!>ciGq8K5kvZoTVQu(xDB@(%i zW-7QIWLupS7oM3BP~yfc?p<>hUx-~=%>MZ?=Rk=Ui zbo1A4(@SMG_I+>)Ilu28Q(fiW@%s4oQoT61){3s)->p?D>x^V4&|;~~TJ!O2sU$m5 zJc*vf=6k}CE2gamlRusCkQw_M8KwOMH?u4fhdR2{*^J1{3eu?2gueGC>38KGp@pGL zu>%puGBFXde|*qHi;kOykb(MQ(9T(52RNhLG?WyCIJmV5KC|xk(%Re#Hf)2^q+8*x zb&vDeWj_N(Z@hWMIRPtH&#SInl&z+<@@jH9xp!1j*MGMdk+h3PiJHzo8-h}Eh&2`A zMW2#(Ct7Lr`r>9Q2MhbrMR|4DIkbzFVmo;*U7cFl8$Iu!0bB}Y3-_bPiOc~>mj02R za!ZCI_<7!~Bzg9iDxG1X42P3e?X47nTXT9RNBLJ%w^FhH!5I* z^bA{WB*CX+Ji01x&upZ^?u0;8Pw$u#u@z*=4w9Kh4cifzlk*B#IudW9%xz9=sKmpb ztYdCQnd)(vgXWmnp*j`t&-8VitUpEybdga|Oq%Miemxe+y0NBSCh7+?DzRDZCc&_Y z$LlYk5u`a&$N}0@5^31H!U%Z!K)8^q}*zC}j+tnXA)$)eOm;zwq zV;feEXik5ED7CF1IH;K2U3YEp{DGy~s@FnbPOFI3J!oaaEQmVTUNQnQ2>JB|?`%!z zNcl?z+5o2^ZkvmQN>N)m`Y{-21G5PFeuZXIleLqs9h(z}j5wHL4>xtgLS_JhxH@LA zVhgy}SL|;IA_toa<;AeYf~8NU&4LrV0Jkc;6pz%7(-@j;5nCxY&sG+>%PUsrYu((< z%*}{noW)wbf@)C1%oyS*cfO$AD8$0>pZ?Y$2{Al~IO78fKfFj1_d2ZI`CMpxW$vpy zkE5i_*zf+#E;*}VtxPv0XS&^DQC<@ZM4PBbJx^g!lkC1~X#U1cWv6djb*P+j*!SVpPo)qmMSxbGh0Au4$CMmkS~h7*|-E3|0O z^myR@<&T_fA*6vZ=-gjSeTe%jkYdLevfrk2Fey@M?|>Qu|8R-Cp6724xz59S=gRH} z3bc&#An(Ktrpw@&8NL3r2$Ff^-*_ba(Ej=vo@*c+KK7|*#-8ja;hsz(Xno8WF&w;o zj2CgilTijX@3o7-#;=5c02LocRw){}EIC4>8XC_e;k9T>D$7{=X*1|E5Xg&)fau9{x>&|M^b+ zzO#RrM412b&-@(;zS9i*QE7j{(d|z1NQeoECeBC34+n%b%?}re6R>y!9yvyo&9iep zM7#W2eN;emq)X_|7U*+PbNC`7tzBJ8|28D2u=#)4E6FMYC;k^AVhzrJu znzb}v9=!Kr>kgXy8su@6gSX7pYXrpNt zF)ri5HWR@Q3rn2ftCT4&$2>sh!{wA#-T^=h(|Go9_MfZ9#JbE_lJ;Erc)nt+5)0vd zu3s$xy@*m@ECX@ADDfv58?uhs86|{gsg6ZGy8cMF$EMf?dP2RDpgmR=WY|tE>NS{ z*X`nesy_%1NJ1XzV6oUhKJ9e9<-u77(YE8B=32li%yf6oEj_|;?tAe{jZ18uSs*4r zWw_sDAzbsf5-eBUlL`Qb9%b^*f7{`;G;AQO(D)8JkJ2R+72Pwh0yYG07NI6P95>UG zg^}V$SfbZ7#g0L|H(rJDwGKdKQfRrxG$r2HT0W$p zS*=TVsWwtusx|HRbXq_>ncg&jFv@2>6Rq88bsHJVE^*uDCgwgJj($*^+r)H8EqGx#`U0aujGxnl*~oMr$QE`{9yt;)WDE zKDUzU0vIs~9`>G82r+nUMqD>&dwcEfLDCz=QZaM3IiGrAqYbLTGlH76OjFt^*cZM2 z0eo3Y8r5~i1~v3m6Y`@PmAWTVRu#DCU^=OoQ|(ZUR3nvw6e;KI3^JljwPX#GYv#^~ zSsoW@$~03bUx^h^huwk{PY$YP_zinz12%n`STTf|;#Bq34IlEMt-utReS6?WFcbRN z&k6p;bz`_NP;)qG0enpN?yf-khRSeNGYBe(HH3h5IILyi--4#htZ zEJq73YY&eN4~Gq>NwUIBWN90d_pfWVC=*(RUQ`7-_A;nK2(MIH6q@9CxH|=i+ZBGQ ziKX3=UJzK^jwNH1&hoL1XL}x`F7kVS(<-44?muHc;3OCfY1)rc`ifjGEPUUn72zJo_BuCD za*(*p(TK!a7uIbq`oJ+OkXS92bLD`)M!8cS;H&`#J)z8Umch7rNxGOh8SVlUPYQ9E z$&s?7F0HVj2~vZ6%}7NBs}x!XZ8p!5S{k27Bw06HATez(d$L90DqT)U^L3r zkG)JdvZLZp%e%l~KH*P`7Z^nv~DAi0lR6irE_Fl^_mm7yyRZ zMc-I+HBSH&Izne;%W>r{R!H;kjb~{OLX1vKRi9`BLR;P~Zl;(2fGyps_A6Tp@!Nh&`HA=IIy&4 zG@2ct0IpteKL5KY{3z8jjiL&jwVuAsp+)NjZj>SNgYGi839iru>!&Eo(%k@fGWcW^ zlkcQDbStEBAn3#X`n0G5jp#Wwi_1eq>!%8!=n?uU1C>yb5ropFs>xomgiUlxy9bkjMyYDwxRZ-XYKU&tZ!qf(?N8)xV*=HY{b#qm z^cMZrEQe+lb$R{$@kTxUaZ(p%6j|@>BmWv4+zx5-XP4bzomCvo&$#Y3%#cv=-w8Dv^-2sO{2OL_{D00+s)?VG0k|$2%M+s$J}bIS1{_KId-|&4 zWOuF1(*;TFqpDDjU=aIQGFJHl$})zyXa155b}ZATghh9l3%B`K-$m*}#*+ze%GO?ZY>IA*GSt8fXF@U~nGipT?muF|W+P_!1+TD%6H8-$ zr!aUB^(!^<7eGqbwLv2_O1sq@j+ujyWT;B=f^_?-)Cc9_O!Ksd4l2@tig0f$wy9vV zZf`t;&1!8YLk%jqHE#RV7}Ux5+Le*0&opoQL{t!%gG;y^o6)hRJyb>8R@*2ez|p=9A!z^8DaROmx@v z_wXe8dC$Xd-54;r)s^(HNAP5OfgOxd)6t7u0$a%23CJ;`yBAu~RcQk_0W^rxR#9>b zVi9VYJrF^3DLsTZnriN;J>lpgG*yUOW?1l0SQW`dF!XsiNkI5Odz_p+JKrt1;ty zUNqY8D(yG=DDsSF*v(%%Cpr8m@|L$S^Z9?VPW_W8~x1eY_zO@^p}5BE&XdH7V|$VvHrVt zzqi@7nEvCskA^4OkJ9x2`F#J_(Ecyi{Wc{0eU|apz{bC_jE|T4?<|AmFSzkHj0JzL z{jK=_Ut<{re;Fi1|88OWpEv$Lsm8w&qkm8hmcOXb|D9?`RAILub{>Bi3%VVh4q+jI zA9$9593k}=_~8WL{K*sb5#YDR2>tk`j#F}^kG2)5YZn#0z_<6m{veBNpet|kdwIEk zW99d>KYsfj*C+7faLCsj-jVxt$?vuCx%0jAx&GPt z<@`STK$mQy3m0NCHx2FO^th_6X?njzvj0?=7*|PJ>RDH+vea+lhtXzb@N5n?aTARlkI1dGWW-QPs%6t zI=f^PF#<@!*k|ilzSn#Fw%pk7I*kq(4G2CZ&t&eix_GImfmruO>!+cn^=J(fXpKqY z+TwVzJ+(haV}zG}2|KMsIRPjSc7M9i4Jk*<1}}J&Du)4nF|2M{h!LHdGacYcDF{>* zqRR+9{AN1~Y&EWr&gOdS6*L>0fehS&0X7^iqwI>b$v{JBb(@z=zkOU;J0 zq5lbU6p;f!k<}UnTfNmQMxh|&4qi zCHbX2;nj{eaG=C4+~~(|>_L6SkSP#yX9N!2?Jl^G&N3YN9?<$fsRa^WVa9CW@=u8L zAOsV(N_v0KsOm$E3V*`YhTVz@^d%tM;&^Ceh~ab{hXHY4rdiQ~d5jS{>*a{)FgRmG zOPXDkkDk%m7YB4Cs^O_t3BmcWu(d}cxTsLGF_`E>fpU}zHT5aNOk>XJ<_Yi4(vq%d zeQarFR$}2Si)K9pv~c&6L^lYPzw<}y33?VEOr$~Rd%7;@fHrdwK&x31`e~A*_uf0% zVdP)n=)|p$G-AcnMzfbf8BrI@oY3?%OMk_T=yWi{qhCa@1v$o72>Vh@<-y_CS_-qY2XO5D9E^=~#*5Ge62sXi6pjL{ z2pBY9D$@O;J{f-FXQ!42Sx0=80|fM{Hy|6FYo>j1G$ zF>ua*`KB)`@D+($u-oc{A>SRnolQ+NV$^fTwsaU!bwB8DRPJ4nWOnGlosQx&KnPP^ z^7$Aq_+lKfv>#JBlU2>fH(l{Q1EzBpTiIy8Nej-1R>t@{o4w+b>PJ)vHv46TW#`8= z>s#=m+aBN1W8KiTNA+89%az*fd4}3qYc=Bv+ybfdCOkoo^+=B=wp@hK8GhyZ9!Y= zoa?PShnfm6s_0e46o>vcyB($x@{FRmo-88BgN!-)ecKp`{R?8Uv^D7d_KG9p$-TG{yTJz0kNOfiRkKCcu@NI3U!9H1m4oUAQVuCQ$jkD`tF6vh zG_TpGmJkzr8aaE+lq4fK^V^e_i{&{(utkQt7o>g`oi!TKx z1jbd2$2l(%xf}Nu`PU|LNWOBaZB%IZ&AyyPstOM|>1xI~v#{CK7=;G)lkfos1aruBMC-2@K)gT@o2%J( z7(|VhdPl`@P-v^9cl!yMHyboCM0%jHH4z0tZE3II|n*RqwN_$&|p80Bo*gwod}1IL5zx%4gv{>Qwuv|pO~JHg0>gmLX!sR z#4B3y#j64R2Q7^3xXBODY^^QLq>!eN)P4C|BWg0)qLr!57m`?m{_=t?M7V&MjoNZJ zE@~It_GOf3ICt9qW^p#0uOcEC)YNcP-snkzTQoK7qKa9C!QN{yo+D4HX-MBP;)Eio z>whE*@|t961Jsj4dricCG60q!L`HA98f${l&WfXJ?D|;H6C!j)mCBa3P6s#)+na|Q ziOuHR`fw2?GSDN7oAOQ&PtA2JMd(ss;eFH?5XT`gjXjPCt)jwzAe=C$iY$MPQWrK7 z*yy-Vpf30>-w&asS6-RxPPwIEX~}%iciZ-bKshKdlqF}>C=WHpb2f1m>8pwfI%PIO zv3yNq=p_ylLZo`H$*|%YiWJe(8x`6un;C=tu99yB2XPjY7S|DdQK;^zO+NWAoMP|N zJVcf{C<`);aqZ2ytk}yoU!UfgtiY~7wan?D(7+V%&!&tm4NG3`c*!Oq;SzV+?+^Z~Oq)5h%&Fc@+M-dlbKeVn8 zH^G1h5Z`x?0g25aY}EH2V25K^^xwwNTf7+Fcff?@Uky7LGT$X=maP41Z9>?)j2%xo zw#Ba>-Yh?5ztLjoym*0q_gx)sUc&vQJH9>XivrZdWZo9kiCoiJZvguMr5vR8!}yIS zQ9K-SS{$iSiI%1}8PM~nrauRma1|^RqS0Lt6UxvotxY?Ru4;JKhCeZhoj*|kFqJ7B zHN&~08ZLq!Pim@WunsMwVb} zTA&hAdo`j%-G;oNua}!SE!Y;IsK&RpL|o4uhT6rbox{o0dBJZ8F=EZ9aEV;fsNxpREBesyLMKMjip*EiNg)yI8pc zL75eY%_n?GP0GAg12Tj+KTH5k!3j#T+)o;kyfS-)?;uQwpn`#-B$bo3mhFtcpDi~q zk6!MJ4QOZ<5&UZQj0>AzyXqfT+8a#%BNW+y4b2m?Jjk4zoJWUnhz!e4 zsO%h8yh4DvwjHjam|Td$noH`c)xP^(wQ>jT67hMqE(Gq!}&=Rxt&U&vK|UPDqU5JdJHPl2CL5 zG-*l~Vgv;dCmu}#9eR%b59rh#b5Vk`i#-(S( z5vm?t)^qDZ&Vj=}fuLJHX-$0IZn^zNRIjsbvvy!k7bD|pjkX;xSdmR}IwM{QB#GP% z94AQGDy#G!qI(20?X8#lz& z?GGlXB`&GNDV9htI9ih-L;<}0zGbr`$9~b zcNZJ3B42;Iucl*ObaYIH8?fJ#L51g!A@x-=^o)N)FzLBRrh=*(jDA)TI5}+!s%;Q0 zeI5(Y$M&RBztzdKxKmvYMT~8ORx%EDdkWs9KS6xN|bh0+8- zbF*YD`48xVix)8|+o--P#~iNN`g|-dqwJUEO)i5XvQSy*nk-A6la@SeygE(wV4-(<_2x=z zw|~?}S=~)gGXHkR8e#fcEOF(LGvS&P9NHC%8!s}kB*?On&bZJW6zW3#W^V4IhOdjt z59qGgM;$e3ajR-5MWV(d$(Rj`(snQ}l+#e}eEaTL7*LH%y`VVqnHW#K=T0V`oa7qm z;2S4$RuDT6+0Pft$ptOyV*MG3#{HEqinoOGXT}YTpNW zMY>6l?lv_sPjE?ho;S6j6m`HSuFDpjv?73|E_);?eA;&|y1z9RfTyv!MqlC^QHOAM z(v*j9oa;jeHIHFmyUBBYHI?6v3KM)-M=Go~nzxsg`q2#l1&OkoO{;^slBFKNZLj;J z=E4@HcEn;(z6XBk&a#r{Y5UEVEzFG>e8^_Qho;Z&RI`^O33o&ErrDp}R{r&~7$nUq zz~&Tyuxo>SW?mJeHM5QAU4j5UTdy{`c+rV1BRega)$J~9-m5Ef{O}@yWZ7IlkePN{ z@yS{;SNf!MKn^>d)_XY^>x?VPBX2!|)Yt==B_E{Ma5etOs!8bpYM96_T-OJ_6XF2U za;s8W4q=`+2S6-uEoc^g0#M(z zd#R7#W;7v@JJ5OLDb#s^826}U6Qb^k#)N0+3lr;i~=qL64r2S!!Fmu3>d=bse)-Xyq10-_o zjQA3se;@)*u0+2|Rg1#c23Pz=Ja4cq-cc>RvOY24P9Rt*K#T?VP%iTr7Nw-c9+rRl zz_ajkPui!1w0ppdKry5prx+G>5oUGnabo?+_@rgDwSRS(kg!?FP7*-K4l?#ztHb=2AREBB>!<(8_A?j&Mi4z86boDVDn}_ftg%HBo^C!h#mtMsMmWF%e zn-(PfJ2a}wlM)`ujaGkHiT#?~uk{x+SP}WqdHO=!8Csyct2tjE;DZ>H}GAt z!tW&qdo3VlzA6*sb4^d~^D&A?+uy%myK~=?OPpMU(AA-Uk(&hcwy4f_^c6zOS&7?k z?np=Ac?mK0_w!xihLj{dx%7^)ZmI$rDRWf6wGtAts&xlo6J-9lY!z3T&rRQHLYG$D z@pJVcb+MA~=2TGh+XzT{m)PF!`WPLL&FnqV8ZsJsSX3HG9DI;aePQRu1I)CI{Q8pp zQ*`bZZPt}J-B<$}0w?g6f43a@_I@~F=O(v3(DgWK(7|^1mnmkKz|7-9no7fkjXh6K zoUP1aC3{Sd1<7|FTjJ$m*4k)m;$sXCjF#hS5BpitdiEP8p#0_#WHyidg9=b?duCxk zFyT40CF3@jYNkn7Nac*Qy06`eZCyRJ54J46G~745I$rB0 z2(cE>>S?m^F!}bZkj!2NRnkTOes`NG)Ks0Eu%`le+)8lO=YSPgK=TzVM zXZs1red&X>(Lih6Cz;L|?w(mP=dL%t^Ud|_#68=r3*ro>#K8(g{|Sb=ugx6S(F0jN zYs)Y|B>Jm|W{VMT?UpcI^F!M`(hE&{?hJ(us!FM|85RdFg$$ScTeq7wMxT4!jvnCp zZ_-^>^A6KJz0!C+HWulbR|T^03ZD@->AiX&*@zFvo-rTa-losq z-zsS||G>@vCwTso0{%e^S?F2+r5KClH<%aJ15%`N(yDt2-yKMX?yUzA^tLMW%Cd{VZZnbWw z*O&G9;4fM~%x&dNtD%1P_{|%=jegp`M_7J5FQ=hL_h?{VLCdf2qEOputP<|rxq7=p zxua?dX5~|gSOCfik;oF;AD8QXc)k{2vwwZd-fCwkGl=}knh)|_>#1!}S&$h|-p+cI z|5BMhn%?7+3&v&rSBK&ZdJ4wF%wi5WCB|gw8X#rL0hGFyz3PFm64+B=&(9y(N2J@FFAm92vuGtXyd_qaT(Y)`aiK-ef1QcH%K$(C|GKaQ;Brw+_A2NJA zY6W(X)`)RL3%92r6CvaHSFQwN6Laz@Bl!lFd<)W9jRy|HgJ^EJ4hhsCrox@YjSi@2ji^)axb{{hnw4rJ7l%mL+zhcUG-r&uM2PU^RCscp3{$}Wj3!Z zPagwjZ^}NeryG{1#sywOZk53j3s-oJ+&ySO4D{bbnzMeo3+45cJj6S~tb2%cf9e7e zizqF?FxcCm1{IY|!yi*Ya?B^WXgCpjy0oII`!1FD3kpd*K~r1=x(jj)wHbdH6{wtn z+@QS1^$R1hffPR@feSFsG4xfM3e*b`Us7Ma!PN}a%=gC&hfkOTp2p5j6+0YN4UCN< zX56(5i;DA#>a;hcN(V-fWh(C@B2so=PJk~!%m5>8TevtA7-bLa0V52e9YGnI z_FMq`NKwLH1%VDZd00@SD@guGC+uISt$UQQZfapShM&ogT*34!(<|ngv~#;-TsBYw zc?sX-@kbAVNB3W)t$j!up%;t-?|`4vfg*3?zhL+1K|d@ZfF!Jc7Q^}yVgc&_^YhCF zo4t7hM<`7icpP%mri|w1-R+9{{F!1~l{UWRuBPLuz6=vrEJ}2($tZ63CnqFZe|3ll zu%k~SOPKcsHI+TvJt^3e@cmfVd_z?H?0Dfep1PTV968tkY2W7iD5LONKfWfrz4%Z9|a3Clr1-dF`JK{`PMU=;RBW{zB{ znM{mD3xx|J8@SVS;mVmHX@VcGLVVEz8G?LnGrZPOuUUe(K^i|@3Fr?YC^_%Ptz1US z2=ito)NwbSkJys9~$cw3zUOXTjGSt`)5|6C+HYM2k6H>$R)ys{0+u@CT}cN%~`i} z8h^%@Bsw)zAwMfDaB|TULQ$yQv~RKEBuXNX{OW>#}^Y7yDf3cTW&%c#j&9! zo}j|3eByPzBo@*7R=rrn`n{LUin7dP?7z|{O>8fsD1kJ2>2%tx=vJ!%bgN-C5Ual1 z9*3(+N6-#!{gN?yAdQy5$;`d1))=nVdZ!9z<EX2j$;Xq(b0g=XeOWFKWW^42B@M>kBYf-b`@d4o74x*O->K5GUc^)z?bO zec2=gpK0w5?MT8R0}| z@r0PX`ulk>EQ+N8IqBSi0*oKTdQEU12dE7@+^EKC+cx^^g@5F(11GJP=Uz<%7RC$M z5(H>;kDEOo#_^{3g)*O97#7h|$kD1!fFKj^e? z?G>Qac{vdDrzB!J``y`b^GU_EpRT83cuvv_$#M~yisJNL967`--u_JSeJq-BszIyl zb|Q5ztAz`|Cb!8fyQVg%@p0*wTR3SUaw>RwN-i*LbF1z>Np7)D9vcP%`bF~Yn>lES zP7-wK0l$t@IzPB=zp++SrS^DCnMJ|0eJT;1PZM8-K*-{qccIyxS81shxpp zF|a1DK#Gwd_Ko^(2B8O)D7blc^hMYysv>XUe$SS;^8^p_)ZAxR_zs~s6uFO?Z$oD# z1$~>9G>?Q7_T7R<41Au2r?dj@<_Mf3*NY>`5GFP(mmHi*kGtEf5XflMnsYgcXgQ6F ziKU+yuWe`5&}$O~g;}WxK;KhA%WC9pue;9?EYJ2j#zCx7+FkagR2>p14^z_HQBCam znn%cUkOh6n$LJyyH6ZbE$2~`pc2lBdX0+9&3TH~7#Buk~xyhT4&gM~E7T0}&37qM>}NmXz`y|HhW z_IiRi+z3#cu2#S=3w_X2P8G;sG*s?8M|%iE!eeP8=&vd%dG#~_bfm9yYx#mIDWeX% zj;T4afJ1CHL<8v=SXcm+Tq-4E=UT<>{yr5_Q!LC2%z&tk{Y+b07mYP}w5z_LWBGM? z-K|DzbG|UwRVUDST$=Gq%D&A(%giL~tXJFl2wf4AhNLZ*mDiHz3hpnRU*|CgSc3-G z65t_4*4MV_S5-qm0GHs)?5R(BkRp%=YrdJ(_R*+~!w4DOYV4aD1lpaxx!MhvqfW_) zhk*uK|(ERJtI&oNGkLxtOU82 zL95{Pd}YE<40#vA$Qmtkh%|_m?n@!ApXBZ(0u#I!>C?MYQMi!VtHpn%2Hk)G?RQe_ z4gjDEcZyb{IoI<#$Q`T&=FSy`I&yfDD$b`_O#Mq-u9aVW8V2#~8XBRxS}hde`p#dv zR%aT)oX%xApdY!vr3Z0-pGWJm*RA`#XW z75&DLUP5Lt=jdEi^>tWNkvjiPGbJ-jRl=G^Wyf)sQ;fqFYK%$h*H(4$lA34vy^{09 z71gQ|<9GZUQ?;pvHo$ITU5fjJ_9;eZ!A=$@bm6?0Q;z*9%`Wgwa(g@|4Ym>vI!v7z zH1U`@T4gNz>*WEk;+$@k#?QIZcpJ~3Q*~F!j(EVm46F?rwi**&pP-+Fc{4@i*DBAD zVWl?7U|JEWGH}dBuPACB$_lA8N(8eqY6WE|q}wJ;0Hp9^9PzasPo6Pr;*zVlIJQNF zBl4^XfZ14zW`!v$){oA-Ck9fGQQ2@8W8^0JBmRvfjV#khHX;h9&um`zMr{JL>(!0R zVW3#Ln!toZ;EH?zu~k6wy1gP8=_ATDAL%$k$)YI@B0`+Z*eHTk7VQWW@#+;TPZ612 zX-YTsMgT%mP!{a*@|Q7#BZTIoUk@2OLbiR4i(5#|%Z;mzukKBu(STP3TQ{iTUfX3> zn`PkdB65%~wpY8Z^kmp>n z8{3+yxXaR0=7TaucnFOrpU{W4oWUf~um~er469nkDlYCN^@$$Ell#Dmb`OIX$Z}ri+bAygVYsXzUb3EhpVz*AAC%X$u6CYF(boT#Hmr z6(*K)k6KW_sj9a^gy^kzLXeE1%iIxV`)oO~YhtIyH5GITW7V-Uc7p>-cw$&(g&_``=nHsMg|cyoA>o`Va9 zSs?^-D7glh?zzE}g2TE!ZVjq8Uu`#iAHgLAEv!yk6w)wcg^v4A~17l+gTQfZy6B|PlM?F)Q z|3%$f21UAM`ySuwnxVyW%TjB2R?uEO%Ls3Yf!#UmOcK7{v%=Dcv zcjgO`1i6yjJKl_V_mjV8t#5{ZJjLN(W^uFq@qYhxU;ZCv%d!1EEceeKh3yag^Uro5 z+u!^7{0AWA&)UD|K7CcKh4qox!gb2p!soy{CTM<{PSqJKez0!CH@yj zVf(v5`JZx>>FQ$#U+ai@9B9xA-GAii*faEMbp}R1@^q)kZKfjUF-Bfgb%j`!7}?Ga zLUDIh2DPV?_rtlIBz$<=FG2k5q*Ad>@@4cY`AUCZSg5JF&CAi zSMELE$veE={*wPyw=0*@SlSlA=&WYSgu%UU!?`1>||B0o#ocbIv`w%OWa z)5v_haIHhC5mV1<* zAd4Yt`Buz>=E?5Z&M31hJawSy_F-_^BK&v##_xzjGwFvHbud#_v~J)0;2J+_JC~V3 z`t5$V?|_NAspTh1Oui{{I~_xj#I2g>xh-A802QpEn55THTMVo)MwnR`dnZ_R1Je^LQ)n7{`Fx&O4KhS{ zvkT0m3XxWp;f8bRN49n)&=ROAy}0p#sbyooEzythDhR>-1LdKS+I=Odj~w-$%x?D8 zsfUt-8wS%yh)b@S5jwxi$ER}dQi|(YGVt50#HZSCh=UJh@{P{jBo|a#$&qfByj@f%TlmexslYSGEChh-JV^@Gg zu2x(y%Z6ujpkNQX=U1z*oOJ>Szs#+10y~KXBhj~~A!o+gc0hMT<0b^-?y6z-Qh}`q z_XFr~@0hn+1c%+YlzyCkVAtl%%&M_NP+br^VO&XwW`k+@CW!riJY@A(QEE^3O+m{V zT$E;-4v&|SPQ`@e?8a0RE3K18{$O*uU0>GFqxJ|a3?JPtVe1<)*)-3f7%84vs3czOgbra39fD5KBPt2@aU)RCk{WgSw;;J>ovUgE>}9O zh|&5I`g-o@7iirV^v|sf!VHU8akj)9Qqm}ey(2Ei1NvrPi&p)w#j$7DN}n2r@h(z{ z4KpnBNx5@UKiOM?X9q~xOFBCXWX4LR>-_pK>ZNc=0=|l0k;4X$?_$6D9jUv5_c!;s z4k-E6E{vM?n_55eBuFLCU}|Yz@5_i7y7Ga)ddLt(QRRGc`<&N50v|5Gz-O4* z*Ql><$Vj?t>h6EUV7h}O#q|XelP_C&??KP1AI;Uaj1x!jCL`Dhz++7R?NgHwCT*?s zZ%3bOb?N)@sJIgrazt&FJDC)u^34+_W^HF<>~_E&xFQXpmlI0@7}F`OW(_Fo;UYcX z#@1L!WtXI3-)0_LBqR=UUUO?c^8Z;%WhH0hevTiiFJ%Y_iz;AW#tFHiyb&YAijA0) ztO#N+&ABOKj7r8Ts7+$ke>6CWAdD%f4Lq#6{><=d7*5*oN;l3y^-$qk6XZyo28XvF zZdbKZMadup^X-=$bZ|*o)KwfR=Gr5cRKYTpA2FOaH-I@=xlAkm%*uFjRv3%3jnV9I zKMdGEP|xV7%~bb!btmycW;^63E+fGugCmTQtSJyVUpo!cDR*ov#M zIMsi*ZcYCvpjpbAbCKC%DP})#;>n1F>HyeyPNHT+XQtJ7Ip7t!DMh_X(JymAF;Ad zCnXO;H#I_HV+=@0kKJ7Revo-IEZtnCxY7i@_0`J`JG(aJMn>6sb|apEHY_r}v(X8Y zd>{*gY*inc3w^75<&d^V`KZivY^m5@k#W6dU5^QiNf?S78UHA&T;=lSJY;xNOA(}3sJV0p+{_J5Y?6&@uEo>l6K5kLOCo)K%TK|W_YNc zx@Y~Ts>%U21Vu0qK`70Gw33vu%Gp8OubmmZS*Y?hGFx5NV+8wHSQi{e{p&)@IDpqk zhfd7ruoXmou5+eU@`BoDpLQ|TBiCPaMPJ~+DoD4*l)tn^%_x@H z_Q$0xSdL9WK1`ZPAigpyGbz2=Xk(8%za_^}wHb)hV#auH?w2Nh+sD1-;XPWTpfx=H zVp^ttvL&)S)qdc9qMdKlsv|vTThWAR?9m zwpS#tMh3Ss^cr`LVwP5+ihzl(cH#z<;CK5Fm*Cxv2B{!sjkSq}(5_-2m^oGOoHN6n z(a~9B5mxCirb_%Z*&=wPa5457QA0?(LzFm?08}JzfW3~t`qv5}+n3#Id}89hY~)~m zvf#kFQDWg#2dziAa0`-o?#{Gl`m*%lyPtT}oBHHv9f2nsZu9|T2Z?FDtX@`42<*Fo zrkQFn!@&azP?jDqQXSB4H&c7=k)#|)-H!V$mg~Xg@~iG-XgXG60>so*M3R2Xtpgo{ zMjZs4x3gNJ`t7?$FqtlCPrM%;|B!5He$xDM-dGTc;JI>|i0g_)#zNHGeanze}Qs;A>8#-)XOA z_QZHpCbz0I`x4roZ_shp zCR@YwyqRlGS2&DeX1q4ovE(lyD2SNFUqXz3Ka)S-l)@DV8RQLfNaFM02T;nQ{upB^ zCiiNuep*?z^mGzyM88P4*>k@XDqjeNck4PRjO9baLHeQxyezX&s(M5auNuhNUa2Kf z29tE{mBv?oHfhL~va`~-<-W7)M4+#$RUF!m@E$r*#EQ~vZt9a7%Pib6?Te#PCdFg> z#6vj`Iu+6FYWFaayAJ6b&+j)dtbt69vcFU=f&uZZDq{MMyuX4xNY}ewbQnxGmNQk( zsbNp}iM)&${*4Emq6Rb7!{9NsBDnnM>Rz-IYhtBC)t%kNwNYLtr`qC3X?lKp%}d!! zx3TLxy!#Xf`g)_ZQLjm7P|iw?WT@j@I@aP9ex`ODF2*vtzhS|~{-*S$N5*Wj^Aho=3i!8M(#%v# zu!NsO7@^?&f31=X4ml!XE8QxP?0|kXAyP5vb^J0-$07?ROYX!@WGf925)GG{7p12WPm2I|?0L}`(bdbQ&iFZ9wvYh(MLU~r2y9IOqvK`pM{ zDOU&QP2Ps^1lfPeW#M!my+8s8>b zCK(}oo(fG%cXh>xY;DfXT8>}E8{>HPw^;bu@tkBl*K3j?&6D!xu@O6Nl+i&_K)8Cj z$e&w#K)PknjRvSENovR?b*Iv7`w2>J!?T!>&_1Q)=2Z8NmT;|b2<LFaFF^Llcaa)oR#s?ipV{B)>3g=%|$k<+s49Eaq5EfEBf8j z&&4Y_%<2=o^xz;MQRZU9@43W&y9ciC100_$B#X84ZAkG}l7p_b+cy|9l7C&eIa$MD zrYIhrUc>|I^?ag_K1DM!KmK+?`3{yuF|NU>O4^0w!T6&}ZxBX48x@O4eAvJN5!(z1 z(NEHC{>`0>oF8QM$PSDhLFz|EE|%h|1xI#}S@M;P614)U5dj5%BLP*`Eu^No33bw+u)U-`mxd>XB>X$?Fo1J zkXt?w2Q_BfQ?%m8_2*DcOt=)+N0#pjHW#QzHkUQ`;uu7#=-tC$0a{86#`7Zg>G5Oh z8a?)4SJAPukxCoH`CXyM>8cm4Au{X98n-e_cEr^cZ5UKw_e@IF;*bop`YAZD`ywvz zE6472sZ=$}QKB_ag6qk~FNBD+ANTEMk*%Wq7nMw<1LVvO2JS9^k52PP3;bU>Gh@}*8EMHb)f?o`7FviV3EcGvx=p82CRC;r zi;AS7H;|6y{uOCMObWBtyMMnY9_9*;OdN{KVpZ%ju^wwXN7s{dG2+v_m5(1RrjWv8 z?y!Ika5|oE`!*-1D}%Mdc4`CveK)%*UaES%T!^uKB%y=0yDtTJ&|-bGU;n12H+EL3 z%o;HK3Tt>^E=pEXE2pD0l53HpTiZvR_OpI&3rLL@jTDOTwH%|2B3@8Aty=7itPXbn zyr>t`PJ4>dsYXYdic&RKUN@SF3Vl9r#A(tp=praovp#g=8|KMK0aEFR^h($GIlW%LbYqyLM-MK-`8`Dx%Xn|dZJ{GS;{CNdK zH5>azpUe|A<`L+32e$wc-hUgQ%Z!;T+x`1)$AKs^d+Qf&p=Q|%LpR%}uiPQW=110K zn7RhI%J{*;YCf?08&4Aw;*Hs{&d|hOpI%@to$S84sq?<>2HI6j%$oJiA!nlq3Mopd zp%}@JP-Mq8ksy^=czCS9h}ST00uxH)?FyGZC;~@HQSA<;WR@K)28*zADcR|{7C|eK zrv{p{wp=(1@qB@<~{8kTda9$7hOAA%vwPgla`(7o#!5Pu)R#4 zmYd-v8zP_cu;Pc&@xqU`a_1YYP|Q|)$!W_Ohpr|yg6dk|NTi$;(hrx{qwnt)W_n-5 zWSe-J9CD*(YdRU36eQIF);ZbXF{K{L8;&!OfkK}~tc{`s-IjZF$W2@Go=kKARc$HAJ&gbd=$VZ_6O!x1o`k$=w4}!_c#QaYK2-*IE z?H{o}mVXobV`l@>G5pEV|J65V`zt*6Kdt-AQ~!@+e{BE8|7QR1{x|!7?tlMT`xnan zU#8XnXe9stmRtY1@V{|u?SC{E_;b(xTH}A=YW6?ADfnRg{|T=CTVwf0Ts_uZ$?v`d zJu(lDzPO+)MSi&cA6@ON{Dn>8raopL5^L7AOFtEi?DofNGWR&fn8yve*N2xq{Ti|*yKTc z@48fT@%#f;XD4Hlzg(`wChRu*yZOX6VS8PXajTC+S8lGJMQ02ybi%66 z_OlszdrBc4U;a?PLsq8rSUQcQTojsn>n*%f7aL5r&c00-I+HowqqCt&W{NdSn4}#; zBT24dTZR;OD$2`OtCtU1Q)P$O-YS)%*ex8S9e?`x>uR9;v{KYbOLEx-{0k4R!OZF2 zVk5P7oCn`zVx*A1Yf%_vsM_q5%z!U*+#vt`gM(axO4I7NU~h+*9qxdam%8U)^Z1#$DLGIK(b@Bl zdk4=l2=5%OP+)=dd>1}jO}i(E&nddj+Wl!W7LJ`mNJBBiZRQ^OQK@^OFpn0`wzzRN z_|U*|K=J@qaxSo_?W=p%?Fd`-X>r|B#N^@2LPlj+=8xa@nFB9CCWm&IQRX3FrXd}?#oaoZ#g(cqtP|lD z*~(zO4`D9T{aqd-q1f19GBL?vchGq!$*`>}i7_=oKyiXU-Nu>Xb%a*S$nN!w#el-z{lq7z4mFp^q{)YcJky+ld8Y@Z=pi$wl@>+h0Km(KR`98F&2=MP(aa^2{$d+4{)|_KYU3WIogy?L!4uH5%3xsoCtSwW!1??fBICT*9TCdRcC9|yLJUk~BEC`?I5dt4F*)!V^&VyQ8f zC-JNa*O0@e;C2Ask?Fke-5K-24e=0e-Td)U^M+szll!oz<4{B7v$D8|BKnC2r;lfC z$G@~}ufP$ykyeNv3zyt!MPcO`_OY5wFx|!l|NepfwWhY_y4V)>%J=a26O{RpplC6D z%=+$rF2dzp;k2LV;ujWD%3GSIzMVdrxJ|c!(`!>8nA?61vP#B66XP`Uu~@jB;^Sa1 z@nQ{<3dbrbjai2KD9svbe*th`_WA}FCpC!Ouy4*)g~Gy>ZE2VosPKDt-XTQEVG5sL z5qUdAUpbU9wf|D(ClPlzd4wRI-H#5~tKLBkAoB=)t55(u5PUXoL7sCWmy{mZVS`%p zX-Nd|V?;B%59?%aNgp|y0f>XEul*wSjEa~sQnU+tybQ7ZIl3X1EV2hJ+v(csi~s1V zki4W(gfFC?&I3$pH_!X$TCJ*{1`JfXVs6CS^%|#q79vDXRYHyenzvV zT$6?vA);dyC;M(5q0b&dV7IW&Koa0pC!r~Y-KRF;!-=qcf4a+*W`s9$4NNiePi^jGe{87 zH&(`VGfo2wd&$8pvB9doF*^z5T{LO;_nCfwp(;vdK{-S|va9+d4x-RV)Dx$vl!{t9|u62V+neB7f1B8C>wHBjp5$uOu2 zdCdu|fR1T(1B(W1z?k-H(J@M6SixG5a#MmRMasWKY8dA>r6>7fm#Vn08Nw#(lRC1G z)4PdkoZs{yg-`aP4yp7N+)#?!`a|4q!{3q;{<`qP)*zOZK%N$fHH{&UF_*~0ZNmS; zHg?C0NWQz>URnb7^c@xoe^@cFM!!n!iPDd`b%rBH$@^&(xyg?QkM*F%Yiv#JS?Vzyb7= zIy^=PNRg_wtf=?+hbGeH6lNUY7wv*@uXyuyWc|+oduJx4ra6VXrfIw8nv?yX#3&XX zkUyIy#mzhARZop}3{m#&MUTj6h~$k}Py4G#H?Ff;BCXQrkD&7EsaD-2i=s2i5aokJ zlL&Qq`Rdami$}(d+IsKA)VC2p<=-w}L2sbsy&(TG3fylYm7#uswvT?jj8I2HTUNAi z3hs8_Q!)@$qbbRernh?SuyEqeBE;jRuq^gC(5wBno=Xr?qwi+v06j{g%am_W8RAmM zKr82qhVbe?T^>_O_HBo%0V&vQb8|uFednPS1$Q=n<1Da2jc>>$FOw-ElT=j=tGj{{ zwXXi8t&X^yfz5RDIj%AEvgN&J_9dioKq0fUYrBa_9P!ZoBNfOAk3!TT$&&2Yqw7j_cPf4@|3_Aa#0^C~OnVI*Lv< z_Aj3hY}8q#Jj*>k#mw`zxO)m%%bH#>51+V9rbz56lS zsY#cdx5B`EbLN#^*BzuuuuTpEm0*oFd8fXOx{L+Nx%d3O!dwnR+&!|UGmu%c$9HzEqh)obF;qh{HgwvD3< z=d$>bxy}MMghLJGPVJUf5h=+7Z5ka z!#r}c=RBP{;@{?>$f{L$chvkRZ;Vo*JI-gE1G^~QenT8>**<_M=z?0^QPk#kWC_~} zMdt=#1`|-vlWe51b{&l_$h|;MZ~-F(M|j-q&jK~c0hMk09ejfdhj-YNuA0RNdFPG@ z19P32w(bqn~1k(ugTax&A2n2^F-eWuqZkwP32O<}f0zcQn2Ny6;M5%~(JC7ymC zoLnTAr}Uu$##aNrWx1%M?HJkH*sRkKTb3w~;StVCLs!T{%abWcfuGukd5q{&OVvmx zS^fgC$KHFgHvu5%2(G=6SIE?K9_%=>IK)WUuM=o(^3MLRrvv9nEn|slcJ-B-z`qP3-cKG_@&H3wT={+OLOq=<1*7aTW=s_=6&lgj zaZ=UDG#f|RlV_w27&Gc4^%B$2h6d?_?=qwI**wkn&MrLr2!V}Fq2+ly$Qp?%#12W{ z%O1d9Y9J>CNhDxFpx9*~8c<)GfgZ{8^f3l6FxIjgKmA;vXsiRqfI2eWC?1+>!VnD! zPGzt9eAV$<$x33vI0>udu?Hs|nDi_LSnEfnLJsYHcoXDQWs29gn{@B%b?bB}Sy3C; z4n^ft#8h&MaN`w(33pUfX?_lLE?8)T`Rh=H>vM#iDQeXCP1~Ab5hFGkD&X6nhuQ2d zjlO-Kx-=StkE@g@nXa%_7U-=1_C;e!S{>@YrENL6zKI2Fii!YNNhKDT&k8= z;8ksT@TQ>>W?SwjXhJAV+3d0_@j|R1p1Tw&v+)&h9H5IzP4Pxf62KgUi;6q!e~e*j zz@enXPS?P38|^R~u2$)%!$Wn!2KS#rFynfp)VfZUK0Hjfzk~72Nss(HIP&Mo_>c24 zGmzn*oJjV6aw1v(4IE)(VWeaFd&cmeoAI&#lN0$rs{0>1k?jA*iDdupP9*z(?nM4s z`xiL)Ux6e49fbTN+V>Aw@}GwK{#^L~0Z0Dav%l8(4>3- z8NFHScIJDi&+4Jzq7_m+EBcw;828#Bz0@GQG#|8>#atSYv86<0pRY2`IVuDdDuip1 zKMT);mh!9eqzo**PM0v=V7N42e5;J*J0CyEt{jfItkg&A{xvqRbOBMtbD;9R(8eZm z(T+Z1T&UoMm^=4JskZR|$mEm|id80M`cHujAsQABjR8G2WWe-5QTutCEC1|>8jGyr zpv?DEp};M{k5}bV0LTuKb*g}+kF`W|eVN%)nnAThc8dfPB0^{+KFKQ0P8iVriR;se zjOgvQ;^mF3!TM}_dvFAZ7o6aHaXpz~9W3_3T|C)6DBhj!Y*q20)bU<%Dm+m#3?^{F zjMM!QS~eqg2QJFlf`E&}`GN)NFAAIuj?r5Vgemqb+qQ~b!~|uvy}T(*>1-tx|I8|l z1XN%>kK z>0B)yQ%6+rIjXR_&6MBQ7)ud#tZ<-VsOu-;`YKX7ff(s~e8=>_tg_@xEHB zow!=35lS!X6fTk88@6cqnxfs;{sm&B0R26&bBjGa<;GT8Tv56Y^$B_zvzTb<0d8r@ zRA#`R7Nb_OC)=<0!gzp5f-Pd^NGn|?vrk{V&x4lR-?Se)l!t04@hct?Q{N_FoM{tp zV}6SNgtOkHBqVZq!DPW*cHqSoZ>T-KLC!R3OQl)}-Kj9Xdex8AiIv7Yx=I25W1t#K z+cyuQ%oQL*3(vcLZZh2+KTXJ6wkj}^CKeyI7C-hRbnA073)5Hz0slY)b z(Kb|MERY~`qZx=W5|Maoy)^+xjJQfDt#(Bz56-3PU?0#-Gv zc|#*deKyt_2^M4WL5~EMbB$F6L@=2KYN?gazjfZa`Ij$etdMyF@`k=-Zn*=$z`4NN6YRcVHwgWHM~n@# zbtP3i{_7r7ZkW#rJS_+yAjvhN;2^>2u{^<3yDN#lHTqLKPLLT?N-N9BMI2RzmSh0J zMXdeF#5y)~9|Bnz%@B?hnz!^&#i-fj_>)->$dE8+A#re!RRmsmIOi<&EYpjRsmRQP zG4)w|;e>tDK)>I6BhI8y>Kx1u=AT()2KME8(v*3Fhko*Mfk%?}(uU@E*63xDC3gsB z6vj@DliZ0cJs+Z6m=%kxJP2@WNe$1(ZSK!cKKDrCMF~}hT*1Qv>}Ed8DTxkTjLxGF z!Q|~%HuKo}U3DZ)&Bz)n@=DO&6oDHC96-e|nBX)EuMSy?h}P08dR$S;z@$fAfcMK{ zy1qPM@C$fZ6Mkm=9L@4I6nBQC0g96(giTFE@a5CM^g)3%ja7+Y$suMQ^l!q%A$=NW z^@OT`gDDO+J(WFxy;vygaljcAW0;_xDBt-qxvv^{vE4pfJN~hS;T2{TuA}KP9u^0! z$L)DE5EU*ov>5zET1Fp zf-#h8T5D!7%QZy6@AV>0u_MY+{rakHErIt726p`-xgJgw{)PP~pt$%gPCc~NkOD(w znUpwtGbbjxK#*L5w`w!sXQYGj5(d3A?BTkxxUpNl?_)-S8IpZn!Y>NkTQD$&i>*g} z^WcsBQdBDtP3$47Cq}fqBE@@)(#`$^idXz%CuDe5ASqttJ+4qV77fSY_f)&NB{ui1QAtJ9Kqph}R3+EaMYl6>cDwKwq0)62Lt6pA{J%fp=#U*`F zHcUkWOO=hMjTe$GG)g-5hScjSeha=3!}OT=!3X+BTzAUrkoXa8DlpgB&W-EL`;1^Z$>hlaKmN470pPkXGA)MbH9?!6M$-KzUyiuku!r)H4EwomhN1cD&T7?u8%;6y2HEb;A#*S;39D z`%i6YQCw%2frugjnW9!%V;h!^S^Co<4(Gtg{yb#jU*lBcWG=FEYqjD+qJtM-!hewU zuQ1VJ%^91yC$tw+iq3^ql9E?~55q>9N%%0d4&0wSh0$g%iGuquiH{tvm0k42M5ET8 zZ!766qdY#jr%ToYUwW&d9M;vp;(IzJaUP_R@jOb%I|F7TiHca#=h_K`m6@}>Jwt@= zBzh0H-+27gQbiM+w$|;;#M2Vian}(5p#(taDBPDQj`^G6ShMzj9HO zCpNm*I0y%yFEV5O)5TQAoigU33N&|{(Z*|JnTitQSwU^i;+HM$HuD)t!fGhQWp%=w zY{dzi0>mTWVKxRHNWYfwt*%_fM_@Z-y{6Mrt;o2}d8lRvrbXm0(`$9p{4TQ_7)Yxy zi%v4Qb@a||P00nZyQ`C?d`AfS!E?3Nfc1#Tv$te88ztgsSyueIV^G@xVj z$+VVPC0nIzhiZ?}3$-nn_Py^y@>0cf@qddwa0;AnO{lavQvU4>Y%g@6$>NigJ&JXb zlC7Z43fO&3p8EQ=v(Uln1Q&2$8g;@nbXsKHCkh-TT>h*tPNcvL%rd|#B?I5s=FH6I z2cKVFGT8V?@9MM^-C2VlVXB1A&E>=nP{w2qLY7duNW4fWwh>sVQ6&R%sM5GLTnjr) z*WbT>@7Bj35uY?9$@tP4cw+@8i=qF#SRyU|5V;=9W<6S~X-`ABq-lTdJk%dG)Wn=k z%aM#ntHsBm;>1ioY+tuv`;?j>j}iN&&#f3fe%5m~7sggSIcUtw%Np4ci8;^sQ@7n24#WhSp`tTpDyZ588p zzY&;C>Uh~In~gMK93sRT|6*p874}QQ-y%|oT1JK|Vz%YjmA!QIz~c4q9iCJ>o#i>!F2D6y~8Vk#sOs<^6swM!tRSa0sf7Mi|Gc2?d(M5apa zbzlzsZEYyjdYj+{?CX@l@-4^u$Z>2P{QA|X@&K_FRrj>#)&BoxANwG224bj<=UFhH&1LhLlO zR#^SAts?|LNkdpD{VN)v=;{18ZpfOxitlNta@YJGPOy3f0YwGVT=UIFha*%|fib!| z-IUb&appi&nvuXg(h{ElT;C(v*fZoC8Z2p66k~UT|Awy4rYzNp8@I~D8V|*VmtdCD zVjG-r2ra6Hf#wjdR|DDGuBisWDNeYpM|F*3FA`5^CkRWQCPXSUA#ncB3``?bXbgS1%V8fOwxkaWo;M>G%kb;y7Poq^Jx~|~bbEna$$&&zt~v?c z&1hlqbs~qP^(pMAQo4G`x+yT*3;d&XKfAUX8K2~GZa&p{(E*&Z`Cq~;*k#gOwC|X+ zAsIk|YM*VLY@B;$gO@0e?Vh3IG)n z+jw&^A1DRu^gCnSv1cf|Dl{b{9RSvs&RH!mI08zoIAUGBN33ZGQ;P>UUvK_#`jLDCT2HU^E7p&|YbijYp+aLHxnBvc4^Z&5!|HK#ncZMb#104t3 zA0p<5iOI^!M8^UA+hay%*8egzSwEii_wfV&pEEQi^quu}zv+L|HFh;Lw*5oQ)cr$4 zwbr-&7e5pDKlU?$e|Ite+0Xny9{=iR0{_k{{sTYr&)UC$$N%r4&Yuha^XmLCHGzK` znEz~Q{<(R7E%v|Y4)E_b>wgk`S^tyn96Nj(-<8bw75-Fx0TV0usUOlF`j3`Z;1PF! zYk9?^;1V)+XWJ8Ry!eRF#-e=vV}cO!30fjY7=+`Bmuof>u#v2g1WY;z}sxj(J@!70w>+fN!Df1r1PRkf9wXH z8p{3Lf^^uCdX*0T3=uWVNsy}!;4)~``K_=H<*YqP!ROL~^-Q{a_HV_j1MX$iY-f`d z>o96Iv&%3W8VLjT(x{{cJeT2Cp&({Id*>E0;S;@fXtRn z&rAqQ=Uce`D2#9Sb8jI{XiqWE^xfydLvUs6im^Br=4cjieEH}Ly_?y35)r9dwR0oZIX-)f+eA zqFf7Woiiw7M9l5b7oV5gg>eh0ugoPu-bCw$I;HFd8<9u1jR*gEEXQn<9;gIr^dO-S_ic;OpYaIxx(ctM)rLID#m-jAzAb`uC^XYo zHz>47)^ssvu~ZM*D=?pFM0A<^@gCpSD^?fD&xT*QXK7EjE~#fY6%@qzkDGgd3*>e_8wyIvzG=&ukX#be7fk5a zL$^#`$9RStLPjI>#E+}czuyUq{9-SFtx^(gYn*0l^~(^d;lodn`d$%Bn-ocDVZApk{ zRYzU~N)PJ7p1pmpb~CbQ;hV01K-~D=Ah~*9hZ_(=rIWK7Z3?B@Hs8}9d3vw!E@Sxf zmKVJ))8o%CNVhaGG7^K5v5%O=QH?MNsn=(z;tRCrDw7P+(>-QP*yx3m_TzN|oAW4% z%_Pn|m?~5{YjN#7U;%)|O&MKq^hDSyExqDPf^c*=-A!cBw#F=hrGbzGSJPPgV+8P)Hcaol>W1fNfgGMXu zh#{TfiXvbt!Y`5qlOUtxd!Pq*)RM%ZRFg-os3|!x-QI|CAQ2Fg5j+mf zSj&(ExR6U+k}tEWuL~JtGzrA2R(KKOLfP)#ajiLZ&4}IDIcr5MSRUUrda3CEMCLfM z39Sd}v*xYHS*_Y@7j9K~vfFAQe-Tca2hoc~u*%(X^F|93F0#cGG?ErDT7R}Au;lxc zL*j6chuIF>d@{{YHexN}m1*&qepDR%`Dq5y(LIPar92m(vT-MJ%<DV)hoXyp2PYz*0#{ zpn)!{bwS}A&evYl&oFaRzegh|Tw^wwGw!&`IWu8@BGnuQohX#X5b-S(hL?-331l=0?0;}jJ5XmC zO+^ZxLcaRwD(Bh%^NI1qqlT_G8U1J5pfl|FR|T%jRIXUi{Gfg?u+kxw*#0b|z zTzF}p33oAdvnPQE%f3J;LF(ivF&cb%_7>vw&{kiC0BWCWW^ZBT7|g>3dL&j`B;%|W zEBK`@Hwfz;d(jCT7d71Fz|d3q=FeWpSUX#|j8iZAyVf2IaL;OzNq9T4E_=_)N1-czPB5Jdqf!)EYsEad^ZA?Dl z6ccCq)G=DG;pZI31QBk?W(2UgKw{1bkzgRX2!CWxDqQ}_7m7qngVZ^JstjkM>3keZmoVMmHxt@Jc$I5@9upSY&XRxQ7P*$QMUxeBQi1^3WIDnn)Av1`%LD z#!*!d?|@!ED30G<`WBQk!bY}B%ncmn?m%h_3od%_h7?Qq)Ez<6_4DGuEY0^(0-JEK zJ1d0J&@-S`%}0TVwPJ=|h*xgZG4DaKv|Nnt9qvvMQ~MbM#Z4(kyKpsfF=P?i*#{s)DGbaeoS1 zd6D&cPTJ#vj&pC&fp#SZ5Z`Jx$lTpS&$MBGw}h%UGnRVkGRT0%Cmf(4J`x~Vf#Y(t`g5V{?I|1tj zbn*TYkwHS#4?^Suk?k}tPB^D`D)Ws5uM`Bc_3 zSPm}j8;i>;5>l&)RdwGtvgjuN5ion(NX_}yh`w@C?tVEcXt$XIVE!uWNcd6;wHD4q zAHx3jh`mLbVEKR~@d3dG+AfISU^Y5FZuZ#X1m4s)kmNGXvSHDO?!IrR3FF^gq0$2= zduALX*R+S%&y>}^v2#3pKC`8SRc%*tw3N&Grbq>pN6=rf%+YU$WDVsnglR;@+IV!@ zr;Id_u-62(7=xj1#s zcG83qsoY)f@3|%ie{)qJ@!YLy{O&#!HVUx1dMW+R(o`Cmp&|~BGmN*bprDr2tSF+NJbO&_fbXmrES|DpvFc$CNvTv6L`^; zB9-N7h0tOV?lss#uQDAto2F1}Wf&n~zD^)tp*Wb?iicHMqrF;{A2iB&S7`|0DHGaO z8Lidi{Wx>1FUdYS5fETbR(BGM~D>b=C-d!U;7mrJyy38y!d{M`&ik8;3Ka?iGYOy z!nr+G5;BdEe0xSbgc^1=$(Vg{iKtP5GKRG#odPd{8ix8APomri91Q3Y8tWQOyq8;@ zQgL-Wr4B?>gX6|Q z#2(_?_76fT;#_2UD-2ujcG{F&>D@Sk)&bU_mcs=3JmcKE(b2DyZ&$}APX+6sojizK#%N5T%yr)wIjx$z|8?K49t3m8_ zq$Id-caTC8G(ey9<+r7dp-Q((XD`j#i@-%|!?R_Wi)U770vfJV#~7%bE+nM!rgHHO zq@V}XTK2wG@Ymr(b=P}yO?8roMD|wn5<{0Ne8*H`&GE&$Myt0ynb+YaW@UE7S%cHs z-BAB$bCr@BC8gRNlO(CPMSi=I#$noyM3*|_E<+Pr@$NQ67=yL_z|qv|b&lJ;`yL1( z(=0}-W2MHi3|v(ph#R#wl3JO4nl5qjtxU&eV~C4xMP!^wa!MA`l0s5xTKREyo`7ns zA*jEiH|*eHp|7CA`i$oAfM;339FApeaR0BZQbxAT3SbcYwkDbW*l2=EK_dW>{i6 zYOY*Xj!|QjJ!0g;00o`NIYO?3x^4%Jl;!6_%u3$*EzFhO5MoR-U{*b1KZ^=6SuwhMZ zY-Y=rP8q;1jk)o%^@>Vj#W;IQ48B;7D>_=%RGEWwSyX`ecVXC%Nz|PDTvT`5xo{G3 zi8bu1Ygz~xm4X?zr%SXW`vZ0hU-*73Q&QpdgsaRnZ7*8SnU+siaUO?$kmZPKWb_Bp z1&VB~I>$BSWhQv)jMO93Wq8~(x^lKOyLnHG{=DBWPdGQKJLM|2j!??$nIeRGgd!%6 zO!0M!Kp<9GRAZ@;128{+PD><(rQgw!yU#DYt-{08%j1wGn^b2)o?>o7#ItF8O$(}j z)fWd)(DzM&(UZtV2#)9BOq<%rQSac`l-m3azE2X9maIxJaqBtBAV8_9;N04VpVgv99L$hP0&@+K%?Fxnc+&oWGQX)%1D^he2oEA33dcYkI;itbGLAyWbj~_-Q4u za{mjz!&Gg82AGG^S~G2KOgw|z4lK;=>Ho0#ZL4G zvd6~<%b+f2X!)CY-TP9#AHF}{?fZZG!`WDWZ}+#S|KRTa`%3-U+5cc&fd695>kq8! z8f*oVDjwC3s3(#ajVJ^p7-1KA7ul^|gLYel+~fO3%&g*l!}nLpI1;Kau1mgVw343a zC*x(?A^cvyhF(ftT0YcYyuG^p@@)=DL+WO) zXV$xg?n|!)%el9o7h4|(vF+O5v|r~rUhAGtke)W$s2Ya6pL~4K*%lyqu*Yg?wuA^+;O1ku&lnBmko5XcU&~ZdsgE%nzc1@HO@EH zlsDo#FJ;(d9Ih-w8myD{Cp zA14CvcACf?)59$nXZ~uH5^7*k2P};SV8=Zg+$;n}L(q}gUo}AZilS20k?@pQ)R^Lr zp1>8-iI@(?vV#Hj0qA9V`p7wS_S<$$WTtV*7Y8^H1iywFb+6pqyuc^pGQHO7sNyOG zCigrH0#Lk1G1AJxH50>}h&Ss$gQkWy))SoIhDZz>X&5nTL_pxrTrZl0svr(V_Qn9h zA+@cd=jR1p4}0J_LE${vsd`Mdt{$u&sP{D@pz)#4l0s8C!ai8eA}Y!kT{uVl_4I09g|`FWUvt; z8Ff*CO5Rt00MPKGb0Ujmc|d5$!Z^OIiM1NsnQ>&Hgq;W}nfRf7Pi#;z0wrystFR`$ zb9IHMpR&1RWJKH=d3?G2**$~|wx&$A;%ivn`Qn4zR#`_3rfq9Ql9GfWPRy~8Wk`fZ6$Ez}yzO{$iWpzE*rjm7vTyQ6o0!q{sY$GC%szKE4 z^}>#uwqA5L>Py3JC3B8pNL6antm!Uue<9A{fZpg4sE=Jq9K**u`S63omPOpdxhHgUgDXo&GV1#v~~d?)~NUI0JCkp6aB3W*As zPuY?cty#dHJf0ugC@S69!f|Sav?cf>9dlttBCE@jdA1k-kc>OsPHVs6mxvZTA(_^y z1dBQ@&<*>uOslZ~yBEF^SHlF}GV|k|4B-Czoa1vNn4RNzp;9 zQlr0D6fqsyZH6L4|0E{S?RPY-ep|6Q2fQxSRV`m%p8aA(J?j|KN(1cM%6SgmMR`Y_Q}zhWL(?6Ak7JI8S07wgZAw0vUwE+r*N*L z<5L@A-=VN6Q%rMiSYNHzgKPOkHN8f|9^7Jt#vW+9BI*7nqgh#MN*=W%WEMh+^Z_=- zsfyg#y3sO9<)fR6bg)!v`5*{**Wq$eWo&yJkL{+fJqp9Gim+e~nu4!Ujl>mCg8sd` zACWU-iV4UM@XK!2yuCd>a z7+W&_lb>;~hQ7ii*hr1q3bpIH-Ei@GtL(7ke0<5a7*<7XrP@zhrF}Aqs|UsBA{vL? zxc28ONBq(t&AO)8)laQbj;`uQbZWfAq;ZfY-3oAxvBKnG(x`w=;VwTMLHFINk@29W z`}bRKXs%-m*k47!FS#Ha&dNMQ8ZvcUe~i%gA!m8b#Q{JJ;NfY1h0@BT4G3o zdZ5L1y7R@Ej7|*JXW*L*VSxc0F#v3R4R5qra?186GHEz*96SgWP>LrzEUEZ?HA{jt z^A>dq&|(WB?GShs6TeK9t!jX*hz0Y+PGWjom6XX$sn}4`L>E|j9!a{Go9+>J2YJ$4 z<|YYhiW9{1bO^bNH|m;xD$J24vCPGc|3*edsG+FHo2WogcB(;<{xnSRJwbAA5U!{B z?4_<58&ak&&Gc6gNg`|%z5Pw4l3abElPuMz1c68!*U%~^(SR`5N-mQ&)2xscO+ zNK9kgX~WMeWNr}f5%S6h-o1?7+jVY`G@D6(-8Fq_I6XU3zHwBGSEHazNcQmCmPM>H zH`V)2u%IJzl{gQch$@rbAb$TYSkqP;rAtPfP3oD!8HyPL?!ZQT<8 zYL5fh=*y+`SHyR#Kc~R3!jr>7weJ-!=akni_dkq$aFXUeSz#d_NxF*s&_M~3+V$9( za_~|mcEd;4NSsn4TC7}MBs+e{w`43R2`1KJT0vRTn72`OdD3fnY)Rmo;{ zg0{*HQS9a}h8zicQ34d5EnQa-JMszviJuGchVIUOV?eagI#Zc>Gsk)#{fp6(!lo`6A}+;Kj`2+R8Ml_t7pg)!FVyg5fLIAVd2BAu5Ut zH*%D5@%MmwhB5_38OmN!m6l}8kx)5O(~(DU-H$61C}oU`FOoFt-&#Zj+%Y!{}JJ8kIj*nzM zcuyZ3dYFbl1|tuWJ}i;KR5y%7%a85m?S3MiZ16acyn-g5{f=vE`H`JU3xa#d26ctb zUpy7rlgi(U+!V#LmG|IBDOi7#kb^h{8F7xX5!gsZAP{1*ph`o(w}?NZ9Q-)36qLAelJ@Is$)TqBE4be4Nmf<~xJFP|!_KTg89Sry&om-tf(nCb+ zTu~tWPgPpIlC$h9`<|c{sidbd+Qq;_622xC_=8cLz7jnY>*K9Ct07vsQ8v-<_IQV& zw=5z1@9js&g9$PR*eJ=QgE+B2!@_yQbWue6<(kCfcksTn5b zPzJA&i5r*;_$`wpvE`zbgH~uhhav)pY=v5P?@acK!B-@ynyt-hxq3sKfc}8i^}XKt zf&EQNV|YHKbJ=)I|+8e2)Ah9uJZQjjwUg;Rj2-O-&_}tm=52*1jmX%f$ zzM-cOx+=9qUTNBu2q?ATCeZ5q7PIE*OrlI7Mr~pK<^i*f!t@SE{<=FN4dxb6`LGPD zM&V3&M&e83`e}~55z2h~@{xIH&DM2=(kGTyM(+sin4y4&yYLUMS-mh!u{?z?xt;!l#zjKsdg${{E?Z+OPiIdV{pdETehyFQH<)kAAG$4^}3TJc* zBlv(Zz=vxH>#C4W*~)`H9`dP6f27qLHT4q#M~=rT6QMb(>MX@1`CJvP1DOw-V)HU0uT*q21TT zjYTPnt&*gyi0ZUfijNHjjC&CC2y*AOeDXh?0HMA%&~%gh1x}W=n z;E`1jUD^n(^%Or7IBN7C*Ob#||1Q--Eof=)e$?Fmc&eZ8G%F4@pB0{>ev<-+-bJGE`NP`pRZ)&Wl9`~fl z)=8rv)_;t&KP54|bCT|Q7hFB@OHKq~{41RDcX;eK(Cl42#_<<~?Ju*QoPQHbvarxI z{TU$v%fZG$&-yRKl7PR=dj46*OwaWDneTBE?{$Db!YBUGKnw7jpzlxY?%&5*Fay~C z_)sDu4h{}_cILl{C0XBvlk9)Qa&mC8{W*^Me^V@JZ)RlwkK#zc|CWsYoA3(2AG*iC ziX-1MKK?-*$@VTO{r!diKpgpd?VsPn{}*)lUro3&aj>ux{r>B3j$Qve75g7f!2WF^ ze(UbHSc~7c+&{!x{JxlfHve}3`HunOe=nAlh{0_~>6&~Wh5dY!CUXY`0cstC|3COK zC$4`7ku2h`CyP=o90V!CVQS2!Y4ypTbnM17sao}?pEGt{&ldO1Z|B~RmwOxSb|;fa zdRb{+GaREn?Z9q5UGE>!9xL?Sh(^tJ#Xz5SJAQtz4KJU^=NtFew|j~iLOpGtF(f%9 zTJYEVmF_HWO>!SizF$ALT(9lkRvOzkCVXCu?nC$|_+LAsT_5@;<#uKXy?-72jIfa5 zp77Cr{o?j;U%c^Vcwg=QVaH(=_~vs|!D4h$H-Gi=Tn2b;_r#EyKjm6LyxxwqIB@yG z!ufigT--g8pP5`s_;kzv;4vb-V^A~&e=QxA{!y+dHG@g$BADF$YOvK^ex=2h1M$o@ z$BKeT8gIln#u=n|LOg^mwPT#E2ril|#A{{QBpshu;aqgm$Rx%Xx|ns^K!)7OmFDJ3 z-tn@1ofa4WXY*GA8jpf?%P42{gyGdSSZ|(hc+dG(F}P>Jrd~INl4=+6_Di;$k!?b?(bJ1 z^&M+;o5ez26Y($bi7$^wl!HqK8*I>ko16O^_8aUgB1SM4foD?U~`dLzI64$!_&-@o_5^V zmE=qxB;V7Qh2m^J8R!phCwd3q?~%--G1c{)TyGAmX6;Xp2W!=7gLmEQUN1v44TO(X zcJ2APwLBIfI|*0M0y6~sSa;*bAyuspme*Sk{h9psqa|nFcx?$ybv#T79Ayr#te7%F z8@K%C&uq9Yrbf|n((SIVwwv5;S`c9Gw&P1R+~estyE|7B95inE?kLJ^22D*tlQtLfpk4wOb2ZW9Z&T(W$(5Rx3(E` zK*VU%e8zPv1vlGfh^ioCBpj3!B!K}X5tBPa%=)-fNh0d=%*8Up44=mmFhnezP8U`_ zw5De}i5%Bk&^y4mIUU8P4RhTqtl1Mp1|Jx&&>K(r`1FyihLw|WPZW!MSCF~nV-ZWB zBocDuWf-#`P&i!M(@`o&!8Q%p0ClQh%a8JXAo8cex98VB5OG&c#RKXolX_M}G` zoWkb4k3l$0qosm)yJAR0t*z`Kdv2p?&p!UN=ZgIHVLY5-=1|5QK@&E0G1@q!@@*J{ zGWH_YZ=t+rW$J5fn%70z>(9)6G*7UN-b;)11cWVxqUnYobPe{WWJ!_;>EDD6Hnib> zECB*e#5t|C<(EbVlizbILxty()FVPw;M0&lNm*+7yx=Cl(^iT;YW3FIl5TrfDjS3sy6SX6cQ@IFt zwX~l5eEvO;?AKBzY?ehn>i~C+V2>$%-o#4C^Ca}Lm6Vg!`?O!X*wM#Gb=$`SY;~6- zPtUe0Z}ID1t}jixT09!tM99A1J>4waka?H@aL5UcTj0&FP2c&LQ2M0E;EuMY&>SEM z{kk9KsN=xQyAD&qHheAOwW;bz)Y6d0t$vDwP+$q`M;2-Gm)UUXsl&qncXJ+Ljb~jt zk%X0uG)G!4F-S@viA4Hq$)-|P_vkaVV&A(d!HJ*zP9B=qo1>$^Cz^ZgW0Z)bBx{TT z8jl#$E6=ov9T=7)h+cuG+)swX-@EdtoMwtx>2rZ~r(A(#AWUX1OKB+EL!gjJ)<&X% zGE{|=KmZHZ`{if!Oj}A%{qe$r>{K^3O+D8G1{4~~#}CNEo#nl1MT2f28slsWSo8s3 zjh?-e>2FvSTY1O1h!M)Y?TPRnEvB|@*qb+VaPs7cGd;2U}O+}t$gk@eClg2otRCQM+FSY@)Qf%JnmbGe8Q(=Z+9SJDu1Ju2+t)rjAv zxCT_g7e^EG7YNXZJc-~T7|?p!5^J6@DLqk>O*Ze@fAy09WkJ9i4I>>Z<#QEHYc0ni zRHvW)lLd3}0Q%4o+v=;~2p#ZDFUfDm^3-4E%Z2KPzM-CPm)C+Qa}TQ9_PnC8g@kE( zE)uDA$=v{9dgC3||$(uS}qLBecGmi^xR6ZMHc2_qGS%NN9`*YNzr|ZiIpXH`gi~O| z;ekn(OrxQO&ZB>K4rrc9HO@;z9-$$k3mh?o>hVQ@2Kr`h;W!qU&4wM?$r>|~Vnbel z&BzmGIfEXB1fYql0)dI2m;1JsK`#xm;8H}k#J|jZt?&hIY_jz`>%42eHwT@U&@FmY z!;PC+7(8SmtK!5Y+;b&u8U40=Q9#KZ`{0t$OXepSMWm#GCN}3E*kY-1U+fkOX{ZGy zUf$LhGYSl*55n|vgM;t32IOC?T7#k#q(*j27YYxYx>sZ9eM)Mho$XOF~6(^F| z)%^hM>HTampoIA)erI4EdJ#(|&j4x>sUZ;--6iZL3fz3~QXI-I%RGrZlpyp03l2O! z=uv!4KJ-khO_349v5_5`w7!h%-7Wg$kcR&U`r=i_lubkIM9cd@Dzl^$%-|SC5Q5hp2CyP5dlh;%rU!AEYkxYLNu%rkqz1iK6=f$y;&TZnt4k?{Of3}$Ck5~eW3!!D@|2?H+pM!E863B-ACe@2Xc6Xl zj3F&%Au%cISBeZ6igYY9a>CN!$q2_!(-h-9kppCcirTpNLc1!bZ-d2! zg~sG;&xu@w?hi8Xxdt6^;dm4F=Fyytv41NAInT^oBIS$YR02!}N?>L|ma9G_Cw(C* z{bpk$XByOnnB(Jlh9}{4Nyr;?^61z9-mvY;42yw-A{`q&e0g5#r`X zVafaqQxz~}2I!%c>gb88)u3gVY#tsfpCBhLVa)cjS$;W8(Ok(g+LqnNL7htrlGai& ztRh%xaOZbI=z16o%$Kb66K4J#UOVDjZ>|0Xp z@*sa$0s=FqURSVK(^I(Skby*rE2g*%#!!I=VQ@5|6s6TZ{Q$I?IXQV+e>t#nHK)g( z38j3W!Z@?sT@qQ-j*o45xk6<(8zpndS5YH=D<)v#J>*9%<2_=DJ*VcV2o&Ga#L1X8 zj3J|zQX@&>-AKuxm__*%H4GEv50ztso@)+^R$m@ph*oTG&cT3R`x(Cv=EFFX(5_=X z0e_`Zi`2Tz_H%YFW|<9%(v*y}_5NB7F0m4B8j^$;8g(n7x z4MW=6_rjxer;uIE0o%vd0+vnM_e>>D&1L^K!F+&YBnXh%B^Lmgca3Fi)ktclELJ5= zV?*Yq6kk%2@RBWoRpNxwo?-F=Cw?E>vGV+)SY+6H=T@Xx zqU-lzd;8iCf#tB>k_nPO_8~+<{wprZGH7kMg3~Ab1;@)E1>z`(9~k3dAiwg6OMIcs#pM$R`_vo0NKYuaq*^C4 zT$j*!Wzx+}M5PQqS7QMo%fXv1%HYnqKae`Ht{O$M3aVH_BO?iGfL_{Fttg_SeDN&c zWS70a{w?woR;6atQZHr|Q$(*^i?1#IcX(i{hwfxy{m_vj{X8%_7OV?CIlG_&caEDG zT~eXaTzcjhOWJa2fh;6};8*U>lAgX%niqeH8b}jGf}Ii1bV#-`Wf?bDjIh(=nYprk zEa!JXm9#*PxZoU>jEfPAWe=rB)pj?HcCqhFrfGTGYvXZpp&l}9dS#h9V~v84!}ctf z!WIdZdb})F_@0dMpMTf-tI2 zGDYoDF8GEI4RKV5Mlm6q2V|`16W&%%RJCiK441`reZPmbiPIfuOfc#~BWe#PP%I7R zhK@`T7CsB%z!BlTq42S!5SK@sT?Ae=`mTKKUi+5GHmYB z9KXH7=yo3iv``*t94z11k5DtQNO4Ml?w?!l?t&Mu*ut|f_~X#S+l%?HFByFfJZ9_|MKKatThlp8V^vBhHdmD2b>wO z9>a={T|0oYk&09qzoya-MwT?Ff0AtGJHC6-jlj^+P^_ew$c5Xs4~XH8wPr^D{&f6J zn;5D18Xya0pSZ*Q!IaU_Qn_xQ;DrXw+_VrxDe?R#zimtx#1j*^(P$gx_Bw4d{ibA8 z9`mny>~A^j6At?IBFr(9_SCMdZJ?5>Ic%zsnGH6#$fvy&cIk44RX3Xn%|HqoY}f}C zyYRGa?ijo<%Nq%>SmpXW#|G^Yh-mf5O-B2{u zL{Ir5#gr+6vw7FS9$aC4A@&jv5pwZYP7RFp(S{Y(XpW7TYU zBRDw5vTrsz5y>4nYX~32xo(@74ZBKM=++N;#7O4ELyUII!b!BS1R$GXi3HRQE#&s%SQ8{VPZB6bG+?)s-jFRp)(Ui zGsp6e7F3P1K~8Z3Ion4Gy52KB4Xmc8dBYdZ5V}~$NHHK|Pk~gPAk4E&BM&lCFeT7x zjsC0+{)&AWv)vSnI>9c(ct!G*#6KJ&zMS4+1+uNhKmrF>Ol781WZyK*1}4D{UIA1h zZc_jRDn-GCjp1PS;JbvS*LSoeOX*@ho5jx4F~EUmVTy!%4h~U5Fu`;0VImH%1=tZIC*KVY`<1R3# zQOqz{IC4KJ23Z&sdUan^7o*GBBC!^JSw!N?*6aajyVv2RH$Hu7TaKwbxqA_u_bT06 z<{|Yo^S_{-p89dVvcD)XDHdauPxtZZXM)+o8e9AQ2qJ&3tE$D;GFrf0?N66=?vpTw zyRND;H&Eu9^GlDF)cTNufNKO#9`)*K+(Yx|7-Gz9w7`wD_ShR8&t*DKf3^1g1MS{} z9$2E_hNNzPHquh5-f7kgXNd6DtKL!dLjubK~tKRIxxf@ zoH8-*T7RQ^C;sIRk##eItc|wR7YZW$`utVq?RhrFxdry3E|>=Z)o1Y{Nw#SMa+KCK zNvyAwe2+4d0U<$ORCuPNjYMK*4~+vWkSN16*FwE{&@9QYOln&MA#hDgJ zhXnT65ZLqvMe!YEnCJh*8e0E!Na#r$O zrV*UMtmen)uBOg?lka$~JCU3z9fVgMTum6sp{O&6gxc8R>Alup9K7}PIty#$IZh{s zx`m~`K;czj!#l&~JKE&A`~d0#mo5IVOS6+%AW!psAETemJ8uik@8}x6OA*o`>HsD3 zEO3LkCV<#i-e?2`uWz$CYWc-nzO7&Yu~#K>D%71(6nk1R%w8L9H3Fb;pe&|?pBp`E zBr30BCv+`fVxd)GL1Z=@(wMJsG-ghQ3_m3vDj|+;4Tf^94;nrUIj~FKMcILE-N7tM zDh(BBWqsL4(f_q3+~jh?)Hg$U17qBI+qf0G0{JL#pYac#^{Og z{$A}Jb(7wud5Rn$4Jxf9(0lhg!9$=gQE4RFB5{8XRW5+I3NS$}_{dbDA{ftP-!uIK z5W}Il%hzAvlDk9E&m+%c--Kq$93Vp!3>ssw;#tR&eOe|%1l9NOX-=Qp11_DRz_Dxp z<@w>_cWX5pmy~I9u@;WT(n7$&S#OH@S=8dUMBwymCoRrbmxv1) z;o?{kDSMZ0)h9Dw>jM6L!xPV7K|J$N^ zP=)47VqS0%uc66#1!lH9CFO^WB?avc3^a6B2+$aw0&gf+lrxxdmeU2!2>Ke70_^)0 zg>`AFmA&DC^ms)Sw1R5h=J6`QC>`>*Dd~Ox)K$oXR9$`M4!PbcP%rJ zynN$)RMJq#N(#MQJ6s6~3+BK+g{I@OKRVR0Wd0Msv=6B(gARZ^{|1Gz_@ zy-wR7DpaLHAX7VD=D>#QBH*ZF@BJn$mw^d8Ne;^CQC-76@{~2Ee~9NOYG;kptp35c zlnU3BW9ucR7tARwgo z6wWAz7B>bEWtEy|>_HeOb8CktdTTB}nXPiK(1Dm6Dna7GDOrO@H!|7fM~QaC%sM6~ zIzFL%B!7-l7L2B^3U8BjFDLPTy_3Ndr2Tbbo$Nf(epwaEHHiEqbW}(Ql*2gVNrn`N=nWTKXAx>PHOBBAN||-*^7+LJiO7{6u|4h6|&RGJ~xanw3(UPdEjZMvLp)mluVNN7|? zH&?b6sLG4(-7*|(3A=!?%f7*9s3H)HYn{7~C+~hTW0k$5?tqc_=F?xZHR}VVw{vUU zuIOf$yvwphce2)16@K)wrN2utss((KBpj{ffsT2&WjtL=lFwIbXdQ z3orl+xL?E`*<`ods2}lV9z)Gjri0GMvQz6mjc-Dxl4{$njE72bT zUBs>2aK9}Z(dt~BE!rVRbNAG7V6~}|^((hmNH2?!xYqRWlOmmEzA{jKJekM!K0%Np z3~O4yjDP_}OAv8*fnCwEd+;1QvB7z%m|Zc#AW0C2)t&=ov(~S?7}^|UYQKsLT!?JjIZ@0S+<(P4SjzX<-j!^8J()X=WK7}; zqiWAh9G^h!GaW@kW1~zEHy2NK-_%esnMAc0ay8~K7406KaOQcsje@)R|jaDroTl)4&hp*%P1 zt^ov%GwK8xPTcBoZ#!&YPRgG+NNh6Luoc>GM@Xd=`dC{uTPd?K=dyr2?D^e>_?9d= z0vz=l->*^8CxtFxl6KHrVqj!w*Hpoq4{sK%iKlqpN`|L(=E2gW zHr1i-F3Bw7_xhn;Yzlm#wD8n`E%O;1*GOG%&zBj}Iw)E0fy;s+W`>D#nqR$*a!``Z>RWlGe?Ju zJnLenAhXqjx$_l6;T!{cO%*S`zou3c=t>J1um>bJE*I_z>cB++1>>O-$cutGSrrdg zQud3Opy$a_$rM_%dV`48g!Hn5;KD1vKJ$ZL*0(P<%T z_Ugqs<5obt#^flN5!&SFqSk96frI>_)4hak-yRQ4a_f!uFr!ngjNzcDAI6@}`pTmA zaRGV!hw7`gkhQ^aqdHXc;SZ~o2~$e#kRXMS=f_)xP=A9(KnPrd!*ag9+0HgJivpDi ziW}d$;@+XAHxF~uStj%PE%9Q7Na{z}Id){6zI32B9oq1WQDzh72! zBY#qY2iuU}C;X7i1`h3>uz)yWfm79BUTj|*Szqth9|7ZUJ9Bj(M)CE&tDmJF>rNmN zyW_%(0WjNJLW8fgXI^WRQPB^SbPm`DUYNn0VBvBEKnztBp zod@_@gcJK>4dClKjIwWk;G;Cqc6zL4R2}KnT7I1u9<6LWwif8fCuAOJm=8$C&P*cX zyP;@rIj(J^cfEk>u+0ktD>lH*4<;hUsD(0gjx{~P7S;0r^T)6f1G9{VX172yh`v$5 z5PIEt3AhLAXZu20q(fzpZ~V=oG1Ou)UaCk!HilXjiD@Fs;M7_0D@z5^hXZ2mZ7j>+ z&T-4>$Vzr|XnXtErcbnR`4TH3s5Tu5bLY3QxMisWcJ!@GKc%u<(zyov1`@Ney+8m> z*!%7XE+$D(7Glp?kGe+HFjHxWCmyT)_&do?U;E8Cp2?Dv&0gZ}h0WGao}}g-2KX;O4WBNN3_TSb09SZxGb<9j0{}Kvg`a2Z%-_`xM9<6Lle;A7X zMTX4A^amL8yXmddyQeMF9~jramm&YH_D^`{{}`n8-$PixH~zmMtl!t{&mR8=!eaUZ z9Q^kXmQ>8&tyxK^;?R*HF0H_Jk$Y->3*G^mE-vlIo3jW~pba%3KR`X!+Fr19!bKd>5p+N99`*xAM zqxUxN^UEUR;s$O5scELz?v>Y*v>>+WZSwj;HsFoxdCzr7?}={lx}(@-!bT+w)?WNp! zOMW}iWKA8%6{kWsDO`*n){r08#%SlZaqj?cu>!SI_w=pz3M9?mgvp5VH*#BeD1hDW z&f5enN{!jGe~)@`oGX2C)_ywbF-`lrC~apGDTSC!C+sq<`gpclW!A!ZqUf!}25icH zDdUMrDT8X6rA-mWaqZlzX9pK|nWHAw%M&>mqqaPN{+aNE3zbzLL<)O`VK>elBed2xh^ZfsDeEai27zSpTIj>o3*35OTwSqr7UI}T@ zS_~(tY`S}Vjx5qj>LGJdBiH4H?xMq?joE?}j3=#Xehl9R&HQySFwrx$_?5nMvEE=xK*opDVQ~g1GQrU>0O0UpWCi7h9TesB@T~4`-`W!xUlcODP_0BNl%KJfuv+~DA#b50AKLy6 znrw50py>#H{MZ!RpN?uB<{Of@;Wmy6e$F7HzTI5n6IZBlUE|U65K2^3mf<$TMYdj+ zn@%~d48&yB9HcGLMP^0Ieg{NGDBc%3>L{*^!UQzSQ~{MR^Uc#kzLV))fTO3EK?}vx z7~PZf#ANfS6eS|{-2GCtm9eSw30l5tKKgKI60}2GzE;FzkQYxB?cqEh&Ayl~`*o zC{~fdlyeJmBu^rEN$N8RX0pcx6F6~%H7%9t@t0XOaUl-(DojDw!7R#IsznlwK?ZOn zPBu}aG({z>ThLLu=VB?)n^G&92MO*#9LmAd$J!G`4EX6_>VBa~MC7NPgrZ>~-D#QT z%ooIZ=kI~CFvQf!rOA!7r0kWG*_>|$P-dTRtU|v;6G{p289{4jb)MW|3+~UL6)HNA&Do}!g!o=MpD8#2m4mP^6tuTq!gEVZc7v9t4TccqY<-X z9>1AmGoDX)9-gK|hvO#c*`+~}!Df5o=Elb9HI_Y7C39x5PZZRR3brd_{T8ZUI*ZWR z8g}?UocD`4X2UOq%JRR&nTFuqp`psl^j|S0onMwZVO%B}w?3JPNzhD6T!$BVf_FKN zdx+Lx)V77CCd`Yt3~CXRmBAPavV%U9^A-kRWWXIV3ciYAf~;aMF`}E87&2Ryd~l7l z0c$>^{go<5!D;tKfSf56AUG5qdD@{x10iW|1>}YxtVjLk&@{XX;$SYYZa}5sDnyx@iJmt5+jgB*=xBNk9b*&ki>w&~c2=7VcYH3AN z-+cTKfLYlU0bAz8i5ihGoD^5d>4Tl@vr6P4JN@`d+V3+^F*i3xxam!9R+(f3bQ)(4 zVOg5X#se!y5#%U_;p)&86|{Ybz~~rmw5Po&AEE{E2^R=SKI^n0jvKlzVSPG1D{sCw zdpVFyd~z<4teO0JU9KZcX-frTg;*q3_9HPXH#-ev736W(A+I~aiLL;wC;~V>RZsy~pjrXzg_6*$=f)WMU#ZKEWrV_#I z@EDLU>vtQ;O%sj#JaEe2;?qbPf9iP)V0EpKQ<0)Uv=nu8BW5Ef!_HWC_fm9?rKD{2 zJ-2L_vFU00Dtc88PuW3(IQg|$PG3#hk{=21US*AHl@S!J&ekXypY3wOqflR6tzD0m z@CgBTjHkPici_yyAzJW>*w=^_J|dyA!0w@AE6P%)J*%=<;?*?wb^LIwJ{7^R9Ng?n zeF=kaE%M!2JFx5_@Qt1x=;*CQeG=jyVko2h&nQWaOE<)la5dU@MwbRVFA{Z@VFp&s zUEaD@Z^R)XCV@|EoB;tdafKASYHF69JL)j>J$rdfI(?)ut|GJmK^h+bkg1{@nc26A zA$8`HSXHFZH#3?@h1t~Po*&E zCm7``5^;Qz=I9K%o}YJ9g@vTl=|tTLX&ih4H1|ASN9~tJ!DL8<3d{(W5t)r(I^|9h zo5vqJ4&giDt6-#K@JB!PE~Dtc*@=#0s}yd;Uvu?W1dJL(+1a3@vVcOLeeRTzo#&US ztboq)3jRvhy0aJ-PMxyl5H7OD#8?XXC@@;&ql(#tXqdD9!$*dZ52bhO6Z z-mE#SBa$If9)m+69yCS5H%z8@T=75s=p-%U|DXje1!~@`&~+1D8JEMakW;aXsFsAB z{j~kW6q2jF-GWn-x6Ol&2ci$Nq-zQjX&&S$;T6cG!8P0PE=GD4P!l8n;q(*Wg6TapCG z%i7uAI4U+f!?bN(;%7yQL0byU`}4ESXGr{=nyNd*mN^XW%ElHYVze7gO*a~{FfC2k zx{^;?P8usDj!KSP66B)>ibq60S!ovnJ>=hK1_JO6XCEm`%Ncf^5nIt5nGV=-<*}-W zQft?ivJN!LFPgC~@^>Vp$RRCGvm`~*gda>K8S?2#D;(i=d518i6ClCBC;Pctzx)~@ zapQxhzgc5*#j}i^5i@aK>>_-+CC{&8szt?mu$fUxh&Gf9BjZZSp$+)3 z>5;tMM+b>!E8eitUICABW5(4Yo#n&ae5YbL0tfk^ z1IsA1nOwxn&)(WPTks(vho1cE*(?cIn)Uuvn1-sX42qdl4TrFxInO>6zV&mjUi44h zvmb*hp*ERVvqi<@RQLnu*YsH3`=SGd^6OF%z$qMGX(YZ{|3p92^YU?Y+q()aN3d&z z$@`E}?EyV%s8xa07pGO&DMzki2*9>je1-*3ZQP89fE}W8eL?B*^#jVV6h%8|39GGq zuNgczVt!?@5L4-S#A0F0BTv-sQ^6C?IScx=m$ZA?EWro+OQ$84)5xu4^p6|-lji4l zIj=Q2RpK_2YPmEG zETfFBJhQDDlAr0;q@Kitn$b?!bpkChH%`(%OYqvTG=s3x)d`b;oppNV_`nLE0rkys z9**dwkf`M=t91p7wm)pPC4j^f_M;zx$Z} z4E`x)Y-v*a=I41(KaZ)j)%$GRE?!#Y)RY7k>9E>k80povZ$aLq;DHl_@!R%vrl8XeN+YV#wFk!em;@X!{H+ zN|?Mo>fICR>+C9-$kqJ;p@!G{K9yO?xNMUYv9KvMGmCBq}q0IjzZ&XFK+hI>PUmvuK6l6YTpxsJZoPh_uy(eF9*`%nGjV z=j^>ql}d-%@2c@ju7@Kr+|?+)6qn|GP9=^}4wy_OS61CR4G@$@#3{OnV>@5c432Ti z$0=D#b*#VG1aS7KX%{;+?iwwtn^{eMM!^7>4v(601PP%dzUD{OI=m(J`J_69IkEGo zhk2<54*ZH_>5F)4hCdeJ*KMy19B-@}U|uSB+K5PCdrr~27hcxc+4OvA9!nh9g3m4J z)<$pbsZ9-y>mc9I&B*a2&ee=|zG);kup~kf7;7I!Ha0V++;i$pp6l}j&G|YH`<$YG zJ2WqnO+7~NHm$U z9hbGoL|*@ByZV(TT=Z3)zj}{b7!bOYFcSiiYAB5bTcqTz3#Gh*II|KA8!W_oAJLFl zD>lddwXM!uhpN@kALe%-sN&z?`ET3Z-G<&ho z=RK?PPkQ11ltql4i;3etNC!I*!~{-i2L1=mCE~D6w*d6~iFb05?3t-3& zU^P&;1(>n`OgI5RAOK_vFaQC7+yI~{fXh(R1z=(TVBrR^vIDqT0Y*l@hUn#Bz2h(5 z&G)a38wgIm#`5zqv9Yo-ar`Xbu{GI$&Vh{$oL~OOlKZ#gHnp%e0k9bWSWSO?nA_Qy zfJ<%`*47pVHsF$zn}r$picf$Sv&pltuY%D3loq9{Jp515%{y5fvt;y zHMpRnE+ql3ad-dWGi)x^=&!o=-& zIPO);e**`Yy!&%G09imkGv?jF^oJJvJHuh`Xku+)V_|FHXz`CrbkXYC{o0vI%-;aKmpnF^8uOafQQUP*v{bBw9?@Yw| z{g{R0KJM4w84+7MV-xUR>}+D|1m2|oVK=_F#Qq{GY+xjQMmht6xS4?Ws`eLDfZ%Xs zpueeQ@{8y=JKDJzf{hb%J3D8v%Kd$<{AYINZ)*hvw$bjjEjYd#=of^*b{+WN-&&!V z*ch4^8=DyGxtSPRSvdcW%719Z{<>DUfcI85ICL4yA8Pi_(*0@O{+%Vr&dL2ZB-sBm z8y5I05}a)Jb~`DM*nu_gqgF|?@0V-=Id{g!omK>iHwz%lZoZtl;s5P zIseOv>~FC38ra)gTNr)cXPo|(w6OnYM(nRUFp&LEZ@yp8Id|*jXK=^A^BVb=$3FJ| z-hjOmAGRNc2Pu%1or&$|5fI4Ee(${acZS2s;_eW9e;EEyS zl>ZOLEAWqF9x0HWm5Jk*MZ@yG}&OT=(a?@Ao5r-noHaet?4s|LrdZES-$No3N3I{oPgd?{WkD=auq5hnfcSw|_*D z{*~j+acANvBQpQN@#eVO-oX`rf#dzX?fn~q|K~a0-zWb4{SKJv&ib9{epk3dSs7gT z{tDoG;X8_VHFw7H_nPk*-qn1^?ym5iO@CMTP6od#eCN{N74CaxyYKn?!R)Rd_WPc{ zo8jMU?t5mx@0tC+XZHJ^+3$O1zwep-zUS|9^J{?YA4}l=k^Mng=lDJoMCSjMvd;Iu zh_W&E`V8C5#(m2o5hEoCA4L~8jPAJOQ#S3~4GYtl3Gvf5@=y5OFLh1w zf)r^s;cvcN58ry#W**^&3P1>%@ zOT5Vv#GxreM;zn*{f>D`10p=Pzt`DYz#eB z`gVDEI%u2lk?xieB%!wtzV5tRJw{cUna-}L=R7z_ntMlLfmA6ka&uan`10KH@OVvz zKJooEa~hV+r<(!2!&@PE>|2l9(@U+h7?df;k?`nrv?x9UyK-vntY&Y~4EAl%HfHa$ zk@}T2MgQk#WL|s^Lsr+yLhzQC)&tFvoyj+QK045ZJ-I45S(HQ$+CIjU#CXU>I2nbv z-01rbOCS=QQK8XyC^CngVwXMp=|&qAzF+gv2({fvJmp95??h&B6S^J82M+VVPHsyN z2Xjamw4KzWuv{I#dC5C^W$VwPBLtgQybWDokn%;SC>)L*u|N$;NA9u znZUQc<|e!?)w?NQCTJ9*+09>=lTqwnq7EUOj8^koDTseILtWjb zBaE+coyH%ARKtNs&JP(4#wzl}OMlNdy{xq$SmKKUeS3k{I|FwNd!200z;LCx21g3u zM@H=SeG4!29E<)y{;PsN3c;-jcTL-~CxV~arQlLy0|^nJ3n?Cr5SBrlKA(0yRZOu} zSeA*UhkN6fHZusbP>wZ}Ec(_l)g8_&y3hw_*BHVI?IX?W1{Z7Pj#8LG_+BkI9)_{Pl0`j&3>0x?zDnnV?!eybs8Ugq_C zB+4hGKpH;t_HxCGE{I2RyrfInum=Fygmvvg8XKxb+PDU3E{eyEPqT50S5>+0*V$qevdpPV7QliRBrMSg1#V` z-!U_>8^2`D41p13(k6F-uG@k84)0r6r_kQfij(Yzj%5HZV_$qkxoB)ZsDCLd;3|?U z(t}EG4R@UOcmn>#3yRc_+!RvI*FEuyLT^nmM3{OZSWn!yr$@1t_Olv+@3^q3aVJIX zpY5TtpFAg2IQ?eN_zp3s6p|VcGYAW+AYxky&ZjfQMsIksaE{HJGYD@lX(WhiA4Oz} zemnMJxI6%l3Z?n9Z8MoVvkw132`fBFXWITDGxfGQs_G{JlA3QGoSw7{1c^f05@jb@ zUR<-|mxJurC|3Nb4Sk|7L|ZV+eJE9c{8sAkJ8By4`ySP{^<&M4>DMnar55B?(X`X5bVO zsg`1tA10?s^M@wVykzPjBI|)3N*mbcY2NJ`GFVM$S(iiG-SHCe zu^+foLUq~nY(S8Cu#?@G;1!!8O z>qV`J1CWy*31~f4dB1p&%=?YPDrI2jX>2e1N`{;|tX|aHP1n5aR+o>uqQdxls1<9J z-pwjsKMsP0(gvS=dl@qXUceC=d3pJ96+}<~`c};L^Zr($`Ss~=A1rZYp(j&v9Z^rB z(-16Dq{7_o{x(R9zKMwj?aYqL2G^1oCYn zCE`B9s~R1dzwO2fT z4KXo_BCJVmjS$8O>QshEyx>Tzaq?d4bL# zUZR+x*g2c{%aZgER>EfGhms+k04rS8SDMB7z%{d>bCg($7ns6(0rl@by-e;fzQSx; z$I_%gWNwlE=wNv0V4onnDu*+B=2tEX1QR7%$Tk~`2KQwB6h+p2bl-azxBx|ZD3=!Fup&IgP z5^|(s3XRpW&JlZ#Tgg`B z{pJur7ZRfmh)$i`VDXW-^yg3(pWmF}mcIKOjD^Pgp;VoE{cE?jmdpMc?Uja*w@u!c zwIp=sciS$7rt%}!OjY03V9YmSNDUF^f(Qo#ELCW0(kLu(+Kd6J&JtgIBVx!M$19uV zx2<0pV+7kV2xiHlc^nABSgYAO~NBm?aDp-)So67ps}gIrTdaf_c40J_Hax$ooS?*=DugzZ_p_Nzq;{&C`)r& z$N!4YHtO-F{d(`wVpqmjiU+;Wq+>)~S8s=~7GS=%XoVdX3Yw8BZo_-oqPvwKePW1E z=nsc5ZIPW&GUUw^3~Wu~6R*3V;lCJs)Xdi&$tm?rFv1kWV2V!Vl$vxE@U9oI+5z3m z1%W-iN5QixwH#glgggs*l%qd0r>Z&2w@zY%0A~ImIVM!~Iwgz-N)Cb3sojtX!u+`= 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%0A8Zh@ z$pW(VT7v*(TuB21iB#A@>MBa=4h##maDQ7y&C7RO1Vko28{0@Ed0r_Z9jF13PX=}$UyyFxB)M36sNtpe&_cKgGkMK7|Lbw;qHetXW*`jT)*SFoHYa)$!pcJHn zRH_I9Z8kvOPRo9=!FCA;mrD_;B?Css6BdIw*r4wF7Kkv3BL>;gk*Sq1I*v>OK|&qu zB#0QkU|Tyw1PAfRAE$AHZUV9B=u_r%t7;)iNjj>CVq*rK49};srfgiUan1uVencLPsG z9*9i)GG?Utj`=L0gYpE`@TMIx4Cizk(**(Zifmke!$2369VSRB0mq4@FN4Wt4q98a z6F}Vt=};Gl*bltdCRs%&ll*j5=ZIxy5Xjx*?w#i!4VV;k4wa4@>o}k=bjlmg1Q}iH z6uOq-E2Nbq867M!?`GYT1lbtBC5o}hvc+UDzr)jZ6Xyc^gdysULi&=u*pgw%=n zyRKD)hl)9*IIB99C)G<+Pm(xPIO$p)mE5C<_8iUvP8qlCp!}}`M8d6fak=kMH1^f3lOg=Oluy(qH*e;}Z0Z1~v3zB#2(b>;5 zrCqc%q)6mtuY4-h>P@LOGJ2`9Tmuf<_c8N^D)W5;3*8*gy{8_3Z3K=B-P2N1xAHY#Ukt z6LH&<>khh9sQ0|1b`4Rls(y*MH)iiWbBd5mdpjfkXhtYpgW|KJ8(w6W6^(^(r2ZQ# zg{~c+F049NVXs~u60)I0JI2(@bUA-i@zBfe`VfmDQQqVvwKuUN8BJVkJk3=jX=ULS z8`|$f3<8s|y7cfrSv$g} zz0Jx2Nx!g^usb*}x6jNt>#0I>wo4`|mBn=|4r!vNd;tsT1sK zT4C>ylcY-U^SCX8fPZ{h6{+U!mMbr^x*UJYaRBNr_n=ErO$Za-Ot`dd+jK~!qF8y5 zTaLJ}8e=}>#G)uvE4O9$23>CuxMDsDl8Oy;c#ux_i)|GiyK#`Db5mp!2=%<$(Pbb> zw9k6*AZ$2~FF}9^h~No=AO((H3AxRTNO%)^>u?e42Nh4@Knfm&P2;TLLw?uqdJOm5 zo}^Qw{m+t3lzcf7MR;Tw!c0Nd2YqGwC5#oTJBm1QXpNa}ff#$nMXU9){sgzFMH9KM zSd4hW#SI}~2?3rhU%^ObmI`^~zD8_zb6Gc*8>)O=xqFIjr>vJUS5tZr>)A$?cyZmi zaDUtjRIrLWu*iKnB5SS!6n|2%O08`nB^6ORv1fQ(Ud1&uSIu=zP3xDo4py*2it-aK za8Xf4yG+lreI){ujyrlFMlNKM5T+tn=su%!Q ziZ+YMz#UEA(TAkr?&oFuVZJSi=f;RllqMai2-54VBn);rUg@VQs;i~rXZj*Mk?WWT z8)Py=-!8KOe4axhjBeef?s|jVOm&ommGGu0yAu06NCE83Oa~(mR@wNB&vP3pIB{!+ zCrW8W5%)WU1J0W^Mf!2(%&Ei{y-4*K{$t*<%$jhkc*3BN1lKA%N}Ch|$VdxqzD5Me zx>%#gc031e#XJ>kQyh?X^qWX=Re=t(fJX^j3xU=RMP6R-(G zT72en+UO~H2FdkUfq7lXz(iuozJA!W4V z#gjOW!{JL&KvPzT(qUG9Nd3fN)+2ZzJAQa*+B4D_niv5dXk za=crg28y(Bnwe^GfNF z_H3IAsl!&!j(+#6C1nGmfavQqDA%M?fynHl=d!RerUvElC~G58B(;S|Dgx1hQ~4>V zY_a|9+;PDg@8ZD6XXy*mJ7K;k*{-&&T^?xO33@Mb%5P7oGP!8)wM-SYkc*&lq-CmT zQ`|yAb*gEX-*O*tdTlIr;ow=Iu42tIVESuE-q-GvBy57*p@W#@;DO~V23>cz!B*_o zm`IT4!uTAQtBiBFt+kSxmbo+)%hHSNnUN3%>xtJN_0refok4s?>*)!~Y6)ydHIQmt zOgeP$At$H{_t-WzsiMvW-o#knHJ8iy&Vb9j_{l)=111SM&AgtRvP~}idx`;~;Mv9` zKU<{^(NP{OXDaqG+&dd#?$G8M2N_QcT2c!fEYRIyjs1e%3snhw`x?4L=2tMFB94)hg z)dNkoJFeD(Xt)Q)1Os>PCbW|;fp&*DUnSxLT4>U2W8@E-FY+LZVex+Cg0(g7<|Wq1 z*~q+Sb~?Ae9=qK+&Z>Dodo}FKSn?$&A$G10LAwCtQri~#=_nb;dU=>F@qf|ZrI-5)RY8ENQf=;;8jg{<@d ze@p3DI_Q`K8uH3wB7pyLurRQ+*ReOTvZOJ#w*b7sC~0D6tz~J+0LjDiuMiv{)bks5 z{{sx@|25qh=m59#6C40G^z1Zrzv1yWqCNi+7%=`7gI~|_Kf{0?FxH=6JwQZ>m5zai z_4jcz08&QTeqSb7>FH>gew!cvsTeT*6@y=E(!Y-Z3p*2FBL4PV&;!Jq{=k5a{?{`0 zpNawVUorT#zWxs|00>nv{VrO?09XU)exC;{?0~uQTl+s11D3yF!2WBm_#a@v%0k2T zyNDM90|O1iFAUh2XqbPSAOEQsu>KW;U;Exa!{E>R0t?{9uli;`cJZIfAYh$fVP*cc zRsN@9!1h-Re(mA^41+(fiGXzbKMH#Pc}-+tVg033_n(RZ`(H8mWsm$%FrcGh``yH$ z2doXh>;o2NHX4B01o#D@@6!rc+3FkE;;a35<^Tp8?SI7HNKf}y5Plg~{|tn`JPb^L zMc{YC2(SjQ|6Csd#uEz@`!9R?KNbY~zk=}ZS&B@|^fWBL8{*7NEPsH&^uq!9-D+h1 zQNiy&bZ6iH3kU$8>i;$s|3BJ>?0=KC!~Vn20A%U>LDU313jg%<^k?5+ zCyW0pr>Fm-WB&K&r~nlT<{wfNzcW&W|EJOvKY{t_)&R5**?wN_N8=}^KN>%*R=FRI zpNRfw{6rGa__>Myc#Hk#q3e&v&ok>Ejh|=LKN>%&pFbMEUHMPy7eBwYUoii1fXn{# z=lzqC24YdmKUEbAFW)5gNM(EDd$%0JMhm{_0<{IV1?Nge_j86fg1vu?5sw!qyp~;- zm?^jX(h>?Nf7+HF6=n5$wU4*!_3Y{S__WWvOMCEoSs<@5BgOra2GEil0-~T4?u#lz zMmY}5y!>ocaJqY10AN5qubq-js%t8|J`5IxRduYjKRLQ`I(lMC@NmE8y9m%772ao_G23U>-K0o`G7Q_72o?&$pNef%&tq zBREBzBVD$?@p@1~eMvB%hI={+A4+5W*daO}p^fN>R9I9m)kX73$IP^SG`P<4y;8gR zl4pt-CZ@1ZwqgF2!m=FQavpXT$>O}KH1!9+5HR5i)xV&B*u1v#86b?unoZiRG0Wt7QDp|}`co$YMU&&3~a(}Ko zSN(KdLu!9d)js`EbD-Q(iP<&C|3HtB858LK4VV!Vr*uMf=roQR_k;c$9rHvMMWVot zSsG?xO6U3B^*wMlaf;rcDr!Tv*?tJiuoT$0sgdwcXA7b8%4tOT1%(FhlnMNm1wXIt zoMy*X^EBw+&3Ps0nYdYkY3SJ(6vfgO@UrWytY1!2F{H>EKTp_ z6cokr#J;?*H#gvpqAjQ>D9BWzBLI~Q#==32gKg=MZ~PGSBoN%?+zX;>x-Ux77&v~M z7pP2xIZeYH3cF<5efXVIooole<3mp&vDuZyl}KjaOF2lW+q5EY0yD?qDI!BoJ`bUa z9_*JDteEVGa#I*xWOx-KEMp4SWIr((wBn}C4p57$A@)+zG8BuCi_}m`DK79c^v(Gk zz4e8W5b1;uh<*nT3?Gz>6ZWw* zGzIuOMHDiJ|z=xY+ke`-JPmiZ-^UpCT~jXnOLFQ6g$r=T;zF$kV`vx z6l=1|)3#u&qC?#Ue8{K+ZJch|mk9i<m;8G4jdS-t5YdyO%|y&Cz)JXJwiGpXkV2&qu%8ymLNg;mfNGChJ$Rv-xi?!u+!AAc+ z1Y{(a7$H1Zy+UZPu+KF689mqC<+mX=#a1J$<#Gv)7_V5z#nb-!8DdRDaB`l}3|DDM zdVxw&Q5uJBz(->2zNXpizSa>7Tr4d&imL&AGa(}mabZD7ZB*6lK>cXMj$MXccscN;Jp6~3-2`FkNoTh>Csdaj|tRcf-n2@Q-B zp;h&-v9_x46)yE7pDxXps7Gp!?aL~UB}Zy#<(ui-Gpl`n}8WDe?a;8ahRqiI-=j>BvDRO6?IThQ*URJKp9_D(rB*yCV4@U zkw9BT0-adQ-pTKS@KGliLP^WyUe1^>x);40qgbhV7}tAR=0IxX2n-jY$aq;I-EEbW zg`-EdSX>+8J-WlHJV7sx58>dmDl2P)Cu)aw%1HI&87CE7t3+1)5Q5m&FN@Xl?&XFv z>OoL0!6$Q91ETpbcGZFJhua(%>3dirqwpZh!~7VJmE`*A$|nO|)@PxS=>2`-SKXJK zgqtd-wz134g?U@f^w4Z+_500LacrS>P!?#tnv`dqELJrU+VxOuOj$`Cq zCjBB{O(IORNSHHAp%smezzH&+9cd5C<6ve;Or~ zL~+xA{>-o9C?1()EGZY&6kUeN! zf{;1}D`6EavOz^cU!}(b9^es>RDv;nDQy~eodh<=c8gQ#&4tk;Y07{Z#)hLEL#+x^ zTkA4;^L*DDC~3o+J=n#H*D)p#&OF3oC`7!&GkEWRnP6kp?x|O>pS%??{1*Cm&_VVM-!3?`ycn0;}f;ihcl1)PJB1onaklsDQS!fs_=IZs<6Eztl zzDs)-v50z%T-Gr{vKqK(&xL)k zC2u3kWdsueW@e~JrAw1wKVac9UG=tuo9gI9dUvr#%)W$TPa6yt6u|~`5VH%6XThb- zFao5?B3e)t>sD>$8=K~@?-eG7mOug}i+j6nGnvgTz4$oJAD+AsGf#Z5Tpt7vJAVTg z3()H{;K4Sv1na`|>;p35HSOP+&k90@(w6T5a3lCA6VTtAlz;R4m?2M*1MeOpdiH5J z!(vAQZ7RR>GPn_%-pDFZgpjx^g>ph)-GY$Aqv@7)(6Y`(cJpWySM_XR1njbry_i0=!jZwZ#=np58Oj7l9!&^Yr!Ndbe z7(&_aHwkV~H0@xX^d`=~Qu3HASS8(uGzi6!@;EWB9#~8Jk8k41`NTsP82PYso^&&7 z)M!4HBjRIiC`o~tt!827HCRj+`ZcOCSK?i4Yx#-bFtF75)hYV*&31a86>4dlS$j;o z%W2CE0Za0Yn-=EQ#+HeFOIh$cq~{LT4}GdPrArC(4(Mj2=I<`m;n*VpJ)Pa|L7bKK zC`4biF64a*y;QQSaP~ASKeZcyZm{hX!hXE45pu)EhyBPFN1W96SZ8vBsq2`|joi+l z24iw_e`!vA((EiiqjVnfu|*<`<3qRW^azEs>?G*2OVSquG@=3_V@xSxuFV>aaq|8+ zgqSo`r~_hUT2 zkzyHz(&;p6zspi`pO}FYeD)Brf#e?ERf_O%>mc$|h;ieAoS(KGv`p%p$s{`t7xSkt zUV0tmoB!Z zKT~K)^XZY!BwIKIR=o>(Eys1-`%`hgE}G}w)#yxK!I+V_dlfwp zv$?zys%%8*T3#=MDVKaJq;-Dcwa;^*2DGY8ao3wp3y$Q$g1s2ZHd(dF<)vwA^-NFbG8NW$<;E)OM6q?kndbHUpdB2u$;bA47|NTFCiZg^GQOd zof7d(b;Gc$)>$-lzpGpAQ6@+Fu+Jr%NTfU82g`kf{CEL}mZQ3tVi5F>*yU&n{^Z0% z$9;asE;gqhp%Q}ayS%YoqkgoS2rj>+jb2T+g-&CKcO7P*D+!cg%o~z!^uX!s!YagB zweoHgAW~(2W@f+c$$kIXERllo3z&_I>MqmzM*JmN`g%u_bRN&0J@3*8sh8x{w?cZyR;}n@%1tmC zb8YtDN@MDCXU&@4`6Z}j(q$84@ga0rc z@r)7{eJ2!FLEmD+R%1iI6gX~Sw)tjf@sS+&3#-urdOv5$7rS+*qA=pRXx&i)7d0IA z>+AB_{zJowPJWE|W#%ZVhZ6bx+td$aece&G5Mo9c)?e?yO3K74ps3>ahRLQXIWxXK zG`=R~@WHD2zQ3{wJJ_xoNGCgbA2P-ew#8_HdHO7R!hqnVo2Y0P^O}G>G6w>B}>PF%lui&kN=f0|t|r_HYu1vx!Q$ET0vD^@)CRe=L3%(bgPgy6U7NFA;FgK`%95sKm{&9IgLB$&u7Ha zh=b1Wm${fNNS)hm(1Q?7EJ8@*Ei-xOdnvczQ8K2-rR=gK7wpg$F1NP{Zj!!!^FHE) zb+QZ8=034XgDuOQED&_I|Cr%%dl=|9-3^`#CGbiGS=~484$CCm4TK6yJYs^%EE&h2 zT(Lqj080{=$V^^hxw2P7c!D_t)`(r!?kQ(OBX%FZkhD(4eul|3lwe4JVWmBrxl%G!U%d^i|19Q&RQGN>b*D~% zXWf<&)D9+~lqkR@+FGhV!5n#2vUgHrwmwYEJd&ooh!>e!HREiNtVaTR4L-bwuCkOa z4X&+X6iAkhC2?5e)Eg!3BoeHv7*Hr_onv#@n82(PpH%e(-an`QD$X2iN=FJ4vBQGu zFxZN-d-9D@43rA>@CS5t>g5#gQ{+5+3?eMwZHW9YUmvNEWZzj*>*LVFplS4#Q?^Ft zZKDR*hIP(t-r*FEd@M}|nYIQ`k5%aip^89(W5@O%LRG;Nn8L*U__b4_H!M( zkjoBn?lIRpI)zAH3Z`mW*G$ji{F_;GZu86S(^rvQT*V-;>2}&RsyhorVGokOMUny<01)``6qf--qzm6P_rAl9U!U18;3ooTZ&6kPG7G8Wqx?QXji?S9x^wVt}eIcq!g7bm|rOCwN5i$JNv3{ zw)$uSCvTU$dKyksgEn>S8k(@$c+J&Y+^iqy-`vWFzk7K(ZWwvAxfr=it-yO_aDUL+ z2;+r&eXP4%S_{JCmD;j+U4JCKIlk#??}HoV#0z@mdaVU{F}s}OMQ(?Y2yU@ySX*Px z3R$|&sEG{f6InSqyw5SNE(W)N?lRhaI-`c(yE`3A)e4-z{VaPEVW+WVKQocz=*d~? zBsJk=f#917!?CnvBiLjIcCZ+2_~kfs*+tDxacV$tqVROnzd~ovjvf^$i|0mz5VM!M zZFF%F_u9D-V9}Ov;-yey)Dwf#KWx}3%e+df*zg9=SRPuix!p$TrL&G#X0ie%Q}M{_c0S9`rc!NLyaiQl`=PYM?SW+8EAz5(E>pxuT>43vKr*f8M7< za2~YzGAE@K*mlxs96=f!6deV=$;&6|^}to`1J5S&f$xm#`fhml(I*tGU;sZR>`@xB z2ww`j1ErHIlfcvM!xQX{7)Cp(S|?W<(RS5`Xwb-=cmC4_f|$W(ikc_ORqjPK87~M> znX}%Rj=@Ut4%pl1{HBxTFoU48?_mWi>pQApl_QuHV9u5Fu<6hZYGG#KtZN@c8tZAh zJ?Vtc8I$s(1x-tdAWY|gg+VCD&)@1r)ovFA;!cljz(fXq741mv%-CJ(AWwYAMg17< z3N&|rTwjSNC6jNFK%Z@JU!|qlrRX+1G+(V9;rkV_5s%6Ux*S6cjSbaIlw`Hzu_OA8 z@>ky^8cyLV)}SiC+nfMd&^ePi(s6qf*RLfv81qjyk?_gu!-$&9k^af)3=fItG!P|0 zHL~bA^H_SDADJ`pP4sQk6~34=*W)Es&;v*A=*;SnES8@SB^lY`&@GXVBOEeu!Ns+7 zd@|l|-DfiCL=3i|P9zo1$nvnHld1}ma@Olyv{vU^hY@rKQ7(%{IQ6;fk$u>tbg@xf zaHN4PaoL=erP(qwKpI>W+3iw?!SM~x&!eQ&eps43%}>u^f~4HneC`~1(bfN!Z{BM{ zxv{WwU6TW-L9;98PA* zbLb*7;ouhL^9*ln;9ui{ZG)5nza=kUkSq}s0V^e-k`IB94zc<^O{9NlGb!MUlHV8$ zEq|XNJT`lCfTGs&(7_5%uS>XS3kyIMZd39wLp#MV1IqKp-{cD<8ZxsE#SYKXuu=qa zxWQ4$XO-0L{($F7nP|MM`qwueVGG@ToIRHs>VB!$_j@1AKGn7DYxVN832;DcY7_5# ziL_SnLO_8+kqsfz54FC5tB5E95l^8PGjkzV>)2jBGiKBBQI5Ee$dV}`Pd%U5>Neu? zFOWlE*YVK`Zv7H1*z?%&)VX~)d4gB=xz0>Vov!*hdR0uvw^id7MN`-gE z)#2N-_Cq4Q0H5_X!L%BKgCp>3i7FC_SfBdnHaf5-sdcngN|L&;Cndj&by7*JtKP6! zT_un@N*ooOwLk8aPI4za;@N&$EGua@wm+?cPK#JS1`i0db%Cj~-e?HDe=v8^3H44c zrUZUuOA<6G5;daB+{`>S&hs=NYm6nBe^N013Mua$c;*li+nJ;Rb6imO3sOvSws~Fb zN)JjWe-SMY^=V=6QQ6JcccAqB(xcYW-+Qm*HzD0h=caDvC|oWYh1o4&?ji5I2WWMz zeCAC&mmJd-L{s^5EQwUY(hi(SWFPBs{m{GdLFt2eh}$iOP7}bB>GK&#j#qFO_KB|O zDO^d)IUZJ-{m_XCh;8O5CVFCS5(l1)mX&n)7lGUhlpHBLN;$lQ^(X4f=5S}Dn4dn$ z4J{k?TI1c6Dy7w-O828b`k0{vV~LTcc1T5vkHR-IqRKd>YU@+% z?;Sc`bQYfe!Fz?ykb=QHlbDYA^4OirI!Uvv#O_hdTT;#?T^!Za&j!tu6;ou|SJXFy z$;R{+`h>;=JGgIKP4m=<{GZ{`^G-$$sj4TBS4>VneDZ1VzUH`rNvM_Z)F25LUX~NE z;p$K{V_mmZyF@RdAemWRtRGjp)#tBmCJQ-{q) zxh@=(G4?IY9=ObOq<%nXKs_wF`ygeIE(O|@b{qG)idr^B zKw&9Ac{hjEz`WYr4;?FLr@GwhQe{PEIb>y*mQQL~`gsf=vTW!xpp?bmZn{t5c^wa^ZG`;;0>69B@Fj-Z44d#v`Lt_fEY7cXn-H{=a@rDg34 z_@8Tn&<4`>M1?C~B>mLehv_o1-*lW)=mcOrkHJFhRv0+mIc%L+T~^kHPsYMl>zH#1dl8EqozT@ZUt`+q5r%fMr}G2$_Pn)m6fo`( zjqEU@GK<=RL%C*E8@{D9(pq#&7z~1Iq7wUMiUhqrUZ2f72>7!G=FJRA-UJ4J0@hR- zo^ni>$;*J)km0r`KPt;O;4rWLf)KpOm*$Z*Iv$r{rdn6+Vu6-K)_(eBnw{2|9(3*u zne2E!G^L&xAb_G+LF6^ftn@i$BxqRb@kWWVc~Zci(<=C(znQR>t6ZA6_K8}Ftk={l zP*ZOh2_CHIdu2nI1+NVpU0X|V(b9;Q7t(jIEliVqhNv^gfJlLC+KABj#7$8gcC%Zf zxA#`4XnWx7`^O4lF4@^%JFf9lnp;mJ`pW(Kl+t2yPI!7;lcO=-THW!$&$m>=@|q<* zLUZUQ>tq+A^xI8dlB&O#a8T3n?BMB@v&e*v3Q&uX2v}xE!l2vz(#RXV*Q4HA#22L1 ztahy2@#K5z&EToJ{rN@d@EGJdHeRdtAu7|Z=S-0cdK*u)<=Jn)ui+GkcNn9{RX3M2 zCZSsd&4sQ$0IS}{8{}}c&S3eZx)4uZ32Ab%-h4~P$7B$JkEYyUOL7K&js(2Gf)Xbo7e5D^jQ`lxSu#EOvHO0BE0k-QG;9P*b>HQhyRR1~gDO{L z7wum1`yMCo&2gT5cNC#jH{;`!H1v|aTMrB;_w*2PBdSa#=9=ce z>MNC|(ADr%M7BwoFow2_yuNMhqH+Hlm+m)D;)j31NXN$Z2Qi+N?%yNEGco~4(7$ut zn3$P=5#aF|0pw`9->G0sEC90je<aS_-?%W=nUYs6W9@wwXj&jFaVK;qu zXDmHT>s~*oS&UMiDV~@68)I7quj$wKGFz{n?622WTTz)u&U3Wx+}DC`&u52M{3dyi z=e%RQ8h9^J}EM(I#@OrWBPoF$DLaU z&wROzni|_OzBN#Hl`m3#1Sp0nBs%0oSSH2 z;rrF9(0_QmsCi~;){L79WXq#8;N8As;UxY|^N-7*5-{p{ND}g1$2~pmxSX%-PNm`{ z6t$Ez-#uM6#*3sgKHqU!HnP83C*)k;wP%jD!; zIf`c?xa*vdJoj%hxxOjNP~M%ngfm!oW zXhXm>dmQ=r;XP)Tv%3RRJ;QZTF^mK-G$pv!6R;qzo{EEe{}#&n^ECP`kQB)V^d;)( zCGH7WTh96-#oL6fbknz`=UnKZxcg_OU*r`y_IBz9zcZX!911?1_#SfIzy&(&iD6(K zUK>(%%H5F6&JwaGDv&0`(>BYccFgkRV7AQan8|B#16N(U)~4>_w95NrQe99xihZB= zlz}n}myap1{q_mijA{z<@QR_jMimj|%2;W*8p9F^W{6lJxR5>T53gM=j1jHS2HVC9sL;1b_txd=L& zA5b})M@o8EJ0B$qnQ}jovt_wwIjduI2?ta;sFb~J7jbpQr!J3v0tqU=!&HbTf_hoS;DrPOUAbe zt_86m3#G)^2O=Z}Qzo%tJi}cbid+5tbr)hIbhz)vrA3|h_K)tHSt{5czU>x+T;^bY zC5Ej3PKKNIt+1$LIf6Pe3%`CiR%I?R)44LBjPI@023hl9MG%;`ro7Z1j%84=lT)r) zsuJtiXZE6Rt98P1<66oM+CCOrRO73rj53F=r=>%ZXA0MOvtKc9&#q>~WSASk#_p^z z6^kVF7TerzVAHL9ql;-Q3fdlvNs?}|@w{Hs`d6DPOZ?iCj7wV-ylEKa07$AcKa-O`Bn!SP8XruwU1E-E=C-cv#O*i$;2K`68)60Eer@xy%j}7 zHb+;1)p!Cj(vW(e9luOSZx$_W!voT_QKwaj1AJkZSocAKS7B{P{jj)jhozKKb_e_h z2iagi(y~w*a|;~S0HmbNhssx|H0g#vyaOo-5sl6uDNFIY=R2s_&e{W=4rI!X>S-br zbsM4YNQT@_yR-9`1UKB18v*{&5isanrz4@sKD5c7qdx)6TygTKo*FO>gxQJ>6L6Ik zWphUZ=uF+MZ+a}-3bPn_Hftuzm`J1AU$nHjTneGWl!o{C1;D4INvXD&8Hf7>c1FR_ zi1{6cCJfB!)7M%oPD4`Mdq<8|VnLc$^XoDV_v%jYVc$4#Atj-ESt}gfx>~=C_OLHU zGCQ~cz4gOyk6LD;Iq~fb!emy>)kfGNBr>i*n{NXv>kHEkCWSU9B!UpFBAFZdKtH1e z+<*ww;Yu7v+x-Uh9Y{d>rV--jc~NMCq466Xy+D4^vl8Y77-668@USR07t%;4sHxs% z^j=!nTzYjJP;?19Ec;-opgVZp^D`aC?-Ms=C0yVH+d6wBooV1%XDI`eNnzk2y^ImW zo}X1rVj?!r628Ic0jF@aAc4aTTaW!H^ojWH^M@b%gZCOdJjrq!#of|AreByE@Mk1Xpaev z<-^}D3L&-wHK;q9CDmGTS|!`bpVg`gdAA;EhuUpTjp}UdUx2&PE)?W|Z*4wTb zBPZAfx#K4N2q?om2R{PsV)0V^czL6i$hPZ?&pLl@_xCSs3w+*%?LoU_PvmxLQo!aR z1b}D)aBnxo7TNsqU=f8~BlTO#`cIuU?@Eii)JN!=z|YX}b@93K#xML8&`}NU(%hAs z{GW0+7(y8e_AJaqZg88~LbwxyIy8%k8s!LI`417pg9Jq-M7aX?4VY@(F1JA~SEq*x z1wdC?b{=o4=?PDwzKdzi)5L|I==ElXrXKCj&RQH5yO~q0Zb{^1#HmNsa+cT-SJ%uo)+g7Nwm?~1p-H=_D4-#nf@aJiM z5&D&u;V z|H6FIfk*bm+(+C0|1kGX;gzQS)^Ai%#kOs$f{Jb1wr$(CZQH7-V%xTp%9rld{dTYY z^}g2o?vuUd!8~}b-1C{wedS<|asS6}bQK1rJSNShy~GX()`gm2^S@b8=_bC?Xvk)r zIfH`P)+z6-501}g)NqgQE>ahNpj8bk=y88%2=pRSReQ%d$*{>VpcXv#6-CFjNrrb6 z^-Zx~{aj+}k>~~UV)7L>Xj_geqPXsv4D3Vlh_k-T`9I+dtZ&)4Z^l4J7;SxEl%~GQL^VkUu5PT%Y$+ZYu`R*cND$;f(2B1 zqRM=M8JQnf6P_OoL!<)ty|_1nCYGqsvzRpg2#?M19wNB20R{~1;?*9 zj6s|W-$jX=07^ zrmJu$1}wzFcFa3@l%CkI0iIuynxh3kn%wpC^K-4gSzab-4HU*um9SX_*jfct3XY2Z zz$Pud<3$5aL>gJ%=(;$hzHIHoOUbTnN>3)|3&;QrKM(X;zwcIO&UV}q}`UdB!rOSnN0BuJK2H^KwH1MazM+gy$#6& zV6L}?g$QIoJ7`!Yt#PT;d|S!4of3F9Dy(aRfS{&X99`?Q4F!RSN@O>YvSW59&lwWv zGZ96gy@!(Z(i6=+7@7=F5EM=P{AG$P_6w5hUQpfDJR2)GPEM_gc>*Sk9rQ|m^V#Ld z`X;-|ddh$W%As(#9`oN7j4zKWFwbiwm&UJ0KnO_J z`Ij4NeL|{~B31&f${kSS)YhN`yRjEJ3a8Q;vT2M<`k`pVJH~%x>0&}VgKwjKudZZ9 zVS$p{Ga@lnK2U|oe>p-}5ucvWkHTxDBPUOQUZCFqZ3M>f32frfRgw z2t4#CHZ*=J^^>Nw7o|jYqwtMA6*suk2Jc%elcq|#r{evO21VNMt-QM6WDC~gV#7D@-F@!SgRN8T}4?2(3PtHTEZ z-$A(-M?&diS~=W3Q{TC+L9a#i5E{L~I?MSCXTyZ>MAV{HnE4%7)IOs|t3cPhZn%s) zNZc-bX)8NKA!7paP@&5@Qlt5HWmh6YWCT-xNc)(>TwO>`2+0-VYFOdgkvpp64JXDljbtyaTx62#btaUBYR z!;CVCDQ3%WJZhON$dCcQV}Pgtxarp8B4(@TtBXe`H+3_ox0aI(a_`ssCCcg0)kJ;f z3Z0rkPkqk=22NaILC7hXpVhy8QTf!yMTqz%0gi-!&A6(1SSAoblCt$3pxuL6W)qb4#y}NQV=YnQT>KIT`OP%C^XSZ$rKpZ>Xz<<2Sc$uo7&)|# z4n$P~5jjsi5iSYA2FYlGGywsc;-WHCIXb}xdn&1)4<h(UP^+Xppeg)SFh7$H#sWX-NK2Gp6+Hu&bWPO?Ws|J8P zvuk4oQt6Ayp?94o(arXP%RMxLZXARMonXhlqe@{6r0mB`qdUdhpbz&y*M7Rq;)teA zE7y2-l%R82SYE1PdI)bP-NqT+;ey=uOd|!Ysvv9LBWSZ|`JI7uG6-0>=I7i--Rm!KwSN55vjTIH`hxn)gI!+-`%JkMlPE zOAi%8mgDOzSPI_+`==cDHB7Bn#lL0W)2EDqp!b2dwL9FV#;GH z)0{gf>_TR?y1G400&La_9^MHm-#gFGQXfx7vV@|jt+-vZKd`wO1@q)NpM~D9AqGC^ z!fv}z`0DLXEcu{37YmZ#%c?RXiR)Igr1s2?>B`0J=vJO0gO1MIdP>-~I z#km105)fHbBDy`on5FPS$U|BvGapBcQ9|ApS|`n&?y6o1ZzB=$kgiZ+($#B}uGkPM zVVuO3{s7xdDwkZ7{V?BSjMd|;D%Kl}G{^6be&uw;ibwB$x}mSiM_4*c1f{6HI=<(_AS3wS^)W{9 zNAOeDf1?b~Ec5^JG6-*K7xXSrAu=4Tx)^M5X3Gn^e>&+Uc)iW;`j!85csY1DT>U}b zm6{!`?X0NUIRB)0*3HxT@pU;_EDE>1i@b2d8+o(qawDvHeeA;U>DH2TrQiQxn9jvx zkZt>N(`(feN4pF2anctlh+5Co2nvHrbz--Kn!r^M9*hb zwd2(=w06LjGVf49SWy?)kvs8 zc{vdxHW@;!Iilja>j8x$wLo+7fCYQ>*K4Z-I;2 zpkgpthHuv#RL$hv=hJnTVT;*eJW7djJV@2u7Y@rN^UV2_7{UcYggf{i1%CC4%o&yb zgqCbyT(}frg^93S11@uA05%EfoV^0-dAoE?zqtUop2v_ENb+?lYJ*?)D(ogA+^O~5 z>pah0p$D?RU{zT^aiuhYnuYKS*Lu*+t8m*0Y#Cp1jm za6zc_#V9jW20+{!gjq7UStED0!j3T8d1}{?!LZO{r$+ck_^%G~Ua+n(*_rM)k_gcV zRjCWmTmY{y*xie{REEZe$DX2mPFC5oL~2w%s38)f5-w5`pgPZ4ptm{<-g^mEy?*|= z?=q9!yhg6^UYqpZ4tKmHp)#&~Zg=CV7Lwot95C6tQ&bt$9DOjCzK7a%CkxV=&PT1{ zN3WaYZLn$Wk6c9?7U5`wxsAkEe)f2M5*ImQ(iI z)c|JO1$+0d9$n%9_=`(t*G0v(TXM>ESHrpqcy2B?_oo3a9oZ0s0c>F|d{avu(FVlV z>BKF>eC+&8%+?lb3uKe#{gdOy>n8RMf+$iY?#I+*6&}O58c(vV^6-P#oe^5lP0r>3uy@fhA+d zzu52b5T~&0z_|$RBK00|a+7vC2{A#RhPMD06!(C9KQKYtR$S|!mOuW7Yc7c+Voi{ED&6)PZo2CtwlkS&N9e_hufhv zamRQ@$Y-f}yOYiDL&O~>{$2M(Z9OkbZg9y1tS@;XuP-c`1_9}T3mETlv>~fwiRd6?%lJi?MzwjCH-9`ZCLj)7A>y(Nkw}Vw zST#BP9W!4Y`nzN`wKpQ-x7{t>E_2B1Ilx>kfE9gg&ykA{$sOmH`Hm{PRSfS8hkUUq+hM;rSm zOaU88;tU2H<4-0c%!0Jwjqi0Z!-*lF1Dql?65t1LLwrMl%5=wu1BXz91&T0kEd|C(#&S$9Ox zL549-XWB}YT~S}CrD_aqW~y3^kgDZM05g7f$Aak+G9cZCp*HSQJ`R1h!W1-S%lGL? zh#W*s7_hXgBw1@TaV&^J+QflB0u#^!bTyH<9#Aq6uK{FtTfml8uTtrMi{Zv)w<2LY z;$Vlqv`H|8pdh$)Eb*ND?y97eD%fJ$z76C?uw{ldVs<_vTrs->P1J}qQBAdKmS&J2 zvXvuJ8o_ENxoqF|eWTNiWD`3eSpbb>OLuu?X9zRDmUg_aw4$az#J^IZ=#JrgL)}^UKovJ{Qb5B#y$2|CB zPN+43R|g=A&BvQt@YqfH?NH(MmkXSDFQSVXubTt&?ql{&d~Sex33;&%HfarcF*t-V zm3be#&akPRM>koAd!U0mYaoz^K4r)2+?6GIWMbo{Uls~vrGqnvQx$%PPDGyyr(iYu zU@j77X~B1nBH^?d$QXxYo$&O$@Inz)|9nY>-sI)jojR8gTWWVG`eMXsw;e%|W#b>f zuClA#;Z9#Cd5K>$#37L)D9+SVn{e4?-K5w0vXRzU6>J^$TIFZ^9!x1~1PO>??oMHI zw50~LfjD?2!CS|JE{Ry=B) zKLntuXUS%DE3qW)(L~ShjpMgU_gv5oHX0#gl0)pCk&SLoP~sF-QqueOOB#H@!z&cs zM!Eh_OvnJR=lEXd3X35dv#f10(V&_pSQkazPXsn2udxYNSBVbiDbuz}FCcIACCwXz z$8vZS**&wpD{G5W5V(5d`yd6n95F;_@|7LlbOB)zrIn?DaXN$9kF36O-{Fmp-4|oU zOQ!45Ws=4D`u*(J5}Wah5ldpV%k;*e%NzOVdV=C9qVK-YnshvSVxYDJ2-jE;C!HfU ze5nYPsg}&vPtnrX93Uwa zJ~(#q;Wfy(@K4(IcOmneykTUZXZ~v_iT+Q?`xlJsf6|(NjNANOYcl+iJ^7c`WcVXY z@o#9&-`D=ByZ%>b&Hp@S^84fd--`0@!$tp6lnj4NC;c1qHP&k^a9x+xKU=>WTocQF zm&Nlc_zwF83iBxUDAy(pg%@#dBG+3TtO z6|W$s>3M2Q`g}_}UAt?niv@4#yyLw4vY}Q@wG%vQcs*b5_5DWnu8x2)k)mNDAORmFLCmUHk)ynv!F-WB!=a%GxLA!NmMkzkR4rtnt}v8O z`J&Wh?yI^*vZ-Jrn*O^&IK9$hAt}ZR3U+wXLx3A6a=6?2S@0zvRrE@6yoMPF2f1BNtnw-&y-sL@q?s) z?2AXVe>@#X=!fyGH+0ITQ^zLSvX^1z1u6k+TLU!Hl=;Px?EaUY98;$_B@xD=gh|K8 zk?>d;{|DC>y{quN_!5TXzKg+HFO*~iAOK${Dq+H$VY;2f-DBg5Q!av_il7)B2}+Pr zm$-gFn~Lb((W}7}j?TQsU^s-Gg5)z#LK_xWMi2T7gCRcbif;*UV0yvz4>%cQH+2Zr z$1FfP10Vq-A@CJY?pQQvDaF`pbff1{_quZWIl^q{xn3i(@gDX9{5k27mpw@1KSvnZ z^Z|hx$^`xm(c*h# z@M$1u*JQ&=iy~bXj?dJ>h#EVv4`B}Yw!x4wwnYSuZAOg`oOz;!_&bW_=yTbM1V@w>9aV9_mqVUzb!g}uxM-S*ZjF=2aHql)oQ4h1jiA0wrLBQy@G{mzzT zf0Ma->^i(PPQ{1Fh{HFo(6bTVj{=8o>5_fnB25Kvr9BhE#pZ`-+muPz#)9npt+u$t z@rdl>xRbjBS5NB12B)lFYCA&?iaDTXt6tj3Ti7IbqaCWh){xWV*=Z6sFDaG4ZS=}u zN-rv$B%3m0YEUFpe=6!!;))zDNeIidXX*O%UKbo_o7%0qntRn=<)9)ylnG81<+R~V zVecm;ata3iqETIv_78OHqrdr`}0P#{RF4SiK)`V;<`Zdgt z+TD<~c={6!d+3xl8xqR7+7F$wZfP87BQuZ^d9s~JP%xM+Mo4jvg-k8$)f_e=g#eys zkOb+i7HA;;?*@?ISgpnsbR8Fii^rxx6>)S!0{XDhJP7rN=|t`VJ&BwH z)C>wmsmc?`bu0r4hiUa_c03AU#EA*?(E>H~cyBsyIFXOA0$%C5ClwG}NmA6arNpP9 z8CrhW*S#Uq3XAEQN@*@Z_Sr-$Xn}_UD6w?#jj(92z_QvP4E4m2cP%fygPQ zMi*KYBkAA+9T%)P2+EJ4ybJH?51ZriB$j#so02$dZ1?M#EaFg;VkKU4Brlu+|!2L*6uHrqirrduBtWO6WHoB7&Y zB3qThy9N)|^$K%T)PG=5iD$G`goxkPVP zkngNFd2gG^^Of@?~Co}N_Aw;I(~&1y%feh614 z*E09oUdcQ}_r{_5)mPk_dP6OmPifDqCbg2H~_WR$R3nNj6Kl~F6nMgAGXiI`C7BwZKQGJR=GJ86 z+fJ0I)AYLbNJsuHRu!k2xixbGNDSd{3pNeL?t?;Fpc!$*BTT#kcT_VjxGLfC;KE>T zgpmaz?4o)b-!BLp+b2@r#w``;Si;>0%pm>~8XCi=*j~L9E>y3Ob!QLc+9d2E@;*z3&x>s}70^ z@eR@}T+0ruAQHL2K^#V#z4SoxZeOI<2I1foVzjQC;!98>nvN7((dt{2(4gR)O8A+d>|I%Uc&dS-)o)T_H7}QhP0_r1J#^>)wV3 z@^c)DUkp7pIFHujLD9rZ+F3Y6=l>aA6|6@i;cD-|$s9l-|#DO8%qw4-uW8BcvD}A3nIY#HK zVs@9Em4e7yf5wZd?O}Y|8cvdaa*ls#ruKOf2h)#vz~m$6Mt>8s&linFuOy)}79r5C>Z~cSP7b>(Uo@`SP1uIu-PgJ> zE|osQlqQ7P2aF#;2LdCDou-+?iz&+2BS^*Lermd(NeBv|nWasgjs)RK>K_^n%>f-o zzh@!BP?M84UmDPt&kwxuEaUC|Np}4HYxlQb#tffO`@dud!=L2W&!aK+e>zfQ{p8*L zK|B8Yks8CFiGlxg-G7$7pr`+YD*p*z|IA_hdAdi>{t29B`!6s(12e<_S_t`XjSZj0 z44*sxw`K-bhCk0E|81?u@DFhdhClS*zqB6XzaO{weeM5Nt@j_tD}I0Q|5AO-tPKA} z(ftd0`&r!aw{**2^6x*0SNw6H*wJGmAXgxO2Tr%nh4`7Th&06u7KG`wU>KmUenw{_^1YsMdLrb+50m^OyYy zFYlirY+SX{L<3GU?CRkvi;v3&%Cw5l24b;!rHE_YOgn(j($dCPSG4n%h&Jmlh}g;J zSM{Gv){(Bm{;ABA?hd1qCpKhr)xvLz_ifE2bq}YkNa0u_EP2ulKfMI0tjsG+zdg#3 zPvfUcT{Lfm(O`t#%1j@{P$6ptBiFW6P8``lDV`?PS_$|+rlu<`Hkx%yZX7K|;sk{S zrQn26{016OSzCa~X%2Fe>SKS#JoIpM@Nil7eCrb$fX%qxKh!05H)Zs6M{lAmhb06% ze>vGNK9QE}U*S=v{X9;jZbUmWqRmQD3-F<)@Mr*S?r}{6TguypbXyAU=eFUQAPfKu zTAjOjHp~fKLsQZ}1!`goLJpv{>WvvjGty++yM`ot-F7LC(IO+we+LovPnd%%seZ=t zO1pwoi(v0y`N7`*+RF)WnE;eYyG;#)*24`n7!r7ug@bQ^A_wAEKAWeYrGA8Kc^e)?Ho(^p_) z1=aw?A$5&rqI4UfY%Jdzx`|SnLoC_Z=$+*cd(v&H%uFcthFaY`rPT_#6qB0NV}zp& ze$!w|DmS4@(cVEE0Y5~SC+G$10DM23+)`>NrSi}`aJ}6PdFzz6&{XGk)|~FSPz8>M zjt^g=z)+d)LD{3kf!y-LrQdTpFB|7xRteeWgdD-#$0T_ zxvPR6EZu2k;hbp!VvVV@x)Tn9ha*>EKI8std#w@^VpqkN%VqSRSaf~iLDX;I?6r*z z3vU4su9(ORq~pAYChccvSGWO`AT~jOFr-<93Rtpi4~E!SU(Hb)VWB%FhHE zBrXKP`8aHu@g+GbEgJ1hi-4m;6ke4!nxqMkK+0%dgg#tqo!&+cm=*Z|fFFblKq{=D zD7=n@sst)Oug@fm_1M?x(?;U@K=5l(;>gdY^^_Cj+Z%==!1W^o>j2DSfocm*+KE+@ z=4%QrK+`v;GYH&5=A2Wp z+|>DfMoRHQYXYcgQ2G{bdPY{Bh~Qq@7AIP1J-X0!Zfa<8btHYd3`h-83FJ)VLv#jY zI&#O%iVTUL!Y$&&Bl~E?;NcT12ajBr7?btnP5Cs?W^PExhz^?wucFI}S!0 zmiALJWx3Lf3J1<&v>>tXQv5yoK<1Gd5eWQ;SO z>`~u)Tm~LL5?D6^G-#2IY{aB?&WE97)E3woDM)_Yu&}d4nda?L+H~Oe+(kd~kD`kA z!X7Y-GTzBP;gM#b%Z+mrC$mTF?5cOFtqL{Ddp@ejXBqPP|% z?Wr^YpR7+!0E;1DQ{IVL-Ga#&HW;R9`{~ve>d8m?1YV28*Hz0lA6T_gQBz}X6IXv7Y95Tq%S zL~A8jU|7XA4CH>viEb$-ASb*w5odm1GhbWo9F_5{Tp=J2|FU;rI_T7?IIg+wM9n4{ zIs2GzXt_a{#~}DQ5-wsEEi&Wm3gZp3f8oT{l!u-d311@D4UHDc#EsdzW3_hp0lpvvk?RqwT|RZr7$z56mw6)iS76!6S9sne*6 z*m&YyI&$VMG4v>1pdKfjd8vb7bs)G7(fU0Go$WEnJxl%7>emXK6;2IC^PFsl%zzb#rYKm6x6^= z*x_YX$o4=$xBO+EgA(vD^;r#hVK6NLTa({U$z2rIAf$gpuuF;1$A;`kIVC;p?*xgK zJyKPVi)CatAju$zJQXWX5vn01fZXWLMwL;F8DDao;pcDtj7w(`GV(;ERECpr8U+-y zvyJ!`k=rr9WAvid>!%?6)MK$<(3hkHxD?#zQ~)c@S7U_MLn9{=1z^rnz+~uSWk93T zY6fu_zFL3<2+0^hmav^W@uZyGP+qF0@l5kwFIzM0miW8+m|UN)f(K~1OOfMgEr4I; zMG1R+1Iv&d{qog~1G}m_rR0Veb@A#$haQZskZtrf@fQgX>h5bh$@CJnHl%LALWXof z2f!~M2q~wjZ+oXoMq%Yiq7=FDbL;%6K{*Bj^L%wpjT&-hi3m#U6FWhec_T{6Wb?+i zZk~B!ZGulatHrL@a%a((tHS%hoXeDS8wgHG z@x}WfjpU(NQoXOJr%j}I5nXyO2)Z`R@Ijp1wj4n;%(IJ_bMA99SUEpM^S?v~z1o1j zn#>)BNa*4`rn-P0(6iS{sWF`}1_$0bew*D<&lXsS%zeNH;HQW#P8WM z&CKLb@_FUVd9Rr=nRl^t`9h?^KfbN_P05EoSQmOxC{F-JH_|!mu=lB#?g-qNHy34i z%lU z*KBpyB?xM<_mkx#Gvah4BD%ogr8Iwz_C`%@w=VX~3Z2ojtHEFk2rv?0#O7w>(e})^ zUJm=&qK^qzI4D^c+Ye}Te3jwe7oD*>w$^ik6C6}Q(U1&+QG9n2*WGxHmY-j%!Ab?j zYMWq!RlXm^ePou^Tny2RJ_oDH<^*A_picx%3%k-lesZznL1EP@QoqMOq)NNh#_kvj z#`)B@A8OF^B4Bd-EDCW1Nku3i2vfLiWoYtgSQ)FXk{$b*li~Ss>Mhq%guEjDbBI&o zX)qWE{~{gWD=D5ITV+{{=1{E`W`OY+#wU0?3#1}Ip=KIAM#f~z` zEH*0D*^sSBw}xAeL~HlxxIh?I>R#8RcQQjRT15`QwU94}0^K6>;GS>cS>X`NHjA5- z6hPsFggLBhSlK8q271*9q~Sm0pDxNTplthgLuM5xg?oK)!PF7g0%NJMIj7q5{&nAlYE_##BG=Huymtw zenYW6RCcyEs($m2vx!Rfr=?+)(JOLKmN4$@-Q@Lt*k`2cV+rV4>^1!;Ac_DzMwnt* zn0j*Kr_eJA5!J`)tBGMrkpqCtDQ$G|{3W8%Bg>$@fr1riS62boCyuv4z2)8Fm3rBgS@tL@^(%2Ibvknxqx!RJ`4>4d}6^znv?TZdyxl$??Q}F@fFtGEJ+eF=pN(~ z=9xqK&3owN?a=((M8z=O8;@R7z@EtC zW~h^42vp%zb|Xtd5^h*1?JG*@riMGeIBptkL2BK12D)3zTai&m+S{gK*gYwC!uZ2_ z4o^*Oc6q{z`P%P*c{tI`EjzNq7nUsnw2434Gs)j4Y)LYmKj+GnDJ5&Nwp9Wm?rW}V z8g;A(CW(?k$l80#b|%&-AWy}V_8nBxZfm`J}s*v zcYb0+N~WkBXd3AnqE*|1?o;Ve>Kc;(qYj41v`v+U2qcqTd)mcPt0#=qvzKZ{psRaDjR z{(B4UXB`;BKbU2VfBHS@jQ?8q_ZC{#&uYbgXm@30{L7sCbKQSyO=bD4;-mYg`~79k z{b%d`H0S>Mp8xHBOl%DQsy_R>8OZpj!SbK3`*WNB^1*&Lv;JRNTA5gBn17${|E-<# zvxn=G&H4HIEFJr7Z~dLU^80o6KezH93dnfz{&pw*-x^duZ-qyzC?^W}+Z!I4iGza; z2Q96>#b==^jlQ*&J&m=UG5K%i-QWE?#{W1M!1xcd8chGsSq-Lte^%r7wg12RcmJ3J zVEX(|_#GDdJND(bdaVCem-X+`LVw?gKm9z$-+j8zPCY{_gWs+(e{y#I$i zw&zdl?z!W6?c>#xFs}l*tuA!#=bM|wU(Fwu`wz75A6^^3t{#64 zN9%jP(!RBswi|tn(e~5wK`uXhuzy%?K3z_1{;GMe#N~58a{jmkTUW5mpB=h>e=1>n z2V$@(O;93B*RHSf|nSu+0e?GElJUGEkJU+*rRdEcsBbWj7I zHIe@UyD{RKUB|LI$)v6iyPl_`B2CapSV$x-{0bjhka|DBGMP2vu&C*oVz6nuLsgs= zH>$YkSDgPIA}}*f($=5lRH?*=u6p{8adxcTTzTfrYW9XmzoFC^99ph5Ni5}gLXj9G zR2F1R|3HXfDxa@2trDs=37Xh6G-NY3JzDDl#!tJeSdc`I{5Gpm}OM$fOFm*Nif8lZW3oClLN;XeE*Eo;{HUi(#BHgKBVr0u-{-fGR`L9qHv zn#k@klfi9LQSDG)9a4)ryGmLay&|P(LHz9CeJ%@znmNOv-Msze zol!1>#4|0ehMLHe&PhP?{2}@gC6xQ)gEpOZ84Y&20=GB9h&H(OXtv>W+kd@g<`4wk zrF3}|*mg?&AQRm6spqUr%C(CEvjw0AQTP!fQcI!VF01Q>{MXYFxH+K@AJm9x}Zc6gzXKS{pk%-Tu{??&DLctVa`m2j3R$a93^84~)=8 zh{I?$r_lQfKmTSn_-X_an>PzAN(nd?6yRk7!PEAN*n;9{B=k{*w+L&I2rSw_DZ`0*(B!8l(>=l;bdi(~b|h_<}ac@1TizTq8f zPOTBR@i;drzT8fAY=!`j-7V}e$c7=bDnwy#e39=$XL6^^uJ^3bg=WwgDH_IM!)^h6 zGf56UClNE9{`pyl9{Tihs$k~1#6t6GZ$QW}3l2$(aJqT+cDh2cT&>fQ_%R81Em#@W zrXWD5w=klVn^_??j;>Vp;UY^A`DiwVBJj157VUE@@%Ge~<>yqlg(3WbbUru0 zu;5&yX+Dp-_+xD|Fsm$m*}a$jYu5C`9U zVHXp)b(a9+IUHctuW#ygNxJ3Xx7D&mjixim*?%rx%Sr&WzD*ISm=zCR0T-L#JH^@i zTpM&!gPMxKWWXM6pwgT%BR$&sl#dl8gnJ%Pgud&+6v6KhV{O15Sk0e-N3Uyo%jXC~$MZO;Y|{42SZ$C>uXdzcIK zN*y~kajx;opcAU<%@+ba9@j=L;#ctSuWk>rUcsVDkmO8Z%_f7sE`C2#q^1gw3Zi)Z zKxrB_b)@0X+3g+pq+rDl7X>Y(SF6CI1&4o<5a&Z;0_01T7sCgjVf>sotlcWOn~qPY z>5uEzS)NRQOI^GmrvK)oZIegzReL8e0P2Um4&>oJ>;4(@mDLVVlmoT#j+S_f!@`wH z9Sfm>vmfOVTI|O%_=k@U|B?f7!0XkWkSc7ePIdo44@4 zU?m?eTi!AjrR2AVLlT z5k#q}v@c$*O@-_bBLw$e0F&WrUG4ldLgEV6&VWPPtwbggUjA{J{1w8%kV}-=zB9&V z#J4e@@a$9@6{fzYm*E$Yu1imnUh)#;5&f%JRWJPuI&165|0xk0Sml39uh##s`Tw*(Cm^HDP{gb0YvV6vc46QLf;?sx@*^ncWfMBV#dqSt4yWM(Y_>9&=| zmfso3XFo~y$tLf_$n7JpND$Mza;AYxFWG)agu#fk6xp!Z-3J)1Lt!2O0jL)s)Prgp zcWm`?kV+~@?x33^S2DRqu;96~#8J6sMx-uC9o=s4eRly7t^P)*OeT^R#~q6hg(vz5 zPR1}9fiAaW4rB>FDn~!s29cyTT9>NUba{9~mcC7y-kXS*lIOzRReL?41JE$hLv^kY z!}@&sRo5!8VVupkZ~}-qDCJE`ozd}jVmbGsm~Z7v;N1bdw0NAn>v&wDzR44mS2T04 zSrmQPA@j+6OYC@icELK|<1^Q*?>2@j)l+aY{h$F=jS;qr-;Qj!&s_#}Ew8qJFq(vcs-@=Rs_&!p?PAWONaGpU%q3l;C zAX~mi3@4e9C9@^WT!A13xIlMz|8ki!he0MchUn`;4)`$C!&#vv1J}1+q|*ch@jf9S z;%OfQo%Yp+i&Nk14rJN`U+7kb1x+DES><~P#?AwZ`PE}O|VNt4cidt+` z4dY)r29>m`0w&r=I>Zw9$!@ejEF=uLIg`GZzD_2nFnv%AB^icBXkTGh!zio+3C}0R zg!gO{E_D?w$?DP)Zh;P`(|OalNGB{fn5PGougbO(BEY_q_Wl}$VB#2Tm4e&~D*&1j zv@*Y>3O(1v2?oM{dWg-fsaqJgT*Yt0b4n6H-)Ie#;^idC| zNvZmBb2bn$K|tYY@sUn^9o5g{nZOV{avK1g?xT)Dt`ol$8UfHUmmmONy46@rbAkcy_zg15y7uW)BVO*tFI?1mqgM0La&Y*xb`J@ zKW+uAR(9wI@{gk)8A&i?1oTcQdc~6D54;i@kG!>Hh8^VF8q^_W`(zu*7_%kN*%&*k z%%p|Te>`JR_g$%hl`9M{=fv%WQbNlPdyuofFGD8Mc)-c5NpeVO)eh|RITU(m0I;nL zpAa%UeyaYxv5u$NKu3b*0<*-5(ApLaXH_Cm-)hKhsL+rP|GBHthQOB*VnZE-Tz?L! z^~E!;HHc=WechDerAcc9XzSAe$%C*cK>9+S+899aJKbC|Z!ki~gM`30-1J?>?krTQ zjEIdM0dfcITLyg%wr+|an=S*SqnE`$b0zf#3r<#5%+)8i6WPc#+r8HjOCd@OZ*q)|(NTyU)lxOPql{UU?x z5^-OeUxsZyhkcFkPAEXPIM(B-PacZK>T6u=Wc$7g74D zjM@9_Y1y1uq$zs1#)@%igO3HrWHx~Kt%B0Fuke?}ud&%Q{^K9??cQ!0cAXftgg#ps zbRmhXlZb@!W*8{f6VD}^f_$6a?NAIZ{#ZrPfRGUv>`TkL$$B22!?(;k#Tb+*Gc}mU z%b;nw7A`*j23TjS0YZfkcFC@>ji9Ove#tsBtW{#O=W~7Na2z*J? zpLrp!@F8!cTb^C?v{jvubiWfZF@Fl!3-n8yN7~X&;vL!UJ7ml-$}&VnlG!of?0to& z0J){bmijDR1JO+ZA!Boq4PpzgE@q7M^UFrvcvt*Sor3}{{tJXLD%c>aHXZNH!*~tI zluE5<4v+#(A0WQ!APzF@d;4syE;`qGc8uhy zeyg$=+iq*r`NB_nFxr{3kr&S<)-srS_~OFl$a6G>P2{iQ$Tu;m>!1}o2lsCcsM&vu z>jM5Fjtt=9U}C-PIQ@H^mHoH4?qA)<%F6ba$(roH#dYuQ`#t{5$_fgm-gdIS_kF*` zb?@$Dz3qh!inYT3+jaiExbAiQmi;!C3t$H@0e&{pCIPT;F>&7}e*)OK?vg+MBCacD zXlGBtY-IYvkep4IoYm;(ZxbsEL(s^{^u-HPT?^32&dJmm^pCNry@`X~zkXJ=vU*|n z>qi4NCKe_D3+QJtD}B)4k8~{^bYFl5*SVaaDF+KfOZ%H%+Ds<)7N84kat^wn98cDJ zA!7F5W0XHTYX486?Rz8uVG8WGQGEb_^K&HvlUOkcs=|0*C}`04Crc+GhQl3-qllEOadmUYJ@M-Y3O> z2MqovZn#GZ00>jMeSB6B-otvgIY48spXB;OxqExR}^(73d#I00RHO?5>TZM%MCUDSP}s4m%*_AcX{}~ zv^)UbV8QUrzqdT#xW#>cmBDb_;_ClF%Y&PHukG{exA3R6JowvXFgFi={WRC7jIjTN z%|U~k)C17WjXkD(J-8vz_24Gq;CgWVCT=cW%jcWHwUoLU{4A#d{hw=&y?1QM&D*%6 z-mkhE;BBhI|Jqi8uou*C>R?_w>j*qY_uvtzs^)Y6)Thr&7lNC?7WTswA~tWR+-c+j z3Z>EAPylg8agpy@G;IF_%{ta0WBOm*sK%A;^owB_A^c9J>^>x{p>C zwhOM*D!;wCJT*W0B)DCYLHHrRxh96A{OkU+GcX!Oi;swcz&LFM&#SC&bI8Iq)+twl z*3!YzuAjIXGv13_SWRMyO3-D+vXp~oI;OTnuYA1Xxzx)_3sf>6@S>%wy?jCOSj^FT9^sdhWNflf>G>eWq7`7nH-jE znH=yUZxU}*T?qVGz$+Q8xw?pZL{eyn7S8btAyUy8VoFi%CtI4v7%3pRkA=!s0tAej z`KHIvpe*VpbZB)oID^a^H3)VeFST_UyW=BUcFgi@I2>DTc6O9xiD9i*dODs|Lwx=C z8*vb|iB>%93zf@iCM^jFGP2~NCgRj4m725LBJvMFb?9CG@S{pu#4v9Ha`eV+Tm{HB zUuC=Dj9hqGio5b6D>)%N!7|Y^++%qVuWBA&8h!D{;N})(?YSr z74RjW>(oj+_RiAh;{yci{A9+RUgq)Gs*B~_iBN|=v6E&?hTIcNZI9v~VzBz2#m_zX zlQeMi#cHB<%@%dtkpL!0l3BEs62-(|?qcTqW$qH@jc-euC585tRxtBukQ77E?H?VW zEz-mA=)TzKL5t<_nxGg$BCcBT9b{Jjq^UJfo38cF-Q3zGT#BTzrPknkB1zQ-?0G>; zFTS%2mN?#E*Ojv2+Gp6#WmmjBH8JLbeNXT+v`Pi|Ib0^=+Pqd%uOrHNm;}UFOSx@Y zHd_1M&j?G0VK1@j*k$}A4+N6N3pRYk>UU%bH9h7N`{s%s`+V}sbRR;qwjV{*-brl? zj8AgkQ&usPc~nFTFIa3rPkN}sxp3Yml99umERfOVc9q`X*?b(=@ z_#L)(8Qok;H;e%?EHW=5QkVA#5Bm2Ah~aF zsCRb4gwk>qjosjeQjJihdeTrg>_iSj{*(Zg=iH8E<*iWBZORp074071~dz z(HPSx%~WpT!S9laeNaqwLU()#b1<#i&DpPwF-%j~=q~vXYGNKP+M{4py6ipNkn-uN zlgx076-?%URwvQpF|mR6{S@z7ttKl;B7PE^)rjyErFVbT84Z|M)!XX#{DtKf92);_M3g;q38O z^jvH~{m^aheF3;rZdMh|^aG46P;D+dj*L=QLTBdAp+%`ZWki-#2NH$;*f)bp@8luI zr^1xX@e*)JxLhdS6o572G&wwcnA2wUNf_K= zALkLd^UzmoOq7okPYS7QWjWM>{pY{Vjq>s3*Q6FC;2H)i4TLT3w9^0;IeM=sCGb99 zk$2Ll*mhu?YQTI<$@R9X^VZUH{mQk8t3)3;WyPIPI5todOwt_j>b!Ada(+XeH6nF$ z%Va@0hQ=7~WdM3vopKvh1Y|N}K^i5K$};N_p9JXz-lCQSy^Q8sLz^KY8B3}?xPFs1 z9i@M+o>U9dlWcdSJTsrSs2?Mtrol6TXDKo$bdXSO%p1@xFQ0f1XtI-4nnJpD(v??# zGc>{mYxHtGe;_r)P9hBtwcmW9|BC%H&9eLxvHrpUv<1j59I%!laX7Ecb4SwV_%S%I zvcU>1MSCU_AW*?O+Qv6`Sr+xs*^A2CN*$G_h4VebHW4^FopgrTfCSj6Pj9}HK}*Er z$5#!l_TyKh>uRY^WEv)4bG5kAB!lLrkhRQ3JFvUC2}r(`X_*ORDIa-7d-?}I$r=Hl zdzIV*Yrec_L+Q0O;)m64zLCIvg44`t{(Sex!dYB3;$Vp7DJD42Gy!zlj+JD%;a=GE zRP*x9hLhOju4xF3iamGw?}(7vF@6(Z2j}c;U)2+1w%+O+%-4=C(SLXYxiq9aj+Suo zb_=#{@70>Ce?YcN(s@cM!CuVf=ZE1Lo}X7kwo9^cX3{!((KJ>HHn_PrzqfFU4)Run zuOGUSdSo}4OE`rz%63;a4aSgjf~jop1KD-st8lUxXk(v248P4f%MU%W&gf~No(ARF zMc3FLF;u*8y0mKS?Mniq?u)BsCQW#2z3_5Hpl(wDZGkYuZ)6Z5xd;V}jeyyR}!IfX-!v*eH_iEhy zS811;;*FWG=_RJC@ukKBWJyn7Su}w`_X`OXn?||w&}!*n)mep^ld$9BLB!&og!*i^ z5Lz&ve7=G>5lNBEgeB9DZImp%vKX+*xFx|U@Pz^;J0o?yoDk1pYPNvQZ17HPcejgV(d5YCKnY=)3ZR zdiu|CWRF_c3YcB^rBxtsUjvT~l~J;e7kCJ&8!qINE#oFq9ufyKy70S@n`)Gi#vbrJ zSI|~K5ezc{2YaN0C)#>gsnh=~oI@_$-|-8wl1zZRNVLr=^!DLPw9b)x*t&lXaV|3f5m8HuXOtf=r5r5q5uGMd{5q$=Z2<9CEQ{o%-2(i`Hea zr&CuJ+{NVQcUm%_EN_Q%TT)c1vZxz2`}>mgbJIL&ZW1Q4ji2!d#d{i*9@PnjL@qgn zRckWSTS0LQRc{E~qURMbl~q#_A>=%vEUCueN`GHTrq5y!l)t$IZ_sN&^nlily*hW3 z{h{29OjvUeAh{%+WL-xCwR}axLH^R3fW;=%{s$T9KrU?pz46`;$_D1rr9<6S4bvX~ zPk!bvX*sQ`XDi@oP@QuhKb>r^E?ZiNcTZA*lZ(=A)=SIwFHosW9idfU<4FO7^StK2SAf|m{`768Q4T?P$AZ60g_>tf{s7iC8attvezEo z<=kmbVWICJm{sT5btC`L7Q#u3?sgIxq5Pa%ns~%E&*+;w9ktt&QpF-X^Jxj0e(Zh4 zqA6wWaSn^%f>BL+R%p=x6W2T=1e3zi7qpNjO^?lr<8Xb^^w~L8%^We^=UXpS%!EHJ z@>p7bvh(kZFL&zHs+kc8uTt$`b$>7AaA&14hLC=0WIIDp5@9Fye{=U+mA!zLe3YQL5;xTebs)O*6OtvN%z zRm*br3k-~WFCm#+8WWAf&-tu;!BQ!+)u;V?u3x8u85yjh zY}LmhI#`i9bpylz#9_^I=|_-RFK7{lAcbirezH}{;is=wXtnRRFan7X!u6Gj{CaS% zDl7chwm|gI8)x$x)gTqR+DQr5=0%yacV-W^j@`LZARMqJKT?$h4 z<_?4(I%ApO+pC+Ue`@n>=`gR@;rlC5gn}4R@s#a3V8;AP@kzejZR~OnDZ`)tva4lO~C3jZ+lerj2U=o znV4L-iR)dK{Eb#<;1auPTYdPkhl(@%bZ4eJ&zb6QGCK3tCYb*?Tzl!NWaT^knP5DR z=5JgVtZERGe5s3Xw^r0&^v}*sYQRl5IrJOTExOT5W}f%C3Oq=4QWVgMz$LCti}6dQ zX(%;HB&zk68Fze|@O~=pRkuGv;7dRK*Akim$CU-+uhZqPV3NlJWd91Wy7AtweL6OF zj^EmZaNN1-pbUT3Tg2*j1c{vmbVll5AV?f{@xFg^9~&Dee(@I-3>Sh;>3 z8GKEfTbBD%X>cF9^2%D4j zS3|Eql@IPicbs=t$v>b0D3=9zz3s1|J5V7b+Z}ENO7QrzlR5zRu{+K?3+wOG0Mtj0 ziR(@#as&TG0~SzW=TDyaQ~BUNcn3Os>gTyd|AYnrCeSfeH+%p}>-a?jP=44Sp3cE~ zAH3uIo7UoQ**zSfGGgE@dVihQ#dfPBIJjB<@O%!|`xY~(W8y#N15S{2^wSOic@3bn zy<7W$gA3Ge@sCdEV7+fGf(p$4F%39CGT?eET+77Y>;n!E$baii{GsxI^}g4@_0R1@ z4&W~j38WW5*=@JZFb4-H&*@K=iMkescGkN3hIaRSNKkO#Z*jwKJ|qW765P4wH|;&| zb_5WV;`B!+y0PB361e`RwfH*?K%T-~BM1Nxq!I3D0J0c<=63w4UIXiW4axO4t;KsZ z_~jvy06>!9mv&$S<$V3r6o05xV7sp&x&EHD_CPvziUWPvifa?_@7FH``#nh|G`=Wg;lw3twjK+%`xEC zYv2Ijc}Bp=wjSQ}dCT5Idt+UmOe z7cKeE?M5IM$XB|x8(CRF!R%XV073rLtzYpcQ^QW%+TQl&kCB7rO#`0$l;Qq+*5vOp z6Uh0?g9620K{=AQdj$w8rn$`?|05~mWNT_~YH6%}%P;?h9{=331akiJra*d>n~CK% z>H-Ae6+d&y|4durjt<(_gt=cv!TmR_%ipvK5R^23>sNvNEmkJZTa60j;J$0w^+$4t zr6t>apOgFVS(o>A2uOq6p)>#v(5|@EuAqPaaFmAazR$`1H?7Ox`2ci?z|UNH5K;xw zqCXplk&pmEwE4498aB3jo)-7tvo3!}s(@^unDm`>3923VMFS9KaqE5jse9qRb;ag5uEZcecc}UGYbI z+-&!)OYZ-Jb;$zqsP1BsziUYlW^wC%{Hc54e$;{c|6o(H{PL(kmIBDzyp2HtL72tu zfh&J14entRpx5}fyiGQ4&~x8DD?9ryJAmYRd{|BK*0xq=hWhqQmWKBK ztrI54f49i~=Mo++mg_r|@0IXyv0UqO(A-@K4;Ra|asy5L?e{>DpktnYp3z^~?=*uLm~^y&haEk(>W>ElF<%cb|L{-@l%@33A^I?mqb@ z(0Ma+_sKUQubY{>PreC$+|1m4GS}TF-}rjhm$>iNd}H6=%-pT{#?rf)xm)v%&cB(t zTl0tNr2 zXHYEAg>QFR7k#}&fQ!CMzDjH>%}xB)F33MFu&e01B5P*`hr>0_d$g2PVq#rD@d zf1GC2Tz%`@Ssz^Zv3~0Q{p_d)$Cf$-(bIBwPhkt%Xg3u}(2RVquU@cb@8ieswU^Fc zza3UxTt(o#{szx*_E+Cc zw+H9;FG9b1uO>q0%X|c12NR{Q5;7tztu;rTJRTtu>96j#9RscXl($w zgucG0;!|QmAAXA!ioDBQh9P+8!t24MxxxdKZ+7gDo)+^iJrdIi*h12W1rQK+z{^yj zCyTuy?AOeQO-UJht-=d63RX|IQ+V-CUUK)9$y9;Er*~)Xzok_H1e1`n+Ipmqec zzKmF9xYDJISvur}`;qrYGpArf>=b>`fYqgc*FLIpfGI<^WxqOKIH1v#ZXH+JW&9;& zK(%Wg(dd{dxMF1;+L1Fq#?0rv=Se1_NdaP^&aV2pZW!aj`@oGf<=(KTyJRz#U9Pxi zZIeQ?zMMnC3*~tE<~Ar6&+|XZTE35((ft9>j&s6}GslJXA}NWO7p3vX>ERL17D3^{ zj}fge4W&yN3-x%hUrtr7u;)Gt&iyF5@YDX`e6eFSH!>HOFVXv>V=3fINn)OGEA%JM zLf)+miZ{mMp5n7md&~@vX|_r>c*_X*RvaQ6%h~qVmy%Ks3eTEL*`kN=ypik^O*q_< zzb9*ZZs8g}Jw+9j0!Bs>;rTqRwhXHB2iI~+w_Z>&uCh1yf_rvizig1kHjhz&Y8Auv zmHId--p@fG#riGVYqor%EBNm+5>~u#VuWQ@Cw_!{aHve9wqxgCPj%R*J zlK_FJGl^fnM`<6{VggBiU#!Ts$eS*KDz}GFre>@x6R{b^d~Yg+vJz6))}kc-mg~U*AcEMN3$K-E>oNd zP^^gM8yza)=4=I+uvQU77GaUH?#xmN2@XX07)&pSSIvp z&b*pMwxdmQEWV5)?AE@ZKb5a9;Ar#Kc9D2VogV!zjV9^HL6m`#4Sx1ypbA!zHD^f6 zi7_%d@O@V`emRj*zJY}3E)V(L8Js>U#i3!+3iSNJ; z8xW`=1Ff%G2fGxCnzVWmam0LLxlG&>XUb7@yp`cavs@5kVnC}sBhj;Cr)~>QTi(9B z7tPd}i@|aWUdPx3LO}ggQZA~yF9RVSv+{s@@}8k#(N7P0Wv9=o>ViY zJ$vPVfPwldmaWV(XiW#o8aH2r3sD6%(1wu+<_%up)B5WdhpbLY5I`H$T8kawI~LaZ z^DAsisUF*uzH4qiXXEOB8LNe4X5iXk?We^l7E=p`i_Auf7>F0N1iGcIKWvHN=Jf@q zpay(;6v!DCv4nU>9}3HGK}xM#_fubV#Uw@M_63iwU$)*IDs3CKU_ z#Ar2E5;)j5#NhjK?i{5{RgjKQVHt#lm-?VIEC%&S2OMOtCITj2tCqnG(o+<+P(*nj zourc{R{RIO+YIFKmaC45^y1Le7*9I5WxBXiSCv8~ec@sWBhq(D$yY5-=}k}>eCciF zloZ&hO!gn@bcS zl3g`8wHm=w_Q5QO$`zS}c0e=|69+ZgmXT;U)W7E|baZk6sIVgtbb*xOvj$)GIvYim z{q;taIbLRvf}dlaB;6sX1U}an7{-?1iwWj-?c4`#z!+(-hcf*_5yhtc&d)l`ce^Sb3+>EYH`=t>4?#nMnjr``IiY zDj;pSh%|W(=oM9q+$^OjirZb~%wA%QYr1(YAxxeJ>QEGuhOKJwB~P%0RsLMqk*iPC zxp800^b}=R>8cG*3ulzAW|?b1zovQV!ApYrDQDszfeCd>&ij zy(ti%TwZ=i=aS^^#L1Ram$dKVuBou1o2t)B<$-eX(!>#N2l~*uLP4exQudD{VX1p{ z!#n{KxFE<-e1Db({qYe+(|Z3xGi2gJcqyT?A6|)UGWiQI?=?RS*Wz~ItmSu`_(T?c zz6dSP$r35xFdT1?`}j!x?D#?_wzZ&+GoWH;DaGFDz=3&Y&su$8i&(zEkQ`b$zT&NV z;^t2GSHE|&1PhaU0_r~!1qOt=Tmr>L97Nx8Gh(t7_`@fC5)rnWt`f3yt^FzLjO;WD zBS9D03$zf}3j%L>K*p|KMe&mva_>x$pUr0*v?N0sN=TZ=(vD%0lFY^w=_VTpK>TkI zxNJZ%yJ)bKxE4PSdVlYfxZ?H|3N|bC8|FfwP8u@GlNE++HSw<^KLKm_Ab+v82SI z$bBgic*kN_*;omZQpzNh1*~+rM_l+;X*Ly0fTxvySYO)~5T5GkY!8fkQ#>{xl_f=AIk^)Qeg4@8E*rpj#fTqDzDjS ze{*kJgYdb$6jwy1t%XgGazhxDBJwe&2;2`d_Xhn@F`DZ=p21F!;)5KNLSDj~0AEV_ z!PK~GctJSP!lv9uALiQcFx-N2MG{0S4d5*wFUHTdz=dO>q!mq!jzv|mWlTpRHX2)wlTBQ_2utGG9=ID1nfLnxUQXuF!??AX6gIpV0v}Ga4RTwYXhhwrW3X{()*Q zOG0^Gdd=X$1E6Nw(lfIXT(l5xg?ieFmC?`6s01;j9+!N4-HwS^E%}!oSA^<9)nqd&~VgKG6*;|T|pzH%H73$UznAMLC`-~XduPXfk0ro z5UIc(zJs`r_uevStR>`umqHY3QvnU+xhBGB%bnOX*A*9ekU@sJXve6CfO0FM<20TO zb4z{3)9S2dSVw@EZQ_q-sO@&I)+yGlp+4tOv;C%0gMpbQ8VY>?;#^sLXjVu}1VdOF zXf{ZYPO_LxB`vkTR*xeA{-7(qc;LnDF&r-jP@mL;EH9=wj_;GsC#tGiX;>f06_3dt zy^TvfRIwmPgxp+1pvq;J=QBU*#s~ERdlR5nAl7dx{%MbFF_tFFt94N$Q)PKN_URex zWe2BxFggQhTDSpFxE_1_b061^(<h z*Ho>W&U692Z!9)b2#CRrxz*cC>)+F^-r?Gxqu>tity z+$a3cF_5sUMw@j&dowsscr=qWt5DcbXEf9NfFeFA2Rh-Juf+8>6-P5iSj>j1oY7?m zm3)74D|&CAk}o${Ik(}aywPF3jh}B@re1QWI+bPzTcg~7&KCo(X1VjG+9EEX7+aOU zbv{yaQnC=23I_22!L6O(Uu1zgP)U?(3SphEwJ7)ApKXV{DJi)W-1Xg43e$)-*@#OT3qkbIYFy+v)Uh z3wFZJy(`SDDRb>sF;#eqItB*VxE*qzXH_4L;t;tfW$M`aVaR)Q@^A`NzBz=Gl%((1@!GEXbG)wSIka^+M;HoU$ODf7x=AI< z+}ySpnXZnvFBcaMQraH7p@M70R-DKN5b#oUWPy1_LRntR43sLe_$qypI`d zZ7E0kqh-%P!W4x7?Fs1Hnh8@WIaO^Kls{a8;|K^(sMEki3XK7fUs*vde+q8=ZnN>6 z(05q0+IG3?^^j1rM+9aft#DR$_aerr>?>}bu=;~BksoLy7Kz1%`xWd$xj1pKh2EyA z6sGd<-Y--Gs&sOIU}u8iNOV3s;YMWz7Zpc{RilyQ==+cOkfGq+4(J`}uVOt6CFzYc z51jQoS>#zP`NKmOj6;}6mg7sb8;TwT4Liq2LvEk{1X7q2o{&iSw;NP7WN>Hc2l^LAG+_{K_G*+6p5)Uw#E=siTNDt2MGY-8|AX)(X{ZbO~vahpDP@p_&*PwINIEO}Rn z9v6ABvjHx+MpyY+OiND+%;ScaAn8Cx43v`a2;Y2l(>C`qb=5bOm@h+P&I~i`uQ663+_}RBoO+o`?m+_s0 z8H>daXP2cDx1FKis90=U_;gr}1-oMQRg>}pNFNA(?lXndNP-BV%H61LE;rx*Py&r1 z-+E+_auxzd`P9~4Sh_!F#qY_7X&0XfjXZQ25mIkRRQ3XcZ{jmblH0;xNX0`WL7 zPkUHNwpHwvpkbE5yb}UMS?#!x_LvA*VX~yBVi-zC249nI4oZVNiNV;F|5!xVU(=B{ zpFm>t@8&F}(`T9Wb8S@-+)mS@kY{r6}?07-GPaT|8( z3G$6Pk0sz<=MV7tW7e`p6IMByyMhNf8&TNx?73y)N$tH+==i9=p0>|i`A)56L;e|m zvx=r}{f9>qt|1Bu`VjGu63eEe=S3^dKJD~Wp@Kf8@)fRc2tbFvz`3@p2)>34IN#kL z%R+h;o_CV&KklEvxUp~m3uW^T`r-0A1)h6Uh$4iXwKW znI_^=FCR97Ol9xO#Q8pgx2_3d4Kh{NYh zrrWtsC+S}BpuG%21^9x3I-EJ%d6g~J(nUu6@#j^_@4fhvjx~&M+Gm=R`j{J~LDJ?C z)3s6Q9cHFU`xZ+tDwi5#MqDrwKTyrbDehCjZ1jTl;k)>4@;1fUg(H7r-r8ki50{xk z%ce9OErHMBdLQNrza2;NaDJI|YyvZ22Zcl9O#(HuMq-5{P;FtLo_bY>GF8&?(3Vir zq;w*O_j|;-4_s+PLrmusughZptL)f-uw+>7z8WV@p%izJ0J@Wj8EBYNXF#OFbKa4$2yr6(3d``E?_CgC?95? zJ;q4|hf7miEu?^-UwJm0&1Dpw+L8ebC5)T=#B1D?Wwk1aLmfNTD>TB~d)(xYFJO@q zQqm;w9?zQaY@^Q2K^;2vEHVL%GhJ2cr1DAcyOmaN1~$Gc#E;Q2{imPzPb4dt_xGhZ z`s}h8;1w!s9@7G6a8M@Ss3}&a9*H7|K)y~5*h zjDdn2mn!rahEA|9SvhT43(ir+dj^0_UTD){&dK9CG)m$KOdFj`P=b-NO7;{k`Jnf> zu%npe7|*8>Ol<=z>Ib4|23~(fCHLagg53c8;DPQr{E?aZ%)teVUcu9IzkyV7_f)77Aw#n-8YL~+>mqfNu<;gB3;*b#*6Y`MT+>l9nv(#5lE!A0&Bww;cDTkB!D)Pvn=kuS;)s@P@hUp`bHqv_ zwb!Lujw~^~m4W29qsEc1$vJp*@pfUx%KhHr5o?O@Zp{a4xe-VlMFy%UV1nZdZqUtm z#aY&uuV#2^soEMCW;>gAah5DGVnJO__zy??mUQ0kw2vw|vqt($r z;`|b-uqsEx!m&>ecX4VVuVt=Mnon^_z08-kJ~kmo-(*+2*f#ev7@mE~Eha(*F0UhJ zV~cIrQFpE9g_WE(PUKu*`@R4JbT@S=ZJxD7Tx>(?O2BKPK;?CV0=iRZjj9h-uh27! zo!s%_-o?zDIKb5@-Fy(1U3fFX&Tv*H`A%p)P9QJhg2f= zb3$IC?58oeoRftDez&pIN?AUkefkVY=Q~yfMdqfiD(Sf~lU;!%6CU4NuKgD(euaxi1H~qDRHgNYoA2PVNx0i9P3xY+Jz=2+kZ1L6uVisiYS4vp z+sViCZTe+L^AJUZNnuNEaMrVZb#B%?$(9T6Lt^va;^eU`mI-e25wXW1#Qb3}(6Umy zZ=8XU5L1@6s7iz%Y5aKCOkb$+C5HkW|Dp4F)Bq29GFZQLJPVgZTsv2scjk)E3Y@Z; zutB6l+>sD@_WJ{};k{7K^k< zre}G@t-s_GEgeaWNIM$Ov-Z@4O;;Iv?e6VJN^Yv2#Pa?)x;!HsIdchM;5%|iFn1*8 zXQFyzS$Po_>0n&+uxE0fE2(_5a~ex#PHi&1VtE&?)0;1`ajSHB$eZ4`@bmWp2F0YD zp#&#jkR^?s=nC#JUZ?<@lzjhg*uF*7%;U-$Z=p+{+N_tITy;%29?j`^-F)``dJBML zUDLrZ`uM}0mG>uzib4*%##EcCSYa~u9~3t2S;f>T;WiKvOVjoR_Lc6B28@ayTx=PR&p{F(`W z(SPA55_OGFae!dNUq{|?vD{^OfchG+{p`PR|71pvUnO+cZBOrx%Hv|W%Z&Ip_i_9y znfm^H*HGFG?)cZ=_wVil+#&G)=KI+H-8%n!CeQzZBLi+g!}~Zg;1C zdR`J(JjaoCL}>iphQ4Ujzdk?ysR>Gy%yiQ0F9YwRH=Z7=k=tYU%5>9gKclQ1f{p5X z+7#y~`c8FXTnnq;0%o$q-+$jjlNL)$Mvc{3P>90E=>t0cUVhp^vD_DqguLj3F{iXX zk(WWL)8p8ED|r;{5f5GYE#@eQJ8g>E{414N>lYtH$;?dK5)3GpkmdUdBq3X+;|O|8 zxj8FUZJx%DBxFcRA+L=e&m>r-xPEVau0Q5_@ws4U@6GGotJ2HEUZY8%?`CqhKuUVz zL;j)+WCf4!thTvM@um$Xwdx4nWM!;Gai0>$GNWwyjv5er-UVk*rCD4x zP^eXbMd~%u(kI`L{r4D_$-@yFahA&@uUESL>^#oxSxN`%zM6f{?tfwp!-UX=L12Wu z&O+E@JsBu!1?jTH?F4SQ+|3PFVie!4HB-4T93Bevac;u3*1@8522S>};XcL9jo`3- z@gfO3O}M9pK7pq!^qB_$zMB9Ri@ogoOAd`ekuh9uLebIFs9e)bEv67vlp%%7G4jbaEt@DnFa;Dy(oUc|H(P z_c_ee)f|RaGnEWovl#y6JT5C*jhPzrG>)Wsy-B&sjsu#33Xs&t9&5h7b9lpXZiVY? zAo4Qv+w^o*s@kfsBWIMP@o2e95GRy=7giYW<8wFY^VMKvVQhX;fw1 zX6lKF=1BN)Wrz57b*mCRl*jhoyb_x?lp5;h219Mrf!ufy@Ut$6u|2LpEh`}$a@MZOL z1^Y2XH>^kAat(1eNQ|aRPnVb7k$%1)Ki4k<)w?ygoVLL#v`yX{!Nl*bdCsQHL-NQ>s4 zs%tO*c(sv0G&6TLWN}D7WT6*M2;Dgvts*<|K|;zyJt&{$lLw9ahHI_XZ*u#*#6pt8 zrNoxnYF{stiJVIErg@~cFPq!Jz6zsJ+Mjuy6dV-h*T5Pq zrI=nEjH#WLql`Bp&+;^&=;IUePDzQPRI`ob@$sGsHw+mrJ|S3Q03B1wl)8ZpH3F77 zy>4AK_N5~`^q@uu2EwT%#)0!uUGfj!EPEk^*M=op`uxprT;^ST_7FGHrcxgpO*|c_ zNQO*(?HKb8^`xy&Pl^{hAo;7qt_ALq{0Z8QalW4&s>!)L!bgZQwof)6-=qzJ`&p%^In89Wyo566~Ns;7C?uqTjwV{*o8GFMp63xKOq$X9TN5A9>|E?jX zmFP8@=FW2L3(R;;$T6XA6>X)xZ)38d@Oef@Z2`(3zVbO8#dM@vPis&tc6bBH+_dsf ziZ$msCQaqlw5~3n6KSmsl;kg(g{k82e&lGS!eHPovF=}5921CTwQvPr(~K#g-M7hK zHN|FVcmy|~6~^`!z?-nnWBd^^7iu6!N8FPM8DXJ$!G?qDWtDqdqY+Tjx9zzHnt*Zq z;2!-Ty9%?DS0A-WgcKx(+Nn9J*_Xx(OWAbn?Fm%`Vd))_6l8q<+VL_)S`vh3=g3w> ztv?>J>XW^qQvQyqsXk!6hL8ZY9$O`9EKSwpM>->F6z3}on~CR)!dH2l|j5 zF2ClS$rcgsjzg~sHC zbUO`}=gU3|#pw;fTLN#D-EP8@!&It=mxcu$n)nI=?zu-^yeSTi9aFx2(YZyeG7c*I z36s(ONObN&Y2*fBjGjbAad=EPMwrpydq1=Gb2Y0*o68R;;Om}mGi*ayV24#iq;p@8J*`<#F{)AFgLoUgJcBy_oOsL9jP3Zj zc#!=@7|`~~QB7avw>rN(j8PkVtemhk5CUh zDV?x$%}~EpOFv)2^zN*1jgDgLF5DwhEt*K2`8iB9fVEl};fY2@+mryhN@o5>2d`+ai-zlxygXbZVOFRH z03mKMK^ha@HH@+F2S0|uzNVCOfh2c)jC*!R-SX)W`|w$T9kQ9_%V!XaN7RrcyN1;U z$}pnaWoWP8!$qM4i};8vHSSy3z(_ijZDG{=Pc7w|Q3caHeDjtpFazJAFl-bd3le^X zEYDvo3y;~qek}G2bzvVM!5Zum@_@Itb=JPn_#2!p&zg&C%aVsfHvjG@0tC#%2J)GH zE7R=EG<>7fw1=%tCu++(G?ihW#vXXWoRYL@p<-AfDyzSHSEnwsr!40lOtnw>GBkOKD+0n1;xmhH zz@GItKe{fB+6wAj5;JQUrM}r@WDZy*sh}diI0YMZTmp+F>F-;>MY(XBr0bOB28WQ2mtsFyj)r0 z^CwKO0m;Hx4BP<=&6lG9PTdc>ns)N|dob^VtOap%a5-9^yc&BI1aoWL#L!pHrM|R&fSBeZ!hr3Q#Ro?OlInoM334r5 z^U zW6Fof#YT%$39B2Ys#hUpPa-Ft%|S06D53~hxxFrbh^iAr{ z)sA)2DV7wgN>fF4m@I5QAEmmbUAiQ3{VI<;z2 zwD)$Bz5uV%L47IQAoldcUvjvPY|NApJ3iNMKIGt4`P_ijK?U2s$9lkadh2Tk_VlMM z5iAU}Z$I>!;3XA1r>blF1=nRc#&BO4J5(`Zz!K2#{#ds)+UE&7L39zMSAayy_|T*E zinpc+A|UF?BT?KB}C8YZG?LLqGilurA5C43(AQ^<~N}z*5 z%PR~|<34byXly-sfJZ!KRYCp z+hZmafK_6yZo`)ijz~+dm0W@2i(3uG4gq)cp+9etXfs4RH5VG5?5iV-G0tXQBHs8q zypb?2qU09p@_J~M?7}ObCF@V3lfKy$z(_xDyFgW@>8&~HDcRGXSktoSZXHwhHJ2Q* zg9xJ>IqJ_TWa^xN>iH7c2ME$jfP9t6rE^QNwc0QU8{o6lq}qxli>L*ck?U3Z6+)|I z*u!qAyckq#kf5BqsjJ3k?hh?2T-Uti1H?Oh94EI_&_4l z1i=3A9hOD(_2Mr}CI(?3{SUZ<%}%ddRqVhcAu+{aU-A!nodR>I_zofu$uW;Um z%KhT$bJFzzE?xa7PoIrB1NFKLl?JQ(f4Eelx) z){F~hk)oU}bd+;h=2XNn@4SfwiVBoMx1n?9nwT)Tx;Xv;z=MW|{jcci@2KlH0LJv0 z&iWTF_6L3Zq?Szog06mA6#j@B_$NwA{}(FzAL;&}vj1Lw7{jM=@s9)$=Fb|eKTAzThXbr6mXr1V2*l3Ncbo3p~EDS%*>c2N1{#P>)8~tw{ zjX&_B;%EE;9_{}N;{NW~_-BaA@OQBL4~Wa~cRu-VK-}N8f2`pD7l`{OwEeF*_dkcY zzi<4v-F)`>u+jg`Kl4|b`v;@{?Njs*n#=GTf&a8l{W~;wtr_8OG&fNwYz_z<@R1%i zM&L^ysGaH_yh|Mf>ZuTk`|xITEAf5($onH1YKd~RMK_~WW3j$cjdnRj=hN+>H`d4f z%k}un?Up{Z;a>s@bO~hVj`Bbca%;Sc2@LcuuQPbZr3E( zbQW%gcZB~KWg&$3$Mfp;_}xw4-N@mCH@5f7rX0=(!~13OZnQV9_bbz+^K);L0B?Pf zj#s7^g8Z=8>*T$4QI9w7`>)_#YeMih*NxdO-eP5E{xKr9EZXR>+s#vv>9Lc%ivrmb zvH+~@IYN&2m&v}#T?;h2Qa*_3hSD;Blk+{-l^kAJEq5+YQ|a#&)HbDap%~0pk`8{N z`P5Q#rS>vH!k&4jW~o{ngGnXwq%(15xk!QpmS#{V*NRG;qteH2`7qDiSUZg>vonF> zTCYZ*7ii7dO+5mR71dbbhvib5FB4|UoI9zfl;-4r=)m&6OnZ_6?(ay;5516I?EIM! z(Vt^Xa0)>XTVET9ZbPE14(-3Sf{|Q;NctTZjb0j_-V%ljg_Ip5hk0_L`DcP840-b~ z2Y-L<=PJwVW8U)Vz%nCxvqbJ$q=xDkC*VW#6RGQc7;9$u9kFLSRgJ}kb8yhQ8Kxl! zvOM)B?m`DfVriu(>UMjabzrS|U`c~7#wH1oO{#33ulHB^B0tzuS6X?!o{k@f+<+ft zhG@I6o=b60luzm~*(2x9nQm@+W}kq#ITAY_-^(s12~YNcT;G3`o#Y%lc-|{bXNUxq zn%_TMA~js|0FcT>KJh?(VfK_QIi5~7F*2cn>Kx2!;PswTmcJWRkup>(v(>Hg{Sx3$ z(*Fd6pNztZ*Hh-BTDL)(ePmjn)xb9g4nNHY-{(7&v7fTB0!u;&VdT}P{pw3LqIV@186HJqO{A zr>ml#HcS`sJf#L3w@~CZ+KVAZUltl6m+q=_1w*4}hpf8B53c}185_aeSXa1BH_+(z zU_#t2_bo=dkl=530rw6zf_tc^0_*8_Fiq(e24vaVc2`GJ&<7ZJU1FjjB|EM|Jzyz? zF#-#FKynh9-QYZliL-R6nXA(;!jMA@EY$mQ{T%L0$#{c?gQorE{&IYaNh(w6iguH1NsF@dxFJ)+w+fS4|q-^r39Hp!BwxbZrodx?22Cdr1=tmueR$H9{f@k2=O zfwReTDiWs#8Rl0R(wx0yq_yT)NFXZ4BMa06&PE9)Rg&So#EwG9^tL<^$?L$FYuYUO zAFyo3fCI}Zf7o&m@=P4}u7+)`jkm*t++PTC2&ux7GKBG@AemfH*O}ab$QKh-H#=Vu z4-(`j`I7*@tJttWh#>FL|MY|u2ZILiiuOA-`yq*>YSsO=rkkd}MCV!U&@C&_t_ObQ zMhAN(&YZrBRXw@VQ)O}`iXXuwYr^*HYtmSZ4%5chb}r$ihNuVK2z?6OH)xYS0H$EC z!O72yl!TS|FtawYf7sBb8Fx%u8@13~Q=C|!pkhRct>1IZq`)Jv* zdteSp2iL{YjY9U&w2+L<&t;;`XxSykYr;MOUl+Pi2Z+RLmiK5N3ajBS5ie4;7^dU3 zVA)bUi>5k0jNdG9`@IyCqsp;0N0XJ5?gJj@35l_qiCqa>i!N-R5JnMdEwF)a##(jr z#P^PgB^-Iuckb=0QjI~(^w|0ZSK#}B+}p6QSS!Zry6RJ0?W}BH>%TyV(2$vo0K)`P z0}oXe$?B1jf!*)dn>MjtbZ=}$YL;7b(yd}Tr}3j!PquE1iM4gqtYQkC!)%1CSXrO_ z3etgv73R64rmDo?yh|uF?O=;)K4B`nHY+y24+j37&4L3g)N>*3uJ z{1MBA4Rv<%!-n7~9fl71RBIa=ZPcwstTdWA8BIZ`FLYqXaRPoC;coAI0f7eAf?&X2 zU2++ak1i;&T~oqUuVEiS?}RU)EEwr*^ArpdMwP7>p==GIs?!yd*H2=CjL=CAJx4;K zf1&OrLf46*MOjP~`e%h|fIgr)Tj&zDjk2ViySqAWw-TH2d88PInf!?6p+(UHK%K~3 z7Db(^J&@bFuvD|54Z2>?0B0zZUXuckrGK4n-2CyPb+C5BBJQi(V@5@&nm2MEwHf)U zm?~`Yyr##r+w-koIY8tb)Dwqg#Mbf^qa#%I*Dd!#OZ>D_MlBy_o5oPRz)BJX$A%d* z%#hZ!a)dG2>BM^IMAWD)lkbmN(ZE=uy^J#8fDqRQJ{SUDY$IzJF%diqsG49a!Meb1 z0S0@pl3N<&MbFu_<2FAm_lf7}dq0Tp%5I&(q2b@QVfN!j>)2ao*}q#<99Q6=yD0nF z#fMjW6TGYlBSeZAG^HzV`t zSXaZSSwcTIYz3vuHJFtJ&4ls<^{6K!c&ddh<61`P9ycAMl2_7oJY!eG(jSodrnl&tA{N0h+ChhM z#TbwzLQIwOC3J==GEx)~Wc14#AXc<28!DQt0wfKla%#}#u4!RF0d~?x3hlN#8AyIq z;|1`s6nV09c~Q)J_gvxCJq;)0$b=Ry54_Z=pGuO0TPV!gbBqRVCk{l*Sdkq%H3fDn zadEZO@m4jy9;GPQc@1)}ThJ7`K~uGs`@y~HQgh}Iwk)R3Hi+5E8a+y52{DWAKquhm zPl|4nR|fike7WMm$>SojsWSdIan~M_nbBSuPK8$bM+IDL(q3|B=X9`wcjQ@&4f8WH zA2%raYuKCaH`2Rxxf4h6AR3e80?83|%+{=|I#Y_gh{XoFfcE-sMn;K4)Rrh~;Dr0c zZ5H`(7V+yu-WQhei#7gf`my~jc$f5fIz0%jMo|?TQbj8^8^3$LW_kRQC_jMaPP9z} zlF^8TfENuc2s&VJ8&Z|Eao2PjDDBC1!dp%ff%uku8vZwte363^WIZXwpYm7dtW>Y- zb5v%yQ#iqSx`q|d%JS^)E(a&-j(Fr*>XNY_Rgq}hOK1$7DmQj^VNMm$%ULBwLa2SI z30jsyIKAPvua@7*J2=$b6*)2X0~S$tlz`cG?xOeyRyE|(CfJr3bFDaXXBTO_v4>ql zWVa3)L^tn)Q1$4|6gZ^V^)~}}K3w7jkr9)R#qL*D?2xbA9d|)U$X}CZ0`@PSJ!~Gm zVb!p=b48Ap9c^um_4b`C|b_v!2?jrjqG_Au{8J(1w zXvtt8pHlbeD+}fW5IHQ4`caEizU^1h&|gT1tETIwpHHl=M})hVgrrG=#uy z!p0QllnDaqSSp4lkMV}GkBCRhX3ts2Pm4X&lkA!(a*giwGa8ed?dSeW!+|vp!x~ug zJ=($no3IWy8B5~8Bv9KXq5&Xj&+86L1SvhlC~Vc%o0_Y*Y@PE_+6s==SYU- zz#8=4D)K;6PEIAs zEuF8b4BG};1vV*sB%&Ar>0r(H0%1o;WA<2g3qOBq0)(ymnyh%(Vz$^-8ZvjzH84QM zzD6~I9Vq{FgDk_iMy%4mf$%mXVw|VFh=bjJ3O?x-biP?b8~6@7^cTpkFF$bJDVWOoMmNwXtWYW-Yl7EmF9y zo;k0-29Oljl}H0@NPR9PzPfuf=<{Wmya3ZE>=<0l^rFxQ_#I627nEN}od6LrCMyA6 zO;i7HB-RARy*sRfVEs;hOj=wKuHK+aAlhl+L>f+Z7w1UBV2G);I9?_7Dw#%S3}MaK z%zRU{b1<5Xn+9q@x81#~%MweDrQ~&5pNhFE2gl4dBHvmH^|Rewzdx0qBL8$ixt5HZ z0q&;UAqFaLy<|5fV|o5T2vw3(0G}}ZB6*;vCtYfLP~Z8-2Gn^-CA9j&+9K)9gsFN!|IQ&5ly2(agMF62ee7!g(n55KT@Y~64-^{gNF?IbJ=T2kLf{tk6N!T|Wr5?54JiqL`b$aa zTLR{kCe%$1q81-}3q$f{dqED~EmYIN2oy!9-O4g*mB|E_YNrM`wjFGgTpGo{dF!r~ zun~_V-}n-8b7)GEhZauSD-8RS^K|YqX7lB8euVXgQ_x+qS;hChCJFfuqNidqumUCs z9MAc*&*_UL4=XhGs;7QyAtlN^V%>KF!$Guh2#KoJsml+dM-AOWey)W}dQQFl?h=>j zaUd1Dl!iKJ92F+Zp|5?qsClAnTkVzFKi)n-t(iy?kdjsl`L zayj7S*ssMKFdTYriIjx2jgrtAb{WOsvKUc&G$@Opag*f26%zn$^0F*X(}hD*VW#>_ zCL0$GF-T7=@KVEp9iSoSl(BvzOQ@)swetp^C{7O8Lr5-?T3!SaWe*%RT)TUs;9X2c zd^c%ZL?w0-jON9G%-q3K(;Yh)ezt*18MIpH^tfgMesF(nQm~vQOzKiiI=MQ6XtDrb zyMg7YYHI~IVb(jjmAE4*EDmSB=8xPt6zeWJTuFG}KCrxuyabL;Js*u>VkAc=K7!hh zPQ3r%xGdDJ7?e+*lsKpTJQF6?0@*<3_hlPr_AxB4N$zLnI@JhlDwHHOk?ny^H5N|C zO4`#G0d@kG(O7%=);tBAR$-Ug1Z*Xe%*#&N4i!uD;a?&3%)!+~f^2Fpcf|GiUb5tY z^24KS!fs-sM(7Idd*biC{Ujyxw?dYd={A+4C^7NFD8+qDJ?I*4o}_-lKPcek61C>n zqb8kLg-I+onG&(AaH37M8scFYN4!qCxjl@1CMCg`GRqCuGlC>pI+<7dffutqd^R%$ z5?GZV5x5yCpEU>pD-2lZcC%8+QR{wvZM+2)-D;h^ln*Davw$UDbK6{X;YkTpM#g2r z-f_7GxFO5m(mZwts)NlCknWjeV*|Mb(u@XT`B`?U_Ly^d+K9M*WZ^N1t_rO?2(RL{ zja1~pQ+LC5sj z$nn`i@%g~}r*$&^hFt%@=zbf({U3Dy?fd?R?oS~8{~*VVf1m9AOA|cXAGu5aAjgcq zM+E&_F;c&4e_Q!)EBIeej(^|y@9)E3$A5o6vp@Fu4`9sr+js6i2F3%)WB`0$Rt>=Z zR@e^A4!mLEC)6HN7ySBGtfBY-T@r10J%6&13cz(<*e_C}dijZqcMrR8Kb}tij*FSS zH@$i8w0Q5vCa>>a`fh0-mmoSl=JHM+9iG{}-kcu2UOy*8ADKR0-nxTs!w)9cnqg}k z9#0oP@nupE+!$;2=7;P1T^AwmyV?8ZZ>VNmB-xe;Dg;Du}O*;L!nF?cBBLpQ{d6$)Eo^7!h_K{ zxx2rS4!D9eqrMs?<4d?Zh3iVb;&c0zn34a~T>=b$fohIarb&OTa^nTaS;>($w7w?l zgyF>ut=7I%zJ%qV*>5j-YPD4vW;L{QYjk|8ks99RkhnTcWSAQDc~w^ljV2)H#8G@j zTBWbBw#VdXx+g@h$j3)ac?4L!$Hxi?zOgzWgO^!oo1X0LPi&b1yR^LHb!-w#W7)Ku zuy*g0V&CU(9`}cKFJH1sc(J-(J#=e#E#^+B;%KS4d7F+Zv-?Z7S9*0NswSy-@58TO z2daO)pG`j;qPo8E)95(Z9p62ZHM!qQesS7~D%#4s&ZL9E#m*%iKNI2p;fyo>g%D>@ zi&SGOplaQ1;n-t(RY&(n&sQRTi%bqAWXPx(v_WXi?X?aOY#!N>CNDj8DbEubot2n1Y& zDt(fOchqYtIExtsK4C5jEaR^v5-!5%-T2eRg+zvmqoKj{0o4l$o?_pmBnzH~L~}~M zSS){zMzp6@W+cU^~w*X%7&xMLTN|G3N)$@1|-@&v$=3*eceK3 z18RrDQSCzo)jMBS5YmAgsz!yNZf<&jaL4fD6AB|sXq>PB@|=r-;HePk3V3Oy5?DW?cl{IuqRuL+tEvrO$^lWz!slh-zb8{@u zqm-NV$9TP|2fLB3g1yV2txlZz%Gy(YaDfWS)H8uA40)&s3{!$L&8w4FA=W4oY=sm> zvXEPbPI$t`DKDu!@l1AL=ZCm+_x%(Yfr_}(S%md&=?RfbSLmDHafsqorgK5mw2R^F z0{u>(U09GU_Kg|J$MgOnWFSPt9c6t(t-6i%Blg4=Cz9KcDpbl*{eA>RZmsQ*J?OZ(5x01@Lb{j zQrf}j4s|)eXFd6!i^w&2eLCM_SmQOnN|7Ug7tC-&#OhrcQQ6 z5{wxnkcoQn&o$rb1D#gzA`^<>S`g`QX%S)W?B_~Dp&mH73s8sNup0le8oE`^%~GCp zHNS#@34S%e!VDdYJVsLA2*Czq5xncdy@UZ-(+lJe%vl0vfd9)DT5bt5C_TUh56^*! zOA4@erM|xB#!OXY|6DjT#f@9T*|rh*05nCsFDWU-GwhuuhW5ZZ5?v`2`lr_bjt*4t z;k4`l3un3OAZ*u6rTaiV;=Y{S z0b5TD}o_KeS1FZwfXeb8dm!CcoJgj;DuNFkBgX*42ov4?k$i}w~T_lCm zwMuF>KOhlwcxcrn`oIb~;-AIrEDa$<*~q&_Yze8lxekExh<-AChkjcyzXW*)-6<6$ zA0q*Y$;?Q|`NUk35y7KK)e9rlT7%%)NEqn>cN5b!xt&>9=@Gk8Rj)Y9;CZ0fY2^@` z_5!}i#c}tksh1V*WE2t5fbs_kEf=4a2l!TZm5?3Y!uvih-B3kP^w^vbeMcL~5gnbS zK%5H_3MKeSr#BEl)RS+Yj4&uNJYIJ8wPG@%P|dnd5$jA!2B9QFl+I+6v6oSOz(9

    smI^m4;FiKC?-E@;J&6bFvC?ncJDMcU|p3 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®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⁣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 z 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

    3MrCM`(8HqttV&l4tpA^}Bx4Js9|=`-+;?{D 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 #BPi6g6g$$_g)T7 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 =f2Zjiu@Hl}dH6j{-BP zwV2{Sxp~zl=1kdYN`>L6NKI7ikZ+p&0oG9Id zgy&%C=@`O{kmrbIO*!*mvvVCk#;P7x@US}i2LByK*vhpC)Ws891&`QbQpYYq3*Z}!V1ZQCGeRuYi~;#g+nsrcSFgXP2=Ruk0i2C`83 zlWT8mxWTA{^T$z4x||H$J8sihJ~}rb=>5ScSEZKIJ5-W zf3|*f{%)z@DZPzOsRF7@+y4%G4^saDbvXCf) zb1OB7DELh3un^jOydK>?4pt0$N6;K8+d#VN5}EsTEUFmcpu_^45eK$l-Sgaxi28U{ zqg&UA2letBwNdhk=|=mBX*}V|OkIKQE?c$d@Q&JTF|6%;m%wstXJ|jwFPq_3>8hUr|~r68cI`Klk@$k`t6tE5D?9D`B&V zPuDoX#m6|oT5_?OvJKGW$86QOz5jSDF%E8Gv6hLm{Lj8PqF*-0t;%;^xadTo)(u2r zs5v8oa7sw7yn^_&lK>ztlwE=`EYteniDQ8vnT7J7k5BC;^;z-KI%wXW?+3&c<{Fw_ z_BFq2Pdv4;oebZZNUWkHl>|WH(<*c$qshzWvc3ZpR9SGzjbnMoTa2}LzOZTe3l>v z9ngzsRB`M^1&+P5Sd0Rea=uSsE^OQ$D0(wwz@lxii-PU4v+`X>CBFLB;#BnL{+L*sGu;Qq(|D3>KImgATJW+{>kx%`&H8x|1apye{fHKFj7n`tpB7t z+35bJ1HaVMZ2yApWTt2SSJgpmbpMGa{a?-d->Qq*=>8y9|7#Kl8{Hq|=hwNvlQ`Ju z|KceB-;+50G52q3?*9t?_)og=zY~%Fd;0Ouh5t|b@ozHv50dwv^y42?^VhEZyU81m zl~ZoMi9%sJK;WoLsedGI=x%*+koMqht!h*|LL?qTo6*|uF~!l;%JG(^)RFl~!{$#4j^3S}o?T9Ax7#X(>2c{7GS^@2 z*6psmZ8+Mi-kWfe54cghD?J8C0)gJ1&+k`yrf+my&u?#w4~?HFZBG)fott5upZV|C zv#L6eJ&XPO{g+nX9d&FTFCWF{#l`IucsFFSYd$Xb ze-&4k(#cJ*Du%!4Dq1DQ?9C1VoCGoCB-yMx4{%s&O>$Ihspf>?RUT%}nd3Q;8hj#AXJ>HN( zgQ4))B(6NLnm2XB~Wo4uAhUVQAUG2p~j;+xbk{9+22xp0D3Vka|1D6z0U~q z{B`%!=uwUSHI4a}Wrg&dbvDbFoC9D(yM+ z9Ujk{tA%gfy9}?icH6t+TZuX8Y4FZ@qX4I>g4o7gF>ivRln#NoT$%A4n8EPV_%Xol zJCKsHvFoE|o-T2f`$oWRt`H?VTB`8R;9se8jdqG~mZ4MLA13&7iL_UofG zAxsON>=!WHP4%;I!b$yvL*Xc?1yK9q{zp{e$_bt%im;qj?wgoPH=X7-0(byp-+F;> zNZn1T<9%#s3M>n{S-N78;^vwJ`i$rn=f%rQTy&t)yhyj?bx!~_>5*f&$8CEtZtKZI zHOycYC7@&8NveEmcA~NUm#Qe;(&5n%M7hk3oW>=~CA^^3G_$hsIad*ywXy^hiVQO& zWtm~m;gtqlRf|z^g5P@Z*Rcqdssvvqu?Fk;!WODn)}*l|aVxjHb1NT$FO! zm`Kz2?4`RRtDg2^NZw$41*$5Xju@9%ecebAthaDiIM`>%EXm_VpJZEDnf@GuE>|T{!XTu&bnChc`-N-Z*qNHcPv1L#`nv z2@mYwV3J6NP?}g^EeMa*xp3H^pl=xtB*>0YGC&4h{nWock*>nW_LMs2QKR3`iq@JnZIFCpC#UEWB9&OQcr8cRk}9mf(zdPFUEtUldh$ z8_!8YiEgr{XNT@UKEMO0yhlYEg@QxlTc$Z9dVRrR6dC%A`-m|c`BgN97ah6__8mBy zxS#W&>U-5jZwJd6`p6R#s8M0u3?;$oOZuF3&9WbB@c<9MU%ynWbuhF+R_CjAWUoss z`+>y0l{N6nySit!8`xmVi)nJ!4&I#7l&k`F`HqVF0>jU zb^=7%ND&-U%hLf!V%2W0IZe8n<4l)z3-T`cAxb-sP}tn9>MuDfnmPqI=*g9npgffG z43N=0J`j|O%zW&yr6Eadq0KP85RS8Dx zxZ65RH{BTna5vMxZV?F~)EpvIQ#5cS0Dy4->~Ih`l{H~8%`66ycBF9&Ct)+uiaU_^ zs)nbyuu|nFkI_hT5L~E5n5=1LWyI-b=2Y=Ya!ec1}toqYOMZuG=iBJ~J zoG_j3HsLwYnS0fd&SANDp(XMc^hHnv@a7Xdgp_cvfb2+msoq8-%(y51P_V1U>L8!f zVZA5%8uanM27AnHxNA!Q!4mjC^=ajXE9(Tecr*O{nO zoM?D4N~T%={6V~4X1;VDSzpd79$^QhDGMi#z9DQ`({}Sz9yZNHe&(l0?n4~kT727+ zq!jJ!SG4kCcSsGy2uZl~8JtZg7Bz1*pFwQc#mZuE19;av=B;r8`uPsj$8PUe-$5Y; z<<`c{SNK=yl-ft}(h^$BI|^zTEN_Q9Mn%huP(R{TO(-z6M>%WPW^lmHaSSC(^GJ#g z!$=DHM&wn}B<7WN;;$BrQ5NZi;?kt@=?0+MukY3*W(t{y!|FfQ;>+yLLAbXiC=u(r z2IZ#)vMCFwX2fdLn^uEL?zh&qW7nCOuM7u-$BVM3$D?PH42FK|1Y`rCjF{TFjhxA% zAY@WXEM)Se2~jUYCA9eW&BCNliG_a6w?#gL79O?ywQat6j6FJ4*et5>ylWK`JEgVh zSg1IVlm6)7$%OK22L*{v2{2(p$x`m+{^SLZwlIacS-lP260P^bA_PFg8}&VN;TNgL zqRa{i8X7NY=I)0zB}o^WES5hH?H>)T5$^u_qvZ=tVZ=e9`j#BH(74DPpz?htrOxRW zS@ku7Lv!NbZTNW@H=^M5DdTC5pZg@er=9<%*@3nxiW%QWG<4t&o_z=fSzg!Bmk)2U z+y!3Nq~c?#{LNyHS=0L0G5`!0kz1o}fo()q2Y;-JE?78!e-c3j3!cYhnhn@Z(Kxw3 zdvRKXJ@2Z@nmV1!49sp?{o%tr ztP1Y_#KpN^4Y8>^gjAV+w`Gk<$~bexTELv|%E|>uu40+A39ns+AmXcMU*y8#E5n}A z9@Tos^lOzTr!xb7mml959!$Id2^pUS{30k4dDXjZq-PuVt1L!vicX0BMX*tUZonY3 zQ5(~h3gWV2!$D4Qm>b0nr1aJ}XdQJoKEw3XZRqexi$$-NmHM$d)HD{*dHmoO9>N*v zpmbizp-o`Y&VagO5OY&1?D7Zk+I7(FDx~KlM)~h<)`9Kx(`(iMOeO41cn^*))8;U#y#U$5fzma4i&Z<7r7cj;Bn=h9NG>M1)_q=4M7$d{tsGlVJt9G1O_g) zD!|PU_+>GKt5)JaW9=B$xv)9|w2rq>*ob){42fCdg{{rmVZ|r>3u- zNqP;x!xijCS*r()JQZ)$T2~X%cB#-@ta3D3XmwH-vhST0U9ycl=DziQ_yGwNzML3? z3{FL4)uAB!FQ3UWHsLVppO#?o(rWs&eZ9+=Zo1784*FEK!|T7X2F=L*cpRSk?KX9- zV6=aAIbW&i2N(H+lhdu+!r3mkap73v3!E4dm~hObrt3aeRz~NR>}0?{J4@^Bow0VI zd3@G7qoG`zuT)P=03u-E941Ikw03ZQUcPzncq5ox9!^W^pEJ~sj)@r?W++I$n$>Ad zIJ0w(rk3xVIfHIwlb)FL2S;m|?JblV~up1kUHQb-w1NJgHhFyUa>CBQKvvaB1VQ^xt z+94ii4_ekK-q9f=U;-#qDFcav6Y)|sgB#K2hDixjv`wtV$gh!P#;gb1#-(i>+XgAK zar7I$!a8X!3pN-2eOXl1}E2qqjQ>KXbJzXEdm9>X;;> zA3^td71C<#U@GAWg_;vWdV=h-0}NNq6!Z2q;`Oo&mR0jk!{bx}Ln)YrnNELS-Mt0{@OflzL!yEX{f?a5MGQFnT3c!1N7DmuU?E3DU(Zs z9ru8?K#NYDw+D`TF#fgNfFa*;>9`zX;LHQrHu#pm_q9J^BJy^jJ9_%RK42Mw)>jw~ zBhQ+%B&vd66Y2CtcLWK}?c9F}+1C2T{w22mTSLUi#P-ixU^eq4F1QS{k_Kj!1nZi@Hqb_w#RHn=r~n5 z!sP7t>1++?6g>HAM4gE3f)V64UIQ3Q@Qa3voS+>t61cUi03# z`sqVv^P}VQ@bdLByW`#D)9d5;c(sCRq#@(u49Gg5b`SRDW%dAa@*URYBvA0M2=j~Ic&I9j<)!X$f z*Tyzf=fz7dx98L29iLg@>ospBFE++!{p%_2LuVx3-Jl)ZXUA!a`w=KM@Ze~38OMj$ zI*OF?MR3EVW4nrYv@Hwa*Da&hCwEOv=)!W9OD#?-9C7MrgY_ilFM}(vgRSf7ORL!i zs{z3<6j?){9Rox`Dx?yfOwhx_-*ZdTcKMw)19r}s6zOg>i2dIP1t~1e7%xI|!#d`* z))NHacs;1R*1C3`>qvs1_3dyd(8B$fI&exDP0fCtcL~t5=Ta(h4oA6@^`g3?Q@|T& zEwf~f{QwJ5T$&-7(?LHe3yGTfj(yMX`1aK1@hLQ~!xX4>+Le7 zq}1vCVfHDYR{9eCdZ^ivvv(QpD`~vOP(>LEM0N!*-UMxy@YYU>G%MG~? z767v^${bx5u1e-|Gk6JP?XdP!{Mr;FI!J>}c9%QQwYN2g{Z@BEe+uAWHnowLHyV+; z#S;U>1Nyl@yon=(QvZ^-%Z(>D333wXI4*~1&F`?giVvcM?w(#*ybF|mBvuBcz~5X{ zbTr==QD{+Ly1t%B&86~0ql%u+#ejQa%7cB>b8HcTKqq-$-~mMpBDBU&GAu2YrJQ0y6WHlzb}P})>m zhAUVfKv6ZM1_<=aCYLnjWxa z*Y->u)n(DVYITsaly5m`L|6*(#$@KyG@P8yhI#t92wmTk&4SJWjxhb zW`tY;Uvok8LYu7afM@sAMUbNkz%-WxC3(ran@Jtt5t?9w5#a%b$mS z3Y2}PlD`Iz1!%UA6UXZTBR>P6y&IjRjIOF4!*^j`-W)9kZLZ4D6|fsEvK?zd-#oTR zqZk2~{O2W8OA-~MQdDl_w(d)~l8nK-QD(A{_!f_sOWRb5xc3#%BETWV`FYMwmseS?)D&*1VB(607VJZ( z)WzeFTW&c0qA`&e*Z5=%yR@wg+wXEHrE-k4Ap{fXVmDkwt9THev)c5imwGZDSPEeo4;5Yw82Ua> zY(N)jH$_%AIX`&mEC}oqFUmkP5QYXc`}k@&57*s%7J4%tQiX|LNwe9ae3>7aloiBn zRX2g|3D_}Wkt(ZfuvppmitK-#50=;o0&72op(mW{9zjaBU;JVWx=lXI$d?}?MJMgrFr9l5m2vRdYJzGRBdq{vF z*4PSf;()1)+L1TTm>J6urTL}#hB{7D8)ayd!Nq~ZpIA! zV-Xx9t*~k`U!i-oGxGkA2|~V_KxH=dlo-uC`^)N%${+)5arp+xY(dCC?Q)oi0X!pLVr?JlLiy)DtL5v3 zqY8|>5z)#CW&o|epdv}g>rzreT{e^ZdqX0fOx7D_P4Q>1QMkjmR67|L ztYG!}retZ)ZG(|)piwjq*{JD8~9zSY7^ltPwY zY{GB76}yow{>2reeq$)B23dIxQ?Kzz+I!t%^xz*@!}V%hlHp*uYPw5k3<$~aJEnAi z`3-&JOfUIRViN8dNrTnr;96Zx7($wcqDGN+j-~^$7UiosNqBWxrht`H&J^VWNa{=N zC*^mYYD)?2b~dOFRx6n3s>wCV?9#O> zGUyhBYOAkyU-n zzGwH;4H?XHRFp|}>sH~^GKluFzs5=tPti5PzZJY|!>DZbS(DOn8pZIjzc*X1fz8Qh z&4jiNw98!brVV(3E}7^H7lt<|*vt;_=1m_^sFYF^(Nw-jQZ1s+)6cIc?nvb(FWMUS zZ+@@Wj&LrCGc5;uz(4S1OIbb~F+~G2*B4eoon@k_(gUYqZQ@c^e-X&p5~pRIiAbcV z`vvTL#iid9*aonG&2~hMuGNaZea-aiwLeROFHk66(TAKsXp_B(H%8{p! z4tSuYB}!S1bjsE*cf=>eo&X`BLfxM z`W!VV;L2G6f6zXrko6tpafItfv=!DGu#;`ZZ>og$o`p$NlN7u9-)Qub3+;oURoOY< z!l5+Rg7GE%38F5Xf31(DKs}euun`pVbjjIeD@?i0RoG~et?4h$HH|DvrODZ~EsmEE z7W*MJ#}r@H*}pf1K$;l#2liYqTU%Z)`CsDKnMYWgz<3n0c@QbF6bytguyv7@#_+d! z4~qxmr^)sC+|WOuduB}}a&?Mk=JMaun_kXmCD8F=m6w1k!4e`?(yW5q>qD>X!%`OO z5qD`oGO%TgH7#19AT;r8JGiKNg)DjTAOOuQxy9nCt(X@TUF*F8g5ksT93*@?eLpY5 zrEoiIS|1V6y8#9jJdCN{x9iy37LY*xX!r#`goa4KCl#7N5&M>lX9aJ&WQgVBYWU%r zL2q=Jj>re>l09dDz~?(S6ugh`5r5zs>Tt%tBq~e*N4QBO`SLz)S&jL1{X)T?Xj9oUrt%9$cpp4sB75yMiLtg4*=WT?+ePn1Ee3w*gS^41ZW z4+6*27RZXp6~#-mff`z=Bb=vo^gWiX0;sZ;6BsQKIF7xQa{Jq+V^`Q058>cRduh;Z z@b#8zM-$2RE(4|}N&C3QXzjgH;!QNd;dapG&vlejH$QT^B9_!)DDYwoK3|T;m zadek&A)Vi{y@a0R3`1(faysI`+rf4VdhU@`7v;S2HyVQXvqk7@p&*6QxIgWklBf@i zb)6)E8e4|r4DwF)i-1oylA;>-7V>|5M%h5Nx~2B(@Mnt^KX12ZBWp1v*b zorGA^z+tOZB5{u@UrA9SIL;-UxLtmVwM)_46i6=fT6skRCQ8#(563J(*3sA z$=g@f?V=2WrLrd}4A!Jfx;LO$g^yyaZW7Da!!UA#kR_v=WyM+6jQ4w}rB$Fr6v4wsnRf zbi0(|&bIzUb{6^Eut7(igG~nR6}oD2&)B(TYQGxmG|sUyk|lQgbd#(5a-w8HMfnNj zJ{96tJ)HkEh5JV*&u!FmxmVDa{|?~Ge^;J9${1qXXi~T(1O|DDRp4JLfGnf?03kI0N{%vy_{a;Fu|I8pU{AIKH4|NE`Uv9O3gF*Up?%(Xn|K}N`KNtST zYW^#O^tW~Jzo9ckV5oQ8w00#^UF8gCIL`;H#V_nV+-WFl z@$fD2SKz33QoT44c&Sbu5XO-^Eey%^ly+;-Pz#us63+Z;#rxbSpyLNDx2VNVw}MtTLfWNl^g7B>Ef`u*`V zbL-+@jqV1v7Pqso)gjXYl~tosNe)`Krp z5YRTr<=fJ)XGYW)_}<+XJq6RzTh%5T1C|ujTm|&I{~?4R6kd$HE=m@;5oXb!8YqcX z^tALSM-!Gq@kR$&SUv(aJ!Uv)ZtrC)!*0= z&^XE#tjeQl>#EdLv~XogaGZ~N^$ADzd-j8b%2cCGAP4~-(wF3ebH4Yw7`mCErg%ks zYQF<-bf~pMPD@aLR)cv?GgJ>WdT%Dy2<^9(MPizY!3OAH*!U*t4t2SWjDiJOmuA6t zcHOJ6bSnW@$s=NrH_?-XPsk783V#7pY9rZj4lrIN8F=QIQu}rQ-e%=7vV{S7h@0^V zj#QIsD^M6JN5tu;SK&sO1)k#fnO-%CbXs4+W&G6L z10v)unQC+2+de=GHE4=mLhJyl$Lv%{?7c|83-!taW2h|UuC9;Pk7s^3^^*~LXO&WSQV)c zOxzmeS+$cB8Go~cB9&fuyd&4pA;j1IB-fdZ6tx7N3p4{0|7F#|5rbYgs2J7 zYM7gV>F(aPprTmBcQ%XqZN_;Rwd@>?1nnQ@f#wKw$TN&W;NJsz`Rowy4DHz}a!v4d zRWY*PMUsD5N&x8vnBen+1Rrr4-D;f@wh8nM-^ck9<3epfx^`iy2lWDD%J)nN86u0?X&xWB*CJP;yV4X+d=a%&$!vLrIzH6(9%#E4`oL>`^p>OPXLyw9wP zy#k;kFjOT(wdxsXw!>H`M~v}#$6cHSFIz?{JKVXO!IA5|G!0vADW8C_cJC=Rm>v!N zs=S4Y)eWjzrrZJFM%WtM>^2?mA;6(|=A;?ZFFGaf3EB_-^(kaQZBd8L1AXY+R*La^ z)!;iir`EIkl-6i7(!$NHg1K^7OL@Nc&zEeNO6HB#k!Pnnl^2%-YV<7oTKToMsBBo= zj#coSbKt3Ua=#D&4x^kF?G1ih)NpiwCV9)Y%}y}_l}N8J=*vY9=xsLYVo;26a4|Y* z>RvrRY`i`hKq#~{!5&*(_7g>xEMEg4;M_r%q*fFT5Og5#uzndiwCoBszA(SAmSf#C zk0z|?L!osl#Fwxp=;124t|1Fn)|((L#v9=$(56mAwC8PdW=bKg1v{3T6>Y|wm8Y*~ z1tjF<+BYt2a>GW6Xk(Z8ZfUT$85c6M=98}AqrcjS{fU~&*@e?<|Aq>uB>@bia1goh znm6mItC7Cm1%Y!fOLI~uw=m3K0{ymc}i!Y=P9ExK2!B==xIv#E{r77e=&$Do; z3^*_sx#nlaeaPiHRfozT3X~X7nObZ?wUkX&2oed5a+Ch313Mh?kcuDmxbHz0cZg^a zuUR_0dQX%hKN(cGOFaZfnKY6kKc5U9cx!ofq36>0Yd}N>xxM(el!QH%JkD3fhV%nC z%k(UY=4c8VD{h*>vb(Dn@wSd{l^207WM2mq`f8T-fKjFrG9>(;hV*uJ`UIEKCw}*h zl5}~ZEp%D0V?*m|^Z<=GkAw?ExkAHplz7&tA?ZmI-&qftWgzB|o`Kt2#_t6&TMJ0% z!PI7>N%Dl!mjEGI{S&BzPL=pPfbJp+B)cxaP#Y-Sa>^15)l^5Y0LkfS1r%H>xKqiFbo z0Q+H?GYO24OSJ?OY7ptl4Qhd*PoEOMhJs`)dd+Jjx+s|vHS&|1Ch&`;aYf{ii z-JT32CVnai1=8|2RAdrBWCFJCD>6Jq?8YW32Pv(7W>F4sHbIm;McCQ$weoXD*rbvU zW18JegLOJ0-u;7hy9(CIVd;z2+(qm^|M*!NGa9QZD2J!6_A55cnrkS_MUu~yKlp~Y zkY&W?|CoAK&vVxq>xk;lk$WghI>ua#^Z}T(E&k1^_aCp-F0@l#E2vYCP6(qWM2@xV z$hf%OEeFMqOs>e^1n~vLHEc*h)({3!qFiJK=O?f#dC0Q}g$EpYEfySkZ*P~|;yHwW zU#Xl>TzeK_|F9ZP1rYo1cN3Dso`*|+$jlv5;NPF_3s$0O$xO zTQG?bm}`)l7#nd(RsES%Nm`A7tb!9P4bZs$g3BXmRoL`GvxGxJOP*Eg$$N(pmNZCx z!8<}9p4f_&FKpnBvG_iuBnImoO-6F4D(Q(uaI8uivh;)pIKr1yFbyu8P!nvScPhF( z_2x@<55Iq4U*%D5rxt9f52M+lQ0Ss*jGZFOB#ablArEUz=I*!z3;UXfW#e+2Lb4Ffu~hLv44%kbol%b@nJg@Jj+S(SZhLD?ky5~2#VNQp8NraJ*5_Py-IPN zcttNdxPVy5tQ{^}qPTq5G5kd{K{Kx>)fU;S=t(od^~bcqD&gQFVht=I*zm>%#{3V-zK(#2`(9}(1fL& z;YRye3amYp2O@&^GYx{!7AKlbxH+B?3x_=wdxF2{2I>N%stl1jEP0qlPEKX06TW>0 zX9d_~u0a^0rD;6^LGC;P#*cCNC4ya4UG6}xan%yJkX3}{Ak)y>a@$q zdem2dfO|BA%_utOf(Q$8!VU9UbRz?T08zfaUYeDLA#q9Z4br=OqjhAX zir_2Q;TF{SW_7}g5R_kIvDk|QD>CC~Mw`|FXluz#=4)fs-daH`$ja>TKiwIR+5uN4r4S+Md z5ivuLl+=ZUZeVRXaPlqtOeg7QyaeeJhShcCDIaT158C^t$wqKcHY0wohk|_d_H1zC z9y>CaSoIqeD6E7DTcY**$-aT~U=b1Tbi$oqw3HXWtQ+4rT8p%Pm0w*F^6*dJgB3vA zMt}?5f?q5;TXg70Jb~70l$F2r)hu_Y`j13)+u#(wIoB*g4iZ2x`f+xD&tyzncW^v; zm{D<-i4hqKqS+5RH(7+9Db*aA7!6=n54`=3M z%(&7z&p<$VP@Af<_Q_J|1@<}s2PcWEllq@M-ys({%CYNJ6&kQvn z_sU*zR`h``!R!c+%3hZnIv1;s-}5n;;A4*g74rhnXpKKZof7>QBSeWSlg_MJt zj){i-e}=%bG5pis@xPn*x4q+^K>SZM4N0rur0?ivYlKHDX=ZH!Nh|+HsJR9U3k~a^ z88u%etPHHIG)#YWx3V+R{G*%okMm#o_J0NEXhG8Q+t?c#+2d*a0Xpfvj`{vbMyLIU zXoSze(agsB>sENQO7dcme++nJrjCxb9JI79E-o}C)=o4w_9nCrHpY%FdiF-NdQOfu z1~%5lwB-LST%C>KZz;<^uP&=+VgyMm`!&zn5$`WzK)}Y@@$2vp`3b|nu$wUace@GW zzi&7BbMF6d2!%fv{trUoYpecL>fmYplfU_M^Zs7!e`r$}{ujQJzqKj4_2VL)K6pMR zXAm(0-+Dp+w4E#ihu;%O!#=;7Ni`Or%m0~L|GU~!_uNUQc3A(9##isR-LH6?&*#ne z=;-W^_RpHP=O?p8th9<$@AK$RZ`WrycQ!Qc&wAVyf1K#f2c3?Kj`PlQo(mr7&-Vs} z_1o~#ugce1(gT3c*Zs!z=-WY;+fGmSx7)kM&-42anc2_xn$Od(;Ps#C1DqdSi|cgG zgPm_2pF(DZ!N=a(ALmb3I<1{=)}O0Pf!l6tyWZYMuNy4RLurGJw`C{KkE1HngK6(e zWgX`a;>TuL=Ymn6Zw8OIOe<~}!P6A;E?=qjBIox^mW*Ga^@B`xa`~*KjZJ;k3}7?v zM?#?PS+OIU>E@QW=;3@`M(0e$W*qIfMa?HH27Z;nBX}!j1-bDUC7e-l^-aR{-LX$~ zD!pVvud}kx$g?Bhk&YSh(C6#1JYgY1UI^ivfV4cG8}CmA<;T(LTep+5f>}z#Z-a-& zIgPKlQ9E`kpOd`j-kVG#A9|n9$?LABBD0OP7opr{>UV;V5z`z`dk8$}+ek1b-#U>} zFtMaM{V&m8pwk|&hQVH3(g3*WpEALk<*V-8VpBCoL{3x|+)p?B4KZ_(H^RKsi+fI5+KFa@-&ccI}LUU??3bXgsO zU>2gUEcIymF{G5sSjBHR!*UgXYW(zWfzOBrpxGAu%{H5aH#cZy-om+rCA# z9zKw8HyT8lp-ldsI2q7mM7+4j_LBKPA9RN0(i447zkj$RGQHf;9x1=v*jQhM%0?Vp zOyPKfXt>+r)Oa`s%;&>(dROb@lTl=~YDMRy-fFh115TQLV%kn*Xe0FBM-phXv;Ed{ zNq1J~Qy*a#>4G`wgRr@EbmBAk%>;X@Rn^^KL(la+y^-^^+;XGAOYe8WMnptC))|!W z8Ql)AOLQ`+7!Wc_KckhFGFdzlr%KFMeC+wQrHn3Uz2^n%ff^VWkf-^zyLB8WfZ{$$ z8|u6f{&%BW6X@sYdW?P1{XyBGnZH8{mQ|3@(R!F}* z?7de1PzR&XC@@+Gj=yWLv#nACBq zZnZMDx&#lWG`R~}0)n8rJ?r0G@B$y5{4}P&NZ_bz;G7`WLkTYtb>H!F9Tsj+xucr- zYE}1l?`ORRd6o1nA?3$pQvnHnL_JgZCId4|l9_*HPlg2zaSFF1)y3(Qq6(B<=;eIf z1Qb7;ejB{U4%XnuH(^9VOzg7CnTJ{Vqf=%h+6TI;pqF7S-pY>Uwjm;ifoP9VNU6__ z*{dSq5-|!1=RTBn8dX8+c(w`)BJ6n{!v)1CBoG9`w~OEa@Ix-hizsg!NMw+6E+(pD zOKem0lQ9cn=RLp$2e+W_s!C;-nZCSL4YKhUcrOU`{8%SVyjyS<(=V&z)jJo^7t`d7 z_{Rxw6FP5^Q~}=GgZ-~pZAJ~c^nmUa9tX%7>~@T-gLDz6?$lNDjoD`5a@)mN8y!}e zv$o?YZlfH<%Nh#<*mOKs8tm`^*bMJreBf>5`fMahHp5ay2vm?t(TBaLg6G_5t>*Xn zlzkg{RAl1rJ!uMzIXhzS5?ip*_T)pIO)}}_)(Z}v)C@|S2?L31+A$>C4^uyc>ES@5y$MfQN{fzvYa2LL+J?49qpFa?;Spk4n*DrP!}$=7Drr4ayQ+sPH@Yhz+1)V$a}y_%=u`9yF|xSe=C;H1@7QXT#{!88vlMy(zaerk7t+J{1Z(j(^bf{T8u-mN6D_3*SnR z^Lq=#=VnhM1>#dDLlACwg=A=KXdhi?7u83AwoVuaLiPRra9t!S+7l|QGlQQEz&ep{ zQ`prcBIGx4=+jF4%>m%ass(fpEe@cpE1gh)izL8_9o6B*tso$07eQ(aC+p*uO_gCV zK;H-?(8feVeV8d!Z2MX$vFpP&Vfpwe8KI-5r27*tVlxUA_ zgATQ!Lh;9^Y&QUVGJa`l!3Yi)o|*f;GXGHxB37I&;3EGIct8x~kWfLjb*U71p(>^T zeyK16#6~@ao^ps>o1W0f1&yknd&ffTtx)JK>R<~%J=)5sNPloLxP~)Mkrjn<%`wht zS-CFEc+uwMZfg5HQ(zI3GO`RVEj1|a-H9P}K{vH%`M$f5!4K|%QbG%fL-<{&%6LV{ z@}R9GTR<^GWFaxxf`%v#c(LatRGfY`!y^Q#EfVBeSxtZ1i`42|?RH#Od)Ll^H$X*p{W?uyh(MbrKl9QHFJ5Pg=PC)JJdygnCoPnKl(s zu@@S3{E`GBk%l-q>$#;Yk#8s9Ji#>2P;UV%imrW&Tpg(q$<|%B)BVP-gbr=*UgJa0 zh%l!dyAL8A27>RFiJ^Yxs8e^D#o(bqH%7jg5BeIg%r0mWtzf{?e_1DvUIwha>8-Q8UZC@i?U1b2tv?(Q0#;7)LN4+M923BlbRKHaa=eee5y z-@E^hKgNHI8nDl)TD$gMb&9Gn=bCdRV@bQVaZZ7fgl#40LBI;r zS~P4JlX@t@SZ1&Uiy&6mE*yAc2b-Pru7(SvrgB5QVTazV?0VRsVJ85?C}RtM9pSWB zAY$J;tWvy+GcNjsG_*Gm50TQh)X)?2bEUC|!x}OYw46N>(qYjvXBm2b(VCz!QjVYe zY70Jc8f%gHT-!Ticqcb5Qi~Lv#{b3=fYjO{Y5$`r{Hb+)d%z%s)KKsaAh+^ zl?3UIU*Ra*W$LM8IZ%*EYf{?@3>#;)A*gg0mt>^ADK5z)AH!W4(s_z9b zKDrBVj%$0+v?HyujY%f4I@9xCL1AON1(MlcecmNl+1!+-d54`;-nbgJyv9gtk*w*8 z3Y@|82eNErR(9P^)f)p`Kh_kThV3$tjTCdssG3O~)q*-W_DCT21b~=j+qw~r!SDYTNn~}j2nUnkzSzH22tbA?( zfxRE)9wcLbqf+Idy;W)^YKWKc9yATu`~kk(QS27y2NBtZei=4m#U8;UZ=OL(!2~&y zy^qHoTP(z_kvHcx=fy15g5xGrjJaZr>ay(y&G))-t{-FFoaA?|-6Uw-$$IZDZG`y< z7rsDQ5DPjGf2&K{Em-J@73(-j*w=aKsce<=L)8{V!z(&V?Ew7}7ssDAm%%8~kE)1K zb32JjHq$@@30AIEhn-$Nv6U+dRql^bHeFBI)QhlXhJN6$Xto z%Rwm4e93AuoCasAC6+4OA z;!oU8$p=9EJ7@a+Z_mY01(382?!fyO(dltQed55RCvStQs<$TbUf(Od3W>y_-Cw;w zB5U(iIDMRyNjU!Ln?GH-dKm)=mY`AOB{;})Foi-x=BPR@rT~taStiV2E5r=u4=Z_g zYb>=r+#;(+RG1u83)=a~PWR0zL)K0lLxrbhTb({EFAow)9J_!WtuZ7139Zep!N|tZ zSgStH0lLvNz>Y+60jpH21KDhcpXq@m+JINJLS{oVYz&(O@0*1m>NT5%h@~|bW2&!W z*Rw6~8_@|}#7r#;*EW&?{&uCNdi1F+%?UGvqHg~5)u>T-;v|AO-3TRaN`}fAK2NGY zW)a;6`;-fYmFsa>utUInRh^7^G*2EPgQM=YAg)zw?xRnIfIBvO*Lqm1K0?#S%H4 zJ5iD4)?fi$jnxcmt}ErTuh!JkjoqwY`+hiHMgj!`ef^&{gw26&O*Fh6L;Y-hI|%2} zizlb=e^A5PR%R3GCFEP-L+BpwObWs`!QMU%eT6a7#?UCdpT|Mh0-60ZyJ5S{n*>6| z*0Sr;I;sg>1+xA!W-h1tXb@=C4AGQPX0N`B(aJ!<|0HY)q9Cm)OL`5AP7ZpAm8YA% zh|J?`%uu8;tvuO6V}qV( ztwN5J>bI5~m}EebWvKC2e=I0p_;XAiTV`;9{xT0bOYSV5x?Dw~H1QZ|nv{ z@fF|w2YWru?qR)lf;6r*PLGB2;MdE6mM@||F38>*aK8`vR$VzvL4h4K;`{>bmEyKZ z9t#z8jUv*LfYT`n5=63a8yLqVsBJ?dpKnIGH5MB|VjV~~hgcHT1%f0Ij(S8U_(7IP zhtlJd{vt(b!V9eNW+-%+^Fr~5i5`N(_fNgrvb4@qq`Wcx!{rdH?>~BwJkz2Pe}8g@_ZYJ(3^I zIh-w}oMU|;>fFEqK8FS)MnWKqqyyN=eKYl`F|31hODP+~+tQ~WL;%Y21D5OF{lzjt zX&Td9IJ;{|uyWqV!D@D3jsnxVtuKDW8B~Sd>X<@kG=h*$l!Hrn&+!5At)#7BEsVKH33UGyJS{*?3gggcP`5EJb{xN8t zh(tCzOggSk%y-Ov{%AybG|YLXJ0jabIp_)++F*@kpurxyItDAYiHQn5T0r6urWPZ6 zisG)OKCP~FuLQBYd!uBwHVio#RFt{J+XvPLZ#_s^iuQmiJDH!Z{pT_iBoV>KB_IUZ zTFqJyBGxJ84^`_`{;!_e-VE3-^X;UEwQ9hvZ)7T1!ujX!vC^4xec!MfY9C1%?Ko2cCMy7=Pvm6JDcK3vE{ zQpZ(rphx2Q+;Y%<<{;C~wI#|ByTcM%$`w8e#AyX(w8r{qir`R*PNWmZ zEAMdZ6C37GYW(|GGI0Dc4~!dCkPQS&&w%1~tzIUd3ItK2Ur2c#z}+!o-;;29#b(15 zNqF!mB;kxRxRF}SbK2*-Z+$?fv*a;PicXkz2pLIr4&A2(Rvh!A`Kq4Iw?Azl zJrp%Ir?16yU*dYQtzA_umzra%+SI77!W}H6_3aPMJB6II9AF)TxbC&^UCqN9JkZLS z2;w?SY<-+ButHpIyFZ!JeH?qYj=jn4&{R4PxypmNpqt6lHEA+;fxDpnxcJ?oz2+O` z)fkC>C9i@R{;)z$d+iaH@iC*Ou!-&J`DqJpPcQn)v55HRJO0g#08c&l-gA(l4zZPp zb^UX&mF_NXSL+xOZXleDi+sO#_?XH!A*_X;HwDV*311&$T3^AC=@J|Nmhbpg@yEu_ z#PS!A%=(vf6~OX0d--n{dwa3}v-J4C;;T5B8Q9-E`hU+g>l;bM{zroaW&n_Z^^Y;&?Na%p|MTDQRl>#& zjzo+m=9b2!too!ZCjW6Wv#~OM8@ZTUTAJ%yy^S1P%uV0^n3_A9IT`$QtZZXr>G0>F z5i0`|12faxv9OKd+iw|tYbSlnw}FzXgxK3DC#yGZO8+-bjKR#&>g^6z5!W}m%E;W> zRQEU9%iPq-{`b3ee_M~kKXw-evi?fwzfFJv{^;cJj}^6mKh(v4R@4Ii5NZD#6}7*| z{^ErGzf{!zod)|q>$I8wQ#a>-xBbKKiTFi`{eBfH{v#pwdoq7*{!c;-@Q3XE-zl~I z3AFE+uNnB9>9XL8Dd{uk(+bT_TBoc`~9?e-7+9Lp0&uP zHD{3E8n6Zc&VQMXd6|IkPU$Y)jxv&jJV+HV$-az~o=p4F2QNkXOectSjH~|?x^j0v zpPbbpw<~mZm?c~5$}5pf*qQnD{wj;rDYB^4hv&&~I^`w{q4QxBJBuaC`g5B}LHTm0+F)9Rj$gw`<0j6$`sskh7aaRC~q#GR&ARZ?w`h zAKi^KqLkDs$UI?Qo0HGT1~;DhK2Bxh&$F#JsvAoPc3sBtJ7!K6P=C5$ZYkXXU_ zg0S{9^o>Nj+q-wb-B&QJVkg=1C|RMDwIf0|Rjr70fPta9YKjy3-?AsNUQ@b0hlSSb zh2xb5+FF3wccWD44U;lPzKw@><9Juo)TAj>{Ph$seVf5X;`o`2*h3j9EsQA>DwjE6nQ88UyUpJ;YW`h?Q=A|g zVvbXW4~)~bp5@{DJ_RPMnbxX?N$*|SBJyx6qe&nRrHaXiMb-w=`=i;HWTE3GgAQs`k3U>}PM-;PU9s)Vg zZ%FrRoQv(}1RpmEbvbGusqyn7v`MaN`ZHN&RhJ*?m$+X3pj7L%7(*qFo-Dd*kaW!S zWt^yS8y>hm;;Vb&@t#=n?svOriiD#H~f!ks%CLsDN*IlMZwtJl4b<2O6AfU7R ze@2|^)iuX}$qlAIUfHXa4t6rG-oAYw9h`LuuN|gVGm&JSqaB$Q@aCU%Qik!Veirte zoKhaoTIQndW7`c%~9pIiI=lvwUR<*-oC3gZ|m!a39G59LHNx zJJqrN$`LW(lazsP!lHgOZW~Gq7I90_2np0_0;+rr&Y>JU`qpehis zG|&r!7Q&x5w_3R9gF8HaMvx@swZg3vFg_0D%LPMEE=uCnvT`Jv3r>l@!zYF%B0Hi7 z*{ydc;186)pkJV$cURYT&Sw@RN#&)j7W8LuTHqzl{(fOxzJ;LN-?Fog3j*_Tz}zmA zXhF$QJ;5|YDS>K|D3@bsh6z~$f0xX+d)Ekfkc-e%1iRGVT`i)$0Y<`K0z9bcHcI2sSUlHX}<#s8Q>XFYB7;?=!XJ@UNK;LCI= zznXvZK4Ou_>Cd~2KRJIK@w5eMyn|Iwxz`wwPvJTzvY^c zeN5N~i^Y=@C%tHB3i>qbI1iQ7U-)jHrnb9-2Ias#GJ!$8(jYh{jlU3_P~DGPrWn8g zfh~9jQlSC3RKa626ws#@S+1TN3@QIq^Xz?g@9k~G0k$ui9r^T55d1?%3@*&9kuTlU zwW4FjIeV902+WP5-X~m4*PzUI5wMjk;a@de$$u>B-AUjvBo2v7)Y`6=wRm`?Y@ND< z*t?8<*Jqe$A#bt9u8`D9CKj}T^HC==kKMxVMey2_?H4JbTghUR8{7{oRuUZeiC&JO z1*2Su^A)VqX+d4P zpI#76e0N?OIC^p|3XC!w!%sQQpfga#yd-MQDp`T~Ed$ifnlr`lh6-SCxS8(^r$n%~ z2t^Kwv!~VRfzJ4b6qafE%Qd}ra)Tv<kubgg=hu$Ai2g)$jrle0^I>l^qk2uUojK z_!Z@Q>-AhUr*SPcnZ@O>_gI?f_WZLkxq};rwSG&YO{a64K-BJb9O&iq@@m_0ys>KK@rqp} zCwt2?_VcNHUq5009Q*B?))Qij8-2jAElZICMLLNh3J$TwED67~_N%z`YL&3`>Q9@i z{dnJ$v2}aIyrxIfmC)kDq|joAZdNUE>0KKc#60Pk@vr>S?Gh(y!cMSQU?65u*s(C_ z>aiyfx8g2BjlwQH8`HgSQ=I%c#h!JQlp{x7H|x^px09&^qF)HI6#Pzt>xk%bxFyli zSBLV$9XaY_961)rThh3)C}gw19bI0MJg~m6@@-ImVvdB)1^|WaH`Ll zWJMoXY8GPCb8J9FNI|p1>Uo1c7yAwgmv=WTncDzHVv{= z+#K%dVP%5^bSE{%7%G;J6Q}5-;uLi0t!G!GjzHR>DK5cXU|6`6{u-wAE;~Q}F&~n2 z4u}HR(aUBhxQCUiUVFNrlKS2sypLF6HY!Lu?yEI} z;f{X2aMB)({9rn#HB!{s3^JRe@GMv0SUl}v>D&9>sU28$7f**D$qkH@#xh33@Nfh9fqc3O!^qknx`I$B*!X%ox z3qy5?77Wr=091Efd|8qFNUmj)mdq9{tR0I<8~e?SH;-Pts0|ra0j)z|qI&%yO&Bgb zceOu=3)t|7f~kk1hJ2JXVNC?da$fZqYl(nk3sYk?dif5>W|3_1uwHo;8Ee-olbFRR ziDAee$Z!o%8Au5B0@)IC{B-K1Z9O$p9kL@JsvHRtf~7&q-|>}2O6+H;40d-Auwgwl zTZJHswgpR+!V7)VJfV{(RUIIWo2l9owzj_2v%WRFk2fWb`$(@Dmlvnf+VH&@-^s!W zwJ4OFsp^T=J-Y9c@MaVt%Ma0g3(NGc{6-Yu+t`;lqDWK#+>hTpSzu;R$qJT2bNsPC zT$@w3HVcNPqrj)DeEd{EX4Q0-6b&5VN0k#-pzrcBa~3&*IQ1<@?3gZ3ZqfL{bxb3G zw@(_&EI*~ejqjpd0|9Iwx;y4q6FC)x!p(6Z3dwbJcwu!XEp##!v>4}tD5`KNZ5-R0 zgLp`Co;Y^dmkg-@9`y&XcG=*Vuf5YO23{YH=wo@AYkgj+f~1hA<&y&6E2isW#{I@$ z;Lik4dpEv+)xWpeAa|SLj(8ctc7!ucPEE>#7iq<>VDXV7{Wd(MYN{L)N>o>rqdoho zVPJ8Nx@ZU)2Bp3vV#*qZWGG=t1qJ>%+@2lU@pAL9?q~|S&R+5!Lph0!j*?7?YuQ8a zyH^HgW34x#MKD2LnW``auH``asgqA}TdhNsMFCneN)Fy)`RqqKWXT%U?BRVNuRVvS zaq>(frD$dRl|t@?qQ&zxz7IBbmp?J1$fA*KNvX}b<*}u5m6?qUi4#d;6P(#z5`+2m zt`Dh9;nhNDMa1I5+;VKpmO&q@nVruuhK?VvD<^L=X>H%F-bQgBgIS>m_n|^Tu*Fx8 znxl`~8RZ-U1XNqLx6ui{Wm4B|IUZRPH-E zT19jdue~vX(Y9lLSC()LyDq6uACaivNuXM=$qzV?*Tp(#&^eLLHqUKsb6F+Di79Zp zSzd{#2p7f45ClBv2t)d5AbBGYSY_6iAWV6bYW~n0hN48dAWHg4lLJP-lP7h z8f6_7bw2*FBU38WaM-zNyG!Aqu1$GLPo?5}|Fj+15NATdv*~ufJ*c5MAHA4y>COj2 z$iAKMpBMuq60mXQQ**X6Io_Qh6nk8z7tUiyKR(PoXsW*RF(_yy1L0XNzO8lk9zTY{ zo$)?v%c@*765poF#tJ@zf`m3mRrSWmc~3I`bXB!U z^~{K3T}*cy(C)<(u3qnEfu1NE5(6Y>gu-%oa|oqVCHSHtu?x&Nh$IO@;GCn^|BijY zO}?ZScaURPC`nWok%}@z5mUJg%U^$!ei=9rkB{;Gloowi3es|98w$q-uC7)uL1CV++xmc!JBWCOH4^fc!sXmc=AQD!}KW}b2#E(Ac z)87Rhrm;BJ5GDEX{ z`LhfN{1hgF(jX_MHD}`uAe|LCDCTK}GA;|Ur|45T2tG8)h;p!B&0u;0I)Ug#^Br>9 z)^T2^12l%s_mbSRVEXEvCXN=Iip|0yy*y+#oJ__o*u(V&0&CJyj%i)wtrDg{qRE0RocG7y*Iue(o#a(|T@}ae(^?t8Ypkn*OF& z2$+V1$-)jsiPG+T?MRcyPYaeUD}>k&LhtWozxnM*rc0wy(kO;%uyY4wgNp-{P%2bfd0=qJ_Mj%D?U~lY){B#LKE_9^ zk77Z-^UR|yX%@uAn*fGREu4g0gUUQ0oIC1e>DXE8&4-& zo8>5ysNlSXbdQs*3p)|^D%+=}ub2#Nl6{S06_nUE4hsdOLB7i){O27Gul{Bkh?9vv zpaA0^L~>u*4(r$I=cQ&pP2CIT+lQV=oXtXedyG|};H^G*QD@baOD_jPskSV!c2kax zH%*l3FKA>L+w2_8SIBBiUC9**B*Gxn_#-dMI1;GGT@hMngR@0e;qRANJB5#6)<-WZ z*f|>WqZE8|M_<-rgPn3Ubx>9GoEE6tgi*7a)tuGQ4(fRTt~PQWp%h6;c)7RaQJqjB zZ_#KwhE<^j_U1{xPb>LY=eSd{FuqtK)#aF|oOE2LHf9S|7Q2m3ePg<^cdR3SWFyKz zH%ZEHlT0(|+&Gr;x~97+3VG`tjC%JohARg5L@>^k$|~ zb@wsa!buBAPVyxiqrj-}vyUi;7a56wh+~=dX_f5Gvo*}nRYqkhFYFLg*5w$?5WsdW zcJd5v!we&O?wca(+xSHfC+I5Jg}4Ty2`Q#!+ymz!f9h_eX+$kzDpD%rxIJ}JMYaDk z$U_o;|2(wkr@609OB0Rdnv86n*_dSHr-~zN%p|aj*gi6pSzJ3GPHtKZI&^BPo@!re z^Dl9&SjQVX%PB+C z1Y7RAmsq$5AH+kql3is|qpIzL)Mr6(W{G_@1>(fu#>oBKBdyF#-xCY0>Evnq{BF%Xk-dIPNZLI78}a& z{f>hN7c9bs6&l?)xpDTWRyMEag|u8ANn57wGy8$>8R!NOu)7^dN{&4eE?1svty%dF zN2=HnaORB{oHE9{7#g91ipTe$X!_hIGn<>gYFl1fV3aj@k>)6>w`BedZcwg#NT&tJ z$d?bsd6FhV-qvL9+68BOaM5-Wowc;!)#>;^EI&dn3uC%H;UvmNE*L6Q#~1)}y7swM z+Ob*^5TPKFo$MOlLEiht9?JY|Q8vHTfF6lC`1!{jbkC>FDn#&}l+8r(bcjlj$RRs} zTi4w)GvsXU6~gC}@{ z!o-FbZ`EK?80CkVZI0s=Ii`@!Bbi{e#>1`53b(*fli*v8;w-ul^RRr5&eOZzS`B>! ziTF}<3(;$?ExWv-W)0>m;8?vxCe9ZiuivsYq(h~B&F;WuoGQj?)#*(3)i)|tg%dR@ z=_{D_uE5#6%L_^$w4E4~W1WOj_-cUj#@00A;*E_6luCkRt-O2MNVEa-wagapPklR@ zyt1UonvAY^%i%d9VIAm1kx*+SqP)-}CvDUQd{5E)vbl@0IeV2@c&|ovYR++Y=5OXj zk8q{M6KT1M93%1r1gd?DZHDfE>G;R_&6kfPsqHf3j$VWQw*;4(JOL1w@Cb4ql6ggd zp&W(L&l>9m>~UcV>uxNRvavL^!5=6^-6N&N(8648 z!w|)r-QLl<3J#>gu%kTi%D)QlHy1kao#{pTI?BHjDRh@|J18}n;XzRHHln#sB0&di!UOU++p%mB{Qnsy@Xb&Bl~d<$y)Sa7N2bd z5;ww(a&N(VRQDLXKQoX3i`223Vku2VxrLhnsF~igGe0 ze?7i_a7@HWA}sc`q-P;O(m0J)O&}`GvpR10JxvqzNP=eSXtk@(-E`k2{q zbi4N~J>{}Z9&59(N8-%-pfp48=lW~YsxQSMI|abgGA*v6tsEl7)PAU^fSy?wuI)NG z$@w7i$qu_}6kKBN5OzKjsL$I9r8dIfbGDFAYEFAB5{~S%C86w5OcUzPAL*rinx4ZB zT)6G`UhD@plZN`&_t>f3$Ron4GT>SqS7$sFxO&awKf>S zF|lI%&n8xE|GtUU@3FsF=l{=?`~NGV{rBzvwkORuk?!vo-9HoUzY0};OZuNgJKG;R z-T$6wAC19nh3|ZPI-)X84E8sBe`TR8P5b?^< z?E2vlcn!%*_UCz>(%?&>ee~Kv(fwF{(OAc z=5_h-IVQ@R-kZzTsUcg8ofVx_1Wuu#+HD_fm5 zeRi2kg%SQ+kJF_GSGNxz0qV6`{nqJ)?TYSxwYn4MSw2VJI-(w+TTJloM-L{M8>hsq zQ4hdb9y}koNAJ3w>LgtDxNy9$HZx=_6VN2+^(?cFc@AU}8dsxC!xKNu^UXAT*(wPz8X&!1>JJtge2z}Kw4Z=3C~UwDM+=-gCUYjMmuX6e=~~^qCpYE-k);u zq7|Nd|2AU{Ec1qVZrxt1XedTkS5aQ)HiL5~OE(0XSyfB8*-?%mb9P8@{P_A=||jfwKl zygnZ_sk%#{2xplG9Nk&)>QW;qZR>7$wW#o9*mhdnq3BGp!L`&JYt1@X$`nI7aH9`5 zCbT+lW#a?um4VSSmeO0Um|(uhQPeBBZglJlq&R`^ErDsa!K&JKJKxPT^`Fj+WB1L; z9JvvLLrwG-6O`u;tPH+&L!}&Q#0R_OA12uvfmN!+7BWt7gR=^eF4Pyuu`H^6r zqryRFVnsj?pg-ivfymQgM9Uh{LB^PXNloy~v7aG`>c8neLJWdv20NKK@z8w%m$(UT z)&AE*8CM!6IPTNP;)d59P_os@-;sLE9YerSUfB^Sn}s|B5AnGo$X7rx<`iF0zfN(xXq*069uW`aq=7VttYqX5hOKt70SY$I#@I`&7&o%8W=>v3^WxXrX*7I_^_d1v^oF2tS4FW%?_{er2PT(M<0`Aames+a2YZXy@*Zo4fb2qP zBQSVf@>FkyBN``X?GTcH4t@Z(N0Fu{d3sjv|e?q!02> z-n`J^k9?dnX@IEx5Sr}IHc4TaE7Rof^wl$(@0d@S%q(YQ7Y%$Xa~oQdfe#J*MLfaE z=>DU#^w%`KsmBFCLDva{kU{N=)<~{vND=2Y?Mr?I*`V}99g7OfQ;FBNU@z3+Y8F1C zg>N9pN4>Gyolm=DL_>ue38j7(EWs}7)bWN7i*>idgSSYW(%nO!S$Rmide1SwL869@ z!4Q(_@9pnq>nIzY1(_m9#w+{vDx(en#ght?M#Ci1hOtozsvzQlqxK0_YGVija*{(N zgIie%*vyw^)^j7lBS~XUHQ$jk9hJ$Xp6PY&$!DCJa9NPF8q8Ix8h~3LRdMj4iOln1#M{hv>^KfV% zpq_$Ck2ldK?xm|p{=ROObNuzw(O3y=uPmJ(KIZm~Dk9u}$dLsv&o zXT-ZjU#YLuJ0|RG?*scJRd#34k!xHHhA8vcg-=kaY;x(k8xy4uMmM6JapDpTfkPNA z$f@or6z-A41V~(H*IQFnt>O@kbci#0@B2jN1+d=tU{R+fQz_-!j`c%16)QLiZenxg z4qBzxeG=JwP9nzi0<9*RbQ{1eS;jkR~m+&J{sK2!pj^SPJN=CC{<0J7VCa?lt`nE`RrLjNdS$}7>(bT| zvY*G*MsTQlt|z6)ctaz}9xIRj=N*Jl*JmvR3BO`^yQl(-!N=XB%Ac`oJsZ0hH0`BV zW7O?Zg@{RqNZbg^2trZ%J&+z}8LTpw;t9pK4vL9XA9Iz%z9mt)^4^7k*jq?Av3QqD9ISMh*IWM3g-~u4xRpzA6kahpjdw zB^!ZZWxmCoH6DDTfRkr$`$BM=98V4kFnSqk>qxh* zgUbH>HIy}i@Q=t6U304%OIJn*tVM0 zMKZJw&}{PL&zDphYaFELW7hs)uR0(WbaLX=v$0w+4MVk@)YQCYZIIef>t2nCC(IUz z@^dNyQ}kdkVdWYp5V*Q&11Vz0MKwuHd!7*oj*dPt=h-7;IQ6*iwPhoVp9g-5G3f%{ zR4p0+8t4zo6RHcVfhTb$dO{`-d1?5YdS*dt@K>ra7PR92Qe!ZpV?#fHVDlwIpBU}I!h1+FGHL%?}-Rn8i-@mmcn_)1V-kxOG zbml(+FPL{J>uFwL*=a~Yk%>sj*1?%i`y zZD4!@k#Vfj#m}ii>J;#!w>UVJY^7ACswOYt|>U z9#r&&(8O%tcvq0i8VbC=uy!{PF2nM;$k{p8L2dxbzJ1Tl-EO>Pq^+cmcANHpY))_G zImnD%V`cktUw`Bn69IJWiOJ8!57X?cKqtLbrA8%zkeG@VF4L2w#@Q@Omv1A?giO8r zU^DclFm# zRDrNXc7DsgmW^?5ax2lWThf8bx*SiW|3Svf1 z245h&9BrMksfO8(X4TWe&YSeT~f><(+0@ja`7(K3AC2hqlmiR7(5P4sOB?S@C%UQloFU^QH=b0OiH@8vVCI2n zpdP*{xU`Vo=xyL9U8+?E`LV?E0t*8*i4G=X_C)JD2ht(tV< zgHS1$+{in2F^}9qdD5~{9CH5a%Yrytp9akf=VOa3I|0;6Us*>Q(u1ZiDI_KFyTyP@rLeVe zz4c%XXbTdA#VMu%XXK(ZBvWPWh5poMc<{O~PUD@_I2Qd%aKeW3#rju|ds z^Px~m&z7tt{-a<|M)3*>IbRs>ClNe=eZ%@QFp#d_@jBzCak>-%$U*&IrV0aj?+i4i zW{5OFR^;_~KUEa;H{wcCkIo+sR`zn{s0<^2*2@;kA9o+oh6KT2g3Pr|I^v=_i4%5c zMF-64P{8FVx@LI}5yRwQ6?avTfWN|KAzn?CA-8)`+lAqPZEHN_}cB;Uo{HMuJ$;VCT5BQUp!z^YzJe9rVsQM!u7MjJAHLUu<8Ay=c<94sNm)wt!ki zuWq+5;u7%B=slcZ{A)JU`X@XtQ=VOFOE|xIB1^p?G#Ns@Qr%2 zbYy_xJioYbdG*p?3L=it1-{-rjCOx#f8-cHdL3*ANw0Kw83P>6)l~WN|Y6vmjdciW`hFyPQDg*s)Hvd&9LwXU`)b~UDcu;!jS!8JA%do%XMAfdjr)K?IE z9^Yra9mi)Sym9An&oi58n}{$yppgT(=C^no>T%9Z=k1H;*cPDgftIrYVCxaU@7aN% z-lT9ux~HMtiO&~a^;vo*{JHax{dYj>@1WFgNEU#dlk+bimF*uSXn?ebAF4f;H$52O52wT5#!UYKCjXBEiht8?{Sz$A_KyhVA4Z4P);5m+!cviijg0~L zYtR3%e^w^ezs~;;-@m-2(?6@x*ni0a|ANN;9I5-}{!n zNf+6F%g28x9{=VV_;+n3o%JnE?ai%?e)pC9-&`cweyK|TTK0c~=(GQU-v6VBj{Of| z-Jc>l_CI7`|AvU}_t^iTi2h%VP5*C2biXI!7q-v#+y4p0H<17LH_UH?->;f~Li>MD z@2_VxgLF5y_fsxHb=)QV|8C>JM@spDze?UmhPiUz=VoF1BAQ)_1ZPbs4^w zn}zRp9^ReajuY;ks2uFiHE0brU60-kS57lZ(yqe$@Vv6? zJRNSwbhf^Dr3ktZx;(v}F3X~SEY90Gf3_=adG+W(=Phfxu~NdA{YcF_QcIAu_4>Md zk*r_W53ttGTP|UEKzJdz$XAJpnUdjrX__m)#yfQC5ml@PODsvoHcO8Ucdy+{p5u($ z(@8k?x~=rWZx6f_pOjK#OPnY~U{zGGX*hb1C*jCw@llSkqGUnU2M(QEp7o3_)~^q{ zxJgyh`3?DR!M9R}tu8js-xIO)AP3059Z&<`W^|MxuEQLDn{5HnK+!1MPL#z1L=0s$ zqQgAs#sHhz8G2a|b{}Lb(&z>>nyeYKTv5`5k$_a>G$?Lq#!i&P!|(0Eu-fc`9@UX( z?SU=xf?$bJ6FMoRUKrJWSEcY*t9DzDmC3pvuJhV&uNiyjPDHn^whnEQE$$3wt`9aV z`E*~cs_@pIAFmJB8Lsujoh9d8XdPN|aUBa>n{|tIIv@651a2Rq`tJDAcR0$J3&W_K zN=pkr9r`n+SQK?zf8<5pA>bk9te3K5sr z>}K;>?3ixU&ncudS`^A+_Bkz!eq8Ld$Ozl$f!pc z>OX7uMY9|qScypSavXuO_8TQW>-)A@?o=*$NndtpWA$BZ;FgYNzdeG&HUEP*KDY!) zHPeEY&9>k@NQEG<7=jLK%}Ba+F8Ygte*6B`eHnY!kBav9B#G0t?{b>q@fSInNI zdNwVqc7=BFL}E!0>%`UW2(Ao{%>6ycu<;YHwfzyS2)*R(Ee#V1jU*eXc zWr1usFZlN#&y%N{yjgpnb^2Kj%`WPV&)bzGcz;GVwS~fF*94tELqG<7Be$5lf_^$vti}?d}r>Pc^mWg*PV^% zkgDqRiO!QnnfYaYiEeF9$&8I3l3o_fQyii}D}q4LqRvGd9Zfg>b)<}XS*;m&s#+gw z13gB)XBICL!ikhi8%8pt)2v~Z$*#W+>c))@4bQ4)HhCK!Z`%K|pe^cdtAX-+&fU-X zwQ`r`Z@G7|$8|mFERvx^ukLGE1SeJzFHl7S)`HxdfJ>%gSw1W4b!MuE2Hx9D?AR}> z3*SY)%{x{GnSS0LtyF*rzN>r(jW`_)<$d-PgRT(}lF^?`Ce|YMxtk3|OTuK*@S<;) ziD-3xRUnAA1|qdE&jRUB9l#!;luh(uW8qn_`=Wt}2+5vTxkD zn-OH1`0I=;HBI_j9Qx~?YYfcxyk!J4tQ*i?275Fx?ZnF|=CF_uW8!PEI~-V~rYE90 z1*DGntU!$&t_nnUL-?rlu9CbpB{eV;7#vLiQEdRkq!~eHvjMn1^wNGxl|^#sY&w;z zGE*{w$DkXwbt~s|!^P>w!6C&_9+`b;I86`Z2ZE0o!GFT?qC)tw0O=ZTIjtG8K4aY1 z1e_xtjU6@EXx4>4rzi%4q>9U}-N~v88$}{4T47oO(CczTYQ*${)V~(%NqBUE_WrEL zv`2{UR!|E4s;ki`eWg>dp;Ayl>Q^smuQ%vU#1$nDE}b~KcgT5H4oYC{IVEoyP4!{2 z)`M06qFtqeDsh;CYAR>VLph*d#)8Ji-Yz(hgG(r+|2gv=Hk4mLKR0_v0$jitv;+^R zLtPI<3r`F(em3r=jWsg!}GIa?{eGS;ChwVNVHbT50I!}VJ;m((F2<|RZ1>R?&5@tWmvWsH z+kX}MN`Ar^+=L6I=@R-_3d`DBbaaS-Sg<;4O#$Ekm>V5s(c@Lh8+S?;%O!l%2n-QOU#7rXA zfmy0AL(Q~~Uv1>qGjkRlA%$u@NCsm{3xZwq$si(p-wxcBH&UColhaJeO4eUqd0~xE za-9ylrxt(`^HzRKhDqY11__6fK|)@q?2M3u>2Dy9mQR|BOu<2%g|7Mhy!ikk7PDfY zs%U7KOV)r13rZDmaCB$p_TAUAH|NJ$&RCAmzUue+`K=k*q-|~c zjMvHfbEGaP$yz4zU3TPXB`#Edrjnj;R(Ok$X}n^k&h9-5ofaZzOw7{(5;WS2QucuNV+eCGO#8x9I)%oqZGYBut`uoc2tV_k zDYUjhF>$5{exG(`RWUThvR#VxG46hM$JDDT!H0Q34!I0`^gR<5JuAD)Hcw9{c`Lew zWv+GX6G@LJ%n{mUy1AiOd^*)PVP*B^i}$bojx$`qL@YH&>t!;^62Ou65E+@2YK22X zI?TsgF)1UKf-!^BrXn|K@wrW)GS5`D45G9&12yGm+HY8N*6l`cnKf1>!qsAjKFb*! zK*~5^UK?Rh7`Jd~@Hzld1AK~I7R;QZSx9|KwwM@ibQ=JJ6$ua`PU=rmA|_(qkCr8@ zsMDgTz@n9KGPK9rkka00WE*^sx|~M03@jR#d8xrGMitG2l>%GOLPRDCH^ zXJS3i=8P#5D5#KH?Qw9EiIXi_+{e-}YSZe*WDS_?+0z|O9>Y0J#aE!JErz$a%i~k?qbYtWA+BrLbvczOacJATv{vrqp2DF z8BwiRn-CI-U=tNw*{{}R^+gPmpCfKoBK$(oBJasUXhHH${m4QqQevDjL%`zwlq!mg zW|}Q740WPL1GYB@^#`HZ_*T)%W0nJqY+0_hLEZ&5&=I-x4CWx5T9L#h-C70S*GFI? z<1mj?(3+0HewqXjJt4-v0c-UyxT(gqA}Z4B`4Pnlwv^7Fmv^6bvEYS@SIG%BwWI2 zEkh1PT7k}mmv3g&GM>0>YvGbOMM32JK2lOrS{t*1Q=YBF2`kv^ToNRT8#KrXcSj;D z&cGtjMr{_yq~52&W*XWlRFYsA{0be>z}jcxR!bY;iFx${VU0Zp#IQa#JG{rylFt_pBl7E$OA3G`Bgr;y<7( zX|&+jW|z|U_est!aQCTK6y`|@rW$I&3V2JVd6l^qM9a5Ap#~!ACMS+lDf6)OarI6) zp^QhM5;Y}nzW6DMu-MpM##r%--{Ut=2-{JzjX@GJrhaNjOB=0);hzKJSzu=Q0$PKB z6#hjH_FW_smm*W&Dm!rbS$V61QQd_849- zV2>5H#6?DrRFW1JQ%nt|5@+3-UT5euk%lmyQJ%UgYnWlX=3~4Q9x@#z*P$^H3ibvG z8q6a5_eo8*+WW)L#R>t*qA1A)P07afccI6D?Df$FNKS~k#5ctU z>bH)V)#LnCYd*8-vyq3KugA$f`(C~J|z#ShDdP+~NVLGm{^ zTaO4Hi)vO08tI=12u&*4oQsoWiSiUB!t%TcpYn&i5T@-iK2Iz02R7gxeMNpS5p$eD zN|vyTbolr!C~sv|?T$oMC#?lgf@U(dk_OIELXVqNQA8i8{8_;xIKyH*^v3qPH^qAn z)`JgGmnn*wQ+cRGcLpVQ3R;!|l-6WgXv|~7E~!i=Z;gEmwh;4@?R)glo;I=lf)clQ zS`u0X=mP;YUOf3rwH0!q_gz7K2flqnmK3ejb~4op1qg?|G)>4m){!*GS?iRv`5|a? zdn}X|ge30Uj1+z#k857m;>y9_)F-H^Q>r6CeECn5booH*RwR>K!5xH*#k!hZV>=8# zTK2{d=&A++0~Vw=@B~P78FMY2s$_u7%o^4KMhQ(VcJ6UEtpmBMEZY`D3cvp{uv8mmk2r%(5}<)*II zbm@>+R2ux&$yU@{x6hD1Jmk=yUg zUFE87%G?PwuQzfc54F%^jOShMlix4j<78CnBnBhqXj*%IQ@=M&I(f!M;?Pa8vTj>i zVr`f#9=5x;lQ`ZIAO*{)N?C$FfSZH%B%Ok|yD6C?$E~hZ%y(6T&aSVhPY7bN;?i#F6U7 z&M4`38M+IZ9L7#*8-#((JbY47o$tW_al20!&K>D92lHLE9~~>rhz})Am(IKLW1?8y z=C&c}9VtNG!E`~m89F?UNb;e&7<{6kh*)&40T8t_4fyG#UMMdkw_@GgD62_1#yce> zq8;16F}0;F+{df1^Ch#zg#rnk(uK+bT`+!R+19$N0k|z=Lm(>|OshFOrgQ+O5jJ1O zEx+nK)DG-9YFPWA&?^?nMmF)d9#5E#Qp7H9HdZ{2 z+X63~*`tPeg(alvV45h+O8*9@hp>8GB5v4^$gUIbqDL<#sWF!x`0QL5#8iSM86k+` z-#?eQaJP~-PuV8~i%bo!aXD4r<-O#vMHh5qsMpiRX65KOBUPtKGh`m~crDBI=9qL? zF~QNMmzlhGgeh>bL&h8KKhYGCn1qiZgOf@`39gX<(0w5k_@oRLtz?t~>PSQc-BBe7 z#pkzu5Fa*2n5cHtBr1*oixD@DBL=&=2>6a`qQR<|9{q+^hPUAeGRNya+Ns$|lx64C z61Au2>j=BD2Zs~j{$t?xHNjt3p|mK1#m_gwY$l)rs>8+Sr)D72*G_m4I-=S-q{Nb8 za3Sq3;;8YuzaXHn*IGce9fXEztRDeh@coFN?}dhz3@rpSSF+<2{>Qj9O-+Ag=IsDX z5CQWe$NN2pofj%_C_K{sY5h^wH$Sl0FiX%j4!SvYrQN|i)>aN`V}KaY7g2&GVDWsm zrn-i`?Txr)|225WGZ@;PynG%QM4J-~9~JUmFvLf;kgL+RsMjYf`CG24qV8j}6tTmyyii`_03 zeEpi!2_psOFCSfXIP^UEjWb2SQ4@Pu$9Y!2q1t~`!^-Ee8-8kQ0!c0kQfe#~LayRK zE07zHNFgibhT38(3a7&*1BgY_Zy-y0WET&bzQ~A6G9*7kg=mx-q<|1(1rKd<2n?>89eP!=>nG%m_fRSJ~%yV-w6g*QDnW~$wTWjHEt%o!#l@3sY3x+TosqAN;~3OI92#qo z9gRCF+V$04eloY%xT(!9(l!kq+<{DfglL--Yf8Dhn<##qo8lDvbacnP^sRK!RRi3X z6T%qS)8T#tuP?9aOpIV3u~Um=Zju25+bsN=R$c-B5Q~|DS|4G*URT~7tl^gr*p9gR zS!fvADxM@IZTGP&<-C|el_Oq=oj^t+TPU@32gWR-+P5f3#<{Vq*2%NSiqWorBMZzO z{p<_5^5NAn7}Wp_szUKXs=^(x2FzuTUqnes9MP3sh0VdKrABVkw>ZEt{1arzw*nJB zCcn9)tISW`WGJ6xPne|E#=1B>#^dkkK~oSl`fLDx`#Xhl%+fHCsXykDjPVj_iQ|Ll zwU0x01$Iopjo&hjx$Il2zY>g$AxrE)io60q{ic}{;ep9Cq8FLT%K4^biMLb)Pj_{wrD6ykGO`v}S}5UgS`$424#%fF z>_r~?TqHyK{?RJ2IYM7o7;Z}7%*Nn(UESG>p|+N;)g_06uh6CDCDe*-xR30mo8+UI z=^Y{Zzx%#Q?i?=-s0>0&f_fQp^T2$HcGWekS!^T@N7Xr`6HaMO3J!bpGZ3wBo0b^a zq#BCnz)mM>1m&p+OZC9}iA>4hV4~GMOg6c{h=|eN>Y>U@^bSlM4j|T&i`HDYnJbb^ zgKMnMl`!ZJvsal4-Z452Rf^6`p3<47&|jc>omrD?Uvf0XtPne~1z*pq?=`iatF{E= zW~&Sj8G@gI6=8_m|5oiAGd;#5S5thYK8PBN9LLejD3l^UPhn8;BCxZ5OjX3F-LG35 zO`mrmh-V_G>oH&dU0cUHCzrtiHb&>rWG-C;fQAK!CW}BWrp9#+FLv{h3zZr&vA347 zd5Zn1HPx?xUcbGkMc-w{;=*e3k;Zv&_Tx2JhjJfnSBQ_*qw|%_`y78?sLR=_hyV?P zd6B_1_AaQ44+*+bT9@^9a>pjjPv`Fk+>c|S|nv9G4*?=(;-Slu*Gd=#VDuA}g>DK9HwZ?&>gHqJn)$}s+T1^-5! z{My9^j2kz_`=Q&7q<{;F3zhoO`!(7`PQYdN^(?dXR{i5>&tZ8;WM3PAACF8-426H~Q4H z3RuU5)1&e3cROXG=l=>z{sZ#(1%z<0vit>0=J*S?%l;26nU(c7l=h46lbwV8KYFzN z6%*$83%2`v-apfCa$I8z7FR^mYKiM$+om#VF^0r5NS>_bEpInENLj_`j^)=|9oYf0t79kA?qBW({_6p&YsH<^6hdp^)>#;oI`%u-n^)(>E61k1x(t^5VMi`op)~gcpKw z=hCA)!^NNF>v%uncYE`D^ZN37^Ld~B{OO8(e=vBh^Ye;lkZJo;-Tl)frQ}6G=Tg+L?|tbYL1}8F zt=v(B7y9Zs#%!%wHdCJw0*f!z6k(Qo8zHu`Bteua>SMA4b~6OkrKR`n>iO!Tk@vP^ zS}>>AH{0Rq;rTQ#=RTB`Rq^2ZR$-VhQl#VC_0w}o|M-z_e0;I>J+ z?eYxHdKH68#0{CaLK_3|6$Yv~!{=M+Z z1KkVI&jyaX(P#XE#m23?&G5Pz!beC!3@)d~4VG`(>rQNUHhUY^@<|>nr=thmxfVs~ z0kBIiCWC&?p~)oru<>%v1K8qVaQUc#c+-enQeHV-YS63XZsTo&9N6^r$&{GmrCmT0G!NL?J$_`#6wAUx64Pc; zl$g?#xE;mHN)HGfpx46eYP$ z^9{Ga3In6Y%6G^k6vbm?brv7oCz_(qg*;7R<0730{bvkIvFCSKS(2avecPS*Rjj4R zf(`d`snFcn+(1HlHSefk3&T$}E#116m6T{nxNULD689=aTWF8R^@xx{Oyc7OH?9om zH4I{@_Kft5Ne>p$-7_5dHMScp&z$=Q3u;L2;b96wdtvHb$2c@6TZf=BjYb~0 z6*-u-F!U*AVR!?HiqvxVY^zmyCKW1gJXfJ)&JY8q*x>gPXGG{Wu6$DD@yDv9D4QGQO0qqajB2~N_kt2e+ADpyCtVU}HN}*Nkg@*-rYe*>natmM(UNd}zDVZ# zk|$Lfo^=dB32nRdv6s`B2?-`bJSJC+69r3F>g=5~6Eu@v;((mGHi6{pO8UleU4yDf z9@1PbIJoCbSn}S8=+`vKphfvK)#)rY3bmdqE$bqzb5*C|*iH(Es^bKtNz>r)(;b*F zI~V38)=(xWWN$)c3wVx^-h8gbXw56^njyBr)u6U?ZaAgR&JQP3gScwpXA!nq_8(ls zlt6Q9$m)b|SA91^w?Hxy)XGRNAFY%(h1jGhGicMrVzKZGgl$!-FcBP^ZRp57z)NsJ z8H%$&Ug{+IxRZPN=3L|=Q4Xp+sg!W@J{BG5S`+q!a6XnApz%f_)#O`%ODnE442Mt~ zF@@B8^n^J0#HE?9<18J(BY;z>;9(*Fq3I;YA+;J@!3SWS)`X7!HY^;bD=BE=_$Ucwl6|(1}uU#3K8tqHW+hz(HXls24m4mmP4iP?MA;ff!gtK>GnY z87a`94jhXil9En_NtUWFpWMReGZ+g@J?beoB?FaG&QxmT-BgnT$I{DTOtCGlLWQu}xM=wq1? zRAi1wgl9GAcJi?{g4S_XF(%8quUNPUBHMxM2{H8pEgfwJ z46#^$mNIjR3aOF9CV7y!K}!fg5>xwcE=P!)+@aL%p7;nDhD91F#i7TetBBpDw%>rB zHz6nLo3E^8vKViOAnpm)XK~w3K-q~sNXX5S>9>hnmOQ;Ohv#8|^X(REIo?wBZbI^S z?zbsooW~y@*{QB)k5abkg+xv$ULZ$$*PHZ4jH=^gRa=*s7KbJ#1n+qmsO5`E$AqyG zswM8WZFV(HgE@9gw=A9$3PAg$P~VmD!_a+_`%=qq^vLw#sBn>6DGY+gj7$kU#@Vy7 zO*?VH-O)5cCnQP3`(AyYqdw73(j1ui^66sGU#d3L3Qlr@tGPl3v})?Ol>VVmVtzM? zL-(ywvlrGi^1_r6D_mF!;;}@$_MqA9qo&bIfgf|JDAJ(jF>x)^qng?&EjwnF6 z%CKgobg9O^A8&tOFkdu2zj;u_nY>uV$rdf7OA7gvoajj*1TKPdiIW3>xJmZNZ%!nf z%wL*F%Wz5v9UK zL}C@fk1JC`SWmCT`lMhEvNDoQ)M#Kb!kN9Jly2APJbyqE8_%_6dSfN6-YtHHz}(<| zB?5LywdBFJi^`NqCIOVN-^-`8mFvF22 z@G0?#r4nd1VrI9YSugM>l~nEY!u8HFH5r)iFWzo#b8EUr0f4;AVj-=$-K<%aVHir= zAv7m390?3lj{sE81j2Jw8#8<`n+d-lZOm|=hA1(c&myRs$=K5?!tODmPKEW)VwVo8 zjqrwC1R*$)NvE4%Vuzuz*I7gg zO}uRLOC|K*|yF?k(6s2VfNk)ni=2 zlLcA8XwYw$(-#=>m44IEHKL``duwhitQ~j^S*(B|N7mEOgQ4wh>(1tV%1p8Q8aVw< z6y!EQwJ$>TV4d1*Uohv8jG%~@dXX5~mneq}0prv`iUlO{r(lG1->`X0Ns~C;aEq>N zm%BC}2p-#|LmD+lP9b+}VL%69fF0lbH4L9ht;hkK(AXva#5idND+ZoMPiG<&e{;0) zo3?%!bS%J+<*Xe-r-zxJ()AiQQ_nR%&Afd)2NnAet_-$abzj z;Vc#%KlY?Hevi7~F}>BYdNFAkLpeQRJCHL_qhKH+stGIwRWDg52D2yL{9F+VanG!K_u%3!L)PY3H@sSKxG;)J~G%uAYw5mhfm@*-?)%q!F z+%4G{&s)koNlKOw4AM>jIn;rpoSV+HR71@I-fvY1mlA_Yp;M_~y9M5zEUU8cq+VVkr6%%L_o4xt+88XtAO$ z_84Y@!*b{&z}^g6s=V*QBrdzz0MtuL>;E^_C4 zL+W1uWyF&Pku-LlG!Eu`dFBxEcr`(KXnhY3$gGI_Lol$(LbiAl^3ZV2WFR#HwLO5Y zKo!`x`0~>RfYRIED3m-rM7bCu2ZR_sJYh&wI;@sV1es|z!6=A1JE0H4%~A_j03Sq> zv~Zsf&xLrKJp`|80_Bol7hjaBqRD_SgoE4xVSd&nk+iyQn10wSr7kqMsyaKtRQh

    TWICff>^O0i41-mPU}QYJ&c+4Fu}`Dv+dmTu$I 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

    dNx?JQHI*D-bQB~9P}aPj12_V)o_z!cl^!mi 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�rS@dA>@t!lYq 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%0D;qdV0n%5O5kA-QI!M;0$Bh=Bn%ssL>34UI5`4B z1l$t1$p9Rqg(0|+8o05Bxn8kLL|Xjj;&5QO!$_2@F7e-1nl8~77^Fdr>+7J#G+JWvLBTn6wn z7^#7-DC{82e_Ef02!#SjED&V4K)WNPVN^m~@ZkYb4RjnJmZ4M+f_}q+PJ^`f0l?bf zaA1_%o|(N%5O~)C0T_1J0t5<_U4Z40YS$bF6jiB!Ajt(lM-t3XiE_a$3h*!x=pnLE zhe1VEL?DQ8!L7X4rYQQhaHv433qsXB_;U7PP*D+J1Su{6Dw4+S*1Hazejv?(P`6Il z{FfMkSljG)B9hMRmXo7|0&M1h4^jZOZ(s*|fQ$uR7~L(10)L#yR&Bl;^6swSe)3|8 zYBeFW5`kISX_W1xWw@{~n3nfxc0qp;l@b%+9(#3Bz#Du(bqORDK&ut#dcdBH1)gOF zo|dxfNZH=A%K*?Fvao-=R;a3teR@CuaKM33%n&G?0u;t5qU}L2P;udH!JJ)eXrJ^F z0PKJT2LJ>5c6(C^sG?&IErWKk$=!}}h~=zN7C}1%6!dnawgldFfGxqD9e|wy{*EAq za~L?pQV7gm+Y&Cj?TKV5ZoTUOaIj7tRC(>c*b9;H?pOzAuRReIl_(NyiNKH1?Q?zT zM1y%BsAfPVJ7m(v2e~6+ivu(tT$ct!4^PcIQ2;?(3-C`Q#1fS@4KPH&zPq>2VTWE} zYabvvhDRK>Qt(#)bN3t^9Ner?Rb~j%HE`$JGbyOVhycW3At?=APjpbTgKd3)EPzjQ z+DCAMF5vn`eu^JN3SZptso!a!?@T=`8tz%|sLnD2%L=H>WuROHR_?;?1_BSh z1PIx_WOaxaBT}v%;D~&6`*V<57}-AZuFa&~et7U+vL#}k+FDf5uin|`-ogicVaJF& zc7<=!fOg%Ujy-nWy4A985G>oreBisc{|C><09MKlZX`<%Rq?QWRb?-1q#+Fs8(4Bc zR~aZ|fjwO?umLwUbf8^DSV;!s?x^=44}^0QcEMHvv8n@ySj%yzT+^ssEPoDD;yFitkY424Kk#9|3Ssy# zK>r4>HL^jAH-P#8Gz}=&fK6=c?Msg)dt>_{^I?OkwAj|L*~Q+GUFAS77z7^(tnCZa zUIYgLEYdwshu-=b)@p+u>D(PY4+D>?^gs{}0vrbkEk-UK1P2c!p4}%J4sY}ve%%!2~-?)z#; z&M`nO{l9vy3ScT$C_UTStK6S-Y*4Y*eZo8de55=N<_-XSAnELO2We>CByi;R-n+$z z0Ya=bcANl~;rAqwt&yR$=WZ?xE-ghUAu@)F^(sQokHT~X5kegFRU2r?15O%RLjSG| zbs*p;n1~4K2f!TQMmDGlJ@{2HaE$QPvEx{9>8u^cLc$J_%R9kl20SIPyM{$GPc3aG8&x{}!Z-N5>T;#y>rht1KP?y-Cs!I^WngDNw&BI+i z1dCX&fD{QqstEuKTcdly9>6>Ru&@?8!pQ;X0KlFLxGVmjCL59e??B$yNZY5^1PtQ< z_5nZ!*vH=9-+uy!YSRKimI%fO8UxU(Q`FT=VWdRv(e zIBS4{-X9c)QB*0AeJV}hZ0&^)#O4Fs2$Ug!RU(INbRKAD6mpCA)x`Mp4axO^Z` zSfvdE`aj^m2iVjWMWq4Rr^y6bc`wvMa@*d`d>VrG<;#y;`}Un`)?fWw7vK_HtQM&$b3u&fHOJ8|d$;Rl<6(g_$epeqc% z3UoGrO=)1JU<2L50S_4>%2fd)E4x<(5(>DbGL2&T0Qv{$m;fDf_0wOJ0qimGrz z(CY?57i@y|tOMjaSujh3n?3(gNFMr4@b5JbQByar4)`*gDakOy!;03=ZFAxcdhc3%8I3!Xc>am2AW>LBSJyB9pK+kN=+SRe^eC>T%cuVK>Hgs5agN@ za32ODhWu6>0CFk(^3Lw#gK&|lgRe;(I4`KGo_#VD;7sjZiU+Vjz>R>=0W`jVvygy( zz~N`M4+M*)e16l~*Sgg=O4 zCsA()x?PDHndA;~4OEyL05(R%39&yxIZ1*?J0A1Lx2HA2?1H-8K$RB z3T-KJpXz2Qa$t)!sSS%j{6plZZ|`D+pw&NXV5bVO|F7LBNIwcHDvf8t~}6|FBr>P?T<zfW%xpera!AIP>>i*Kz%pdJIR zi|=%9_6%Vc93(D{st`k>s|4A44T&)UG(ZssyJ!z=OIkqDz#ef05PHP9-7yamJczZ| zc99E#E4AzdXe8Z8}I46uX$ z1rS4ob6Vi6A{^TRU?3rl$PZ(}p#h{F$UOiwSQQQUAcEf=W-C;61;SzmEw#4|06~7D z5DpO_>H^SE2RkqfoWKMY1}StxVRf$+bgE%bTH3Q%4g-xe009tpx{Bax*|zlFDM!&D z1Xc^+hX5H@fcAL+wG}}B705YAWyBAIiK=GUcN`98M?~AAXb*xg0kW;Q-9SMU+uN(^ zzjZeMzbqhBRRUZ}YRA6&=^_NV5D45UVB0r9>;_x`Q4$2&8Tv0!QPl_t5^sQW?C*m> zw%&yzv;(dH5JWf`1oNc|wC{#+%KYGfgjgBuSPx0N1G!!sXgyeK2GBSImJ)bi3AUvT zeZtyq%k56cNP;AarVM1C8r!ZM1g3E?TJn+jvpbsLo7x2*szykX(fD8((le>Fs3h6G|fs^?N zk=pLS-D%(Nz(tZMkxO{Mrx(_bh4olr=lo!@KHzrXE*nGb4X*P4r9+_TJwxE?6+1(L zP2gTn1xVrnmIs2qIP~0(%_>`A*jA!&Pg?FvcT7T;rE^@Vc<7H%^8cNp0h}}>N{x^$1w<5H17ure=qd#?8ew6U z6#5`2;5?|oma`+0vpr$v5Y#B^fqgt|dkXi=1#$@!*jxarow&Ac27WbC^ODOrir6G1v-;h)eb$aE2%< z2e`%s=nq>~M4*nyRU+V)-QDg7TAsk|bR-GpAb_aqhJ8vA5Ty1zpuh+02_zWMo&ZhM z+j3RdA_S%$wyg*_F%Yexh2np)Evo8apF9L)+uD0v0l7Q`+_pfnk=%Xn|Gz*(RWa<7 zg@7QDg@7QJg@8i?0-VeiaRm1u4>|gB@B%`t5YAQTY_)`f*V0tvW#WWVK& z(2ecgmOCU8p=7f#(!Yy_ZL7sXUxBBN9Y+USd`QG0AY1aND24z#Lv`4G?oKR65{*#R zF-(YC*5I7%bxIWbdqAxSv>#!?6xh{8EFEACZiLbS2%S6Miv%pHM2$qt0fJmp1Ll-4 zXh84;;yhqJc+TD0EZ^+`hk-&>5bV>&fNU$5?6n}kg;2~c3?>jXVONP@GyvEwg5AXd z%Gd+6{|>aJJ*om?pHc?Qk_eH0>s<%J2D!Q^G>8Jc2H0SPF&7wf2k9=*bNe54-VSgK zdsJn|J~a&p5;YA7ay5C%K2Yyo?+~kGP17Jn~!D;x#Mx+_|prN2D zN%pC2K(=RUuR9$;7+~%M1Y=m;4sb~T@D{I!{t3?EZDIrnhfFPGu+zlGYI)DT; zOqdclM+Br#8|bP4)&(?}{)g~skBZB~HQjbBjARD_xx(LWuz=TtaULLYK(q%#D5!`4 zEb0H1rBS8-ZSB8ZmPVqb2tlp}xEDN7jKGdISVI2>+zCYS7`DTl0#(_ut@gGXDw2~i z$VEl=LPd3h3OsEG@_o83X8}kwB7KHq*`NIF_b~rGK@YjGA0jw_*~1DBpi2#0$p@kZ zu(b;?eOTlGvg!5-M(FEcK>VK%;2`#5Z-}C{+Li*`Jp-_26ZDlGt_atD0lDJ#D|;<* zD4T$tLKcRuQ=pX#j&&z7|Cg1Es-A&Met;_%iJ~9`x$w{4Ndq_p%3V(Azk#<+0m(La zZ4R8I0Jr;rZVAwIvw{8zqyof~6|hqk-~_{4?!c!3wJG2xu<+G^KX8yT&}af~mh7?p!2_~KRg=LL6~KkH9dGtvMXt{edJa(Zi0*g>$X=1P5rIVn zV^RMFJF3Zm3xw@pN0QEwi;RQVfl3Itytw;-H(+;Uv0EI99u^*es%d)`{^w3*k63Dg zsJG_;Zt?B8MCu&7Z@9u2DLl%+qR$@c1RWx(*tK^W4m>Jjhe*7);6tIpBF*l^0)K!U zxB#}NYS$29-vtiQ-dvZILB__~*w9qh3QSQ@9T8a4f(ht=9uEHyC_iC?^Lb1L#jTGK z(z4bvHq*yskk!(Me%SU$?0oo+I?2|*OPT3Fzgfvj7yNh3t-B6Zq|mo9LQ93+7EVZG4pf7F<0Wk=enwr7h zwk>zVAf>Bgs3mCji1Z%t?X1u{q#P_v>X>`Ryi1M=lR?PL*vwMFTuWP*l!pfjL`cD$ z6gDFaz+a)Gu{G4zl@}F+zE#0oAACX7Qp+CrR0fep)}jj5TGp^%7gf+A-Py{4j>_6v z*U}XDVBoE{pu^hwl3NfK=nnMO{{Ray+~OdG6+8^LI7zq1dkd;$0T;7iP?33Hq^rI4 z>(GzdI~=g#bB|OVQ`b}nurFvh(AJW=rux+SIZ8;|=?g2r{m;8L28vp*}m43AUo8-LAZ$?bhc22xkxo@NJn{&B! zWyE^2bq{0vTiuHoNBem-DueX@#ZKQ7G#=YwNw<-7deR==Q7gdbi5_AzcZ&-(By2Jl~yIYaV)v=8GUT} z#iMSDg2yD@U$&ec@K{_9#AlYy6~q~5jP<=fN%4d`7zo)VA^xLy!MbDTRj-F0wZF8w;R_JWKTokJQInw|QqpU&b zMYwy(7jgz~?=G2+QC>VXo2%d2tEG#JMEU}#>f7^6$CnKSCzG(3R@|SZkxV4Xgc_<= zDoq~aXBRYWJr!zx_9@u~f3-@R3xpLa3Kq}Frt~(6Tw}B%=1)fm@{-ySOx{e#zB_=! z)Irc&8}oI@c135Sw!Z}J@&{%;pZSYzkB!2dm(SYwYtcQv*U?l!&|xV}nizhv!9H31 z_`?&6=1F>ycWuLl>T&U(>0;&))wAgH)1+~q){d(9@L9umITtDIK-_(&M<@~BERlTLGX)X@035nGo6`#MfRu}1OqryD1U#ASUFp5!UN z%uzifc_+}XHa}#khGW$1aubWL$yDZ24_ft!J_Dg2O=BI(F7>PH$Dy=GIG>ZJ$R#~|CE-{N!I!!%okyOg1d+?G3c1Yacv)cSVZJQ6z`Q(+@ zMBO@b%?SZ3{7TVMkkrOpY3N=&1OFlzcY{w{bpjG#PRddc=7jQ9G)kW z7yL!f#(vQ4o;$@gdF^<-|H#v-pICf%HLkb*p{e`e-guv`d7PJW@rdB?-GT z`mHTJql=SP^yh!PW~qB&8#Xhz$uV|0`e{O7wio5%nc4fC7lqyt-!~vAt@HYn@JRM+ z^~EM;-v=f0O64W`)xDHoicc~J&i^hZ<*qa2RCr_?9VGugaY0X7xcK1{q4z$FxV>h% zY^E871MLBWl+dJzsskEpj2Kxq|004MCoS?Q5-8K2XhPqMvdA+ zx7W|gn5gkMOXi7YethM{krS_2m)MHHoUPm!0{4PYka=A2-3ZHP_Sxwd6V2?eqWKl>P|BVT{2s63a>9_7nNs$97cIa48O9Ts z^5-mAV@?OA@lk*GJZ3)@;3pmQ+sJ|=E~~D)m<6xf(5Z%jsyo{GC)4?Ssabmn2AMcc z(9;*u7QZ20R3jF4i$}bAuHIdJt8uLB8EuVg9@>2P-2#S7`R8y8hWT`Et$m7};u#4y zFvec6SGZ-Ne`(CRxQ_;dR4*wEyp00?#7K;-kXW#R7YMDch_nVzT^EheF z^yrPF=kQRX);WjMxkqswm%SY4yt4m1*T4;zJL(gq@%hiYz>B=$LwAP@v3eChWs;p7 zY*VcAUM<1TknfVx6Sk-L^p5G~U>b8Eahal}WS3EAx9)OT%B5O2DP8ICY@XlW%{)HH z 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 z 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[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 literal 2054702 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⁡CHVpl&nx+j;m=VVFwj7Lir3(oU1J1>;FJ zI+pEg|K=>GagM=TvkF#qnrLEBk(MSNU?O_zTN4v;Hq!+2MiXNS%%hwNvsIcHoZJ#d zT4_iYP=|U>6IYngBVcxF)*7xG@weCtQ1xN1jX9MrOGaf}Hq3p^P&fmmVGgkuD8hO4 zan>V0vFiJwaYi7w1Rh@l0AK(-ooKPn-ww)DeL0J+`5BM}Ihc4TtnZU`tu!_D7whMCHdGvAC(?wy>`_?SIC{nhl$U@=wJo>0G z<9uEVSj7@Y*&lS;TpM#LUz=mYtY+Vur4h)g9H60)k1)|kIn09Rshzeo0`D4TaCav9 zC@@1wCe}2XPG~OAtjodj+J+@Q3k-dSzSGi~dZ{Mi@+4)8W5%o(JZFh33^Ut3%+d;| z{)dVH7?$`fXJ*cUiDdR|X4BM~WQi#*Hql3cxrRg6wPr0~O{p~RBQR3wQv!l!Y-%bO zXDwITO-iNVaagHzg`vEtZ;i78oM|bQhKAWzb3RLsb#w)+fR$q-mN+h?KyhLd=Tw-1 z9H5lKPJv{Jw}{#eOMI48F4l3K0!u5PIv_eQVOZi*8jv;x25*o;5Z@YQ^RMJpjhj|- zteBp)HA^cXGWv@B2Kw?j8GRNQ1{VEHTUr5?0=dGgg}B(bX*HEwOMze;G3!PXI>~6} zBaE9?4oqwV2k`*`tFrlUpsZB-tT2PqX$7oYH(3h=UVtT|&zdo=CyjC9+H{&=!Z)L5 z6FL3qVV1LGjCnk_n*vtADi{@ZMsYq+gaJ8;J4#lPW8T9!UqDB|#YQ7m#^4w>`Ybr3 zYhx9xi4)#gR!%fx>9eFiM`wL4VHF)6*DYWY7>BUHY(wsgLubuRiluL#VWSNlU0X90 zXvFef&Nb4}AVT2Y8anzc3B#kx@_G1d>Oyg@HL>&&tuYQ^f!SgXcXRCn5>|<&;R=F_ zG!9{b84AK&IS=jFBpr>GLHBFu=#rNlXWClBnshWG9B`h-AuKRQ6+v7%4Sj1Q8$fqK z`aPEooCSu(Zu+rtc0f}g9m2TS#fYUV%pm-|a^QSxC>sDn2v5z?(Ix#k$nvjNcd6Dy z4j)rF6jw$p&AY&FvLBkI5fJPB2peF$!O~+?+V&vM z6=07AfrjWN#>KGSHeGBbm-IKpdZQ7R^)4V=kj!06_(u%N7tyN0&XNy7#pq;xQ~V6Z z4%QWaPx13Lt3ZpriuaTCP4P3zVddxZ`%?TY5(1ykYS7mdKT}#C-=E@VMXK>SS?R0^ zjrv#m-V{G8oWbX^F7!3U&({<`gJj6h=kulb`I_QqxpnyWDSk$AO?^Ja&sTX-_m3z363nHC&3HMC8j{XreY*#t>MB=5*(Jo77RJdF{g9zs`v~Zh9r1!ES>}}N&Yck zy;iWQA~k&2XpM=k>cODMYW1BK%f`1RqpP_0&5__0X5fvjf|Zs#3x=SW3zkqoz77;_ z<;c!i#s3IsO=|=bq0S#RoOH2T=?cTLJ6)%-I+E?QEEvM;(hS*tD`$g7=Z*7Y2BX$U z>I3HuwJ+w;RfRbQD_|9@f{|95SD6{I{Z_ODV=9bk)LCn^uPV0UMX82tzm+POxLHtO<~j; zYKg9hNkD1&)S7TyW)qsrQ+2T6S;0b^ zn+7Y);J|NI!73POr9rS^Y~~uATgg+77l2v?t6&uLz}P_fJ=aR#YM!#{*qQ3}ot9eZ z^M)wiXr(L69$sWW1)LRNYmx=0=F_m?x00ts9A06Z6%dU4G%E273w|qkO8WSHYnHx1 zvf#Wq)3D&TlBXPR&a?_vF3(mlB#!Tzf+4q>Kn%~lYmHT~s?+4B@#+Y}g5OHYZL3wi zwzYy)EI4XUW8D}Q{8p>sRlN$&+Ak)w{4`Z6pR?e%k_#Jl&+P*WR7yAh21C;W~I8v!}-)XQ;0+_qa*rxmaY zhW-;OL19-j-1Mzv+^~!*j0*@j1Cli6RY-<3zLiwiI0bAOQMM*E%v9eP(zwD5_rP!T zdhFOFX}rg>F{JUW*4(QZw{5LpZKN@aE*t-;CiZI5mDkTtSEo9Sq;X7TP~gUYDll8E zu)voK7?H*(h;1uu+{#hVt%{2`TSru_k^h9cZdSv5tBJiT^5JEKi`LM8!l8fowuUsm zl}y+*#H`)sN$1MWG_qV5EFmkEzLf+OBH@B!MVM@WNMoGPd>GQWg0Or<*A#kIXv!C! zJqao?1;e7h;&oDsDHy({U>GNzVR7T{NiC*eSS$nH&mzgZPAEQ?f??`Q_&TY@6b!SE z`M$nS;SjFyOTn-Lig+!mQZ9MC*7M1!jn|@PvHSA*wiFC+DHz_eRa6tDC9QZTHQ7VqctWnGUgsco*9cPbUG zklD~^o8JY+o8wY%C22I;W-D6dBuhatZL{H0E6iw{ZP``9$VW#i995C$*@+6Xg*E7B zbIb+1FvX=_?%@R(LGi6*S`eL9m=AKP5WfdAJXfmR3IY8zHZFcrr^!c0;W*2sR+zo& zJU8Y1W%g<;O4ADdB^=mp9t6F8JiA%+Sh-i)B zQpd;?KQ>_!Jq)>29Nxf|=D5@XGZF#}t~^XQ=7<7Vt~elPV?$fr^lDW|w%M|) z8k^)&Nk9kWM_`7+aT`;OzBPGlGHM4pF103Z1{Q^xObU5EagIwZCuhgyX;rJ-J(EiXk>b}#KzCbF9vHsB-!=>s7+k}9&s#SJcDvB}dFw^D=l3Rfp%3EvC_6d5iGbUQdC0Io15MJeR(JNKV`dgHAIfXN4KP zPODl~r^$iB?rG~z3^3s|cb#TctAddOh3Yf7!Em08t}qM%dKecG2qsC+U<6Fvi3&q4 zN)O{QDul_p6A+c7)8-D;y(FW@DM01QY^DiD4ipF!5O#A1s={nFgU6s^n;}BVU|`vLSK|>448nNwT7HQv(WVr(`GfRYKqjsMkAvF+49_hsxZ7cvFkLeStU$zw%DH0nt3w1!tnfc53{ra z;%r0w1deMi^u1R-!r(wrZ)UAPa<)*u*t!!H=BRfHY*w?XPLrP|m^o)#Va9}~)vR*& z%z_X&T4EKr_fimIG@Vwns@Bkfy3ido3fy}s)i9K|*r@fJjSb@)l`D>OY?e$NV8T}R zGtF56!jMdrV`J)0+>2CXbULkWl_+wb(0%SQzI#z{AVMuoX}Z;y2MjqdB)KF?3%rRr zD8*uw_b$?@g}=ZiBxo zfqhxEF2GKBPQsnN@xD+X{l-(k-FhTiYT~>`aaosS1WFcBp`0rwvVf zFWMwBLOqOgqXfePjj>cMOPH7Euyuj1^nBfn3B{R2W(9cg4W6++G?HMi`HLbuAV?<7MO&55`JRL3Jo+_}8BHfM{; z*Eh%ISTsB&h`|mls$5i@;U@L{15#D#Q($bMA)Ry515A8x-yCNPvNPz<-wD10jp zoYmT#h}#x8WWR$f1dd_9i&pUr{Y>9&YePUT8q8WGj~)G8a9}Yi&eAIo{SA3Tkom?j zEHFH&+Be4;0u4`!e6bx^k?+0WAY)RSv-S!o?FCav9OD`mjVIicf@2k{*`8#;gJCgp z;(Nhiv9qq<$XfX6COvW7_JF*BaSp4>voeOPV7{2vB&0!0N4+q|fft-{x>?aGtw9#M z!0%{|aSjU%4-)s?=DY&hHWj;2cHan!??p{IoG{!O4$nqMt&wYp@=9op;lL}*U<=lz zSH*!}k<xXM|O<(GLl*GQM^WaFXrZg`q>^(EUX7I)BEdd#}q``4Vf~Ubt>7&tQTMIEsgX7va_&AORFDNX^-}l+l4#;6c zQP0z8itiO<@Yz35Iy79HsNAucLKGDQ0a00;vHwhmg`-ajFRDi3)cl+VFD+qxhQ7Pf z0(=qA3R*VR&|9jZw^T#(+UKBoQw_bP8k$Qm-cL33CIJp!$3VpU;XcLBXioeL#P}ID zA%2PmR@D8+Pl}4;r)Xt`mGN5Nr?4zu>-!Yf#A|(@A_KfmHT0fp=$+1Qyf2!1Pc<}a z%-}g#M2$c7e0!Ep-ct>|ry6=!R^gNOPy9R4z4)2Wmul!eZ#mpk4J{iOpU?JYp^sfe z(I>4!{5{hUdlvfO+4FcVPKP&IoJVV?vxAE^X>l%EM~j#F@w8~2cg0EAXmL`nCIG7E z4Qe)qKEt#%f)Opw#p`JCBAw-+cC&r0X-)MsZia(&)-0+5Lxp}1mrt#o;kua>gi#3co0xD96K^_Vl4M=<28QGh%Q(OlMiFEB$n!QEBq)dRl$g_#=3zD)TnX_3@_d6VVq|r;|(xu5x99BFeWG|g2tyQ z;2f*mBSP7ZWF!9X`04^PTsN>=O{-v}%7MDT%9`&*H%Xh=b(+<*YHT7r0LdR0H#)w$ z=q8VPhKkOqH#VZH{XDD`t#;8A02Lh*sZ2jtr1ZT0vUyp=S20R7QCpM zkKJlo1w(fb=VD+53{U+iX;|#$b=@p|0ac>F6`%}gHa2u_n|k^R z3vKA*M@hntGwlPKR{3eTOC;K)wBvGoF@-~g!%jbnp5Ux?FnN5-8)y<-aY5+Su+tTU%GMP*7Y?Q&#@{)8@H4tMUg!5^ z#o;~m&{SW=-%}60ryg3{S-cY?}4L(3@PbJ9cOXA;*GM92Hte@WD9 zZpHh2zW?XzPk)A&_KDYfPp2IHwIqtMiY~6q#-pU+M}O@Ds#Z>IT|j2aY*ZM|s%~zt zORti(<>3Gbn*(xU4N7ZJovqAnt7@guX+&|@HbWFYO0IuoqL?F@`O@5XvScy#9jL)g z08(IvE8TfT&~yq2Mtn4s7`DttZOxd1x20DFBb^MKTnL*@08(0W3B%A&fmk=b)5J$p z3T*i3M-dc^zO+@fvNg#^KZ5f#d~}6j^_;#nVMT0fNDjjxThJ5rz?D||H^C&RP zA@-f-94Wyt&bc5Zfjj6-oTI%Yg|mbD@35s;1*14e?0P`XI*nUG!VKQ$VfCznAs>A~ zJ3!(Grv z9L!hvPLrQT`pyx>6{g-nM<>+VG!ey7l>nD28b7U6cRXu-&%+8?)oJw8LOYL?#9TM< zs4!Iqe%RWpgh@V{q>AIC3(OJhV>i>RjJ20DM@HYunIAeB+pJCH@38Hz95oTrI$~|g zc~qEzh&Vo=V;s1+CxeRZn2kbwIdX19pZF(-fgBx)mm>idqY(yZt` z-WMIK_%~kb`xHUOYdZg*D5?R@k-B6Az{EXLm&~Z0f6wpBD$R$aIrw*aJ~@l{p427F z-HO-weW^>9LlN)i_oXiRNL{ivwfK8JU+R*N)FmHz0U>k1@m#4(KC(QD7I(a#?alHi zn!tEJ(*cLl0gaYEtaz21T+-6qf8ik~#@jLip6Yi7}rqrPKFw3Y)v~*mwY0G*%3JmX{>|vZC zRcjRPz-zN*Jsw4hdxjjYhlw7YZ3}`SEgh~0rho}|3e0fI{;=XzO@Rz|BC2wCSm zrt!sb$YstK1BT|UZ9#))V8yF~5noI((Y)Tq0K+pPeW%4U%vz(diI{+{F4*rWUp&Bo zyr^Td6s(ZE{evi+xqcZiwAn4%sdCSQ*%99w^2Ip#i#E;q;sIv3pZHjdSMdeuAE0>1 zlrJ7&cu{UYHqHugY{VCbO#{p{+QDCX3w_pt0Th|~DUf_I0!3(Kr+o1M!(w7xYd#=e zWwaA?2ZY5_z8GFjzdU(`L=O|bgq;H7i-VSiuy`8n0EWryoM|H&Va2QBR;VUs^-@=A zW5A)$(Kp9&D~Uq|^A(r0K=wUVFb_DFm=ZmXvja3YBBsSk&WUNj^i~b^Oe)OM4!oDz zz$BQ)I|B^%!3yKN0j``RrYT&Tm)ZbKF*j8x&EhzIu8EkAJHa5voqB2m49nv6W3#ja zNlddfb7C4Wy&a&+rGv5ZRdpJpo}lrZf*IjPzjDU?lRWQifoevRCWdU0$AAL!WpZM` zIU`!=o8t^Y;&2<#k=HpjJ>Z};N5zT8F51JETv7SciI{;?mQFoy$m*#p9Ek{k=E!N_ zlu11}9%LcMS>Dq5gQ;@YbaB|A2r2*5=>Zj?pGzCdcqcE1MH9f%K zFi&lb3kZQM zD~y^1=rrRM7MRhGBA>XJYGS9~+^LxEDP1M}9LXed87um`g~D`qnJXK+2_gpk*$X z21Qra=U}64by4kYV!?3|CbaCvD=d0xGI3pV*5yS>Nh8w|`OrBFj^^|;dZePP5Hp)2 z8XTj88YspsEI6Z<#40g4rIQBtBL&yIDJH%r1=rew;&rxHsT91<_GV?2Bkzf1wY~WFSsCTX3&v zEKs0@^Us(C5!_7z)S_vkQR#7FtFO`KI=uC+YDNy2nC(*&b1izV|M`(8vqL)3V# zYqgRJr~C)G1QTWznBi9Wb1iNq6^=NLf_=lj*ZX86i`>mLTdS3wmTGMPxJuWU(7mhTftbo{Rs54>R2b(EXl%&6!$@IcbKHA@8Ls=r24Xe>!9>Kv z9Gnw{qc#0Zql~1R0&8)rxcBSH0x~AZDoN$RS)+I0Hv)0*;oN}YkGO8Kdls0X=Im+3 zt?aZEg)=YWxc8D&erk<#1_UFI5T+9pzwrnQ3`^woW80x@zZJs?zGxg&NR{Po6-p3fxcchmr{FcP@SDt+bS5k zgHd$YX~NN(-q@V=8bLVUE1M?T9ar38_nd3O2bdvZJFT`=t)V77_z72}1k$$N>l{wi zooj7t((agPP7^-B3=-OtWVzivTX}1yMCR_`r6l^c!3qSKIJM9;HY#r&WGiwN;ek$O zT1oU>>WRm5t!)+Sj^m}U0)}x`!iaUp zU1%_!bLlx;;JR+A*GcK2hmkvoMG886&bp%}F-EzGm{8NCw8jctxo*U|LtPQ%{+xBc zlmyQuwuR1gvW|jp4QpG+wF)THJZIf6CGj#&Xe-QAYv>L}Jweda(;_7hvi6;J)_NNt zF3h?SjNC!aH$%E#3b~KU8MV`#FCZAYgWG2c=>u}IJPWr!ZqinmDHw6?Se{OLj!r8s zM@@{L{G*)$?os2-l+Xr99}X})?`QMU5s)j$ zyMpGPAi0LOmC0Hi9f;LriWMR$1n)VDMNG$D%ykAf!!_(@Q)GTQd=3K?ke7=;B%lpFLQ$jBPC0>gF zmj@89v%TCy<8^*tO32TwD8p(^fiHuCpZR>s9^!SjHxnGZS)QNI@5=*w-ip~c&t*aO(CtPDEXwM&T34=KRY=hpGDEu$FcI$bODmqi znxdrLc_h}*?mR5?wt|N{((oNin22~Fn;^SC53(u@ZByTxm?^$BV%_18K=E#Ztipy5 ziWBD17cf*eMFmw$y0c!*Tc_bbQym*;TWR)4fMfFxpVV;f6=t{+{&oSs zWH`^?lYgH$B&E|vzh_;jmCQ7GT}y^v3K{-1HcKmzQuG@(S5rzGrTqAGY&opNR zIMbRGJ??ihWH?Sun@+PzS9Y4naF7BR8$*VpctQsQBCE89X}Ot&rm>Mk94sATIm1#@ za{6XE#|do7?OAvLykvA+gZ;_kBgu$D&MlfQjaf%1UK1^6rm{59F-4tNyxfzV6 zfWi_LVwtnlwKZdck0!#xBufpkvt_9-g>XIV4VKLJO*@UPNtPPZ0oklM z%Y17Xn&_m6VX3c$qI{ZZ&I)h}h^1bYF2MoNe%%cBA)U;Z`PR^Zl48%W)C0^wQLaU< zVyRW#*09tSW*-7zD{|EokOQSd0&|wS!VCvE&b7u>EOit(h6;TyTEM}W&ZZ5QTAw^L zZ^tIZ;Z$uKad?HnMTf<7t~IVr98T5tw3IexTEBa;P-SOqn3nUc!L){-Ce`+|lr~`c z{bo$NtP8cKI9#gjfPC#hQEK>Rp>aT>cAE1AIMc*ZUt!arsGo}#P*Ja&0%twLLvgjY zX~|McO+9C+E6f(5b3ZoGqke2CT2K)V!%|=CiKKeep9XsY6HXJNH5LY+`)QDZbe)C; zR$4H<-IG6%+Kdr)Wlj~ueFTj~b$`}9? zZO>WiYsnz+;C>GiB#G@bvDCWC*s#>NKcE|%+mH{TKQe>iwx*p%cMKbrnx(+s#^zFQ zFFl*e)m)7z(E{^`hNY&w=M84uq^%}XV^BZY6 zWYFE%!11o@W@!b;8ABu&_ZAvu__dy^sre8J(x)?xQ-Cb>honTW_&P_dSu%#*I7UdSN`E~dilQUk^B!3d^gV!nN7I6}-=}HtcERI~p5ttO7gjm~-g$u(6pHB`kf&u7PdkIj8BW^k z2yv!irHAQP6|FaVjvj_933d`I$*|HDW*e81Go)NfVx^<39a`fSQ}2KbQqvn9RNor0 z(n!MMB*&bUrV#6G_u-z|1u{*OKuaC-estt&(W7T&rQFE6h-co^Fp{H!0CZ zWkcw5O|(;5gFJNYv@oKxnU;G)EYIjP2xsxmEZQlF<>AoSjTyoj46Q(uXkUV3H_=Xk zp>6Lc^fIV=XQfes+C)3$XxhNw+-$j4b(*3bm3zV5n|4}n1qQY8jWLSvG)6l(*BErM ziFQhBwt58awpO&JL|b&RiFOJM!q+m>tfG~jCRRFRz?&)5J>a zT5H2f4=~})^e|zGJWL2=5Q)a|M8it+g333W##^gcC7>JtZnw)FVWQ?YBt!O0^4F)IVjE4NKFvHoS+gj18@+cQfXmr|~{H`#2 z^in@IOJ5)*+6dgynmPH++E{N>fc{<&6DGorjmU3kZepg*CE5c_joof*MXSi~fI$iB zIr&{-cuP&!8mnlf70B`^;G>{6HX%rPz8pZJg2TSpwXn zT47v7z_CfX7{~5We%R2(<=p1e*f?K+otCvkbit!>pbE^On!J5L(MnNsFrTi_H9C#) zY&y43tyx-uCTb2>-Ou(T*>!Cu*xo;kK5v zCSMHWj9Uba2UTFM!RqvLz&Qii9J)|Zvjo~%<3d%Odan9L7kf53i9^O%*WWnCxZqrB zLg!|ct%;MAag^qBlyT7!jdrbxTVFc3i9-p&hLTTUz>ODGaL7V-<74ZMa#km2e8UoT zoN+-R9p0ljOQ6<>G$t2ie5fLdqTaPfaqfUnlIz;gWyXanCwGUs2RC~1ex`{w#+L2G z%`8>)W(J1yTDPXZ{31Rw=*n;p;-~1`TZ)s#iQ)YeCyP~z*GX?G4T{&%JMliZQ~b>D zOL4M-_xL*b{Ur{uEX8$E!f6MAC8vl2?nC|v$I?!t)cMD4pUYntduf?5uvIlEBDiyOzXga>Q z%x*^W{Tf>OQ&KUj8l>Zk%YpHcDY6pQT&kITiIkWlj0+Bv3te-phBa}LG2URV9b;T@ zc`KJe4+T$@y4Y!3{ZO*XA8vXE9}Abc&M#z z!k(gL9&=%IxMr;(OsbhNPPVW%%IkGAZ66}v4@g;gmQ$)s#~T+InuWg8mK=-J%vrj5 zewMSg2L5-Q0*+%*r|~SOVjssFJ8kxjTdW@&@y6KWK!KW|r@##AvKuq-9wt>Xyd=}8 zWC{#5n*G=;eFE{uQe`^cxGK#fq2Ix*rL5wOqkIG;;3ncJFjUd^Fu}puPD{}=95(3Y z4R2iX`@H_Vhgn*I8%vQ;LS$;6mX$|rT|^FC?8=@_d}>sW8q8aCv5-Yu*xIsOe3dU&fvk zmiC?IxB*Q89d6?(0K-gI7?$_#VVo5p44LWRyD-t_ZdygT)cnNV78Yfnk(j>l>dHAW zJ%9v9+Be0q0&EI-X`RuUyJ)B})CFpT)x47rwkwl_S|jeJ8%+T@!iVWwlA*wtTdI_A zsZzeBO8G`+4>W43ly6ydTFh0vpER`cpm?1$bgGoaY{ci1=1rCIO<9>ww^S+LlyAW6 z{JvBv-%_Ql5DedwD&?DKwNJNHDc@41d`p$`Emg|5R4Lz5r7T|&-=pXiKf}((>wLac zDc@41d`p$`O~JvZTdI_AsZzeBN?F?iz9&`6GOU06B+C~+DHXua@F3zf#~we`-h0+8 z(FBgaGl<7eK3}V`ako-ddIm{P(=#yiwDk<`ACR(Y9WmfF>~x*utY+0sKPzR`LdumC zA);ZYnRtKO)|jZO$c%?G4R;on^DuG;F&$9H z!NgTXF*{_b@05mk7`cNyS8K@ct!OXc(A7>``T|LQtN2AgPOLzI89f_rt-dvsDqL`~ z37r-m=nTfKo3)fx zlvT{94!2>&KxuCLv?Bf-jSWRbv$0`ol9fh9OH>;+ep-QH<$%655!}sSXgagtw75d! zrxg(+3tjdwF+V&Ewb^m0sAr`M%pO!{53}?IQk#tq1eI_6v;sq}rH5HY1WA4~_H^WT zf#IRb9%g9;QkxB`2(7^g%_ek_N)C6K->r~UQy>qwQO#`pw4#+9C$!bE3Pyg~NkRKu zq_7nj-fh-(nw7B6Du7vxLd8s`g0-IMG$ z?`tsH?5(Q2>Pe8hEhU;blquj8PPE5(Y6WLdMcqFjWflJ&RX#ocT~tvlq}%tKGX&Wl ziL8c7R)$Fs`f0dQ5gld-@FF1^ zidEiiAyI;ewBtn@#z`w$m~)^wngH{Qm{kz3q(0+k61Azf7P}Yk(;36hSOoE!?hJm$ zeiE-mB#WcL>(pD{Q*SLABHmBpH}%%{)LSbQj=$&krQZ6UdTWJa_wD_0<=EkKskgqT-uj-!pzo=-zNg;$F1i4p&*w|M^<{f5>wh-ZqTOPOK!HxT> z6}09|r*MH+yE!7fOv7u~@y?=JJ*!|8`S1w5Bf^VT>ZvtLgPLVMAp5Z@?XAGDAb8)J zm>Pa;$WX(qV7oKo>8(hzo?7D!D($uyYUv6bLtS8oGP8H9X4Tk;p@yOR?5aT5*6gvc zx=y3BI_or80z(~G53{ral4oB*fnjV+x{+=gH|Ye-oI2i>aL(m9lw7$p zOYUK~Vq`iEbzEVFd%f=Thi5RH(4vlYXx!+g2bl0_`mtGBfuxSHt=TIP_ae+348iXQ)T|kgg#Ob|$9vHj@{*B$Y@9E^ zDInc+grt@_X06A!)@vjs8Qh;T#jL=sm6UX zokOQRs7Ui;BZeAA6Lo6l4E0_VID-{<*y^lmjr=tHj+D!sq2@KU^VTe_fEa3AlmaVY z80rc$1ndu6Rg|qshI&b{IGIX!AMDf;yxe^jXUUsJ`Y<}l>3dgfGe{H zhM#72$G5Q=T=mCV(kgly*IZ%>7Afmr2Fq!cn4HgY21)1}U$B7i9?s4@uXUKoPluasJi#iy zsREBjD=7Nqo zEpHKcDYU+e%E0S2kN(&P!8K-=*I4_lg*%Sh!zVw=P4a|?<6 z(P+FX$9T|1owY_VT1m|G7+!iW+Am%i(k&&cXBAAJ>v4;TquCs)TK@B4^{j%SBIhbH z--K1AjN#}|t@W%bH?4ZMhW_3Q%n?(o?=(lTsx=C$MCO~Ys=y3Kw;oo{DqBkWJ5D59 z`n$GfxcvF?0X?heZ#agS&?c-Z60@hVS%y_9(8kRwASLI*A9A;Ed+Bf&$z!c&75yFC z913liu&R{GJ0i)}Pk|-5k^*hXW=&XCl3;kY3ga9qP5}wDqogrvbepiMC~^?#7nrr4 zRRZlRZp;RZ39AasHRKmvr>*s@S)Bxq0SMzc{mn$t+Y}fMK0nra)}+57F+*!iSXDGE zm@Bn4ODmwN))%STO;}Z6c!^-&X|dbQHUbX2s*~tC8Y9r&i-KjSvhY~zS(9bQ!UQQf zXW1(Z?pUv#wzLAtvfl|~!m27P37@3zwAhShokj~Sfi`ZI2<7x#_OlmZ$w09_)}>if zppD4D3bZQ>3)=OqSz3X{vPbl01loJmmc$0r!L0SHjb#rdn-OTUrq|o@95({1XVus+ zsKNoZAoER7RTBG8FyV#TDUbqfT;gM|bleLJE-?(@NL z*iQkeAz%f-OV0(`)Z@NQ=sg5G{kmED0!^SDRFPxZOKYx!%VG7bVk1Pe2h(cHlkno` zx8{rs#|m17lRUd{j6+xgsiO)N9#+wsI21&vJ&tHEIIw?Zc&wx~aWK!oe6T&HLdj7w zyS#>}n+9YPX0t7ENVS7zf+;X1N-EA?t2;fcrj_#-tjW8(&Ulr;;#K~mTei>$(RkV^(kw`lzNy~vB zB~d+&jn%Yr3Wx(o@u^^q=gwM%87}R3SXHZFf{@OmyM_a=Fna`Wof&Al*7<}^4jk%P zTv0gZzz^|XIW}Wb$Eq;Z8d2al>1ZkN3Nswwe^?c!VCbxcn#^9fIKTvV*LRu=3kV}c z1bPcP@IZW>q^u}=l`1?K(a)9*QOJPf02b!ioVcqX+Yqw1f}&qUNCsaizEqSRUXyc+ zpUIb|KKY?MF5ZubFaDlXQ}4#QVv=rat+h9L%Rj>XRR-PnIu=&!;|F-dwyU1Bjpbe5p@v57AAZw6O7aoe9Lx?7!seAIaBi_}}VHKS;dHW<%kN zW6~ME_$b1a(Yjd?D<@s@#k?iN@Wn?}lnm2uEn;ourm2;kr(Q^QPMt&MGG?8|oku$6 z)XL5SgbH&EMs!`0RRul5AApW|9w1a0>KQw;vo6V+d@*kcF?=zusEjq+xcnh4x)!mf zTpHO|FsyUFxWZ5^)3?SMQH_oGVhX-YL5~VERL*{ot(r{%PUtM?0SgK#`#d~2iazFP z-7KT3ScWe?igxK3QqEt zaT&WU=uu&Yqx_Gxh&5H&xDgpJbH4Z}q9SmMWkOT+U|S=;_`+nUQDq|s@`+@+H+262N@8^#|j5~<;?;s<#|KR6d-{8|qOg?Wu#TZAr4gF?Z!h$nY z5CV>K2sjN|@etmOJJ%2#Mf!C{9`D_L0>^m-!l6^BDsPT4uHu`jiUCe|KX$&UsC69C zfMhl>XXDfRQK$hiv}b7zk}^gK83>IHWn2U+!-jzNES-YnjG1t8oN<+s)GQTnma##r zAQJVr9BEu|cwc&%2hJ_fJdkI&u~>~^jZ3|vGqi<0juo`h162X-*n6x(`zScW!K2G( zD`+K7lW0>38dUXUz7=uIQ056ZOM4)V_JxOaOcjx%;6T+s^qaE>Y7a%)iDSIOqQV)9 z*P%Vm9tel-VWeDeRiR<13(g*+Rp!Cc9;8g0$z(@S7ah(Kj9bBR_CVWqBdHH;+m58J zK(XNzAZHK~NIoJQQgHiorS?&PhJxJ~A!iX1h(vWPB(%tQiKVE}P~-zZ&LjvZd^Yd} zELmcx>Vh-mlrNvHFjF}46LFIN;mGO&GstlO<2(exNM?G8Q?G_KEHHz_5HQXl2qt_s z^csu6PV2rMrFhYBkvU+}9()nG3r;wTUOzN@@H!qO-j7el&sf>$A-$z`V& zTQm{gPc8N%wb+l;Vn0%g{YWjgg8le>eqU;_AF0KDq!#;;TI@$^u^)`7@b9G3z|VZX z)M7tUi~UF~wjAU5Jo(2@*cy@iMg#DRvJ3b{O~x;3Gk(#R;up0VzvwaXi`tD}VnOkH z+Bb8Pig!|%jbGX~r!pJwv~Lzy9UpGroYh+JPWxtYrua-IL~=F;gi<0++Kt!oy)#GY zKa8sfjx)e*IdE@;0ok3pyUx@t{HES8GN&_ZPy%V;!6~-|xGT_5tQIX=Tj0jnhYw>) za34jcc*b-nEm~XPES(b@uwwU3()PgmrmwrC%{Osk5`F`~}kB!(~5_uG$;lA?AXQm$g^iK93r@|ri zHIZ7;c@DHXfSh5-7AaJNtBLx>hQBXBd#zjwptWU4#W#*HfLArKS_KN@*RLaHXJ=hU zUo$1&l&%`d_fc?$G&LIJ41;h!$l+IsY?ToKXKfe6;;RIoQGFi;XedYnptW5{-8XCf zIUc_N?Xem4BV={5Ip?VIi7QYs=ORR$gi%G0`!u<&QdU68<=><9iP3%^1!%ZF0eXtq z$Y*mdfg*U~Iae^ohRrX9vKIDaHj|ta`#`LMAev2LAJino#zyE-fCl*|fSg6p zj1#pV94LV1)c#r2xz8iyOhN*Y+)to6xnF_cjSWNOY(fIbZB&cqZes<)RzCnmXyvVT z3c_K#LAwX&>wTyK4TY33M$Rg5(xo8$a~$h8^nS(JMw;5HXGOPC5FT~gLF>+)#)@+d z&!8+KXB5;P`iz*Yfiw3R2b?h^vie!!NDxkAYUus5$aJ5kHc9N+L=X;DA5pX!?U~d2 zr^5eCC+)Q;@a6MbL7VhGWFJT)%q8Jx(E~rxlO(Zyd#DLVg#+xWhTg9@!)1bKk24AC zH_`iy9gHZv;#{g)1~|?l2#5aS1#TR~=W~DYEK0+nv>b4pK_E_}_o+S)%!xfHa<;un zKY+8e2TAWkEdjai+*>@0W@&gR=4qX-rJ%{WQwnNW_p@kbo^c$ht9c+Nj{BV<-7C&;famggEe54jn=90oN2xe_ zEyx8N=OeH^q}-!;4W#aKAFje&Yn@5JEX@HKchzT|dvIqd#xz{(1eB#QkOK$j;4p;y zS@cX>@WTBTM;_anQ1R_7$~Sl3&Z09KZjC`((hz(}hL+TAw2!|u=2wd^Slw99{8KEr z_$8(5_@%McSzH_MG`2eB>v*SqGbs}O^T6jX?VD4>j!6J#iGNBJJKkw*b?VshP7HYb z^Hj3qm-fu5Wyd@1n^VmWZ>W8^9zMy^+Fp z7^K!4+;QW3l-G@4+B2uR9q+VfR<1NY)1Fz`M!b`05d6}CIAWG%`~%{(p!0AoGRepQ@n#54uR z*<<>(Nx_5l0PFhE<#?%891vPK8b|%6Dl3#s8`b<-bbn9#3+XXyTv9fV9q9~ZvHIFzr7XTEY0uIgG}=8*h8f!Z)MnqLz@z++ z$$YzhTFn*8!A%@hWO-YyPk{Nhv5AeV5bYP=)amOWJqz4^U5G)o+s1hoAVce0#weO7fvOOM8%)al#$|$MEeX z8$0qu7c0}HeM>n#i6Y0hmu&3Qe51I{u2aeBwN4%1UTQuawOk(h&DjIBM-mM%?dUhd zx0j+%FjK?4cJ_dAeHKT79kq4H&ytLNo^Q?`s6FDr!AgPGH#~SLl=O__>;Z9-2WJA# zR3bkM&N&D{E)m~N?X_^Enm8iw;&||a!y77kyJJPV!ja7VyaeBFc<_QVil{GErOSOT z3$ehDw}n{FlJh+VE!CyTbmuCN->&0&XInga6e zaR4ru#2GSEvs4o2$R(3W%#1Y@Fil&Bdzm>e@G34J+zsKNkF2D2bC?+%K+bhnfm%OY+y2-bn z!Fw6Lz2bnBtNmt0x@r#@aGk0&eEY5BN4GJ~wHjUFNaap@ZTR+E$@5{t4DDIk1M%%w z>~N^`GB2H3aZoyTz**XZ4;DJV)qLWRS7v-Yo!9C&@$D#%a&eVwZl%n}5z3K%{jBx5 z$+yD~!Rd{_oY?Db>`e`Ef2fRhYx8F*hZoCwBIEI1@MN_&O{mcixX@1n#$jvxVDO+T$Dq;o$!W=wJ{~BHTENC878{;haGb zjs)%qP*LtWFeme^B>IjBgiCwUAbdd#*<$Uc4^&hcA$HRTvibly1i3fyr+83)CcY_t zY5G9kEvI+dH*1rM&&2fOhZ{f8^nr50_^0;GO&=&PBmUI%fgmvRdt_eYPwktt<}Kc7 z{6NzO%G&aK+A}wOAWu2*!J0ns()58^GV!mPK2Vd6?{H1WpZLu0Ji}U-e8SR#@r8~j zE}BAA_Hr0;aVJTe7AMsrd*D=Do}1GJr;-8(%M7}{z?|Te>Hjn>tu9$OjQE1{gDxpB zCpaZ9{EXwwpm222B@71Qiol%Ul>FH0323WAm#+8@)={lSzRn~a9K^@FzbY? z3TEwD@IWN0ecXq;v!Xqr>m%mt_Ei7)so$(FR_(#@PvD?XCH(NfoZu9{^%-Yr4{#Y{ z;2^Js_5|hxr|37HahCRAM`km|C-RQOoZyta@H38ci_~u$=K=D8aq4(F5AG#T_l&c2 zi#90JklDmJtf+|zw)=H^?j;rUjI*={8!Zk9*Km&mbAsddA6vAR{k9!($u4$c{GXT; zoT3wXZqL#lY+&qxqxJ;mYn&|oKijvhE>`Vf1_G%S>~qAN;CTPQ>SBch&p`bKoWPvm zRDIfL->fcHI4p!1`zde&bAnU!LQmskb+N>`GU7u53F~wV%$GP|yqMCPj?dB_T)_mQ z-*9dgcjyG>Yn+P?gG_Oj_5c<70tbN@-2K3u;CQ=Zb+PIbJx%0q$-EY{MEY8wD2<1i_A7ajMe0!GmAUp%$z+U73f%zJz-gGq1Yurb_>^CsN z(QmQO5p#lL_w6h5{eFC)7>o8$_Y#<|as0Wnt1Vy4`37za!Wx0aO<@xl8)jXbEEa4= zJC~=>ID+(cE-y`Syc46zKQ$I2ixlEdEuwE~5ZpDJA8u+8TtnX8X)HujgCP8Ee`?>{ z)F3#C-u~41jjUJ*9Yn1Dcpixtwre)h^WJ<2%WmX!zdl_rXV_FYL5A5yn86N4fzTuWz=O<2le8yxp{8r;wFe z;vl2|&KBm7m>K!5&D_1)f;l)UO9`9KwzJ- zgy4yVg2GIN-a{HL0tApV2?+$}2rb$oYlhp9=3UnVU1R_4ZJd<`3kbLI1`s+eG!%2A zP*PaukRrkTH}8w++yDEI|2_WuKmO&n-+uYOzWw&^fB*Y8zyAG)@4xx^uitXSf_Xh5W}DUfakfqd=fe?-IFwl?w9lo!gpvYQSGgKr+FMrC93U% ze@ZXu+Ek*lko;46NwP8V4vheRN&ic$i0{NK=P&6cAwp{Jq;qtY5bP~Qb8X7spnhF9 ze*2g2es~^TCe3D^5IYnn2SIhf@j{QDQ7-INmrBjmcWJj??Nj~wZ$CXvIjaWcLxl-O z-597ru>^4i-|L5BZ}txrojGf49G1e&0nr<`(F9EafA*Wl*xLX0_1E9N!0+p=)p!hu zep3KpLba^qwG}I2ahX4K&S+n5)ppgNfBxya-@ZQgR=1A+_D{e4`!8R={U1O4^snFk z@#~*{`*H=f7YP|2qXR7#hwYI<8(S3%R4LKEySl|@AMEAKvJy)Oz2NBJwiwvzom(F6 zvVM-u_*k@}-DCBdO8Z#<^tbPSed;Z%l%#SR1%4x91m^~ZJf84XXGs>-KUFv3pGHAx zv5iTQ@bN%ZPmkj4EJpH1eT=6Tpm2Jh#IKtF{ZD_RHUIVJfBx<7-~II~*8RVJ{kAuv zUi27q1P3x={v+)b6(cu+B}IL17kmUgaU)Cjj$$vxiXVCaQpLuA>SHL(5ACdv}m3508^n!2{cr zqY4TR-GzeV)|=WRs(>dT9aT^=`D5k!t5pQby+y5!aBndgV`A#@P+I}~!tC)hbNa{YJlzjH z-j6^0({I@GYv;L@dIee3I&Y)9Jb$_|#_N@8A9}hrw*UFNzy9f8e)zYq-+uT1{^KwI z`u#uB;R-V3KXq^Po~zZW(LDkGhn@{Z2SPBI(3it6Az|OY-D3QGEhtZEqeBS(aU6_U zjw@^kBxv!-uV$$dO8sMY`|hj9{8P-xaQFMCvHGzM+Zhzwa97c3I1qX-Eb*8dahfCPtHUFDLaJN6kdz*_X^N>2=Qt~VF^Tk z564o%u{8c(0UGaKx-wBa9V2z!2lGP(=!vbjvM{wM6GYG*!TC21UjZU_+Akxk3riq+ zd?B#KmSQqQ1&Ad93XpY`*>#yBB3)`-zTSl$E0bKUGE9a+Iid{#C)m93Ge>)!;Y^Vx zKg~K@GEu%|rihq}az0<*ATSJdy)w@~opg-Pn5{uA@I5vllOie&!a=+NXl)pntpQU& z9@M0W3eb2%4ODW@)M+j-MHGHasJiEyL{SNjS8!f!)kMv1rHHPWbUsB?fND+&g5-|JGhFjN4)?AxNNv=(Vhted*FY$4{6HAo8yg7O_Qus_0De>qcKhs1?vc2)I znn>x|L`pbtmtWXQ)@X6^!}-mc+;~SbiN7#9iFYzMRnNUAf3{v&_G+U3>EFNq`wu?_ zw_2vEcj}p2!6;xIk;0F2*H8V=smgBZr)p;iUOmoVe)#G8zYk9RW>rp6X*DQXK27k> zth)O8Y1on7)AZF2KmIg!8AHH}4(qByw^NP}_v_Dp`|F>+{xbr^uiyOi^|x<-`RmXB z3mMB_zvUeJ_MdEG3*5}gk{)whiZ`O9~|{)X(%|M$Z$goh)7$HjvpAPRpD z5B>5%8J+hJ+C{46K~tyF(ud_?+(smpcZUWI%bfq;Uu~_i*j1IQf0(z8hxB~x6L1@~ z2T*=l2ELo-PhFxIn>iw=LhvY#G$`tNIF8k;VO_A9D=i#y2C?fR@(s+f=hKfUI22d) z-V-GzGn^zRlq7=020(^1C}mkk9-R*F)bJz_NrPC-U?&V|P=Lm}1h-x!^E5&Uq$Cl= zR*p0%1z^WQOemu8ZUbgOA`K9VdeWc(JT>OcJx@KCEt0Ghn`>0%n#YL+h;ri6b?FXb1Jm){Fjj3RlU@w(sD@ztl1UUz*05}? zV#3x$N+1`~*0Hzv8E%_zOzHN4Qf-+Sk5JATJ-O5w)SN?!bzWt+7%mzhL>#g0JF8cK zc*ddc#a>r587>+i_(EIEbYt~uk=vnY5-(v`wMbSE!J4;v1?UnvwbCNDRTrxV$rD;M zr%HEw%#h`$RxOg%<0&RXl~$l5Y+z}T+wZeQvU+gwt&+Y1Z4u}dAZH|ctB3Ry26z zW04@8(r~+?*QS#g&Tps~%hY**_zw#D;9==DN1ct|4YYI~#QnyJMv&Qo`PyTx4MI_z zVTjgtLELW?-j6KjbWdlA^*8n9lQ(2#TDgqG{ff<=bH5b`fz!~UwP8r^7cn`Uhxze< z3dD1OWp=L(gSg+2Lq~en%!L?*c4ilG*U+MlTbk^zB7fr)Wk_$$WS}pSv-@d`tWb-# zd&dqQ2P;DBP0ZP(>v7u9bpdSIkq4EJ}Z5MVDeKEVyq5z!% zkz;GV)=(}G{PWVJB9onV0Zd+iegp{liJ?W#E@&C;(1OJnJ)%VcIsqyLlE(tPn^kJX z{Q)?)A|TZC#P7c!$Tnd4vQLr!Cg`l|`UT6o!g^EZ z6V!P~lxj(2ceQGsP{f=UJBBV>DJjMkO`NfWdPQhh8~f=(tw0ovls zY5{UC19u5ze}EHVB^qQL?^0U$i4n3gF&PG=v;ruq%^@E#p9`fH?~|#cfWZ$D?(>MA zgKGj+;+$^S3lQD#(sOIW0O@A52qGyQCNchSsrvi0kuwRoXp!7h7&&mf#!W3iXT)TE zi>xdy$0%Gz_``9KDyH6SJ1TX5&q2I|!cj|`8fsAhf$&7(662?qi$tHg&g$5*Mf6iu zSA?LGWmGCNjg^154+z;}VxvV2E21#(tm{e%wKJ%wGDglYaJ`~5MNB%F9;Ba*n_6(j zD`mG22-)H=bF5e1d|}+w0>m2qr9o?tA(*BBVo8<&oefdH?H!~0=!I)6zD z^d7GWSpa0b#{xvncL7@41>Bv9!9kT1_``^Qr*okm1|P|9Ti{G~LCz!6c5w(2n3FkI zaKKL05&D3PO}-mX1`%bdrH zv+2sg-bzjf#O^TVVt&B)!IYEssC$NJ$cu3LlV=bvy7tY*$={e*G}=KwRt~ab2(J702^r3 z8UrOhdxq0iy%mL@&%n9Y^+U{$=~(a#dED;wnS})~HxTbl`+@5%BfWh{8j0PX0!66{ zZa+~}FOKtI#AYRASB;I8la0*dV0O>Y`2bEX(rbuVm}xp(A-@FKjY0%aI&pV8W49e29D0#V7`*F6 zL{I1NeEex*GEK)+=W%c>BXn0h4HHlH>S;!)niyY=VXI@ZOUU%zf424&4nM>s!X*H~ z^2LOT8+K+hw`87hpskK!D}IGBBxbjQDW#frK-`7}u{NV(tQ-6uUe?$FvLaxM(U*-h z8~ud66|9P9;LgzXgR`c=b|dSilo(thSk~WdMVid)<)YzvF&qX6w9sw=(+8lVh7Z%}W}>W<=wN$)tFLt#2vu{0*)X}f2Le>fZa zEBYN4o0Sz*5&4`~R#@yHt)de;L<+9%8Pc!&UA1$V;Fz`mGVs`cq=eJ{Gf~3rs`1kq zlfLBAD`WDeG<{X!1Q#Khj@=O*x5qkQ-9m!&Vqu4k)1KHrR$AQX$aJp+)~)DPO6lb! zXJnS==MX&KohqbW6fh?I&;172G-URKW~90nM;Nh(}F7h&`` z*dqrVw;F^aW*WxWNxC(-Rt1 z1H>U}XXhf7?Gzye=LjCJG^lf+o|6J)KDMI2% z4U+SQm@Yu@ache{px{cO23=Gq)F|g)U?K+~>$s`wNKB)~ZnVe{(*b~zKM_Ub;Po3`+Pjuk!6h8=(vZg6qjP%^{Eh-H9_F3eAK{3WMz|Tp z7|l$Gh2Q#ZtS<&%&rCVth?VA*Pfk5i+A|7Vb}Qc!j!0>^{^&PDN*B5B5v)!>v#okd zIMPmFV&AQHq7XJuAx2*+>&cu7N1QYd0XXS|4xP1>?@$wWw^gx(LrNN4Vax+VNmn^+ zcvPj|oJA0h7-^7RkOj>d>7!^z&lvZD)A`^}{U(FZ^bB!6*ytH55DVoMptYxvdIntf z8<)vUGgY|Ps9QnfS#hv{W(8%7#7bj=TRp?!BkK>;*rK!m!8=dS%bigz_aWLR-HjZq0KNUzh+Py(y23?nB z#0-Zb>s+g&a+Jk|z0H=E0Yzc4!5S?C_S+=T5;M%(V;^XH>2$__G5fDMKg>kocc_jPQuMj^lk1rQ@7U;KY`aLHA1= zCBvagf;kb6NCg!fXA*=Xe=+4pQ(axf;XT|1XBj(CQhsn_{`O|aKXFwoWs58yA^B^M*{d_&}_ z>BZsVR%~@fTEG(+bHl^H4?y6a+Bqh1KuGqn{C(sl_jZm+GzZ_I-Hbmq#;V=?syLgU z;ncuqT1q$dPw@`ZJ@E^7{P-m-VEiiyed3q)%`!FdPUBr$c~LpL@vmA+7f15*dnB)k zKecaeDc!xLbmdX-pSN#rDP7)>&F5(;U2Qt?;g-^s)#f{`H(E*;Hx1@vw3Kf0NBHM0 zrK`me|GcGiQ9dI7l~TIzgsK<2u_Ocubm$mj;=zfYCKY^Iu!-F;ACyGyp269`sNeyw zm`e?bRT!ror$Z)*ja$*dJx~7hisBhKF7MA^1!Ym(Bno6inT9B!45r*=ZRtm)?ra*pev^rn0HrhtllrQSnFzrqG zqUY)oI<|aQ=;R^vxW+&uC<%)mhUIn709rw&ZOUyUP2FS;C0tf%OT zVIk+Jp7?^l(TjNNVy(;>W=IiHDKJzB)Y2gH5kd20s#(gGhj6uNrZwoE!3AoehrpU= zmOgGJ!0)dvM9D2n$Lw>u<3j8b*`P*^nGvxuMHZB;3 zOMpd#eGMlZ!uy_%?5ah%fTCA3tU09Z!F&__*Nt^&y`MAlf?<)^1c zN8o|$ju4i^b;3Qo2-G1mn=CRV9op7Co&jNPnzX0H>~^6hzIi#pujmArwwTm7@WP9i zVh|>a%(^*8yG{+$LB*W9esFW2kzi_4XmL!Xk}8+wZro4(Ubgep-@=h5MG{?;Unr6X zO3n+8+d70JO$z3<)uhz+T!tzEhb;po9MY9BaS%nB>_Sym1hLS!=L4D{X;MhO8BNMj zZXXyksK*C1L!l0VdlBx9k)%`{78EM&ae=q`jp0zxZqQ=Q6)8uNJB%4e-Y#i^qS(}_ z4gn7zEUZzaRG{%1io=SAGG`xDKccV5)f!1k1=@#Pt+E`m&4WEBMG9*7V8$6mO2rw= zfw5B4wC98qhZaGMMth7PP9+Zp=%7GJ@uZ>^D8R=eZS7z6Vdl^w( z67&X2hJ+&p&DC_%t)~*6+z6h2nGKNQ7!W9-_YadEkgwabfN6@MFy={d9Fil(HW!Tz zr?OSH0=Jy+$mPbL+O2z9Bk|!@*(x(>@lN~Z#t5q$`C$gi?>h*$9^32?%_0)!u{MOF z6GzcYcbPTHeN>xW_XN&al}(BLglAx{PFHyp!4VSP)fSW9p0!js+QU$a9wIlhhZP*0 zn;LM!Wt-v1q-3!z$a7#)=E6$cXBeZO4%yR;wKAXtdfUYSWOlJ4Y(j;#p+#=3Cy=%= zgg1y}O_IDsugn7UMx|YC_tK?GAnjv3=k4~fqR<&n!Yb7`8zapH?PIvw1hI+P$BIIS zm7MzqStU?5D3z5V8g~0w0eW(1tQ1H|@Xs96W^X`U=UOFc9)vjxZn)3ghztb{`Vmt&qRKa1+<4E0ZsW7R-v5M_>_ z8F^x5o-H4M!e1yr@4Ocw*t67{CmNVU z1`b>?ofYmLA*tM#8xfAs#-_m301gSoju-ynYj@DAO^#N?DV~9y*FA$<#+_dj{+T^* za*9N1wAOIU;9#D7*4>(mtqLit)6N~E0Vt+dnTzXHoQ@IH6>-3IDiJx01`d}a3_xxb zXN%+*@o=eejIbehc8N-hzC~8UlR$Kg;@-?S{x;nV&r<7aEI)xw2amBBBRNLMUtm54 z=8&_}`A3%b)dMrYwtkI0{wo?Gwk8Q?R?Y8;~hD3UM*$gN}zQFDyw zjn5sU3WN;i0Q7nQRgAdkIt6E{8*FS)*)GYs_g(ja zx=XYNpvq{zjSVV5PZPY!ZeC8h>^eqgkyu98&7-qZ{71`Z#BwPuTHA&+LQIo6Bc$3X z33QAec@y!N7Rd<3y$+x=jS(t9%7N(OCh4P`tLt>WZ@K z^4wdLta8y=5f+_car)W45Ee1Ul#&_exdAjk_jVQ_YFG-8qXabR7@UQpin!JUXC)2) z4o1Ca9=IJL3s!Zj=(IYj z>^Vv2p_;L$-v*$;Q58$&EgesyA(s-@CY$4LXI1JCIv}V!mO+b-zeQFO+KG8ZHbiLM zTtH`(AredFTa?G&01?W@`CKUJTuhw-$T|!Xjd5qa;vU7Uv@@A>1!#1E&c!W+6a+GY z#g)()BU8@zEQ#YWhj7N^n3_7y?mYg6NZB5Lt2n$cu*~ilz{LN)~fG zE6>s$iv_E4zEOb=d3WPI79iGnEMv5`3_O$u?Mmp^OgUc=hTSd!;lVIQYmXsM!f7%X z_pty$0y+S#EkoAx<;C>oD4f>`o>q}ZU?baUKf}N+k_F=j?)T zSUDlKamW;n^H}oPbQb$X)Fgs0M@TsG9jX5^#eC0_D;^Szx@=YDmiYiGM}sguif1%~5_2NAQiC7yoS6qE0VG8GPgi z=PAltDaG;Rt=T$pa&%!Q5WvM1J)4e9y|(@ph?=xAf7jj`Pu0Rsh7yCIGa&ZWgbiW+ z{i$z5>!OpqxUC3Q%$(%)2jNcA+;)Uie)EDvHY)ke%WvLFzVjLxpwe+MX=XSVNV1VJ zVTc_r6vRKjAIO>Ih~kkJCs4${`2F_-#d4apNF&6fN^xw-RusL}1n$TjkbL$yaXJb6 zS;TNGVmg^|1!t6JvC7(_Jv?jWt?=-X11fwh?p?{SdhuZLd{sFbX%@|#f5X>bCPVorcZ0IE>omXs5dJfWf z-0$m8-~9cDfBoT?uYdmGyKive`nU1w+yDCOFSu|0KmYvKAHM$d+t)w;BQ9Y7{;%Kt zC9YrZuGnUleL5;A_KVFJ^#FqRKnrjZ5Fyo*`V}Vuk!_Fd^8M_h`11d#C;m_W@b#~F z@}GbF`TKt_Pw!SePFA4*_4FtWjYTqldhYT4)4NrUYdx{DalACT1!*1JQ-uBHsax_y zQJJk{-O01bJuzEbH42SM%+{t!I>pt$?|Zh28+7V;yr}CO3OZgH7d7i&&pR)r=ZWy? z^oZ>g+-PJ`a2Om{;05IGgNcQT$r8QL)|$jt?``&~ONh~tzu|d4G#Sd7>2W?)i*AbI z@ixA*6=1`osE9}R1Yt8~mNIAtFvT>=p>Pu>6Ek}{9fUD2bG9;P(GRqY-7~nI3BpC#3Ebj1>lo)zpkm#LOq8IK= z2=!wPB6Exe)@@ z#t(eC)q7nz->-3Morzn>zN4JT>;A3|-FT`LljY4gG|uZ3=hZdZ+IXyd_!Y_=Vt>am zF&sFU*n(T(9(f^DzX+OC3$}prur9K)>MGRr2yYJ}0C+p_yKvkgJfGJcQm-0#9(?D_ z$nJqX2%Pv|K>j|M_j%svLu}L-i>}R97InqmfL)b)D=MDi_qZ?j_dQILMWNq`**}Au z@M0ZEJI6gl2yS5uCmG$vy8nQXNs9YOKY&IF(AOP*6LFX;>uG#jfuxsd0a14pzw>l6 zcn3p07oexynk}W2K+-F~bOn(zO-tTHd}fQT!@>RY141T>-;t2ytrc^%>#YcdxgYn- zlZzL2(RCe1=Zf1~?2-Bk!~%l_$gRQbI;mZ;^PubIf`waABqN%vEFszSMT;m{h@ZzuzkMJV%8DYW1Xvj|f-4AjiWw1iSb$v*3GCX(3(eubFe8CoSudpoyVh0o z4keDsmrh_;nrQ$ekKqcLP~Vj0phU&tjL?XM)n<4@Q7%9?nyVfb<#yzubxGGB*FylA zcu(FPTkW_@x_7O(2gNfhR$Z(Oiakj(wBoKl^g#)vSlyp62JKQahU)lQ3IW2Z)RM69 zOeX**{;>rqm0^{Pqamtl=&SGObebiDVrhxhdGoe%PqnRls=CN|Us1)g5W`kyS;{S((UuNJxFu8|&y)SESLAQMH15 z4E$CYRSDNF2v(ZU;^8)8T0^xZohR(UTAb z0WNUkjX%!*)k9g*YlWJi;A7M3psU0E!Ez{r8#bXYCzo1@?qH!c=nNL6!c77*hbX3b zLOHvkPdYeUih9}Pv>;lvivSF01_efsVt9T2`f_)E{o&<&|I6*$4|mU>Zyp~${`~Vp z+u`|80xk&qM^s2E0Xw1M!e#-?ema0Fcn$VTz~2-ioJmM@i^DggUOq;0i4pI?rUzq} zSV{?)h;3yU)?&f#V)$MW0w~0GqSKebK9n`H?6|tv)}3G6#R&tho)_(L6=D;W0X@PDr4qH3A@T@4*@v@|^5AC)9VpJp`(x+9Pv@8K8$mN6g(4 z>ibU~u4tZTb-CbPhw@W7!*aB}b15IBQZ6i=QoqrZ6H0aoiGiOiZMc@i0}!|3!F8Pi3O90cD^p^KOo_+7wtcU_6S zF*>G;fT3$$q>N}EmOJNpXbz?-=2MuE=CK|f(h{v>^D$inVicxCVL~Q4eQjtn{ObKN z6A~Cd=m>=_lISS$rsadExkZjAhx0%NX6X=>oeqXs;#YB2qq37*sF!mh3vV=VYbk`- z6XY1nk^#&D-EeSLbH>I*yNMoo7`a)M%^0e)N|YvRHPhdP3WFHK8six_?H4?XQ4VWX zFv*N$2Swl!84ni8`8#!qj2~7`H8!bh&vqz*L&lgUpKu$N#?moW5}g=JGCfB7Yjh-^ zEc#LyOC6oAlJTJgAsHPLP>8j|hcXsWna-xGm1U+!Js%TLFw;vPSEjS(&DS2ZvVxV( z$BZS^oWp@03#ent_nRCGDYo@|Oh6$}2*>hRKxI0>5_j|Qt8$k0Z9eYfTBwti>A;25 z(W%a|(UGx4*k+yr4$@~y+4q(K=fDsopq{WN%Ue|BmzWs21 zdHD7B-+%w%{(J+k>z9Ye^UK}s-7n|lc&)KuI8?xV0F;VO6z)63lU~W7+w%h;r_VRH5DUJ467m@-l09kGDWB^Eu&&b-rB{b2zG+ODI zm(kkg>c^!Y64&ze+rua2;LWw&JC-Oa>1pg93iyWV#tTU?vxa`dx1*wS2c!B4*-Vi0 zWGka}0d^isypvsEQp{w~6?Ws%Pzi3B^bvi#-A3}nJV{cLzzPJ%REk+9L~Ecq=*KJ2 zPI4(j!Ka#EX=XWZmF9mURNa(5BdKO=;)W}E?8iQ)R6y1IPJ|Y(O0yjiT&IdrsAh>y z58tv2VPT6*H$(gp#(kliWkMa6?^t4%eC13zgGZ_KWFJ#@thxZVD|bcJCTU7ISW5mL zyRtK(4W(Wp-ZPR9CzHBlb)bv6N}7KRdT^s&TyU30--|}I$FYet29X>)ZDj|4tGw-lr$*o zP@+k+zn{$cdrXA-l0e52(q)8POJkZ@RmJp}@!nLS+8Iec)uIlb1e}w#ldAjD))NDyB%#K<~$K71Lt^Vo#1yi3~G%uL_EK z8T_J(X(pts>a<6tV6Yh>)&SE@;-RQwnhB{6d?G~sdSU5QiE0B;2c?iiM|&i_Fmxa~ zFB73<$)Jj&KuI&=soJU65JGF>j!-EXZ0Q&QP^wT_#xyV8rt1%6$GKiQD`QIS-%=#6 zTDo-?T0NGKGLsBm#uSVVe8(6Bk!OSeX5sV9ksLgZJ{%KjREh3sk4nj4OK09a7-=9>=#Poej&^$@R7nQu zCSJx=-ie}&X`YZ;BquthV9UO3x*nACJCg9qThjC;pY|6fv8J_ zR`jp5GYWXwtX3DW?Kt6)MIF85BY&!=jAoF%jB!@S9@^Wi#%! zGNzP3hz=DlzC;KRjc(~mTf+9pe0&I4!+}%ikBJcQZXKb@_vTAyPzYr}7G+G23E-?= zo@tMkRR$|#N)m{8k?4r)_^Lo2ugT7dP$?L+bXLZ6y(U(!C}VoeP-;dE6QN2l*wU$_ zD0YYTo`{ZS#8<_Prd+oy8E7O!+d^@A=*5Npm}Z1juWm+_F(FZBWlUM~0u@?Fb2On= z+3E{R9!s>G9V68gg-GDEiaMspgbtqw2Fa)T+EYf;)wa#_kW&!{h+d#nL-A|&7AhLr@WTBaQxDsgG$ zO1YqGPeI`|5RKcSmT4w~yQCviN(GUT6MTbQysDPzF{KIYx;$@_7}y?qbv;<%!9%)t zIR^Q8b=>)cCtFW+UhpIedwM8?PiUs{H`bbwAL7mCZRL}AvlU$AlX!C!_A~>Y?=c4; zKg63OALbbOFvrM;IYwbmci`}^;>`iCHv@og4tV`B;Pq~S^Q#zh)b2Y*?Y?8w?mG%# zulK}iNQ2-LQ=|DI#%$Sed=hUCDB3ZgXs#3UH!dxlJ01I-m!RH3!YGz$&I9upx&^&b$(DMhKZJaco6H)p$8^;pr zM^z9h*{q7E&9$T@f&-!h}^< zQMW{BO+nlq)WGjmGhze`gp`R@xJ`1FTptaKieD8WbDO|+#q5f(TgvO`t0o>xG@$W< zc};`~EHInLLcQVfB=v^rr%AF)l)SO5o6md#1${_Cfdi^Ka+J=P&1% zA8w!SU!EWCl{xl$|Le`e)BX8xKm79c`LU@Odn|E-)Y%~uQD_U>4W9^nv%oY=Za*Lc zjt2T@V(=|c@cKbM4F{^VAKennyQhbm16^ZFk^DXys9{msfl@aay%_f$L?V=ATnhGI zh>F3buyBG~1mJZG^6BdXFetvGs8f7{n#F%b5#!hQ58vN?zJGjpI#0GW%9_m|E}Yz$ z&qjADjn2uexUB}yX;;hdPzd?J8XxVPL$|Q%f&4%h3pK##B6|#gter-E6?a6yg#38n zuL2!(G*Hmx`iKH)oYo&)LoDaR-OPfOhZiV#5nGgO{ZAOM|Ey@KR@CsS-uCvZT3vH zIt4IPP+1F|!cLXb>Dw3{TYTErk8i(!Ip6%#!_%)ff5FlJ$>_+OW;OB}$deMACMtOe zVKX`k#1Mj5L#z`W0GYaV^Aj+;ZmuIqqgY!$e4$aK$CgZkiMsr#&XXZE_oMou7MI0uj>GXY^PbCn~R?cxe zmJd|mc#`U}?Mh0V1d^|}$Z*ycB`I(`_Nwsf_PFFz3Gee633{*rE`W7{hW^%52B>#{ zd;4}_MuxPO{!rj}GNC>V`cwk^bX*;24cif@7t)-Uw5Nm|-*r*OQ(etW%rKT%8 zIusk*=~M#zv_%f%VRlso<2fZdD|!PHohl}0bPUC#Om)#5&4)|#euz4#=cz1gW(#L1 z9#$KNMnR(25Zd;KC<>butY9b}N^TGuM`2DGf=S0?TDeMB@EO7T1|OW^lEz_}Q-b&P zchO1i<610OFJd;&pj|Z#$(<6U3w6`F8ByU}AS4tIi=eS5#aJ#RNY{q)CM{j1A^Xx< z7zVNwZJftpm{TrCP9;APTGkh=8L{<7E1D6X5_Syk;*QX=TyPW*6ccFvlOXaulG+se15old47HV+3LKUpT7V4%4#n!w=cin+};91^W*mTKmYuH{r4XZ ztN;0TKis~4`CDVd8_N$_0P+AvvAJ(`dvBN!-yc&b{wEEy=~;7XdoT9mCc6Lg^V9S9 zZj{Q;@Lz5po<97y+fU~-yei(lhQpOMJ8c9;B$oP96iKGtX8!bz1BpeW? zmGgtvksr7*bX!CT)uSo8e_EL}fUitj*9UPbpST~y)KPs!|A{{Mn@!)+6RiOMN|!P| zM8MMZ8$O9QN5JwF0ZY4a_?`$@x)Q-B@#Y9v`YnmCB0TBW8K3w}PZ5JWS&6TAgZorM z_;5&&BVmPZacq#rfPJ6vsM-8G3o8zQbtm0N!}F<*I$IUs*r4qJt~Q?4Uaq-wp*DX4 z!S@py7smqIW!Ox*3Lb5!o2uX@t_j$(h)2!|Sq%nSW2EMPZs8@wb@SRP_L>`naEZm&P^Bt;HuC_kh)NqkjXE8$d{{bX! z93xz?kOF(h0}ui#Fa)mKKr#e|;ABX7JP8cJ$uI<$(;@`Hh__gd81|fa%P!d6n78Ue z>?a`gVc{@SW{Z2`HtyY=q(Pv0J%s35iX zW?2pnG8+O#{Zj;R0LT^PfA{k*`}1BJ`SHgYja)F7A^S^V*}yf(f{d(By+MumxqMq2W~&qhatx~(;F^%Z~y$udR5G=QEsO~2|d9M;9JgW4R<6Q|Cr|lPe8sk;7`N1Q45W8 zlXBEdiCi^YPc^}!GzVoRNb#x~RIh=%s!;|}>?T`kW%V-lxU$O^&KniWDG1g5UQPi9 z;$%ZRGrZ+x)@9`})U2b*q4{ofGUyeVthC)TOM{`(V?wm6@pV#EX0-Aw{EI9xAZG|F z7G{PqiP<}K_hW(s^tn4H0cCs)x_p~;Xc&6JaoCgncM#)*vQkR1meIfol?%P8VL~g$ zFQ}bU2i7?W&oWvC)ULr0m@^L<30OaFe2!#(6;=t!tzP4449@6a3&YSft58a4_$FXF z!zjeLQ%kfp00;Bjfb0kfV%KgaV+f26#~@AhGKLaXg9FIYXFU3>piKDA%+YrpI3+|* zhu{o3>kr&PT7riyJkBnE!l01mXkS~oGNt2w zN33Z?%TEz4KXrAoP9-u%gW7Oq0o&rB*w}P_P+-Ycjos54ZJ8~AF&vaQqS5u@%g84m%;!59{dkifEV3|hfv3?;+E*kkobZVrti=J}2`2hP=YbKpkF>kv>C zj-g}t5_KX?UvXZ5&S?M^Wg=W>4vT_@c)Jy487gzG8enZLVOs>3Goe1Xd}>iB6Itqn z6kVqLz{w&$e3s+k!%uD%#zfPMoa1MYu&ta$m(}FFz^i3C*yWB+bvgKi46lYV(Wo3g zjxKkEy2?PO7JD*UIm4@gT!~l9gw%gItz3Eb+UPRU1Ii+UnNW}0KdGF~@Q@oJrTMMk z$bsfP4lldy6^@(zCg3E~x>e+R4Ds#x_ zSZvu?p@=OfIx9L`TB%T?b!_20xUBG7QSaET?oj`F%t;iWnq>t|$Vx=e^Hi3I$aFT; za?*sBg@Ol{ape(rS8#%EZJ!WISha-UY{Jbn)@4*F++r$(PE(heiK)1|F6C$M^U8sc zhvlJ17*ZG>vVbz$#Y^{m6goRap)jr*6xHdo$27vUAbrT<0mYl3aoj<>xE8u*HQ6cM_B!&g(}28VD2{sKSs< zT&y6J)gKTFxq!*p!S-2l!7auYRuBGN9Y2ZRus9YnWZW<4g97d&ABqxkV|1wdE8`h< zz!=S%>7XHHN2fY`M#s>sx`!)!BY7=42qV_5Iea7aTm}c-lE}m%(fL#Ep2=7^O5RqQ zD7-p42zC*BT{f#yDo==XCZWc0w{Z)^NJ9C(;%;0!dkOLtS9Wg_Dw1HOX z2>H=2_Q)&_)Z z;7D|~8MX#Gi((@VS#hfZ%bMt{X;7s3G%}&rYl$7ZfB5w9cKi7G7Md;l)ZI6g zk|FoXlg>=EjW~$b7eXh%de4Np@fr@|5(>qG=44+tDtOD01qoQ&&$oBy|MC1ECMtIg zy&(p4gEHm-sz78wIb=Rq&+^o`4MNdq+$GWmiBYKcA~ciI%n&D^zSiuVoPdh(Ot(+v zk%gn4sb3mDSb^1fhJ?xlR7}v1EG!5Iq~U}1hYBtCTbeC5NFQWM@GG59eh4+#0cnt* zRL1#Zub_bsVVgKa4Nv0DUO@v-;>`|P!;^Tkqt`Ilc(Z|&K*BLz_z*92tP7sR2o39U zQOirn4+RD^Jx1IBc4P#6&$xci8}39%7yULDjY6H=N~74~jKH<5Fdro@^w?pTZ(BxQ zK&X-)7WzU@5=5EgS`^K}geoLF=rqz}qKlzPBCkUli@HK^V=!)JUGmi~#S$T+Bk<;mnm5>M2*ep>w7cye+V3LP%Rgh9Ctx0B95s z7H)wInSNx^XoHLlGyrI%a=0cM(Iu{GROejw#U#OJXTfc;5<=PCrWkG%6G5NeAoTEsgE ztigYIx6AV~zxO4^7G*#yDS$%7I4G$44MHf{gU{PxNPnAcKZMP@8C7C{*Aj{pLZU%{ z!m_|;Xv-sRPPSiHhZ-{?-+-IRX5k8)$O) zOxSMR2RBL^9opgBdvr-kEmd zf+;IDv62#$YD@Hhi;$Z9jH(xRWI7!=7J@yx=pW|U;1-8)Fz(?`t z#R1Bxw;)uVR2sfOETdo%7m)Q%HUL{5=NV@~>PJl|ZfIPyW~FmO<0RP?)$D9@&0cSD zu^7$m+w;rwZ|9fC=i7Urk0*v#K+a})#)31b9gMTW;0#hqsF?N>r{!gMwZ`&l0c+O{ z8TQf5RYNW>PV5i(PKDD5p1=*w;m-}(;9%{LtBaBi+#xZ5uLVQnibQ*Nr~#AGEg?l^ zfjPH<`SJx+S9-#wkC!93!o)W&y@>WRa6)Fr1zYDd;`NV#X9Kr+%@}-$``1gw;E5RV z!fk<0o8<|4Q9KX=t)VOx<|xKk29BmxvIRREi4mh?fe<*<$_71|PS=4M^K zmcGTnI`NH#pR1K39mE2JnqxY#8k~?KAuDMxRV2ii(^qa!9lc$-z|GCh$W~6sE7<$I zTZ=$QqJuu99i7S~_6ZsC3RgC~`9&Zk5$d|{u7A7+g{MFWTYHradK~5HD+j^U&8Rx# zJ|hc+z~2Ppg+vEO&(2S55rG3~i>k}m2s!c!iWx#XMIa;-q6U-*Rcf;nVo*ZRV2Hy4 zdX)(6`r}%|@NjhCi&pMFbE4`x=_bJ{#dJq3#_uRbQTSPkgKC11`75)+U15H z>mN%Tp6?L@6EH2cME>Ki_}&^!(xO`MxPwfVWjQ^#<9T zmd1`fQx+P*W3$K`16{Q{=LZlwXE?0)VIpg#@CLNn4oH@L>>YX*E0vL}XnS4VrAgai z_mv9vVeI5|dTnP_qR5PnlpSivxOWO=C(-GZot1z~BT-{?OxF?oveI=DogO2xDludx zX&m)|d!X!O??^yjxIRj`YC&Wp?ah=OB%{=*k5p!^YdQu_@G~>3z4?r!?5q*8u2CN* zHHI^)tXd}|WoHfEhSRiAb`qg2eHM)lf>#x1$OyTzBTb}Ib`qfuIFF^PE>ba_!_1Yf zU+FrD4p8ZNLM1}Y=t$LZ408ecC;@6Hwp=Wn(UGRZ9KTxANp!kGTyXC;x9EVkUDJX6 zT%$hh5(<{<5O-LQVnWUdAOUSu9@a|JNrVtT>UOBouWjW_(Sc_OAt%xt=pTvBma)o~ zwM%rH(UG3BLQEPeVxi|GI_u6UEe;$yrA5aj%T8}L#P`Ip4Bd6rRg}U5mjFLOh`L^CDhbp`(;4(ZY9yby zUTU|ZzH+^EB^0xsaEtZ9_0pA>&B3N{8vH6y3MLrzB;M?OKJc4(bD$KAdGzCWvw;&X zT3d;hLwEz2a@f^aAl%plTnt^^bwptmXgMsKp&^c%bHGLk$2&{~iMO8m(p|w%@;nXo<&Mz0gO?y>c=2YmJ_7EAq>?_n ziy*{(3X`m>g^5h`<-6V#W=49wdBHV=HvJVWVA#k4Fv%;#GD6A}@ni2`H=}juhFq0E zHYa4>L4?XdXb6)AAqkYY9DB8|MYavpBIoZd~LC|R>9kSf=7L~X&-y*5ZfQM4W z96AR(La6575n2`uR`!>!0azPDof(9Z1j>cf;PJb{2ymrY0E?m0+z~?9wVP381lZEK z)@(BxYRw?j3I-Go>j+hMy%Ty@n+ZZ2d5Te;PAZlkqsg^b0?+Iinc9r|1#{4 zD|R#TyMEpYp<`rfGdyOvV8?26M+jK)j!>mA_>7>}(o?LOZ9}j$2&Hq>-x9(c4X-1c z5o_?`I-*WEF8m8ZiM_k@HH4rRC6H?HLOVD3L%|F!p&nKYb-yB{G6B)Pn|X5M!oQeN z%ia^NtFdTC2(S)Vg(wsV_Qvfu(oGT}NrG0U3hXl6BN4K~zbq*PtB^zox=AYF2gpt4 zy1=5%v$qj4{SlI!K=|=3VW9Fjur!R)jFu&Xx9=8=LOsJrGiup;qHPIgHC#Hew>oLV z*kOr;R**G4(zyn_s-Dhq2r?*VMl0L zGI;-P+)4&?8=a$Esi=1sl|VNsLEgR_)udTLddv%njmB z6Hyn{&gKP!j*&WPg9MYiMRagpQ`rar{kkn$77Xg7jq^$`|G0fOc%fywK3pze?}Fy- z?Yjkf9JlZ82myND&1hLLsFOB)yM&#L+jn<_-~s9gEvpRp8!j3Oz_AbMm>CRq?819Z z^j+e*QZR@aP}70;9)vdt75ZaJ^xZK$+!88bcHT)@`r{fG5qwvL{+KY>C<@aNDg}eh zh#pWVbnNGVK4HTPHs^fw>@65seH~f*ZkA64p`qJ#XCT)QbzPTOl+jw24AH-vk^OQ1 zZV+lOSQN19mTuXYu>RdEL4(HqyFn;ju#=@LC4=n|JSJps<~5D`cXxzff_5`1y$nW( zsvOeG8QUKB?*^e(1Oc?(5h^8v5t9ChC^Gk`&>s^{Y}WxARmo&1>vSDakyC{{%%{*E z6Pd0gCU~xt3sQkhc~lZmp*tortKOdU=!j6ubki9v3x=JHI2Kbz zdKHOYLulLOpu=J+1cSJn$!J(P{}8YEnU)py3idkILk9q6K3A8tQ0t8hTNKH z-=P$g#*AVLQ!w6q36EfuyRw;rgBswD0F5RY=49l2NYkEV+0glmFcXXtYubd!M ztpqADqb7kiQXa|O-f3qrp%hT-WjBn(#g$`LF^&QK7N+xJtpADR(bx3>&GBBLakt-BN^Xx@u^L?LH{P#t5eKDw_WX4K#0EpT+Ac-w)6XPSiIutEWj zvHF+^_0d&9&K88XI+daO7NIdBI@qJ+H($}k&~hDbjU_@-AFXTfxIJ3k5e2u?vShFr z0Bs5O#2DWa$#34Z2?3!>GDs;|oB9a1IYS%cOClGJ=v*1-?NF?o(b1u$nhH8&?a{qY z&T|_&x6%$R%LT@Xp%3d6$#F7Zh2%Bgbgo|&=wD!kmFf~BSPB(LL`Q^L#Ty1yH=|{R zfoat^MS$KivN2|bUTU z+G8TLW^PM6qY`?mHG@N!bP)JPL)SuiOmyJJ@94N#fTP)~uj7LhXgD_`(-Gy2Fl~A; zBhwM;emvnG>nmO3_)TOwnwx}QSym=L#GAePI-bOvz4|(y#GAePI-dBO&5*+j0pByC z(9z?AzZrFm;)%c66mk8Pzu6R7J&8953SMzdPRBGUeTX+ltv=Hf^c7F6KE#`K6Y5F4 zIcoKpq~}+X#QG3#j#_;tYV=jSIcoL6H|De=3}C#-A6u=ycW?5#1o=X3u@Xjy?_hUW zLG(f8o=wW)nCO}%#Fs_RS^tbBg0`wd4nWhOL{JBU?9rC0T{o0h)L?jvu!hJ+Wn7U3 zGEK0s+8f6t>9@U7s}Ko1l|NxkV{ammVxzdE>!NfaHe}@11eh3V0c=7XQPzusw~**Ioj*Q4e|r7lueZP5{(v6oH~i<#ujj|d-=BZEeR#RK zeYyJut-o&|sP;EMu5M7@^~=K}+JQemeR%%4FXXeXF}FHExIfUUmUZMbo7pKy1YQ!S zp-|Zr$i*R-BGf0ZqC{3i_-qsnUn{IP;sX}B1CzSC9A_Sq?fx&ewf{BQjqu zOFhxCw?c31WkS-G2|#@jfJi9ZZ)MNo<#9(%F)sF27s*5vV(TZ7%S6Ktjg}q4j8+sj?>PWC7C!iR> z>miH){-FsltTS6DC1b&(W!Ao>as$+6{_(L6oK zX5C^w`@<*U{`yrNsBiAiznvdh;Oypqdw%})_2%`Lho9e275kaLy7_YZ>AbRx(3kU< zN7TtaKYjiD+TK#qH%7vAi?kY?N>dV`!9#(WQxbSj8OWhIp)JVsfAJKmb105vq0b+` zgHcK!5;UHkBQ=5kmTEzr{REhr%N73i{PK7&Md1BkH-G*1{f~$5VG|tuBiEco^Un8^ z3sz?EX!TKuhbykJv+KO?#O&Z@Q?#q!oYH^M;4!JUhcB-jI;Vuslv}^NeNMVfS=x|o zJOOytxOV_@V-CYbmle^DyHO?oSB$$lzhad&wMH1nx{f%7+2xk0(+s57FS5GbW}fRms`LF!RQFdqj$#E%Vl zbh&&>U}Y;HwZNr-6p43}1B}voAIfTnEZU7aRB}b}GGa@ZnNzQOXdy`pMNA5bZ`YmN zDJ&EZv$b%i)Nv7kvPN5MoGEuMAg=(BkG;8d&Y6-6LaUpov}^#5ymo_EfhKg8afB@A zob{<->!^&&5HS zL&4JQrON084LVjhpfrIF+e<;$;ZlK^K8au*5IgWdxbBR2JL~FvF+2hdPqxnnv&I1% z8b9!aN=yy6y15Z2oWDV)39czc&$ifWd@iDADF{7@4Qowsk~!-ToaU8m_PV*|CWC?3 zhi0B!8Psm^dFaa6!gWP98qV4;JPt;e)@2MO7!8tu)lpR{Ue%_HD*FpwxEhP5CWA%@ z9!>EzSZ}~?^;}CV8a%_e6L3Ak9FyCHbDJfzkVv9_Izti4fCQX5B(uR?0P!&xLikvaDHDAVDmF4;kZ_A5U4$$J@f>b(o3oxs(QKHgI#uu}jlq%scYTN(IZWci@m3qK0~ahy^bn=w>}NjeAoOc)3p_q;n&Mq#vD=iuFXT3Yffx#6ONbq>V|WQCu5cPJ z=AXSNc97W@?)kSGYvXvF$Si3n3?{Kz4zEg%x?g3C)CSi0GdBU?;>Jos{RuzP)yNMr z%HFpcuJp^arelCtfQ>!rSVcwE9vxGX&(SYOqrEO z#)`2thdb)w{e)MX1+2rSUiG^ppp zq9)BhBs^NQ(cId@Y4AnC!j-QA1RMGhJ+XK%12v(_#pfH!cb)qxgDetqKVw99hh0Mpg*>Dfdazd zy7Fvl3p?Z!i787#QX~+j-gG&x68(YN;RqBSYSy4S0&FHoYl+jh-aCY!k95qMQ=>W? z$Dl20#!%e~h}wX2SqF*v`D)HGbc`e1t?9X3>}_KhL&km_gP5WjL&cet%`7X*^Mpde zP+N8dY^L;zz}tKoL&uLL{)DO3?EgbQBpfpc0{+2n^P4DqhE?cL44V?gz?5M?Bb5S$ z5EVHCMau_gA_KL1-B%qH$oL#X$B|`mF*NZ4H`t+Ie=+n*8=i{oA=OgoI|&0MYdbM3 z{q68k(czlIH!*Y@Et09YTV&V(4uTpEJ@!nQk$HB=y*8vXci*rW5W-?QZ21Gmk+X$s z$eJ;uz1!~0p))!~b!9OK3xp&D2xTR5Cpv%W)Oct3E8dTap?e|BBcm2)0AEtPN0=Q6 zW_)rv(q+Lg+f?O^qcS24&yi8Pv>E|k04G~`zZpQ~l`<{ByZ*s5gA0aoc6On*I|Fg~ zjsVt@T*tuu6k9JA+sl5(u0VSq8rF+s{I1|sb!f5rmYLklxjIzr(*xHJM?q&4WY~;J zWq!DQa`;UodB6)e6y5X92%2-yt17Kc+v+7{O{_)~u#PoKl+MWl>Lr$f-RLDPR-hV- zRlj|=uiK#oEMQhjF`kA6wd?{pwPxKB9GhVZ+OfR{O5iH=vt)4Q%UafW0NezSBeYUr z9IHzLZK_!gMlV>=a1QQa^P9i}%+8YiwI~@Gz@jb&qS%x9o>Gg1Dt!k9e))1)V#v$K zZ6~6CY(~{VVAU!1XWnpL@E5|y#{vC=Gb-;FRdS=#fGIn=zghhDkIkq#SQAghR{cv@ z;}Hu8EDG*3kejcs3(?ma?|r77+K9VyAO@tAk2(b?qZPcWbI-5hCa^jM7w)Yf2cK^r z9=|uM5QgH%*L$@`p*8&dujiL1+QOTgACEVy)yCsQ_hK@jYI98er4)eba3%djP#NvwvqGMbjk?$+G>)2BJyj)X|#m0ccMf;lVG>s zX+@ZKJEf&%A!_mwn^9zV^eIr1N`djDP8CQtaSF_auXsOgeXZ_8FNGk z%iS7NJ(Li*-(p5uI1Clka5=Gz(s1Dx$h0_wiPRzDnT*4Q+e(Sr68Jm2a62#N5=vB8 z0(es*5}5l6dk4`&*nw6)9CyWlQ0@0eTi&IG+aP;}i44R>ist-;mgrRK=T=cTVxKS} z7;{7_{^1ENs-Hy5U_x*nz&0SwKQ^K2?q&yBc+#*p+#$ND={_0|^4d1e3VoInGBlTV z2+|aE;FLfyKa!lE&k~tRCRkT+%L%fs;NzU2C7BS&g;`P0Y&yhYWa=`X6OoQN{npj; zoDX&AEm? zKt7u54vGkpiw@j!G1SOD&_ ze5gwRgG{;|3f9sZ7RU#;`23_{(8^{R-9Ld~n3dP)S;G}2{#0-#MAGLF%%+ttP1-Ly zPMViEMX)8HH9K7$0buuV14@wbsL|>h1u3@MBwwaG?dB!NqSa}JQ1QE%jWxZ2?gBJ| zB5ugU?kfi zEUIEkhJyaW8)aP54i0cR4txmM;B@>|gvUhPR%nQJ2+o+Zr%^E>Z{-6aM=$QM%C1*1 zj8jh*ORG?ExzRz)hgC@T;IN{VPe+FVmX=OgfW`8ut(A{=*dfu`ZQW%;edP#%MGE$D zLh5}`;QUqB}*$3YEU*^HCvoXN7SipFAIdW7EP_$JhvY zBOf?{%0@njgEl)fUAXeLqV8#(FX5uBnta3JN{qlTN19J56KGHY#tLGVi#>;9Fnj8l zfVb1xxJaOoCPm!OTT^53A%HS=&iIufX86IaCwNBuuL2eUvofCOlI4%}=F3$VV2W9J zC&x}$PX_88X*t_EO>Gap>bSFYrT(7!} zP)dYLH|`7KwLOARSEUOsgJS8L%g8!>6>a4*9SGuXLRZ|b))oX)!8JaYS$4oDaf&+tz0G~vn~<3;(ld^H&~2ZIuV`M7_3-h zXh0|i+s&xDUw!G+R*vyg%!ovxNH>WNmd^0AeqQ0&%X?G;UwlT^7X+dX zdo=C~0>!+U(Y~we2^ZVqjI6I5^I)(?1gpMLd%jN`pPkrq3A0oRpXr*;G^mYElURPD+jm?l!$R(5HE7%GXgTABeX0T)Zz_G z$6Nyu9dMnYSDlb*Mx~`&mJIaFfW3*es`|MoXtf2~B)Uc3#!t%{(lMlMe~C5@=#hlvpAo z+(cz(6D-)7NpLn5?3$}7{WdL!*35|Uji2St^V$NKmvn&>nnggCAb{TQ?LVL`F zc*`Y1l~}M-WKHF81#smG?J*G&JiR5<;+H0JK`UoX<-CPEq0s~RW6)TaKd|2Ogch(& zJVf494!(B8)yGZc<~i@@QDwm{D(4me?lWBIww!D$-3QiRr*R*& zNT#{5oH3X$FVBBH-@UPtTIp4*sSn zuV}VE{Z>(4QT9HqqIx{2S!o1@DT65RYN1J>ft4Lr*a@#a7;BK{mdmQ3bv;?03x+(wrr zps@YNh7H7z1I`AVM|>4ywv223MkBnq&{}xb72H4s^388B*>28HA3lD4c)Wjj`qZNy zkrD^`Bd-v0i{J|K+ziIxhN#D_65%oK$)hNQPM#ronq{u8aK#%5 zc;B9g{k>r7>{}d`uD)ml2f6A)r#|>qHVILI+j|0EwHEoNz}MeglKx9&c8rqKw8XSz&kIg>fDW}cj9hT<0}YBE|^Do1&IK+ z=$yG{SiVeWL-cdAL&$x<(CHQa&(HT?A8$9xacb;7pkFV4Gtp}i34*3+&S4lw;L};> zFzh~~-PnDAHWx3Z7Y;8&eOzNTZ~FeE?E*SBD-Br+AHH)DV(B3) z@0d`XaSEvHWk&t-($YUao$gI2=R%mzkZ#e9qe}4Ox2VI?38#GG< zu(BaCyEy*dTG606#+G{mp$1FLGdprAhtz6p*7}dZwWW@3Cyy zz{_i|8f1GHmLN9(IOrnRprHR!LmQ4tN2Iw8<&%*!#OBR&Bw~$7E)i+A=k!a!2~H<{ z#lx0!9DCluy>SXJD>RW`rs+BpBfFq>hNQBa6BX$iK$>weGPGD?XsqcbLMlqqaks7Gj|ADk;3Yz+#!h& z`g3+ODg}ehNbV4p_N(0?nGo;PmKkb5nh}yagn?Lgbs7tXL}=9|*B~9cVg@5b&xGQ> zaC{dKJIf1puA7Lu8jxm$hO;w+Aa<s|5Idx{V2=uaNJ@a}Ye-qC@u8^G(iy~#1?pMjrC*2Nx}Jo!kN7I;N3U5W7SOYHv3q8i&KBGjyVS5Qg#{`yh5+ zN7QTkYVhAm7z&i z*g%O;-=Psb_6n}!a-r0Q6jfH}GDq80Gnx`Abq1Rebw(_m>WCCkyEG#;KTUhIEEyck zhm;xwfD1)66Y5I6?Bp4)&yk_|SdJNls2vZ^QHnJ8(KJ=SUyuxj=CjP@3eA@Y^{{-! z1%gm-ZqYmWe0Tf#apL|h0cLDa4h)uVu?=8S_&j%u(fTuEy|J@eL|H$a`{!>@kI%R0 zF@+)BJ-q#{Va3zrUMy>2F=-S~B*89N>IK&69PEPQGvm7*pC3}VFrvq+*<&;aWiROi zg_Ax|c<2NFP9J#q^g$*j|BB43C%XOk#C?W4L*L;^fRIcf;*SG_gnH-x=K(_U-XHu; zyxBs;d=hUqM-83?2x(^_JwAys2MEao28mjvhack20YWl{s)nag35?Sh>PDPIOj0 zk}aJQb>`;2V+E8KMxrBe-D)Ef^Fdb3!WNlz3=0J)3lhDCP@m6&O42y(H6gc-l^0f7 z$0;3JSz>AFN^L|;=U@TL3o9_hIU%~s3lr3LX-16O!*Qp)umVGz2r1n=&8XByY({1s zJvC5-Mm_`^=d#R4;!b!=Hwg>{?>bx@dHSq99F zR$0fEMO9hHiBJy~u=>#pGm>6`7EWM^$~sOduqaZNB|{0#ob?jYS{FV?5 zs$~Z0ll6?uI`-tIv2|?SVFG`p_-rDyEExf2D6TNV9NwF z>nsy9Qc<@wqsmV4Ju>T9Sp32|&VO(isPSO*YBaU_PfuT^JQH^C?e^t-^L+Pqi(cq$ETshWNu}|WFCZfh z^X4d3XuF{s6A4d=}dp=L+%zn!_n_*JOc z=DXsPP+83-!zc0PXhXOQoa@f4K>Q{O*5R&mH9O!0yMPneu5zedSGiq@AY?BF`1jax z8wM#Wnf$b3zrem~lPDn8+bndLR?o3F{<&=WW3}6x z^2Cg~TQaZt)S8O0u%*wQlbi6f4((822saZ@>!{lY-fc2^BG^Oi02ot=zJHy0e zYu%a9stbPYOW>dckSpDo5H!cJ(%sP^Kp{+~8=7 zOzE}~Amfl!CZroV&1hLJNdJu)%{lWd_LT{#NlPNMEEfWzD^qVAlJZVazI3{`6QRn# z;F_aDbcO9Klnx=?oTYl{qS<+fp%|keaKe87&J2SGskMijb5yf^tH8Iv^9FE6fOmq*h=9 zMDq%zJ7@Y6L7WIxl0g#4t3DtLjSWJEZaOqjZ13@|c#7&P51G#BC?K^$;v42O4oG?9 zBVV|Q09tMl=L_&UN2|8(z0X-nKB& z3L)__OteYqYI|njwwzF+4DGaf(Fd>sAi86ZZ6>s0+J7QM3#it#JWOOQA`0CxrI7(* z+Yze7f_TnrKEO7{7L7f&-ZCh7uB)7~7aVY5LQ)-JGeQ|IiaumQ`wlm?FVTy>Mdq=U zSS^Y^Y;rPGS2Aqh;u#0mxEFmu^BB7Q8Q120BOh7!&( z5n9$4yy^pjplC8Z_SoVOG=gp-fJ#86?U7Y|AW|EI3f(agQpJ`uqe?J{yV;C~$W7kj zMbQUuDdgO}?T}!C&MX{Pg3Uk(J?9w~A72qEM@dZt+6i3&s8mc=3FpYtE_BC4sE2g# z%L;$KMRM3$rRUi|u6We%3_3<= zip?#O0wkIP0hF+)yRM1DJ^+>QAVyM-_c??UF3QovHl}RhlkohR6OB)(ap)^W_5QRr z10PS!0M`fJc={lx3cqrn;$Ep^`pVx7dp~~cZ{A0-T{98*<4Dag6e|#0iU+o&@pX-{_2Vaf7q1O3Tyg7gj`>3X3a*BUtDm*{L zYD6^^)nnEAL^YLt02%gHoao&Lxo-<4&UvHnZ$F-I|2d_$-OLGiH|^R)r_DL0b4YlgOq_13Xc+!*-?iCn(v_UzZEqON0~C~ zS}`po%V?@d-a%~_D4}aM3S~cVker|D5*gPFxY%)C3`BF8bBTFG42+Gii6%!m5&HVa zeJ*lEl*zJ7{Tof0$t^#Ahdd0cFoLujWKPacxz1M=VwvX*Qx0&@-Zal<$`x;G%5bl& zze61X3}o1DdTAhj6LTOPqf4C|EroU;`8_Cs1*Dht*%|D9U1)qSn3FF>$LLavMkCN& z=Lu`je$fQFFpg7}0u-ctr>eNqh>j^(mh9tUh{8BdP$Z-I~kE9NGt0xOA- zDh;%RO6;Jm9L>}yn&~{Q0tvb= z<0@%JeJuqQAYLLwI~A~1fq#m?N`~|^kdkIpU4WidWN;=hc3JxbJ};^xZcA>u%um@Z z;~62KjNq~et<^%Yir_2|@+)vQvgGD`G3Z`J1Sg@z!8#qCW#iZ*IJo+uiWgRR0`Z~|c}HkjFgR=qJdRQa zg%zF%p%`UHXxVG#uqn$ME?`p$i`sVp+Ft?IbJ!F}9LfkzLT<|JO59Bobi@lLygh;g z5e`B${YTv0N+6{eB|@cO5TG(5IIP4~MQ{>wb8;PB1J<($4r04yQW0VYjZEDW1>ep{ zhYU+cjWe|UsIIxUTm{&|fpFiO$BIwFIyR3FpYWj2f(~Sp-9UO0Z&ry@J<&4b$AN6x zo5H~-@#a7_?E~4g4`h?@;-VGErhOorprrXQ4B2#1;Du`%F$sjk$~vOKNK_-pVPDss zstLW{Qm9tft*EOkSW$ygHAARm2@0{0Wu(Qk>;$YDRBaq+@m@*ArLe4)w5ydYk+HB9 zo_z&03hI53=InXcF41vO!nwxwoA7BSU8x7H*|1b2V3RS(WQH{7Wg%c@!)mEUKu3r! zhD2yt2q+;zIY2cYE6r#ks7o-N>!fBkSaL#PH>AQ)IxOvs0!%ln@7NYmgNLJ;)h#MG zR-z+}W1_>OJvxFuAu}65t~MJoA^PDGp?^EGArVq_;Y6r9(aCJEA=$%c3 zO2Gg%)Dx!>6WV~#Sh2#@&Rq!mWV&=N7$^gT; z5T-_uPr~mW9{s&}^xx&ILjS|V)yi3Ds3q*xdz^-b-(eRH%XmE(vrDkoOb6Ae)3zP1 z!0VZqb$LF9y>^5;L;)OC%Tme2ED|Gt-5iTq074r6=uMVGiPv*sAvuepQY18X&sZ1O zV8kh*Wnm#tiGr^1F^t_a*6TG0sdiy=v<_DQ_LTS)>2qV)tG8+lg=WHZ%fiB8uK@Cv z?iud@8Qe`hHqEFM7M3zaktftyDQCU0q!Utk{6uJ3i*Vd4JlsHUj^%77q^3J!EF@1daci^H%B@(C7BlT1js zl{BMe!Qi-8gQJq@tQw6R=5|KvKadD5YY}o_L`S-@(`0L*QfE38z3KL7Suh0dRdCd? z*Tg!KhG5ut!23hg=bL3Z+oQm}s?6TlYvQdxeMS=rR3i4Akl|hpjym?5c&`m7)L-t0 zsN`48NTpcV(7r6ik_n*#QnyFTg2B8d?3)bJe~ex5ULhfYXjr#gcLikcO5Cf`A%=R< zA)41#OGgMQt|N7%8z-B2XOq~YF2(T>r2#8K<~6Z|z%lOC8>R%I&c3jyWo^hf@YNc{ zje)P3Q15U;gOEktL?~2YW#AMXBVQ5WZiK3`yb?1kO9qF&Zd7P>9NmMK+z^_aqq1J1 z)Ko{lLYkJ{&N7|eyf{Sp!h#n9`6>`%p+2Swsdz49j?Ia35DvdrwZun zHeq?;gUq7t3e28RsE!9Kps$dK?TmVvT4MIZ-G+Q!DJoGQUo)M)a_~WoooWGO$X9|8 z_Z9Nh+5*N!-shEAUEu{n?^Zepjjiq@KwrJXSrF<)YC!L1XJou!$|K-) zK%5oIW5Trb`DO>*Aho1ZFF&v~YYd}s=g`_qgiwO2Te)S0!5RpzF+4 z>bIy=805=XS=tl|+F(Y7@|X}HyAGIfDB*y{bOdQZEHJbtngfZN=&a}=ZF#PQ1Bw-> z#R&rk5FRLwsI(etU(Dv9YG5@Z&;_VN3bbXx1}&KlwW>53_b&VdD;;0aC2YP`ePEp(Mkjzj zjyIc~!zb}()8FyL(9ZlIC5|6roefvaCoyJIUHK&59B|k})Ra3!O*uOO9FM7o{Gc~q z-1B7#N;@Og4sr#^FxZMw+5!7!U`$sc=}-bioe+v6F};E*L?SvOBo=YOEUb89V6IDj zPQcl`pP}D?5Q$zxXiXuI2vr)Jjy?QOF8c{Qoq?6Ryv)EDvS*^RESP~j;DnG)1}8I# zjwYmo<107O2BehKD+f3QNNms%hCTNRUT9^^gir}QHC_PtnKMGd4QjHJ=x9bQp)~^? z?b1p6S(p(((ja8PcM=^CN_Z8dxpjnitQH8NP!fWrYp7MVb)P$$*v~ zPpBoN=D>;2vRr_fNkZz`Bch{~YYCw>P{#}WcC>O1(?n_<&#OY!bNMDN7*gr9=`kt= zgP|vtoa=;0bTp&(7^xmpS~`BaFe8z3LL_<(A+>aF3DspHZAP#}-j|L~<_UEOpjJXm zAW$P_1Y1FRq%_UYe4{e)Apo3*0B|16`vGk<0Gx*aa2^7{c?baKApo3*0B|0nG~L0H zQ~4gwnAD>*-5~&+hX8OM0>F6)0Ouh9oQD8#9-=gz?G;~W0M3iP+#+E6Ohk2V`ttkR zFV9a_5c}cv?d#jaSXI%&@+^C!HU;)FwgE%fys92z`XFTL39t=@>$xA#0 zq!im?I(akvMt$gq&vJxUC4e3TsvL2$aGZOTcSjPO)I?^c%#K^>rLCYALdK-6d^ z>MGXKuTYx>r4ev7f^#_b*|pb! zY1TeKom_iqH{gB4hFvzH#bfq!x}JH;I*2v{-MnHRW@^qdkE!GB1e~)m0Ryfz_ByNC0tLYw>j zcTiv^V#AY*OWfc=dOK#r71ePBO9b%mV8Fj-jjKCni<^_6B+3Ld=;CLjLQVG7Mzu|) z4JLX)R2t-{#KiAoIF_{m(O?cHD0{ zq62kG*SdC@$BWuigKPI_4$q4OI;!-9&Wn+_)Gs);Eqo^@c4H?(CLy}Lfp7LhlW^-N z&{=cU>6k|qyYMk|r=tbjEv@3+_qSgjZn%7S*JJ_95_nobI*6cN!sRvY8GJM+aI=6> z@ebT!e&GuXEVQJhVA-;Dh}3hyoCvq!SQUZ2Dla6@s@SOdpsNy{;GY$!i8)?6wF8^Xc$NHg14*XZU&B2+DEfmr7#9fRJW2by#;&| zpNIB3N{+XVfnFFNqmCQL(6L(y<3gZ<7=3OVdvGFogEsJB!|EXfiVH(9-~VM9O5BzB z)ZCc>Jun|;cpWb+LRl#d4gp%Hh|^-i@cpqb)l36c%k+ zJoeIsJf~ROuq?#j3S1hBs~{YTRHA0pEBBWmd?;-BbLtZZ~F z>62Q=#Bi4M3ShFz}b?b;V zA0yUmYsarF#C#DzW$7y0JVQ+^CC0*i(l9;n=iQ=KR;&jB?G!I1#(EF?I9(l@>Uaf$ z=E}s_OlU`EV`BSC?TWCbl61h2;QMjLRwlHeC7uX17u-btIUzg9OYOnDSG_M?U%}vb z1%l?vjIB&ai6`xhN(hb5$g0g+B2{&iTam8rEQwHalqXAP+|4rxx2i#kT;*n$ z+=40$k!G|k7p`nnkO{3=A|?@9mJ6P+1w9;&sd2&<+88&?02DzcbOnF|S1OkdelRTE z7;&2k^}Sz?R{%IXVM}>bB06G*EEoD2RdT_YAn*z$g~PH3WRDK5G|$S}8v8NiD+#@u?FTPL*XV1CCM!6BrBC2SE(4!3e) z1Lh>1F35eX5gbNH>f;(31KhY{+^uTiy&Grh!`pJ5;>N?JlN-%4w$@OH%U%VUkWkWz z5U<4%A>HJjumuPdoOXrwn6i%47BSJOGzJrO(W+pF5JQo$W!>!G&DyT$+VKhqhxaM~ z)0GKZnGo_Z^L3=K{b=QUMpljyxo+@%720FUqe3ayj!@+ga6(cad0w$}h5DEX^>y%% zWuH&+f+uXjds9<;Eg-T;EI!v8H{sMFNicSSNWQOQ-Ubq%EF;Tm1;gmWh zd?ZqI#`#(up{{MkvBp$LELgr4lV*_JRA`SWN2f1+ehiSstb5I8WZEOzaj2A3l3%$~~fQ9my>g^+0 zpxdHlOTs%97@ac*OEqj;v7K8sr!WP3IMZ#7l)ORR63MjrX zBPow)DGtS?NZ9gjt?%sJ32&i476?gsM3EO9*dk#o6Y3$_#}YqdODESOO9Ph)TbWLu z<8-WxiHR3Xbwre8TV!lyGJP87F#t64ye%>cAFL4(L^xz@M5KJWK1KN`7!0-tuHZ-x zI!1DkIX~s*rRdNH*}-u9%DKlUksNfiooJ7e;%+-Gk^6Y-W;&bW57Di{L*jY%_c+eo`7|l`p@44tn(PK&SStjP5;zyV$7Du z$G?gZuE&={|bR0e!Dv?iOHFU-3H?bN~Sk;GSMrXEMrUcM~jTDT}sqc$CpMlpGrKH5weu6HBlH<%2p->OnAC%P78pl zcf0{~4pmbhr)+hEI_2;bfU1HS4C6qNiTKhGbN*;C*;c9&6}*oeJbLffwI+$rE%)zW#&mZFCwIv`{s!>`ZY5qB!V zU(R(*pMvH=NMDh%<=xPo(6(!sbqerTH6!J0tr2Vl4unLnnbDTOns$#`DA~Z8^PDZ1 zrvRglbGGt~`oQa{M4Fjm?KxXuZ1|ZG;~36JS6ZkzUG~f=pl8L>?JQ@@O6v~+dOJj0 zcx^bLzSiui1hN@3AjCuVHbUc^txO2$w{DMkzt&0{TD$oV?LEK|Ty->ZPc$?>J!M*~l zi$q5=YCY$D&erLg;%x%Su~-GzdkB)l9wkDIN2LQ>xq0jy88Uqh*BD{}Lufh(C863& zh7$GXgyc%F^wcVAtAs3{0`^xNSj*a4BNK(?=*E&E5mJZTcIiqGq0dNJTee3cI$(xG z2#qE49+fact=U$XMK;O7gh+Elr`@8-brdMV`IVE0Y|AS1FzV?~647f2?a0k(B{_nvCEjZ53_QXcGvwb~M)WtCxT`XhwI0l|%e7uu!kb01H2@is{yoN>xjBQ#F= z_wI%vfjY>_sqVLGgs93nArYP5qf7{Zzi#PD!C-`x@^3TRjP=J%2ssa#Pzj~9d(U$c zm2f-GNyM95_ebeCcou zGNBSG>PtsO4uqJ7B%&iit?b@*b)ZirR@4cZ_6VOG8!-xsppS*8ui3|Wo8-ciM9^Ev78`&a9^2OX8euu5kI)+@MQQ>K8ZJ5 zJ!?L3|K2GIL!G3V@;wHpYrvhdoU zF!0##uC?r`M8Xot4HH@dk=7v7#fO(;cC<}=l!1iBV9Y`P?)g2*J@3=+7x8W#U7K&% zvH9Qs$FFz4{*T|kAQ7^Gqn~P2Dq@BNZsI=-BBR*XjAY^hT9}|&z$hZdG3)#{V=j$= z6`Lb^eKF)BL1GQP)#y|pK{8S*qC@Pg-nYS2VAcXAVVSHjYv87wPkrhX%!!&5uu)Dn zM4JUgnpszjiijbjWHRi5rs8G8`=Do4O9@+=b#+ghxd;~=&nx~Tl7EOy;5|9#kWv=y zxy-qQY9i(VHG!x}_Fd*S5UM%Y03~IEtYS%aTn#zVjDg%Y5)jlKj?g1WeFFw( zJ<|~rz+ce1@up*NT^S2v7=&gF700hprW_WiwA&5R0qNAi*356p(ikYKhLaVqvu!39 zoT2me4io=lgeWk5!Gq&1Sl7(D;&`^g*+R=kdK~_IfADEGuMNRMg8 zP}y;8um`47$24HCF`gY%#er&=70}5c2z(#MAkC>6L&KZ>RmBv{*KZG>lq~fhpYLEy z-u(Cf`#=8!K7RdtetNroLzNaKo&P&N{&0W(`S$DM+lSkiPi^g%Q&~^RWS`LID;xrx zb?7Y<_UCP8HGi7hEUdkygZdJzsgqKg2 zE=-X*s64U2tBPTm4C`tOol2M({K2?1q!gi*H7?OPrO2ZSCD!{CATh3iw9IA=D&cve zZs~j{+>X@>z8U2Hf=GA`@4^5*~z^tP|gbgPGA&^lVOebnfFq74HfPWo2J-pE<7{k)^ ze@F`mG!uu=@oylI=5=pChj-r@+8>n`fTtRSAcaK>$xLYAI_}~w$Imoy=@sm@0XFdG8 zRCT5Ov0ZOyf5;D+UVqmuhYM(qK`KeJ3YDrW|Ei_?v&IJ$pK-1Sl1QW#0tYLG0yeKgt|hfAmp0vEF+tfFj9q;!8^w6WkOr(i5K4;2vri_30cZN zT+`4b#>pO;5K!42p-N+MLf54V@6DOz_BZ03na~xO5DXP;zB2>3?Ks(EpYqz^zUc^+y1a266E7fHnPDWNqZvt$3?Fz#bt6BgI?A?3 zmMgr17q`q6&ND(OvTjC|uBG#8xxy@Z3#DhAE1c<|NMA>%k_$c|CSJ%GgtKg%?Xgcf z)kHAVkPvN==L&-ys_T;IXp5w0#};KQB(|s$47PI2y8tUtS1nS7_o?FBHmA>l&azyH zRAFUVljvYVnNSY=g3z*Dh*V)^S&vhN^NeulGA~?#2=P>5sMlb+akd9UMs-Qlh!F9D zrwSuZ3Xj-0+anWNbE#SZbPXbei5Duh3{T@Y+hdSna8F(_*n z5=h-D$JrjJg41x_zQ4$8NQiNr+$^lP1n2WORX7tu)@3)NWyuh|9o4OJoGQFGhMyf+u|JE2Z8)Q}J@ou>+0x5`3&Oc``tsvdgQSIW9^oi%r~ zoa7=^c%KNNKxEz{#r;N0r(41^g`t@sYqQWElk;y&{kJ`@*FZvCdsGw2LVHYv0O{xm zEei%u6;?E(NEP0v=ncY$9id8Nu$7bYNNXA^S16Au-K?v$1y-o!g3+-=Vdc9PiNgDo z1h&c8H_%zs7p$@4N=WP?Pk5hFCw3XP3_8nF0U;aSMYxfWG){eWpf4msTe_$c%Ps2* zO4@~=l`JQsBSJ|Tra!PHbPXUxx})_8Dl&y(5;l^%1K$Evv@8|8vm<0SKs$x*nDPG^ zg#<#F;m}uL;>S8WGC0II%`g#cp9rCCS+{h{`a)z1(+^W*3hy(BJwx9xqh+z6tX*)O z2o=g>g)Il6N-X%&S*ozQ-4v<9YQ+2QVd(l3g3zK|uuNezdm%3rx?=)jPwf5{2Ql$v zNd8!&@EQsUqGW~Ym~hx#77gaJEEhacSjSaF2glVMqkf6+a@Rl*s^o%Ah)Nt#NUVKY zl&f5%-ey#pchIC*`M4k^cQ}RMBxWcTTgWK@x%c|_#h7xpYS;HHx4Mm2ePxC z#G4&Zgsp1rC-G(-ZW8rmQheay(35zxp=0

    eXmio2YhXwyOuKJpt~dckl_lEoIRLzlK_x$ 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

  • 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�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 z%0D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%0D$X6O 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

    7_EJffN@pOekdf6>Z1q3T4wj+X$p% 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%0DWfr{p1Nj(Xt(9{OQgRXUXxQ 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
    >&q!Mnbth~XPu0xPAr=~OMT?Um~7xF@F*P};i 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�vXWRaZFySjA$!0x!UD47U^HNoq2Li=u4hH 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¥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�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�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 z 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

    ;<8?%lkd?fG9&N%9~dMe~1FN9~DuGN(T1(QxNbs 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⋙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�x6Iex@}ylC*E*bxDm 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 diff --git a/Doc/Manual/SWIGPlus.html b/Doc/Manual/SWIGPlus.html index 2713725..73b242f 100644 --- a/Doc/Manual/SWIGPlus.html +++ b/Doc/Manual/SWIGPlus.html @@ -1,12 +1,13 @@ - + SWIG and C++ + -

    6 SWIG and C++

    +

    6 SWIG and C++

      @@ -75,7 +76,7 @@ how SWIG wraps ANSI C. Support for C++ builds upon ANSI C wrapping and that material will be useful in understanding this chapter.

      -

      6.1 Comments on C++ Wrapping

      +

      6.1 Comments on C++ Wrapping

      @@ -117,7 +118,7 @@ crossing language boundaries and provides many opportunities to shoot yourself in the foot. You will just have to be careful.

      -

      6.2 Approach

      +

      6.2 Approach

      @@ -158,7 +159,7 @@ proxy classes. More detailed coverage can be found in the documentation for each target language.

      -

      6.3 Supported C++ features

      +

      6.3 Supported C++ features

      @@ -185,7 +186,6 @@ The following C++ features are not currently supported:

      • Overloaded versions of certain operators (new, delete, etc.) -
      • Nested classes, see Nested classes for workarounds.

      @@ -198,7 +198,7 @@ in future releases. However, we make no promises. Also, submitting a bug repor good way to get problems fixed (wink).

      -

      6.4 Command line options and compilation

      +

      6.4 Command line options and compilation

      @@ -217,7 +217,7 @@ to use the C++ compiler. For example:

       $ swig -c++ -tcl example.i
      -$ c++ -c example_wrap.cxx 
      +$ c++ -fPIC -c example_wrap.cxx 
       $ c++ example_wrap.o $(OBJS) -o example.so
       
      @@ -232,7 +232,7 @@ details. The SWIG Wiki also has further details. The -noproxy commandline option is recognised by many target languages and will generate just this interface as in earlier versions. -

      6.5 Proxy classes

      +

      6.5 Proxy classes

      @@ -244,7 +244,7 @@ wrapped by a Python proxy class. Or if you're building a Java module, each C++ class is wrapped by a Java proxy class.

      -

      6.5.1 Construction of proxy classes

      +

      6.5.1 Construction of proxy classes

      @@ -326,7 +326,7 @@ Whenever possible, proxies try to take advantage of language features that are s might include operator overloading, exception handling, and other features.

      -

      6.5.2 Resource management in proxies

      +

      6.5.2 Resource management in proxies

      @@ -480,7 +480,7 @@ every possible memory management problem. However, proxies do provide a mechani can be used (if necessary) to address some of the more tricky memory management problems.

      -

      6.5.3 Language specific details

      +

      6.5.3 Language specific details

      @@ -488,7 +488,7 @@ Language specific details on proxy classes are contained in the chapters describ chapter has merely introduced the topic in a very general way.

      -

      6.6 Simple C++ wrapping

      +

      6.6 Simple C++ wrapping

      @@ -521,7 +521,7 @@ To generate wrappers for this class, SWIG first reduces the class to a collectio accessor functions which are then used by the proxy classes.

      -

      6.6.1 Constructors and destructors

      +

      6.6.1 Constructors and destructors

      @@ -530,15 +530,15 @@ functions such as the following :

       List * new_List(void) {
      -	return new List;
      +  return new List;
       }
       void delete_List(List *l) {
      -	delete l;
      +  delete l;
       }
       
       
      -

      6.6.2 Default constructors, copy constructors and implicit destructors

      +

      6.6.2 Default constructors, copy constructors and implicit destructors

      @@ -687,7 +687,7 @@ leaks, and so it is strongly recommended to not use them.

      -

      6.6.3 When constructor wrappers aren't created

      +

      6.6.3 When constructor wrappers aren't created

      @@ -764,7 +764,7 @@ public: More information about %feature can be found in the Customization features chapter.

      -

      6.6.4 Copy constructors

      +

      6.6.4 Copy constructors

      @@ -866,7 +866,7 @@ constructor is set to new_CopyFoo(). This is the same as in older versions.

      -

      6.6.5 Member functions

      +

      6.6.5 Member functions

      @@ -874,7 +874,7 @@ All member functions are roughly translated into accessor functions like this :<

       int List_search(List *obj, char *value) {
      -	return obj->search(value);
      +  return obj->search(value);
       }
       
       
      @@ -892,7 +892,7 @@ wrapper functions. However, the name and calling convention of the low-level procedural wrappers match the accessor function prototype described above.

      -

      6.6.6 Static members

      +

      6.6.6 Static members

      @@ -902,7 +902,7 @@ transformations. For example, the static member function in the generated wrapper code.

      -

      6.6.7 Member data

      +

      6.6.7 Member data

      @@ -912,11 +912,11 @@ structures. A pair of accessor functions are effectively created. For example

       int List_length_get(List *obj) {
      -	return obj->length;
      +  return obj->length;
       }
       int List_length_set(List *obj, int value) {
      -	obj->length = value;
      -	return value;
      +  obj->length = value;
      +  return value;
       }
       
       
      @@ -933,7 +933,7 @@ class List { public: ... %immutable; - int length; + int length; %mutable; ... }; @@ -960,8 +960,9 @@ Similarly, all data attributes declared as const are wrapped as read-on

      +By default, SWIG uses the const reference typemaps for members that are primitive types. There are some subtle issues when wrapping data members that are -themselves classes. For instance, if you had another class like this, +not primitive types, such as classes. For instance, if you had another class like this,

      @@ -974,7 +975,8 @@ public:

      -then the low-level accessor to the items member actually uses pointers. For example: +then the low-level accessor to the items member actually uses pointers. +For example:

      @@ -999,7 +1001,22 @@ This can be somewhat unnatural for some types. For example, a user would expect the STL std::string class member variables to be wrapped as a string in the target language, rather than a pointer to this class. The const reference typemaps offer this type of marshalling, so there is a feature to tell SWIG to use the const reference typemaps rather than the pointer typemaps. -It is the %naturalvar directive and is used as follows: +It is the naturalvar feature and can be used to effectively change the way accessors are generated to the following: +

      + +
      +
      +const List &Foo_items_get(Foo *self) {
      +    return self->items;
      +}
      +void Foo_items_set(Foo *self, const List &value) {
      +    self->items = value;
      +}
      +
      +
      + +

      +The %naturalvar directive is a macro for, and hence equivalent to, %feature("naturalvar"). It can be used as follows:

      @@ -1013,40 +1030,31 @@ struct Foo { List myList; }; -// All variables will use const reference typemaps +// All non-primitive types will use const reference typemaps %naturalvar;

      The observant reader will notice that %naturalvar works like any other -feature flag directive, -except it can also be attached to class types. -The first of the example usages above show %naturalvar attaching to the List class. -Effectively this feature changes the way accessors are generated to the following: +feature flag directive but with some extra flexibility. +The first of the example usages above shows %naturalvar attaching to the myList's variable type, that is the List class. +The second usage shows %naturalvar attaching to the variable name. +Hence the naturalvar feature can be used on either the variable's name or type. +Note that using the naturalvar feature on a variable's name overrides any naturalvar feature attached to the variable's type.

      -
      -
      -const List &Foo_items_get(Foo *self) {
      -    return self->items;
      -}
      -void Foo_items_set(Foo *self, const List &value) {
      -    self->items = value;
      -}
      -
      -
      -

      -In fact it is generally a good idea to use this feature globally as the reference typemaps have extra NULL checking compared to the pointer typemaps. +It is generally a good idea to use this feature globally as the reference typemaps have extra NULL checking compared to the pointer typemaps. A pointer can be NULL, whereas a reference cannot, so the extra checking ensures that the target language user does not pass in a value that translates to a NULL pointer and thereby preventing any potential NULL pointer dereferences. The %naturalvar feature will apply to global variables in addition to member variables in some language modules, eg C# and Java.

      -Other alternatives for turning this feature on globally are to use the swig -naturalvar commandline option -or the module mode option, %module(naturalvar=1) +The naturalvar behavior can also be turned on as a global setting via the -naturalvar commandline option +or the module mode option, %module(naturalvar=1). +However, any use of %feature("naturalvar") will override the global setting.

      @@ -1086,7 +1094,7 @@ a few problems related to structure wrapping and some of SWIG's customization features.

      -

      6.7 Default arguments

      +

      6.7 Default arguments

      @@ -1177,26 +1185,28 @@ public:

      -This produces uncompileable wrapper code because default values in C++ are +This produces uncompilable wrapper code because default values in C++ are evaluated in the same scope as the member function whereas SWIG evaluates them in the scope of a wrapper function (meaning that the values have to be public).

      -This feature is automatically turned on when wrapping C code with default arguments -and whenever keyword arguments (kwargs) are specified for either C or C++ code. +The compactdefaultargs feature is automatically turned on when wrapping C code with default arguments. +Some target languages will also automatically turn on this feature +if the keyword arguments feature (kwargs) is specified for either C or C++ functions, and the target language supports kwargs, +the compactdefaultargs feature is also automatically turned on. Keyword arguments are a language feature of some scripting languages, for example Ruby and Python. SWIG is unable to support kwargs when wrapping overloaded methods, so the default approach cannot be used.

      -

      6.8 Protection

      +

      6.8 Protection

      SWIG wraps class members that are public following the C++ conventions, i.e., by explicit public declaration or by the use of - the using directive. In general, anything specified in a + the using directive. In general, anything specified in a private or protected section will be ignored, although the internal code generator sometimes looks at the contents of the private and protected sections so that it can properly generate code for default @@ -1210,7 +1220,7 @@ until you explicitly give a `public:' declaration (This is the same convention used by C++).

      -

      6.9 Enums and constants

      +

      6.9 Enums and constants

      @@ -1221,7 +1231,7 @@ into constants with the classname as a prefix. For example :

       class Swig {
       public:
      -	enum {ALE, LAGER, PORTER, STOUT};
      +  enum {ALE, LAGER, PORTER, STOUT};
       };
       
       
      @@ -1240,7 +1250,7 @@ Swig_STOUT = Swig::STOUT Members declared as const are wrapped as read-only members and do not create constants.

      -

      6.10 Friends

      +

      6.10 Friends

      @@ -1301,7 +1311,7 @@ namespace bar { and a wrapper for the method 'blah' will not be generated.

      -

      6.11 References and pointers

      +

      6.11 References and pointers

      @@ -1311,7 +1321,7 @@ a declaration like this :

       class Foo {
       public:
      -	double bar(double &a);
      +  double bar(double &a);
       }
       
      @@ -1321,7 +1331,7 @@ has a low-level accessor
       double Foo_bar(Foo *obj, double *a) {
      -	obj->bar(*a);
      +  obj->bar(*a);
       }
       
      @@ -1401,7 +1411,7 @@ templates and the STL. This was first added in SWIG-1.3.12.

      -

      6.12 Pass and return by value

      +

      6.12 Pass and return by value

      @@ -1505,7 +1515,7 @@ classes that don't define a default constructor. It is not used for C++ pointers or references.

      -

      6.13 Inheritance

      +

      6.13 Inheritance

      @@ -1522,7 +1532,7 @@ multiple inheritance. spirit, and target language capabilities, as possible. In most cases, this means that SWIG will parse the non-public inheritance declarations, but that will have no effect in the generated code, -besides the implicit policies derived for constructor and +besides the implicit policies derived for constructors and destructors.

      @@ -1540,24 +1550,24 @@ the full C++ code has been omitted.

      class Shape { public: - double x,y; - virtual double area() = 0; - virtual double perimeter() = 0; - void set_location(double x, double y); + double x,y; + virtual double area() = 0; + virtual double perimeter() = 0; + void set_location(double x, double y); }; class Circle : public Shape { public: - Circle(double radius); - ~Circle(); - double area(); - double perimeter(); + Circle(double radius); + ~Circle(); + double area(); + double perimeter(); }; class Square : public Shape { public: - Square(double size); - ~Square(); - double area(); - double perimeter(); + Square(double size); + ~Square(); + double area(); + double perimeter(); }
    @@ -1691,7 +1701,7 @@ functions for virtual members that are already defined in a base class.

    -

    6.14 A brief discussion of multiple inheritance, pointers, and type checking

    +

    6.14 A brief discussion of multiple inheritance, pointers, and type checking

    @@ -1823,7 +1833,7 @@ int y = B_function((B *) pB); In practice, the pointer is held as an integral number in the target language proxy class.

    -

    6.15 Wrapping Overloaded Functions and Methods

    +

    6.15 Wrapping Overloaded Functions and Methods

    @@ -1886,7 +1896,7 @@ it might be used like this -

    6.15.1 Dispatch function generation

    +

    6.15.1 Dispatch function generation

    @@ -2011,7 +2021,7 @@ checked in the same order as they appear in this ranking. If you're still confused, don't worry about it---SWIG is probably doing the right thing.

    -

    6.15.2 Ambiguity in Overloading

    +

    6.15.2 Ambiguity in Overloading

    @@ -2092,13 +2102,13 @@ Therefore, earlier methods will shadow methods that appear later.

    -When wrapping an overloaded function, there is a chance that you will get an error message like this: +When wrapping an overloaded function, there is a chance that you will get a warning message like this:

    -example.i:3: Warning 467: Overloaded foo(int) not supported (no type checking
    -rule for 'int').
    +example.i:3: Warning 467: Overloaded foo(int) not supported (incomplete type checking rule - 
    +no precedence level in typecheck typemap for 'int').
     
    @@ -2107,7 +2117,8 @@ This error means that the target language module supports overloading, but for some reason there is no type-checking rule that can be used to generate a working dispatch function. The resulting behavior is then undefined. You should report this as a bug to the -SWIG bug tracking database. +SWIG bug tracking database +if this is due to one of the typemaps supplied with SWIG.

    @@ -2128,7 +2139,7 @@ it means that the target language module has not yet implemented support for ove functions and methods. The only way to fix the problem is to read the next section.

    -

    6.15.3 Ambiguity resolution and renaming

    +

    6.15.3 Ambiguity resolution and renaming

    @@ -2471,6 +2482,7 @@ above:

    4Bz6GKN7O^5+dzd(1LT2`S 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 z�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

  • Currently no resolution is performed in order to match function parameters. This means function parameter types must match exactly. For example, namespace qualifiers and typedefs will not work. The following usage of typedefs demonstrates this: +

    @@ -2557,7 +2569,7 @@ to wrapping methods with default arguments was introduced.
     
     
     
    -

    6.15.4 Comments on overloading

    +

    6.15.4 Comments on overloading

    @@ -2574,7 +2586,7 @@ As a general rule, statically typed languages like Java are able to provide more than dynamically typed languages like Perl, Python, Ruby, and Tcl.

    -

    6.16 Wrapping overloaded operators

    +

    6.16 Wrapping overloaded operators

    @@ -2603,7 +2615,7 @@ public: } Complex operator*(const Complex &c) const { return Complex(rpart*c.rpart - ipart*c.ipart, - rpart*c.ipart + c.rpart*ipart); + rpart*c.ipart + c.rpart*ipart); } Complex operator-() const { return Complex(-rpart, -ipart); @@ -2758,7 +2770,7 @@ are ignored as well as conversion operators.

  • -

    6.17 Class extension

    +

    6.17 Class extension

    @@ -2776,22 +2788,22 @@ example : class Vector { public: - double x,y,z; - Vector(); - ~Vector(); - ... bunch of C++ methods ... - %extend { - char *__str__() { - static char temp[256]; - sprintf(temp,"[ %g, %g, %g ]", $self->x,$self->y,$self->z); - return &temp[0]; - } - } + double x,y,z; + Vector(); + ~Vector(); + ... bunch of C++ methods ... + %extend { + char *__str__() { + static char temp[256]; + sprintf(temp,"[ %g, %g, %g ]", $self->x,$self->y,$self->z); + return &temp[0]; + } + } };

    -This code adds a __str__ method to our class for producing a +This code adds a __str__ method to our class for producing a string representation of the object. In Python, such a method would allow us to print the value of an object using the print command. @@ -2840,12 +2852,12 @@ struct Derived : Base {

    The following special variables are expanded if used within a %extend block: -$name, $symname, $overname, $decl, $fulldecl, $parentname and $parentsymname. +$name, $symname, $overname, $decl, $fulldecl, $parentclassname and $parentclasssymname. The Special variables section provides more information each of these special variables.

    -The %extend directive follows all of the same conventions +The %extend directive follows all of the same conventions as its use with C structures. Please refer to the Adding member functions to C structures section for further details.

    @@ -2857,7 +2869,7 @@ be used to extend a structure with more than just methods, a more suitable directive name has been chosen.

    -

    6.18 Templates

    +

    6.18 Templates

    @@ -3558,7 +3570,7 @@ It is also possible to separate these declarations from the template class. For template<class T> class List { ... public: - List() { }; + List() { } T get(int index); ... }; @@ -3605,18 +3617,52 @@ and the second will take two integer arguments.

    -Needless to say, SWIG's template support provides plenty of -opportunities to break the universe. That said, an important final -point is that SWIG does not perform extensive error checking of -templates! Specifically, SWIG does not perform type checking nor -does it check to see if the actual contents of the template -declaration make any sense. Since the C++ compiler will hopefully -check this when it compiles the resulting wrapper file, there is no -practical reason for SWIG to duplicate this functionality (besides, -none of the SWIG developers are masochistic enough to want to -implement this right now). +Needless to say, SWIG's template support provides plenty of opportunities to +break the universe. That said, an important final point is that SWIG does +not perform extensive error checking of templates! Specifically, SWIG does +not perform type checking nor does it check to see if the actual contents of the +template declaration make any sense. Since the C++ compiler checks this when it +compiles the resulting wrapper file, there is no practical reason for SWIG to +duplicate this functionality. +

    + + +

    +As SWIG's template support does not perform type checking %template +can be used as early as after a template declaration. You can, and rarely have +to, use %template before the template parameters have been declared. +For example:

    +
    +
    +template <class T> class OuterTemplateClass {};
    +
    +// The nested class OuterClass::InnerClass inherits from the template class
    +// OuterTemplateClass<OuterClass::InnerStruct> and thus the template needs
    +// to be expanded with %template before the OuterClass declaration.
    +%template(OuterTemplateClass_OuterClass__InnerStruct)
    +    OuterTemplateClass<OuterClass::InnerStruct>
    +
    +
    +// Don't forget to use %feature("flatnested") for OuterClass::InnerStruct and
    +// OuterClass::InnerClass if the target language doesn't support nested classes.
    +class OuterClass {
    +    public:
    +        // Forward declarations:
    +        struct InnerStruct;
    +        class InnerClass;
    +};
    +
    +struct OuterClass::InnerStruct {};
    +
    +// Expanding the template at this point with %template is too late as the
    +// OuterClass::InnerClass declaration is processed inside OuterClass.
    +
    +class OuterClass::InnerClass : public OuterTemplateClass<InnerStruct> {};
    +
    +
    +

    Compatibility Note: The first implementation of template support relied heavily on macro expansion in the preprocessor. Templates have been more tightly integrated into @@ -3657,7 +3703,7 @@ as the class name. For example: Similar changes apply to typemaps and other customization features.

    -

    6.19 Namespaces

    +

    6.19 Namespaces

    @@ -4106,7 +4152,7 @@ with any namespace awareness. In the future, language modules may or may not p more advanced namespace support.

    -

    6.19.1 The nspace feature for namespaces

    +

    6.19.1 The nspace feature for namespaces

    @@ -4187,7 +4233,7 @@ namespace MyWorld { Compatibility Note: The nspace feature was first introduced in SWIG-2.0.0.

    -

    6.20 Renaming templated types in namespaces

    +

    6.20 Renaming templated types in namespaces

    @@ -4265,7 +4311,7 @@ namespace Space { -

    6.21 Exception specifications

    +

    6.21 Exception specifications

    @@ -4316,7 +4362,7 @@ Consult the "Exception hand The next section details a way of simulating an exception specification or replacing an existing one.

    -

    6.22 Exception handling with %catches

    +

    6.22 Exception handling with %catches

    @@ -4366,7 +4412,7 @@ just a single catch handler for the base class, EBase will be generated

    -

    6.23 Pointers to Members

    +

    6.23 Pointers to Members

    @@ -4416,7 +4462,7 @@ when checking types. However, no such support is currently provided for member pointers.

    -

    6.24 Smart pointers and operator->()

    +

    6.24 Smart pointers and operator->()

    @@ -4628,11 +4674,12 @@ p = f.__deref__() # Raw pointer from operator-> Note: Smart pointer support was first added in SWIG-1.3.14.

    -

    6.25 C++ reference counted objects - ref/unref feature

    +

    6.25 C++ reference counted objects - ref/unref feature

    Another similar idiom in C++ is the use of reference counted objects. Consider for example: +

    @@ -4649,11 +4696,11 @@ public:
         return add_ref();
       }
     
    -  int unref() const   {
    +  int unref() const {
         if (ref_count() == 0 || del_ref() == 0 ) {
    -	delete this;
    -	return 0;
    -      } 
    +      delete this;
    +      return 0;
    +    }
         return ref_count();
       }
     };
    @@ -4800,7 +4847,7 @@ exit              # 'a' is released, SWIG unref 'a' called in the destructor wra
     
     
     
    -

    6.26 Using declarations and inheritance

    +

    6.26 Using declarations and inheritance

    @@ -4963,151 +5010,71 @@ public:

    -

    6.27 Nested classes

    +

    6.27 Nested classes

    -There is some support for nested structs and unions when wrapping C code, -see Nested structures for further details. -The added complexity of C++ compared to C means this approach does not work well for -C++ code (when using the -c++ command line option). -For C++, a nested class is treated much like an opaque pointer, so anything useful within the nested class, such as its -methods and variables, are not accessible from the target language. -True nested class support may be added to SWIG in the future, however, -until then some of the following workarounds can be applied to improve the situation. +If the target language supports the nested classes concept (like Java), the nested C++ classes +are wrapped as nested target language proxy classes. (In case of Java - "static" nested classes.) +Only public nested classes are wrapped. Otherwise there is little difference between nested and +normal classes.

    -

    -It might be possible to use partial class information as often you can accept that the nested class is not needed, -especially if it is not actually used in any methods you need from the target language. -Imagine you are wrapping the following Outer class which contains a nested class Inner. -The easiest thing to do is turn a blind eye to the warning that SWIG generates, or simply suppress it: +If the target language doesn't support nested classes directly, or the support is not implemented in the +language module (like for python currently), then the visible nested classes are moved to the same name +space as the containing class (nesting hierarchy is "flattened"). The same behaviour may be turned on for +C# and Java by the %feature ("flatnested"); If there is a class with the same name in the outer namespace +the inner class (or the global one) may be renamed or ignored:

    -%warnfilter(SWIGWARN_PARSE_NAMED_NESTED_CLASS) Outer::Inner;
    -
    -class Outer {
    -public:
    -  class Inner {
    -    public:
    -      ...
    -  };
    -  Inner getInner();
    -  void useInner(const Inner& inner);
    -  ...
    -};
    -
    -
    - -

    -Note that if Inner can be used as an opaque type, the default wrapping approach suffices. -For example, if the nested class does not need to be created from the target language, but can be obtained via a method -call, such as the getInner() method above, the returned value can then be passed around, such as passed into the -useInner() method. -

    - -

    -With some more effort the above situation can be improved somewhat and a nested class can be constructed and used -from the target language much like any other non-nested class. Assuming we have the Outer class in a header file: -

    - -
    -
    -// File outer.h
    -class Outer {
    -public:
    -  class Inner {
    -    public:
    -      int var;
    -      Inner(int v = 0) : var(v) {}
    -  };
    -  Inner getInner();
    -  void useInner(const Inner& inner);
    -};
    -
    -
    - -

    -The following interface file works around the nested class limitations by redefining the nested class as a global class. -A typedef for the compiler and the nestedworkaround -feature flag is also required in -order for the generated wrappers to compile. This flag simply removes all the type information from SWIG, so SWIG treats -the nested class as if it had not been parsed at all. -

    - -
    -
    -// File : example.i
    -%module example
    -
    -// Redefine nested class in global scope in order for SWIG to generate
    -// a proxy class. Only SWIG parses this definition.
    -class Inner {
    +%rename (Bar_Foo) Bar::Foo;
    +class Foo {};
    +class Bar {
       public:
    -    int var;
    -    Inner(int v = 0) : var(v) {}
    +  class Foo {};
     };
    -
    -%nestedworkaround Outer::Inner;
    -
    -%{
    -#include "outer.h"
    -%}
    -%include "outer.h"
    -
    -// We've fooled SWIG into thinking that Inner is a global class, so now we need
    -// to trick the C++ compiler into understanding this apparent global type.
    -%{
    -typedef Outer::Inner Inner;
    -%}
     

    -The downside to this approach is a more complex interface file and having to maintain two definitions of Inner, -the real one and the one in the interface file that SWIG parses. -However, the upside is that all the methods/variables in the nested class are available from the target language -as a proxy class is generated instead of treating the nested class as an opaque type. -The proxy class can be constructed from the target language and passed into any methods accepting the nested class. -Also note that the original header file is parsed unmodified. +If a nested class, within an outer class, has to be used as a template parameter within the outer class, then the template will +have to be instantiated with %template before the beginning of the outer class. +An example can be found in the +Templates section.

    -Finally, conditional compilation can be used as a workaround to comment out nested class definitions in the actual headers, -assuming you are able to modify them. +Compatibility Note: +Prior to SWIG-3.0.0, there was limited nested class support. Nested classes were treated as opaque pointers. +However, there was a workaround for nested class support in these older versions requiring the user to replicate +the nested class in the global scope, adding in a typedef for the nested class in the global scope and +using the "nestedworkaround" feature on the nested class. This resulted in approximately the +same behaviour as the "flatnested" feature. With proper nested class support now available in SWIG-3.0.0, this +feature has been deprecated and no longer works requiring code changes. If you see the following warning:

    -
    +
    -// File outer.h
    -class Outer {
    -public:
    -#ifndef SWIG
    -  class Inner {
    -    public:
    -      ...
    -  };
    -#endif
    -  ...
    -};
    +example.i:8: Warning 126: The nestedworkaround feature is deprecated
     

    -This workaround used to be common when SWIG could not deal with nested classes particulary well. -This should just be a last resort for unusual corner cases now as SWIG can parse nested classes and even handle nested template classes fairly well. +consider using the "flatnested" feature discussed above which generates a non-nested proxy class, like the +"nestedworkaround" feature did. Alternatively, use the default nested class code generation, which may generate an +equivalent to a nested proxy class in the target language, depending on the target language support.

    -Compatibility Note: SWIG-1.3.40 and earlier versions did not have the nestedworkaround feature +SWIG-1.3.40 and earlier versions did not have the nestedworkaround feature and the generated code resulting from parsing nested classes did not always compile. Nested class warnings could also not be suppressed using %warnfilter.

    -

    6.28 A brief rant about const-correctness

    +

    6.28 A brief rant about const-correctness

    @@ -5165,7 +5132,7 @@ using another tool if maintaining constness is the most important part of your project.

    -

    6.29 Where to go for more information

    +

    6.29 Where to go for more information

    diff --git a/Doc/Manual/Scilab.html b/Doc/Manual/Scilab.html new file mode 100644 index 0000000..0ac4c05 --- /dev/null +++ b/Doc/Manual/Scilab.html @@ -0,0 +1,2147 @@ + + + +SWIG and Scilab + + + + + + + +

    39 SWIG and Scilab

    + + + + + + +

    +Scilab is a scientific software package for numerical computations providing a powerful open computing environment for engineering and scientific applications that is mostly compatible with MATLAB. More information can be found at www.scilab.org. +

    + +

    +This chapter explains how to use SWIG for Scilab. After this introduction, you should be able to generate with SWIG a Scilab external module from a C/C++ library. +

    + + +

    39.1 Preliminaries

    + + +

    +SWIG for Scilab supports Linux. Other operating sytems haven't been tested. +

    + +

    +Scilab is supported from version 5.3.3 onwards. +The forthcoming version 6, as of January 2015, is also supported. +

    + +

    +SWIG for Scilab supports C language. C++ is partially supported. See A basic tour of C/C++ wrapping for further details. +

    + + +

    39.2 Running SWIG

    + + +

    +Let's see how to use SWIG for Scilab on a small example. +
    +In this example we bind from C a function and a global variable into Scilab. The SWIG interface (stored in a file named example.i), is the following: +

    + +
    +%module example
    +
    +%inline %{
    +double Foo = 3.0;
    +
    +int fact(int n) {
    +    if (n < 0) {
    +        return 0;
    +    }
    +    else if (n == 0) {
    +        return 1;
    +    }
    +    else {
    +        return n * fact(n-1);
    +    }
    +}
    +%}
    +
    + +

    +Note: a code in an %inline section is both parsed and wrapped by SWIG, and inserted as is in the wrapper source file. +

    + + +

    39.2.1 Generating the module

    + + +

    +The module is generated using the swig executable and its -scilab option. +

    + +
    +$ swig -scilab example.i
    +
    + +

    +This command generates two files: +

    +
      +
    • example_wrap.c: a C source file containing the wrapping code and also here the wrapped code (the fact() and Foo definitions)
    • +
    • loader.sce: a Scilab script used to load the module into Scilab +
    + +

    +Note: if the following error is returned: +

    + +
    +:1: Error: Unable to find 'swig.swg'
    +:3: Error: Unable to find 'scilab.swg'
    +
    + +

    +it may be because the SWIG library is not found. Check the SWIG_LIB environment variable or your SWIG installation. +

    + +

    +Note: SWIG for Scilab can work in two modes related to the way the module is built, see the Building modes section for details. +This example uses the builder mode. +

    + + +

    +The swig executable has several other command line options you can use. See Scilab command line options for further details. +

    + + +

    39.2.2 Building the module

    + + +

    +To be loaded in Scilab, the wrapper has to be built into a dynamic module (or shared library). +

    + +

    +The commands to compile and link the wrapper (with gcc) into the shared library libexample.so are: +

    + +
    +$ gcc -fPIC -c -I/usr/local/include/scilab example_wrap.c
    +$ gcc -shared example_wrap.o -o libexample.so
    +
    + +

    +Note: we supposed in this example that the path to the Scilab include directory is /usr/local/include/scilab (which is the case in a Debian environment), this should be changed for another environment. +

    + +

    39.2.3 Loading the module

    + + +

    +Loading a module is done by running the loader script in Scilab: +

    + +
    +--> exec loader.sce
    +
    + +

    +Scilab should output the following messages: +

    + +
    +Shared archive loaded.
    +Link done.
    +
    + +

    +which means that Scilab has successfully loaded the shared library. The module functions and other symbols are now available in Scilab. +

    + +

    39.2.4 Using the module

    + + +

    +In Scilab, the function fact() is simply called as following: +

    + +
    +--> fact(5)
    +ans  =
    +
    +    120.
    +
    + +

    For the Foo global variable, the accessors need to be used: + +

    +--> Foo_get
    +ans  =
    +
    +    3.
    +
    +--> Foo_set(4);
    +
    +--> Foo_get
    +ans  =
    +
    +    4.
    +
    + +

    +Note: for conciseness, we assume in the subsequent Scilab code examples that the modules have been beforehand built and loaded in Scilab. +

    + +

    39.2.5 Scilab command line options

    + + +

    +The following table lists the Scilab specific command line options in addition to the generic SWIG options: +

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    -builderGenerate the Scilab builder script
    -buildercflags <cflags>Add <cflags> to the builder compiler flags
    -builderldflags <ldflags>Add <ldlags> to the builder linker flags
    -buildersources <files>Add the (comma separated) files <files> to the builder sources
    -builderverbositylevel <level>Set the build verbosity level to <level> (default 0: off, 2: high)
    -builderflagscript <file>Use the Scilab script <file> to configure the compiler and linker flags
    -gatewayxml <gateway_id>Generate the gateway XML with the given <gateway_id>
    + +

    +These options can be displayed with: +

    + +
    +$ swig -scilab -help
    +
    + + +

    39.3 A basic tour of C/C++ wrapping

    + + +

    39.3.1 Overview

    + + +

    +SWIG for Scilab provides only a low-level C interface for Scilab (see Scripting Languages for the general approach to wrapping). +This means that functions, structs, classes, variables, etc... are interfaced through C functions. These C functions are mapped as Scilab functions. +There are a few exceptions, such as constants and enumerations, which can be wrapped directly as Scilab variables. +

    + +

    39.3.2 Identifiers

    + + +

    +In Scilab 5.x, identifier names are composed of 24 characters maximum (this limitation should disappear from Scilab 6.0 onwards). +
    Thus long function or variable names may be truncated and this can cause ambiguities. +

    +

    This happens especially when wrapping structs/classes, for which the wrapped function name is composed of the struct/class name and field names. +In these cases, the %rename directive can be used to choose a different Scilab name. +

    + +

    39.3.3 Functions

    + + +

    +Functions are wrapped as new Scilab built-in functions. For example: +

    + +
    +%module example
    +
    +%inline %{
    +int fact(int n) {
    +  if (n > 1)
    +    return n * fact(n - 1);
    +  else
    +    return 1;
    +}
    +%}
    +
    + +

    +creates a built-in function fact(n) in Scilab: +

    + +
    +--> fact(4)
    +ans  =
    +
    +    24.
    +
    + +

    39.3.3.1 Argument passing

    + + +

    +In the above example, the function parameter is a primitive type and is marshalled by value. +So this function is wrapped without any additional customization. +Argument values are converted between C types and Scilab types through type mappings. +There are several default type mappings for primitive and complex types, described later in the Scilab typemaps section. +

    + +

    +When a parameter is not passed by value, such as a pointer or reference, SWIG does not know if it is an input, output (or both) parameter. +The INPUT, OUTPUT, INOUT typemaps defined in the typemaps.i library can be used to specify this. +

    + +

    +Let's see this on two simple functions: sub() which has an output parameter, and inc(), which as input/output parameter: +

    + +
    +%module example
    +
    +%include <typemaps.i>
    +
    +extern void sub(int *INPUT, int *INPUT, int *OUTPUT);
    +extern void inc(int *INOUT, int *INPUT);
    +
    +%{
    +void sub(int *x, int *y, int *result) {
    +  *result = *x - *y;
    +}
    +void inc(int *x, int *delta) {
    +  *x = *x + *delta;
    +}
    +%}
    +
    + +

    +In Scilab, parameters are passed by value. The output (and inout) parameters are returned as the result of the functions: +

    + +
    +--> sub(5, 3)
    + ans  =
    +
    +    2.
    +
    +--> inc(4, 3)
    + ans  =
    +
    +    7.
    +
    + +

    39.3.3.2 Multiple output arguments

    + + +

    +A C function can have several output parameters. They can all be returned as results of the wrapped function as Scilab supports multiple return values from a function +when using the typemaps.i library. +If the C function itself returns a result, this is returned first before the parameter outputs. +

    + +

    +The example below shows this for a C function returning 2 values and a result: +

    + +
    +%module example
    +
    +%include <typemaps.i>
    +
    +int divide(int n, int d, int *OUTPUT, int *OUTPUT);
    +
    +%{
    +int divide(int n, int d, int q*, int *r) {
    +   if (d != 0) {
    +     *q = n / d;
    +     *r = n % d;
    +     return 1;
    +   }
    +   else return 0;
    +}
    +%}
    +
    + +
    + +
    +--> [ret, q, r] = divide(20, 6)
    + r  =
    +
    +    2.
    + q  =
    +
    +    3.
    + ret  =
    +
    +    1.
    +
    + + +

    39.3.4 Global variables

    + + +

    +Global variables are manipulated through generated accessor functions. +For example, for a given Foo global variable, SWIG actually generates two functions: Foo_get() to get the value of Foo, and Foo_set() to set the value. +These functions are used as following: +

    + +
    +--> exec loader.sce;
    +--> c = Foo_get();
    +
    +--> Foo_set(4);
    +
    +--> c
    +c =
    +
    +    3.
    +
    +--> Foo_get()
    +ans  =
    +
    +    4.
    +
    + +

    +It works for variables of primitive type, but also for non-primitive types: arrays, and structs/classes which are described later. +For now, an example with two global primitive arrays x and y is shown: +

    + +
    +%module example
    +
    +%inline %{
    +int x[10];
    +double y[7];
    +
    +void initArrays()
    +{
    +  int i;
    +  for (i = 0; i < 10; i++)
    +    x[i] = 1;
    +  for (i = 0; i < 7; i++)
    +    y[i] = 1.0f;
    +}
    +%}
    +
    + +

    +It works the same:

    + +
    +--> exec loader.sce
    +
    +--> initArrays();
    +--> x_get()
    + ans  =
    +
    +    1.    1.    1.    1.    1.    1.    1.    1.    1.    1.
    +
    +--> y_set([0:6] / 10);
    +--> y_get()
    + ans  =
    +
    +    0.    0.1    0.2    0.3    0.4    0.5    0.6
    +
    + + +

    39.3.5 Constants and enumerations

    + + +

    39.3.5.1 Constants

    + + +

    +There is not any constant in Scilab. By default, C/C++ constants are wrapped as getter functions. For example, for the following constants: +

    + +
    +%module example
    +#define    ICONST      42
    +#define    FCONST      2.1828
    +#define    CCONST      'x'
    +#define    CCONST2     '\n'
    +#define    SCONST      "Hello World"
    +#define    SCONST2     "\"Hello World\""
    +
    + +

    +the following getter functions are generated: +

    + +
    +--> exec loader.sce;
    +--> ICONST_get();
    + ans  =
    +
    +    42.
    +
    +--> FCONST_get();
    + ans  =
    +
    +    2.1828
    +
    +--> CCONST_get();
    + ans  =
    +
    +    x
    +
    +--> CCONST2_get();
    + ans  =
    +
    +--> SCONST_get();
    + ans  =
    +
    +    Hello World
    +
    +--> SCONST2_get();
    + ans  =
    +
    +    "Hello World"
    +
    +--> EXPR_get();
    + ans  =
    +
    +    48.5484
    +
    +--> iconst_get();
    + ans  =
    +
    +    37.
    +
    +--> fconst_get();
    + ans  =
    +
    +    3.14
    +
    + +

    +There is another mode in which constants are wrapped as Scilab variables. +The variables are easier to use than functions, but the drawback is that variables are not constant and so can be modified. +

    + +

    +This mode can be enabled/disabled at any time in the interface file with %scilabconst(), which +works like all the other %feature directives. +Use the argument value "1" to enable and "0" to disable this mode. +For example in this mode the previous constants: +

    + +
    +%module example
    +
    +%scilabconst(1);
    +#define    ICONST      42
    +#define    FCONST      2.1828
    +#define    CCONST      'x'
    +#define    CCONST2     '\n'
    +#define    SCONST      "Hello World"
    +#define    SCONST2     "\"Hello World\""
    +
    + +

    +are mapped to Scilab variables, with the same name: +

    + +
    +--> exec loader.sce;
    +--> ICONST
    + ans  =
    +
    +    42
    +
    +--> FCONST
    + ans  =
    +
    +    2.1828
    +
    +--> CCONST
    + ans  =
    +
    +    x
    +
    +--> CCONST2
    + ans  =
    +
    +--> SCONST
    + ans  =
    +
    +    Hello World
    +
    +--> SCONST2
    + ans  =
    +
    +    "Hello World"
    +
    +--> EXPR
    + ans  =
    +
    +    48.5484
    +
    +--> iconst
    + ans  =
    +
    +    37
    +
    +--> fconst
    + ans  =
    +
    +    3.14
    +
    + +

    39.3.5.2 Enumerations

    + + +

    +The wrapping of enums is the same as for constants. +By default, enums are wrapped as getter functions. +For example, with the following enumeration: +

    + +
    %module example
    +typedef enum { RED, BLUE, GREEN } color;
    +
    + +

    +a getter function will be generated for each value of the enumeration: +

    + +
    +--> exec loader.sce;
    +--> RED_get()
    + ans  =
    +
    +    0.
    +
    +--> BLUE_get()
    + ans  =
    +
    +    1.
    +
    +--> GREEN_get()
    + ans  =
    +
    +    2.
    +
    + +

    +The %scilabconst() feature is also available for enumerations: +

    + +
    %module example
    +%scilabconst(1) color;
    +typedef enum { RED, BLUE, GREEN } color;
    +
    + +
    + +
    +--> exec loader.sce;
    +--> RED
    + ans  =
    +
    +    0.
    +
    +--> BLUE
    + ans  =
    +
    +    1.
    +
    +--> GREEN
    + ans  =
    +
    +    2.
    +
    +
    + +

    39.3.6 Pointers

    + + +

    +Pointers are supported by SWIG. A pointer can be returned from a wrapped C/C++ function, stored in a Scilab variable, and used in input argument of another C/C++ function. +

    +

    +Also, thanks to the SWIG runtime which stores informations about types, pointer types are tracked between exchanges Scilab and the native code. Indeed pointer types are stored alongside the pointer adress. +A pointer is mapped to a Scilab structure (tlist), which contains as fields the pointer address and the pointer type (in fact a pointer to the type information structure in the SWIG runtime). +
    +Why a native pointer is not mapped to a Scilab pointer (type name: "pointer", type ID: 128) ? The big advantage of mapping to a tlist is that it exposes a new type for the pointer in Scilab, type which can be acessed in Scilab with the typeof function, and manipulated using the overloading mechanism. +

    + +

    +Notes: +

    +
      +
    • type tracking needs the SWIG runtime to be first initialized with the appropriate function (see the Module initialization section).
    • +
    • for any reason, if a wrapped pointer type is unknown (or if the SWIG runtime is not initialized), SWIG maps it to a Scilab pointer. Also, a Scilab pointer is always accepted as a pointer argument of a wrapped function. The drawaback is that pointer type is lost.
    • +
    + +

    +Following is an example of the wrapping of the C FILE* pointer: +

    + +
    +%module example
    +
    +%{
    +#include <stdio.h>
    +%}
    +
    +FILE *fopen(const char *filename, const char *mode);
    +int fputs(const char *, FILE *);
    +int fclose(FILE *);
    +
    + +

    +These functions can be used the same way as in C from Scilab: +

    + +
    +--> example_Init();
    +
    +--> f = fopen("junk", "w");
    +--> typeof(f)
    + ans  =
    +
    +  _p_FILE
    +
    +--> fputs("Hello World", f);
    +--> fclose(f);
    +
    + +

    +Note: the type name _p_FILE which means "pointer to FILE". +

    + +

    +The user of a pointer is responsible for freeing it or, like in the example, closing any resources associated with it (just as is required in a C program). +

    + +

    39.3.6.1 Utility functions

    + + +

    +As a scripting language, Scilab does not provide functions to manipulate pointers. +However, in some cases it can be useful, such as for testing or debugging. +

    + +

    +SWIG comes with two pointer utility functions: +

    +
      +
    • SWIG_this(): returns the address value of a pointer
    • +
    • SWIG_ptr(): creates a pointer from an address value
    • +
    + +

    +Note: a pointer created by SWIG_ptr() does not have any type and is mapped as a Scilab pointer. +

    + +

    Following we use the utility functions on the previous example:

    + +
    +--> f = fopen("junk", "w");
    +--> fputs("Hello", f);
    +--> addr = SWIG_this(f)
    + ans  =
    +
    +    8219088.
    +
    +--> p = SWIG_ptr(addr);
    +--> typeof(p)
    +ans  =
    +
    +  pointer
    +
    +--> fputs(" World", p);
    +--> fclose(f);
    +
    + + +

    39.3.6.2 Null pointers:

    + + +

    +Using the previous SWIG_this() and SWIG_ptr(), it is possible to create and check null pointers: +

    + +
    +--> p = SWIG_ptr(0);
    +--> SWIG_this(p) == 0
    + ans  =
    +
    +    T
    +
    + + +

    39.3.7 Structures

    + + +

    +Structs exist in Scilab, but C structs are not (at least in this version of SWIG) mapped to Scilab structs. +A C structure is wrapped through low-level accessor functions, i.e. functions that give access to the member variables of this structure. +In Scilab, a structure is manipulated through a pointer which is passed as an argument to the accessor functions. +

    + +

    +Let's see it on an example of a struct with two members: +

    + +
    +%module example
    +
    +%inline %{
    +
    +typedef struct {
    +    int x;
    +    int arr[4];
    +} Foo;
    +
    +%}
    +
    + +

    +Several functions are generated: +

    +
      +
    • a constructor function new_Foo() which returns a pointer to a newly created struct Foo.
    • +
    • two member getter functions Foo_x_get(), Foo_arr_get(), to get the values of x and y for the struct pointer (provided as the first parameter to these functions)
    • +
    • two member setter functions Foo_x_set(), Foo_arr_set(), to set the values of x and y for the struct pointer (provided as the first parameter to these functions).
    • +
    • a destructor function delete_Foo() to release the struct pointer.
    • +
    + + +

    +Usage example: +

    + +
    +--> f = new_Foo();
    +--> Foo_x_set(f, 100);
    +--> Foo_x_get(f)
    +ans  =
    +
    +    100.
    +
    +--> Foo_arr_set(f, [0:3]);
    +--> Foo_arr_get(f)
    +ans  =
    +
    +    0.    1.    2.    3.
    +
    +--> delete_Foo(f);
    +
    + + +

    +Members of a structure that are also structures are also accepted and wrapped as a pointer: +

    + +
    +%module example
    +
    +%inline %{
    +
    +typedef struct {
    +  int x;
    +} Bar;
    +
    +typedef struct {
    +  Bar b;
    +} Foo;
    +
    +%}
    +
    + +
    + +
    +--> b = new_Bar();
    +--> Bar_x_set(b, 20.);
    +
    +--> f = new_Foo();
    +--> Foo_b_set(f, b);
    +
    +--> b2 = Foo_b_get(f);
    +--> Bar_x_get(b2);
    +ans  =
    +
    +    20.
    +
    + +

    +Note: the pointer to the struct works as described in Pointers. For example, the type of the struct pointer can be get with typeof, as following: +

    + +
    +--> example_Init();
    +--> b = new_Bar();
    +--> typeof(b)
    + ans  =
    +
    +    _p_Bar
    +--> delete_Bar(b);
    +
    + +

    39.3.8 C++ classes

    + + +

    +Classes do not exist in Scilab. The classes are wrapped the same way as structs. +Low-level accessor functions are generated for class members. +Also, constructor and destructor functions are generated to create and destroy an instance of the class. +

    + +

    +For example, the following class: +

    + +
    +%module example
    +
    +%inline %{
    +
    +class Point {
    +public:
    +  int x, y;
    +  Point(int _x, int _y) : x(_x), y(_y) {}
    +  double distance(const Point& rhs) {
    +    return sqrt(pow(x-rhs.x, 2) + pow(y-rhs.y, 2));
    +  }
    +  void set(int _x, int _y) {
    +    x=_x;
    +    y=_y;
    +  }
    +};
    +
    +%}
    +
    + +

    +can be used in Scilab like this: +

    + +
    +--> p1 = Point_new(3, 5);
    +--> p2 = Point_new(1, 2);
    +--> p1.distance(p2)
    +ans  =
    +
    +    3.6056
    +
    +--> delete_Point(p1);
    +--> delete_Point(p2);
    +
    + +

    +Note: like structs, class pointers are mapped as described in Pointers. Let's give an example which shows that each class pointer type is a new type in Scilab that can be used for example (through overloading) to implement a custom print for the Point class: +

    + +
    +--> function %_p_Point_p(p)
    +-->     mprintf('[%d, %d]\n', Point_x_get(p), Point_y_get(p));
    +--> endfunction
    +
    +--> example_Init();
    +--> p = new_Point(1, 2)
    + p  =
    +
    +[1, 2]
    +
    +--> delete_Point(p);
    +
    + +

    39.3.9 C++ inheritance

    + + +

    +Inheritance is supported. SWIG knows the inheritance relationship between classes. +

    + +

    +A function is only generated for the class in which it is actually declared. +But if one of its parameters is a class, any instance of a derived class is accepted as the argument. +

    + +

    +This mechanism also applies for accessor functions: they are generated only in the class in which they are defined. +But any instance of a derived class can be used as the argument to these accessor functions. +

    + +

    +For example, let's take a base class Shape and two derived classes Circle and Square: +

    + +
    +%module example
    +
    +%inline %{
    +
    +class Shape {
    +public:
    +  double x, y;
    +  void set_location(double _x, double _y) { x = _x; y = _y; }
    +  virtual double get_perimeter() { return 0; };
    +};
    +
    +class Circle : public Shape {
    +public:
    +  int radius;
    +  Circle(int _radius): radius(_radius) {};
    +  virtual double get_perimeter() { return 6.28 * radius; }
    +};
    +
    +class Square : public Shape {
    +public:
    +  int size;
    +  Square(int _size): size(_size) {};
    +  virtual double get_perimeter() { return 4 * size; }
    +};
    +
    +%}
    +
    + +

    +To set the location of the Circle, we have to use the function set_location() of the parent Shape. +But we can use either use the get_perimeter() function of the parent class or the derived class: +

    + +
    +--> c = new_Circle(3);
    +
    +--> Shape_set_location(c, 2, 3);
    +--> Shape_x_get(c)
    + ans  =
    +
    +    2.
    +
    +--> Circle_get_perimeter(c)
    + ans  =
    +
    +    18.84
    +
    +--> Shape_get_perimeter(c)
    + ans  =
    +
    +    18.84
    +
    + +

    39.3.10 C++ overloading

    + + +

    +As explained in 6.15 SWIG provides support for overloaded functions and constructors. +

    + +

    As SWIG knows pointer types, the overloading works also with pointer types, here is is an example with a function magnify overloaded for the previous classes Shape and Circle: +

    + +
    +%module example
    +
    +void magnify(Square *square, double factor) {
    +    square->size *= factor;
    +};
    +
    +void magnify(Circle *circle, double factor) {
    +    square->radius *= factor;
    +};
    +
    + +
    +--> example_Init();
    +--> c = new_Circle(3);
    +--> s = new_Square(2);
    +
    +--> magnify(c, 10);
    +--> Circle_get_radius(c)
    + ans  =
    +
    +   30;
    +--> magnify(s, 10);
    +--> Square_get_size(s)
    + ans  =
    +
    +   20;
    +
    + + +

    39.3.11 Pointers, references, values, and arrays

    + + +

    +In C++ objects can be passed by value, pointer, reference, or by an array: +

    +
    +%module example
    +
    +%{
    +#include <sciprint.h>
    +%}
    +
    +%inline %{
    +
    +class Foo {
    +public:
    +  Foo(int _x) : x(_x) {}
    +  int x;
    +};
    +
    +void spam1(Foo *f)  { sciprint("%d\n", f->x); }   // Pass by pointer
    +void spam2(Foo &f)  { sciprint("%d\n", f.x); }    // Pass by reference
    +void spam3(Foo f)   { sciprint("%d\n", f.x); }    // Pass by value
    +void spam4(Foo f[]) { sciprint("%d\n", f[0].x); } // Array of objects
    +
    +%}
    +
    +

    + +In SWIG, there is no real distinction between these. +So in Scilab, it is perfectly legal to do this: +

    +
    +--> f = new_Foo()
    +--> spam1(f)
    +3
    +--> spam2(f)
    +3
    +--> spam3(f)
    +3
    +--> spam4(f)
    +3
    +
    + +

    +Similar behaviour occurs for return values. For example, if you had functions like this: +

    +
    +Foo *spam5();
    +Foo &spam6();
    +Foo  spam7();
    +
    +

    +All these functions will return a pointer to an instance of Foo. +As the function spam7 returns a value, new instance of Foo has to be allocated, and a pointer on this instance is returned. +

    + +

    39.3.12 C++ templates

    + + +

    +As in other languages, function and class templates are supported in SWIG Scilab. +

    + +

    +You have to tell SWIG to create wrappers for a particular template instantiation. The %template directive is used for this purpose. +For example: +

    + +
    +%module example
    +
    +template<class T1, class T2, class T3>
    +struct triplet {
    +  T1 first;
    +  T2 second;
    +  T3 third;
    +  triplet(const T1& a, const T2& b, const T3& c) {
    +    third = a; second = b; third = c;
    +  }
    +};
    +
    +%template(IntTriplet) triplet<int,int,int>;
    +
    + +

    +Then in Scilab: +

    + +
    +
    +--> t = new_IntTriplet(3, 4, 1);
    +
    +--> IntTriplet_first_get(t)
    + ans  =
    +
    +    3.
    +
    +--> IntTriplet_second_get(t)
    + ans  =
    +
    +    4.
    +
    +--> IntTriplet_third_get(t)
    + ans  =
    +
    +    1.
    +
    +--> delete_IntTriplet(t);
    +
    +
    + +

    +More details on template support can be found in the templates documentation. +

    + +

    39.3.13 C++ operators

    + + +

    +C++ operators are partially supported. +Operator overloading exists in Scilab, but a C++ operator is not (in this version) wrapped by SWIG as a Scilab operator, but as a function. +It is not automatic, you have to rename each operator (with the instruction %rename) with the suitable wrapper name. +

    + +

    +Let's see it with an example of class with two operators + and double(): +

    + +
    +%module example
    +
    +%rename(plus) operator +;
    +%rename(toDouble) operator double();
    +
    +%inline %{
    +
    +class Complex {
    +public:
    +  Complex(double re, double im) : real(re), imag(im) {};
    +
    +  Complex operator+(const Complex& other) {
    +    double result_real = real + other.real;
    +    double result_imaginary = imag + other.imag;
    +    return Complex(result_real, result_imaginary);
    +  }
    +  operator double() { return real; }
    +private:
    +  double real;
    +  double imag;
    +};
    +
    +%}
    +
    + +
    + +
    +--> c1 = new_Complex(3, 7);
    +
    +--> c2 = Complex_plus(c, new_Complex(1,1));
    +
    +--> Complex_toDouble(c2)
    + ans  =
    +
    +    4.
    +
    + + +

    39.3.14 C++ namespaces

    + + +

    +SWIG is aware of C++ namespaces, but does not use it for wrappers. +The module is not broken into submodules, nor do namespace appear in functions names. +All the namespaces are all flattened in the module. +For example with one namespace Foo: +

    + +
    +
    +%module example
    +
    +%inline %{
    +
    +namespace foo {
    +  int fact(int n) {
    +    if (n > 1)
    +      return n * fact(n-1);
    +    else
    +      return 1;
    +  }
    +
    +  struct Vector {
    +    double x,y,z;
    +  };
    +};
    +
    +%}
    +
    +
    +
    + +

    +In Scilab, there is no need to the specify the Foo namespace: +

    + +
    +
    +--> fact(3)
    + ans  =
    +
    +   6.
    +
    +--> v = new_Vector();
    +--> Vector_x_set(v, 3.4);
    +--> Vector_y_get(v)
    + ans  =
    +
    +   0.
    +
    +
    + +

    +If your program has more than one namespace, name conflicts can be resolved using %rename. +For example: +

    + +
    +
    +%rename(Bar_spam) Bar::spam;
    +
    +namespace Foo {
    +  int spam();
    +}
    +
    +namespace Bar {
    +  int spam();
    +}
    +
    +
    + +

    +Note: the nspace feature is not supported. +

    + + +

    39.3.15 C++ exceptions

    + + +

    +Scilab does not natively support exceptions, but has errors. +When an exception is thrown, SWIG catches it, and sets a Scilab error. An error message is displayed in Scilab. +For example: +

    + +
    +%module example
    +
    +%inline %{
    +void throw_exception() throw(char const *) {
    +  throw "Bye world !";
    +}
    +%}
    +
    + +
    + +
    +-->throw_exception()
    +  !--error 999
    +SWIG/Scilab: Exception (char const *) occured: Bye world !
    +
    + +

    +Scilab has a try-catch mechanism (and a similar instruction execstr()) to handle exceptions. +It can be used with the lasterror() function as following: +

    + +
    +--> execstr('throw_exception()', 'errcatch');
    + ans  =
    +
    +    999.
    +
    +--> lasterror()
    + ans  =
    +
    +    SWIG/Scilab: Exception (char const *) occured: Bye world !
    +
    + +

    +If the function has a throw exception specification, SWIG can automatically map the exception type and set an appropriate Scilab error message. +It works for a few primitive types, and also for STL exceptions (the library std_except.i has to be included to get the STL exception support): +

    + +
    +%module example
    +
    +%include <std_except.i>
    +
    +%inline %{
    +void throw_int() throw(int) {
    +  throw 12;
    +}
    +
    +void throw_stl_invalid_arg(int i) throw(std::invalid_argument) {
    +  if (i < 0)
    +    throw std::invalid_argument("argument is negative.");
    +}
    +%}
    +
    + +
    + +
    +--> throw_int();
    +            !--error 999
    +SWIG/Scilab: Exception (int) occured: 12
    +
    +-->throw_stl_invalid_arg(-1);
    +                          !--error 999
    +SWIG/Scilab: ValueError: argument is negative.
    +
    + +

    +More complex or custom exception types require specific exception typemaps to be implemented in order to specifically handle a thrown type. +See the SWIG C++ documentation for more details. +

    + +

    39.3.16 C++ STL

    + + +

    +The Standard Template Library (STL) is partially supported. See STL for more details. +

    + +

    39.4 Type mappings and libraries

    + + +

    39.4.1 Default primitive type mappings

    + + +

    +The following table provides the equivalent Scilab type for C/C++ primitive types. +

    + +
    + + + + + + + + + + + + + + + + + + + + +
    C/C++ typeScilab type
    boolboolean
    charstring
    signed chardouble or int8
    unsigned chardouble or uint8
    shortdouble or int16
    unsigned shortdouble or uint16
    intdouble or int32
    unsigned intdouble or uint32
    longdouble or int32
    unsigned longdouble or uint32
    signed long longnot supported in Scilab 5.x
    unsigned long longnot supported in Scilab 5.x
    floatdouble
    doubledouble
    char * or char[]string
    +
    + +

    +Notes: +

    +
      +
    • In Scilab the double type is far more used than any integer type. +This is why integer values (int32, uint32, ...) are automatically converted to Scilab double values when marshalled from C into Scilab. +Additionally on input to a C function, Scilab double values are converted into the related integer type. +
    • +
    • +When an integer is expected, if the input is a double, the value must be an integer, i.e. it must not have any decimal part, otherwise a SWIG value error occurs. +
    • +
    • +In SWIG for Scilab 5.x, the long long type is not supported, since Scilab 5.x does not have a 64-bit integer type. +The default behaviour is for SWIG to generate code that will give a runtime error if long long type arguments are used from Scilab. +
    • +
    + + + + +

    39.4.2 Arrays

    + + +

    +Typemaps are available by default for arrays. Primitive type arrays are automatically converted to/from Scilab matrices. +Typemaps are also provided to handle members of a struct or class that are arrays. +

    + +

    +In input, the matrix is usually one-dimensional (it can be either a row or column vector). But it can also be a two-dimensional matrix. +Warning: in Scilab, the values are column-major ordered, unlike in C, which is row-major ordered. +

    + +

    +The type mappings used for arrays is the same for primitive types, described earlier. +This means that, if needed, a Scilab double vector is converted in input into the related C integer array +and this C integer array is automatically converted on output into a Scilab double vector. +Note that unlike scalars, no control is done for arrays when a double is converted into an integer. +

    + +

    +The following example illustrates all this:

    + +
    +%module example
    +
    +%#include <stdio.h>
    +
    +%inline %{
    +
    +void printArray(int values[], int len) {
    +  int i = 0;
    +  for (i = 0; i < len; i++) {
    +    printf("%s %d %s", i==0?"[":"", values[i], i==len-1?"]\n":"");
    +  }
    +}
    +%}
    +
    + +
    + +
    +--> printArray([0 1 2 3], 4)
    +[ 0  1  2  3 ]
    +
    +--> printArray([0.2; -1.8; 2; 3.7], 4)
    +[ 0  -1  2  3 ]
    +
    +--> printArray([0 1; 2 3], 4)
    +[ 0  2  1  3 ]
    +
    +--> printArray([0; 1; 2; 3], 4)
    +[ 0  1  2  3 ]
    +
    + +

    39.4.3 Pointer-to-pointers

    + + +

    +There are no specific typemaps for pointer-to-pointers, they are are mapped as pointers in Scilab. +

    + +

    +Pointer-to-pointers are sometimes used to implement matrices in C. The following is a an example of this: +

    + + +
    +%module example
    +%inline %{
    +
    +// Returns the matrix [1 2; 3 4];
    +double **create_matrix() {
    +  double **M;
    +  int i;
    +  M = (double **) malloc(2 * sizeof(double *));
    +  for (i = 0; i < 2; i++) {
    +    M[i] = (double *) malloc(2 * sizeof(double));
    +    M[i][0] = 2 * i + 1;
    +    M[i][1] = 2 * i + 2;
    +  }
    +  return M;
    +}
    +
    +// Gets the item M(i,j) value
    +double get_matrix(double **M, int i, int j) {
    +  return M[i][j];
    +}
    +
    +// Sets the item M(i,j) value to be val
    +void set_matrix(double **M, int i, int j, double val) {
    +  M[i][j] = val;
    +}
    +
    +// Prints a matrix (2,2) to console
    +void print_matrix(double **M, int nbRows, int nbCols) {
    +  int i, j;
    +  for (i = 0; i < 2; i++) {
    +    for (j = 0; j < 2; j++) {
    +      printf("%3g ", M[i][j]);
    +    }
    +    printf("\n");
    +  }
    +}
    +
    +%}
    +
    + +

    + These functions are used like this in Scilab: +

    + +
    +--> m = create_matrix();
    +
    +--> print_matrix(m);
    +   1.   2.
    +   3.   4.
    +
    +--> set_matrix(m, 1, 1, 5.);
    +
    +--> get_matrix(m, 1, 1)
    + ans  =
    +
    +    5.
    +
    + + +

    39.4.4 Matrices

    + + +

    +The matrix.i library provides a set of typemaps which can be useful when working with one-dimensional and two-dimensional matrices. +

    + +

    +In order to use this library, just include it in the interface file: +

    + +
    +  %include <matrix.i>
    +
    + + +

    +Several typemaps are available for the common Scilab matrix types: +

    +
      +
    • double
    • +
    • int
    • +
    • char *
    • +
    • bool
    • +
    + +

    +For example: for a matrix of int, we have the typemaps, for input: +

    +
      +
    • (int *IN, int IN_ROWCOUNT, int IN_COLCOUNT)
    • +
    • (int IN_ROWCOUNT, int IN_COLCOUNT, int *IN)
    • +
    • (int *IN, int IN_SIZE)
    • +
    • (int IN_SIZE, int *IN)
    • +
    + +

    +and output: +

    +
      +
    • (int **OUT, int *OUT_ROWCOUNT, int *OUT_COLCOUNT)
    • +
    • (int *OUT_ROWCOUNT, int *OUT_COLCOUNT, int **OUT)
    • +
    • (int **OUT, int *OUT_SIZE)
    • +
    • (int *OUT_SIZE, int **OUT)
    • +
    + +

    +They marshall a Scilab matrix type into the appropriate 2 or 3 C parameters. +The following is an example using the typemaps in this library: +

    + +
    +%module example
    +
    +%include <matrix.i>
    +
    +%apply (int *IN, int IN_ROWCOUNT, int IN_COLCOUNT) { (int *matrix, int matrixNbRow, int matrixNbCol) };
    +%apply (int **OUT, int *OUT_ROWCOUNT, int *OUT_COLCOUNT) { (int **outMatrix, int *outMatrixNbRow, int *outMatrixNbCol) };
    +
    +%inline %{
    +
    +void absolute(int *matrix, int matrixNbRow, int matrixNbCol,
    +  int **outMatrix, int *outMatrixNbRow, int *outMatrixNbCol) {
    +  int i, j;
    +  *outMatrixNbRow = matrixNbRow;
    +  *outMatrixNbCol = matrixNbCol;
    +  *outMatrix = malloc(matrixNbRow * matrixNbCol * sizeof(int));
    +  for (i=0; i < matrixNbRow * matrixNbCol; i++) {
    +    (*outMatrix)[i] = matrix[i] > 0 ? matrix[i]:-matrix[i];
    +  }
    +}
    +
    +%}
    +
    + +
    + +
    +--> absolute([-0 1 -2; 3 4 -5])
    + ans  =
    +
    +    0.    1.    2.
    +    3.    4.    5.
    +
    + +

    +The remarks made earlier for arrays also apply here: +

    +
      +
    • The values of matrices in Scilab are column-major orderered,
    • +
    • There is no control while converting double values to integers, double values are truncated without any checking or warning.
    • +
    + +

    39.4.5 STL

    + + +

    +The STL library wraps some containers defined in the STL (Standard Template Library), so that they can be manipulated in Scilab. +This library also provides the appropriate typemaps to use the containers in functions and variables. +

    + +

    +The list of wrapped sequence containers are: +

    +
      +
    • std::vector
    • +
    • std::list
    • +
    • std::deque
    • +
    + +

    +And associative containers are: +

    +
      +
    • std::set
    • +
    • std::multiset
    • +
    + +

    +Typemaps are available for the following container types: +

    + +
      +
    • double
    • +
    • float
    • +
    • int
    • +
    • string
    • +
    • bool
    • +
    • pointer
    • +
    + +

    +Containers of other item types are not supported. Using them does not break compilation, but provokes a runtime error. +Containers of enum are not supported yet. +

    + +

    +In order to use the STL, the library must first be included in the SWIG interface file: +

    + +
    +%include <stl.i>
    +
    + +

    Then for each container used, the appropriate template must be instantiated, in the std namespace: +

    +namespace std {
    +    %template(IntVector)    vector<int>;
    +    %template(DoubleVector) vector<double>;
    +}
    +
    + +

    +Additionally, the module initialization function has to be executed first in Scilab, so that all the types are known to Scilab. +See the Module initialization section for more details. +

    + + +

    +Because in Scilab matrices exist for basic types only, a sequence container of pointers is mapped to a Scilab list. +For other item types (double, int, string...) the sequence container is mapped to a Scilab matrix. +

    + +

    +The first example below shows how to create a vector (of int) in Scilab, add some values to the vector and pass it as an argument of a function. +It also shows, thanks to the typemaps, that we can also pass a Scilab matrix of values directly into the function: +

    + +
    +%module example
    +
    +%include <stl.i>
    +
    +namespace std {
    +  %template(IntVector) vector<int>;
    +}
    +
    +%{
    +#include <numeric>
    +%}
    +
    +%inline %{
    +
    +double average(std::vector<int> v) {
    +  return std::accumulate(v.begin(), v.end(), 0.0) / v.size();
    +}
    +
    +%}
    +
    + +
    + +
    +--> example_Init();
    +
    +--> v = new_IntVector();
    +
    +--> for i = 1:4
    +-->     IntVector_push_back(v, i);
    +--> end;
    +
    +--> average(v)
    + ans  =
    +
    +    2.5
    +
    +--> average([0 1 2 3])
    + ans  =
    +
    +    2.5
    +
    +--> delete_IntVector();
    +
    + + +

    +In the second example, a set of struct (Person) is wrapped. +A function performs a search in this set, and returns a subset. As one can see, the result in Scilab is a list of pointers: +

    + +
    +%module example
    +
    +%include <stl.i>
    +
    +%{
    +#include <string>
    +%}
    +
    +%inline %{
    +
    +struct Person {
    +  Person(std::string _name, int _age) : name(_name), age(_age) {};
    +  std::string name;
    +  int age;
    +};
    +typedef Person * PersonPtr;
    +
    +%}
    +
    +namespace std {
    +  %template(PersonPtrSet) set<PersonPtr>;
    +}
    +
    +%inline %{
    +
    +std::set<PersonPtr> findPersonsByAge(std::set<PersonPtr> persons, int minAge, int maxAge) {
    +  std::set<PersonPtr> foundPersons;
    +  for (std::set<PersonPtr>::iterator it = persons.begin(); it != persons.end(); it++) {
    +    if (((*it)->age >= minAge) && ((*it)->age <= maxAge)) {
    +      foundPersons.insert(*it);
    +    }
    +  }
    +  return foundPersons;
    +}
    +
    +%}
    +
    + +
    + +
    +--> example_Init();
    +
    +--> joe = new_Person("Joe", 25);
    +--> susan = new_Person("Susan", 32);
    +--> bill = new_Person("Bill", 50);
    +
    +--> p = new_PersonPtrSet();
    +--> PersonPtrSet_insert(p, susan);
    +--> PersonPtrSet_insert(p, joe);
    +--> PersonPtrSet_insert(p, bill);
    +
    +--> l = findPersonsByAge(p, 20, 40);
    +
    +--> size(l)
    + ans  =
    +
    +    2.
    +
    +--> Person_name_get(l(1))
    +ans  =
    +
    +    Susan
    +
    +--> Person_name_get(l(2))
    + ans  =
    +
    +    Joe
    +
    +--> delete_PersonPtrSet(p);
    +
    + +

    39.5 Module initialization

    + + +

    +The wrapped module contains an initialization function to: +

    +
      +
    • initialize the SWIG runtime, needed for pointer type tracking or when working with the STL
    • +
    • initialize the module constants and enumerations declared with %scilabconst()
    • +
    + +

    +This initialization function should be executed at the start of a script, before the wrapped library has to be used. +

    + +

    +The function has the name of the module suffixed by _Init. +For example, to initialize the module example: +

    + +
    +--> example_Init();
    +
    + +

    39.6 Building modes

    + + +

    +The mechanism to load an external module in Scilab is called Dynamic Link and works with dynamic modules (or shared libraries, .so files). +

    + +

    +To produce a dynamic module, when generating the wrapper, there are two possibilities, or build modes: +

    +
      +
    • the nobuilder mode, this is the default mode in SWIG. The user is responsible of the build. +
    • the builder mode. In this mode, Scilab is responsible of building. +
    + +

    39.6.1 No-builder mode

    + + +

    +In this mode, used by default, SWIG generates the wrapper sources, which have to be manually compiled and linked. +A loader script loader.sce is also produced, this one is executed further in Scilab to load the module. +

    + +

    +This mode is the best option to use when you have to integrate the module build into a larger build process. +

    + + +

    39.6.2 Builder mode

    + + +

    +In this mode, in addition to the wrapper sources, SWIG produces a builder Scilab script (builder.sce), which is executed in Scilab to build the module. +In a few words, the Scilab ilib_build() command is used, which produces the shared library file, and the loader script loader.sce (and also a cleaner script cleaner.sce). +

    + +

    +An advantage of this mode is that it hides all the complexity of the build and other platform issues. +Also it allows the module to conform to a Scilab external module convention which is that an external module should be simply built by calling a builder script. +

    + +

    +The builder mode is activated with the -builder SWIG option. +In this mode, the following SWIG options may be used to setup the build: +

    + +
      +
    • -buildersources: to add sources to the build (several files must be separated by a comma)
    • +
    • -buildercflags: to add flags to the builder compiler flags, for example to set library dependencies include paths
    • +
    • -builderldflags: to add flags to the linker flags, for example to set library dependency names and paths
    • +
    + +

    +Let's give an example how to build a module example, composed of two sources, and using a library dependency: +

    +
      +
    • the sources are baa1.c and baa2.c (and are stored in in the current directory)
    • +
    • the library is libfoo in /opt/foo (headers stored in /opt/foo/include, and shared library in /opt/foo/lib)
    • +
    + +

    +The command is: +

    + +
    +$ swig -scilab -builder -buildercflags -I/opt/foo/include -builderldflags "-L/opt/foo/lib -lfoo" -buildersources baa1.cxx,baa2.cxx example.i
    +
    + +

    39.7 Generated scripts

    + + +

    +In this part we give some details about the generated Scilab scripts. +

    + +

    39.7.1 Builder script

    + + +

    +builder.sce is the name of the builder script generated by SWIG in builder mode. It contains code like this: +

    +
    +ilib_name = "examplelib";
    +files = ["example_wrap.c"];
    +libs = [];
    +table = ["fact","_wrap_fact";"Foo_set","_wrap_Foo_set";"Foo_get","_wrap_Foo_get";];
    +ilib_build(ilib_name,table,files,libs);
    +
    + +

    +ilib_build(lib_name,table,files,libs) is used to create shared libraries, and to generate a loader file used to dynamically load the shared library into Scilab. +

    + +
      +
    • ilib_name: a character string, the generic name of the library without path and extension.
    • +
    • files: string matrix containing objects files needed for shared library creation.
    • +
    • libs: string matrix containing extra libraries needed for shared library creation.
    • +
    • table: two column string matrix containing a table of pairs of 'scilab function name', 'C function name'.
    • +
    + +

    39.7.2 Loader script

    + + +

    +The loader script is used to load in Scilab all the module functions. When loaded, these functions can be used as other Scilab functions. +

    + +

    +The loader script loader.sce contains code similar to: +

    + +
    +// ------------------------------------------------------
    +// generated by builder.sce: Please do not edit this file
    +// ------------------------------------------------------
    +
    +libexamplelib_path = get_file_path('loader.sce');
    +list_functions = [             'fact';
    +            'Foo_set';
    +            'Foo_get';
    +];
    +addinter(libexamplelib_path+'/libexamplelib.so','libexamplelib',list_functions);
    +// remove temp. variables on stack
    +clear libexamplelib_path;
    +clear list_functions;
    +clear get_file_path;
    +// ------------------------------------------------------
    +
    + +

    +addinter(files,spname,fcts) performs dynamic linking of a compiled C interface function. +

    +
      +
    • files: a character string or a vector of character strings defining the object files (containing the C interface functions) to link with.
    • +
    • spname: a character string. Name of interface routine entry point.
    • +
    • fcts: vector of character strings. The name of new Scilab function.
    • +
    + + +

    39.8 Other resources

    + + +
      +
    • Example use cases can be found in the Examples/scilab directory.
    • +
    • The test suite in the Examples/test-suite/scilab can be another source of useful use cases.
    • +
    • The Scilab API is used in the generated code and is a useful reference when examining the output.
    • +
    • This guide describes the Scilab external modules structure and files, in particular the files that are generated by SWIG for Scilab.
    • +
    + diff --git a/Doc/Manual/Scripting.html b/Doc/Manual/Scripting.html index e6a2eee..18af78a 100644 --- a/Doc/Manual/Scripting.html +++ b/Doc/Manual/Scripting.html @@ -1,12 +1,13 @@ - + Scripting Languages + -

    4 Scripting Languages

    +

    4 Scripting Languages

      @@ -37,7 +38,7 @@ programming and the mechanisms by which scripting language interpreters access C and C++ code.

      -

      4.1 The two language view of the world

      +

      4.1 The two language view of the world

      @@ -68,7 +69,7 @@ languages can be used for rapid prototyping, interactive debugging, scripting, and access to high-level data structures such associative arrays.

      -

      4.2 How does a scripting language talk to C?

      +

      4.2 How does a scripting language talk to C?

      @@ -93,7 +94,7 @@ function, arguments, and so forth. The next few sections illustrate the process.

      -

      4.2.1 Wrapper functions

      +

      4.2.1 Wrapper functions

      @@ -101,8 +102,10 @@ Suppose you have an ordinary C function like this :

       int fact(int n) {
      -	if (n <= 1) return 1;
      -	else return n*fact(n-1);
      +  if (n <= 1)
      +    return 1;
      +  else
      +    return n*fact(n-1);
       }
       
      @@ -123,18 +126,17 @@ As an example, the Tcl wrapper function for the fact() function above example might look like the following :

      -int wrap_fact(ClientData clientData, Tcl_Interp *interp,
      -		int argc, char *argv[]) {
      -	int result;
      -	int arg0;
      -	if (argc != 2) {
      -		interp->result = "wrong # args";
      -		return TCL_ERROR;
      -	}
      -	arg0 = atoi(argv[1]);
      -	result = fact(arg0);
      -	sprintf(interp->result,"%d", result);
      -	return TCL_OK;
      +int wrap_fact(ClientData clientData, Tcl_Interp *interp, int argc, char *argv[]) {
      +  int result;
      +  int arg0;
      +  if (argc != 2) {
      +    interp->result = "wrong # args";
      +    return TCL_ERROR;
      +  }
      +  arg0 = atoi(argv[1]);
      +  result = fact(arg0);
      +  sprintf(interp->result,"%d", result);
      +  return TCL_OK;
       }
       
       
      @@ -148,9 +150,9 @@ requires code like the following :

       int Wrap_Init(Tcl_Interp *interp) {
      -	Tcl_CreateCommand(interp, "fact", wrap_fact, (ClientData) NULL,
      -				(Tcl_CmdDeleteProc *) NULL);
      -	return TCL_OK;
      +  Tcl_CreateCommand(interp, "fact", wrap_fact, (ClientData) NULL,
      +                    (Tcl_CmdDeleteProc *) NULL);
      +  return TCL_OK;
       }
       
      @@ -165,7 +167,7 @@ Python. Both require special wrappers to be written and both need additional initialization code. Only the specific details are different.

      -

      4.2.2 Variable linking

      +

      4.2.2 Variable linking

      @@ -201,7 +203,7 @@ typing $Foo = 4 would call the underlying set function to change the value.

      -

      4.2.3 Constants

      +

      4.2.3 Constants

      @@ -222,7 +224,7 @@ functions for creating variables so installing constants is usually a trivial exercise.

      -

      4.2.4 Structures and classes

      +

      4.2.4 Structures and classes

      @@ -243,9 +245,9 @@ representation of a structure. For example,

       struct Vector {
      -	Vector();
      -	~Vector();
      -	double x,y,z;
      +  Vector();
      +  ~Vector();
      +  double x,y,z;
       };
       
       
      @@ -283,7 +285,7 @@ internals of an object, the interpreter does not need to know anything about the actual representation of a Vector.

      -

      4.2.5 Proxy classes

      +

      4.2.5 Proxy classes

      @@ -293,14 +295,14 @@ A proxy class is a special kind of object that gets created in a scripting language to access a C/C++ class (or struct) in a way that looks like the original structure (that is, it proxies the real C++ class). For example, if you -have the following C definition :

      +have the following C++ definition :

       class Vector {
       public:
      -	Vector();
      -	~Vector();
      -	double x,y,z;
      +  Vector();
      +  ~Vector();
      +  double x,y,z;
       };
       
      @@ -334,18 +336,18 @@ Finally, in Tcl :
       Vector v
      -v configure -x 3 -y 4 -z 13
      +v configure -x 3 -y 4 -z -13
       
       

      -When proxy classes are used, two objects are at really work--one in +When proxy classes are used, two objects are really at work--one in the scripting language, and an underlying C/C++ object. Operations affect both objects equally and for all practical purposes, it appears as if you are simply manipulating a C/C++ object.

      -

      4.3 Building scripting language extensions

      +

      4.3 Building scripting language extensions

      @@ -353,32 +355,27 @@ The final step in using a scripting language with your C/C++ application is adding your extensions to the scripting language itself. There are two primary approaches for doing this. The preferred technique is to build a dynamically loadable -extension in the form a shared library. Alternatively, you can +extension in the form of a shared library. Alternatively, you can recompile the scripting language interpreter with your extensions added to it.

      -

      4.3.1 Shared libraries and dynamic loading

      +

      4.3.1 Shared libraries and dynamic loading

      To create a shared library or DLL, you often need to look at the manual pages for your compiler and linker. However, the procedure -for a few common machines is shown below:

      +for a few common platforms is shown below:

       # Build a shared library for Solaris
      -gcc -c example.c example_wrap.c -I/usr/local/include
      +gcc -fpic -c example.c example_wrap.c -I/usr/local/include
       ld -G example.o example_wrap.o -o example.so
       
       # Build a shared library for Linux
       gcc -fpic -c example.c example_wrap.c -I/usr/local/include
       gcc -shared example.o example_wrap.o -o example.so
      -
      -# Build a shared library for Irix
      -gcc -c example.c example_wrap.c -I/usr/local/include
      -ld -shared example.o example_wrap.o -o example.so
      -
       

      @@ -405,7 +402,7 @@ changing the link line to the following :

      c++ -shared example.o example_wrap.o -o example.so
    -

    4.3.2 Linking with shared libraries

    +

    4.3.2 Linking with shared libraries

    @@ -452,7 +449,7 @@ the path using linker options instead. -

    4.3.3 Static linking

    +

    4.3.3 Static linking

    diff --git a/Doc/Manual/Sections.html b/Doc/Manual/Sections.html index 9a9c0cc..0adc606 100644 --- a/Doc/Manual/Sections.html +++ b/Doc/Manual/Sections.html @@ -1,16 +1,19 @@ - + -SWIG-2.0 Documentation +SWIG-3.0 Documentation + -

    SWIG-2.0 Documentation

    +

    SWIG-3.0 Documentation

    -Last update : SWIG-2.0.12 (9 Feb 2014) +

    +Last update : SWIG-3.0.10 (12 Jun 2016) +

    -

    Sections

    +

    Sections

    -

    SWIG Core Documentation

    +

    SWIG Core Documentation

    -

    Language Module Documentation

    +

    Language Module Documentation

    -

    Developer Documentation

    +

    Developer Documentation

    • Extending SWIG
    • diff --git a/Doc/Manual/Tcl.html b/Doc/Manual/Tcl.html index e6b3b4a..31fae03 100644 --- a/Doc/Manual/Tcl.html +++ b/Doc/Manual/Tcl.html @@ -1,12 +1,13 @@ - + SWIG and Tcl + -

      37 SWIG and Tcl

      +

      40 SWIG and Tcl

        @@ -83,7 +84,7 @@ Tcl 8.0 or a later release. Earlier releases of SWIG supported Tcl 7.x, but this is no longer supported.

        -

        37.1 Preliminaries

        +

        40.1 Preliminaries

        @@ -109,7 +110,7 @@ build a Tcl extension module. To finish building the module, you need to compile this file and link it with the rest of your program.

        -

        37.1.1 Getting the right header files

        +

        40.1.1 Getting the right header files

        @@ -127,7 +128,7 @@ this is the case, you should probably make a symbolic link so that tcl.h -

        37.1.2 Compiling a dynamic module

        +

        40.1.2 Compiling a dynamic module

        @@ -139,8 +140,8 @@ using commands like this (shown for Linux):

         $ swig -tcl example.i
        -$ gcc -c example.c
        -$ gcc -c example_wrap.c -I/usr/local/include
        +$ gcc -fPIC -c example.c
        +$ gcc -fPIC -c example_wrap.c -I/usr/local/include
         $ gcc -shared example.o example_wrap.o -o example.so
         
        @@ -160,10 +161,10 @@ of the module. If the name of your SWIG module is "example", the name of the corresponding object file should be "example.so". The name of the module is specified using the %module directive or the - -module command line option. + -module command line option.

        -

        37.1.3 Static linking

        +

        40.1.3 Static linking

        @@ -207,8 +208,8 @@ $ swig -tcl example.i $ gcc example.c example_wrap.c \ -Xlinker -export-dynamic \ -DHAVE_CONFIG_H -I/usr/local/include/ \ - -L/usr/local/lib -ltcl -lm -ldl \ - -o mytclsh + -L/usr/local/lib -ltcl -lm -ldl \ + -o mytclsh

      @@ -229,7 +230,7 @@ minimal in most situations (and quite frankly not worth the extra hassle in the opinion of this author).

      -

      37.1.4 Using your module

      +

      40.1.4 Using your module

      @@ -357,7 +358,7 @@ to the default system configuration (this requires root access and you will need the man pages).

      -

      37.1.5 Compilation of C++ extensions

      +

      40.1.5 Compilation of C++ extensions

      @@ -374,8 +375,8 @@ compiler. For example:

       % swig -c++ -tcl example.i
      -% g++ -c example.cxx
      -% g++ -c example_wrap.cxx -I/usr/local/include
      +% g++ -fPIC -c example.cxx
      +% g++ -fPIC -c example_wrap.cxx -I/usr/local/include
       % g++ -shared example.o example_wrap.o -o example.so
       
      @@ -387,8 +388,8 @@ Solaris, you often need to add an extra library -lCrun like this:
       % swig -c++ -tcl example.i
      -% CC -c example.cxx
      -% CC -c example_wrap.cxx -I/usr/local/include
      +% CC -KPIC -c example.cxx
      +% CC -KPIC -c example_wrap.cxx -I/usr/local/include
       % CC -G example.o example_wrap.o -L/opt/SUNWspro/lib -o example.so -lCrun
       
      @@ -440,7 +441,7 @@ erratic program behavior. If working with lots of software components, you might want to investigate using a more formal standard such as COM.

      -

      37.1.6 Compiling for 64-bit platforms

      +

      40.1.6 Compiling for 64-bit platforms

      @@ -467,7 +468,7 @@ also introduce problems on platforms that support more than one linking standard (e.g., -o32 and -n32 on Irix).

      -

      37.1.7 Setting a package prefix

      +

      40.1.7 Setting a package prefix

      @@ -486,7 +487,7 @@ option will append the prefix to the name when creating a command and call it "Foo_bar".

      -

      37.1.8 Using namespaces

      +

      40.1.8 Using namespaces

      @@ -504,11 +505,11 @@ name, but you can override it using the -prefix option.

      -When the -namespace option is used, objects in the module +When the -namespace option is used, objects in the module are always accessed with the namespace name such as Foo::bar.

      -

      37.2 Building Tcl/Tk Extensions under Windows 95/NT

      +

      40.2 Building Tcl/Tk Extensions under Windows 95/NT

      @@ -519,7 +520,7 @@ covers the process of using SWIG with Microsoft Visual C++. although the procedure may be similar with other compilers.

      -

      37.2.1 Running SWIG from Developer Studio

      +

      40.2.1 Running SWIG from Developer Studio

      @@ -577,7 +578,7 @@ MSDOS > tclsh80 %

    -

    37.2.2 Using NMAKE

    +

    40.2.2 Using NMAKE

    @@ -625,11 +626,11 @@ CFLAGS = /Z7 /Od /c /nologo TCL_INCLUDES = -Id:\tcl8.0a2\generic -Id:\tcl8.0a2\win TCLLIB = d:\tcl8.0a2\win\tcl80.lib -tcl:: - ..\..\swig -tcl -o $(WRAPFILE) $(INTERFACE) - $(CC) $(CFLAGS) $(TCL_INCLUDES) $(SRCS) $(WRAPFILE) - set LIB=$(TOOLS)\lib - $(LINK) $(LOPT) -out:example.dll $(LIBS) $(TCLLIB) example.obj example_wrap.obj +tcl: + ..\..\swig -tcl -o $(WRAPFILE) $(INTERFACE) + $(CC) $(CFLAGS) $(TCL_INCLUDES) $(SRCS) $(WRAPFILE) + set LIB=$(TOOLS)\lib + $(LINK) $(LOPT) -out:example.dll $(LIBS) $(TCLLIB) example.obj example_wrap.obj @@ -640,7 +641,7 @@ to get you started. With a little practice, you'll be making lots of Tcl extensions.

    -

    37.3 A tour of basic C/C++ wrapping

    +

    40.3 A tour of basic C/C++ wrapping

    @@ -651,7 +652,7 @@ classes. This section briefly covers the essential aspects of this wrapping.

    -

    37.3.1 Modules

    +

    40.3.1 Modules

    @@ -685,7 +686,7 @@ To fix this, supply an extra argument to load like this: -

    37.3.2 Functions

    +

    40.3.2 Functions

    @@ -710,7 +711,7 @@ like you think it does: % -

    37.3.3 Global variables

    +

    40.3.3 Global variables

    @@ -790,7 +791,7 @@ extern char *path; // Read-only (due to %immutable) -

    37.3.4 Constants and enums

    +

    40.3.4 Constants and enums

    @@ -874,7 +875,7 @@ When an identifier name is given, it is used to perform an implicit hash-table l conversion. This allows the global statement to be omitted.

    -

    37.3.5 Pointers

    +

    40.3.5 Pointers

    @@ -970,7 +971,7 @@ C-style cast may return a bogus result whereas as the C++-style cast will return None if the conversion can't be performed.

    -

    37.3.6 Structures

    +

    40.3.6 Structures

    @@ -980,7 +981,7 @@ This provides a very natural interface. For example,

     struct Vector {
    -	double x,y,z;
    +  double x,y,z;
     };
     
     
    @@ -1252,7 +1253,7 @@ Note: Tcl only destroys the underlying object if it has ownership. See the memory management section that appears shortly.

    -

    37.3.7 C++ classes

    +

    40.3.7 C++ classes

    @@ -1283,7 +1284,7 @@ you can use it in Tcl like this: % x insert Lager % x get 1 Stout -% puts [l cget -length] +% puts [x cget -length] 3 % @@ -1319,7 +1320,7 @@ In Tcl, the static member is accessed as follows: -

    37.3.8 C++ inheritance

    +

    40.3.8 C++ inheritance

    @@ -1368,7 +1369,7 @@ For instance: It is safe to use multiple inheritance with SWIG.

    -

    37.3.9 Pointers, references, values, and arrays

    +

    40.3.9 Pointers, references, values, and arrays

    @@ -1422,7 +1423,7 @@ to hold the result and a pointer is returned (Tcl will release this memory when the return value is garbage collected).

    -

    37.3.10 C++ overloaded functions

    +

    40.3.10 C++ overloaded functions

    @@ -1545,7 +1546,7 @@ first declaration takes precedence. Please refer to the "SWIG and C++" chapter for more information about overloading.

    -

    37.3.11 C++ operators

    +

    40.3.11 C++ operators

    @@ -1647,7 +1648,7 @@ There are ways to make this operator appear as part of the class using the % Keep reading.

    -

    37.3.12 C++ namespaces

    +

    40.3.12 C++ namespaces

    @@ -1711,7 +1712,7 @@ utilizes thousands of small deeply nested namespaces each with identical symbol names, well, then you get what you deserve.

    -

    37.3.13 C++ templates

    +

    40.3.13 C++ templates

    @@ -1763,7 +1764,7 @@ More details can be found in the SWIG and C++ -

    37.3.14 C++ Smart Pointers

    +

    40.3.14 C++ Smart Pointers

    @@ -1847,7 +1848,7 @@ simply use the __deref__() method. For example: -

    37.4 Further details on the Tcl class interface

    +

    40.4 Further details on the Tcl class interface

    @@ -1860,7 +1861,7 @@ of low-level details were omitted. This section provides a brief overview of how the proxy classes work.

    -

    37.4.1 Proxy classes

    +

    40.4.1 Proxy classes

    @@ -1925,7 +1926,7 @@ function. This allows objects to be encapsulated objects that look a lot like as shown in the last section.

    -

    37.4.2 Memory management

    +

    40.4.2 Memory management

    @@ -2113,7 +2114,7 @@ typemaps--an advanced topic discussed later.

    -

    37.5 Input and output parameters

    +

    40.5 Input and output parameters

    @@ -2301,7 +2302,7 @@ set c [lindex $dim 1] -

    37.6 Exception handling

    +

    40.6 Exception handling

    @@ -2365,7 +2366,7 @@ Tcl extension by specifying the following in an interface file : $action // Gets substituted by actual function call } catch (RangeError) { - Tcl_SetStringObj(tcl_result,"Array index out-of-bounds"); + Tcl_SetResult(interp, (char *)"Array index out-of-bounds", TCL_STATIC); return TCL_ERROR; } } @@ -2384,7 +2385,7 @@ exception handler to only apply to specific methods like this: $action } catch (RangeError) { - Tcl_SetStringObj(tcl_result,"Array index out-of-bounds"); + Tcl_SetResult(interp, (char *)"Array index out-of-bounds", TCL_STATIC); return TCL_ERROR; } } @@ -2394,7 +2395,7 @@ exception handler to only apply to specific methods like this: $action } catch (RangeError) { - Tcl_SetStringObj(tcl_result,"Array index out-of-bounds"); + Tcl_SetResult(interp, (char *)"Array index out-of-bounds", TCL_STATIC); return TCL_ERROR; } } @@ -2419,7 +2420,7 @@ For example: $action } catch (RangeError) { - Tcl_SetStringObj(tcl_result,"Array index out-of-bounds"); + Tcl_SetResult(interp, (char *)"Array index out-of-bounds", TCL_STATIC); return TCL_ERROR; } } @@ -2435,7 +2436,7 @@ Since SWIG's exception handling is user-definable, you are not limited to C++ ex See the chapter on "Customization Features" for more examples.

    -

    37.7 Typemaps

    +

    40.7 Typemaps

    @@ -2452,7 +2453,7 @@ Typemaps are only used if you want to change some aspect of the primitive C-Tcl interface.

    -

    37.7.1 What is a typemap?

    +

    40.7.1 What is a typemap?

    @@ -2465,8 +2466,9 @@ you might define a typemap like this: %module example %typemap(in) int { - if (Tcl_GetIntFromObj(interp,$input,&$1) == TCL_ERROR) return TCL_ERROR; - printf("Received an integer : %d\n",$1); + if (Tcl_GetIntFromObj(interp,$input,&$1) == TCL_ERROR) + return TCL_ERROR; + printf("Received an integer : %d\n",$1); } %inline %{ extern int fact(int n); @@ -2503,8 +2505,9 @@ You can refine this by supplying an optional parameter name. For example: %module example %typemap(in) int n { - if (Tcl_GetIntFromObj(interp,$input,&$1) == TCL_ERROR) return TCL_ERROR; - printf("n = %d\n",$1); + if (Tcl_GetIntFromObj(interp,$input,&$1) == TCL_ERROR) + return TCL_ERROR; + printf("n = %d\n",$1); } %inline %{ extern int fact(int n); @@ -2526,8 +2529,9 @@ the typemap system follows typedef declarations. For example:

     %typemap(in) int n {
    -        if (Tcl_GetIntFromObj(interp,$input,&$1) == TCL_ERROR) return TCL_ERROR;
    -	printf("n = %d\n",$1);
    +  if (Tcl_GetIntFromObj(interp,$input,&$1) == TCL_ERROR)
    +    return TCL_ERROR;
    +  printf("n = %d\n",$1);
     }
     %inline %{
     typedef int Integer;
    @@ -2569,7 +2573,7 @@ parameter is omitted):
     
    -

    37.7.2 Tcl typemaps

    +

    40.7.2 Tcl typemaps

    @@ -2707,7 +2711,7 @@ Initialize an argument to a value before any conversions occur. Examples of these methods will appear shortly.

    -

    37.7.3 Typemap variables

    +

    40.7.3 Typemap variables

    @@ -2778,7 +2782,7 @@ properly assigned. The Tcl name of the wrapper function being created. -

    37.7.4 Converting a Tcl list to a char **

    +

    40.7.4 Converting a Tcl list to a char **

    @@ -2840,7 +2844,7 @@ argv[2] = Larry 3 -

    37.7.5 Returning values in arguments

    +

    40.7.5 Returning values in arguments

    @@ -2882,7 +2886,7 @@ result, a Tcl function using these typemaps will work like this : % -

    37.7.6 Useful functions

    +

    40.7.6 Useful functions

    @@ -2921,7 +2925,6 @@ int Tcl_GetDoubleFromObj(Tcl_Interp *, Tcl_Obj *o, double *dp);

     Tcl_Obj  *Tcl_NewStringObj(char *str, int len);
    -void      Tcl_SetStringObj(Tcl_Obj *obj, char *str, int len);
     char     *Tcl_GetStringFromObj(Tcl_Obj *obj, int *len);
     void      Tcl_AppendToObj(Tcl_Obj *obj, char *str, int len);
     
    @@ -2959,7 +2962,7 @@ int Tcl_IsShared(Tcl_Obj *obj);
    -

    37.7.7 Standard typemaps

    +

    40.7.7 Standard typemaps

    @@ -2976,10 +2979,10 @@ work)

     %typemap(in) int, short, long {
    -   int temp;
    -   if (Tcl_GetIntFromObj(interp, $input, &temp) == TCL_ERROR)
    -      return TCL_ERROR;
    -   $1 = ($1_ltype) temp;
    +  int temp;
    +  if (Tcl_GetIntFromObj(interp, $input, &temp) == TCL_ERROR)
    +    return TCL_ERROR;
    +  $1 = ($1_ltype) temp;
     }
     
    @@ -3037,13 +3040,14 @@ work)
    -%typemap(out) char * {
    -   Tcl_SetStringObj($result,$1);
    +%typemap(out,noblock=1,fragment="SWIG_FromCharPtr") char *, const char * {
    +  Tcl_SetObjResult(interp,SWIG_FromCharPtr((const char *)$1));
     }
    +
     
    -

    37.7.8 Pointer handling

    +

    40.7.8 Pointer handling

    @@ -3119,7 +3123,7 @@ For example: -

    37.8 Turning a SWIG module into a Tcl Package.

    +

    40.8 Turning a SWIG module into a Tcl Package.

    @@ -3153,8 +3157,8 @@ subdirectory which has the same name as the package. For example :

     ./example/
    -	   pkgIndex.tcl           # The file created by pkg_mkIndex
    -	   example.so             # The SWIG generated module
    +           pkgIndex.tcl           # The file created by pkg_mkIndex
    +           example.so             # The SWIG generated module
     

    @@ -3191,7 +3195,7 @@ As a final note, most SWIG examples do not yet use the to use the load command instead.

    -

    37.9 Building new kinds of Tcl interfaces (in Tcl)

    +

    40.9 Building new kinds of Tcl interfaces (in Tcl)

    @@ -3264,14 +3268,14 @@ Our script allows easy array access as follows :

     set a [Array double 100]                   ;# Create a double [100]
     for {set i 0} {$i < 100} {incr i 1} {      ;# Clear the array
    -	$a set $i 0.0
    +        $a set $i 0.0
     }
     $a set 3 3.1455                            ;# Set an individual element
     set b [$a get 10]                          ;# Retrieve an element
     
     set ia [Array int 50]                      ;# Create an int[50]
     for {set i 0} {$i < 50} {incr i 1} {       ;# Clear it
    -	$ia set $i 0
    +        $ia set $i 0
     }
     $ia set 3 7                                ;# Set an individual element
     set ib [$ia get 10]                        ;# Get an individual element
    @@ -3290,7 +3294,7 @@ danger of blowing something up (although it is easily accomplished
     with an out of bounds array access).
     

    -

    37.9.1 Proxy classes

    +

    40.9.1 Proxy classes

    @@ -3411,7 +3415,7 @@ short, but clever Tcl script can be combined with SWIG to do many interesting things.

    -

    37.10 Tcl/Tk Stubs

    +

    40.10 Tcl/Tk Stubs

    diff --git a/Doc/Manual/Typemaps.html b/Doc/Manual/Typemaps.html index 81e3fd1..b074e9f 100644 --- a/Doc/Manual/Typemaps.html +++ b/Doc/Manual/Typemaps.html @@ -1,12 +1,13 @@ - + Typemaps + -

    10 Typemaps

    +

    11 Typemaps

    +
  • Special variables and typemap attributes +
  • Special variables combined with special variable macros
  • Common typemap methods
      @@ -85,7 +88,7 @@
    • Usage
  • Typemaps and overloading -
  • More about %apply and %clear +
  • More about %apply and %clear
  • Passing data between typemaps
  • C++ "this" pointer
  • Where to go for more information? @@ -95,7 +98,7 @@ -

    10.1 Introduction

    +

    11.1 Introduction

    @@ -112,7 +115,7 @@ to re-read the earlier chapters if you have found your way to this chapter with only a vague idea of what SWIG already does by default.

    -

    10.1.1 Type conversion

    +

    11.1.1 Type conversion

    @@ -205,7 +208,7 @@ to read the extension documentation for your favorite language to know how it works (an exercise left to the reader).

    -

    10.1.2 Typemaps

    +

    11.1.2 Typemaps

    @@ -306,7 +309,7 @@ parts of the generated wrapper functions. Because arbitrary code can be insert possible to completely change the way in which values are converted.

    -

    10.1.3 Pattern matching

    +

    11.1.3 Pattern matching

    @@ -408,7 +411,7 @@ In this case, a single input object is expanded into a pair of C arguments. Thi provides a hint to the unusual variable naming scheme involving $1, $2, and so forth.

    -

    10.1.4 Reusing typemaps

    +

    11.1.4 Reusing typemaps

    @@ -464,7 +467,7 @@ typedef int size_t; then SWIG already knows that the int typemaps apply. You don't have to do anything.

    -

    10.1.5 What can be done with typemaps?

    +

    11.1.5 What can be done with typemaps?

    @@ -576,7 +579,7 @@ typemaps that expand upon this list. For example, the Java module defines a var aspects of the Java bindings. Consult language specific documentation for further details.

    -

    10.1.6 What can't be done with typemaps?

    +

    11.1.6 What can't be done with typemaps?

    @@ -639,7 +642,7 @@ void wrap_foo(char *s, int x) {

  • -

    10.1.7 Similarities to Aspect Oriented Programming

    +

    11.1.7 Similarities to Aspect Oriented Programming

    @@ -653,11 +656,11 @@ The %feature. +SWIG can also be viewed as has having a second set of aspects based around %feature. Features such as %exception are also cross-cutting concerns as they encapsulate code that can be used to add logging or exception handling to any function.

    -

    10.1.8 The rest of this chapter

    +

    11.1.8 The rest of this chapter

    @@ -677,14 +680,14 @@ of "The C Programming Language" by Kernighan and Ritchie or "The C++ Programming Language" by Stroustrup before going any further.

    -

    10.2 Typemap specifications

    +

    11.2 Typemap specifications

    This section describes the behavior of the %typemap directive itself.

    -

    10.2.1 Defining a typemap

    +

    11.2.1 Defining a typemap

    @@ -747,7 +750,7 @@ code : { ... }

    Note that the preprocessor will expand code within the {} delimiters, but not in the last two styles of delimiters, -see Preprocessor and Typemaps. +see Preprocessor and Typemaps. Here are some examples of valid typemap specifications:

    @@ -797,7 +800,7 @@ Admittedly, it's not the most readable syntax at first glance. However, the pur individual pieces will become clear.

    -

    10.2.2 Typemap scope

    +

    11.2.2 Typemap scope

    @@ -847,7 +850,7 @@ class Foo { -

    10.2.3 Copying a typemap

    +

    11.2.3 Copying a typemap

    @@ -905,7 +908,7 @@ The patterns for %apply follow the same rules as for %typemap. -

    10.2.4 Deleting a typemap

    +

    11.2.4 Deleting a typemap

    @@ -938,7 +941,7 @@ For example: after the clear operation.

    -

    10.2.5 Placement of typemaps

    +

    11.2.5 Placement of typemaps

    @@ -1018,7 +1021,7 @@ It should be noted that for scoping to work, SWIG has to know that stringclass string.

    -

    10.3 Pattern matching rules

    +

    11.3 Pattern matching rules

    @@ -1026,7 +1029,7 @@ The section describes the pattern matching rules by which C/C++ datatypes are as The matching rules can be observed in practice by using the debugging options also described.

    -

    10.3.1 Basic matching rules

    +

    11.3.1 Basic matching rules

    @@ -1125,7 +1128,7 @@ void F(int x[1000]); // int [ANY] rule (typemap 5) stripped all qualifiers in one step.

    -

    10.3.2 Typedef reductions matching

    +

    11.3.2 Typedef reductions matching

    @@ -1300,7 +1303,7 @@ void go(Struct aStruct); -

    10.3.3 Default typemap matching rules

    +

    11.3.3 Default typemap matching rules

    @@ -1438,7 +1441,7 @@ Finally the best way to view the typemap matching rules in action is via the -

    10.3.4 Multi-arguments typemaps

    +

    11.3.4 Multi-arguments typemaps

    @@ -1468,7 +1471,7 @@ but all subsequent arguments must match exactly.

    -

    10.3.5 Matching rules compared to C++ templates

    +

    11.3.5 Matching rules compared to C++ templates

    @@ -1627,7 +1630,7 @@ are similar to those for specialized template handling.

    -

    10.3.6 Debugging typemap pattern matching

    +

    11.3.6 Debugging typemap pattern matching

    @@ -1840,7 +1843,7 @@ Also the types may be displayed slightly differently - char const * and -

    10.4 Code generation rules

    +

    11.4 Code generation rules

    @@ -1848,7 +1851,7 @@ This section describes rules by which typemap code is inserted into the generated wrapper code.

    -

    10.4.1 Scope

    +

    11.4.1 Scope

    @@ -1926,7 +1929,7 @@ a block scope when it is emitted. This sometimes results in a less complicated Note that only the third of the three typemaps have the typemap code passed through the SWIG preprocessor.

    -

    10.4.2 Declaring new local variables

    +

    11.4.2 Declaring new local variables

    @@ -2050,6 +2053,22 @@ wrap_foo() { +

    There is an exception: if the variable name starts with the _global_ prefix, +the argument number is not appended. Such variables can be used throughout the generated +wrapper function. For example, the above typemap could be rewritten to use _global_temp +instead of temp and the generated code would then contain a single _global_temp variable +instead of temp1, temp2 and temp3: +

    + +
    +
    +%typemap(in) std::string * (std::string _global_temp) {
    + ... as above ...
    +}
    +
    +
    + +

    Some typemaps do not recognize local variables (or they may simply not apply). At this time, only typemaps that apply to argument conversion support this (input typemaps such as the "in" typemap). @@ -2077,7 +2096,7 @@ each type must have its own local variable declaration. -

    10.4.3 Special variables

    +

    11.4.3 Special variables

    @@ -2329,7 +2348,7 @@ Another approach, which only works for arrays is to use the $1_basetype -

    10.4.4 Special variable macros

    +

    11.4.4 Special variable macros

    @@ -2341,7 +2360,7 @@ it is done during the SWIG parsing/compilation stages. The following special variable macros are available across all language modules.

    -

    10.4.4.1 $descriptor(type)

    +

    11.4.4.1 $descriptor(type)

    @@ -2352,7 +2371,7 @@ For example, $descriptor(std::vector<int> *) will expand into Run-time type checker usage section.

    -

    10.4.4.2 $typemap(method, typepattern)

    +

    11.4.4.2 $typemap(method, typepattern)

    @@ -2409,7 +2428,77 @@ The result is the following expansion -

    10.5 Common typemap methods

    + +

    11.4.5 Special variables and typemap attributes

    + + +

    +As of SWIG-3.0.7 typemap attributes will also expand special variables and special variable macros. +

    + +

    +Example usage showing the expansion in the 'out' attribute (C# specific) as well as the main typemap body: +

    + +
    +
    +%typemap(ctype, out="$*1_ltype") unsigned int& "$*1_ltype"
    +
    +
    + +

    +is equivalent to the following as $*1_ltype expands to unsigned int: +

    + +
    +
    +%typemap(ctype, out="unsigned int") unsigned int& "unsigned int"
    +
    +
    + +

    11.4.6 Special variables combined with special variable macros

    + + +

    +Special variables can also be used within special variable macros. +The special variables are expanded before they are used in the special variable macros. +

    + +

    +Consider the following C# typemaps: +

    + +
    +
    +%typemap(cstype) unsigned int "uint"
    +%typemap(cstype, out="$typemap(cstype, $*1_ltype)") unsigned int& "$typemap(cstype, $*1_ltype)"
    +
    +
    + +

    +Special variables are expanded first and hence the above is equivalent to: +

    + +
    +
    +%typemap(cstype) unsigned int "uint"
    +%typemap(cstype, out="$typemap(cstype, unsigned int)") unsigned int& "$typemap(cstype, unsigned int)"
    +
    +
    + +

    +which then expands to: +

    + +
    +
    +%typemap(cstype) unsigned int "uint"
    +%typemap(cstype, out="uint") unsigned int& "uint"
    +
    +
    + + +

    11.5 Common typemap methods

    @@ -2417,7 +2506,7 @@ The set of typemaps recognized by a language module may vary. However, the following typemap methods are nearly universal:

    -

    10.5.1 "in" typemap

    +

    11.5.1 "in" typemap

    @@ -2477,7 +2566,7 @@ Usually numinputs is not specified, whereupon the default value is 1, t is the same as the old "ignore" typemap.

    -

    10.5.2 "typecheck" typemap

    +

    11.5.2 "typecheck" typemap

    @@ -2503,7 +2592,7 @@ If you define new "in" typemaps and your program uses overloaded method "typecheck" typemaps. More details about this follow in the Typemaps and overloading section.

    -

    10.5.3 "out" typemap

    +

    11.5.3 "out" typemap

    @@ -2534,7 +2623,7 @@ $symname - Name of function/method being wrapped The "out" typemap supports an optional attribute flag called "optimal". This is for code optimisation and is detailed in the Optimal code generation when returning by value section.

    -

    10.5.4 "arginit" typemap

    +

    11.5.4 "arginit" typemap

    @@ -2553,7 +2642,7 @@ For example: -

    10.5.5 "default" typemap

    +

    11.5.5 "default" typemap

    @@ -2586,7 +2675,7 @@ See the Default/optional arguments sec for further information on default argument wrapping.

    -

    10.5.6 "check" typemap

    +

    11.5.6 "check" typemap

    @@ -2605,7 +2694,7 @@ converted. For example: -

    10.5.7 "argout" typemap

    +

    11.5.7 "argout" typemap

    @@ -2651,7 +2740,7 @@ return values are often appended to return value of the function. See the typemaps.i library file for examples.

    -

    10.5.8 "freearg" typemap

    +

    11.5.8 "freearg" typemap

    @@ -2684,7 +2773,7 @@ be used in other typemaps whenever a wrapper function needs to abort prematurely.

    -

    10.5.9 "newfree" typemap

    +

    11.5.9 "newfree" typemap

    @@ -2713,7 +2802,7 @@ string *foo(); See Object ownership and %newobject for further details.

    -

    10.5.10 "memberin" typemap

    +

    11.5.10 "memberin" typemap

    @@ -2735,7 +2824,7 @@ It is rarely necessary to write "memberin" typemaps---SWIG already provides a default implementation for arrays, strings, and other objects.

    -

    10.5.11 "varin" typemap

    +

    11.5.11 "varin" typemap

    @@ -2743,7 +2832,7 @@ The "varin" typemap is used to convert objects in the target language to C for t purposes of assigning to a C/C++ global variable. This is implementation specific.

    -

    10.5.12 "varout" typemap

    +

    11.5.12 "varout" typemap

    @@ -2751,7 +2840,7 @@ The "varout" typemap is used to convert a C/C++ object to an object in the targe language when reading a C/C++ global variable. This is implementation specific.

    -

    10.5.13 "throws" typemap

    +

    11.5.13 "throws" typemap

    @@ -2797,7 +2886,7 @@ Note that if your methods do not have an exception specification yet they do thr For a neat way to handle these, see the Exception handling with %exception section.

    -

    10.6 Some typemap examples

    +

    11.6 Some typemap examples

    @@ -2805,7 +2894,7 @@ This section contains a few examples. Consult language module documentation for more examples.

    -

    10.6.1 Typemaps for arrays

    +

    11.6.1 Typemaps for arrays

    @@ -2962,8 +3051,8 @@ For example, suppose you had a structure like this:

     struct SomeObject {
    -	float  value[4];
    -        ...
    +  float  value[4];
    +  ...
     };
     
    @@ -3064,7 +3153,7 @@ Now, you will find that member access is quite nice: useless and has since been eliminated. To return structure members, simply use the "out" typemap.

    -

    10.6.2 Implementing constraints with typemaps

    +

    11.6.2 Implementing constraints with typemaps

    @@ -3077,9 +3166,9 @@ checking the values of function arguments. For example:

    %module math %typemap(check) double posdouble { - if ($1 < 0) { - croak("Expecting a positive number"); - } + if ($1 < 0) { + croak("Expecting a positive number"); + } } ... @@ -3112,7 +3201,7 @@ a NULL pointer. As a result, SWIG can often prevent a potential segmentation faults or other run-time problems by raising an exception rather than blindly passing values to the underlying C/C++ program.

    -

    10.7 Typemaps for multiple target languages

    +

    11.7 Typemaps for multiple target languages

    @@ -3142,7 +3231,7 @@ The example above also shows a common approach of issuing a warning for an as ye %typemap(ruby,in) int "$1 = NUM2INT($input);".

    -

    10.8 Optimal code generation when returning by value

    +

    11.8 Optimal code generation when returning by value

    @@ -3331,7 +3420,7 @@ example.i:7: Warning 475: optimal attribute usage in the out typemap. However, it doesn't always get it right, for example when $1 is within some commented out code.

    -

    10.9 Multi-argument typemaps

    +

    11.9 Multi-argument typemaps

    @@ -3355,12 +3444,12 @@ list of strings like this:

    ->>> foo(["ale","lager","stout"])
    +>>> foo(["ale", "lager", "stout"])
     

    -To do this, you not only need to map a list of strings to char *argv[], but the +To do this, you not only need to map a list of strings to char *argv[], but the value of int argc is implicitly determined by the length of the list. Using only simple typemaps, this type of conversion is possible, but extremely painful. Multi-argument typemaps help in this situation. @@ -3398,6 +3487,11 @@ maps perform the conversion described for the above example: %typemap(freearg) (int argc, char *argv[]) { if ($2) free($2); } + +/* Required for C++ method overloading */ +%typecheck(SWIG_TYPECHECK_STRING_ARRAY) (int argc, char *argv[]) { + $1 = PyList_Check($input) ? 1 : 0; +} @@ -3466,6 +3560,11 @@ Other directives such as %apply and %clear also work with mult

    +Don't forget to also provide a suitable typemap for overloaded functions, such as %typecheck shown for foo above. +This is only required if the function is overloaded in C++. +

    + +

    Although multi-argument typemaps may seem like an exotic, little used feature, there are several situations where they make sense. First, suppose you wanted to wrap functions similar to the low-level read() and write() system calls. @@ -3598,7 +3697,7 @@ with non-consecutive C/C++ arguments; a workaround such as a helper function re- the arguments to make them consecutive will need to be written.

    -

    10.10 Typemap warnings

    +

    11.10 Typemap warnings

    @@ -3607,7 +3706,7 @@ See the information in the issuing warnings

    -

    10.11 Typemap fragments

    +

    11.11 Typemap fragments

    @@ -3860,7 +3959,7 @@ fragment usage unless a desire to really get to grips with some powerful but tricky macro and fragment usage that is used in parts of the SWIG typemap library.

    -

    10.11.1 Fragment type specialization

    +

    11.11.1 Fragment type specialization

    @@ -3893,7 +3992,7 @@ struct A { -

    10.11.2 Fragments and automatic typemap specialization

    +

    11.11.2 Fragments and automatic typemap specialization

    @@ -3939,7 +4038,7 @@ The interested (or very brave) reader can take a look at the fragments.swg file

    -

    10.12 The run-time type checker

    +

    11.12 The run-time type checker

    @@ -3956,7 +4055,7 @@ Requirements for the type system:

  • Store inheritance and type equivalence information and be able to correctly re-create the type pointer.
  • Share type information between modules.
  • -
  • Modules can be loaded in any order, irregardless of actual type +
  • Modules can be loaded in any order, regardless of actual type dependency.
  • Avoid the use of dynamically allocated memory, and library/system calls in general.
  • Provide a reasonably fast implementation, minimizing the lookup time for all @@ -3965,7 +4064,7 @@ language modules.
  • Modules can be unloaded from the type system.
  • -

    10.12.1 Implementation

    +

    11.12.1 Implementation

    @@ -4151,7 +4250,7 @@ structures rather than creating new ones. These swig_module_info structures are chained together in a circularly linked list.

    -

    10.12.2 Usage

    +

    11.12.2 Usage

    This section covers how to use these functions from typemaps. To learn how to @@ -4245,7 +4344,7 @@ probably just look at the output of SWIG to get a better sense for how types are managed.

    -

    10.13 Typemaps and overloading

    +

    11.13 Typemaps and overloading

    @@ -4413,7 +4512,7 @@ before arrays, and so forth.

    Using the above table as a guide, each target language defines a collection of "typecheck" typemaps. -The follow excerpt from the Python module illustrates this: +The following excerpt from the Python module illustrates this:

    @@ -4422,22 +4521,22 @@ The follow excerpt from the Python module illustrates this: /* Note: %typecheck(X) is a macro for %typemap(typecheck,precedence=X) */ %typecheck(SWIG_TYPECHECK_INTEGER) - int, short, long, - unsigned int, unsigned short, unsigned long, - signed char, unsigned char, - long long, unsigned long long, - const int &, const short &, const long &, - const unsigned int &, const unsigned short &, const unsigned long &, - const long long &, const unsigned long long &, - enum SWIGTYPE, - bool, const bool & + int, short, long, + unsigned int, unsigned short, unsigned long, + signed char, unsigned char, + long long, unsigned long long, + const int &, const short &, const long &, + const unsigned int &, const unsigned short &, const unsigned long &, + const long long &, const unsigned long long &, + enum SWIGTYPE, + bool, const bool & { $1 = (PyInt_Check($input) || PyLong_Check($input)) ? 1 : 0; } %typecheck(SWIG_TYPECHECK_DOUBLE) - float, double, - const float &, const double & + float, double, + const float &, const double & { $1 = (PyFloat_Check($input) || PyInt_Check($input) || PyLong_Check($input)) ? 1 : 0; } @@ -4526,11 +4625,31 @@ Here is an example,

    The bottom line: If you are writing new typemaps and you are using overloaded methods, you will probably -have to write typecheck code or copy existing code. Since this is a relatively new SWIG feature, there are -few examples to work with. However, you might look at some of the existing library files likes 'typemaps.i' for -a guide. +have to write new typecheck code or copy and modify existing typecheck code. +

    + +

    +If you write a typecheck typemap and omit the precedence level, for example commenting it out as shown below:

    +
    +
    +%typemap(typecheck /*,precedence=SWIG_TYPECHECK_INTEGER*/) int {
    +   $1 = PyInt_Check($input) ? 1 : 0;
    +}
    +
    +
    + +

    +then the type is given a precedence higher than any other known precedence level and a warning is issued: +

    + +
    +
    +example.i:18: Warning 467: Overloaded method foo(int) not supported (incomplete type checking rule - no precedence level in typecheck typemap for 'int').
    +
    +
    +

    Notes:

    @@ -4556,7 +4675,7 @@ Subsequent "in" typemaps would then perform more extensive type-checking. -

    10.14 More about %apply and %clear

    +

    11.14 More about %apply and %clear

    @@ -4642,7 +4761,7 @@ example:

    -

    10.15 Passing data between typemaps

    +

    11.15 Passing data between typemaps

    @@ -4679,7 +4798,7 @@ sure that the typemaps sharing information have exactly the same types and names

    -

    10.16 C++ "this" pointer

    +

    11.16 C++ "this" pointer

    @@ -4739,7 +4858,7 @@ will also match the typemap. One work around is to create an interface file tha the method, but gives the argument a name other than self.

    -

    10.17 Where to go for more information?

    +

    11.17 Where to go for more information?

    diff --git a/Doc/Manual/Varargs.html b/Doc/Manual/Varargs.html index 9564fe0..1c99804 100644 --- a/Doc/Manual/Varargs.html +++ b/Doc/Manual/Varargs.html @@ -1,12 +1,13 @@ - + Variable Length Arguments + -

    13 Variable Length Arguments

    +

    14 Variable Length Arguments

      @@ -42,7 +43,7 @@ added in SWIG-1.3.12. Most other wrapper generation tools have wisely chosen to avoid this issue.

      -

      13.1 Introduction

      +

      14.1 Introduction

      @@ -139,7 +140,7 @@ List make_list(const char *s, ...) {

    -

    13.2 The Problem

    +

    14.2 The Problem

    @@ -232,7 +233,7 @@ can also support real varargs wrapping (with stack-frame manipulation) if you are willing to get hands dirty. Keep reading.

    -

    13.3 Default varargs support

    +

    14.3 Default varargs support

    @@ -301,7 +302,7 @@ Read on for further solutions.

    -

    13.4 Argument replacement using %varargs

    +

    14.4 Argument replacement using %varargs

    @@ -412,7 +413,7 @@ mixed argument types such as printf(). Providing general purpose wrappers to such functions presents special problems (covered shortly).

    -

    13.5 Varargs and typemaps

    +

    14.5 Varargs and typemaps

    @@ -589,7 +590,7 @@ really want to elevate your guru status and increase your job security, continue to the next section.

    -

    13.6 Varargs wrapping with libffi

    +

    14.6 Varargs wrapping with libffi

    @@ -605,7 +606,7 @@ you need to bring out some bigger guns.

    One way to do this is to use a special purpose library such as libffi (http://sources.redhat.com/libffi). +href="http://www.sourceware.org/libffi/">http://www.sourceware.org/libffi/). libffi is a library that allows you to dynamically construct call-stacks and invoke procedures in a relatively platform independent manner. Details about the library can be found in the libffi @@ -635,7 +636,7 @@ example. For example: PyObject *o = PyTuple_GetItem(varargs,i); if (!PyString_Check(o)) { PyErr_SetString(PyExc_ValueError,"Expected a string"); - free(argv); + free(argv); return NULL; } argv[i] = PyString_AsString(o); @@ -841,7 +842,7 @@ provide an argument number for the first extra argument. This can be used to in values. Please consult the chapter on each language module for more details.

    -

    13.7 Wrapping of va_list

    +

    14.7 Wrapping of va_list

    @@ -895,7 +896,7 @@ int my_vprintf(const char *fmt, ...) { -

    13.8 C++ Issues

    +

    14.8 C++ Issues

    @@ -964,7 +965,7 @@ design or to provide an alternative interface using a helper function than it is fully general wrapper to a varargs C++ member function.

    -

    13.9 Discussion

    +

    14.9 Discussion

    diff --git a/Doc/Manual/Warnings.html b/Doc/Manual/Warnings.html index cf4c38d..89a8375 100644 --- a/Doc/Manual/Warnings.html +++ b/Doc/Manual/Warnings.html @@ -1,12 +1,13 @@ - + Warning Messages + -

    14 Warning Messages

    +

    15 Warning Messages

      @@ -35,7 +36,7 @@ -

      14.1 Introduction

      +

      15.1 Introduction

      @@ -55,7 +56,7 @@ where the generated wrapper code will probably compile, but it may not work like you expect.

      -

      14.2 Warning message suppression

      +

      15.2 Warning message suppression

      @@ -147,7 +148,7 @@ your interface. Ignore the warning messages at your own peril.

      -

      14.3 Enabling extra warnings

      +

      15.3 Enabling extra warnings

      @@ -220,7 +221,7 @@ that is, any warnings suppressed or added in %warnfilter, #pragma S or the -w option.

      -

      14.4 Issuing a warning message

      +

      15.4 Issuing a warning message

      @@ -274,7 +275,7 @@ example.i:24: Warning 901: You are really going to regret this usage of blah * s

    -

    14.5 Symbolic symbols

    +

    15.5 Symbolic symbols

    @@ -309,7 +310,7 @@ or -

    14.6 Commentary

    +

    15.6 Commentary

    @@ -326,7 +327,7 @@ no obvious recovery. There is no mechanism for suppressing error messages.

    -

    14.7 Warnings as errors

    +

    15.7 Warnings as errors

    @@ -335,7 +336,7 @@ option. This will cause SWIG to exit with a non successful exit code if a warning is encountered.

    -

    14.8 Message output format

    +

    15.8 Message output format

    @@ -349,15 +350,15 @@ These can be overridden using command line options, for example:

     $ swig -python -Fstandard example.i
    -example.i:4: Syntax error in input.
    +example.i:4: Syntax error in input(1).
     $ swig -python -Fmicrosoft example.i
    -example.i(4) : Syntax error in input.
    +example.i(4) : Syntax error in input(1).
     
    -

    14.9 Warning number reference

    +

    15.9 Warning number reference

    -

    14.9.1 Deprecated features (100-199)

    +

    15.9.1 Deprecated features (100-199)

      @@ -382,9 +383,10 @@ example.i(4) : Syntax error in input.
    • 119. Deprecated %typemap(ignore).
    • 120. Deprecated command line option (-runtime, -noruntime).
    • 121. Deprecated %name directive. +
    • 126. The 'nestedworkaround' feature is deprecated.
    -

    14.9.2 Preprocessor (200-299)

    +

    15.9.2 Preprocessor (200-299)

      @@ -396,7 +398,7 @@ example.i(4) : Syntax error in input.
    • 206. Unexpected tokens after #directive directive.
    -

    14.9.3 C/C++ Parser (300-399)

    +

    15.9.3 C/C++ Parser (300-399)

      @@ -473,7 +475,7 @@ example.i(4) : Syntax error in input.
    • 395. operator delete[] ignored.
    -

    14.9.4 Types and typemaps (400-499)

    +

    15.9.4 Types and typemaps (400-499)

      @@ -491,18 +493,20 @@ example.i(4) : Syntax error in input.
    • 464. Unsupported constant value.
    • 465. Unable to handle type type.
    • 466. Unsupported variable type type. -
    • 467. Overloaded declaration not supported (no type checking rule for 'type') +
    • 467. Overloaded declaration not supported (incomplete type checking rule - no precedence level in typecheck typemap for 'type')
    • 468. No 'throw' typemap defined for exception type type
    • 469. No or improper directorin typemap defined for type
    • 470. Thread/reentrant unsafe wrapping, consider returning by value instead.
    • 471. Unable to use return type type in director method
    • 474. Method method usage of the optimal attribute ignored in the out typemap as the following cannot be used to generate optimal code: code
    • 475. Multiple calls to method might be generated due to optimal attribute usage in the out typemap. +
    • 476. Initialization using std::initializer_list. +
    • 477. No directorthrows typemap defined for type
    -

    14.9.5 Code generation (500-599)

    +

    15.9.5 Code generation (500-599)

      @@ -531,7 +535,7 @@ example.i(4) : Syntax error in input.
    • 523. Use of an illegal destructor name 'name' in %extend is deprecated, the destructor name should be 'name'.
    -

    14.9.6 Language module specific (700-899)

    +

    15.9.6 Language module specific (700-899)

      @@ -542,7 +546,7 @@ example.i(4) : Syntax error in input.
    • 810. No jni typemap defined for type (Java).
    • 811. No jtype typemap defined for type (Java).
    • 812. No jstype typemap defined for type (Java). -
    • 813. Warning for classname: Base baseclass ignored. Multiple inheritance is not supported in Java. (Java). +
    • 813. Warning for classname, base baseclass ignored. Multiple inheritance is not supported in Java. (Java).
    • 814.
    • 815. No javafinalize typemap defined for type (Java).
    • 816. No javabody typemap defined for type (Java). @@ -562,7 +566,7 @@ example.i(4) : Syntax error in input.
    • 830. No ctype typemap defined for type (C#).
    • 831. No cstype typemap defined for type (C#).
    • 832. No cswtype typemap defined for type (C#). -
    • 833. Warning for classname: Base baseclass ignored. Multiple inheritance is not supported in C#. (C#). +
    • 833. Warning for classname, base baseclass ignored. Multiple inheritance is not supported in C#. (C#).
    • 834.
    • 835. No csfinalize typemap defined for type (C#).
    • 836. No csbody typemap defined for type (C#). @@ -578,18 +582,18 @@ example.i(4) : Syntax error in input.
      -
    • 870. Warning for classname: Base baseclass ignored. Multiple inheritance is not supported in PHP. +
    • 870. Warning for classname: Base baseclass ignored. Multiple inheritance is not supported in PHP. (Php).
    • 871. Unrecognized pragma pragma. (Php).
    -

    14.9.7 User defined (900-999)

    +

    15.9.7 User defined (900-999)

    These numbers can be used by your own application.

    -

    14.10 History

    +

    15.10 History

    diff --git a/Doc/Manual/Windows.html b/Doc/Manual/Windows.html index c8467c7..b95105b 100644 --- a/Doc/Manual/Windows.html +++ b/Doc/Manual/Windows.html @@ -1,12 +1,13 @@ - + Getting started on Windows + -

    3 Getting started on Windows

    +

    3 Getting started on Windows

      @@ -52,7 +53,7 @@ Usage within the Unix like environments MinGW and Cygwin is also detailed.

      -

      3.1 Installation on Windows

      +

      3.1 Installation on Windows

      @@ -63,7 +64,7 @@ SWIG does not come with the usual Windows type installation program, however it

    • Set environment variables as described in the SWIG Windows Examples section in order to run examples using Visual C++.
    -

    3.1.1 Windows Executable

    +

    3.1.1 Windows Executable

    @@ -72,22 +73,22 @@ If you want to build your own swig.exe have a look at 3.2 SWIG Windows Examples +

    3.2 SWIG Windows Examples

    Using Microsoft Visual C++ is the most common approach to compiling and linking SWIG's output. The Examples directory has a few Visual C++ project files (.dsp files). These were produced by Visual C++ 6. -Later versions of Visual Studio should also be able to open and convert these project files. -The C# examples come with .NET 2003 solution (.sln) and project files instead of Visual C++ 6 project files. +Newer versions of Visual Studio should be able to open and convert these project files. +Each C# example comes with a Visual Studio 2005 solution and associated project files instead of Visual C++ 6 project files. The project files have been set up to execute SWIG in a custom build rule for the SWIG interface (.i) file. Alternatively run the examples using Cygwin.

    More information on each of the examples is available with the examples distributed with SWIG (Examples/index.html). -

    3.2.1 Instructions for using the Examples with Visual Studio

    +

    3.2.1 Instructions for using the Examples with Visual Studio

    @@ -105,7 +106,7 @@ If you don't want to use environment variables then change all occurrences of th If you are interested in how the project files are set up there is explanatory information in some of the language module's documentation.

    -

    3.2.1.1 C#

    +

    3.2.1.1 C#

    @@ -115,7 +116,7 @@ The accompanying C# and C++ project files are automatically used by the solution

    -

    3.2.1.2 Java

    +

    3.2.1.2 Java

    @@ -129,7 +130,7 @@ JAVA_BIN: D:\jdk1.3\bin

    -

    3.2.1.3 Perl

    +

    3.2.1.3 Perl

    @@ -143,7 +144,7 @@ PERL5_LIB: D:\nsPerl5.004_04\lib\CORE\perl.lib

    -

    3.2.1.4 Python

    +

    3.2.1.4 Python

    @@ -157,13 +158,13 @@ PYTHON_LIB: D:\python21\libs\python21.lib

    -

    3.2.1.5 TCL

    +

    3.2.1.5 TCL

    TCL_INCLUDE : Set this to the directory containing tcl.h
    TCL_LIB : Set this to the TCL library including path for linking

    -Example using ActiveTcl 8.3.3.3
    +Example using ActiveTcl 8.3.3.3
    TCL_INCLUDE: D:\tcl\include
    TCL_LIB: D:\tcl\lib\tcl83.lib
    @@ -171,7 +172,7 @@ TCL_LIB: D:\tcl\lib\tcl83.lib

    -

    3.2.1.6 R

    +

    3.2.1.6 R

    @@ -185,7 +186,7 @@ R_LIB: C:\Program Files\R\R-2.5.1\bin\Rdll.lib

    -

    3.2.1.7 Ruby

    +

    3.2.1.7 Ruby

    @@ -199,21 +200,21 @@ RUBY_LIB: D:\ruby\lib\mswin32-ruby16.lib

    -

    3.2.2 Instructions for using the Examples with other compilers

    +

    3.2.2 Instructions for using the Examples with other compilers

    If you do not have access to Visual C++ you will have to set up project files / Makefiles for your chosen compiler. There is a section in each of the language modules detailing what needs setting up using Visual C++ which may be of some guidance. Alternatively you may want to use Cygwin as described in the following section.

    -

    3.3 SWIG on Cygwin and MinGW

    +

    3.3 SWIG on Cygwin and MinGW

    SWIG can also be compiled and run using Cygwin or MinGW which provides a Unix like front end to Windows and comes free with gcc, an ANSI C/C++ compiler. However, this is not a recommended approach as the prebuilt executable is supplied.

    -

    3.3.1 Building swig.exe on Windows

    +

    3.3.1 Building swig.exe on Windows

    @@ -223,7 +224,7 @@ This information is provided for those that want to modify the SWIG source code Normally this is not needed, so most people will want to ignore this section.

    -

    3.3.1.1 Building swig.exe using MinGW and MSYS

    +

    3.3.1.1 Building swig.exe using MinGW and MSYS

    @@ -293,9 +294,9 @@ Execute the steps in the order shown and don't use spaces in path names. In fact Start the MSYS command prompt and execute:

     cd /
    -tar -jxf msys-automake-1.8.2.tar.bz2 
    +tar -jxf msys-automake-1.8.2.tar.bz2
     tar -jxf msys-autoconf-2.59.tar.bz2
    -tar -zxf bison-2.0-MSYS.tar.gz   
    +tar -zxf bison-2.0-MSYS.tar.gz
     
    @@ -341,7 +342,7 @@ make -

    3.3.1.2 Building swig.exe using Cygwin

    +

    3.3.1.2 Building swig.exe using Cygwin

    @@ -352,7 +353,7 @@ Note that the Cygwin environment will also allow one to regenerate the autotool These files are generated using the autogen.sh script and will only need regenerating in circumstances such as changing the build system.

    -

    3.3.1.3 Building swig.exe alternatives

    +

    3.3.1.3 Building swig.exe alternatives

    @@ -362,7 +363,7 @@ file in order to build swig.exe from the Visual C++ IDE.

    -

    3.3.2 Running the examples on Windows using Cygwin

    +

    3.3.2 Running the examples on Windows using Cygwin

    @@ -371,7 +372,7 @@ The modules which are known to work are Python, Tcl, Perl, Ruby, Java and C#. Follow the Unix instructions in the README file in the SWIG root directory to build the examples.

    -

    3.4 Microsoft extensions and other Windows quirks

    +

    3.4 Microsoft extensions and other Windows quirks

    @@ -388,6 +389,53 @@ Include it like you would any other interface file, for example: __declspec(dllexport) ULONG __stdcall foo(DWORD, __int32);

    +

    Note that if you follow Microsoft's recommendation of wrapping the +__declspec calls in a preprocessor definition, you will need to +make sure that the definition is included by SWIG as well, by either defining it +manually or via a header. For example, if you have specified the +preprocessor definition in a header named export_lib.h and include +other headers which depend on it, you should use the %include directive +to include the definition explicitly. For example, if you had a header file, +bar.h, which depended on export_lib.h, your SWIG definition +file might look like:

    + +
    +// bar.i
    +%module bar
    +%include <windows.i>
    +%include "export_lib.h"
    +%include "bar.h"
    +
    + +

    +where export_lib.h may contain: +

    + +
    +// export_lib.h
    +#define BAR_API __declspec(dllexport)
    +
    + +

    +and bar.h may look like: +

    + +
    +// bar.h
    +#include "export_lib.h"
    +BAR_API void bar_function(int, double);
    +
    + +

    +Using the preprocessor to remove BAR_API is a popular simpler solution: +

    + +
    +// bar.i
    +%module bar
    +#define BAR_API
    +%include "bar.h"
    +
    diff --git a/Doc/Manual/chapters b/Doc/Manual/chapters index 40e2271..d94a8a3 100644 --- a/Doc/Manual/chapters +++ b/Doc/Manual/chapters @@ -4,6 +4,7 @@ Windows.html Scripting.html SWIG.html SWIGPlus.html +CPlusPlus11.html Preprocessor.html Library.html Arguments.html @@ -22,6 +23,7 @@ D.html Go.html Guile.html Java.html +Javascript.html Lisp.html Lua.html Modula3.html @@ -34,5 +36,6 @@ Pike.html Python.html R.html Ruby.html +Scilab.html Tcl.html Extending.html diff --git a/Doc/Manual/fixstyle.py b/Doc/Manual/fixstyle.py index 1007d59..a360968 100644 --- a/Doc/Manual/fixstyle.py +++ b/Doc/Manual/fixstyle.py @@ -1,6 +1,6 @@ #!/usr/bin/python -# Adds the SWIG stylesheet to the generated documentation on a single page +# Replace the inline htmldoc stylesheet with the SWIG stylesheet import sys import string @@ -14,11 +14,16 @@ swigstyle = "\n" + open("style.css").read() lines = data.splitlines() result = [ ] +skip = False for s in lines: - if s == "": + result.append(s) + skip = False data = "\n".join(result) diff --git a/Doc/Manual/index.html b/Doc/Manual/index.html index 30c6957..26cc81e 100644 --- a/Doc/Manual/index.html +++ b/Doc/Manual/index.html @@ -1,10 +1,11 @@ - + -SWIG-2.0 Documentation +SWIG-3.0 Documentation + -

    SWIG-2.0 Documentation

    +

    SWIG-3.0 Documentation

    The SWIG documentation is available in one of the following formats.
      diff --git a/Doc/Manual/linkchecker.config b/Doc/Manual/linkchecker.config index a947b27..9317a89 100644 --- a/Doc/Manual/linkchecker.config +++ b/Doc/Manual/linkchecker.config @@ -1,5 +1,3 @@ -[checking] -anchors=1 - [filtering] ignorewarnings=http-robots-denied +ignorewarnings=https-certificate-error diff --git a/Doc/Manual/makechap.py b/Doc/Manual/makechap.py index 8225bfc..61994e2 100644 --- a/Doc/Manual/makechap.py +++ b/Doc/Manual/makechap.py @@ -21,7 +21,7 @@ import string ############################################################################### # Regexs for -alink = re.compile(r"", re.IGNORECASE) +alink = re.compile(r".*", re.IGNORECASE) heading = re.compile(r"(_nn\d)", re.IGNORECASE) def getheadingname(m): @@ -38,6 +38,19 @@ def getheadingname(m): headingname = "%s_nn%d" % (filenamebase, nameindex) return headingname +# Return heading - 1.1. Introduction in the examples below: +# old style example:

      1.1 Introduction

      +# new style example:

      1.1 Introduction

      +def getheadingtext(m, s): + prevheadingtext_newstyle = m.group(2) + prevheadingtext_oldstyle = m.group(3) + if len(prevheadingtext_oldstyle) == 0 and len(prevheadingtext_newstyle) == 0: + raise RuntimeError("No heading text in line:\n%s" % s) + if len(prevheadingtext_oldstyle) > 0 and len(prevheadingtext_newstyle) > 0: + raise RuntimeError("Two heading texts, only one should be specified in line:\n%s" % s) + prevheadingtext = prevheadingtext_oldstyle if len(prevheadingtext_oldstyle) > 0 else prevheadingtext_newstyle + return prevheadingtext + ############################################################################### # Main program ############################################################################### @@ -59,11 +72,11 @@ name = "" # Regexs for

      ,...

      sections -h1 = re.compile(r".*?

      ()*[\d\.\s]*(.*?)

      ", re.IGNORECASE) -h2 = re.compile(r".*?

      ()*[\d\.\s]*(.*?)

      ", re.IGNORECASE) -h3 = re.compile(r".*?

      ()*[\d\.\s]*(.*?)

      ", re.IGNORECASE) -h4 = re.compile(r".*?

      ()*[\d\.\s]*(.*?)

      ", re.IGNORECASE) -h5 = re.compile(r".*?
      ()*[\d\.\s]*(.*?)
      ", re.IGNORECASE) +h1 = re.compile(r".*?

      (\s*[\d\s]*(.*?))*[\d\s]*(.*?)

      ", re.IGNORECASE) +h2 = re.compile(r".*?

      (\s*[\d\.\s]*(.*?))*[\d\.\s]*(.*?)

      ", re.IGNORECASE) +h3 = re.compile(r".*?

      (\s*[\d\.\s]*(.*?))*[\d\.\s]*(.*?)

      ", re.IGNORECASE) +h4 = re.compile(r".*?

      (\s*[\d\.\s]*(.*?))*[\d\.\s]*(.*?)

      ", re.IGNORECASE) +h5 = re.compile(r".*?
      (\s*[\d\.\s]*(.*?))*[\d\.\s]*(.*?)
      ", re.IGNORECASE) data = open(filename).read() # Read data open(filename+".bak","w").write(data) # Make backup @@ -95,10 +108,10 @@ for s in lines: m = h1.match(s) if m: - prevheadingtext = m.group(2) + prevheadingtext = getheadingtext(m, s) nameindex += 1 headingname = getheadingname(m) - result.append("""

      %d %s

      """ % (headingname,num,prevheadingtext)) + result.append("""

      %d %s

      """ % (headingname,num,prevheadingtext)) result.append("@INDEX@") section = 0 subsection = 0 @@ -109,11 +122,11 @@ for s in lines: continue m = h2.match(s) if m: - prevheadingtext = m.group(2) + prevheadingtext = getheadingtext(m, s) nameindex += 1 section += 1 headingname = getheadingname(m) - result.append("""

      %d.%d %s

      """ % (headingname,num,section, prevheadingtext)) + result.append("""

      %d.%d %s

      """ % (headingname,num,section, prevheadingtext)) if subsubsubsection: index += "
    \n" @@ -132,11 +145,11 @@ for s in lines: continue m = h3.match(s) if m: - prevheadingtext = m.group(2) + prevheadingtext = getheadingtext(m, s) nameindex += 1 subsection += 1 headingname = getheadingname(m) - result.append("""

    %d.%d.%d %s

    """ % (headingname,num,section, subsection, prevheadingtext)) + result.append("""

    %d.%d.%d %s

    """ % (headingname,num,section, subsection, prevheadingtext)) if subsubsubsection: index += "\n" @@ -151,12 +164,12 @@ for s in lines: continue m = h4.match(s) if m: - prevheadingtext = m.group(2) + prevheadingtext = getheadingtext(m, s) nameindex += 1 subsubsection += 1 headingname = getheadingname(m) - result.append("""

    %d.%d.%d.%d %s

    """ % (headingname,num,section, subsection, subsubsection, prevheadingtext)) + result.append("""

    %d.%d.%d.%d %s

    """ % (headingname,num,section, subsection, subsubsection, prevheadingtext)) if subsubsubsection: index += "\n" @@ -169,11 +182,11 @@ for s in lines: continue m = h5.match(s) if m: - prevheadingtext = m.group(2) + prevheadingtext = getheadingtext(m, s) nameindex += 1 subsubsubsection += 1 headingname = getheadingname(m) - result.append("""
    %d.%d.%d.%d.%d %s
    """ % (headingname,num,section, subsection, subsubsection, subsubsubsection, prevheadingtext)) + result.append("""
    %d.%d.%d.%d.%d %s
    """ % (headingname,num,section, subsection, subsubsection, subsubsubsection, prevheadingtext)) if subsubsubsection == 1: index += "
      \n" diff --git a/Doc/Manual/maketoc.py b/Doc/Manual/maketoc.py index d8c4aa7..dc86264 100644 --- a/Doc/Manual/maketoc.py +++ b/Doc/Manual/maketoc.py @@ -6,12 +6,14 @@ chs = open("chapters").readlines() f = open("Contents.html","w") print >>f, """ - + SWIG Users Manual + +

      SWIG Users Manual

      diff --git a/Doc/Manual/margin-left.patch b/Doc/Manual/margin-left.patch deleted file mode 100644 index 8bef630..0000000 --- a/Doc/Manual/margin-left.patch +++ /dev/null @@ -1,277 +0,0 @@ -# This patch is against htmldoc 1.8.27, and it hacks in support for -# correctly indenting the

      sections in the SWIG manual. -# This patch should only be used until the 1.9 branch of htmldoc -# stabilizes, since the 1.9 branch includes true CSS1 support. -# -# This patch only affects the PDF generation, an unpatched htmldoc -# creates the one-page html documentation just fine. -# -diff -Naur htmldoc-1.8.27/htmldoc/htmldoc.cxx htmldoc-1.8.27-margin-left/htmldoc/htmldoc.cxx ---- htmldoc-1.8.27/htmldoc/htmldoc.cxx 2006-03-30 14:01:20.000000000 +0100 -+++ htmldoc-1.8.27-margin-left/htmldoc/htmldoc.cxx 2013-05-11 10:11:47.428435647 +0100 -@@ -65,6 +65,8 @@ - const char *__XOS2RedirRoot(const char *); - } - #endif -+ -+extern void parse_style(char *); - - - /* -@@ -1115,6 +1117,7 @@ - else if (compare_strings(argv[i], "--version", 6) == 0) - { - puts(SVERSION); -+ puts("Patched with margin-left.patch"); - return (0); - } - else if (compare_strings(argv[i], "--webpage", 3) == 0) -@@ -2403,6 +2406,10 @@ - } - else if (strcmp(temp, "--cookies") == 0) - file_cookies(temp2); -+ else if (strcmp(temp, "--stylesheet") == 0) -+ { -+ parse_style(temp2); -+ } - } - } - -diff -Naur htmldoc-1.8.27/htmldoc/Makefile htmldoc-1.8.27-margin-left/htmldoc/Makefile ---- htmldoc-1.8.27/htmldoc/Makefile 2005-10-28 21:32:59.000000000 +0100 -+++ htmldoc-1.8.27-margin-left/htmldoc/Makefile 2013-05-11 09:39:04.392367869 +0100 -@@ -36,7 +36,7 @@ - OBJS = gui.o file.o html.o htmldoc.o htmllib.o htmlsep.o \ - http.o http-addr.o http-addrlist.o http-support.o image.o \ - iso8859.o license.o md5.o progress.o ps-pdf.o rc4.o \ -- snprintf.o string.o toc.o util.o -+ snprintf.o string.o toc.o util.o style.o - - - # -diff -Naur htmldoc-1.8.27/htmldoc/ps-pdf.cxx htmldoc-1.8.27-margin-left/htmldoc/ps-pdf.cxx ---- htmldoc-1.8.27/htmldoc/ps-pdf.cxx 2006-08-01 17:58:50.000000000 +0100 -+++ htmldoc-1.8.27-margin-left/htmldoc/ps-pdf.cxx 2013-05-11 09:37:40.096364957 +0100 -@@ -160,6 +160,7 @@ - # undef page_t - #endif // __hpux - -+extern int lookup_div_class(uchar *); - - /* - * Output options... -@@ -4230,9 +4231,24 @@ - para->child = para->last_child = NULL; - } - -- parse_doc(t->child, left, right, bottom, top, x, y, page, NULL, -+ { -+ int num_indent = 0; -+ uchar *cname; -+ -+ if (cname = htmlGetVariable(t, (uchar *)"class")) { -+ num_indent = lookup_div_class(cname); -+ *left += 5.0f * num_indent; -+ *x = *left; -+ } -+ -+ parse_doc(t->child, left, right, bottom, top, x, y, page, NULL, - needspace); - -+ if (num_indent > 0) { -+ *left -= 5.0f * num_indent; -+ } -+ } -+ - if (para->child != NULL) - { - parse_paragraph(para, *left, *right, *bottom, *top, x, y, page, *needspace); -diff -Naur htmldoc-1.8.27/htmldoc/style.cxx htmldoc-1.8.27-margin-left/htmldoc/style.cxx ---- htmldoc-1.8.27/htmldoc/style.cxx 1970-01-01 01:00:00.000000000 +0100 -+++ htmldoc-1.8.27-margin-left/htmldoc/style.cxx 2013-05-11 09:37:40.096364957 +0100 -@@ -0,0 +1,185 @@ -+/* Extreamly simple parsing routines for CSS style sheets. -+ * We only parse div.class { } sections, and only look -+ * for margin-left: em; -+ * -+ * Copyright (C) 2005 John Lenz -+ * -+ * Released under GNU GPL v2 or above. -+ */ -+ -+#include -+#include -+#include -+#include -+#include -+ -+#include "types.h" -+ -+#define BUFF_SIZE 512 -+ -+struct div_entry { -+ uchar class_name[BUFF_SIZE]; -+ int indent; -+ struct div_entry *next; -+}; -+ -+static struct div_entry *head = 0; -+ -+/* These are the parsing states */ -+#define IGNORE_TILL_SEMI 0 -+#define IGNORE_TILL_CLOSE_BRACE 1 -+#define READING_DIV 2 -+#define READING_CLASS 3 -+#define READING_ATTRIBUTE 4 -+#define READING_NUM 5 -+#define CHECKING_ONLY_DIV 6 -+ -+static int at_eof = 0; -+ -+static int strucmp(uchar *a, uchar *b) { -+ int i; -+ for (i = 0; a[i] && b[i]; i++) { -+ if (a[i] < b[i]) return -1; -+ if (a[i] > b[i]) return 1; -+ } -+ /* This isn't right, but who cares...*/ -+ if (a[i] || b[i]) return 1; -+ return 0; -+} -+ -+static int read_word(FILE *f, const char *word) { -+ char c; -+ for (int idx = 0; word[idx]; idx++) { -+ c = getc(f); -+ if (c == EOF) { -+ at_eof = 1; -+ return 0; -+ } -+ if (c != word[idx]) -+ return 0; -+ } -+ return 1; -+} -+ -+int lookup_div_class(uchar *name) { -+ struct div_entry *node = head; -+ -+ while (node) { -+ if (strucmp(node->class_name, name) == 0) -+ return node->indent; -+ node = node->next; -+ } -+ -+ return 0; -+} -+ -+void parse_style(char *fname) { -+ FILE *f; -+ char c; -+ int state; -+ struct div_entry *cur = 0; -+ int class_idx = 0; -+ char num[BUFF_SIZE]; -+ int num_idx = 0; -+ -+ if (!fname) return; -+ -+ f = fopen(fname, "r"); -+ if (!f) { -+ fprintf(stderr, "Unable to parse style\n"); -+ return; -+ } -+ -+ state = READING_DIV; -+ while (!at_eof && (c = getc(f)) != EOF) { -+ switch (state) { -+ -+ case IGNORE_TILL_SEMI: -+ if (c == ';') -+ state = READING_ATTRIBUTE; -+ break; -+ -+ case IGNORE_TILL_CLOSE_BRACE: -+ if (c == '}') -+ state = READING_DIV; -+ break; -+ -+ case READING_DIV: -+ if (c != ' ' && c != '\t' && c != '\n') { -+ if (c == 'd' && read_word(f, "iv.")) { -+ state = READING_CLASS; -+ cur = (struct div_entry *) malloc(sizeof(struct div_entry)); -+ memset(cur, 0, sizeof(struct div_entry)); -+ class_idx = 0; -+ } else -+ state = IGNORE_TILL_CLOSE_BRACE; -+ } -+ break; -+ -+ case READING_CLASS: -+ if (isalpha(c)) { -+ if (class_idx >= BUFF_SIZE-1) { -+ fprintf(stderr, "class size %s too long\n", cur->class_name); -+ free(cur); -+ state = IGNORE_TILL_CLOSE_BRACE; -+ } else { -+ cur->class_name[class_idx++] = c; -+ } -+ } else { -+ if (c == '{') { -+ cur->next = head; -+ head = cur; -+ state = READING_ATTRIBUTE; -+ } else -+ state = CHECKING_ONLY_DIV; -+ } -+ break; -+ -+ case READING_ATTRIBUTE: -+ if (c != ' ' && c != '\t' && c != '\n') { -+ if (c == '}') -+ state = READING_DIV; -+ else { -+ if (c == 'm' && read_word(f, "argin-left:")) { -+ num_idx = 0; -+ memset(num, 0, sizeof(num)); -+ state = READING_NUM; -+ } else { -+ state = IGNORE_TILL_SEMI; -+ } -+ } -+ } -+ break; -+ -+ case READING_NUM: -+ if (isdigit(c)) { -+ if (num_idx >= BUFF_SIZE - 1) { -+ fprintf(stderr, "Number too long\n"); -+ state = IGNORE_TILL_SEMI; -+ } else { -+ num[num_idx++] = c; -+ } -+ } else if (c != ' ' && c != '\t') { -+ if (num_idx > 0 && c == 'e' && read_word(f, "m")) -+ cur->indent = atoi(num); -+ state = IGNORE_TILL_SEMI; -+ } -+ break; -+ -+ case CHECKING_ONLY_DIV: -+ if (c != ' ' && c != '\t' && c != '\n') { -+ if (c == '{') { -+ cur->next = head; -+ head = cur; -+ state = READING_ATTRIBUTE; -+ } else { -+ free(cur); -+ state = IGNORE_TILL_CLOSE_BRACE; -+ } -+ } -+ break; -+ } -+ } -+ -+ fclose(f); -+} diff --git a/Doc/Manual/style.css b/Doc/Manual/style.css index 02329e5..45e51e3 100644 --- a/Doc/Manual/style.css +++ b/Doc/Manual/style.css @@ -32,6 +32,7 @@ div.code { margin-left: 4em; margin-right: 4em; background-color: #F0FFFF; + font-family: "Courier New", Courier, "Courier 10 Pitch", monospace; } div.targetlang { @@ -41,9 +42,9 @@ div.targetlang { margin-left: 4em; margin-right: 4em; background-color: #d7f6bb; + font-family: "Courier New", Courier, "Courier 10 Pitch", monospace; } - div.shell { border-style: solid; border-width: 1px; @@ -51,6 +52,7 @@ div.shell { margin-left: 4em; margin-right: 4em; background-color: #DCDCDC; + font-family: "Courier New", Courier, "Courier 10 Pitch", monospace; } div.diagram { @@ -60,6 +62,7 @@ div.diagram { margin-left: 4em; margin-right: 4em; background-color: #FFEBCD; + font-family: "Courier New", Courier, "Courier 10 Pitch", monospace; } ul li p { @@ -82,3 +85,8 @@ div.indent p { margin-right: 0; } +pre, code, tt { + font-family: "Courier New", Courier, "Courier 10 Pitch", monospace; +} + +body { font-family: serif; } diff --git a/Doc/Manual/swightml.book b/Doc/Manual/swightml.book index 6ab0e04..29b4a9e 100644 --- a/Doc/Manual/swightml.book +++ b/Doc/Manual/swightml.book @@ -7,6 +7,7 @@ Windows.html Scripting.html SWIG.html SWIGPlus.html +CPlusPlus11.html Preprocessor.html Library.html Arguments.html @@ -25,6 +26,7 @@ D.html Go.html Guile.html Java.html +Javascript.html Lisp.html Lua.html Modula3.html @@ -37,5 +39,6 @@ Pike.html Python.html R.html Ruby.html +Scilab.html Tcl.html Extending.html diff --git a/Doc/Manual/swigpdf.book b/Doc/Manual/swigpdf.book deleted file mode 100644 index e66d790..0000000 --- a/Doc/Manual/swigpdf.book +++ /dev/null @@ -1,41 +0,0 @@ -#HTMLDOC 1.8.24 --t pdf13 -f SWIGDocumentation.pdf --book --toclevels 4 --no-numbered --toctitle "Table of Contents" --title --titleimage swig16.png --linkcolor #0000ff --linkstyle underline --size Universal --left 0.50in --right 0.50in --top 0.50in --bottom 0.50in --header .t. --footer h.1 --nup 1 --tocheader .t. --tocfooter ..i --portrait --color --no-pscommands --no-xrxcomments --compression=1 --jpeg=0 --fontsize 10.0 --fontspacing 1.2 --headingfont Helvetica --bodyfont Times --headfootsize 10.0 --headfootfont Helvetica --charset iso-8859-1 --links --no-embedfonts --pagemode outline --pagelayout single --firstpage c1 --pageeffect none --pageduration 10 --effectduration 1.0 --no-encryption --permissions all --owner-password "" --user-password "" --browserwidth 680 --stylesheet style.css -Sections.html -Preface.html -Introduction.html -Windows.html -Scripting.html -SWIG.html -SWIGPlus.html -Preprocessor.html -Library.html -Arguments.html -Typemaps.html -Customization.html -Contract.html -Varargs.html -Warnings.html -Modules.html -CCache.html -Allegrocl.html -Android.html -CSharp.html -Chicken.html -D.html -Go.html -Guile.html -Java.html -Lisp.html -Lua.html -Modula3.html -Mzscheme.html -Ocaml.html -Octave.html -Perl5.html -Php.html -Pike.html -Python.html -R.html -Ruby.html -Tcl.html -Extending.html diff --git a/Examples/Makefile.in b/Examples/Makefile.in index 5607feb..9b51027 100644 --- a/Examples/Makefile.in +++ b/Examples/Makefile.in @@ -14,17 +14,41 @@ # # 2. To use this makefile, set required variables, eg SRCS, INTERFACE, # INTERFACEDIR, INCLUDES, LIBS, TARGET, and do a -# $(MAKE) -f Makefile.template.in SRCS='$(SRCS)' \ +# $(MAKE) -f Makefile.template.in SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ # INCLUDES='$(INCLUDES) LIBS='$(LIBS)' INTERFACE='$(INTERFACE)' \ # INTERFACEDIR='$(INTERFACEDIR)' TARGET='$(TARGET)' method # # 'method' describes what is being built. #--------------------------------------------------------------- +# Regenerate Makefile if Makefile.in or config.status have changed. +Makefile: @srcdir@/Makefile.in ../config.status + cd .. && $(SHELL) ./config.status Examples/Makefile + +# SRCDIR is the relative path to the current source directory +# - For in-source-tree builds, SRCDIR with be either '' or './', but +# '../' for the test suites that build in a subdir (e.g. C#, Java) +# - For out-of-source-tree builds, SRCDIR will be a relative +# path ending with a '/' + +# SRCDIR_SRCS, etc. are $(SRCS), etc. with $(SRCDIR) prepended +SRCDIR_SRCS = $(addprefix $(SRCDIR),$(SRCS)) +SRCDIR_CSRCS = $(addprefix $(SRCDIR),$(CSRCS)) +SRCDIR_CXXSRCS = $(addprefix $(SRCDIR),$(CXXSRCS)) + +ifeq (,$(SRCDIR)) +SRCDIR_INCLUDE = -I. +else +SRCDIR_INCLUDE = -I. -I$(SRCDIR) +endif + TARGET = CC = @CC@ CXX = @CXX@ -CFLAGS = @BOOST_CPPFLAGS@ @PLATFLAGS@ +CPPFLAGS = $(SRCDIR_INCLUDE) +CFLAGS = @PLATCFLAGS@ +CXXFLAGS = @BOOST_CPPFLAGS@ @PLATCXXFLAGS@ +LDFLAGS = prefix = @prefix@ exec_prefix= @exec_prefix@ SRCS = @@ -32,9 +56,15 @@ INCLUDES = LIBS = INTERFACE = INTERFACEDIR = -INTERFACEPATH = $(INTERFACEDIR)$(INTERFACE) +INTERFACEPATH = $(SRCDIR)$(INTERFACEDIR)$(INTERFACE) SWIGOPT = -SWIG = swig + +# SWIG_LIB_DIR and SWIGEXE must be explicitly set by Makefiles using this Makefile +SWIG_LIB_DIR = ./Lib +SWIGEXE = swig +SWIG_LIB_SET = @SWIG_LIB_SET@ +SWIGTOOL = +SWIG = $(SWIG_LIB_SET) $(SWIGTOOL) $(SWIGEXE) LIBM = @LIBM@ LIBC = @LIBC@ @@ -51,11 +81,6 @@ RUNPIPE= RUNME = runme -# X11 options - -XLIB = @XLIBSW@ -XINCLUDE = @XINCLUDES@ - IWRAP = $(INTERFACE:.i=_wrap.i) ISRCS = $(IWRAP:.i=.c) ICXXSRCS = $(IWRAP:.i=.cxx) @@ -92,7 +117,7 @@ endif ################################################################## CPP_DLLIBS = #-L/usr/local/lib/gcc-lib/sparc-sun-solaris2.5.1/2.7.2 \ - -L/usr/local/lib -lg++ -lstdc++ -lgcc + -L/usr/local/lib -lg++ -lstdc++ -lgcc # Solaris workshop 5.0 # CPP_DLLIBS = -L/opt/SUNWspro/lib -lCrun @@ -111,9 +136,17 @@ OBJS = $(SRCS:.c=.@OBJEXT@) $(CXXSRCS:.cxx=.@OBJEXT@) distclean: rm -f Makefile + rm -f d/example.mk rm -f xml/Makefile ################################################################## +# Very generic invocation of swig +################################################################## + +swiginvoke: + $(SWIG) $(SWIGOPT) + +################################################################## ##### Tcl/Tk ###### ################################################################## @@ -130,55 +163,39 @@ TCL_DLNK = @TCLDYNAMICLINKING@ TCL_SO = @TCL_SO@ TCLLDSHARED = @TCLLDSHARED@ TCLCXXSHARED = @TCLCXXSHARED@ -TCL_SCRIPT = $(RUNME).tcl +TCL_SCRIPT = $(SRCDIR)$(RUNME).tcl # ----------------------------------------------------------- # Build a new version of the tclsh shell # ----------------------------------------------------------- - -tclsh: $(SRCS) - $(SWIG) -tcl8 $(SWIGOPT) $(TCL_SWIGOPTS) -ltclsh.i $(INTERFACEPATH) - $(CC) $(CFLAGS) $(SRCS) $(ISRCS) $(INCLUDES) $(TCL_INCLUDE) \ +tclsh: $(SRCDIR_SRCS) + $(SWIG) -tcl8 $(SWIGOPT) $(TCL_SWIGOPTS) -ltclsh.i -o $(ISRCS) $(INTERFACEPATH) + $(CC) $(CPPFLAGS) $(CFLAGS) $(LDFLAGS) $(SRCDIR_SRCS) $(ISRCS) $(INCLUDES) $(TCL_INCLUDE) \ $(TCL_LIB) $(TCL_OPTS) $(LIBS) $(SYSLIBS) -o $(TARGET) -tclsh_cpp: $(SRCS) - $(SWIG) -tcl8 -c++ $(SWIGOPT) $(TCL_SWIGOPTS) -ltclsh.i $(INTERFACEPATH) - $(CXX) $(CFLAGS) $(SRCS) $(CXXSRCS) $(ICXXSRCS) $(INCLUDES) $(TCL_INCLUDE) \ +tclsh_cpp: $(SRCDIR_SRCS) + $(SWIG) -tcl8 -c++ $(SWIGOPT) $(TCL_SWIGOPTS) -ltclsh.i -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) $(CPPFLAGS) $(CXXFLAGS) $(LDFLAGS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(ICXXSRCS) $(INCLUDES) $(TCL_INCLUDE) \ $(TCL_LIB) $(TCL_OPTS) $(LIBS) $(SYSLIBS) -o $(TARGET) # ----------------------------------------------------------- -# Build a new copy of wish -# ----------------------------------------------------------- - -wish: $(SRCS) - $(SWIG) -tcl8 $(SWIGOPT) $(TCL_SWIGOPTS) -lwish.i $(INTERFACEPATH) - $(CC) $(CFLAGS) $(SRCS) $(ISRCS) $(INCLUDES) $(TCL_INCLUDE) \ - $(XINCLUDE) $(TCL_LIB) $(TK_OPTS) $(XLIB) $(LIBS) $(SYSLIBS) -o $(TARGET) - - -wish_cpp: $(SRCS) - $(SWIG) -tcl8 -c++ $(SWIGOPT) $(TCL_SWIGOPTS) -lwish.i $(INTERFACEPATH) - $(CXX) $(CFLAGS) $(SRCS) $(CXXSRCS) $(ICXXSRCS) $(INCLUDES) $(TCL_INCLUDE) \ - $(XINCLUDE) $(TCL_LIB) $(TK_OPTS) $(XLIB) $(LIBS) $(SYSLIBS) -o $(TARGET) - -# ----------------------------------------------------------- # Build a Tcl dynamic loadable module (you might need to tweak this) # ----------------------------------------------------------- -tcl: $(SRCS) - $(SWIG) -tcl8 $(SWIGOPT) $(TCL_SWIGOPTS) $(INTERFACEPATH) - $(CC) -c $(CCSHARED) $(CFLAGS) $(SRCS) $(ISRCS) $(INCLUDES) $(TCL_INCLUDE) - $(TCLLDSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(TCL_DLNK) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(TCL_SO) +tcl: $(SRCDIR_SRCS) + $(SWIG) -tcl8 $(SWIGOPT) $(TCL_SWIGOPTS) -o $(ISRCS) $(INTERFACEPATH) + $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(SRCDIR_SRCS) $(ISRCS) $(INCLUDES) $(TCL_INCLUDE) + $(TCLLDSHARED) $(CFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(TCL_DLNK) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(TCL_SO) # ----------------------------------------------------------- # Build a Tcl7.5 dynamic loadable module for C++ # ----------------------------------------------------------- -tcl_cpp: $(SRCS) - $(SWIG) -tcl8 -c++ $(SWIGOPT) $(TCL_SWIGOPTS) $(INTERFACEPATH) - $(CXX) -c $(CCSHARED) $(CFLAGS) $(SRCS) $(CXXSRCS) $(ICXXSRCS) $(INCLUDES) $(TCL_INCLUDE) - $(TCLCXXSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(TCL_DLNK) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(TCL_SO) +tcl_cpp: $(SRCDIR_SRCS) + $(SWIG) -tcl8 -c++ $(SWIGOPT) $(TCL_SWIGOPTS) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(ICXXSRCS) $(INCLUDES) $(TCL_INCLUDE) + $(TCLCXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(TCL_DLNK) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(TCL_SO) # ----------------------------------------------------------------- # Run Tcl example @@ -201,7 +218,7 @@ tcl_version: tcl_clean: rm -f *_wrap* *~ .~* mytclsh@EXEEXT@ rm -f core @EXTRA_CLEAN@ - rm -f *.@OBJEXT@ *@SO@ + rm -f *.@OBJEXT@ *$(TCL_SO) ################################################################## ##### PERL 5 ###### @@ -221,44 +238,44 @@ PERL5_CCCDLFLAGS = @PERL5CCCDLFLAGS@ PERL5_LDFLAGS = @PERL5LDFLAGS@ PERL = @PERL@ PERL5_LIB = -L$(PERL5_INCLUDE) -l@PERL5LIB@ @LIBS@ $(SYSLIBS) -PERL5_SCRIPT = $(RUNME).pl +PERL5_SCRIPT = $(SRCDIR)$(RUNME).pl # ---------------------------------------------------------------- # Build a Perl5 dynamically loadable module (C) # ---------------------------------------------------------------- -perl5: $(SRCS) - $(SWIG) -perl5 $(SWIGOPT) $(INTERFACEPATH) - $(CC) -c -Dbool=char $(CCSHARED) $(CFLAGS) $(SRCS) $(ISRCS) $(INCLUDES) $(PERL5_CCFLAGS) $(PERL5_CCCDLFLAGS) -I$(PERL5_INCLUDE) - $(LDSHARED) $(CFLAGS) $(PERL5_CCDLFLAGS) $(OBJS) $(IOBJS) $(PERL5_LDFLAGS) $(PERL5_DLNK) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(SO) +perl5: $(SRCDIR_SRCS) + $(SWIG) -perl5 $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) -c -Dbool=char $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(SRCDIR_SRCS) $(ISRCS) $(INCLUDES) $(PERL5_CCFLAGS) $(PERL5_CCCDLFLAGS) -I$(PERL5_INCLUDE) + $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(PERL5_CCDLFLAGS) $(OBJS) $(IOBJS) $(PERL5_LDFLAGS) $(PERL5_DLNK) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(SO) # ---------------------------------------------------------------- # Build a Perl5 dynamically loadable module (C++) # ---------------------------------------------------------------- -perl5_cpp: $(SRCS) - $(SWIG) -perl5 -c++ $(SWIGOPT) $(INTERFACEPATH) - $(CXX) -c $(CCSHARED) $(CFLAGS) $(SRCS) $(CXXSRCS) $(ICXXSRCS) $(INCLUDES) $(PERL5_CCFLAGS) $(PERL5_CCCDLFLAGS) -I$(PERL5_INCLUDE) - $(CXXSHARED) $(CFLAGS) $(PERL5_CCDLFLAGS) $(OBJS) $(IOBJS) $(PERL5_LDFLAGS) $(PERL5_DLNK) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(SO) +perl5_cpp: $(SRCDIR_SRCS) + $(SWIG) -perl5 -c++ $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(ICXXSRCS) $(INCLUDES) $(PERL5_CCFLAGS) $(PERL5_CCCDLFLAGS) -I$(PERL5_INCLUDE) + $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(PERL5_CCDLFLAGS) $(OBJS) $(IOBJS) $(PERL5_LDFLAGS) $(PERL5_DLNK) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(SO) # ---------------------------------------------------------------- # Build a module from existing XS C source code. (ie. from xsubpp). # ---------------------------------------------------------------- -perl5_xs: $(SRCS) - $(CC) -c $(CCSHARED) $(CFLAGS) $(SRCS) $(INCLUDES) -I$(PERL5_INCLUDE) - $(LDSHARED) $(CFLAGS) $(OBJS) $(LIBS) -o $(TARGET)$(SO) +perl5_xs: $(SRCDIR_SRCS) + $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(SRCDIR_SRCS) $(INCLUDES) -I$(PERL5_INCLUDE) + $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(OBJS) $(LIBS) -o $(TARGET)$(SO) # ---------------------------------------------------------------- # Build a statically linked Perl5 executable # ---------------------------------------------------------------- -perl5_static: $(SRCS) - $(SWIG) -perl5 -static -lperlmain.i $(SWIGOPT) $(INTERFACEPATH) - $(CC) $(CFLAGS) -Dbool=char $(SRCS) $(ISRCS) $(INCLUDES) -I$(PERL5_INCLUDE) $(PERL5_LIB) $(LIBS) -o $(TARGET) +perl5_static: $(SRCDIR_SRCS) + $(SWIG) -perl5 -static -lperlmain.i $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) $(CPPFLAGS) $(CFLAGS) $(LDFLAGS) -Dbool=char $(SRCDIR_SRCS) $(ISRCS) $(INCLUDES) -I$(PERL5_INCLUDE) $(PERL5_LIB) $(LIBS) -o $(TARGET) -perl5_static_cpp: $(SRCS) - $(SWIG) -perl5 -c++ -static -lperlmain.i $(SWIGOPT) $(INTERFACEPATH) - $(CXX) $(CFLAGS) $(SRCS) $(CXXSRCS) $(ICXXSRCS) $(INCLUDES) -I$(PERL5_INCLUDE) $(PERL5_LIB) $(LIBS) -o $(TARGET) +perl5_static_cpp: $(SRCDIR_SRCS) + $(SWIG) -perl5 -c++ -static -lperlmain.i $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) $(CPPFLAGS) $(CXXFLAGS) $(LDFLAGS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(ICXXSRCS) $(INCLUDES) -I$(PERL5_INCLUDE) $(PERL5_LIB) $(LIBS) -o $(TARGET) # ----------------------------------------------------------------- # Running a Perl5 example @@ -287,15 +304,17 @@ perl5_clean: ##### PYTHON ###### ################################################################## +PYTHON_FLAGS = + # Make sure these locate your Python installation ifeq (,$(PY3)) PYTHON_INCLUDE= $(DEFS) @PYINCLUDE@ PYTHON_LIB = @PYLIB@ - PYTHON = @PYTHON@ + PYTHON = @PYTHON@ $(PYTHON_FLAGS) else PYTHON_INCLUDE= $(DEFS) @PY3INCLUDE@ PYTHON_LIB = @PY3LIB@ - PYTHON = @PYTHON3@ + PYTHON = @PYTHON3@ $(PYTHON_FLAGS) endif # Extra Python specific linking options @@ -308,30 +327,33 @@ else endif PYTHON_SO = @PYTHON_SO@ -# SWIG option for Python +# SWIG option for Python3 ifeq (,$(PY3)) - SWIGPYTHON = $(SWIG) -python + SWIGOPTPY3 = else - SWIGPYTHON = $(SWIG) -python -py3 + SWIGOPTPY3 = -py3 endif +PEP8 = @PEP8@ +PEP8_FLAGS = --ignore=E402,E501,E30,W291,W391 + # ---------------------------------------------------------------- # Build a C dynamically loadable module # ---------------------------------------------------------------- -python: $(SRCS) - $(SWIGPYTHON) $(SWIGOPT) $(INTERFACEPATH) - $(CC) -c $(CCSHARED) $(CFLAGS) $(ISRCS) $(SRCS) $(INCLUDES) $(PYTHON_INCLUDE) - $(LDSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(PYTHON_DLNK) $(LIBS) -o $(LIBPREFIX)_$(TARGET)$(PYTHON_SO) +python: $(SRCDIR_SRCS) + $(SWIG) -python $(SWIGOPTPY3) $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(ISRCS) $(SRCDIR_SRCS) $(INCLUDES) $(PYTHON_INCLUDE) + $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(PYTHON_DLNK) $(LIBS) -o $(LIBPREFIX)_$(TARGET)$(PYTHON_SO) # ----------------------------------------------------------------- # Build a C++ dynamically loadable module # ----------------------------------------------------------------- -python_cpp: $(SRCS) - $(SWIGPYTHON) -c++ $(SWIGOPT) $(INTERFACEPATH) - $(CXX) -c $(CCSHARED) $(CFLAGS) $(ICXXSRCS) $(SRCS) $(CXXSRCS) $(INCLUDES) $(PYTHON_INCLUDE) - $(CXXSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(PYTHON_DLNK) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)_$(TARGET)$(PYTHON_SO) +python_cpp: $(SRCDIR_SRCS) + $(SWIG) -python $(SWIGOPTPY3) -c++ $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(INCLUDES) $(PYTHON_INCLUDE) + $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(PYTHON_DLNK) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)_$(TARGET)$(PYTHON_SO) # ----------------------------------------------------------------- # Build statically linked Python interpreter @@ -344,14 +366,14 @@ python_cpp: $(SRCS) TKINTER = PYTHON_LIBOPTS = $(PYTHON_LINK) @LIBS@ $(TKINTER) $(SYSLIBS) -python_static: $(SRCS) - $(SWIGPYTHON) -lembed.i $(SWIGOPT) $(INTERFACEPATH) - $(CC) $(CFLAGS) @LINKFORSHARED@ $(ISRCS) $(SRCS) $(INCLUDES) \ +python_static: $(SRCDIR_SRCS) + $(SWIG) -python $(SWIGOPTPY3) -lembed.i $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) $(CPPFLAGS) $(CFLAGS) $(LDFLAGS) @LINKFORSHARED@ $(ISRCS) $(SRCDIR_SRCS) $(INCLUDES) \ $(PYTHON_INCLUDE) $(LIBS) -L$(PYTHON_LIB) $(PYTHON_LIBOPTS) -o $(TARGET) -python_static_cpp: $(SRCS) - $(SWIGPYTHON) -c++ -lembed.i $(SWIGOPT) $(INTERFACEPATH) - $(CXX) $(CFLAGS) $(ICXXSRCS) $(SRCS) $(CXXSRCS) $(INCLUDES) \ +python_static_cpp: $(SRCDIR_SRCS) + $(SWIG) -python $(SWIGOPTPY3) -c++ -lembed.i $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) $(CPPFLAGS) $(CXXFLAGS) $(LDFLAGS) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(INCLUDES) \ $(PYTHON_INCLUDE) $(LIBS) -L$(PYTHON_LIB) $(PYTHON_LIBOPTS) -o $(TARGET) # ----------------------------------------------------------------- @@ -367,9 +389,17 @@ endif PY2TO3 = 2to3 `2to3 -l | grep -v -E "Available|import$$" | awk '{print "-f "$$0}'` python_run: $(PYSCRIPT) - $(RUNTOOL) $(PYTHON) $(PYSCRIPT) $(RUNPIPE) +ifneq (,$(PEP8)) + $(COMPILETOOL) $(PEP8) $(PEP8_FLAGS) $(PYSCRIPT) +endif + env PYTHONPATH=$$PWD $(RUNTOOL) $(PYTHON) $(PYSCRIPT) $(RUNPIPE) + +ifneq (,$(SRCDIR)) +$(RUNME).py: $(SRCDIR)$(RUNME).py + cp $< $@ +endif -$(RUNME)3.py: $(RUNME).py +$(RUNME)3.py: $(SRCDIR)$(RUNME).py cp $< $@ $(PY2TO3) -w $@ >/dev/null 2>&1 @@ -388,9 +418,10 @@ python_clean: rm -rf __pycache__ rm -f *_wrap* *~ .~* mypython@EXEEXT@ *.pyc rm -f core @EXTRA_CLEAN@ - rm -f *.@OBJEXT@ *@SO@ *@PYTHON_SO@ + rm -f *.@OBJEXT@ *@SO@ *$(PYTHON_SO) rm -f $(TARGET).py - if [ -f $(RUNME).py ]; then rm -f $(RUNME)3.py $(RUNME)3.py.bak; fi + if test -f $(SRCDIR)$(RUNME).py; then rm -f $(RUNME)3.py $(RUNME)3.py.bak; fi + case "x$(SRCDIR)" in x|x./);; *) rm -f $(RUNME).py;; esac ################################################################## @@ -398,41 +429,41 @@ python_clean: ################################################################## # Make sure these locate your Octave installation -OCTAVE = OCTAVE_HISTFILE=/dev/null @OCTAVE@ +OCTAVE = @OCTAVE@ OCTAVE_CXX = $(DEFS) @OCTAVE_CPPFLAGS@ @OCTAVE_CXXFLAGS@ # Extra Octave specific dynamic linking options OCTAVE_DLNK = @OCTAVE_LDFLAGS@ OCTAVE_SO = @OCTAVE_SO@ -OCTAVE_SCRIPT = $(RUNME).m +OCTAVE_SCRIPT = $(SRCDIR)$(RUNME).m # ---------------------------------------------------------------- # Build a C dynamically loadable module # Note: Octave requires C++ compiler when compiling C wrappers # ---------------------------------------------------------------- -octave: $(SRCS) - $(SWIG) -octave $(SWIGOPT) $(INTERFACEPATH) - $(CXX) -g -c $(CCSHARED) $(CFLAGS) $(ICXXSRCS) $(INCLUDES) $(OCTAVE_CXX) - $(CC) -g -c $(CCSHARED) $(CFLAGS) $(SRCS) $(CSRCS) $(INCLUDES) - $(LDSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(OCTAVE_DLNK) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(OCTAVE_SO) +octave: $(SRCDIR_SRCS) + $(SWIG) -octave $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) -g -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(ICXXSRCS) $(INCLUDES) $(OCTAVE_CXX) + $(CC) -g -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(SRCDIR_SRCS) $(SRCDIR_CSRCS) $(INCLUDES) + $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(OCTAVE_DLNK) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(OCTAVE_SO) # ----------------------------------------------------------------- # Build a C++ dynamically loadable module # ----------------------------------------------------------------- -octave_cpp: $(SRCS) - $(SWIG) -c++ -octave $(SWIGOPT) $(INTERFACEPATH) - $(CXX) -g -c $(CCSHARED) $(CFLAGS) $(ICXXSRCS) $(SRCS) $(CXXSRCS) $(INCLUDES) $(OCTAVE_CXX) - $(CXXSHARED) -g $(CFLAGS) $(OBJS) $(IOBJS) $(OCTAVE_DLNK) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(OCTAVE_SO) +octave_cpp: $(SRCDIR_SRCS) + $(SWIG) -c++ -octave $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) -g -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(INCLUDES) $(OCTAVE_CXX) + $(CXXSHARED) -g $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(OCTAVE_DLNK) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(OCTAVE_SO) # ----------------------------------------------------------------- # Running an Octave example # ----------------------------------------------------------------- octave_run: - $(RUNTOOL) $(OCTAVE) $(OCTAVE_SCRIPT) $(RUNPIPE) + OCTAVE_HISTFILE=/dev/null $(RUNTOOL) $(OCTAVE) $(OCTAVE_SCRIPT) $(RUNPIPE) # ----------------------------------------------------------------- # Version display @@ -449,7 +480,7 @@ octave_clean: rm -rf __pycache__ rm -f *_wrap* *~ .~* myoctave@EXEEXT@ *.pyc rm -f core @EXTRA_CLEAN@ - rm -f *.@OBJEXT@ *@SO@ *@OCTAVE_SO@ + rm -f *.@OBJEXT@ *@SO@ *$(OCTAVE_SO) ################################################################## ##### GUILE ###### @@ -462,21 +493,20 @@ GUILE_SO = @GUILE_SO@ GUILE_LIBS = @GUILE_LIBS@ GUILE_LIBOPTS = @LIBS@ $(SYSLIBS) GUILE_LIBPREFIX = lib -GUILE_SCRIPT = $(RUNME).scm +GUILE_SCRIPT = $(SRCDIR)$(RUNME).scm #------------------------------------------------------------------ # Build a dynamically loaded module with passive linkage #------------------------------------------------------------------ -guile: $(SRCS) - $(SWIG) -guile -Linkage passive $(SWIGOPT) $(INTERFACEPATH) - $(CC) -c $(CCSHARED) $(CFLAGS) $(INCLUDES) $(GUILE_CFLAGS) $(ISRCS) $(SRCS) - $(LDSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(GUILE_LIBS) $(LIBS) -o $(GUILE_LIBPREFIX)$(TARGET)$(GUILE_SO) +guile: $(SRCDIR_SRCS) + $(SWIG) -guile -Linkage passive $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(INCLUDES) $(GUILE_CFLAGS) $(ISRCS) $(SRCDIR_SRCS) + $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(GUILE_LIBS) $(LIBS) -o $(GUILE_LIBPREFIX)$(TARGET)$(GUILE_SO) -guile_cpp: $(GUILE_LIBPREFIX)$(TARGET)$(GUILE_SO) -$(GUILE_LIBPREFIX)$(TARGET)$(GUILE_SO): $(SRCS) - $(SWIG) -c++ -guile -Linkage passive $(SWIGOPT) $(INTERFACEPATH) - $(CXX) -c $(CCSHARED) $(CFLAGS) $(INCLUDES) $(GUILE_CFLAGS) $(ICXXSRCS) $(SRCS) $(CXXSRCS) - $(CXXSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(GUILE_LIBS) $(LIBS) $(CPP_DLLIBS) -o $@ +guile_cpp: $(SRCDIR_SRCS) + $(SWIG) -c++ -guile -Linkage passive $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(INCLUDES) $(GUILE_CFLAGS) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) + $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(GUILE_LIBS) $(LIBS) $(CPP_DLLIBS) -o $(GUILE_LIBPREFIX)$(TARGET)$(GUILE_SO) guile_externalhdr: $(SWIG) -guile -external-runtime $(TARGET) @@ -485,34 +515,34 @@ guile_externalhdr: # Build Guile interpreter augmented with extra functions # ----------------------------------------------------------------- -guile_augmented: - $(SWIG) -guile $(SWIGOPT) $(INTERFACE) - $(CC) $(CFLAGS) $(SRCS) $(ISRCS) $(GUILE_CFLAGS) $(GUILE_LIBS) $(LIBS) -o $(TARGET) +guile_augmented: $(SRCDIR_SRCS) + $(SWIG) -guile $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) $(CPPFLAGS) $(CFLAGS) $(LDFLAGS) $(SRCDIR_SRCS) $(ISRCS) $(GUILE_CFLAGS) $(GUILE_LIBS) $(LIBS) -o $(TARGET) # ----------------------------------------------------------------- # Build statically linked Guile interpreter # ----------------------------------------------------------------- -guile_static: $(SRCS) - $(SWIG) -guile -lguilemain.i -Linkage ltdlmod $(SWIGOPT) $(INTERFACEPATH) - $(CC) $(CFLAGS) $(ISRCS) $(SRCS) $(INCLUDES) \ +guile_static: $(SRCDIR_SRCS) + $(SWIG) -guile -lguilemain.i -Linkage ltdlmod $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) $(CPPFLAGS) $(CFLAGS) $(LDFLAGS) $(ISRCS) $(SRCDIR_SRCS) $(INCLUDES) \ -DSWIGINIT="SCM scm_init_$(TARGET)_module(void); scm_init_$(TARGET)_module();" \ $(GUILE_CFLAGS) $(GUILE_LIBS) $(LIBS) $(GUILE_LIBOPTS) -o $(TARGET)-guile -guile_static_cpp: $(SRCS) - $(SWIG) -c++ -guile -lguilemain.i -Linkage ltdlmod $(SWIGOPT) $(INTERFACEPATH) - $(CXX) $(CFLAGS) $(ICXXSRCS) $(SRCS) $(CXXSRCS) $(INCLUDES) \ +guile_static_cpp: $(SRCDIR_SRCS) + $(SWIG) -c++ -guile -lguilemain.i -Linkage ltdlmod $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) $(CPPFLAGS) $(CXXFLAGS) $(LDFLAGS) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(INCLUDES) \ -DSWIGINIT="SCM scm_init_$(TARGET)_module(void); scm_init_$(TARGET)_module();" \ $(GUILE_CFLAGS) $(GUILE_LIBS) $(LIBS) $(GUILE_LIBOPTS) -o $(TARGET)-guile -guile_simple: $(SRCS) - $(SWIG) -guile -lguilemain.i -Linkage simple $(SWIGOPT) $(INTERFACEPATH) - $(CC) $(CFLAGS) $(ISRCS) $(SRCS) $(INCLUDES) \ +guile_simple: $(SRCDIR_SRCS) + $(SWIG) -guile -lguilemain.i -Linkage simple $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) $(CPPFLAGS) $(CFLAGS) $(LDFLAGS) $(ISRCS) $(SRCDIR_SRCS) $(INCLUDES) \ $(GUILE_CFLAGS) $(GUILE_LIBS) $(LIBS) $(GUILE_LIBOPTS) -o $(TARGET)-guile -guile_simple_cpp: $(SRCS) - $(SWIG) -c++ -guile -lguilemain.i -Linkage simple $(SWIGOPT) $(INTERFACEPATH) - $(CXX) $(CFLAGS) $(ICXXSRCS) $(SRCS) $(CXXSRCS) $(INCLUDES) \ +guile_simple_cpp: $(SRCDIR_SRCS) + $(SWIG) -c++ -guile -lguilemain.i -Linkage simple $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) $(CPPFLAGS) $(CXXFLAGS) $(LDFLAGS) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(INCLUDES) \ $(GUILE_CFLAGS) $(GUILE_LIBS) $(LIBS) $(GUILE_LIBOPTS) -o $(TARGET)-guile # ----------------------------------------------------------------- @@ -539,7 +569,7 @@ guile_version: guile_clean: rm -f *_wrap* *~ .~* my-guile@EXEEXT@ $(TARGET)@EXEEXT@ rm -f core @EXTRA_CLEAN@ - rm -f *.@OBJEXT@ *@GUILE_SO@ + rm -f *.@OBJEXT@ *$(GUILE_SO) ################################################################## ##### JAVA ###### @@ -557,40 +587,41 @@ JAVASO =@JAVASO@ JAVALDSHARED = @JAVALDSHARED@ JAVACXXSHARED = @JAVACXXSHARED@ JAVACFLAGS = @JAVACFLAGS@ +JAVAFLAGS = @JAVAFLAGS@ JAVA = @JAVA@ -JAVAC = @JAVAC@ +JAVAC = @JAVAC@ -d . # ---------------------------------------------------------------- # Build a java dynamically loadable module (C) # ---------------------------------------------------------------- -java: $(SRCS) - $(SWIG) -java $(SWIGOPT) $(INTERFACEPATH) - $(CC) -c $(CCSHARED) $(CFLAGS) $(JAVACFLAGS) $(SRCS) $(ISRCS) $(INCLUDES) $(JAVA_INCLUDE) - $(JAVALDSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(JAVA_DLNK) $(LIBS) -o $(JAVA_LIBPREFIX)$(TARGET)$(JAVASO) +java: $(SRCDIR_SRCS) + $(SWIG) -java $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(JAVACFLAGS) $(SRCDIR_SRCS) $(ISRCS) $(INCLUDES) $(JAVA_INCLUDE) + $(JAVALDSHARED) $(CFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(JAVA_DLNK) $(LIBS) -o $(JAVA_LIBPREFIX)$(TARGET)$(JAVASO) # ---------------------------------------------------------------- # Build a java dynamically loadable module (C++) # ---------------------------------------------------------------- -java_cpp: $(SRCS) - $(SWIG) -java -c++ $(SWIGOPT) $(INTERFACEPATH) - $(CXX) -c $(CCSHARED) $(CFLAGS) $(JAVACFLAGS) $(SRCS) $(CXXSRCS) $(ICXXSRCS) $(INCLUDES) $(JAVA_INCLUDE) - $(JAVACXXSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(JAVA_DLNK) $(LIBS) $(CPP_DLLIBS) -o $(JAVA_LIBPREFIX)$(TARGET)$(JAVASO) +java_cpp: $(SRCDIR_SRCS) + $(SWIG) -java -c++ $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(JAVACFLAGS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(ICXXSRCS) $(INCLUDES) $(JAVA_INCLUDE) + $(JAVACXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(JAVA_DLNK) $(LIBS) $(CPP_DLLIBS) -o $(JAVA_LIBPREFIX)$(TARGET)$(JAVASO) # ---------------------------------------------------------------- # Compile java files # ---------------------------------------------------------------- -java_compile: $(SRCS) - $(COMPILETOOL) $(JAVAC) $(JAVACFLAGS) $(JAVASRCS) +java_compile: $(SRCDIR_SRCS) + $(COMPILETOOL) $(JAVAC) $(addprefix $(SRCDIR),$(JAVASRCS)) # ----------------------------------------------------------------- # Run java example # ----------------------------------------------------------------- java_run: - env LD_LIBRARY_PATH=. $(RUNTOOL) $(JAVA) $(RUNME) $(RUNPIPE) + env LD_LIBRARY_PATH=$$PWD $(RUNTOOL) $(JAVA) $(JAVAFLAGS) $(RUNME) $(RUNPIPE) # ----------------------------------------------------------------- # Version display @@ -610,20 +641,130 @@ java_clean: rm -f *.@OBJEXT@ *@JAVASO@ ################################################################## +##### JAVASCRIPT ###### +################################################################## + +# Note: These targets are also from within Makefiles in the Example directories. +# There is a common makefile, 'Examples/javascript/js_example.mk' to simplify +# create a configuration for a new example. + +ROOT_DIR = @ROOT_DIR@ +JSINCLUDES = @JSCOREINC@ @JSV8INC@ +JSDYNAMICLINKING = @JSCOREDYNAMICLINKING@ @JSV8DYNAMICLINKING@ +NODEJS = @NODEJS@ +NODEGYP = @NODEGYP@ + +# ---------------------------------------------------------------- +# Creating and building Javascript wrappers +# ---------------------------------------------------------------- + +javascript_wrapper: + $(SWIG) -javascript $(SWIGOPT) -o $(INTERFACEDIR)$(TARGET)_wrap.c $(INTERFACEPATH) + +javascript_wrapper_cpp: $(SRCDIR_SRCS) + $(SWIG) -javascript -c++ $(SWIGOPT) -o $(INTERFACEDIR)$(TARGET)_wrap.cxx $(INTERFACEPATH) + +javascript_build: $(SRCDIR_SRCS) + $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(ISRCS) $(SRCDIR_SRCS) $(INCLUDES) $(JSINCLUDES) + $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(JSDYNAMICLINKING) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(SO) + +javascript_build_cpp: $(SRCDIR_SRCS) +ifeq (node,$(JSENGINE)) + sed -e 's|$$srcdir|./$(SRCDIR)|g' $(SRCDIR)binding.gyp.in > binding.gyp + $(NODEGYP) --loglevel=silent configure build 1>>/dev/null +else + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(INCLUDES) $(JSINCLUDES) + $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(JSDYNAMICLINKING) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(SO) + +endif + +# These targets are used by the test-suite: + +javascript: $(SRCDIR_SRCS) javascript_custom_interpreter + $(SWIG) -javascript $(SWIGOPT) $(INTERFACEPATH) +ifeq (jsc, $(ENGINE)) + $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(ISRCS) $(SRCDIR_SRCS) $(INCLUDES) $(JSINCLUDES) + $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(JSDYNAMICLINKING) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(SO) +else # (v8 | node) # v8 and node must be compiled as c++ + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(ISRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(INCLUDES) $(JSINCLUDES) + $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(JSDYNAMICLINKING) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(SO) +endif + +javascript_cpp: $(SRCDIR_SRCS) javascript_custom_interpreter + $(SWIG) -javascript -c++ $(SWIGOPT) $(INTERFACEPATH) + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(INCLUDES) $(JSINCLUDES) + $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(JSDYNAMICLINKING) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(SO) + +# ----------------------------------------------------------------- +# Running a Javascript example +# ----------------------------------------------------------------- + +javascript_custom_interpreter: + (cd $(ROOT_DIR)/Tools/javascript && $(MAKE) JSENGINE='$(JSENGINE)') + +ifeq (node,$(JSENGINE)) +javascript_run: + env NODE_PATH=$$PWD:$(SRCDIR) $(RUNTOOL) $(NODEJS) $(SRCDIR)$(RUNME).js $(RUNPIPE) +else +javascript_run: javascript_custom_interpreter + $(RUNTOOL) $(ROOT_DIR)/Tools/javascript/javascript -$(JSENGINE) -L $(TARGET) $(SRCDIR)$(RUNME).js $(RUNPIPE) +endif + +# ----------------------------------------------------------------- +# Version display +# ----------------------------------------------------------------- + +javascript_version: +ifeq (, $(ENGINE)) + @if [ "$(NODEJS)" != "" ]; then \ + echo "Node.js: `($(NODEJS) --version)`"; \ + echo "node-gyp: `($(NODEGYP) --version)`"; \ + else \ + echo "Version depends on the interpreter"; \ + fi +endif +ifeq (node, $(ENGINE)) + echo "Node.js: `($(NODEJS) --version)`" + echo "node-gyp: `($(NODEGYP) --version)`" +endif +ifeq (jsc, $(ENGINE)) + @if [ "@JSCOREVERSION@" != "" ]; then \ + echo "@JSCOREVERSION@"; \ + else \ + echo "Unknown JavascriptCore version."; \ + fi +endif +ifeq (v8, $(ENGINE)) + echo "Unknown v8 version." +endif + +# ----------------------------------------------------------------- +# Cleaning the Javascript examples +# ----------------------------------------------------------------- + +javascript_clean: + rm -rf build + rm -f *_wrap* $(RUNME) + rm -f core @EXTRA_CLEAN@ + rm -f *.@OBJEXT@ *@SO@ + rm -f binding.gyp example-gypcopy.cxx + cd $(ROOT_DIR)/Tools/javascript && $(MAKE) -s clean + +################################################################## ##### ANDROID ###### ################################################################## -ANDROID = android -ANDROID_NDK_BUILD = ndk-build -ANDROID_ADB = adb -ANT = ant +ANDROID = @ANDROID@ +ANDROID_NDK_BUILD = @NDKBUILD@ +ANDROID_ADB = @ADB@ +ANT = @ANT@ TARGETID = 1 # ---------------------------------------------------------------- # Build an Android dynamically loadable module (C) # ---------------------------------------------------------------- -android: $(SRCS) +android: $(SRCDIR_SRCS) $(ANDROID) $(SILENT_OPTION) update project --target $(TARGETID) --name $(PROJECTNAME) --path . $(SWIG) -java $(SWIGOPT) -o $(INTERFACEDIR)$(TARGET)_wrap.c $(INTERFACEPATH) +$(ANDROID_NDK_BUILD) $(SILENT_PIPE) @@ -633,7 +774,7 @@ android: $(SRCS) # Build an Android dynamically loadable module (C++) # ---------------------------------------------------------------- -android_cpp: $(SRCS) +android_cpp: $(SRCDIR_SRCS) $(ANDROID) $(SILENT_OPTION) update project --target $(TARGETID) --name $(PROJECTNAME) --path . $(SWIG) -java -c++ $(SWIGOPT) -o $(INTERFACEDIR)$(TARGET)_wrap.cpp $(INTERFACEPATH) +$(ANDROID_NDK_BUILD) $(SILENT_PIPE) @@ -659,7 +800,7 @@ android_version: # ----------------------------------------------------------------- android_clean: - ant -q -logfile /dev/null clean + test -n "$(SRCDIR)" && cd $(SRCDIR) ; $(ANT) -q -logfile /dev/null clean rm -f $(INTERFACEDIR)$(TARGET)_wrap.* rm -f `find $(PACKAGEDIR) -name \*.java | grep -v $(PROJECTNAME).java` rm -rf obj @@ -674,13 +815,11 @@ MODULA3_INCLUDE= @MODULA3INC@ # Build a modula3 dynamically loadable module (C) # ---------------------------------------------------------------- -modula3: $(SRCS) - $(SWIG) -modula3 $(SWIGOPT) $(INTERFACEPATH) -# $(CC) -c $(CCSHARED) $(CFLAGS) $(SRCS) $(ISRCS) $(INCLUDES) \ -# $(OBJS) $(IOBJS) $(LIBS) +modula3: $(SRCDIR_SRCS) + $(SWIG) -modula3 $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) -modula3_cpp: $(SRCS) - $(SWIG) -modula3 -c++ $(SWIGOPT) $(INTERFACEPATH) +modula3_cpp: $(SRCDIR_SRCS) + $(SWIG) -modula3 -c++ $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) # ----------------------------------------------------------------- # Run modula3 example @@ -719,22 +858,22 @@ MZSCHEME_SCRIPT = $(RUNME).scm # Build a C/C++ dynamically loadable module # ---------------------------------------------------------------- -mzscheme: $(SRCS) - $(SWIG) -mzscheme $(SWIGOPT) $(INTERFACEPATH) - $(COMPILETOOL) $(MZC) `echo $(INCLUDES) | sed 's/-I/++ccf -I/g'` --cc $(ISRCS) $(SRCS) +mzscheme: $(SRCDIR_SRCS) + $(SWIG) -mzscheme $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(COMPILETOOL) $(MZC) `echo $(INCLUDES) | sed 's/-I/++ccf -I/g'` --cc $(ISRCS) $(SRCDIR_SRCS) $(COMPILETOOL) $(MZC) --ld $(TARGET)$(MZSCHEME_SO) $(OBJS) $(IOBJS) -mzscheme_cpp: $(SRCS) - $(SWIG) -mzscheme -c++ $(SWIGOPT) $(INTERFACEPATH) - $(COMPILETOOL) $(MZC) `echo $(INCLUDES) | sed 's/-I/++ccf -I/g'` --cc $(ICXXSRCS) $(SRCS) $(CXXSRCS) - $(CXXSHARED) $(CFLAGS) -o $(LIBPREFIX)$(TARGET)$(MZSCHEME_SO) $(OBJS) $(IOBJS) $(MZDYNOBJ) $(CPP_DLLIBS) +mzscheme_cpp: $(SRCDIR_SRCS) + $(SWIG) -mzscheme -c++ $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(COMPILETOOL) $(MZC) `echo $(INCLUDES) | sed 's/-I/++ccf -I/g'` --cc $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) + $(CXXSHARED) $(CPPFLAGS) $(CXXFLAGS) $(LDFLAGS) -o $(LIBPREFIX)$(TARGET)$(MZSCHEME_SO) $(OBJS) $(IOBJS) $(MZDYNOBJ) $(CPP_DLLIBS) # ----------------------------------------------------------------- # Run mzscheme example # ----------------------------------------------------------------- mzscheme_run: - env LD_LIBRARY_PATH=. $(RUNTOOL) $(MZSCHEME) -r $(MZSCHEME_SCRIPT) $(RUNPIPE) + env LD_LIBRARY_PATH=$$PWD $(RUNTOOL) $(MZSCHEME) -r $(MZSCHEME_SCRIPT) $(RUNPIPE) # ----------------------------------------------------------------- # Version display @@ -751,7 +890,7 @@ mzscheme_version: mzscheme_clean: rm -f *_wrap* *~ .~* rm -f core @EXTRA_CLEAN@ - rm -f *.@OBJEXT@ *@SO@ + rm -f *.@OBJEXT@ *$(MZSCHEME_SO) ################################################################## ##### Ocaml ##### @@ -763,7 +902,7 @@ OCAMLFIND=@OCAMLFIND@ OCAMLMKTOP=@OCAMLMKTOP@ $(SWIGWHERE) NOLINK ?= false OCAMLPP= -pp "camlp4o ./swigp4.cmo" -OCAMLP4WHERE=`$(COMPILETOOL) camlp4 -where` +OCAMLP4WHERE=`$(COMPILETOOL) @CAMLP4@ -where` OCAMLCORE=\ rm -rf swig.mli swig.ml swigp4.ml && \ $(SWIG) -ocaml -co swig.mli 2>/dev/null && \ @@ -774,10 +913,10 @@ OCAMLCORE=\ $(OCC) -I $(OCAMLP4WHERE) -pp "camlp4o pa_extend.cmo q_MLast.cmo" \ -c swigp4.ml -ocaml_static: $(SRCS) +ocaml_static: $(SRCDIR_SRCS) $(OCAMLCORE) - $(SWIG) -ocaml $(SWIGOPT) $(INTERFACEPATH) - $(OCC) -g -c -ccopt -g -ccopt "$(INCLUDES)" $(ISRCS) $(SRCS) + $(SWIG) -ocaml $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(OCC) -g -c -ccopt -g -ccopt "$(INCLUDES)" $(ISRCS) $(SRCDIR_SRCS) $(OCC) -g -c $(INTERFACE:%.i=%.mli) $(OCC) -g -c $(INTERFACE:%.i=%.ml) test -z "$(PROGFILE)" || test -f "$(PROGFILE)" && \ @@ -788,11 +927,11 @@ ocaml_static: $(SRCS) $(PROGFILE:%.ml=%.cmo) \ $(INTERFACE:%.i=%_wrap.@OBJEXT@) $(OBJS) -cclib "$(LIBS)" -ocaml_dynamic: $(SRCS) +ocaml_dynamic: $(SRCDIR_SRCS) $(OCAMLCORE) - $(SWIG) -ocaml $(SWIGOPT) $(INTERFACEPATH) - $(OCC) -g -c -ccopt -g -ccopt "$(INCLUDES)" $(ISRCS) $(SRCS) - $(CXXSHARED) $(CFLAGS) $(CCSHARED) $(CFLAGS) -o $(INTERFACE:%.i=%@SO@) \ + $(SWIG) -ocaml $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(OCC) -g -c -ccopt -g -ccopt "$(INCLUDES)" $(ISRCS) $(SRCDIR_SRCS) + $(CXXSHARED) $(CPPFLAGS) $(CXXFLAGS) $(LDFLAGS) $(CCSHARED) -o $(INTERFACE:%.i=%@SO@) \ $(INTERFACE:%.i=%_wrap.@OBJEXT@) $(OBJS) $(LIBS) $(OCAMLDLGEN) $(INTERFACE:%.i=%.ml) $(INTERFACE:%.i=%@SO@) > \ $(INTERFACE:%.i=%_dynamic.ml) @@ -807,10 +946,10 @@ ocaml_dynamic: $(SRCS) -package dl -linkpkg \ $(INTERFACE:%.i=%.cmo) $(PROGFILE:%.ml=%.cmo) -ocaml_static_toplevel: $(SRCS) +ocaml_static_toplevel: $(SRCDIR_SRCS) $(OCAMLCORE) - $(SWIG) -ocaml $(SWIGOPT) $(INTERFACEPATH) - $(OCC) -g -c -ccopt -g -ccopt "$(INCLUDES)" $(ISRCS) $(SRCS) + $(SWIG) -ocaml $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(OCC) -g -c -ccopt -g -ccopt "$(INCLUDES)" $(ISRCS) $(SRCDIR_SRCS) $(OCC) -g -c $(INTERFACE:%.i=%.mli) $(OCC) -g -c $(INTERFACE:%.i=%.ml) test -z "$(PROGFILE)" || test -f "$(PROGFILE)" && \ @@ -822,12 +961,12 @@ ocaml_static_toplevel: $(SRCS) $(INTERFACE:%.i=%.cmo) \ $(INTERFACE:%.i=%_wrap.@OBJEXT@) $(OBJS) -cclib "$(LIBS)" -ocaml_static_cpp: $(SRCS) +ocaml_static_cpp: $(SRCDIR_SRCS) $(OCAMLCORE) - $(SWIG) -ocaml -c++ $(SWIGOPT) $(INTERFACEPATH) + $(SWIG) -ocaml -c++ $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) cp $(ICXXSRCS) $(ICXXSRCS:%.cxx=%.c) $(OCC) -cc '$(CXX) -Wno-write-strings' -g -c -ccopt -g -ccopt "-xc++ $(INCLUDES)" \ - $(ICXXSRCS:%.cxx=%.c) $(SRCS) $(CXXSRCS) + $(ICXXSRCS:%.cxx=%.c) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(OCC) -g -c $(INTERFACE:%.i=%.mli) $(OCC) -g -c $(INTERFACE:%.i=%.ml) test -z "$(PROGFILE)" || test -f "$(PROGFILE)" && \ @@ -839,12 +978,12 @@ ocaml_static_cpp: $(SRCS) $(INTERFACE:%.i=%_wrap.@OBJEXT@) $(OBJS) \ -cclib "$(LIBS)" -cc '$(CXX) -Wno-write-strings' -ocaml_static_cpp_toplevel: $(SRCS) +ocaml_static_cpp_toplevel: $(SRCDIR_SRCS) $(OCAMLCORE) - $(SWIG) -ocaml -c++ $(SWIGOPT) $(INTERFACEPATH) + $(SWIG) -ocaml -c++ $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) cp $(ICXXSRCS) $(ICXXSRCS:%.cxx=%.c) $(OCC) -cc '$(CXX) -Wno-write-strings' -g -c -ccopt -g -ccopt "-xc++ $(INCLUDES)" \ - $(ICXXSRCS:%.cxx=%.c) $(SRCS) $(CXXSRCS) + $(ICXXSRCS:%.cxx=%.c) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(OCC) -g -c $(INTERFACE:%.i=%.mli) $(OCC) -g -c $(INTERFACE:%.i=%.ml) test -z "$(PROGFILE)" || test -f "$(PROGFILE)" && \ @@ -857,13 +996,13 @@ ocaml_static_cpp_toplevel: $(SRCS) $(INTERFACE:%.i=%_wrap.@OBJEXT@) $(OBJS) \ -cclib "$(LIBS)" -cc '$(CXX) -Wno-write-strings' -ocaml_dynamic_cpp: $(SRCS) +ocaml_dynamic_cpp: $(SRCDIR_SRCS) $(OCAMLCORE) - $(SWIG) -ocaml -c++ $(SWIGOPT) $(INTERFACEPATH) + $(SWIG) -ocaml -c++ $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) cp $(ICXXSRCS) $(ICXXSRCS:%.cxx=%.c) $(OCC) -cc '$(CXX) -Wno-write-strings' -g -c -ccopt -g -ccopt "-xc++ $(INCLUDES)" \ - $(ICXXSRCS:%.cxx=%.c) $(SRCS) $(CXXSRCS) -ccopt -fPIC - $(CXXSHARED) $(CFLAGS) -o $(INTERFACE:%.i=%@SO@) \ + $(ICXXSRCS:%.cxx=%.c) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) -ccopt -fPIC + $(CXXSHARED) $(CPPFLAGS) $(CXXFLAGS) $(LDFLAGS) -o $(INTERFACE:%.i=%@SO@) \ $(INTERFACE:%.i=%_wrap.@OBJEXT@) $(OBJS) \ $(CPP_DLLIBS) $(LIBS) $(OCAMLDLGEN) $(INTERFACE:%.i=%.ml) $(INTERFACE:%.i=%@SO@) > \ @@ -915,26 +1054,26 @@ RUBY_DLNK = @RUBYDYNAMICLINKING@ RUBY_LIBOPTS = @RUBYLINK@ @LIBS@ $(SYSLIBS) RUBY_SO = @RUBYSO@ RUBY = @RUBY@ -RUBY_SCRIPT = $(RUNME).rb +RUBY_SCRIPT = $(SRCDIR)$(RUNME).rb # ---------------------------------------------------------------- # Build a C dynamically loadable module # ---------------------------------------------------------------- -ruby: $(SRCS) - $(SWIG) -ruby $(SWIGOPT) $(INTERFACEPATH) - $(CC) -c $(CCSHARED) $(CFLAGS) $(RUBY_CFLAGS) $(ISRCS) $(SRCS) $(INCLUDES) $(RUBY_INCLUDE) - $(LDSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(RUBY_DLNK) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(RUBY_SO) +ruby: $(SRCDIR_SRCS) + $(SWIG) -ruby $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(RUBY_CFLAGS) $(ISRCS) $(SRCDIR_SRCS) $(INCLUDES) $(RUBY_INCLUDE) + $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(RUBY_DLNK) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(RUBY_SO) # ----------------------------------------------------------------- # Build a C++ dynamically loadable module # ----------------------------------------------------------------- -ruby_cpp: $(SRCS) - $(SWIG) -c++ -ruby $(SWIGOPT) $(INTERFACEPATH) - $(CXX) -c $(CCSHARED) $(CFLAGS) $(RUBY_CFLAGS) $(ICXXSRCS) $(SRCS) $(CXXSRCS) $(INCLUDES) $(RUBY_INCLUDE) - $(CXXSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(RUBY_DLNK) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(RUBY_SO) +ruby_cpp: $(SRCDIR_SRCS) + $(SWIG) -c++ -ruby $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(RUBY_CFLAGS) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(INCLUDES) $(RUBY_INCLUDE) + $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(RUBY_DLNK) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(RUBY_SO) # ----------------------------------------------------------------- # Build statically linked Ruby interpreter @@ -943,14 +1082,14 @@ ruby_cpp: $(SRCS) # library file # ----------------------------------------------------------------- -ruby_static: $(SRCS) - $(SWIG) -ruby -lembed.i $(SWIGOPT) $(INTERFACEPATH) - $(CC) $(CFLAGS) $(RUBY_CFLAGS) @LINKFORSHARED@ $(ISRCS) $(SRCS) $(INCLUDES) \ +ruby_static: $(SRCDIR_SRCS) + $(SWIG) -ruby -lembed.i $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) $(CPPFLAGS) $(CFLAGS) $(LDFLAGS) $(RUBY_CFLAGS) @LINKFORSHARED@ $(ISRCS) $(SRCDIR_SRCS) $(INCLUDES) \ $(RUBY_INCLUDE) $(LIBS) -L$(RUBY_LIB) $(RUBY_LIBOPTS) -o $(TARGET) -ruby_cpp_static: $(SRCS) - $(SWIG) -c++ -ruby -lembed.i $(SWIGOPT) $(INTERFACEPATH) - $(CXX) $(CFLAGS) $(RUBY_CFLAGS) $(ICXXSRCS) $(SRCS) $(CXXSRCS) $(INCLUDES) \ +ruby_cpp_static: $(SRCDIR_SRCS) + $(SWIG) -c++ -ruby -lembed.i $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) $(CPPFLAGS) $(CXXFLAGS) $(LDFLAGS) $(RUBY_CFLAGS) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(INCLUDES) \ $(RUBY_INCLUDE) $(LIBS) -L$(RUBY_LIB) $(RUBY_LIBOPTS) -o $(TARGET) # ----------------------------------------------------------------- @@ -958,7 +1097,7 @@ ruby_cpp_static: $(SRCS) # ----------------------------------------------------------------- ruby_run: - $(RUNTOOL) $(RUBY) -I. $(RUBY_SCRIPT) $(RUNPIPE) + $(RUNTOOL) $(RUBY) $(RUBYFLAGS) -I. $(RUBY_SCRIPT) $(RUNPIPE) # ----------------------------------------------------------------- # Version display @@ -972,9 +1111,9 @@ ruby_version: # ----------------------------------------------------------------- ruby_clean: - rm -f *_wrap* *~ .~* myruby@EXEEXT@ *.pm + rm -f *_wrap* *~ .~* myruby@EXEEXT@ rm -f core @EXTRA_CLEAN@ - rm -f *.@OBJEXT@ *@SO@ + rm -f *.@OBJEXT@ *$(RUBY_SO) ################################################################## ##### PHP ###### @@ -983,25 +1122,25 @@ ruby_clean: PHP = @PHP@ PHP_INCLUDE = @PHPINC@ PHP_SO = @PHP_SO@ -PHP_SCRIPT = $(RUNME).php +PHP_SCRIPT = $(SRCDIR)$(RUNME).php # ------------------------------------------------------------------- # Build a PHP dynamically loadable module (C) # ------------------------------------------------------------------- -php: $(SRCS) - $(SWIG) -php $(SWIGOPT) $(INTERFACEPATH) - $(CC) -c $(CCSHARED) $(CFLAGS) $(SRCS) $(ISRCS) $(INCLUDES) $(PHP_INCLUDE) - $(LDSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(PHP_SO) +php: $(SRCDIR_SRCS) + $(SWIG) -php $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(SRCDIR_SRCS) $(ISRCS) $(INCLUDES) $(PHP_INCLUDE) + $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(PHP_SO) # -------------------------------------------------------------------- # Build a PHP dynamically loadable module (C++) # -------------------------------------------------------------------- -php_cpp: $(SRCS) - $(SWIG) -php -cppext cxx -c++ $(SWIGOPT) $(INTERFACEPATH) - $(CXX) -c $(CCSHARED) $(CFLAGS) $(SRCS) $(CXXSRCS) $(ICXXSRCS) $(INCLUDES) $(PHP_INCLUDE) - $(CXXSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(PHP_SO) +php_cpp: $(SRCDIR_SRCS) + $(SWIG) -php -cppext cxx -c++ $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(ICXXSRCS) $(INCLUDES) $(PHP_INCLUDE) + $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(PHP_SO) # ----------------------------------------------------------------- # Running a PHP example @@ -1024,7 +1163,7 @@ php_version: php_clean: rm -f *_wrap* *~ .~* example.php php_example.h rm -f core @EXTRA_CLEAN@ - rm -f *.@OBJEXT@ *@SO@ + rm -f *.@OBJEXT@ *$(PHP_SO) ################################################################## ##### Pike ###### @@ -1043,19 +1182,19 @@ PIKE_SCRIPT = $(RUNME).pike # Build a C dynamically loadable module # ---------------------------------------------------------------- -pike: $(SRCS) - $(SWIG) -pike $(SWIGOPT) $(INTERFACEPATH) - $(CC) -c $(CCSHARED) $(CFLAGS) $(PIKE_CFLAGS) $(ISRCS) $(SRCS) $(INCLUDES) $(PIKE_INCLUDE) - $(LDSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(PIKE_DLNK) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(SO) +pike: $(SRCDIR_SRCS) + $(SWIG) -pike $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(PIKE_CFLAGS) $(ISRCS) $(SRCDIR_SRCS) $(INCLUDES) $(PIKE_INCLUDE) + $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(PIKE_DLNK) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(SO) # ----------------------------------------------------------------- # Build a C++ dynamically loadable module # ----------------------------------------------------------------- -pike_cpp: $(SRCS) - $(SWIG) -c++ -pike $(SWIGOPT) $(INTERFACEPATH) - $(CXX) -c $(CCSHARED) $(CFLAGS) $(PIKE_CFLAGS) $(ICXXSRCS) $(SRCS) $(CXXSRCS) $(INCLUDES) $(PIKE_INCLUDE) - $(CXXSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(PIKE_DLNK) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(SO) +pike_cpp: $(SRCDIR_SRCS) + $(SWIG) -c++ -pike $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(PIKE_CFLAGS) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(INCLUDES) $(PIKE_INCLUDE) + $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(PIKE_DLNK) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(SO) # ----------------------------------------------------------------- # Build statically linked Pike interpreter @@ -1064,14 +1203,14 @@ pike_cpp: $(SRCS) # library file # ----------------------------------------------------------------- -pike_static: $(SRCS) - $(SWIG) -pike -lembed.i $(SWIGOPT) $(INTERFACEPATH) - $(CC) $(CFLAGS) $(PIKE_CFLAGS) @LINKFORSHARED@ $(ISRCS) $(SRCS) $(INCLUDES) \ +pike_static: $(SRCDIR_SRCS) + $(SWIG) -pike -lembed.i $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) $(CPPFLAGS) $(CFLAGS) $(LDFLAGS) $(PIKE_CFLAGS) @LINKFORSHARED@ $(ISRCS) $(SRCDIR_SRCS) $(INCLUDES) \ $(PIKE_INCLUDE) $(LIBS) -L$(PIKE_LIB) $(PIKE_LIBOPTS) -o $(TARGET) -pike_cpp_static: $(SRCS) - $(SWIG) -c++ -pike -lembed.i $(SWIGOPT) $(INTERFACEPATH) - $(CXX) $(CFLAGS) $(PIKE_CFLAGS) $(ICXXSRCS) $(SRCS) $(CXXSRCS) $(INCLUDES) \ +pike_cpp_static: $(SRCDIR_SRCS) + $(SWIG) -c++ -pike -lembed.i $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) $(CPPFLAGS) $(CXXFLAGS) $(LDFLAGS) $(PIKE_CFLAGS) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(INCLUDES) \ $(PIKE_INCLUDE) $(LIBS) -L$(PIKE_LIB) $(PIKE_LIBOPTS) -o $(TARGET) # ----------------------------------------------------------------- @@ -1118,7 +1257,7 @@ CHICKEN_GENERATED_SCHEME = $(INTERFACE:.i=.scm) CHICKEN_COMPILED_SCHEME = $(INTERFACE:.i=_chicken.c) CHICKEN_COMPILED_OBJECT = $(CHICKEN_COMPILED_SCHEME:.c=.@OBJEXT@) -# flags for the main chicken sources (only used when compiling staticly) +# flags for the main chicken sources (only used when compiling statically) CHICKEN_COMPILED_MAIN = $(CHICKEN_MAIN:.scm=_chicken.c) CHICKEN_COMPILED_MAIN_OBJECT = $(CHICKEN_COMPILED_MAIN:.c=.@OBJEXT@) @@ -1127,24 +1266,24 @@ CHICKEN_COMPILED_MAIN_OBJECT = $(CHICKEN_COMPILED_MAIN:.c=.@OBJEXT@) # ----------------------------------------------------------------- # This is the old way to build chicken, but it does not work correctly with exceptions -chicken_direct: $(SRCS) +chicken_direct: $(SRCDIR_SRCS) $(SWIG) -chicken $(SWIGOPT) $(INCLUDE) $(INTERFACEPATH) $(CHICKEN) $(CHICKEN_GENERATED_SCHEME) $(CHICKENOPTS) \ -dynamic -feature chicken-compile-shared \ -output-file $(CHICKEN_COMPILED_SCHEME) - $(CC) -c $(CCSHARED) $(CFLAGS) $(CHICKEN_CFLAGS) \ - $(INCLUDES) $(CHICKEN_INCLUDE) $(ISRCS) $(SRCS) $(CHICKEN_COMPILED_SCHEME) - $(LDSHARED) $(CFLAGS) $(CHICKEN_COMPILED_OBJECT) $(OBJS) $(IOBJS) \ + $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(CHICKEN_CFLAGS) \ + $(INCLUDES) $(CHICKEN_INCLUDE) $(ISRCS) $(SRCDIR_SRCS) $(CHICKEN_COMPILED_SCHEME) + $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(CHICKEN_COMPILED_OBJECT) $(OBJS) $(IOBJS) \ $(LIBS) $(CHICKEN_SHAREDLIBOPTS) -o $(LIBPREFIX)$(TARGET)$(SO) -chicken_direct_cpp: $(CXXSRCS) $(CHICKSRCS) +chicken_direct_cpp: $(SRCDIR_CXXSRCS) $(CHICKSRCS) $(SWIG) -c++ -chicken $(SWIGOPT) $(INCLUDE) $(INTERFACEPATH) $(CHICKEN) $(CHICKEN_GENERATED_SCHEME) $(CHICKENOPTS) \ -dynamic -feature chicken-compile-shared \ -output-file $(CHICKEN_COMPILED_SCHEME) - $(CXX) -c $(CCSHARED) $(CFLAGS) $(CHICKEN_CFLAGS) \ - $(INCLUDES) $(CHICKEN_INCLUDE) $(ICXXSRCS) $(SRCS) $(CXXSRCS) $(CHICKEN_COMPILED_SCHEME) - $(CXXSHARED) $(CFLAGS) $(CHICKEN_COMPILED_OBJECT) $(OBJS) $(IOBJS) \ + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(CHICKEN_CFLAGS) \ + $(INCLUDES) $(CHICKEN_INCLUDE) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(CHICKEN_COMPILED_SCHEME) + $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(CHICKEN_COMPILED_OBJECT) $(OBJS) $(IOBJS) \ $(LIBS) $(CPP_DLLIBS) $(CHICKEN_SHAREDLIBOPTS) -o $(LIBPREFIX)$(TARGET)$(SO) # ----------------------------------------------------------------- @@ -1152,28 +1291,28 @@ chicken_direct_cpp: $(CXXSRCS) $(CHICKSRCS) # ----------------------------------------------------------------- # The following two targets are also used by the test suite -chicken_static: $(SRCS) $(CHICKSRCS) +chicken_static: $(SRCDIR_SRCS) $(CHICKSRCS) $(SWIG) -chicken $(SWIGOPT) $(INCLUDE) $(INTERFACEPATH) $(CHICKEN) $(CHICKEN_GENERATED_SCHEME) $(CHICKENOPTS) \ -output-file $(CHICKEN_COMPILED_SCHEME) $(CHICKEN) $(CHICKEN_MAIN) $(CHICKENOPTS) \ -output-file $(CHICKEN_MAIN:.scm=_chicken.c) - $(CC) -c $(CCSHARED) $(CFLAGS) $(CHICKEN_CFLAGS) \ - $(INCLUDES) $(CHICKEN_INCLUDE) $(ISRCS) $(SRCS) \ + $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(CHICKEN_CFLAGS) \ + $(INCLUDES) $(CHICKEN_INCLUDE) $(ISRCS) $(SRCDIR_SRCS) \ $(CHICKEN_COMPILED_SCHEME) $(CHICKEN_COMPILED_MAIN) - $(CC) $(CHICKEN_COMPILED_OBJECT) $(CHICKEN_COMPILED_MAIN_OBJECT) \ + $(CC) $(CFLAGS) $(LDFLAGS) $(CHICKEN_COMPILED_OBJECT) $(CHICKEN_COMPILED_MAIN_OBJECT) \ $(OBJS) $(IOBJS) $(LIBS) $(CHICKEN_SHAREDLIBOPTS) -o $(TARGET) -chicken_static_cpp: $(CXXSRCS) $(CHICKSRCS) +chicken_static_cpp: $(SRCDIR_CXXSRCS) $(CHICKSRCS) $(SWIG) -c++ -chicken $(SWIGOPT) $(INCLUDE) $(INTERFACEPATH) $(CHICKEN) $(CHICKEN_GENERATED_SCHEME) $(CHICKENOPTS) \ -output-file $(CHICKEN_COMPILED_SCHEME) $(CHICKEN) $(CHICKEN_MAIN) $(CHICKENOPTS) \ -output-file $(CHICKEN_MAIN:.scm=_chicken.c) - $(CXX) -c $(CCSHARED) $(CFLAGS) $(CHICKEN_CFLAGS) \ - $(INCLUDES) $(CHICKEN_INCLUDE) $(ICXXSRCS) $(SRCS) $(CXXSRCS) \ + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(CHICKEN_CFLAGS) \ + $(INCLUDES) $(CHICKEN_INCLUDE) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) \ $(CHICKEN_COMPILED_SCHEME) $(CHICKEN_COMPILED_MAIN) - $(CXX) $(CHICKEN_COMPILED_OBJECT) $(CHICKEN_COMPILED_MAIN_OBJECT) \ + $(CXX) $(CXXFLAGS) $(LDFLAGS) $(CHICKEN_COMPILED_OBJECT) $(CHICKEN_COMPILED_MAIN_OBJECT) \ $(OBJS) $(IOBJS) $(LIBS) $(CPP_DLLIBS) $(CHICKEN_SHAREDLIBOPTS) -o $(TARGET) # ---------------------------------------------------------------- @@ -1182,11 +1321,11 @@ chicken_static_cpp: $(CXXSRCS) $(CHICKSRCS) chicken: $(SWIG) -chicken $(SWIGOPT) $(INCLUDE) $(INTERFACEPATH) - $(COMPILETOOL) $(CHICKEN_CSC) -s `echo $(INCLUDES) | sed 's/-I/-C -I/g'` $(CHICKEN_GENERATED_SCHEME) $(SRCS) $(ISRCS) -o $(TARGET)$(SO) + $(COMPILETOOL) $(CHICKEN_CSC) -s `echo $(INCLUDES) | sed 's/-I/-C -I/g'` $(CHICKEN_GENERATED_SCHEME) $(SRCDIR_SRCS) $(ISRCS) -o $(TARGET)$(SO) chicken_cpp: $(SWIG) -c++ -chicken $(SWIGOPT) $(INCLUDE) $(INTERFACEPATH) - $(COMPILETOOL) $(CHICKEN_CSC) -s `echo $(INCLUDES) | sed 's/-I/-C -I/g'` $(CHICKEN_GENERATED_SCHEME) $(SRCS) $(ICXXSRCS) $(CXXSRCS) -o $(TARGET)$(SO) + $(COMPILETOOL) $(CHICKEN_CSC) -s `echo $(INCLUDES) | sed 's/-I/-C -I/g'` $(CHICKEN_GENERATED_SCHEME) $(SRCDIR_SRCS) $(ICXXSRCS) $(SRCDIR_CXXSRCS) -o $(TARGET)$(SO) chicken_externalhdr: $(SWIG) -chicken -external-runtime $(TARGET) @@ -1196,7 +1335,7 @@ chicken_externalhdr: # ----------------------------------------------------------------- chicken_run: - env LD_LIBRARY_PATH=. $(RUNTOOL) $(CHICKEN_CSI) $(CHICKEN_SCRIPT) $(RUNPIPE) + env LD_LIBRARY_PATH=$$PWD $(RUNTOOL) $(CHICKEN_CSI) $(CHICKEN_SCRIPT) $(RUNPIPE) # ----------------------------------------------------------------- # Version display @@ -1223,41 +1362,50 @@ CSHARP_DLNK = @CSHARPDYNAMICLINKING@ CSHARP_LIBPREFIX = @CSHARPLIBRARYPREFIX@ CSHARPCOMPILER = @CSHARPCOMPILER@ CSHARPCILINTERPRETER = @CSHARPCILINTERPRETER@ +CSHARPCILINTERPRETER_FLAGS = @CSHARPCILINTERPRETER_FLAGS@ CSHARPCFLAGS = @CSHARPCFLAGS@ +CSHARPFLAGS = +CSHARPOPTIONS = CSHARPSO = @CSHARPSO@ -CSHARP_RUNME = ./$(RUNME).exe +CSHARP_RUNME = $(CSHARPCILINTERPRETER) $(CSHARPCILINTERPRETER_FLAGS) ./$(RUNME).exe # ---------------------------------------------------------------- # Build a CSharp dynamically loadable module (C) # ---------------------------------------------------------------- -csharp: $(SRCS) - $(SWIG) -csharp $(SWIGOPT) $(INTERFACEPATH) - $(CC) -c $(CCSHARED) $(CFLAGS) $(CSHARPCFLAGS) $(SRCS) $(ISRCS) $(INCLUDES) - $(LDSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(CSHARP_DLNK) $(LIBS) -o $(CSHARP_LIBPREFIX)$(TARGET)$(CSHARPSO) +csharp: $(SRCDIR_SRCS) + $(SWIG) -csharp $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(CSHARPCFLAGS) $(SRCDIR_SRCS) $(ISRCS) $(INCLUDES) + $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(CSHARP_DLNK) $(LIBS) -o $(CSHARP_LIBPREFIX)$(TARGET)$(CSHARPSO) # ---------------------------------------------------------------- # Build a CSharp dynamically loadable module (C++) # ---------------------------------------------------------------- -csharp_cpp: $(SRCS) - $(SWIG) -csharp -c++ $(SWIGOPT) $(INTERFACEPATH) - $(CXX) -c $(CCSHARED) $(CFLAGS) $(CSHARPCFLAGS) $(SRCS) $(CXXSRCS) $(ICXXSRCS) $(INCLUDES) - $(CXXSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(CSHARP_DLNK) $(LIBS) $(CPP_DLLIBS) -o $(CSHARP_LIBPREFIX)$(TARGET)$(CSHARPSO) +csharp_cpp: $(SRCDIR_SRCS) + $(SWIG) -csharp -c++ $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(CSHARPCFLAGS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(ICXXSRCS) $(INCLUDES) + $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(CSHARP_DLNK) $(LIBS) $(CPP_DLLIBS) -o $(CSHARP_LIBPREFIX)$(TARGET)$(CSHARPSO) # ---------------------------------------------------------------- # Compile CSharp files # ---------------------------------------------------------------- -csharp_compile: $(SRCS) - $(COMPILETOOL) $(CSHARPCOMPILER) $(CSHARPFLAGS) $(CSHARPSRCS) +ifneq (,$(SRCDIR)) +SRCDIR_CSHARPSRCS = $(addprefix $(SRCDIR),$(CSHARPSRCS)) +else +SRCDIR_CSHARPSRCS = +endif + +csharp_compile: $(SRCDIR_SRCS) + $(COMPILETOOL) $(CSHARPCOMPILER) $(CSHARPFLAGS) $(CSHARPOPTIONS) $(CSHARPSRCS) $(SRCDIR_CSHARPSRCS) # ----------------------------------------------------------------- # Run CSharp example # ----------------------------------------------------------------- csharp_run: - env LD_LIBRARY_PATH=. $(RUNTOOL) $(CSHARP_RUNME) $(RUNPIPE) + env LD_LIBRARY_PATH=$$PWD $(RUNTOOL) $(CSHARP_RUNME) $(RUNPIPE) # ----------------------------------------------------------------- # Version display @@ -1266,13 +1414,14 @@ csharp_run: # Version check below also works with MS csc.exe which does not understand --version csharp_version: $(CSHARPCOMPILER) --version | head -n 1 + if test -n "$(CSHARPCILINTERPRETER)" ; then "$(CSHARPCILINTERPRETER)" --version ; fi # ----------------------------------------------------------------- # Cleaning the CSharp examples # ----------------------------------------------------------------- csharp_clean: - rm -f *_wrap* *~ .~* runme runme.exe *.exe.mdb gc.log `find . -name \*.cs | grep -v runme.cs` + rm -f *_wrap* *~ .~* $(RUNME) $(RUNME).exe *.exe.mdb gc.log `find . -name \*.cs | grep -v $(RUNME).cs` rm -f core @EXTRA_CLEAN@ rm -f *.@OBJEXT@ *@CSHARPSO@ @@ -1289,7 +1438,7 @@ LUA_DLNK = @LUADYNAMICLINKING@ LUA_SO = @LUA_SO@ LUA = @LUABIN@ -LUA_SCRIPT = $(RUNME).lua +LUA_SCRIPT = $(SRCDIR)$(RUNME).lua # Extra code for lua static link LUA_INTERP = ../lua.c @@ -1298,32 +1447,38 @@ LUA_INTERP = ../lua.c # Build a C dynamically loadable module # ---------------------------------------------------------------- -lua: $(SRCS) - $(SWIG) -lua $(SWIGOPT) $(INTERFACEPATH) - $(CC) -c $(CCSHARED) $(CFLAGS) $(ISRCS) $(SRCS) $(INCLUDES) $(LUA_INCLUDE) - $(LDSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(LIBS) $(LUA_LIB) -o $(LIBPREFIX)$(TARGET)$(LUA_SO) +lua: $(SRCDIR_SRCS) + $(SWIG) -lua $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(ISRCS) $(SRCDIR_SRCS) $(INCLUDES) $(LUA_INCLUDE) + $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(LIBS) $(LUA_LIB) -o $(LIBPREFIX)$(TARGET)$(LUA_SO) # ----------------------------------------------------------------- # Build a C++ dynamically loadable module # ----------------------------------------------------------------- -lua_cpp: $(SRCS) - $(SWIG) -c++ -lua $(SWIGOPT) $(INTERFACEPATH) - $(CXX) -c $(CCSHARED) $(CFLAGS) $(ICXXSRCS) $(SRCS) $(CXXSRCS) $(INCLUDES) $(LUA_INCLUDE) - $(CXXSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(LIBS) $(LUA_LIB) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(LUA_SO) +lua_cpp: $(SRCDIR_SRCS) $(GENCXXSRCS) + $(SWIG) -c++ -lua $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(GENCXXSRCS) $(INCLUDES) $(LUA_INCLUDE) + $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(LIBS) $(LUA_LIB) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(LUA_SO) + +lua_externalhdr: + $(SWIG) -lua -external-runtime $(TARGET) + +lua_swig_cpp: + $(SWIG) -c++ -lua $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) # ----------------------------------------------------------------- # Build statically linked Lua interpreter # ----------------------------------------------------------------- -lua_static: $(SRCS) - $(SWIG) -lua -module example $(SWIGOPT) $(INTERFACEPATH) - $(CC) $(CFLAGS) $(ISRCS) $(SRCS) $(LUA_INTERP) $(INCLUDES) \ +lua_static: $(SRCDIR_SRCS) + $(SWIG) -lua -module example $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) $(CPPFLAGS) $(CFLAGS) $(LDFLAGS) $(ISRCS) $(SRCDIR_SRCS) $(SRCDIR)$(LUA_INTERP) $(INCLUDES) \ $(LUA_INCLUDE) $(LIBS) $(LUA_LIB) -o $(TARGET) -lua_static_cpp: $(SRCS) - $(SWIG) -c++ -lua -module example $(SWIGOPT) $(INTERFACEPATH) - $(CXX) $(CFLAGS) $(ICXXSRCS) $(SRCS) $(CXXSRCS) $(LUA_INTERP) $(INCLUDES) \ +lua_static_cpp: $(SRCDIR_SRCS) $(GENCXXSRCS) + $(SWIG) -c++ -lua -module example $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) $(CPPFLAGS) $(CXXFLAGS) $(LDFLAGS) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(GENCXXSRCS) $(SRCDIR)$(LUA_INTERP) $(INCLUDES) \ $(LUA_INCLUDE) $(LIBS) $(LUA_LIB) -o $(TARGET) # ----------------------------------------------------------------- @@ -1334,7 +1489,7 @@ lua_run: $(RUNTOOL) $(LUA) $(LUA_SCRIPT) $(RUNPIPE) lua_embed_run: - $(RUNTOOL) ./$(TARGET) $(RUNPIPE) + $(RUNTOOL) ./$(TARGET) $(LUA_SCRIPT) $(RUNPIPE) # ----------------------------------------------------------------- # Version display @@ -1350,7 +1505,7 @@ lua_version: lua_clean: rm -f *_wrap* *~ .~* mylua@EXEEXT@ rm -f core @EXTRA_CLEAN@ - rm -f *.@OBJEXT@ *@SO@ + rm -f *.@OBJEXT@ *$(LUA_SO) ################################################################## ##### ALLEGRO CL ###### @@ -1359,15 +1514,15 @@ lua_clean: ALLEGROCL = @ALLEGROCLBIN@ ALLEGROCL_SCRIPT=$(RUNME).lisp -allegrocl: $(SRCS) - $(SWIG) -allegrocl -cwrap $(SWIGOPT) $(INTERFACEPATH) - $(CC) -c $(CCSHARED) $(CFLAGS) $(ISRCS) $(INCLUDES) $(SRCS) - $(LDSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(SO) +allegrocl: $(SRCDIR_SRCS) + $(SWIG) -allegrocl -cwrap $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(ISRCS) $(INCLUDES) $(SRCDIR_SRCS) + $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(SO) -allegrocl_cpp: $(SRCS) - $(SWIG) -c++ -allegrocl $(SWIGOPT) $(INTERFACEPATH) - $(CXX) -c $(CCSHARED) $(CFLAGS) $(ICXXSRCS) $(SRCS) $(CXXSRCS) $(INCLUDES) - $(CXXSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(SO) +allegrocl_cpp: $(SRCDIR_SRCS) + $(SWIG) -c++ -allegrocl $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(INCLUDES) + $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(SO) # ----------------------------------------------------------------- # Run ALLEGRO CL example @@ -1399,11 +1554,11 @@ allegrocl_clean: CLISP = @CLISPBIN@ CLISP_SCRIPT=$(RUNME).lisp -clisp: $(SRCS) - $(SWIG) -clisp $(SWIGOPT) $(INTERFACEPATH) +clisp: $(SRCDIR_SRCS) + $(SWIG) -clisp $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) -clisp_cpp: $(SRCS) - $(SWIG) -c++ -clisp $(SWIGOPT) $(INTERFACEPATH) +clisp_cpp: $(SRCDIR_SRCS) + $(SWIG) -c++ -clisp $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) # ----------------------------------------------------------------- # Run CLISP example @@ -1435,15 +1590,15 @@ clisp_clean: CFFI = @CFFIBIN@ CFFI_SCRIPT=$(RUNME).lisp -cffi: $(SRCS) - $(SWIG) -cffi $(SWIGOPT) $(INTERFACEPATH) -# $(CC) -c $(CCSHARED) $(CFLAGS) $(ISRCS) $(INCLUDES) $(SRCS) -# $(LDSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(SO) +cffi: $(SRCDIR_SRCS) + $(SWIG) -cffi $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) +# $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(ISRCS) $(INCLUDES) $(SRCDIR_SRCS) +# $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(SO) -cffi_cpp: $(SRCS) - $(SWIG) -c++ -cffi $(SWIGOPT) $(INTERFACEPATH) - $(CXX) -c $(CCSHARED) $(CFLAGS) $(ICXXSRCS) $(SRCS) $(CXXSRCS) $(INCLUDES) - $(CXXSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(SO) +cffi_cpp: $(SRCDIR_SRCS) + $(SWIG) -c++ -cffi $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(INCLUDES) + $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(SO) # ----------------------------------------------------------------- # Run CFFI example @@ -1475,15 +1630,15 @@ cffi_clean: UFFI = @UFFIBIN@ UFFI_SCRIPT=$(RUNME).lisp -uffi: $(SRCS) - $(SWIG) -uffi $(SWIGOPT) $(INTERFACEPATH) -# $(CC) -c $(CCSHARED) $(CFLAGS) $(ISRCS) $(INCLUDES) $(SRCS) -# $(LDSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(SO) +uffi: $(SRCDIR_SRCS) + $(SWIG) -uffi $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) +# $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(ISRCS) $(INCLUDES) $(SRCDIR_SRCS) +# $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(SO) -uffi_cpp: $(SRCS) - $(SWIG) -c++ -uffi $(SWIGOPT) $(INTERFACEPATH) -# $(CXX) -c $(CCSHARED) $(CFLAGS) $(ICXXSRCS) $(SRCS) $(CXXSRCS) $(INCLUDES) -# $(CXXSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(SO) +uffi_cpp: $(SRCDIR_SRCS) + $(SWIG) -c++ -uffi $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) +# $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(INCLUDES) +# $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(SO) # ----------------------------------------------------------------- # Run UFFI example @@ -1516,7 +1671,8 @@ R = R RCXXSRCS = $(INTERFACE:.i=_wrap.cpp) #Need to use _wrap.cpp for R build system as it does not understand _wrap.cxx RRSRC = $(INTERFACE:.i=.R) R_CFLAGS=-fPIC -R_SCRIPT=$(RUNME).R +R_OPT = --slave --quiet --no-save --no-restore +R_SCRIPT=$(SRCDIR)$(RUNME).R # need to compile .cxx files outside of R build system to make sure that # we get -fPIC @@ -1526,30 +1682,29 @@ R_SCRIPT=$(RUNME).R # Build a R dynamically loadable module (C) # ---------------------------------------------------------------- -r: $(SRCS) - $(SWIG) -r $(SWIGOPT) $(INTERFACEPATH) -ifneq ($(SRCS),) - $(CC) -g -c $(CFLAGS) $(R_CFLAGS) $(SRCS) $(INCLUDES) +r: $(SRCDIR_SRCS) + $(SWIG) -r $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) +ifneq ($(SRCDIR_SRCS),) + $(CC) -g -c $(CPPFLAGS) $(CFLAGS) $(R_CFLAGS) $(SRCDIR_SRCS) $(INCLUDES) endif - +( PKG_CPPFLAGS="$(INCLUDES)" $(COMPILETOOL) $(R) CMD SHLIB -o $(LIBPREFIX)$(TARGET)$(SO) $(ISRCS) $(OBJS) > /dev/null ) + +( PKG_CPPFLAGS="$(CPPFLAGS) $(INCLUDES)" $(COMPILETOOL) $(R) CMD SHLIB -o $(LIBPREFIX)$(TARGET)$(SO) $(ISRCS) $(OBJS) > /dev/null ) # ---------------------------------------------------------------- # Build a R dynamically loadable module (C++) # ---------------------------------------------------------------- - -r_cpp: $(CXXSRCS) +r_cpp: $(SRCDIR_CXXSRCS) $(SWIG) -c++ -r $(SWIGOPT) -o $(RCXXSRCS) $(INTERFACEPATH) -ifneq ($(CXXSRCS),) - $(CXX) -g -c $(CFLAGS) $(R_CFLAGS) $(CXXSRCS) $(INCLUDES) +ifneq ($(SRCDIR_CXXSRCS),) + $(CXX) -g -c $(CPPFLAGS) $(CXXFLAGS) $(R_CFLAGS) $(SRCDIR_CXXSRCS) $(INCLUDES) endif - +( PKG_CPPFLAGS="$(INCLUDES)" $(COMPILETOOL) $(R) CMD SHLIB -o $(LIBPREFIX)$(TARGET)$(SO) $(RCXXSRCS) $(OBJS) > /dev/null ) + +( PKG_CPPFLAGS="$(CPPFLAGS) $(INCLUDES)" $(COMPILETOOL) $(R) CMD SHLIB -o $(LIBPREFIX)$(TARGET)$(SO) $(RCXXSRCS) $(OBJS) > /dev/null ) # ----------------------------------------------------------------- # Run R example # ----------------------------------------------------------------- r_run: - $(RUNTOOL) $(R) CMD BATCH $(R_SCRIPT) $(RUNPIPE) + $(RUNTOOL) $(R) $(R_OPT) -f $(R_SCRIPT) $(RUNPIPE) # ----------------------------------------------------------------- # Version display @@ -1569,72 +1724,277 @@ r_clean: rm -f $(RRSRC) $(RUNME).Rout .RData ################################################################## +##### SCILAB ###### +################################################################## + +SCILAB = @SCILAB@ +SCILAB_INC= @SCILABINCLUDE@ +SCILAB_OPT = @SCILABOPT@ +SCILAB_LIBPREFIX = lib + +# ---------------------------------------------------------------- +# Build a C dynamically loadable module +# ---------------------------------------------------------------- + +scilab: + $(SWIG) -scilab $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) -g -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(SCILAB_INC) $(INCLUDES) $(ISRCS) $(SRCDIR_SRCS) $(SRCDIR_CSRCS) + $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(IOBJS) $(OBJS) $(LIBS) -o $(SCILAB_LIBPREFIX)$(TARGET)$(SO) + +# ---------------------------------------------------------------- +# Build a C++ dynamically loadable module +# ---------------------------------------------------------------- + +scilab_cpp: + $(SWIG) -c++ -scilab $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) -g -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(SCILAB_INC) $(INCLUDES) $(ICXXSRCS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) + $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(IOBJS) $(OBJS) $(LIBS) $(CPP_DLLIBS) -o $(SCILAB_LIBPREFIX)$(TARGET)$(SO) + +# ----------------------------------------------------------------- +# Running a Scilab example +# ----------------------------------------------------------------- + +scilab_run: + env LD_LIBRARY_PATH=$$PWD $(RUNTOOL) $(SCILAB) $(SCILAB_OPT) -f $(SRCDIR)$(RUNME).sci $(RUNPIPE) + +# ----------------------------------------------------------------- +# Scilab version +# ----------------------------------------------------------------- + +scilab_version: + echo `$(SCILAB) -version | head -1` + +# ----------------------------------------------------------------- +# Cleaning the scilab examples +# ----------------------------------------------------------------- + +scilab_clean: + rm -f *_wrap* *~ .~* + rm -f core @EXTRA_CLEAN@ + rm -f *.@OBJEXT@ *@SO@ + rm -f *.sce + +################################################################## ##### Go ###### ################################################################## +# TODO: The Go make targets need simplifying to use configure time +# configuration or to use Make's ifeq rather than using lots of +# runtime shell code. The output will then be a lot less verbose. + GO = @GO@ GOGCC = @GOGCC@ +GCCGO = @GCCGO@ GO1 = @GO1@ +GO12 = @GO12@ +GO13 = @GO13@ +GO15 = @GO15@ GOC = @GOC@ GOOPT = @GOOPT@ +GCCGOOPT = @GCCGOOPT@ GOVERSIONOPTION = @GOVERSIONOPTION@ GOSWIGARG = `if $(GOGCC) ; then echo -gccgo; fi` -GOCOMPILEARG = `if $(GOGCC) ; then echo -c -g; elif $(GO1) ; then echo tool $(GOC:c=g) ; fi` +GOCOMPILEARG = `if $(GO15); then echo tool compile; elif $(GO1) ; then echo tool $(GOC:c=g) ; fi` `if $(GO13) || $(GO15); then echo -pack ; fi` GOSRCS = $(INTERFACE:.i=.go) GOCSRCS = $(INTERFACE:.i=_gc.c) -GOLD = $(GOC:c=l) +GOLD = `if $(GO15); then echo link; else echo $(GOC:c=l); fi` GOTOOL = `if $(GO1) ; then echo go tool; fi` GOPACK = `if $(GO1) ; then echo go tool pack; else echo gopack; fi` -GOPACKAGE = $(INTERFACE:.i=.a) +GOPACKAGE = $(notdir $(INTERFACE:.i=.a)) -GOOBJEXT = $(GOC:c=) +GOPATHDIR = gopath/src/$(INTERFACE:.i=) + +GOOBJEXT = `if $(GO15); then echo o; else echo $(GOC:c=); fi` GOGCOBJS = $(GOSRCS:.go=.$(GOOBJEXT)) GOGCCOBJS = $(GOSRCS:.go=.@OBJEXT@) # ---------------------------------------------------------------- -# Build a Go dynamically loadable module (C) +# Build a Go module (C) # ---------------------------------------------------------------- -go: $(SRCS) - $(SWIG) -go $(GOOPT) $(GOSWIGARG) $(SWIGOPT) $(INTERFACEPATH) - $(CC) -g -c $(CCSHARED) $(CFLAGS) $(SRCS) $(ISRCS) $(INCLUDES) - $(LDSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(SO) - $(COMPILETOOL) $(GO) $(GOCOMPILEARG) -I . $(GOSRCS) - if ! $(GOGCC) ; then \ - $(COMPILETOOL) $(GOTOOL) $(GOC) -I $${GOROOT}/pkg/$${GOOS}_$${GOARCH} $(GOCSRCS) && \ - $(COMPILETOOL) $(GOPACK) grc $(GOPACKAGE) $(GOGCOBJS) $(GOCSRCS:.c=.$(GOOBJEXT)); \ +go_nocgo: $(SRCDIR_SRCS) + $(SWIG) -go $(GOOPT) $(GOSWIGARG) $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + if $(GO12) || $(GO13) || $(GO15) || $(GOGCC); then \ + $(CC) -g -c $(CPPFLAGS) $(CFLAGS) $(SRCDIR_SRCS) $(ISRCS) $(INCLUDES); \ + else \ + $(CC) -g -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(SRCDIR_SRCS) $(ISRCS) $(INCLUDES); \ + $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(LIBS) -o $(LIBPREFIX)$(TARGET)$(SO); \ + fi + if $(GOGCC) ; then \ + $(COMPILETOOL) $(GCCGO) -g -c -I . $(GOSRCS); \ + else \ + $(COMPILETOOL) $(GO) $(GOCOMPILEARG) -I . $(GOSRCS); \ + $(COMPILETOOL) $(GOTOOL) $(GOC) -I $${GOROOT:-`go env GOROOT`}/pkg/$${GOOS:-`go env GOOS`}_$${GOARCH:-`go env GOARCH`} $(GOCSRCS); \ + rm -f $(GOPACKAGE); \ + if $(GO13) || $(GO15); then \ + cp $(GOGCOBJS) $(GOPACKAGE); \ + $(COMPILETOOL) $(GOPACK) r $(GOPACKAGE) $(GOCSRCS:.c=.$(GOOBJEXT)) $(OBJS) $(IOBJS); \ + elif $(GO12); then \ + $(COMPILETOOL) $(GOPACK) grc $(GOPACKAGE) $(GOGCOBJS) $(GOCSRCS:.c=.$(GOOBJEXT)) $(OBJS) $(IOBJS); \ + else \ + $(COMPILETOOL) $(GOPACK) grc $(GOPACKAGE) $(GOGCOBJS) $(GOCSRCS:.c=.$(GOOBJEXT)); \ + fi; \ + fi + if test -f $(SRCDIR)$(RUNME).go; then \ + if $(GOGCC) ; then \ + $(COMPILETOOL) $(GCCGO) -g -c $(SRCDIR)$(RUNME).go; \ + $(COMPILETOOL) $(GCCGO) -o $(RUNME) $(RUNME).@OBJEXT@ $(GOGCCOBJS) $(OBJS) $(IOBJS); \ + elif $(GO12) || $(GO13) || $(GO15); then \ + $(GO) $(GOCOMPILEARG) $(SRCDIR)$(RUNME).go; \ + $(COMPILETOOL) $(GOTOOL) $(GOLD) -linkmode external -extld "$(CC)" -extldflags "$(CFLAGS) $(LDFLAGS)" -o $(RUNME) $(RUNME).$(GOOBJEXT); \ + else \ + $(GO) $(GOCOMPILEARG) $(SRCDIR)$(RUNME).go; \ + $(COMPILETOOL) $(GOTOOL) $(GOLD) -r $${GOROOT:-`go env GOROOT`}/pkg/$${GOOS:-`go env GOOS`}_$${GOARCH:-`go env GOARCH`}:. -o $(RUNME) $(RUNME).$(GOOBJEXT); \ + fi; \ + fi + +go: $(SRCDIR_SRCS) + $(SWIG) -go -cgo $(GOOPT) $(GOSWIGARG) $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + @mkdir gopath 2>/dev/null || true + @mkdir gopath/src 2>/dev/null || true + @mkdir gopath/src/$(INTERFACE:.i=) 2>/dev/null || true + rm -f $(GOPATHDIR)/* + cp $(ISRCS) $(GOPATHDIR)/ + if test -f $(IWRAP:.i=.h); then \ + cp $(IWRAP:.i=.h) $(GOPATHDIR)/; \ + fi + if test -n "$(SRCDIR_SRCS)"; then \ + cp $(SRCDIR_SRCS) $(GOPATHDIR)/; \ + fi + cp $(GOSRCS) $(GOPATHDIR)/ + GOPATH=`pwd`/gopath; \ + export GOPATH; \ + CGO_CPPFLAGS="$(CPPFLAGS) $(INCLUDES) -I `cd $(SRCDIR) && pwd` -I `pwd`"; \ + export CGO_CPPFLAGS; \ + CGO_CFLAGS="$(CFLAGS)"; \ + export CGO_CFLAGS; \ + CGO_LDFLAGS="$(LDFLAGS) -lm"; \ + export CGO_LDFLAGS; \ + (cd $(GOPATHDIR)/ && $(COMPILETOOL) $(GO) build `if $(GOGCC); then echo -compiler=gccgo; fi` -o $(GOPACKAGE)) + cp $(GOPATHDIR)/$(GOPACKAGE) $(dir $(INTERFACE))/$(GOPACKAGE) + if $(GOGCC); then \ + cp $(dir $(INTERFACE))/$(GOPACKAGE) $(dir $(INTERFACE))/$(GOPACKAGE:.a=.gox); \ + fi + if test -f $(SRCDIR)$(RUNME).go; then \ + if $(GOGCC) ; then \ + $(COMPILETOOL) $(GCCGO) -c -g $(SRCDIR)$(RUNME).go; \ + $(COMPILETOOL) $(GCCGO) -o $(RUNME) $(RUNME).@OBJEXT@ $(dir $(INTERFACE))/$(GOPACKAGE); \ + elif $(GO12) || $(GO13) || $(GO15); then \ + $(COMPILETOOL) $(GO) $(GOCOMPILEARG) -o $(RUNME).$(GOOBJEXT) $(SRCDIR)$(RUNME).go; \ + $(COMPILETOOL) $(GOTOOL) $(GOLD) -linkmode external -extld "$(CC)" -extldflags "$(CFLAGS) $(LDFLAGS)" -o $(RUNME) $(RUNME).$(GOOBJEXT); \ + else \ + $(COMPILETOOL) $(GO) $(GOCOMPILEARG) $(SRCDIR)$(RUNME).go; \ + $(COMPILETOOL) $(GOTOOL) $(GOLD) -r $${GOROOT:-`go env GOROOT`}/pkg/$${GOOS:-`go env GOOS`}_$${GOARCH:-`go env GOARCH`}:. -o $(RUNME) $(RUNME).$(GOOBJEXT); \ + fi; \ fi # ---------------------------------------------------------------- -# Build a Go dynamically loadable module (C++) +# Build a Go module (C++) # ---------------------------------------------------------------- -go_cpp: $(SRCS) - $(SWIG) -go -c++ $(GOOPT) $(GOSWIGARG) $(SWIGOPT) $(INTERFACEPATH) - $(CXX) -g -c $(CCSHARED) $(CFLAGS) $(SRCS) $(CXXSRCS) $(ICXXSRCS) $(INCLUDES) - $(CXXSHARED) $(CFLAGS) $(OBJS) $(IOBJS) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(SO) - $(COMPILETOOL) $(GO) $(GOCOMPILEARG) -I . $(GOSRCS) +go_cpp_nocgo: $(SRCDIR_SRCS) + $(SWIG) -go -c++ $(GOOPT) $(GOSWIGARG) $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + if $(GO12) || $(GO13) || $(GO15) || $(GOGCC); then \ + if test -n "$(SRCDIR_CXXSRCS)$(SRCDIR_SRCS)"; then \ + $(CXX) -g -c $(CPPFLAGS) $(CXXFLAGS) $(SRCDIR_CXXSRCS) $(SRCDIR_SRCS) $(INCLUDES); \ + fi; \ + $(foreach f,$(ICXXSRCS), \ + $(CXX) -g -c $(CPPFLAGS) $(CXXFLAGS) -o $(addsuffix .@OBJEXT@,$(basename $f)) $f $(INCLUDES); \ + ) \ + else \ + $(CXX) -g -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(ICXXSRCS) $(INCLUDES); \ + $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(IOBJS) $(LIBS) $(CPP_DLLIBS) -o $(LIBPREFIX)$(TARGET)$(SO); \ + fi if ! $(GOGCC) ; then \ - $(COMPILETOOL) $(GOTOOL) $(GOC) -I $${GOROOT}/pkg/$${GOOS}_$${GOARCH} $(GOCSRCS) && \ - $(COMPILETOOL) $(GOPACK) grc $(GOPACKAGE) $(GOGCOBJS) $(GOCSRCS:.c=.$(GOOBJEXT)); \ + $(foreach f,$(GOSRCS), \ + $(COMPILETOOL) $(GO) $(GOCOMPILEARG) -I . -o $(addsuffix .$(GOOBJEXT),$(basename $f)) $f \ + ); \ + $(foreach f,$(GOCSRCS), \ + $(COMPILETOOL) $(GOTOOL) $(GOC) -I $${GOROOT:-`go env GOROOT`}/pkg/$${GOOS:-`go env GOOS`}_$${GOARCH:-`go env GOARCH`} \ + -o $(addsuffix .$(GOOBJEXT),$(basename $f)) $f; \ + ) \ + rm -f $(GOPACKAGE); \ + if $(GO13) || $(GO15); then \ + cp $(GOGCOBJS) $(GOPACKAGE); \ + $(COMPILETOOL) $(GOPACK) r $(GOPACKAGE) $(GOCSRCS:.c=.$(GOOBJEXT)) $(OBJS) $(IOBJS); \ + elif $(GO12); then \ + $(COMPILETOOL) $(GOPACK) grc $(GOPACKAGE) $(GOGCOBJS) $(GOCSRCS:.c=.$(GOOBJEXT)) $(OBJS) $(IOBJS); \ + else \ + $(COMPILETOOL) $(GOPACK) grc $(GOPACKAGE) $(GOGCOBJS) $(GOCSRCS:.c=.$(GOOBJEXT)); \ + fi; \ + else \ + $(foreach f,$(GOSRCS), \ + $(COMPILETOOL) $(GCCGO) -g -c -I . -o $(addsuffix .@OBJEXT@,$(basename $f)) $f \ + ); \ + fi + if test -f $(SRCDIR)$(RUNME).go; then \ + if $(GOGCC) ; then \ + $(COMPILETOOL) $(GCCGO) -g -c $(SRCDIR)$(RUNME).go; \ + $(COMPILETOOL) $(GCCGO) -o $(RUNME) $(RUNME).@OBJEXT@ $(GOGCCOBJS) $(OBJS) $(IOBJS) -lstdc++; \ + elif $(GO12) || $(GO13) || $(GO15); then \ + $(GO) $(GOCOMPILEARG) $(SRCDIR)$(RUNME).go; \ + $(COMPILETOOL) $(GOTOOL) $(GOLD) -linkmode external -extld "$(CXX)" -extldflags "$(CXXFLAGS) $(LDFLAGS)" -o $(RUNME) $(RUNME).$(GOOBJEXT); \ + else \ + $(GO) $(GOCOMPILEARG) $(SRCDIR)$(RUNME).go; \ + $(COMPILETOOL) $(GOTOOL) $(GOLD) -r $${GOROOT:-`go env GOROOT`}/pkg/$${GOOS:-`go env GOOS`}_$${GOARCH:-`go env GOARCH`}:. -o $(RUNME) $(RUNME).$(GOOBJEXT); \ + fi; \ + fi + +go_cpp: $(SRCDIR_SRCS) + $(SWIG) -go -c++ -cgo $(GOOPT) $(GOSWIGARG) $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + @mkdir gopath 2>/dev/null || true + @mkdir gopath/src 2>/dev/null || true + @mkdir gopath/src/$(INTERFACE:.i=) 2>/dev/null || true + rm -f $(GOPATHDIR)/* + cp $(ICXXSRCS) $(GOPATHDIR)/ + if test -f $(IWRAP:.i=.h); then \ + cp $(IWRAP:.i=.h) $(GOPATHDIR)/; \ + fi + if test -n "$(SRCDIR_CXXSRCS)"; then \ + cp $(SRCDIR_CXXSRCS) $(GOPATHDIR)/; \ + fi + if test -n "$(SRCDIR_SRCS)"; then \ + cp $(SRCDIR_SRCS) $(GOPATHDIR)/; \ + fi + cp $(GOSRCS) $(GOPATHDIR)/ + GOPATH=`pwd`/gopath; \ + export GOPATH; \ + CGO_CPPFLAGS="$(CPPFLAGS) $(INCLUDES) -I `cd $(SRCDIR) && pwd` -I `pwd`"; \ + export CGO_CPPFLAGS; \ + CGO_CFLAGS="$(CFLAGS)"; \ + export CGO_CFLAGS; \ + CGO_CXXFLAGS="$(CXXFLAGS)"; \ + export CGO_CXXFLAGS; \ + CGO_LDFLAGS="$(LDFLAGS) -lm"; \ + export CGO_LDFLAGS; \ + (cd $(GOPATHDIR) && $(COMPILETOOL) $(GO) build `if $(GOGCC); then echo -compiler=gccgo; fi` -o $(GOPACKAGE)) + cp $(GOPATHDIR)/$(GOPACKAGE) $(dir $(INTERFACE))/$(GOPACKAGE) + if $(GOGCC); then \ + cp $(dir $(INTERFACE))/$(GOPACKAGE) $(dir $(INTERFACE))/$(GOPACKAGE:.a=.gox); \ + fi + if test -f $(SRCDIR)$(RUNME).go; then \ + if $(GOGCC) ; then \ + $(COMPILETOOL) $(GCCGO) -g -c $(SRCDIR)$(RUNME).go; \ + $(COMPILETOOL) $(GCCGO) -o $(RUNME) $(RUNME).@OBJEXT@ $(dir $(INTERFACE))/$(GOPACKAGE) -lstdc++; \ + elif $(GO12) || $(GO13) || $(GO15); then \ + $(COMPILETOOL) $(GO) $(GOCOMPILEARG) -o $(RUNME).$(GOOBJEXT) $(SRCDIR)$(RUNME).go; \ + $(COMPILETOOL) $(GOTOOL) $(GOLD) -linkmode external -extld "$(CXX)" -extldflags "$(CXXFLAGS) $(LDFLAGS)" -o $(RUNME) $(RUNME).$(GOOBJEXT); \ + else \ + $(COMPILETOOL) $(GO) $(GOCOMPILEARG) $(SRCDIR)$(RUNME).go; \ + $(COMPILETOOL) $(GOTOOL) $(GOLD) -r $${GOROOT:-`go env GOROOT`}/pkg/$${GOOS:-`go env GOOS`}_$${GOARCH:-`go env GOARCH`}:. -o $(RUNME) $(RUNME).$(GOOBJEXT); \ + fi; \ fi # ----------------------------------------------------------------- -# Running a Go example +# Running Go example # ----------------------------------------------------------------- -go_run: runme.go - $(GO) $(GOCOMPILEARG) runme.go - if $(GOGCC) ; then \ - $(COMPILETOOL) $(GO) -o runme runme.@OBJEXT@ $(GOGCCOBJS) $(LIBPREFIX)$(TARGET)$(SO); \ - else \ - $(COMPILETOOL) $(GOTOOL) $(GOLD) -r $${GOROOT}/pkg/$${GOOS}_$${GOARCH}:. -o runme runme.$(GOOBJEXT); \ - fi - env LD_LIBRARY_PATH=.:$$LD_LIBRARY_PATH $(RUNTOOL) ./runme $(RUNPIPE) +go_run: + env $(RUNTOOL) ./$(RUNME) $(RUNPIPE) # ----------------------------------------------------------------- # Version display @@ -1648,7 +2008,8 @@ go_version: # ----------------------------------------------------------------- go_clean: - rm -f *_wrap* *_gc* .~* runme $(GOSRCS) + rm -f *_wrap* *_gc* *.gox .~* $(RUNME) $(GOSRCS) + rm -rf gopath rm -f core @EXTRA_CLEAN@ rm -f *.@OBJEXT@ *.[568] *.a *@SO@ @@ -1676,19 +2037,19 @@ D_RUNME = ./$(RUNME) # Build a dynamically loadable D wrapper for a C module # ---------------------------------------------------------------- -d: $(SRCS) - $(SWIGD) $(SWIGOPT) $(INTERFACEPATH) - $(CC) -c $(CCSHARED) $(CFLAGS) $(DCFLAGS) $(EXTRA_CFLAGS) $(SRCS) $(ISRCS) $(INCLUDES) - $(LDSHARED) $(CFLAGS) $(DCFLAGS) $(EXTRA_LDFLAGS) $(OBJS) $(IOBJS) $(LIBS) -o $(DLIBPREFIX)$(TARGET)$(SO) +d: $(SRCDIR_SRCS) + $(SWIGD) $(SWIGOPT) -o $(ISRCS) $(INTERFACEPATH) + $(CC) -c $(CCSHARED) $(CPPFLAGS) $(CFLAGS) $(DCFLAGS) $(EXTRA_CFLAGS) $(SRCDIR_SRCS) $(ISRCS) $(INCLUDES) + $(LDSHARED) $(CFLAGS) $(LDFLAGS) $(DCFLAGS) $(EXTRA_LDFLAGS) $(OBJS) $(IOBJS) $(LIBS) -o $(DLIBPREFIX)$(TARGET)$(SO) # ---------------------------------------------------------------- # Build a dynamically loadable D wrapper for a C++ module # ---------------------------------------------------------------- -d_cpp: $(SRCS) - $(SWIGD) -c++ $(SWIGOPT) $(INTERFACEPATH) - $(CXX) -c $(CCSHARED) $(CFLAGS) $(DCFLAGS) $(EXTRA_CFLAGS) $(SRCS) $(CXXSRCS) $(ICXXSRCS) $(INCLUDES) - $(CXXSHARED) $(CFLAGS) $(DCFLAGS) $(EXTRA_LDFLAGS) $(OBJS) $(IOBJS) $(LIBS) $(CPP_DLLIBS) -o $(DLIBPREFIX)$(TARGET)$(SO) +d_cpp: $(SRCDIR_SRCS) + $(SWIGD) -c++ $(SWIGOPT) -o $(ICXXSRCS) $(INTERFACEPATH) + $(CXX) -c $(CCSHARED) $(CPPFLAGS) $(CXXFLAGS) $(DCFLAGS) $(EXTRA_CFLAGS) $(SRCDIR_SRCS) $(SRCDIR_CXXSRCS) $(ICXXSRCS) $(INCLUDES) + $(CXXSHARED) $(CXXFLAGS) $(LDFLAGS) $(DCFLAGS) $(EXTRA_LDFLAGS) $(OBJS) $(IOBJS) $(LIBS) $(CPP_DLLIBS) -o $(DLIBPREFIX)$(TARGET)$(SO) # ---------------------------------------------------------------- # Compile D files @@ -1696,7 +2057,7 @@ d_cpp: $(SRCS) # Clear the DFLAGS environment variable for the compiler call itself # to work around a discrepancy in argument handling between DMD and LDC. -d_compile: $(SRCS) +d_compile: $(SRCDIR_SRCS) DFLAGS="" $(COMPILETOOL) $(DCOMPILER) $(DFLAGS) $(DSRCS) # ----------------------------------------------------------------- @@ -1704,7 +2065,7 @@ d_compile: $(SRCS) # ----------------------------------------------------------------- d_run: - $(RUNTOOL) $(D_RUNME) $(RUNPIPE) + env LD_LIBRARY_PATH=$$PWD $(RUNTOOL) $(D_RUNME) $(RUNPIPE) # ----------------------------------------------------------------- # Version display @@ -1719,6 +2080,6 @@ d_version: # ----------------------------------------------------------------- d_clean: - rm -f *_wrap* *~ .~* runme runme.exe `find . -name \*.d | grep -v runme.d` + rm -f *_wrap* *~ .~* $(RUNME) $(RUNME).exe `find . -name \*.d | grep -v $(RUNME).d` rm -f core @EXTRA_CLEAN@ rm -f *.@OBJEXT@ *@SO@ diff --git a/Examples/README b/Examples/README index 4dda322..eff0f2c 100644 --- a/Examples/README +++ b/Examples/README @@ -1,24 +1,18 @@ SWIG Examples -The "perl5", "python", "tcl", "guile", "java", "mzscheme", "ruby", and -"chicken" directories contain a number of simple examples that are -primarily used for testing. +The subdirectories of "Examples" named after SWIG's language backends +contain a number of simple examples that are primarily used for testing. The file 'index.html' is the top of a hyperlinked document that contains information about all of the examples along with various notes related to each example. -The Examples directory is currently quite incomplete because it -is being reorganized. A more complete set of examples can be found -in the SWIG1.1p5 distribution (most of which should still work with -SWIG1.3). - Note: All of the examples rely upon the Makefile in this directory. You may need to edit it to reflect the configuration of your machine in case the configure script guesses incorrect settings. -*** Special note concering C++ *** +*** Special note concerning C++ *** The configure script is currently unable to handle all of the possible options for producing dynamically loadable C++ extensions. Here are diff --git a/Examples/android/class/Makefile b/Examples/android/class/Makefile index 6155d94..8b5a090 100644 --- a/Examples/android/class/Makefile +++ b/Examples/android/class/Makefile @@ -1,11 +1,12 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib TARGET = example INTERFACE = example.i INTERFACEDIR = jni/ -PACKAGEDIR = src/org/swig +PACKAGEDIR = $(SRCDIR)src/org/swig PACKAGENAME= org.swig.classexample -SWIGOPT = -package $(PACKAGENAME) -outdir $(PACKAGEDIR)/classexample +SWIGOPT = -package $(PACKAGENAME) -outdir $(PACKAGEDIR)/classexample PROJECTNAME= SwigClass TARGETID = 1 #INSTALLOPTIONS = -s # To install on SD Card @@ -13,14 +14,15 @@ TARGETID = 1 check: build build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' INTERFACEDIR='$(INTERFACEDIR)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' INTERFACEDIR='$(INTERFACEDIR)' \ PROJECTNAME='$(PROJECTNAME)' TARGETID='$(TARGETID)' android_cpp install: - $(MAKE) -f $(TOP)/Makefile INSTALLOPTIONS='$(INSTALLOPTIONS)' PROJECTNAME='$(PROJECTNAME)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INSTALLOPTIONS='$(INSTALLOPTIONS)' PROJECTNAME='$(PROJECTNAME)' \ PACKAGEDIR='$(PACKAGEDIR)' PACKAGENAME='$(PACKAGENAME)' android_install clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' PROJECTNAME='$(PROJECTNAME)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' PROJECTNAME='$(PROJECTNAME)' \ PACKAGEDIR='$(PACKAGEDIR)' INTERFACEDIR='$(INTERFACEDIR)' android_clean diff --git a/Examples/android/class/jni/example.cpp b/Examples/android/class/jni/example.cpp index d59cc7c..7686159 100644 --- a/Examples/android/class/jni/example.cpp +++ b/Examples/android/class/jni/example.cpp @@ -11,18 +11,18 @@ void Shape::move(double dx, double dy) { int Shape::nshapes = 0; -double Circle::area(void) { +double Circle::area() { return M_PI*radius*radius; } -double Circle::perimeter(void) { +double Circle::perimeter() { return 2*M_PI*radius; } -double Square::area(void) { +double Square::area() { return width*width; } -double Square::perimeter(void) { +double Square::perimeter() { return 4*width; } diff --git a/Examples/android/class/jni/example.h b/Examples/android/class/jni/example.h index 64b7684..0dff185 100644 --- a/Examples/android/class/jni/example.h +++ b/Examples/android/class/jni/example.h @@ -7,11 +7,11 @@ public: } virtual ~Shape() { nshapes--; - }; - double x, y; + } + double x, y; void move(double dx, double dy); - virtual double area(void) = 0; - virtual double perimeter(void) = 0; + virtual double area() = 0; + virtual double perimeter() = 0; static int nshapes; }; @@ -19,16 +19,16 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; - virtual double area(void); - virtual double perimeter(void); + Circle(double r) : radius(r) { } + virtual double area(); + virtual double perimeter(); }; class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; - virtual double area(void); - virtual double perimeter(void); + Square(double w) : width(w) { } + virtual double area(); + virtual double perimeter(); }; diff --git a/Examples/android/extend/Makefile b/Examples/android/extend/Makefile index ec53013..19d90ec 100644 --- a/Examples/android/extend/Makefile +++ b/Examples/android/extend/Makefile @@ -1,11 +1,12 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib TARGET = example INTERFACE = example.i INTERFACEDIR = jni/ -PACKAGEDIR = src/org/swig +PACKAGEDIR = $(SRCDIR)src/org/swig PACKAGENAME= org.swig.extendexample -SWIGOPT = -package $(PACKAGENAME) -outdir $(PACKAGEDIR)/extendexample +SWIGOPT = -package $(PACKAGENAME) -outdir $(PACKAGEDIR)/extendexample PROJECTNAME= SwigExtend TARGETID = 1 #INSTALLOPTIONS = -s # To install on SD Card @@ -13,14 +14,15 @@ TARGETID = 1 check: build build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' INTERFACEDIR='$(INTERFACEDIR)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' INTERFACEDIR='$(INTERFACEDIR)' \ PROJECTNAME='$(PROJECTNAME)' TARGETID='$(TARGETID)' android_cpp install: - $(MAKE) -f $(TOP)/Makefile INSTALLOPTIONS='$(INSTALLOPTIONS)' PROJECTNAME='$(PROJECTNAME)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INSTALLOPTIONS='$(INSTALLOPTIONS)' PROJECTNAME='$(PROJECTNAME)' \ PACKAGEDIR='$(PACKAGEDIR)' PACKAGENAME='$(PACKAGENAME)' android_install clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' PROJECTNAME='$(PROJECTNAME)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' PROJECTNAME='$(PROJECTNAME)' \ PACKAGEDIR='$(PACKAGEDIR)' INTERFACEDIR='$(INTERFACEDIR)' android_clean diff --git a/Examples/android/extend/src/org/swig/extendexample/SwigExtend.java b/Examples/android/extend/src/org/swig/extendexample/SwigExtend.java index a343dfe..b88d360 100644 --- a/Examples/android/extend/src/org/swig/extendexample/SwigExtend.java +++ b/Examples/android/extend/src/org/swig/extendexample/SwigExtend.java @@ -96,7 +96,7 @@ public class SwigExtend extends Activity // methods of all these instances are treated the same. For items 0, 1, and // 2, all methods resolve in C++. For item 3, our CEO, getTitle calls // getPosition which resolves in Java. The call to getPosition is - // slightly different, however, because of the overidden getPosition() call, since + // slightly different, however, because of the overridden getPosition() call, since // now the object reference has been "laundered" by passing through // EmployeeList as an Employee*. Previously, Java resolved the call // immediately in CEO, but now Java thinks the object is an instance of diff --git a/Examples/android/simple/Makefile b/Examples/android/simple/Makefile index 7e7ff40..46bcd93 100644 --- a/Examples/android/simple/Makefile +++ b/Examples/android/simple/Makefile @@ -1,9 +1,10 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib TARGET = example INTERFACE = example.i INTERFACEDIR = jni/ -PACKAGEDIR = src/org/swig +PACKAGEDIR = $(SRCDIR)src/org/swig PACKAGENAME= org.swig.simple SWIGOPT = -package $(PACKAGENAME) -outdir $(PACKAGEDIR)/simple PROJECTNAME= SwigSimple @@ -13,14 +14,15 @@ TARGETID = 1 check: build build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' INTERFACEDIR='$(INTERFACEDIR)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' INTERFACEDIR='$(INTERFACEDIR)' \ PROJECTNAME='$(PROJECTNAME)' TARGETID='$(TARGETID)' android install: - $(MAKE) -f $(TOP)/Makefile INSTALLOPTIONS='$(INSTALLOPTIONS)' PROJECTNAME='$(PROJECTNAME)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INSTALLOPTIONS='$(INSTALLOPTIONS)' PROJECTNAME='$(PROJECTNAME)' \ PACKAGEDIR='$(PACKAGEDIR)' PACKAGENAME='$(PACKAGENAME)' android_install clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' PROJECTNAME='$(PROJECTNAME)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' PROJECTNAME='$(PROJECTNAME)' \ PACKAGEDIR='$(PACKAGEDIR)' INTERFACEDIR='$(INTERFACEDIR)' android_clean diff --git a/Examples/chicken/class/Makefile b/Examples/chicken/class/Makefile index 1436d83..ea2d8b6 100644 --- a/Examples/chicken/class/Makefile +++ b/Examples/chicken/class/Makefile @@ -1,38 +1,40 @@ -TOP = ../.. -SWIG = $(TOP)/../preinst-swig -INTERFACE = example.i -SRCS = -CXXSRCS = example.cxx -TARGET = class -INCLUDE = -SWIGOPT = -CFLAGS = -VARIANT = +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +INTERFACE = example.i +SRCS = +CXXSRCS = example.cxx +TARGET = class +INCLUDE = +SWIGOPT = +VARIANT = # uncomment the following lines to build a static exe (only pick one of the CHICKEN_MAIN lines) #CHICKEN_MAIN = runme-lowlevel.scm #CHICKEN_MAIN = runme-tinyclos.scm -#VARIANT = _static +#VARIANT = _static check: build - $(MAKE) -f $(TOP)/Makefile CHICKEN_SCRIPT='runme-lowlevel.scm' chicken_run - $(MAKE) -f $(TOP)/Makefile CHICKEN_SCRIPT='runme-tinyclos.scm' chicken_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CHICKEN_SCRIPT='runme-lowlevel.scm' chicken_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CHICKEN_SCRIPT='runme-tinyclos.scm' chicken_run build: $(TARGET) $(TARGET)_proxy $(TARGET): $(INTERFACE) $(SRCS) - $(MAKE) -f $(TOP)/Makefile \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ SRCS='$(SRCS)' CXXSRCS='$(CXXSRCS)' CHICKEN_MAIN='$(CHICKEN_MAIN)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ INCLUDE='$(INCLUDE)' SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' \ - SWIG='$(SWIG)' INTERFACE='$(INTERFACE)' CHICKENOPTS='$(CHICKENOPTS)' chicken$(VARIANT)_cpp + INTERFACE='$(INTERFACE)' CHICKENOPTS='$(CHICKENOPTS)' chicken$(VARIANT)_cpp $(TARGET)_proxy: $(INTERFACE) $(SRCS) - $(MAKE) -f $(TOP)/Makefile \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ SRCS='$(SRCS)' CXXSRCS='$(CXXSRCS)' CHICKEN_MAIN='$(CHICKEN_MAIN)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ INCLUDE='$(INCLUDE)' SWIGOPT='$(SWIGOPT) -proxy' TARGET='$(TARGET)_proxy' \ - SWIG='$(SWIG)' INTERFACE='$(INTERFACE)' CHICKENOPTS='$(CHICKENOPTS)' chicken$(VARIANT)_cpp + INTERFACE='$(INTERFACE)' CHICKENOPTS='$(CHICKENOPTS)' chicken$(VARIANT)_cpp clean: - $(MAKE) -f $(TOP)/Makefile chicken_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' chicken_clean rm -f example.scm rm -f $(TARGET) diff --git a/Examples/chicken/class/example.cxx b/Examples/chicken/class/example.cxx index 1e8e203..0463045 100644 --- a/Examples/chicken/class/example.cxx +++ b/Examples/chicken/class/example.cxx @@ -1,4 +1,4 @@ -/* File : example.c */ +/* File : example.cxx */ #include "example.h" #define M_PI 3.14159265358979323846 @@ -11,18 +11,18 @@ void Shape::move(double dx, double dy) { int Shape::nshapes = 0; -double Circle::area(void) { +double Circle::area() { return M_PI*radius*radius; } -double Circle::perimeter(void) { +double Circle::perimeter() { return 2*M_PI*radius; } -double Square::area(void) { +double Square::area() { return width*width; } -double Square::perimeter(void) { +double Square::perimeter() { return 4*width; } diff --git a/Examples/chicken/class/example.h b/Examples/chicken/class/example.h index 210ba98..5bad316 100644 --- a/Examples/chicken/class/example.h +++ b/Examples/chicken/class/example.h @@ -7,11 +7,11 @@ public: } virtual ~Shape() { nshapes--; - }; - double x, y; + } + double x, y; void move(double dx, double dy); - virtual double area(void) = 0; - virtual double perimeter(void) = 0; + virtual double area() = 0; + virtual double perimeter() = 0; static int nshapes; enum SomeEnum { @@ -26,21 +26,16 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; - virtual double area(void); - virtual double perimeter(void); + Circle(double r) : radius(r) { } + virtual double area(); + virtual double perimeter(); }; class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; - virtual double area(void); - virtual double perimeter(void); + Square(double w) : width(w) { } + virtual double area(); + virtual double perimeter(); }; - - - - - diff --git a/Examples/chicken/class/example.i b/Examples/chicken/class/example.i index 75700b3..fbdf724 100644 --- a/Examples/chicken/class/example.i +++ b/Examples/chicken/class/example.i @@ -7,4 +7,3 @@ /* Let's just grab the original header file here */ %include "example.h" - diff --git a/Examples/chicken/constants/Makefile b/Examples/chicken/constants/Makefile index 31e39d3..2fdde0a 100644 --- a/Examples/chicken/constants/Makefile +++ b/Examples/chicken/constants/Makefile @@ -1,30 +1,31 @@ -TOP = ../.. -SWIG = $(TOP)/../preinst-swig -INTERFACE = example.i -SRCS = -CXXSRCS = -TARGET = constants -INCLUDE = -SWIGOPT = -CFLAGS = -VARIANT = +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +INTERFACE = example.i +SRCS = +CXXSRCS = +TARGET = constants +INCLUDE = +SWIGOPT = +VARIANT = # uncomment the following two lines to build a static exe #CHICKEN_MAIN = runme.scm #VARIANT = _static check: build - $(MAKE) -f $(TOP)/Makefile chicken_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' chicken_run build: $(TARGET) $(TARGET): $(INTERFACE) $(SRCS) - $(MAKE) -f $(TOP)/Makefile \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ SRCS='$(SRCS)' CXXSRCS='$(CXXSRCS)' CHICKEN_MAIN='$(CHICKEN_MAIN)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ INCLUDE='$(INCLUDE)' SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' \ - SWIG='$(SWIG)' INTERFACE='$(INTERFACE)' CHICKENOPTS='$(CHICKENOPTS)' chicken$(VARIANT) + INTERFACE='$(INTERFACE)' CHICKENOPTS='$(CHICKENOPTS)' chicken$(VARIANT) clean: - $(MAKE) -f $(TOP)/Makefile chicken_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' chicken_clean rm -f example.scm rm -f $(TARGET) diff --git a/Examples/chicken/egg/Makefile b/Examples/chicken/egg/Makefile index 55aa114..0137dc0 100644 --- a/Examples/chicken/egg/Makefile +++ b/Examples/chicken/egg/Makefile @@ -1,4 +1,6 @@ -SWIG = ../../../preinst-swig +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib check: build cd eggs/install && csi ../../test.scm @@ -14,7 +16,7 @@ single: single_wrap.cxx # compile the single module with -nounit single_wrap.cxx: single.i - $(SWIG) -chicken -c++ -proxy -nounit single.i + $(SWIGEXE) -chicken -c++ -proxy -nounit single.i # Now build both mod1 and mod2 into a single egg multi: mod1_wrap.cxx mod2_wrap.cxx @@ -23,10 +25,10 @@ multi: mod1_wrap.cxx mod2_wrap.cxx rm -f mod1.scm mod1_wrap.cxx mod2.scm mod2_wrap.cxx mod1_wrap.cxx: mod1.i - $(SWIG) -chicken -c++ -proxy mod1.i + $(SWIGEXE) -chicken -c++ -proxy mod1.i mod2_wrap.cxx: mod2.i - $(SWIG) -chicken -c++ -proxy mod2.i + $(SWIGEXE) -chicken -c++ -proxy mod2.i clean: rm -rf eggs diff --git a/Examples/chicken/multimap/Makefile b/Examples/chicken/multimap/Makefile index eba3616..551d1c7 100644 --- a/Examples/chicken/multimap/Makefile +++ b/Examples/chicken/multimap/Makefile @@ -1,30 +1,31 @@ -TOP = ../.. -SWIG = $(TOP)/../preinst-swig -INTERFACE = example.i -SRCS = example.c -CXXSRCS = -TARGET = multimap -INCLUDE = -SWIGOPT = -CFLAGS = -VARIANT = +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +INTERFACE = example.i +SRCS = example.c +CXXSRCS = +TARGET = multimap +INCLUDE = +SWIGOPT = +VARIANT = # uncomment the following two lines to build a static exe #CHICKEN_MAIN = runme.scm -#VARIANT = _static +#VARIANT = _static check: build - $(MAKE) -f $(TOP)/Makefile chicken_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' chicken_run build: $(TARGET) $(TARGET): $(INTERFACE) $(SRCS) - $(MAKE) -f $(TOP)/Makefile \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ SRCS='$(SRCS)' CXXSRCS='$(CXXSRCS)' CHICKEN_MAIN='$(CHICKEN_MAIN)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ INCLUDE='$(INCLUDE)' SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' \ - SWIG='$(SWIG)' INTERFACE='$(INTERFACE)' CHICKENOPTS='$(CHICKENOPTS)' chicken$(VARIANT) + INTERFACE='$(INTERFACE)' CHICKENOPTS='$(CHICKENOPTS)' chicken$(VARIANT) clean: - $(MAKE) -f $(TOP)/Makefile chicken_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' chicken_clean rm -f example.scm rm -f $(TARGET) diff --git a/Examples/chicken/overload/Makefile b/Examples/chicken/overload/Makefile index e15352e..0193901 100644 --- a/Examples/chicken/overload/Makefile +++ b/Examples/chicken/overload/Makefile @@ -1,30 +1,31 @@ -TOP = ../.. -SWIG = $(TOP)/../preinst-swig -INTERFACE = example.i -SRCS = -CXXSRCS = example.cxx -TARGET = overload -INCLUDE = -SWIGOPT = -proxy -unhideprimitive -CFLAGS = -VARIANT = +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +INTERFACE = example.i +SRCS = +CXXSRCS = example.cxx +TARGET = overload +INCLUDE = +SWIGOPT = -proxy -unhideprimitive +VARIANT = # uncomment the following lines to build a static exe #CHICKEN_MAIN = runme.scm -#VARIANT = _static +#VARIANT = _static check: build - $(MAKE) -f $(TOP)/Makefile chicken_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' chicken_run build: $(TARGET) $(TARGET): $(INTERFACE) $(SRCS) - $(MAKE) -f $(TOP)/Makefile \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ SRCS='$(SRCS)' CXXSRCS='$(CXXSRCS)' CHICKEN_MAIN='$(CHICKEN_MAIN)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ INCLUDE='$(INCLUDE)' SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' \ - SWIG='$(SWIG)' INTERFACE='$(INTERFACE)' CHICKENOPTS='$(CHICKENOPTS)' chicken$(VARIANT)_cpp + INTERFACE='$(INTERFACE)' CHICKENOPTS='$(CHICKENOPTS)' chicken$(VARIANT)_cpp clean: - $(MAKE) -f $(TOP)/Makefile chicken_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' chicken_clean rm -f example.scm rm -f $(TARGET) diff --git a/Examples/chicken/simple/Makefile b/Examples/chicken/simple/Makefile index f8fb006..f5dd1a9 100644 --- a/Examples/chicken/simple/Makefile +++ b/Examples/chicken/simple/Makefile @@ -1,30 +1,31 @@ -TOP = ../.. -SWIG = $(TOP)/../preinst-swig -INTERFACE = example.i -SRCS = example.c -CXXSRCS = -TARGET = simple -INCLUDE = -SWIGOPT = -CFLAGS = -VARIANT = +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +INTERFACE = example.i +SRCS = example.c +CXXSRCS = +TARGET = simple +INCLUDE = +SWIGOPT = +VARIANT = # uncomment the following two lines to build a static exe #CHICKEN_MAIN = runme.scm -#VARIANT = _static +#VARIANT = _static check: build - $(MAKE) -f $(TOP)/Makefile chicken_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' chicken_run build: $(TARGET) $(TARGET): $(INTERFACE) $(SRCS) - $(MAKE) -f $(TOP)/Makefile \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ SRCS='$(SRCS)' CXXSRCS='$(CXXSRCS)' CHICKEN_MAIN='$(CHICKEN_MAIN)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ INCLUDE='$(INCLUDE)' SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' \ - SWIG='$(SWIG)' INTERFACE='$(INTERFACE)' CHICKENOPTS='$(CHICKENOPTS)' chicken$(VARIANT) + INTERFACE='$(INTERFACE)' CHICKENOPTS='$(CHICKENOPTS)' chicken$(VARIANT) clean: - $(MAKE) -f $(TOP)/Makefile chicken_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' chicken_clean rm -f example.scm example-generic.scm example-clos.scm rm -f $(TARGET) diff --git a/Examples/contract/simple_cxx/example.h b/Examples/contract/simple_cxx/example.h index 64b7684..de708bb 100644 --- a/Examples/contract/simple_cxx/example.h +++ b/Examples/contract/simple_cxx/example.h @@ -7,7 +7,7 @@ public: } virtual ~Shape() { nshapes--; - }; + } double x, y; void move(double dx, double dy); virtual double area(void) = 0; @@ -19,7 +19,7 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; + Circle(double r) : radius(r) { } virtual double area(void); virtual double perimeter(void); }; @@ -28,7 +28,7 @@ class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; + Square(double w) : width(w) { } virtual double area(void); virtual double perimeter(void); }; diff --git a/Examples/csharp/arrays/Makefile b/Examples/csharp/arrays/Makefile index 65386f0..66b2c21 100644 --- a/Examples/csharp/arrays/Makefile +++ b/Examples/csharp/arrays/Makefile @@ -1,19 +1,21 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i SWIGOPT = CSHARPSRCS = *.cs -CSHARPFLAGS= -nologo -unsafe -out:runme.exe +CSHARPFLAGS= -nologo -debug+ -unsafe -out:runme.exe check: build - $(MAKE) -f $(TOP)/Makefile csharp_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' csharp - $(MAKE) -f $(TOP)/Makefile CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile clean: - $(MAKE) -f $(TOP)/Makefile csharp_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_clean diff --git a/Examples/csharp/arrays/example-cs.csproj b/Examples/csharp/arrays/example-cs.csproj new file mode 100644 index 0000000..422c76b --- /dev/null +++ b/Examples/csharp/arrays/example-cs.csproj @@ -0,0 +1,90 @@ + + + Local + 8.0.50727 + 2.0 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A} + Debug + x86 + + + + + runme + + + JScript + Grid + IE50 + false + Exe + runme + OnBuildSuccess + + + + + + + + + true + bin\x86\Debug\ + DEBUG;TRACE + 285212672 + full + x86 + prompt + true + + + bin\x86\Release\ + TRACE + 285212672 + true + + + x86 + prompt + true + + + true + bin\x64\Debug\ + DEBUG;TRACE + 285212672 + full + x64 + prompt + true + + + bin\x64\Release\ + TRACE + 285212672 + true + + + x64 + prompt + true + + + + Code + + + Code + + + Code + + + + + + + copy runme.exe "$(SolutionDir)runme.exe" +echo Run the example from the root directory $(SolutionDir) and ensure example.dll is also in this directory + + diff --git a/Examples/csharp/arrays/example-vc.vcproj b/Examples/csharp/arrays/example-vc.vcproj new file mode 100644 index 0000000..d3ee58e --- /dev/null +++ b/Examples/csharp/arrays/example-vc.vcproj @@ -0,0 +1,415 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Examples/csharp/arrays/example.sln b/Examples/csharp/arrays/example.sln new file mode 100644 index 0000000..234bd64 --- /dev/null +++ b/Examples/csharp/arrays/example.sln @@ -0,0 +1,38 @@ +Microsoft Visual Studio Solution File, Format Version 9.00 +# Visual Studio 2005 +Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "example-cs", "example-cs.csproj", "{C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}" + ProjectSection(ProjectDependencies) = postProject + {C2302635-D489-4678-96B4-70F5309DCBE6} = {C2302635-D489-4678-96B4-70F5309DCBE6} + EndProjectSection +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "example-vc", "example-vc.vcproj", "{C2302635-D489-4678-96B4-70F5309DCBE6}" +EndProject +Global + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Win32 = Debug|Win32 + Debug|x64 = Debug|x64 + Release|Win32 = Release|Win32 + Release|x64 = Release|x64 + EndGlobalSection + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.ActiveCfg = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.Build.0 = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.ActiveCfg = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.Build.0 = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.ActiveCfg = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.Build.0 = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.ActiveCfg = Release|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.Build.0 = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.ActiveCfg = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.Build.0 = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.ActiveCfg = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.Build.0 = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.ActiveCfg = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.Build.0 = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.ActiveCfg = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.Build.0 = Release|x64 + EndGlobalSection + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE + EndGlobalSection +EndGlobal diff --git a/Examples/csharp/callback/Makefile b/Examples/csharp/callback/Makefile index 340febc..c7f264e 100644 --- a/Examples/csharp/callback/Makefile +++ b/Examples/csharp/callback/Makefile @@ -1,19 +1,21 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i SWIGOPT = CSHARPSRCS = *.cs -CSHARPFLAGS= -debug -nologo -out:runme.exe +CSHARPFLAGS= -nologo -debug+ -out:runme.exe check: build - $(MAKE) -f $(TOP)/Makefile csharp_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' csharp_cpp - $(MAKE) -f $(TOP)/Makefile CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile clean: - $(MAKE) -f $(TOP)/Makefile csharp_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_clean diff --git a/Examples/csharp/callback/example-cs.csproj b/Examples/csharp/callback/example-cs.csproj index ce5ccfd..14d43dc 100644 --- a/Examples/csharp/callback/example-cs.csproj +++ b/Examples/csharp/callback/example-cs.csproj @@ -1,99 +1,88 @@ - - - - - - - - - - - - - - - - - - - - - + + + Local + 8.0.50727 + 2.0 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A} + Debug + x86 + + + + + runme + + + JScript + Grid + IE50 + false + Exe + runme + OnBuildSuccess + + + + + + + + + true + bin\x86\Debug\ + DEBUG;TRACE + 285212672 + full + x86 + prompt + + + bin\x86\Release\ + TRACE + 285212672 + true + + + x86 + prompt + + + true + bin\x64\Debug\ + DEBUG;TRACE + 285212672 + full + x64 + prompt + + + bin\x64\Release\ + TRACE + 285212672 + true + + + x64 + prompt + + + + + + Code + + + Code + + + Code + + + + + + + copy runme.exe "$(SolutionDir)runme.exe" +echo Run the example from the root directory $(SolutionDir) and ensure example.dll is also in this directory + + diff --git a/Examples/csharp/callback/example-vc.vcproj b/Examples/csharp/callback/example-vc.vcproj index 5788bc9..5958945 100644 --- a/Examples/csharp/callback/example-vc.vcproj +++ b/Examples/csharp/callback/example-vc.vcproj @@ -1,110 +1,345 @@ + Keyword="Win32Proj" + > + Name="Win32" + /> + + + + InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC71.vsprops" + CharacterSet="2" + > + + + + + + Detect64BitPortabilityProblems="true" + DebugInformationFormat="4" + /> + Name="VCManagedResourceCompilerTool" + /> + + + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="1" + /> + + + + + + + + + + + + + Name="VCXMLDataGeneratorTool" + /> + Name="VCWebServiceProxyGeneratorTool" + /> + Name="VCMIDLTool" + TargetEnvironment="3" + /> + Name="VCCLCompilerTool" + Optimization="0" + PreprocessorDefinitions="WIN32;_DEBUG;_WINDOWS;_USRDLL;EXAMPLEVC_EXPORTS" + MinimalRebuild="true" + BasicRuntimeChecks="3" + RuntimeLibrary="1" + UsePrecompiledHeader="0" + WarningLevel="3" + Detect64BitPortabilityProblems="true" + DebugInformationFormat="3" + /> + + Name="VCResourceCompilerTool" + /> + Name="VCPreLinkEventTool" + /> + Name="VCLinkerTool" + OutputFile="$(OutDir)\example.dll" + LinkIncremental="2" + GenerateDebugInformation="true" + ProgramDatabaseFile="$(OutDir)\example.pdb" + SubSystem="2" + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="17" + /> + Name="VCALinkTool" + /> + Name="VCManifestTool" + /> + Name="VCXDCMakeTool" + /> + + + + + + InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC71.vsprops" + CharacterSet="2" + > + + + + + + Detect64BitPortabilityProblems="true" + DebugInformationFormat="3" + /> + Name="VCManagedResourceCompilerTool" + /> + + + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="1" + /> + + Name="VCManifestTool" + /> + Name="VCXDCMakeTool" + /> + Name="VCBscMakeTool" + /> + Name="VCFxCopTool" + /> + Name="VCAppVerifierTool" + /> + Name="VCWebDeploymentTool" + /> + Name="VCPostBuildEventTool" + Description="Copy unmanaged dll to root directory..." + CommandLine="echo on copy "$(OutDir)\example.dll" "$(SolutionDir)" @echo off " + /> + + + Name="VCPreBuildEventTool" + /> + Name="VCCustomBuildTool" + /> + Name="VCXMLDataGeneratorTool" + /> + + + + + + + + + + + + + + + @@ -113,43 +348,69 @@ + UniqueIdentifier="{4FC737F1-C7A5-4376-A066-2A32D752A2FF}" + > + RelativePath="example.cxx" + > + RelativePath="example_wrap.cxx" + > + UniqueIdentifier="{93995380-89BD-4b04-88EB-625FBE52EBFB}" + > + RelativePath="example.h" + > + + + RelativePath=".\example.i" + > + + + + + + + Name="Release|Win32" + > + CommandLine="echo Invoking SWIG... echo on ..\..\..\swig.exe -c++ -csharp "$(InputPath)" @echo off " + Outputs="$(InputName)_wrap.cxx" + /> + Name="Release|x64" + > + CommandLine="echo Invoking SWIG... echo on ..\..\..\swig.exe -c++ -csharp "$(InputPath)" @echo off " + Outputs="$(InputName)_wrap.cxx" + /> diff --git a/Examples/csharp/callback/example.i b/Examples/csharp/callback/example.i index 90beda0..cf61ef9 100644 --- a/Examples/csharp/callback/example.i +++ b/Examples/csharp/callback/example.i @@ -4,8 +4,6 @@ #include "example.h" %} -%include "std_string.i" - /* turn on director wrapping Callback */ %feature("director") Callback; diff --git a/Examples/csharp/callback/example.sln b/Examples/csharp/callback/example.sln index 88995ff..234bd64 100644 --- a/Examples/csharp/callback/example.sln +++ b/Examples/csharp/callback/example.sln @@ -1,30 +1,38 @@ -Microsoft Visual Studio Solution File, Format Version 8.00 +Microsoft Visual Studio Solution File, Format Version 9.00 +# Visual Studio 2005 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "example-cs", "example-cs.csproj", "{C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}" ProjectSection(ProjectDependencies) = postProject {C2302635-D489-4678-96B4-70F5309DCBE6} = {C2302635-D489-4678-96B4-70F5309DCBE6} EndProjectSection EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "example-vc", "example-vc.vcproj", "{C2302635-D489-4678-96B4-70F5309DCBE6}" - ProjectSection(ProjectDependencies) = postProject - EndProjectSection EndProject Global - GlobalSection(SolutionConfiguration) = preSolution - Debug = Debug - Release = Release - EndGlobalSection - GlobalSection(ProjectConfiguration) = postSolution - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug.ActiveCfg = Debug|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug.Build.0 = Debug|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release.ActiveCfg = Release|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release.Build.0 = Release|.NET - {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug.ActiveCfg = Debug|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug.Build.0 = Debug|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Release.ActiveCfg = Release|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Release.Build.0 = Release|Win32 + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Win32 = Debug|Win32 + Debug|x64 = Debug|x64 + Release|Win32 = Release|Win32 + Release|x64 = Release|x64 EndGlobalSection - GlobalSection(ExtensibilityGlobals) = postSolution + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.ActiveCfg = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.Build.0 = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.ActiveCfg = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.Build.0 = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.ActiveCfg = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.Build.0 = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.ActiveCfg = Release|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.Build.0 = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.ActiveCfg = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.Build.0 = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.ActiveCfg = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.Build.0 = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.ActiveCfg = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.Build.0 = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.ActiveCfg = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.Build.0 = Release|x64 EndGlobalSection - GlobalSection(ExtensibilityAddIns) = postSolution + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE EndGlobalSection EndGlobal diff --git a/Examples/csharp/check.list b/Examples/csharp/check.list index 5454d85..a530a4b 100644 --- a/Examples/csharp/check.list +++ b/Examples/csharp/check.list @@ -5,6 +5,7 @@ class enum extend funcptr +nested reference simple template diff --git a/Examples/csharp/class/Makefile b/Examples/csharp/class/Makefile index bc3ce8c..c7f264e 100644 --- a/Examples/csharp/class/Makefile +++ b/Examples/csharp/class/Makefile @@ -1,19 +1,21 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i SWIGOPT = CSHARPSRCS = *.cs -CSHARPFLAGS= -nologo -out:runme.exe +CSHARPFLAGS= -nologo -debug+ -out:runme.exe check: build - $(MAKE) -f $(TOP)/Makefile csharp_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' csharp_cpp - $(MAKE) -f $(TOP)/Makefile CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile clean: - $(MAKE) -f $(TOP)/Makefile csharp_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_clean diff --git a/Examples/csharp/class/example-cs.csproj b/Examples/csharp/class/example-cs.csproj index 8b105d7..4f6d66a 100644 --- a/Examples/csharp/class/example-cs.csproj +++ b/Examples/csharp/class/example-cs.csproj @@ -1,104 +1,89 @@ - - - - - - - - - - - - - - - - - - - - - - + + + Local + 8.0.50727 + 2.0 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A} + Debug + x86 + + + + + runme + + + JScript + Grid + IE50 + false + Exe + runme + OnBuildSuccess + + + + + + + + + true + bin\x86\Debug\ + DEBUG;TRACE + 285212672 + full + x86 + prompt + + + bin\x86\Release\ + TRACE + 285212672 + true + + + x86 + prompt + + + true + bin\x64\Debug\ + DEBUG;TRACE + 285212672 + full + x64 + prompt + + + bin\x64\Release\ + TRACE + 285212672 + true + + + x64 + prompt + + + + + Code + + + Code + + + Code + + + + + + + + + copy runme.exe "$(SolutionDir)runme.exe" +echo Run the example from the root directory $(SolutionDir) and ensure example.dll is also in this directory + + diff --git a/Examples/csharp/class/example-vc.vcproj b/Examples/csharp/class/example-vc.vcproj index 5788bc9..ef87095 100644 --- a/Examples/csharp/class/example-vc.vcproj +++ b/Examples/csharp/class/example-vc.vcproj @@ -1,110 +1,345 @@ + Keyword="Win32Proj" + > + Name="Win32" + /> + + + + InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC71.vsprops" + CharacterSet="2" + > + + + + + + Detect64BitPortabilityProblems="true" + DebugInformationFormat="4" + /> + Name="VCManagedResourceCompilerTool" + /> + + + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="1" + /> + Name="VCALinkTool" + /> + Name="VCManifestTool" + /> + Name="VCXDCMakeTool" + /> + Name="VCBscMakeTool" + /> + Name="VCFxCopTool" + /> + Name="VCAppVerifierTool" + /> + Name="VCWebDeploymentTool" + /> + Name="VCPostBuildEventTool" + Description="Copy unmanaged dll to root directory..." + CommandLine="echo on copy "$(OutDir)\example.dll" "$(SolutionDir)" @echo off " + /> + + + Name="VCPreBuildEventTool" + /> + Name="VCCustomBuildTool" + /> + + + + + + + + + + + + + + + + + InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC71.vsprops" + CharacterSet="2" + > + + + + + + Detect64BitPortabilityProblems="true" + DebugInformationFormat="3" + /> + + + Name="VCPreLinkEventTool" + /> + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="1" + /> + + + + + + + + + + + + + + + + + Name="VCManagedResourceCompilerTool" + /> + Name="VCResourceCompilerTool" + /> + + + Name="VCALinkTool" + /> + Name="VCManifestTool" + /> + Name="VCXDCMakeTool" + /> + Name="VCBscMakeTool" + /> + Name="VCFxCopTool" + /> + Name="VCAppVerifierTool" + /> + Name="VCWebDeploymentTool" + /> + Name="VCPostBuildEventTool" + Description="Copy unmanaged dll to root directory..." + CommandLine="echo on copy "$(OutDir)\example.dll" "$(SolutionDir)" @echo off " + /> @@ -113,43 +348,65 @@ + UniqueIdentifier="{4FC737F1-C7A5-4376-A066-2A32D752A2FF}" + > + RelativePath="example.cxx" + > + RelativePath="example_wrap.cxx" + > + UniqueIdentifier="{93995380-89BD-4b04-88EB-625FBE52EBFB}" + > + RelativePath="example.h" + > + RelativePath=".\example.i" + > + + + + + + + Name="Release|Win32" + > + CommandLine="echo Invoking SWIG... echo on ..\..\..\swig.exe -c++ -csharp "$(InputPath)" @echo off " + Outputs="$(InputName)_wrap.cxx" + /> + Name="Release|x64" + > + CommandLine="echo Invoking SWIG... echo on ..\..\..\swig.exe -c++ -csharp "$(InputPath)" @echo off " + Outputs="$(InputName)_wrap.cxx" + /> diff --git a/Examples/csharp/class/example.cxx b/Examples/csharp/class/example.cxx index 1e8e203..0463045 100644 --- a/Examples/csharp/class/example.cxx +++ b/Examples/csharp/class/example.cxx @@ -1,4 +1,4 @@ -/* File : example.c */ +/* File : example.cxx */ #include "example.h" #define M_PI 3.14159265358979323846 @@ -11,18 +11,18 @@ void Shape::move(double dx, double dy) { int Shape::nshapes = 0; -double Circle::area(void) { +double Circle::area() { return M_PI*radius*radius; } -double Circle::perimeter(void) { +double Circle::perimeter() { return 2*M_PI*radius; } -double Square::area(void) { +double Square::area() { return width*width; } -double Square::perimeter(void) { +double Square::perimeter() { return 4*width; } diff --git a/Examples/csharp/class/example.h b/Examples/csharp/class/example.h index 46d9013..0dff185 100644 --- a/Examples/csharp/class/example.h +++ b/Examples/csharp/class/example.h @@ -7,11 +7,11 @@ public: } virtual ~Shape() { nshapes--; - }; - double x, y; + } + double x, y; void move(double dx, double dy); - virtual double area(void) = 0; - virtual double perimeter(void) = 0; + virtual double area() = 0; + virtual double perimeter() = 0; static int nshapes; }; @@ -19,21 +19,16 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; - virtual double area(void); - virtual double perimeter(void); + Circle(double r) : radius(r) { } + virtual double area(); + virtual double perimeter(); }; class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; - virtual double area(void); - virtual double perimeter(void); + Square(double w) : width(w) { } + virtual double area(); + virtual double perimeter(); }; - - - - - diff --git a/Examples/csharp/class/example.i b/Examples/csharp/class/example.i index 75700b3..fbdf724 100644 --- a/Examples/csharp/class/example.i +++ b/Examples/csharp/class/example.i @@ -7,4 +7,3 @@ /* Let's just grab the original header file here */ %include "example.h" - diff --git a/Examples/csharp/class/example.sln b/Examples/csharp/class/example.sln index 88995ff..234bd64 100644 --- a/Examples/csharp/class/example.sln +++ b/Examples/csharp/class/example.sln @@ -1,30 +1,38 @@ -Microsoft Visual Studio Solution File, Format Version 8.00 +Microsoft Visual Studio Solution File, Format Version 9.00 +# Visual Studio 2005 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "example-cs", "example-cs.csproj", "{C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}" ProjectSection(ProjectDependencies) = postProject {C2302635-D489-4678-96B4-70F5309DCBE6} = {C2302635-D489-4678-96B4-70F5309DCBE6} EndProjectSection EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "example-vc", "example-vc.vcproj", "{C2302635-D489-4678-96B4-70F5309DCBE6}" - ProjectSection(ProjectDependencies) = postProject - EndProjectSection EndProject Global - GlobalSection(SolutionConfiguration) = preSolution - Debug = Debug - Release = Release - EndGlobalSection - GlobalSection(ProjectConfiguration) = postSolution - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug.ActiveCfg = Debug|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug.Build.0 = Debug|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release.ActiveCfg = Release|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release.Build.0 = Release|.NET - {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug.ActiveCfg = Debug|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug.Build.0 = Debug|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Release.ActiveCfg = Release|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Release.Build.0 = Release|Win32 + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Win32 = Debug|Win32 + Debug|x64 = Debug|x64 + Release|Win32 = Release|Win32 + Release|x64 = Release|x64 EndGlobalSection - GlobalSection(ExtensibilityGlobals) = postSolution + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.ActiveCfg = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.Build.0 = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.ActiveCfg = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.Build.0 = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.ActiveCfg = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.Build.0 = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.ActiveCfg = Release|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.Build.0 = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.ActiveCfg = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.Build.0 = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.ActiveCfg = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.Build.0 = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.ActiveCfg = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.Build.0 = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.ActiveCfg = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.Build.0 = Release|x64 EndGlobalSection - GlobalSection(ExtensibilityAddIns) = postSolution + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE EndGlobalSection EndGlobal diff --git a/Examples/csharp/enum/Makefile b/Examples/csharp/enum/Makefile index bc3ce8c..c7f264e 100644 --- a/Examples/csharp/enum/Makefile +++ b/Examples/csharp/enum/Makefile @@ -1,19 +1,21 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i SWIGOPT = CSHARPSRCS = *.cs -CSHARPFLAGS= -nologo -out:runme.exe +CSHARPFLAGS= -nologo -debug+ -out:runme.exe check: build - $(MAKE) -f $(TOP)/Makefile csharp_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' csharp_cpp - $(MAKE) -f $(TOP)/Makefile CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile clean: - $(MAKE) -f $(TOP)/Makefile csharp_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_clean diff --git a/Examples/csharp/enum/example-cs.csproj b/Examples/csharp/enum/example-cs.csproj index 44face8..5c8bd3c 100644 --- a/Examples/csharp/enum/example-cs.csproj +++ b/Examples/csharp/enum/example-cs.csproj @@ -1,99 +1,88 @@ - - - - - - - - - - - - - - - - - - - - - + + + Local + 8.0.50727 + 2.0 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A} + Debug + x86 + + + + + runme + + + JScript + Grid + IE50 + false + Exe + runme + OnBuildSuccess + + + + + + + + + true + bin\x86\Debug\ + DEBUG;TRACE + 285212672 + full + x86 + prompt + + + bin\x86\Release\ + TRACE + 285212672 + true + + + x86 + prompt + + + true + bin\x64\Debug\ + DEBUG;TRACE + 285212672 + full + x64 + prompt + + + bin\x64\Release\ + TRACE + 285212672 + true + + + x64 + prompt + + + + + Code + + + Code + + + + Code + + + + + + + copy runme.exe "$(SolutionDir)runme.exe" +echo Run the example from the root directory $(SolutionDir) and ensure example.dll is also in this directory + + diff --git a/Examples/csharp/enum/example-vc.vcproj b/Examples/csharp/enum/example-vc.vcproj index 5788bc9..ef87095 100644 --- a/Examples/csharp/enum/example-vc.vcproj +++ b/Examples/csharp/enum/example-vc.vcproj @@ -1,110 +1,345 @@ + Keyword="Win32Proj" + > + Name="Win32" + /> + + + + InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC71.vsprops" + CharacterSet="2" + > + + + + + + Detect64BitPortabilityProblems="true" + DebugInformationFormat="4" + /> + Name="VCManagedResourceCompilerTool" + /> + + + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="1" + /> + Name="VCALinkTool" + /> + Name="VCManifestTool" + /> + Name="VCXDCMakeTool" + /> + Name="VCBscMakeTool" + /> + Name="VCFxCopTool" + /> + Name="VCAppVerifierTool" + /> + Name="VCWebDeploymentTool" + /> + Name="VCPostBuildEventTool" + Description="Copy unmanaged dll to root directory..." + CommandLine="echo on copy "$(OutDir)\example.dll" "$(SolutionDir)" @echo off " + /> + + + Name="VCPreBuildEventTool" + /> + Name="VCCustomBuildTool" + /> + + + + + + + + + + + + + + + + + InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC71.vsprops" + CharacterSet="2" + > + + + + + + Detect64BitPortabilityProblems="true" + DebugInformationFormat="3" + /> + + + Name="VCPreLinkEventTool" + /> + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="1" + /> + + + + + + + + + + + + + + + + + Name="VCManagedResourceCompilerTool" + /> + Name="VCResourceCompilerTool" + /> + + + Name="VCALinkTool" + /> + Name="VCManifestTool" + /> + Name="VCXDCMakeTool" + /> + Name="VCBscMakeTool" + /> + Name="VCFxCopTool" + /> + Name="VCAppVerifierTool" + /> + Name="VCWebDeploymentTool" + /> + Name="VCPostBuildEventTool" + Description="Copy unmanaged dll to root directory..." + CommandLine="echo on copy "$(OutDir)\example.dll" "$(SolutionDir)" @echo off " + /> @@ -113,43 +348,65 @@ + UniqueIdentifier="{4FC737F1-C7A5-4376-A066-2A32D752A2FF}" + > + RelativePath="example.cxx" + > + RelativePath="example_wrap.cxx" + > + UniqueIdentifier="{93995380-89BD-4b04-88EB-625FBE52EBFB}" + > + RelativePath="example.h" + > + RelativePath=".\example.i" + > + + + + + + + Name="Release|Win32" + > + CommandLine="echo Invoking SWIG... echo on ..\..\..\swig.exe -c++ -csharp "$(InputPath)" @echo off " + Outputs="$(InputName)_wrap.cxx" + /> + Name="Release|x64" + > + CommandLine="echo Invoking SWIG... echo on ..\..\..\swig.exe -c++ -csharp "$(InputPath)" @echo off " + Outputs="$(InputName)_wrap.cxx" + /> diff --git a/Examples/csharp/enum/example.sln b/Examples/csharp/enum/example.sln index 88995ff..234bd64 100644 --- a/Examples/csharp/enum/example.sln +++ b/Examples/csharp/enum/example.sln @@ -1,30 +1,38 @@ -Microsoft Visual Studio Solution File, Format Version 8.00 +Microsoft Visual Studio Solution File, Format Version 9.00 +# Visual Studio 2005 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "example-cs", "example-cs.csproj", "{C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}" ProjectSection(ProjectDependencies) = postProject {C2302635-D489-4678-96B4-70F5309DCBE6} = {C2302635-D489-4678-96B4-70F5309DCBE6} EndProjectSection EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "example-vc", "example-vc.vcproj", "{C2302635-D489-4678-96B4-70F5309DCBE6}" - ProjectSection(ProjectDependencies) = postProject - EndProjectSection EndProject Global - GlobalSection(SolutionConfiguration) = preSolution - Debug = Debug - Release = Release - EndGlobalSection - GlobalSection(ProjectConfiguration) = postSolution - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug.ActiveCfg = Debug|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug.Build.0 = Debug|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release.ActiveCfg = Release|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release.Build.0 = Release|.NET - {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug.ActiveCfg = Debug|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug.Build.0 = Debug|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Release.ActiveCfg = Release|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Release.Build.0 = Release|Win32 + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Win32 = Debug|Win32 + Debug|x64 = Debug|x64 + Release|Win32 = Release|Win32 + Release|x64 = Release|x64 EndGlobalSection - GlobalSection(ExtensibilityGlobals) = postSolution + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.ActiveCfg = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.Build.0 = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.ActiveCfg = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.Build.0 = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.ActiveCfg = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.Build.0 = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.ActiveCfg = Release|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.Build.0 = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.ActiveCfg = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.Build.0 = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.ActiveCfg = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.Build.0 = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.ActiveCfg = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.Build.0 = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.ActiveCfg = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.Build.0 = Release|x64 EndGlobalSection - GlobalSection(ExtensibilityAddIns) = postSolution + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE EndGlobalSection EndGlobal diff --git a/Examples/csharp/extend/Makefile b/Examples/csharp/extend/Makefile index bc3ce8c..c7f264e 100644 --- a/Examples/csharp/extend/Makefile +++ b/Examples/csharp/extend/Makefile @@ -1,19 +1,21 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i SWIGOPT = CSHARPSRCS = *.cs -CSHARPFLAGS= -nologo -out:runme.exe +CSHARPFLAGS= -nologo -debug+ -out:runme.exe check: build - $(MAKE) -f $(TOP)/Makefile csharp_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' csharp_cpp - $(MAKE) -f $(TOP)/Makefile CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile clean: - $(MAKE) -f $(TOP)/Makefile csharp_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_clean diff --git a/Examples/csharp/extend/example-cs.csproj b/Examples/csharp/extend/example-cs.csproj index 9592399..68d202c 100644 --- a/Examples/csharp/extend/example-cs.csproj +++ b/Examples/csharp/extend/example-cs.csproj @@ -1,104 +1,89 @@ - - - - - - - - - - - - - - - - - - - - - - + + + Local + 8.0.50727 + 2.0 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A} + Debug + x86 + + + + + runme + + + JScript + Grid + IE50 + false + Exe + runme + OnBuildSuccess + + + + + + + + + true + bin\x86\Debug\ + DEBUG;TRACE + 285212672 + full + x86 + prompt + + + bin\x86\Release\ + TRACE + 285212672 + true + + + x86 + prompt + + + true + bin\x64\Debug\ + DEBUG;TRACE + 285212672 + full + x64 + prompt + + + bin\x64\Release\ + TRACE + 285212672 + true + + + x64 + prompt + + + + + + Code + + + Code + + + + Code + + + + + + + copy runme.exe "$(SolutionDir)runme.exe" +echo Run the example from the root directory $(SolutionDir) and ensure example.dll is also in this directory + + diff --git a/Examples/csharp/extend/example-vc.vcproj b/Examples/csharp/extend/example-vc.vcproj index 5788bc9..5958945 100644 --- a/Examples/csharp/extend/example-vc.vcproj +++ b/Examples/csharp/extend/example-vc.vcproj @@ -1,110 +1,345 @@ + Keyword="Win32Proj" + > + Name="Win32" + /> + + + + InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC71.vsprops" + CharacterSet="2" + > + + + + + + Detect64BitPortabilityProblems="true" + DebugInformationFormat="4" + /> + Name="VCManagedResourceCompilerTool" + /> + + + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="1" + /> + + + + + + + + + + + + + Name="VCXMLDataGeneratorTool" + /> + Name="VCWebServiceProxyGeneratorTool" + /> + Name="VCMIDLTool" + TargetEnvironment="3" + /> + Name="VCCLCompilerTool" + Optimization="0" + PreprocessorDefinitions="WIN32;_DEBUG;_WINDOWS;_USRDLL;EXAMPLEVC_EXPORTS" + MinimalRebuild="true" + BasicRuntimeChecks="3" + RuntimeLibrary="1" + UsePrecompiledHeader="0" + WarningLevel="3" + Detect64BitPortabilityProblems="true" + DebugInformationFormat="3" + /> + + Name="VCResourceCompilerTool" + /> + Name="VCPreLinkEventTool" + /> + Name="VCLinkerTool" + OutputFile="$(OutDir)\example.dll" + LinkIncremental="2" + GenerateDebugInformation="true" + ProgramDatabaseFile="$(OutDir)\example.pdb" + SubSystem="2" + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="17" + /> + Name="VCALinkTool" + /> + Name="VCManifestTool" + /> + Name="VCXDCMakeTool" + /> + + + + + + InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC71.vsprops" + CharacterSet="2" + > + + + + + + Detect64BitPortabilityProblems="true" + DebugInformationFormat="3" + /> + Name="VCManagedResourceCompilerTool" + /> + + + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="1" + /> + + Name="VCManifestTool" + /> + Name="VCXDCMakeTool" + /> + Name="VCBscMakeTool" + /> + Name="VCFxCopTool" + /> + Name="VCAppVerifierTool" + /> + Name="VCWebDeploymentTool" + /> + Name="VCPostBuildEventTool" + Description="Copy unmanaged dll to root directory..." + CommandLine="echo on copy "$(OutDir)\example.dll" "$(SolutionDir)" @echo off " + /> + + + Name="VCPreBuildEventTool" + /> + Name="VCCustomBuildTool" + /> + Name="VCXMLDataGeneratorTool" + /> + + + + + + + + + + + + + + + @@ -113,43 +348,69 @@ + UniqueIdentifier="{4FC737F1-C7A5-4376-A066-2A32D752A2FF}" + > + RelativePath="example.cxx" + > + RelativePath="example_wrap.cxx" + > + UniqueIdentifier="{93995380-89BD-4b04-88EB-625FBE52EBFB}" + > + RelativePath="example.h" + > + + + RelativePath=".\example.i" + > + + + + + + + Name="Release|Win32" + > + CommandLine="echo Invoking SWIG... echo on ..\..\..\swig.exe -c++ -csharp "$(InputPath)" @echo off " + Outputs="$(InputName)_wrap.cxx" + /> + Name="Release|x64" + > + CommandLine="echo Invoking SWIG... echo on ..\..\..\swig.exe -c++ -csharp "$(InputPath)" @echo off " + Outputs="$(InputName)_wrap.cxx" + /> diff --git a/Examples/csharp/extend/example.h b/Examples/csharp/extend/example.h index b27ab97..ca1aed2 100644 --- a/Examples/csharp/extend/example.h +++ b/Examples/csharp/extend/example.h @@ -14,7 +14,7 @@ public: virtual std::string getTitle() { return getPosition() + " " + getName(); } virtual std::string getName() { return name; } virtual std::string getPosition() const { return "Employee"; } - virtual ~Employee() { printf("~Employee() @ %p\n", this); } + virtual ~Employee() { printf("~Employee() @ %p\n", (void *)this); } }; diff --git a/Examples/csharp/extend/example.sln b/Examples/csharp/extend/example.sln index 88995ff..234bd64 100644 --- a/Examples/csharp/extend/example.sln +++ b/Examples/csharp/extend/example.sln @@ -1,30 +1,38 @@ -Microsoft Visual Studio Solution File, Format Version 8.00 +Microsoft Visual Studio Solution File, Format Version 9.00 +# Visual Studio 2005 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "example-cs", "example-cs.csproj", "{C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}" ProjectSection(ProjectDependencies) = postProject {C2302635-D489-4678-96B4-70F5309DCBE6} = {C2302635-D489-4678-96B4-70F5309DCBE6} EndProjectSection EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "example-vc", "example-vc.vcproj", "{C2302635-D489-4678-96B4-70F5309DCBE6}" - ProjectSection(ProjectDependencies) = postProject - EndProjectSection EndProject Global - GlobalSection(SolutionConfiguration) = preSolution - Debug = Debug - Release = Release - EndGlobalSection - GlobalSection(ProjectConfiguration) = postSolution - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug.ActiveCfg = Debug|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug.Build.0 = Debug|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release.ActiveCfg = Release|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release.Build.0 = Release|.NET - {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug.ActiveCfg = Debug|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug.Build.0 = Debug|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Release.ActiveCfg = Release|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Release.Build.0 = Release|Win32 + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Win32 = Debug|Win32 + Debug|x64 = Debug|x64 + Release|Win32 = Release|Win32 + Release|x64 = Release|x64 EndGlobalSection - GlobalSection(ExtensibilityGlobals) = postSolution + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.ActiveCfg = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.Build.0 = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.ActiveCfg = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.Build.0 = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.ActiveCfg = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.Build.0 = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.ActiveCfg = Release|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.Build.0 = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.ActiveCfg = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.Build.0 = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.ActiveCfg = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.Build.0 = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.ActiveCfg = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.Build.0 = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.ActiveCfg = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.Build.0 = Release|x64 EndGlobalSection - GlobalSection(ExtensibilityAddIns) = postSolution + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE EndGlobalSection EndGlobal diff --git a/Examples/csharp/extend/runme.cs b/Examples/csharp/extend/runme.cs index 825dcdb..92313aa 100644 --- a/Examples/csharp/extend/runme.cs +++ b/Examples/csharp/extend/runme.cs @@ -45,7 +45,7 @@ public class runme // methods of all these instances are treated the same. For items 0, 1, and // 2, all methods resolve in C++. For item 3, our CEO, getTitle calls // getPosition which resolves in C#. The call to getPosition is - // slightly different, however, because of the overidden getPosition() call, since + // slightly different, however, because of the overridden getPosition() call, since // now the object reference has been "laundered" by passing through // EmployeeList as an Employee*. Previously, C# resolved the call // immediately in CEO, but now C# thinks the object is an instance of diff --git a/Examples/csharp/funcptr/Makefile b/Examples/csharp/funcptr/Makefile index 875ae0e..9af1d66 100644 --- a/Examples/csharp/funcptr/Makefile +++ b/Examples/csharp/funcptr/Makefile @@ -1,19 +1,21 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i SWIGOPT = CSHARPSRCS = *.cs -CSHARPFLAGS= -nologo -out:runme.exe +CSHARPFLAGS= -nologo -debug+ -out:runme.exe check: build - $(MAKE) -f $(TOP)/Makefile csharp_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' csharp - $(MAKE) -f $(TOP)/Makefile CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile clean: - $(MAKE) -f $(TOP)/Makefile csharp_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_clean diff --git a/Examples/csharp/funcptr/example-cs.csproj b/Examples/csharp/funcptr/example-cs.csproj index 5a107c5..d8c4559 100644 --- a/Examples/csharp/funcptr/example-cs.csproj +++ b/Examples/csharp/funcptr/example-cs.csproj @@ -1,94 +1,87 @@ - - - - - - - - - - - - - - - - - - - - + + + Local + 8.0.50727 + 2.0 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A} + Debug + x86 + + + + + runme + + + JScript + Grid + IE50 + false + Exe + runme + OnBuildSuccess + + + + + + + + + true + bin\x86\Debug\ + DEBUG;TRACE + 285212672 + full + x86 + prompt + + + bin\x86\Release\ + TRACE + 285212672 + true + + + x86 + prompt + + + true + bin\x64\Debug\ + DEBUG;TRACE + 285212672 + full + x64 + prompt + + + bin\x64\Release\ + TRACE + 285212672 + true + + + x64 + prompt + + + + Code + + + Code + + + Code + + + + + + + + copy runme.exe "$(SolutionDir)runme.exe" +echo Run the example from the root directory $(SolutionDir) and ensure example.dll is also in this directory + + diff --git a/Examples/csharp/funcptr/example-vc.vcproj b/Examples/csharp/funcptr/example-vc.vcproj index 7ba8cbd..d3ee58e 100644 --- a/Examples/csharp/funcptr/example-vc.vcproj +++ b/Examples/csharp/funcptr/example-vc.vcproj @@ -1,110 +1,345 @@ + Keyword="Win32Proj" + > + Name="Win32" + /> + + + + InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC71.vsprops" + CharacterSet="2" + > + + + + + + Detect64BitPortabilityProblems="true" + DebugInformationFormat="4" + /> + Name="VCManagedResourceCompilerTool" + /> + + + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="1" + /> + Name="VCALinkTool" + /> + Name="VCManifestTool" + /> + Name="VCXDCMakeTool" + /> + Name="VCBscMakeTool" + /> + Name="VCFxCopTool" + /> + Name="VCAppVerifierTool" + /> + Name="VCWebDeploymentTool" + /> + Name="VCPostBuildEventTool" + Description="Copy unmanaged dll to root directory..." + CommandLine="echo on copy "$(OutDir)\example.dll" "$(SolutionDir)" @echo off " + /> + + + Name="VCPreBuildEventTool" + /> + Name="VCCustomBuildTool" + /> + + + + + + + + + + + + + + + + + InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC71.vsprops" + CharacterSet="2" + > + + + + + + Detect64BitPortabilityProblems="true" + DebugInformationFormat="3" + /> + + + Name="VCPreLinkEventTool" + /> + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="1" + /> + + + + + + + + + + + + + + + + + Name="VCManagedResourceCompilerTool" + /> + Name="VCResourceCompilerTool" + /> + + + Name="VCALinkTool" + /> + Name="VCManifestTool" + /> + Name="VCXDCMakeTool" + /> + Name="VCBscMakeTool" + /> + Name="VCFxCopTool" + /> + Name="VCAppVerifierTool" + /> + Name="VCWebDeploymentTool" + /> + Name="VCPostBuildEventTool" + Description="Copy unmanaged dll to root directory..." + CommandLine="echo on copy "$(OutDir)\example.dll" "$(SolutionDir)" @echo off " + /> @@ -113,45 +348,65 @@ + UniqueIdentifier="{4FC737F1-C7A5-4376-A066-2A32D752A2FF}" + > + RelativePath="example.c" + > + RelativePath="example_wrap.c" + > + UniqueIdentifier="{93995380-89BD-4b04-88EB-625FBE52EBFB}" + > + RelativePath="example.h" + > + RelativePath=".\example.i" + > + + + + + + + Name="Release|Win32" + > + CommandLine="echo Invoking SWIG... echo on ..\..\..\swig.exe -csharp "$(InputPath)" @echo off " + Outputs="$(InputName)_wrap.c" + /> + Name="Release|x64" + > + CommandLine="echo Invoking SWIG... echo on ..\..\..\swig.exe -csharp "$(InputPath)" @echo off " + Outputs="$(InputName)_wrap.c" + /> diff --git a/Examples/csharp/funcptr/example.sln b/Examples/csharp/funcptr/example.sln index 88995ff..234bd64 100644 --- a/Examples/csharp/funcptr/example.sln +++ b/Examples/csharp/funcptr/example.sln @@ -1,30 +1,38 @@ -Microsoft Visual Studio Solution File, Format Version 8.00 +Microsoft Visual Studio Solution File, Format Version 9.00 +# Visual Studio 2005 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "example-cs", "example-cs.csproj", "{C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}" ProjectSection(ProjectDependencies) = postProject {C2302635-D489-4678-96B4-70F5309DCBE6} = {C2302635-D489-4678-96B4-70F5309DCBE6} EndProjectSection EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "example-vc", "example-vc.vcproj", "{C2302635-D489-4678-96B4-70F5309DCBE6}" - ProjectSection(ProjectDependencies) = postProject - EndProjectSection EndProject Global - GlobalSection(SolutionConfiguration) = preSolution - Debug = Debug - Release = Release - EndGlobalSection - GlobalSection(ProjectConfiguration) = postSolution - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug.ActiveCfg = Debug|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug.Build.0 = Debug|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release.ActiveCfg = Release|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release.Build.0 = Release|.NET - {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug.ActiveCfg = Debug|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug.Build.0 = Debug|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Release.ActiveCfg = Release|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Release.Build.0 = Release|Win32 + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Win32 = Debug|Win32 + Debug|x64 = Debug|x64 + Release|Win32 = Release|Win32 + Release|x64 = Release|x64 EndGlobalSection - GlobalSection(ExtensibilityGlobals) = postSolution + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.ActiveCfg = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.Build.0 = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.ActiveCfg = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.Build.0 = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.ActiveCfg = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.Build.0 = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.ActiveCfg = Release|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.Build.0 = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.ActiveCfg = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.Build.0 = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.ActiveCfg = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.Build.0 = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.ActiveCfg = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.Build.0 = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.ActiveCfg = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.Build.0 = Release|x64 EndGlobalSection - GlobalSection(ExtensibilityAddIns) = postSolution + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE EndGlobalSection EndGlobal diff --git a/Examples/csharp/nested/Makefile b/Examples/csharp/nested/Makefile new file mode 100644 index 0000000..c7f264e --- /dev/null +++ b/Examples/csharp/nested/Makefile @@ -0,0 +1,21 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = example.cxx +TARGET = example +INTERFACE = example.i +SWIGOPT = +CSHARPSRCS = *.cs +CSHARPFLAGS= -nologo -debug+ -out:runme.exe + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' csharp_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_clean diff --git a/Examples/csharp/nested/example-cs.csproj b/Examples/csharp/nested/example-cs.csproj new file mode 100644 index 0000000..b20ff23 --- /dev/null +++ b/Examples/csharp/nested/example-cs.csproj @@ -0,0 +1,87 @@ + + + Local + 8.0.50727 + 2.0 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A} + Debug + x86 + + + + + runme + + + JScript + Grid + IE50 + false + Exe + runme + OnBuildSuccess + + + + + + + + + true + bin\x86\Debug\ + DEBUG;TRACE + 285212672 + full + x86 + prompt + + + bin\x86\Release\ + TRACE + 285212672 + true + + + x86 + prompt + + + true + bin\x64\Debug\ + DEBUG;TRACE + 285212672 + full + x64 + prompt + + + bin\x64\Release\ + TRACE + 285212672 + true + + + x64 + prompt + + + + Code + + + Code + + + Code + + + + + + + + copy runme.exe "$(SolutionDir)runme.exe" +echo Run the example from the root directory $(SolutionDir) and ensure example.dll is also in this directory + + diff --git a/Examples/csharp/nested/example-vc.vcproj b/Examples/csharp/nested/example-vc.vcproj new file mode 100644 index 0000000..ef87095 --- /dev/null +++ b/Examples/csharp/nested/example-vc.vcproj @@ -0,0 +1,415 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Examples/csharp/nested/example.cxx b/Examples/csharp/nested/example.cxx new file mode 100644 index 0000000..03bb74d --- /dev/null +++ b/Examples/csharp/nested/example.cxx @@ -0,0 +1,62 @@ +#include "example.h" + +int MotorCar::DesignOpinion::AceDesignCount = 0; +int MotorCar::DesignOpinion::TotalDesignCount = 0; + +int MotorCar::DesignOpinion::PercentScore() { + return AceDesignCount*100/TotalDesignCount; +} + +MotorCar::Wheels::Wheels(Shape shape, size_t count) : shape(shape), count(count) {} + +MotorCar::WindScreen::WindScreen(bool opaque) : opaque(opaque) {} + +MotorCar::MotorCar(const std::string &name, const Wheels &wheels, const WindScreen &windscreen) : name(name), wheels(wheels), windscreen(windscreen) {} + +MotorCar MotorCar::DesignFromComponents(const std::string &name, const Wheels &wheels, const WindScreen &windscreen) { + MotorCar car = MotorCar(name, wheels, windscreen); + DesignOpinion::TotalDesignCount++; + if (car.wheels.Opinion().itrocks && car.windscreen.Opinion().itrocks) + DesignOpinion::AceDesignCount++; + return car; +} + +MotorCar::DesignOpinion MotorCar::Wheels::Opinion() { + DesignOpinion opinion; + opinion.itrocks = true; + if (shape == Square) { + opinion.itrocks = false; + opinion.reason = "you'll have a few issues with wheel rotation"; + } + if (count <= 2) { + opinion.reason += opinion.itrocks ? "" : " and "; + opinion.itrocks = false; + opinion.reason += "a few more wheels are needed for stability"; + } + if (opinion.itrocks) + opinion.reason = "your choice of wheels was top notch"; + + return opinion; +} + +MotorCar::DesignOpinion MotorCar::WindScreen::Opinion() { + DesignOpinion opinion; + opinion.itrocks = !opaque; + opinion.reason = opinion.itrocks ? "the driver will have a commanding view out the window" : "you can't see out the windscreen"; + return opinion; +} + +std::string MotorCar::WillItWork() { + DesignOpinion wh = wheels.Opinion(); + DesignOpinion ws = windscreen.Opinion(); + std::string willit; + if (wh.itrocks && ws.itrocks) { + willit = "Great car design because " + wh.reason + " and " + ws.reason; + } else { + willit = "You need a rethink because "; + willit += wh.itrocks ? "" : wh.reason; + willit += (!wh.itrocks && !ws.itrocks) ? " and " : ""; + willit += ws.itrocks ? "" : ws.reason; + } + return willit; +} diff --git a/Examples/csharp/nested/example.h b/Examples/csharp/nested/example.h new file mode 100644 index 0000000..4fb107c --- /dev/null +++ b/Examples/csharp/nested/example.h @@ -0,0 +1,48 @@ +#include + +/** Design a motor car from various components */ +struct MotorCar { + + /** Information about an opinion of the design of a car component */ + struct DesignOpinion { + bool itrocks; + std::string reason; + static int AceDesignCount; + static int TotalDesignCount; + static int PercentScore(); + }; + + /** Wheels component */ + struct Wheels { + enum Shape { Round, Square }; + Wheels(Shape shape, size_t count); + DesignOpinion Opinion(); + private: + Shape shape; + size_t count; + }; + + /** Windscreen component */ + struct WindScreen { + WindScreen(bool opaque); + DesignOpinion Opinion(); + private: + bool opaque; + }; + + /** Factory method for creating a car */ + static MotorCar DesignFromComponents(const std::string &name, const Wheels &wheels, const WindScreen &windscreen); + + std::string Name() { + return name; + } + + /** Get an overall opinion on the car design */ + std::string WillItWork(); + +private: + MotorCar(const std::string &name, const Wheels &wheels, const WindScreen &windscreen); + std::string name; + Wheels wheels; + WindScreen windscreen; +}; diff --git a/Examples/csharp/nested/example.i b/Examples/csharp/nested/example.i new file mode 100644 index 0000000..c07c152 --- /dev/null +++ b/Examples/csharp/nested/example.i @@ -0,0 +1,13 @@ +%module example + +// This example shows how wrappers for numerous aspects of C++ nested classes work: +// Nested static and instance variables and methods and nested enums + +%include + +%{ +#include "example.h" +%} + +%include "example.h" + diff --git a/Examples/csharp/nested/example.sln b/Examples/csharp/nested/example.sln new file mode 100644 index 0000000..234bd64 --- /dev/null +++ b/Examples/csharp/nested/example.sln @@ -0,0 +1,38 @@ +Microsoft Visual Studio Solution File, Format Version 9.00 +# Visual Studio 2005 +Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "example-cs", "example-cs.csproj", "{C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}" + ProjectSection(ProjectDependencies) = postProject + {C2302635-D489-4678-96B4-70F5309DCBE6} = {C2302635-D489-4678-96B4-70F5309DCBE6} + EndProjectSection +EndProject +Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "example-vc", "example-vc.vcproj", "{C2302635-D489-4678-96B4-70F5309DCBE6}" +EndProject +Global + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Win32 = Debug|Win32 + Debug|x64 = Debug|x64 + Release|Win32 = Release|Win32 + Release|x64 = Release|x64 + EndGlobalSection + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.ActiveCfg = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.Build.0 = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.ActiveCfg = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.Build.0 = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.ActiveCfg = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.Build.0 = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.ActiveCfg = Release|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.Build.0 = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.ActiveCfg = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.Build.0 = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.ActiveCfg = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.Build.0 = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.ActiveCfg = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.Build.0 = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.ActiveCfg = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.Build.0 = Release|x64 + EndGlobalSection + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE + EndGlobalSection +EndGlobal diff --git a/Examples/csharp/nested/runme.cs b/Examples/csharp/nested/runme.cs new file mode 100644 index 0000000..facaefd --- /dev/null +++ b/Examples/csharp/nested/runme.cs @@ -0,0 +1,27 @@ +// This example illustrates how C++ classes can be used from C# using SWIG. +// The C# class gets mapped onto the C++ class and behaves as if it is a C# class. + +using System; + +public class runme +{ + static void Main() + { + MotorCar car1 = MotorCar.DesignFromComponents("Bumpy", new MotorCar.Wheels(MotorCar.Wheels.Shape.Square, 4), new MotorCar.WindScreen(false)); + MotorCar car2 = MotorCar.DesignFromComponents("Wobbly", new MotorCar.Wheels(MotorCar.Wheels.Shape.Round, 2), new MotorCar.WindScreen(false)); + MotorCar car3 = MotorCar.DesignFromComponents("Batty", new MotorCar.Wheels(MotorCar.Wheels.Shape.Round, 4), new MotorCar.WindScreen(true)); + MotorCar car4 = MotorCar.DesignFromComponents("Spiffing", new MotorCar.Wheels(MotorCar.Wheels.Shape.Round, 4), new MotorCar.WindScreen(false)); + + Console.WriteLine("Expert opinion on " + car1.Name() + " : \n " + car1.WillItWork()); + Console.WriteLine("Expert opinion on " + car2.Name() + " : \n " + car2.WillItWork()); + Console.WriteLine("Expert opinion on " + car3.Name() + " : \n " + car3.WillItWork()); + Console.WriteLine("Expert opinion on " + car4.Name() + " : \n " + car4.WillItWork()); + + int count = MotorCar.DesignOpinion.AceDesignCount; + int total = MotorCar.DesignOpinion.TotalDesignCount; + int percent = MotorCar.DesignOpinion.PercentScore(); + Console.WriteLine("Overall opinion rating on car design is " + count + "/" + total + " = " + percent + "%"); + + Console.WriteLine("Single square wheel thoughts: " + new MotorCar.Wheels(MotorCar.Wheels.Shape.Square, 1).Opinion().reason); + } +} diff --git a/Examples/csharp/reference/Makefile b/Examples/csharp/reference/Makefile index bc3ce8c..c7f264e 100644 --- a/Examples/csharp/reference/Makefile +++ b/Examples/csharp/reference/Makefile @@ -1,19 +1,21 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i SWIGOPT = CSHARPSRCS = *.cs -CSHARPFLAGS= -nologo -out:runme.exe +CSHARPFLAGS= -nologo -debug+ -out:runme.exe check: build - $(MAKE) -f $(TOP)/Makefile csharp_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' csharp_cpp - $(MAKE) -f $(TOP)/Makefile CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile clean: - $(MAKE) -f $(TOP)/Makefile csharp_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_clean diff --git a/Examples/csharp/reference/example-cs.csproj b/Examples/csharp/reference/example-cs.csproj index a3efbe0..c8ad318 100644 --- a/Examples/csharp/reference/example-cs.csproj +++ b/Examples/csharp/reference/example-cs.csproj @@ -1,99 +1,88 @@ - - - - - - - - - - - - - - - - - - - - - + + + Local + 8.0.50727 + 2.0 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A} + Debug + x86 + + + + + runme + + + JScript + Grid + IE50 + false + Exe + runme + OnBuildSuccess + + + + + + + + + true + bin\x86\Debug\ + DEBUG;TRACE + 285212672 + full + x86 + prompt + + + bin\x86\Release\ + TRACE + 285212672 + true + + + x86 + prompt + + + true + bin\x64\Debug\ + DEBUG;TRACE + 285212672 + full + x64 + prompt + + + bin\x64\Release\ + TRACE + 285212672 + true + + + x64 + prompt + + + + Code + + + Code + + + Code + + + + + + + + + copy runme.exe "$(SolutionDir)runme.exe" +echo Run the example from the root directory $(SolutionDir) and ensure example.dll is also in this directory + + diff --git a/Examples/csharp/reference/example-vc.vcproj b/Examples/csharp/reference/example-vc.vcproj index 5788bc9..ef87095 100644 --- a/Examples/csharp/reference/example-vc.vcproj +++ b/Examples/csharp/reference/example-vc.vcproj @@ -1,110 +1,345 @@ + Keyword="Win32Proj" + > + Name="Win32" + /> + + + + InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC71.vsprops" + CharacterSet="2" + > + + + + + + Detect64BitPortabilityProblems="true" + DebugInformationFormat="4" + /> + Name="VCManagedResourceCompilerTool" + /> + + + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="1" + /> + Name="VCALinkTool" + /> + Name="VCManifestTool" + /> + Name="VCXDCMakeTool" + /> + Name="VCBscMakeTool" + /> + Name="VCFxCopTool" + /> + Name="VCAppVerifierTool" + /> + Name="VCWebDeploymentTool" + /> + Name="VCPostBuildEventTool" + Description="Copy unmanaged dll to root directory..." + CommandLine="echo on copy "$(OutDir)\example.dll" "$(SolutionDir)" @echo off " + /> + + + Name="VCPreBuildEventTool" + /> + Name="VCCustomBuildTool" + /> + + + + + + + + + + + + + + + + + InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC71.vsprops" + CharacterSet="2" + > + + + + + + Detect64BitPortabilityProblems="true" + DebugInformationFormat="3" + /> + + + Name="VCPreLinkEventTool" + /> + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="1" + /> + + + + + + + + + + + + + + + + + Name="VCManagedResourceCompilerTool" + /> + Name="VCResourceCompilerTool" + /> + + + Name="VCALinkTool" + /> + Name="VCManifestTool" + /> + Name="VCXDCMakeTool" + /> + Name="VCBscMakeTool" + /> + Name="VCFxCopTool" + /> + Name="VCAppVerifierTool" + /> + Name="VCWebDeploymentTool" + /> + Name="VCPostBuildEventTool" + Description="Copy unmanaged dll to root directory..." + CommandLine="echo on copy "$(OutDir)\example.dll" "$(SolutionDir)" @echo off " + /> @@ -113,43 +348,65 @@ + UniqueIdentifier="{4FC737F1-C7A5-4376-A066-2A32D752A2FF}" + > + RelativePath="example.cxx" + > + RelativePath="example_wrap.cxx" + > + UniqueIdentifier="{93995380-89BD-4b04-88EB-625FBE52EBFB}" + > + RelativePath="example.h" + > + RelativePath=".\example.i" + > + + + + + + + Name="Release|Win32" + > + CommandLine="echo Invoking SWIG... echo on ..\..\..\swig.exe -c++ -csharp "$(InputPath)" @echo off " + Outputs="$(InputName)_wrap.cxx" + /> + Name="Release|x64" + > + CommandLine="echo Invoking SWIG... echo on ..\..\..\swig.exe -c++ -csharp "$(InputPath)" @echo off " + Outputs="$(InputName)_wrap.cxx" + /> diff --git a/Examples/csharp/reference/example.cxx b/Examples/csharp/reference/example.cxx index 8a513bf..9dbaed2 100644 --- a/Examples/csharp/reference/example.cxx +++ b/Examples/csharp/reference/example.cxx @@ -19,7 +19,7 @@ Vector operator+(const Vector &a, const Vector &b) { char *Vector::print() { static char temp[512]; - sprintf(temp,"Vector %p (%g,%g,%g)", this, x,y,z); + sprintf(temp,"Vector %p (%g,%g,%g)", (void *)this, x,y,z); return temp; } diff --git a/Examples/csharp/reference/example.h b/Examples/csharp/reference/example.h index 4915adb..bcfcfb7 100644 --- a/Examples/csharp/reference/example.h +++ b/Examples/csharp/reference/example.h @@ -4,8 +4,8 @@ class Vector { private: double x,y,z; public: - Vector() : x(0), y(0), z(0) { }; - Vector(double x, double y, double z) : x(x), y(y), z(z) { }; + Vector() : x(0), y(0), z(0) { } + Vector(double x, double y, double z) : x(x), y(y), z(z) { } friend Vector operator+(const Vector &a, const Vector &b); char *print(); }; @@ -20,7 +20,3 @@ public: Vector &operator[](int); int size(); }; - - - - diff --git a/Examples/csharp/reference/example.i b/Examples/csharp/reference/example.i index 6daa3b1..173143d 100644 --- a/Examples/csharp/reference/example.i +++ b/Examples/csharp/reference/example.i @@ -29,7 +29,7 @@ public: VectorArray(int maxsize); ~VectorArray(); int size(); - + /* This wrapper provides an alternative to the [] operator */ %extend { Vector &get(int index) { @@ -40,7 +40,3 @@ public: } } }; - - - - diff --git a/Examples/csharp/reference/example.sln b/Examples/csharp/reference/example.sln index 88995ff..234bd64 100644 --- a/Examples/csharp/reference/example.sln +++ b/Examples/csharp/reference/example.sln @@ -1,30 +1,38 @@ -Microsoft Visual Studio Solution File, Format Version 8.00 +Microsoft Visual Studio Solution File, Format Version 9.00 +# Visual Studio 2005 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "example-cs", "example-cs.csproj", "{C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}" ProjectSection(ProjectDependencies) = postProject {C2302635-D489-4678-96B4-70F5309DCBE6} = {C2302635-D489-4678-96B4-70F5309DCBE6} EndProjectSection EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "example-vc", "example-vc.vcproj", "{C2302635-D489-4678-96B4-70F5309DCBE6}" - ProjectSection(ProjectDependencies) = postProject - EndProjectSection EndProject Global - GlobalSection(SolutionConfiguration) = preSolution - Debug = Debug - Release = Release - EndGlobalSection - GlobalSection(ProjectConfiguration) = postSolution - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug.ActiveCfg = Debug|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug.Build.0 = Debug|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release.ActiveCfg = Release|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release.Build.0 = Release|.NET - {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug.ActiveCfg = Debug|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug.Build.0 = Debug|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Release.ActiveCfg = Release|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Release.Build.0 = Release|Win32 + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Win32 = Debug|Win32 + Debug|x64 = Debug|x64 + Release|Win32 = Release|Win32 + Release|x64 = Release|x64 EndGlobalSection - GlobalSection(ExtensibilityGlobals) = postSolution + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.ActiveCfg = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.Build.0 = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.ActiveCfg = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.Build.0 = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.ActiveCfg = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.Build.0 = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.ActiveCfg = Release|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.Build.0 = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.ActiveCfg = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.Build.0 = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.ActiveCfg = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.Build.0 = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.ActiveCfg = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.Build.0 = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.ActiveCfg = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.Build.0 = Release|x64 EndGlobalSection - GlobalSection(ExtensibilityAddIns) = postSolution + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE EndGlobalSection EndGlobal diff --git a/Examples/csharp/simple/Makefile b/Examples/csharp/simple/Makefile index 875ae0e..9af1d66 100644 --- a/Examples/csharp/simple/Makefile +++ b/Examples/csharp/simple/Makefile @@ -1,19 +1,21 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i SWIGOPT = CSHARPSRCS = *.cs -CSHARPFLAGS= -nologo -out:runme.exe +CSHARPFLAGS= -nologo -debug+ -out:runme.exe check: build - $(MAKE) -f $(TOP)/Makefile csharp_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' csharp - $(MAKE) -f $(TOP)/Makefile CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile clean: - $(MAKE) -f $(TOP)/Makefile csharp_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_clean diff --git a/Examples/csharp/simple/example-cs.csproj b/Examples/csharp/simple/example-cs.csproj index 3d91f9a..6138dd0 100644 --- a/Examples/csharp/simple/example-cs.csproj +++ b/Examples/csharp/simple/example-cs.csproj @@ -1,89 +1,86 @@ - - - - - - - - - - - - - - - - - - - + + + Local + 8.0.50727 + 2.0 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A} + Debug + x86 + + + + + runme + + + JScript + Grid + IE50 + false + Exe + runme + OnBuildSuccess + + + + + + + + + true + bin\x86\Debug\ + DEBUG;TRACE + 285212672 + full + x86 + prompt + + + bin\x86\Release\ + TRACE + 285212672 + true + + + x86 + prompt + + + true + bin\x64\Debug\ + DEBUG;TRACE + 285212672 + full + x64 + prompt + + + bin\x64\Release\ + TRACE + 285212672 + true + + + x64 + prompt + + + + Code + + + Code + + + Code + + + + + + + copy runme.exe "$(SolutionDir)runme.exe" +echo Run the example from the root directory $(SolutionDir) and ensure example.dll is also in this directory + + diff --git a/Examples/csharp/simple/example-vc.vcproj b/Examples/csharp/simple/example-vc.vcproj index ec289c6..74b5046 100644 --- a/Examples/csharp/simple/example-vc.vcproj +++ b/Examples/csharp/simple/example-vc.vcproj @@ -10,14 +10,17 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -180,11 +351,11 @@ UniqueIdentifier="{4FC737F1-C7A5-4376-A066-2A32D752A2FF}" > @@ -207,6 +378,15 @@ /> + + + + + + diff --git a/Examples/csharp/simple/example.sln b/Examples/csharp/simple/example.sln index 3ebbba5..234bd64 100644 --- a/Examples/csharp/simple/example.sln +++ b/Examples/csharp/simple/example.sln @@ -1,5 +1,5 @@ Microsoft Visual Studio Solution File, Format Version 9.00 -# Visual C++ Express 2005 +# Visual Studio 2005 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "example-cs", "example-cs.csproj", "{C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}" ProjectSection(ProjectDependencies) = postProject {C2302635-D489-4678-96B4-70F5309DCBE6} = {C2302635-D489-4678-96B4-70F5309DCBE6} @@ -10,15 +10,27 @@ EndProject Global GlobalSection(SolutionConfigurationPlatforms) = preSolution Debug|Win32 = Debug|Win32 + Debug|x64 = Debug|x64 Release|Win32 = Release|Win32 + Release|x64 = Release|x64 EndGlobalSection GlobalSection(ProjectConfigurationPlatforms) = postSolution - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.ActiveCfg = Debug|Any CPU - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.ActiveCfg = Release|Any CPU + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.ActiveCfg = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.Build.0 = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.ActiveCfg = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.Build.0 = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.ActiveCfg = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.Build.0 = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.ActiveCfg = Release|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.Build.0 = Release|x64 {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.ActiveCfg = Debug|Win32 {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.Build.0 = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.ActiveCfg = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.Build.0 = Debug|x64 {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.ActiveCfg = Release|Win32 {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.Build.0 = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.ActiveCfg = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.Build.0 = Release|x64 EndGlobalSection GlobalSection(SolutionProperties) = preSolution HideSolutionNode = FALSE diff --git a/Examples/csharp/template/Makefile b/Examples/csharp/template/Makefile index 43243d6..010447f 100644 --- a/Examples/csharp/template/Makefile +++ b/Examples/csharp/template/Makefile @@ -1,19 +1,21 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = TARGET = example INTERFACE = example.i SWIGOPT = CSHARPSRCS = *.cs -CSHARPFLAGS= -nologo -out:runme.exe +CSHARPFLAGS= -nologo -debug+ -out:runme.exe check: build - $(MAKE) -f $(TOP)/Makefile csharp_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' csharp_cpp - $(MAKE) -f $(TOP)/Makefile CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile clean: - $(MAKE) -f $(TOP)/Makefile csharp_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_clean diff --git a/Examples/csharp/template/example-cs.csproj b/Examples/csharp/template/example-cs.csproj index bf17c14..782aeac 100644 --- a/Examples/csharp/template/example-cs.csproj +++ b/Examples/csharp/template/example-cs.csproj @@ -1,109 +1,90 @@ - - - - - - - - - - - - - - - - - - - - - - - + + + Local + 8.0.50727 + 2.0 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A} + Debug + x86 + + + + + runme + + + JScript + Grid + IE50 + false + Exe + runme + OnBuildSuccess + + + + + + + + + true + bin\x86\Debug\ + DEBUG;TRACE + 285212672 + full + x86 + prompt + + + bin\x86\Release\ + TRACE + 285212672 + true + + + x86 + prompt + + + true + bin\x64\Debug\ + DEBUG;TRACE + 285212672 + full + x64 + prompt + + + bin\x64\Release\ + TRACE + 285212672 + true + + + x64 + prompt + + + + Code + + + Code + + + Code + + + + + + + + + + + copy runme.exe "$(SolutionDir)runme.exe" +echo Run the example from the root directory $(SolutionDir) and ensure example.dll is also in this directory + + diff --git a/Examples/csharp/template/example-vc.vcproj b/Examples/csharp/template/example-vc.vcproj index f7bbbcb..f8a9000 100644 --- a/Examples/csharp/template/example-vc.vcproj +++ b/Examples/csharp/template/example-vc.vcproj @@ -1,110 +1,345 @@ + Keyword="Win32Proj" + > + Name="Win32" + /> + + + + InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC71.vsprops" + CharacterSet="2" + > + + + + + + Detect64BitPortabilityProblems="true" + DebugInformationFormat="4" + /> + Name="VCManagedResourceCompilerTool" + /> + + + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="1" + /> + Name="VCALinkTool" + /> + Name="VCManifestTool" + /> + Name="VCXDCMakeTool" + /> + Name="VCBscMakeTool" + /> + Name="VCFxCopTool" + /> + Name="VCAppVerifierTool" + /> + Name="VCWebDeploymentTool" + /> + Name="VCPostBuildEventTool" + Description="Copy unmanaged dll to root directory..." + CommandLine="echo on copy "$(OutDir)\example.dll" "$(SolutionDir)" @echo off " + /> + + + Name="VCPreBuildEventTool" + /> + Name="VCCustomBuildTool" + /> + + + + + + + + + + + + + + + + + InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC71.vsprops" + CharacterSet="2" + > + + + + + + Detect64BitPortabilityProblems="true" + DebugInformationFormat="3" + /> + + + Name="VCPreLinkEventTool" + /> + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="1" + /> + + + + + + + + + + + + + + + + + Name="VCManagedResourceCompilerTool" + /> + Name="VCResourceCompilerTool" + /> + + + Name="VCALinkTool" + /> + Name="VCManifestTool" + /> + Name="VCXDCMakeTool" + /> + Name="VCBscMakeTool" + /> + Name="VCFxCopTool" + /> + Name="VCAppVerifierTool" + /> + Name="VCWebDeploymentTool" + /> + Name="VCPostBuildEventTool" + Description="Copy unmanaged dll to root directory..." + CommandLine="echo on copy "$(OutDir)\example.dll" "$(SolutionDir)" @echo off " + /> @@ -113,42 +348,61 @@ + UniqueIdentifier="{4FC737F1-C7A5-4376-A066-2A32D752A2FF}" + > + RelativePath="example_wrap.cxx" + > + UniqueIdentifier="{93995380-89BD-4b04-88EB-625FBE52EBFB}" + > + RelativePath="example.h" + > + RelativePath=".\example.i" + > + + + + + + + Name="Release|Win32" + > + CommandLine="echo Invoking SWIG... echo on ..\..\..\swig.exe -c++ -csharp "$(InputPath)" @echo off " + Outputs="$(InputName)_wrap.cxx" + /> + Name="Release|x64" + > + CommandLine="echo Invoking SWIG... echo on ..\..\..\swig.exe -c++ -csharp "$(InputPath)" @echo off " + Outputs="$(InputName)_wrap.cxx" + /> diff --git a/Examples/csharp/template/example.sln b/Examples/csharp/template/example.sln index 88995ff..234bd64 100644 --- a/Examples/csharp/template/example.sln +++ b/Examples/csharp/template/example.sln @@ -1,30 +1,38 @@ -Microsoft Visual Studio Solution File, Format Version 8.00 +Microsoft Visual Studio Solution File, Format Version 9.00 +# Visual Studio 2005 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "example-cs", "example-cs.csproj", "{C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}" ProjectSection(ProjectDependencies) = postProject {C2302635-D489-4678-96B4-70F5309DCBE6} = {C2302635-D489-4678-96B4-70F5309DCBE6} EndProjectSection EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "example-vc", "example-vc.vcproj", "{C2302635-D489-4678-96B4-70F5309DCBE6}" - ProjectSection(ProjectDependencies) = postProject - EndProjectSection EndProject Global - GlobalSection(SolutionConfiguration) = preSolution - Debug = Debug - Release = Release - EndGlobalSection - GlobalSection(ProjectConfiguration) = postSolution - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug.ActiveCfg = Debug|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug.Build.0 = Debug|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release.ActiveCfg = Release|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release.Build.0 = Release|.NET - {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug.ActiveCfg = Debug|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug.Build.0 = Debug|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Release.ActiveCfg = Release|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Release.Build.0 = Release|Win32 + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Win32 = Debug|Win32 + Debug|x64 = Debug|x64 + Release|Win32 = Release|Win32 + Release|x64 = Release|x64 EndGlobalSection - GlobalSection(ExtensibilityGlobals) = postSolution + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.ActiveCfg = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.Build.0 = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.ActiveCfg = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.Build.0 = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.ActiveCfg = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.Build.0 = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.ActiveCfg = Release|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.Build.0 = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.ActiveCfg = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.Build.0 = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.ActiveCfg = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.Build.0 = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.ActiveCfg = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.Build.0 = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.ActiveCfg = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.Build.0 = Release|x64 EndGlobalSection - GlobalSection(ExtensibilityAddIns) = postSolution + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE EndGlobalSection EndGlobal diff --git a/Examples/csharp/variables/Makefile b/Examples/csharp/variables/Makefile index 875ae0e..9af1d66 100644 --- a/Examples/csharp/variables/Makefile +++ b/Examples/csharp/variables/Makefile @@ -1,19 +1,21 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i SWIGOPT = CSHARPSRCS = *.cs -CSHARPFLAGS= -nologo -out:runme.exe +CSHARPFLAGS= -nologo -debug+ -out:runme.exe check: build - $(MAKE) -f $(TOP)/Makefile csharp_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' csharp - $(MAKE) -f $(TOP)/Makefile CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CSHARPSRCS='$(CSHARPSRCS)' CSHARPFLAGS='$(CSHARPFLAGS)' csharp_compile clean: - $(MAKE) -f $(TOP)/Makefile csharp_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' csharp_clean diff --git a/Examples/csharp/variables/example-cs.csproj b/Examples/csharp/variables/example-cs.csproj index a73c879..d2ce17a 100644 --- a/Examples/csharp/variables/example-cs.csproj +++ b/Examples/csharp/variables/example-cs.csproj @@ -1,99 +1,88 @@ - - - - - - - - - - - - - - - - - - - - - + + + Local + 8.0.50727 + 2.0 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A} + Debug + x86 + + + + + runme + + + JScript + Grid + IE50 + false + Exe + runme + OnBuildSuccess + + + + + + + + + true + bin\x86\Debug\ + DEBUG;TRACE + 285212672 + full + x86 + prompt + + + bin\x86\Release\ + TRACE + 285212672 + true + + + x86 + prompt + + + true + bin\x64\Debug\ + DEBUG;TRACE + 285212672 + full + x64 + prompt + + + bin\x64\Release\ + TRACE + 285212672 + true + + + x64 + prompt + + + + Code + + + Code + + + Code + + + + + + + + + copy runme.exe "$(SolutionDir)runme.exe" +echo Run the example from the root directory $(SolutionDir) and ensure example.dll is also in this directory + + diff --git a/Examples/csharp/variables/example-vc.vcproj b/Examples/csharp/variables/example-vc.vcproj index acd55a3..d3ee58e 100644 --- a/Examples/csharp/variables/example-vc.vcproj +++ b/Examples/csharp/variables/example-vc.vcproj @@ -1,110 +1,345 @@ + Keyword="Win32Proj" + > + Name="Win32" + /> + + + + InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC71.vsprops" + CharacterSet="2" + > + + + + + + Detect64BitPortabilityProblems="true" + DebugInformationFormat="4" + /> + Name="VCManagedResourceCompilerTool" + /> + + + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="1" + /> + + + + + + + + + + + + + Name="VCXMLDataGeneratorTool" + /> + Name="VCWebServiceProxyGeneratorTool" + /> + Name="VCMIDLTool" + TargetEnvironment="3" + /> + Name="VCCLCompilerTool" + Optimization="0" + PreprocessorDefinitions="WIN32;_DEBUG;_WINDOWS;_USRDLL;EXAMPLEVC_EXPORTS" + MinimalRebuild="true" + BasicRuntimeChecks="3" + RuntimeLibrary="1" + UsePrecompiledHeader="0" + WarningLevel="3" + Detect64BitPortabilityProblems="true" + DebugInformationFormat="3" + /> + + Name="VCResourceCompilerTool" + /> + Name="VCPreLinkEventTool" + /> + Name="VCLinkerTool" + OutputFile="$(OutDir)\example.dll" + LinkIncremental="2" + GenerateDebugInformation="true" + ProgramDatabaseFile="$(OutDir)\example.pdb" + SubSystem="2" + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="17" + /> + Name="VCALinkTool" + /> + Name="VCManifestTool" + /> + Name="VCXDCMakeTool" + /> + + + + + + InheritedPropertySheets="$(VCInstallDir)VCProjectDefaults\UpgradeFromVC71.vsprops" + CharacterSet="2" + > + + + + + + Detect64BitPortabilityProblems="true" + DebugInformationFormat="3" + /> + Name="VCManagedResourceCompilerTool" + /> + + + ImportLibrary="$(OutDir)\example.lib" + TargetMachine="1" + /> + + Name="VCManifestTool" + /> + Name="VCXDCMakeTool" + /> + Name="VCBscMakeTool" + /> + Name="VCFxCopTool" + /> + Name="VCAppVerifierTool" + /> + Name="VCWebDeploymentTool" + /> + Name="VCPostBuildEventTool" + Description="Copy unmanaged dll to root directory..." + CommandLine="echo on copy "$(OutDir)\example.dll" "$(SolutionDir)" @echo off " + /> + + + Name="VCPreBuildEventTool" + /> + Name="VCCustomBuildTool" + /> + Name="VCXMLDataGeneratorTool" + /> + + + + + + + + + + + + + + + @@ -113,42 +348,65 @@ + UniqueIdentifier="{4FC737F1-C7A5-4376-A066-2A32D752A2FF}" + > + RelativePath="example.c" + > + RelativePath="example_wrap.c" + > + UniqueIdentifier="{93995380-89BD-4b04-88EB-625FBE52EBFB}" + > + + + RelativePath=".\example.i" + > + + + + + + + Name="Release|Win32" + > + CommandLine="echo Invoking SWIG... echo on ..\..\..\swig.exe -csharp "$(InputPath)" @echo off " + Outputs="$(InputName)_wrap.c" + /> + Name="Release|x64" + > + CommandLine="echo Invoking SWIG... echo on ..\..\..\swig.exe -csharp "$(InputPath)" @echo off " + Outputs="$(InputName)_wrap.c" + /> diff --git a/Examples/csharp/variables/example.c b/Examples/csharp/variables/example.c index aa4ffe9..85685fe 100644 --- a/Examples/csharp/variables/example.c +++ b/Examples/csharp/variables/example.c @@ -51,10 +51,10 @@ void print_vars() { printf("dvar = %g\n", dvar); printf("cvar = %c\n", cvar); printf("strvar = %s\n", strvar ? strvar : "(null)"); - printf("cstrvar = %s\n", cstrvar ? cstrvar : "(null)"); - printf("iptrvar = %p\n", iptrvar); + printf("cstrvar = %s\n", cstrvar); + printf("iptrvar = %p\n", (void *)iptrvar); printf("name = %s\n", name); - printf("ptptr = %p (%d, %d)\n", ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0); + printf("ptptr = %p (%d, %d)\n", (void *)ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0); printf("pt = (%d, %d)\n", pt.x, pt.y); printf("status = %d\n", status); } diff --git a/Examples/csharp/variables/example.sln b/Examples/csharp/variables/example.sln index 88995ff..234bd64 100644 --- a/Examples/csharp/variables/example.sln +++ b/Examples/csharp/variables/example.sln @@ -1,30 +1,38 @@ -Microsoft Visual Studio Solution File, Format Version 8.00 +Microsoft Visual Studio Solution File, Format Version 9.00 +# Visual Studio 2005 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "example-cs", "example-cs.csproj", "{C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}" ProjectSection(ProjectDependencies) = postProject {C2302635-D489-4678-96B4-70F5309DCBE6} = {C2302635-D489-4678-96B4-70F5309DCBE6} EndProjectSection EndProject Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "example-vc", "example-vc.vcproj", "{C2302635-D489-4678-96B4-70F5309DCBE6}" - ProjectSection(ProjectDependencies) = postProject - EndProjectSection EndProject Global - GlobalSection(SolutionConfiguration) = preSolution - Debug = Debug - Release = Release - EndGlobalSection - GlobalSection(ProjectConfiguration) = postSolution - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug.ActiveCfg = Debug|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug.Build.0 = Debug|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release.ActiveCfg = Release|.NET - {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release.Build.0 = Release|.NET - {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug.ActiveCfg = Debug|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug.Build.0 = Debug|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Release.ActiveCfg = Release|Win32 - {C2302635-D489-4678-96B4-70F5309DCBE6}.Release.Build.0 = Release|Win32 + GlobalSection(SolutionConfigurationPlatforms) = preSolution + Debug|Win32 = Debug|Win32 + Debug|x64 = Debug|x64 + Release|Win32 = Release|Win32 + Release|x64 = Release|x64 EndGlobalSection - GlobalSection(ExtensibilityGlobals) = postSolution + GlobalSection(ProjectConfigurationPlatforms) = postSolution + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.ActiveCfg = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|Win32.Build.0 = Debug|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.ActiveCfg = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Debug|x64.Build.0 = Debug|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.ActiveCfg = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|Win32.Build.0 = Release|x86 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.ActiveCfg = Release|x64 + {C17D27DF-4C57-4625-AEE0-A40C4F48FF1A}.Release|x64.Build.0 = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.ActiveCfg = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|Win32.Build.0 = Debug|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.ActiveCfg = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Debug|x64.Build.0 = Debug|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.ActiveCfg = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|Win32.Build.0 = Release|Win32 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.ActiveCfg = Release|x64 + {C2302635-D489-4678-96B4-70F5309DCBE6}.Release|x64.Build.0 = Release|x64 EndGlobalSection - GlobalSection(ExtensibilityAddIns) = postSolution + GlobalSection(SolutionProperties) = preSolution + HideSolutionNode = FALSE EndGlobalSection EndGlobal diff --git a/Examples/d/callback/Makefile b/Examples/d/callback/Makefile index eda18f1..ad84231 100644 --- a/Examples/d/callback/Makefile +++ b/Examples/d/callback/Makefile @@ -1,27 +1 @@ -ifeq (2,$(D_VERSION)) - WORKING_DIR = d2/ -else - WORKING_DIR = d1/ -endif - -TOP = ../../.. -SWIG = $(TOP)/../preinst-swig -EXTRA_CFLAGS = -I../ ../example.cxx example_wrap.cxx -EXTRA_LDFLAGS = example.o example_wrap.o -TARGET = example_wrap -SWIGOPT = -DSRCS = *.d -DFLAGS = -ofrunme - -check: build - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile d_run - -build: - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile EXTRA_CFLAGS='$(EXTRA_CFLAGS)' EXTRA_LDFLAGS='$(EXTRA_LDFLAGS)' SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT) -outcurrentdir ../example.i' TARGET='$(TARGET)' d_cpp; \ - $(MAKE) -f $(TOP)/Makefile DSRCS='$(DSRCS)' DFLAGS='$(DFLAGS)' d_compile - -clean: - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile d_clean +include ../example.mk diff --git a/Examples/d/callback/example.i b/Examples/d/callback/example.i index 90beda0..cf61ef9 100644 --- a/Examples/d/callback/example.i +++ b/Examples/d/callback/example.i @@ -4,8 +4,6 @@ #include "example.h" %} -%include "std_string.i" - /* turn on director wrapping Callback */ %feature("director") Callback; diff --git a/Examples/d/class/Makefile b/Examples/d/class/Makefile index eda18f1..ad84231 100644 --- a/Examples/d/class/Makefile +++ b/Examples/d/class/Makefile @@ -1,27 +1 @@ -ifeq (2,$(D_VERSION)) - WORKING_DIR = d2/ -else - WORKING_DIR = d1/ -endif - -TOP = ../../.. -SWIG = $(TOP)/../preinst-swig -EXTRA_CFLAGS = -I../ ../example.cxx example_wrap.cxx -EXTRA_LDFLAGS = example.o example_wrap.o -TARGET = example_wrap -SWIGOPT = -DSRCS = *.d -DFLAGS = -ofrunme - -check: build - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile d_run - -build: - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile EXTRA_CFLAGS='$(EXTRA_CFLAGS)' EXTRA_LDFLAGS='$(EXTRA_LDFLAGS)' SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT) -outcurrentdir ../example.i' TARGET='$(TARGET)' d_cpp; \ - $(MAKE) -f $(TOP)/Makefile DSRCS='$(DSRCS)' DFLAGS='$(DFLAGS)' d_compile - -clean: - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile d_clean +include ../example.mk diff --git a/Examples/d/class/example.cxx b/Examples/d/class/example.cxx index 1e8e203..0463045 100644 --- a/Examples/d/class/example.cxx +++ b/Examples/d/class/example.cxx @@ -1,4 +1,4 @@ -/* File : example.c */ +/* File : example.cxx */ #include "example.h" #define M_PI 3.14159265358979323846 @@ -11,18 +11,18 @@ void Shape::move(double dx, double dy) { int Shape::nshapes = 0; -double Circle::area(void) { +double Circle::area() { return M_PI*radius*radius; } -double Circle::perimeter(void) { +double Circle::perimeter() { return 2*M_PI*radius; } -double Square::area(void) { +double Square::area() { return width*width; } -double Square::perimeter(void) { +double Square::perimeter() { return 4*width; } diff --git a/Examples/d/class/example.h b/Examples/d/class/example.h index 0d4527e..0dff185 100644 --- a/Examples/d/class/example.h +++ b/Examples/d/class/example.h @@ -7,11 +7,11 @@ public: } virtual ~Shape() { nshapes--; - }; + } double x, y; void move(double dx, double dy); - virtual double area(void) = 0; - virtual double perimeter(void) = 0; + virtual double area() = 0; + virtual double perimeter() = 0; static int nshapes; }; @@ -19,16 +19,16 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; - virtual double area(void); - virtual double perimeter(void); + Circle(double r) : radius(r) { } + virtual double area(); + virtual double perimeter(); }; class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; - virtual double area(void); - virtual double perimeter(void); + Square(double w) : width(w) { } + virtual double area(); + virtual double perimeter(); }; diff --git a/Examples/d/class/example.i b/Examples/d/class/example.i index 75700b3..fbdf724 100644 --- a/Examples/d/class/example.i +++ b/Examples/d/class/example.i @@ -7,4 +7,3 @@ /* Let's just grab the original header file here */ %include "example.h" - diff --git a/Examples/d/constants/Makefile b/Examples/d/constants/Makefile index d537ce2..ad84231 100644 --- a/Examples/d/constants/Makefile +++ b/Examples/d/constants/Makefile @@ -1,27 +1 @@ -ifeq (2,$(D_VERSION)) - WORKING_DIR = d2/ -else - WORKING_DIR = d1/ -endif - -TOP = ../../.. -SWIG = $(TOP)/../preinst-swig -EXTRA_CFLAGS = -I../ example_wrap.c -EXTRA_LDFLAGS = example_wrap.o -TARGET = example_wrap -SWIGOPT = -DSRCS = *.d -DFLAGS = -ofrunme - -check: build - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile d_run - -build: - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile EXTRA_CFLAGS='$(EXTRA_CFLAGS)' EXTRA_LDFLAGS='$(EXTRA_LDFLAGS)' SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT) -outcurrentdir ../example.i' TARGET='$(TARGET)' d; \ - $(MAKE) -f $(TOP)/Makefile DSRCS='$(DSRCS)' DFLAGS='$(DFLAGS)' d_compile - -clean: - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile d_clean +include ../example.mk diff --git a/Examples/d/constants/example.d b/Examples/d/constants/example.d deleted file mode 100644 index 7448d0a..0000000 --- a/Examples/d/constants/example.d +++ /dev/null @@ -1,23 +0,0 @@ -/* ---------------------------------------------------------------------------- - * This file was automatically generated by SWIG (http://www.swig.org). - * Version 1.3.41 - * - * Do not make changes to this file unless you know what you are doing--modify - * the SWIG interface file instead. - * ----------------------------------------------------------------------------- */ - -module example; - -static import example_wrap; - -static import tango.stdc.stringz; - -public const int ICONST = 42; -public const double FCONST = 2.1828; -public const char CCONST = 'x'; -public const char CCONST2 = '\n'; -public const char[] SCONST = "Hello World"; -public const char[] SCONST2 = "\"Hello World\""; -public const double EXPR = 42+3*(2.1828); -public const int iconst = 37; -public const double fconst = 3.14; diff --git a/Examples/d/enum/Makefile b/Examples/d/enum/Makefile index eda18f1..ad84231 100644 --- a/Examples/d/enum/Makefile +++ b/Examples/d/enum/Makefile @@ -1,27 +1 @@ -ifeq (2,$(D_VERSION)) - WORKING_DIR = d2/ -else - WORKING_DIR = d1/ -endif - -TOP = ../../.. -SWIG = $(TOP)/../preinst-swig -EXTRA_CFLAGS = -I../ ../example.cxx example_wrap.cxx -EXTRA_LDFLAGS = example.o example_wrap.o -TARGET = example_wrap -SWIGOPT = -DSRCS = *.d -DFLAGS = -ofrunme - -check: build - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile d_run - -build: - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile EXTRA_CFLAGS='$(EXTRA_CFLAGS)' EXTRA_LDFLAGS='$(EXTRA_LDFLAGS)' SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT) -outcurrentdir ../example.i' TARGET='$(TARGET)' d_cpp; \ - $(MAKE) -f $(TOP)/Makefile DSRCS='$(DSRCS)' DFLAGS='$(DFLAGS)' d_compile - -clean: - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile d_clean +include ../example.mk diff --git a/Examples/d/example.mk.in b/Examples/d/example.mk.in new file mode 100644 index 0000000..84b3ceb --- /dev/null +++ b/Examples/d/example.mk.in @@ -0,0 +1,66 @@ +# +# Common Makefile code for building D examples. +# +# We actually need to configure this to gain access to the default D version to +# use when D_VERSION is not set. Using Examples/Makefile.in is not enough, as +# the location of the source files (d1/ or d2/) depends on it. The alternative +# would be to add the functionality specific to Examples/d (as opposed to the +# test suite) directly to Examples/Makefile.in. +# +# This file is supposed to be included from a Makefile in the subdirectory +# corresponding to a specific example. +# + +ifeq (,$(D_VERSION)) + D_VERSION = @DDEFAULTVERSION@ +endif + +ifeq (1,$(D_VERSION)) + VERSION_DIR = d1/ +else + VERSION_DIR = d2/ +endif + +EXAMPLES_TOP = ../../.. +SWIG_TOP = ../../../.. +SWIGEXE = $(SWIG_TOP)/swig +SWIG_LIB_DIR = $(SWIG_TOP)/$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +EXTRA_CFLAGS = +EXTRA_CXXFLAGS = +EXTRA_LDFLAGS = +TARGET = example_wrap +SWIGOPT = -outcurrentdir +DFLAGS = -ofrunme + +ifeq (,$(SRCDIR)) +DSRCS = *.d +else +DSRCS = *.d $(addprefix ../$(SRCDIR)$(VERSION_DIR),runme.d) +endif + + +check: build + $(MAKE) -C $(VERSION_DIR) -f $(EXAMPLES_TOP)/Makefile SRCDIR='../$(SRCDIR)' d_run + +build: + mkdir -p $(VERSION_DIR) + if [ -f $(SRCDIR)example.cxx ]; then \ + $(MAKE) -C $(VERSION_DIR) -f $(EXAMPLES_TOP)/Makefile SRCDIR='../$(SRCDIR)' EXTRA_CXXFLAGS='$(EXTRA_CXXFLAGS)' EXTRA_LDFLAGS='$(EXTRA_LDFLAGS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='example.i' CXXSRCS='example.cxx' d_cpp; \ + elif [ -f $(SRCDIR)example.c ]; then \ + $(MAKE) -C $(VERSION_DIR) -f $(EXAMPLES_TOP)/Makefile SRCDIR='../$(SRCDIR)' EXTRA_CFLAGS='$(EXTRA_CFLAGS)' EXTRA_LDFLAGS='$(EXTRA_LDFLAGS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='example.i' SRCS='example.c' d; \ + else \ + $(MAKE) -C $(VERSION_DIR) -f $(EXAMPLES_TOP)/Makefile SRCDIR='../$(SRCDIR)' EXTRA_CFLAGS='$(EXTRA_CFLAGS)' EXTRA_LDFLAGS='$(EXTRA_LDFLAGS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='example.i' SRCS='' d; \ + fi + $(MAKE) -C $(VERSION_DIR) -f $(EXAMPLES_TOP)/Makefile SRCDIR='../$(SRCDIR)' DSRCS='$(DSRCS)' DFLAGS='$(DFLAGS)' d_compile + +clean: + if [ -d $(VERSION_DIR) ]; then \ + $(MAKE) -C $(VERSION_DIR) -f $(EXAMPLES_TOP)/Makefile SRCDIR='../$(SRCDIR)' d_clean; \ + fi + test -f $(VERSION_DIR)runme.d || rm -rf $(VERSION_DIR) # Only delete dir if out of source diff --git a/Examples/d/extend/Makefile b/Examples/d/extend/Makefile index eda18f1..ad84231 100644 --- a/Examples/d/extend/Makefile +++ b/Examples/d/extend/Makefile @@ -1,27 +1 @@ -ifeq (2,$(D_VERSION)) - WORKING_DIR = d2/ -else - WORKING_DIR = d1/ -endif - -TOP = ../../.. -SWIG = $(TOP)/../preinst-swig -EXTRA_CFLAGS = -I../ ../example.cxx example_wrap.cxx -EXTRA_LDFLAGS = example.o example_wrap.o -TARGET = example_wrap -SWIGOPT = -DSRCS = *.d -DFLAGS = -ofrunme - -check: build - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile d_run - -build: - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile EXTRA_CFLAGS='$(EXTRA_CFLAGS)' EXTRA_LDFLAGS='$(EXTRA_LDFLAGS)' SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT) -outcurrentdir ../example.i' TARGET='$(TARGET)' d_cpp; \ - $(MAKE) -f $(TOP)/Makefile DSRCS='$(DSRCS)' DFLAGS='$(DFLAGS)' d_compile - -clean: - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile d_clean +include ../example.mk diff --git a/Examples/d/extend/d1/runme.d b/Examples/d/extend/d1/runme.d index 96501d1..0584320 100644 --- a/Examples/d/extend/d1/runme.d +++ b/Examples/d/extend/d1/runme.d @@ -46,7 +46,7 @@ void main() { // methods of all these instances are treated the same. For items 0, 1, and // 2, all methods resolve in C++. For item 3, our CEO, getTitle calls // getPosition which resolves in D. The call to getPosition is - // slightly different, however, because of the overidden getPosition() call, since + // slightly different, however, because of the overridden getPosition() call, since // now the object reference has been "laundered" by passing through // EmployeeList as an Employee*. Previously, D resolved the call // immediately in CEO, but now D thinks the object is an instance of diff --git a/Examples/d/extend/d2/runme.d b/Examples/d/extend/d2/runme.d index 1ea6dfd..cccdf46 100644 --- a/Examples/d/extend/d2/runme.d +++ b/Examples/d/extend/d2/runme.d @@ -46,7 +46,7 @@ void main() { // methods of all these instances are treated the same. For items 0, 1, and // 2, all methods resolve in C++. For item 3, our CEO, getTitle calls // getPosition which resolves in D. The call to getPosition is - // slightly different, however, because of the overidden getPosition() call, since + // slightly different, however, because of the overridden getPosition() call, since // now the object reference has been "laundered" by passing through // EmployeeList as an Employee*. Previously, D resolved the call // immediately in CEO, but now D thinks the object is an instance of diff --git a/Examples/d/extend/example.h b/Examples/d/extend/example.h index 7ad93fb..7a8c04c 100644 --- a/Examples/d/extend/example.h +++ b/Examples/d/extend/example.h @@ -14,7 +14,7 @@ public: virtual std::string getTitle() { return getPosition() + " " + getName(); } virtual std::string getName() { return name; } virtual std::string getPosition() const { return "Employee"; } - virtual ~Employee() { printf("~Employee() @ %p\n", this); } + virtual ~Employee() { printf("~Employee() @ %p\n", (void *)this); } }; diff --git a/Examples/d/funcptr/Makefile b/Examples/d/funcptr/Makefile index 2ba893c..ad84231 100644 --- a/Examples/d/funcptr/Makefile +++ b/Examples/d/funcptr/Makefile @@ -1,27 +1 @@ -ifeq (2,$(D_VERSION)) - WORKING_DIR = d2/ -else - WORKING_DIR = d1/ -endif - -TOP = ../../.. -SWIG = $(TOP)/../preinst-swig -EXTRA_CFLAGS = -I../ ../example.c example_wrap.c -EXTRA_LDFLAGS = example.o example_wrap.o -TARGET = example_wrap -SWIGOPT = -DSRCS = *.d -DFLAGS = -ofrunme - -check: build - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile d_run - -build: - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile EXTRA_CFLAGS='$(EXTRA_CFLAGS)' EXTRA_LDFLAGS='$(EXTRA_LDFLAGS)' EXTRA_LDFLAGS='$(EXTRA_LDFLAGS)' SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT) -outcurrentdir ../example.i' TARGET='$(TARGET)' d; \ - $(MAKE) -f $(TOP)/Makefile DSRCS='$(DSRCS)' DFLAGS='$(DFLAGS)' d_compile - -clean: - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile d_clean +include ../example.mk diff --git a/Examples/d/simple/Makefile b/Examples/d/simple/Makefile index a8808c9..ad84231 100644 --- a/Examples/d/simple/Makefile +++ b/Examples/d/simple/Makefile @@ -1,27 +1 @@ -ifeq (2,$(D_VERSION)) - WORKING_DIR = d2/ -else - WORKING_DIR = d1/ -endif - -TOP = ../../.. -SWIG = $(TOP)/../preinst-swig -EXTRA_CFLAGS = -I../ ../example.c example_wrap.c -EXTRA_LDFLAGS = example.o example_wrap.o -TARGET = example_wrap -SWIGOPT = -DSRCS = *.d -DFLAGS = -ofrunme - -check: build - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile d_run - -build: - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile EXTRA_CFLAGS='$(EXTRA_CFLAGS)' EXTRA_LDFLAGS='$(EXTRA_LDFLAGS)' SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT) -outcurrentdir ../example.i' TARGET='$(TARGET)' d; \ - $(MAKE) -f $(TOP)/Makefile DSRCS='$(DSRCS)' DFLAGS='$(DFLAGS)' d_compile - -clean: - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile d_clean +include ../example.mk diff --git a/Examples/d/variables/Makefile b/Examples/d/variables/Makefile index a8808c9..ad84231 100644 --- a/Examples/d/variables/Makefile +++ b/Examples/d/variables/Makefile @@ -1,27 +1 @@ -ifeq (2,$(D_VERSION)) - WORKING_DIR = d2/ -else - WORKING_DIR = d1/ -endif - -TOP = ../../.. -SWIG = $(TOP)/../preinst-swig -EXTRA_CFLAGS = -I../ ../example.c example_wrap.c -EXTRA_LDFLAGS = example.o example_wrap.o -TARGET = example_wrap -SWIGOPT = -DSRCS = *.d -DFLAGS = -ofrunme - -check: build - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile d_run - -build: - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile EXTRA_CFLAGS='$(EXTRA_CFLAGS)' EXTRA_LDFLAGS='$(EXTRA_LDFLAGS)' SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT) -outcurrentdir ../example.i' TARGET='$(TARGET)' d; \ - $(MAKE) -f $(TOP)/Makefile DSRCS='$(DSRCS)' DFLAGS='$(DFLAGS)' d_compile - -clean: - cd $(WORKING_DIR); \ - $(MAKE) -f $(TOP)/Makefile d_clean +include ../example.mk diff --git a/Examples/d/variables/example.c b/Examples/d/variables/example.c index 1bf9c12..f5356c7 100644 --- a/Examples/d/variables/example.c +++ b/Examples/d/variables/example.c @@ -51,10 +51,10 @@ void print_vars() { printf("dvar = %g\n", dvar); printf("cvar = %c\n", cvar); printf("strvar = %s\n", strvar ? strvar : "(null)"); - printf("cstrvar = %s\n", cstrvar ? cstrvar : "(null)"); - printf("iptrvar = %p\n", iptrvar); + printf("cstrvar = %s\n", cstrvar); + printf("iptrvar = %p\n", (void *)iptrvar); printf("name = %s\n", name); - printf("ptptr = %p (%d, %d)\n", ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0); + printf("ptptr = %p (%d, %d)\n", (void *)ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0); printf("pt = (%d, %d)\n", pt.x, pt.y); printf("status = %d\n", status); } diff --git a/Examples/go/callback/Makefile b/Examples/go/callback/Makefile index 7489f87..8604736 100644 --- a/Examples/go/callback/Makefile +++ b/Examples/go/callback/Makefile @@ -1,16 +1,26 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = example.cxx +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = callback.cxx +GOSRCS = gocallback.go TARGET = example INTERFACE = example.i SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + if [ -n '$(SRCDIR)' ]; then \ + cp $(GOSRCS:%=$(SRCDIR)/%) .; \ + fi + @# Note: example.go gets generated by SWIG + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' GOSRCS='example.go $(GOSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_cpp clean: - $(MAKE) -f $(TOP)/Makefile INTERFACE='$(INTERFACE)' go_clean + if [ -n '$(SRCDIR)' ]; then \ + rm -f $(GOSRCS); \ + fi + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INTERFACE='$(INTERFACE)' go_clean diff --git a/Examples/go/extend/example.cxx b/Examples/go/callback/callback.cxx similarity index 100% rename from Examples/go/extend/example.cxx rename to Examples/go/callback/callback.cxx diff --git a/Examples/go/callback/example.h b/Examples/go/callback/example.h index 1a0e8c4..74ddad9 100644 --- a/Examples/go/callback/example.h +++ b/Examples/go/callback/example.h @@ -20,4 +20,3 @@ public: void setCallback(Callback *cb) { delCallback(); _callback = cb; } void call() { if (_callback) _callback->run(); } }; - diff --git a/Examples/go/callback/example.i b/Examples/go/callback/example.i index 90beda0..cf61ef9 100644 --- a/Examples/go/callback/example.i +++ b/Examples/go/callback/example.i @@ -4,8 +4,6 @@ #include "example.h" %} -%include "std_string.i" - /* turn on director wrapping Callback */ %feature("director") Callback; diff --git a/Examples/go/callback/gocallback.go b/Examples/go/callback/gocallback.go new file mode 100644 index 0000000..20fd062 --- /dev/null +++ b/Examples/go/callback/gocallback.go @@ -0,0 +1,41 @@ +package example + +import ( + "fmt" +) + +type GoCallback interface { + Callback + deleteCallback() + IsGoCallback() +} + +type goCallback struct { + Callback +} + +func (p *goCallback) deleteCallback() { + DeleteDirectorCallback(p.Callback) +} + +func (p *goCallback) IsGoCallback() {} + +type overwrittenMethodsOnCallback struct { + p Callback +} + +func NewGoCallback() GoCallback { + om := &overwrittenMethodsOnCallback{} + p := NewDirectorCallback(om) + om.p = p + + return &goCallback{Callback: p} +} + +func DeleteGoCallback(p GoCallback) { + p.deleteCallback() +} + +func (p *goCallback) Run() { + fmt.Println("GoCallback.Run") +} diff --git a/Examples/go/callback/index.html b/Examples/go/callback/index.html index b053cf5..9a53065 100644 --- a/Examples/go/callback/index.html +++ b/Examples/go/callback/index.html @@ -12,67 +12,17 @@

      Implementing C++ callbacks in Go

      -This example illustrates how to use directors to implement C++ -callbacks in Go. -

      - -

      -Because Go and C++ use inheritance differently, you must call a -different function to create a class which uses callbacks. Instead of -calling the usual constructor function whose name is New -followed by the capitalized name of the class, you call a function -named NewDirector followed by the capitalized name of the -class. -

      - -

      -The first argument to the NewDirector function is an instance -of a type. The NewDirector function will return an interface -value as usual. However, when calling any method on the returned -value, the program will first check whether the value passed -to NewDirector implements that method. If it does, the -method will be called in Go. This is true whether the method is -called from Go code or C++ code. -

      - -

      -Note that the Go code will be called with just the Go value, not the -C++ value. If the Go code needs to call a C++ method on itself, you -need to get a copy of the C++ object. This is typically done as -follows: - -

      -
      -type Child struct { abi Parent }
      -func (p *Child) ChildMethod() {
      -	p.abi.ParentMethod()
      -}
      -func f() {
      -	p := &Child{nil}
      -	d := NewDirectorParent(p)
      -	p.abi = d
      -	...
      -}
      -
      -
      - -In other words, we first create the Go value. We pass that to -the NewDirector function to create the C++ value; this C++ -value will be created with an association to the Go value. We then -store the C++ value in the Go value, giving us the reverse -association. That permits us to call parent methods from the child. - -

      - -

      -To delete a director object, use the function DeleteDirector -followed by the capitalized name of the class. +This example illustrates how to use directors to implement C++ callbacks in Go. +See the Go Director +Classes documentation subsection for an in-depth explanation how to use the +director feature.

      diff --git a/Examples/go/callback/runme.go b/Examples/go/callback/runme.go index 2eef77f..03ab0c5 100644 --- a/Examples/go/callback/runme.go +++ b/Examples/go/callback/runme.go @@ -16,26 +16,18 @@ func main() { caller.Call() caller.DelCallback() - callback = NewDirectorCallback(new(GoCallback)) + go_callback := NewGoCallback() fmt.Println() fmt.Println("Adding and calling a Go callback") - fmt.Println("------------------------------------") + fmt.Println("--------------------------------") - caller.SetCallback(callback) + caller.SetCallback(go_callback) caller.Call() caller.DelCallback() - // Test that a double delete does not occur as the object has - // already been deleted from the C++ layer. - DeleteDirectorCallback(callback) + DeleteGoCallback(go_callback) fmt.Println() fmt.Println("Go exit") } - -type GoCallback struct{} - -func (p *GoCallback) Run() { - fmt.Println("GoCallback.Run") -} diff --git a/Examples/go/check.list b/Examples/go/check.list index 5399b89..b3f34b3 100644 --- a/Examples/go/check.list +++ b/Examples/go/check.list @@ -2,6 +2,7 @@ callback class constants +director enum extend funcptr diff --git a/Examples/go/class/Makefile b/Examples/go/class/Makefile index a099654..f72c067 100644 --- a/Examples/go/class/Makefile +++ b/Examples/go/class/Makefile @@ -1,16 +1,18 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = example.cxx +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = class.cxx TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_cpp clean: - $(MAKE) -f $(TOP)/Makefile INTERFACE='$(INTERFACE)' go_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INTERFACE='$(INTERFACE)' go_clean diff --git a/Examples/go/class/class.cxx b/Examples/go/class/class.cxx new file mode 100644 index 0000000..f87c7ec --- /dev/null +++ b/Examples/go/class/class.cxx @@ -0,0 +1,28 @@ +/* File : class.cxx */ + +#include "example.h" +#define M_PI 3.14159265358979323846 + +/* Move the shape to a new location */ +void Shape::move(double dx, double dy) { + x += dx; + y += dy; +} + +int Shape::nshapes = 0; + +double Circle::area() { + return M_PI*radius*radius; +} + +double Circle::perimeter() { + return 2*M_PI*radius; +} + +double Square::area() { + return width*width; +} + +double Square::perimeter() { + return 4*width; +} diff --git a/Examples/go/class/example.h b/Examples/go/class/example.h index 46d9013..0dff185 100644 --- a/Examples/go/class/example.h +++ b/Examples/go/class/example.h @@ -7,11 +7,11 @@ public: } virtual ~Shape() { nshapes--; - }; - double x, y; + } + double x, y; void move(double dx, double dy); - virtual double area(void) = 0; - virtual double perimeter(void) = 0; + virtual double area() = 0; + virtual double perimeter() = 0; static int nshapes; }; @@ -19,21 +19,16 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; - virtual double area(void); - virtual double perimeter(void); + Circle(double r) : radius(r) { } + virtual double area(); + virtual double perimeter(); }; class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; - virtual double area(void); - virtual double perimeter(void); + Square(double w) : width(w) { } + virtual double area(); + virtual double perimeter(); }; - - - - - diff --git a/Examples/go/class/example.i b/Examples/go/class/example.i index 75700b3..fbdf724 100644 --- a/Examples/go/class/example.i +++ b/Examples/go/class/example.i @@ -7,4 +7,3 @@ /* Let's just grab the original header file here */ %include "example.h" - diff --git a/Examples/go/class/index.html b/Examples/go/class/index.html index b39119d..df93b56 100644 --- a/Examples/go/class/index.html +++ b/Examples/go/class/index.html @@ -33,8 +33,8 @@ public: } virtual ~Shape() { nshapes--; - }; - double x, y; + } + double x, y; void move(double dx, double dy); virtual double area() = 0; virtual double perimeter() = 0; @@ -45,7 +45,7 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; + Circle(double r) : radius(r) { } virtual double area(); virtual double perimeter(); }; @@ -54,7 +54,7 @@ class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; + Square(double w) : width(w) { } virtual double area(); virtual double perimeter(); }; diff --git a/Examples/go/constants/Makefile b/Examples/go/constants/Makefile index b45feb9..b791fc9 100644 --- a/Examples/go/constants/Makefile +++ b/Examples/go/constants/Makefile @@ -1,16 +1,18 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go clean: - $(MAKE) -f $(TOP)/Makefile INTERFACE='$(INTERFACE)' go_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INTERFACE='$(INTERFACE)' go_clean diff --git a/Examples/go/director/Makefile b/Examples/go/director/Makefile new file mode 100644 index 0000000..430cac8 --- /dev/null +++ b/Examples/go/director/Makefile @@ -0,0 +1,26 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = +GOSRCS = director.go +TARGET = example +INTERFACE = example.i +SWIGOPT = + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run + +build: + if [ -n '$(SRCDIR)' ]; then \ + cp $(GOSRCS:%=$(SRCDIR)/%) .; \ + fi + @# Note: example.go gets generated by SWIG + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' GOSRCS='example.go $(GOSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_cpp + +clean: + if [ -n '$(SRCDIR)' ]; then \ + rm -f $(GOSRCS); \ + fi + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INTERFACE='$(INTERFACE)' go_clean diff --git a/Examples/go/director/director.go b/Examples/go/director/director.go new file mode 100644 index 0000000..4f99bfc --- /dev/null +++ b/Examples/go/director/director.go @@ -0,0 +1,72 @@ +package example + +// FooBarGo is a superset of FooBarAbstract and hence FooBarGo can be used as a +// drop in replacement for FooBarAbstract but the reverse causes a compile time +// error. +type FooBarGo interface { + FooBarAbstract + deleteFooBarAbstract() + IsFooBarGo() +} + +// Via embedding fooBarGo "inherits" all methods of FooBarAbstract. +type fooBarGo struct { + FooBarAbstract +} + +func (fbgs *fooBarGo) deleteFooBarAbstract() { + DeleteDirectorFooBarAbstract(fbgs.FooBarAbstract) +} + +// The IsFooBarGo method ensures that FooBarGo is a superset of FooBarAbstract. +// This is also how the class hierarchy gets represented by the SWIG generated +// wrapper code. For an instance FooBarCpp has the IsFooBarAbstract and +// IsFooBarCpp methods. +func (fbgs *fooBarGo) IsFooBarGo() {} + +// Go type that defines the DirectorInterface. It contains the Foo and Bar +// methods that overwrite the respective virtual C++ methods on FooBarAbstract. +type overwrittenMethodsOnFooBarAbstract struct { + // Backlink to FooBarAbstract so that the rest of the class can be used by + // the overridden methods. + fb FooBarAbstract + + // If additional constructor arguments have been given they are typically + // stored here so that the overriden methods can use them. +} + +func (om *overwrittenMethodsOnFooBarAbstract) Foo() string { + // DirectorFooBarAbstractFoo calls the base method FooBarAbstract::Foo. + return "Go " + DirectorFooBarAbstractFoo(om.fb) +} + +func (om *overwrittenMethodsOnFooBarAbstract) Bar() string { + return "Go Bar" +} + +func NewFooBarGo() FooBarGo { + // Instantiate FooBarAbstract with selected methods overridden. The methods + // that will be overwritten are defined on + // overwrittenMethodsOnFooBarAbstract and have a compatible signature to the + // respective virtual C++ methods. Furthermore additional constructor + // arguments will be typically stored in the + // overwrittenMethodsOnFooBarAbstract struct. + om := &overwrittenMethodsOnFooBarAbstract{} + fb := NewDirectorFooBarAbstract(om) + om.fb = fb // Backlink causes cycle as fb.v = om! + + fbgs := &fooBarGo{FooBarAbstract: fb} + // The memory of the FooBarAbstract director object instance can be + // automatically freed once the FooBarGo instance is garbage collected by + // uncommenting the following line. Please make sure to understand the + // runtime.SetFinalizer specific gotchas before doing this. Furthemore + // DeleteFooBarGo should be deleted if a finalizer is in use or the fooBarGo + // struct needs additional data to prevent double deletion. + // runtime.SetFinalizer(fbgs, FooBarGo.deleteFooBarAbstract) + return fbgs +} + +// Recommended to be removed if runtime.SetFinalizer is in use. +func DeleteFooBarGo(fbg FooBarGo) { + fbg.deleteFooBarAbstract() +} diff --git a/Examples/go/director/director.h b/Examples/go/director/director.h new file mode 100644 index 0000000..339a9ad --- /dev/null +++ b/Examples/go/director/director.h @@ -0,0 +1,41 @@ +#ifndef DIRECTOR_H +#define DIRECTOR_H + + +#include +#include + + +class FooBarAbstract +{ +public: + FooBarAbstract() {}; + virtual ~FooBarAbstract() {}; + + std::string FooBar() { + return this->Foo() + ", " + this->Bar(); + }; + +protected: + virtual std::string Foo() { + return "Foo"; + }; + + virtual std::string Bar() = 0; +}; + + +class FooBarCpp : public FooBarAbstract +{ +protected: + virtual std::string Foo() { + return "C++ " + FooBarAbstract::Foo(); + } + + virtual std::string Bar() { + return "C++ Bar"; + } +}; + + +#endif diff --git a/Examples/go/director/example.i b/Examples/go/director/example.i new file mode 100644 index 0000000..e832bd8 --- /dev/null +++ b/Examples/go/director/example.i @@ -0,0 +1,11 @@ +/* File : example.i */ +%module(directors="1") example + +%include "std_string.i" + +%header %{ +#include "director.h" +%} + +%feature("director") FooBarAbstract; +%include "director.h" diff --git a/Examples/go/director/index.html b/Examples/go/director/index.html new file mode 100644 index 0000000..b93e780 --- /dev/null +++ b/Examples/go/director/index.html @@ -0,0 +1,28 @@ + + +SWIG:Examples:go:director + + + + +SWIG/Examples/go/director/ +
      + +

      How to subclass a C++ class with a Go type

      + +

      +See the Go Director +Classes documentation subsection for an explanation of this example. +

      + +

      +

        +
      • director.go. Go source with the definition of the FooBarGo class. +
      • director.h. Header with the definition of the FooBarAbstract and FooBarCpp classes. +
      • example.i. SWIG interface file. +
      • runme.go. Sample Go program. +
      + +
      + + diff --git a/Examples/go/director/runme.go b/Examples/go/director/runme.go new file mode 100644 index 0000000..0d839bc --- /dev/null +++ b/Examples/go/director/runme.go @@ -0,0 +1,39 @@ +package main + +import ( + "./example" + "fmt" + "os" +) + +func Compare(name string, got string, exp string) error { + fmt.Printf("%s; Got: '%s'; Expected: '%s'\n", name, got, exp) + if got != exp { + return fmt.Errorf("%s returned unexpected string! Got: '%s'; Expected: '%s'\n", name, got, exp) + } + return nil +} + +func TestFooBarCpp() error { + fb := example.NewFooBarCpp() + defer example.DeleteFooBarCpp(fb) + return Compare("FooBarCpp.FooBar()", fb.FooBar(), "C++ Foo, C++ Bar") +} + +func TestFooBarGo() error { + fb := example.NewFooBarGo() + defer example.DeleteFooBarGo(fb) + return Compare("FooBarGo.FooBar()", fb.FooBar(), "Go Foo, Go Bar") +} + +func main() { + fmt.Println("Test output:") + fmt.Println("------------") + err := TestFooBarCpp() + err = TestFooBarGo() + fmt.Println("------------") + if err != nil { + fmt.Fprintf(os.Stderr, "Tests failed! Last error: %s\n", err.Error()) + os.Exit(1) + } +} diff --git a/Examples/go/enum/Makefile b/Examples/go/enum/Makefile index 7489f87..15defe9 100644 --- a/Examples/go/enum/Makefile +++ b/Examples/go/enum/Makefile @@ -1,16 +1,18 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = example.cxx +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = enum.cxx TARGET = example INTERFACE = example.i SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_cpp clean: - $(MAKE) -f $(TOP)/Makefile INTERFACE='$(INTERFACE)' go_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INTERFACE='$(INTERFACE)' go_clean diff --git a/Examples/go/enum/example.cxx b/Examples/go/enum/enum.cxx similarity index 100% rename from Examples/go/enum/example.cxx rename to Examples/go/enum/enum.cxx diff --git a/Examples/go/extend/Makefile b/Examples/go/extend/Makefile index 7489f87..a3c520e 100644 --- a/Examples/go/extend/Makefile +++ b/Examples/go/extend/Makefile @@ -1,16 +1,26 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = example.cxx +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = extend.cxx +GOSRCS = ceo.go TARGET = example INTERFACE = example.i SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + if [ -n '$(SRCDIR)' ]; then \ + cp $(GOSRCS:%=$(SRCDIR)/%) .; \ + fi + @# Note: example.go gets generated by SWIG + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' GOSRCS='example.go $(GOSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_cpp clean: - $(MAKE) -f $(TOP)/Makefile INTERFACE='$(INTERFACE)' go_clean + if [ -n '$(SRCDIR)' ]; then \ + rm -f $(GOSRCS); \ + fi + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INTERFACE='$(INTERFACE)' go_clean diff --git a/Examples/go/extend/ceo.go b/Examples/go/extend/ceo.go new file mode 100644 index 0000000..8f00c92 --- /dev/null +++ b/Examples/go/extend/ceo.go @@ -0,0 +1,37 @@ +package example + +type CEO interface { + Manager + deleteManager() + IsCEO() +} + +type ceo struct { + Manager +} + +func (p *ceo) deleteManager() { + DeleteDirectorManager(p.Manager) +} + +func (p *ceo) IsCEO() {} + +type overwrittenMethodsOnManager struct { + p Manager +} + +func NewCEO(name string) CEO { + om := &overwrittenMethodsOnManager{} + p := NewDirectorManager(om, name) + om.p = p + + return &ceo{Manager: p} +} + +func DeleteCEO(p CEO) { + p.deleteManager() +} + +func (p *ceo) GetPosition() string { + return "CEO" +} diff --git a/Examples/go/extend/example.h b/Examples/go/extend/example.h index b27ab97..0c3b721 100644 --- a/Examples/go/extend/example.h +++ b/Examples/go/extend/example.h @@ -14,7 +14,7 @@ public: virtual std::string getTitle() { return getPosition() + " " + getName(); } virtual std::string getName() { return name; } virtual std::string getPosition() const { return "Employee"; } - virtual ~Employee() { printf("~Employee() @ %p\n", this); } + virtual ~Employee() { printf("~Employee() @ %p\n", (void *)this); } }; @@ -44,7 +44,7 @@ public: const Employee *get_item(int i) { return list[i]; } - ~EmployeeList() { + ~EmployeeList() { std::vector::iterator i; std::cout << "~EmployeeList, deleting " << list.size() << " employees." << std::endl; for (i=list.begin(); i!=list.end(); i++) { diff --git a/Examples/go/callback/example.cxx b/Examples/go/extend/extend.cxx similarity index 100% rename from Examples/go/callback/example.cxx rename to Examples/go/extend/extend.cxx diff --git a/Examples/go/extend/index.html b/Examples/go/extend/index.html index 471fa9c..31788b2 100644 --- a/Examples/go/extend/index.html +++ b/Examples/go/extend/index.html @@ -12,13 +12,16 @@

      Extending a simple C++ class in Go

      -This example illustrates the extending of a C++ class with cross -language polymorphism. - +This example illustrates how to inherit from a C++ class in Go. +See the Go Director +Classes documentation subsection for an in-depth explanation how to use the +director feature.

      +

        -
      • example.h. Header file containing some enums. -
      • example.i. Interface file. +
      • ceo.go. Go source with the definition of the CEO class. +
      • example.h. Header with the definition of the Employee, Manager and EmployeeList classes. +
      • example.i. SWIG interface file.
      • runme.go. Sample Go program.
      diff --git a/Examples/go/extend/runme.go b/Examples/go/extend/runme.go index 8fdfd0a..a569689 100644 --- a/Examples/go/extend/runme.go +++ b/Examples/go/extend/runme.go @@ -7,19 +7,12 @@ import ( "fmt" ) -type CEO struct{} - -func (p *CEO) GetPosition() string { - return "CEO" -} - func main() { // Create an instance of CEO, a class derived from the Go // proxy of the underlying C++ class. The calls to getName() // and getPosition() are standard, the call to getTitle() uses // the director wrappers to call CEO.getPosition(). - - e := NewDirectorManager(new(CEO), "Alice") + e := NewCEO("Alice") fmt.Println(e.GetName(), " is a ", e.GetPosition()) fmt.Println("Just call her \"", e.GetTitle(), "\"") fmt.Println("----------------------") @@ -27,7 +20,6 @@ func main() { // Create a new EmployeeList instance. This class does not // have a C++ director wrapper, but can be used freely with // other classes that do. - list := NewEmployeeList() // EmployeeList owns its items, so we must surrender ownership @@ -42,22 +34,20 @@ func main() { // treated the same. For items 0, 1, and 2, all methods // resolve in C++. For item 3, our CEO, GetTitle calls // GetPosition which resolves in Go. The call to GetPosition - // is slightly different, however, because of the overidden + // is slightly different, however, because of the overridden // GetPosition() call, since now the object reference has been // "laundered" by passing through EmployeeList as an // Employee*. Previously, Go resolved the call immediately in // CEO, but now Go thinks the object is an instance of class // Employee. So the call passes through the Employee proxy // class and on to the C wrappers and C++ director, eventually - // ending up back at the Java CEO implementation of + // ending up back at the Go CEO implementation of // getPosition(). The call to GetTitle() for item 3 runs the // C++ Employee::getTitle() method, which in turn calls // GetPosition(). This virtual method call passes down - // through the C++ director class to the Java implementation + // through the C++ director class to the Go implementation // in CEO. All this routing takes place transparently. - fmt.Println("(position, title) for items 0-3:") - fmt.Println(" ", list.Get_item(0).GetPosition(), ", \"", list.Get_item(0).GetTitle(), "\"") fmt.Println(" ", list.Get_item(1).GetPosition(), ", \"", list.Get_item(1).GetTitle(), "\"") fmt.Println(" ", list.Get_item(2).GetPosition(), ", \"", list.Get_item(2).GetTitle(), "\"") @@ -66,11 +56,11 @@ func main() { // Time to delete the EmployeeList, which will delete all the // Employee* items it contains. The last item is our CEO, - // which gets destroyed as well. + // which gets destroyed as well and hence there is no need to + // call DeleteCEO. DeleteEmployeeList(list) fmt.Println("----------------------") // All done. - fmt.Println("Go exit") } diff --git a/Examples/go/funcptr/Makefile b/Examples/go/funcptr/Makefile index 452ea21..efeb6e8 100644 --- a/Examples/go/funcptr/Makefile +++ b/Examples/go/funcptr/Makefile @@ -1,16 +1,18 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -SRCS = example.c +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = funcptr.c TARGET = example INTERFACE = example.i SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go clean: - $(MAKE) -f $(TOP)/Makefile INTERFACE='$(INTERFACE)' go_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INTERFACE='$(INTERFACE)' go_clean diff --git a/Examples/go/funcptr/example.c b/Examples/go/funcptr/funcptr.c similarity index 100% rename from Examples/go/funcptr/example.c rename to Examples/go/funcptr/funcptr.c diff --git a/Examples/go/index.html b/Examples/go/index.html index 21dda21..467f4ec 100644 --- a/Examples/go/index.html +++ b/Examples/go/index.html @@ -23,6 +23,7 @@ certain C declarations are turned into constants.
    • template. C++ templates.
    • callback. C++ callbacks using directors.
    • extend. Polymorphism using directors. +
    • director. Example how to utilize the director feature.

    Compilation Issues

    @@ -37,20 +38,23 @@ certain C declarations are turned into constants.
  • On Unix the compilation of examples is done using the -file Example/Makefile. This makefile performs a manual -module compilation which is platform specific. When using -the 6g or 8g compiler, the steps look like this +file Example/Makefile. Normally builds are done simply +using go build. For testing purposes this makefile performs +a manual module compilation that is platform specific. When using +the gc compiler, the steps look approximately like this (GNU/Linux):
    -% swig -go interface.i
    -% gcc -fpic -c interface_wrap.c
    -% gcc -shared interface_wrap.o $(OBJS) -o interfacemodule.so 
    -% 6g interface.go
    -% 6c interface_gc.c
    -% gopack grc interface.a interface.6 interface_gc.6
    -% 6l program.6
    +% swig -go -cgo interface.i
    +% mkdir -p gopath/src/interface
    +% cp interface_wrap.c interface_wrap.h interface.go gopath/src/interface
    +% GOPATH=`pwd`/gopath
    +% export GOPATH
    +% cd gopath/src/interface
    +% go build
    +% go tool compile $(SRCDIR)/runme.go
    +% go tool link -o runme runme.o
     
    @@ -58,10 +62,15 @@ the 6g or 8g compiler, the steps look like this
    -% swig -go interface.i
    -% gcc -c interface_wrap.c
    -% gccgo -c interface.go
    -% gccgo program.o interface.o interface_wrap.o
    +% swig -go -cgo interface.i
    +% mkdir -p gopath/src/interface
    +% cp interface_wrap.c interface_wrap.h interface.go gopath/src/interface
    +% GOPATH=`pwd`/gopath
    +% export GOPATH
    +% cd gopath/src/interface
    +% go build
    +% gccgo -c $(SRCDIR)/runme.go
    +% gccgo -o runme runme.o interface.a
     
    All of the examples were last tested with the following configuration -(10 May 2010): +(5 August 2015):
      -
    • Ubuntu Hardy -
    • gcc-4.2.4 +
    • Ubuntu Trusty +
    • gcc-4.8.4
    -Your mileage may vary. If you experience a problem, please let us know by +Your mileage may vary. If you experience a problem, please let us know by contacting us on the mailing lists. diff --git a/Examples/go/multimap/Makefile b/Examples/go/multimap/Makefile index 452ea21..ba17261 100644 --- a/Examples/go/multimap/Makefile +++ b/Examples/go/multimap/Makefile @@ -1,16 +1,18 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -SRCS = example.c +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = multimap.c TARGET = example INTERFACE = example.i SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go clean: - $(MAKE) -f $(TOP)/Makefile INTERFACE='$(INTERFACE)' go_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INTERFACE='$(INTERFACE)' go_clean diff --git a/Examples/go/multimap/example.i b/Examples/go/multimap/example.i index 8de6b0d..30a37d3 100644 --- a/Examples/go/multimap/example.i +++ b/Examples/go/multimap/example.i @@ -74,16 +74,21 @@ extern int count(char *bytes, int len, char c); %} /* Return the mutated string as a modified element in the array. */ -%typemap(argout) (char *str, int len) +%typemap(argout,fragment="AllocateString") (char *str, int len) %{ { _gostring_ *a; a = (_gostring_*) $input.array; - a[0] = _swig_makegostring($1, $2); + a[0] = Swig_AllocateString($1, $2); } %} +%typemap(goargout,fragment="CopyString") (char *str, int len) +%{ + $input[0] = swigCopyString($input[0]) +%} + %typemap(freearg) (char *str, int len) %{ free($1); diff --git a/Examples/go/multimap/example.c b/Examples/go/multimap/multimap.c similarity index 100% rename from Examples/go/multimap/example.c rename to Examples/go/multimap/multimap.c diff --git a/Examples/go/pointer/Makefile b/Examples/go/pointer/Makefile index 452ea21..20587fd 100644 --- a/Examples/go/pointer/Makefile +++ b/Examples/go/pointer/Makefile @@ -1,16 +1,18 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -SRCS = example.c +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = pointer.c TARGET = example INTERFACE = example.i SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go clean: - $(MAKE) -f $(TOP)/Makefile INTERFACE='$(INTERFACE)' go_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INTERFACE='$(INTERFACE)' go_clean diff --git a/Examples/go/pointer/example.c b/Examples/go/pointer/pointer.c similarity index 100% rename from Examples/go/pointer/example.c rename to Examples/go/pointer/pointer.c diff --git a/Examples/go/reference/Makefile b/Examples/go/reference/Makefile index 7489f87..d203fff 100644 --- a/Examples/go/reference/Makefile +++ b/Examples/go/reference/Makefile @@ -1,16 +1,18 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = example.cxx +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = reference.cxx TARGET = example INTERFACE = example.i SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_cpp clean: - $(MAKE) -f $(TOP)/Makefile INTERFACE='$(INTERFACE)' go_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INTERFACE='$(INTERFACE)' go_clean diff --git a/Examples/go/reference/example.h b/Examples/go/reference/example.h index 4915adb..bcfcfb7 100644 --- a/Examples/go/reference/example.h +++ b/Examples/go/reference/example.h @@ -4,8 +4,8 @@ class Vector { private: double x,y,z; public: - Vector() : x(0), y(0), z(0) { }; - Vector(double x, double y, double z) : x(x), y(y), z(z) { }; + Vector() : x(0), y(0), z(0) { } + Vector(double x, double y, double z) : x(x), y(y), z(z) { } friend Vector operator+(const Vector &a, const Vector &b); char *print(); }; @@ -20,7 +20,3 @@ public: Vector &operator[](int); int size(); }; - - - - diff --git a/Examples/go/reference/example.i b/Examples/go/reference/example.i index 1cf19c8..173143d 100644 --- a/Examples/go/reference/example.i +++ b/Examples/go/reference/example.i @@ -29,7 +29,7 @@ public: VectorArray(int maxsize); ~VectorArray(); int size(); - + /* This wrapper provides an alternative to the [] operator */ %extend { Vector &get(int index) { diff --git a/Examples/go/reference/reference.cxx b/Examples/go/reference/reference.cxx new file mode 100644 index 0000000..9dbaed2 --- /dev/null +++ b/Examples/go/reference/reference.cxx @@ -0,0 +1,46 @@ +/* File : example.cxx */ + +/* Deal with Microsoft's attempt at deprecating C standard runtime functions */ +#if !defined(SWIG_NO_CRT_SECURE_NO_DEPRECATE) && defined(_MSC_VER) +# define _CRT_SECURE_NO_DEPRECATE +#endif + +#include "example.h" +#include +#include + +Vector operator+(const Vector &a, const Vector &b) { + Vector r; + r.x = a.x + b.x; + r.y = a.y + b.y; + r.z = a.z + b.z; + return r; +} + +char *Vector::print() { + static char temp[512]; + sprintf(temp,"Vector %p (%g,%g,%g)", (void *)this, x,y,z); + return temp; +} + +VectorArray::VectorArray(int size) { + items = new Vector[size]; + maxsize = size; +} + +VectorArray::~VectorArray() { + delete [] items; +} + +Vector &VectorArray::operator[](int index) { + if ((index < 0) || (index >= maxsize)) { + printf("Panic! Array index out of bounds.\n"); + exit(1); + } + return items[index]; +} + +int VectorArray::size() { + return maxsize; +} + diff --git a/Examples/go/simple/Makefile b/Examples/go/simple/Makefile index 75f81bf..89b936f 100644 --- a/Examples/go/simple/Makefile +++ b/Examples/go/simple/Makefile @@ -1,15 +1,17 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -SRCS = example.c +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = simple.c TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go clean: - $(MAKE) -f $(TOP)/Makefile INTERFACE='$(INTERFACE)' go_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INTERFACE='$(INTERFACE)' go_clean diff --git a/Examples/go/simple/example.c b/Examples/go/simple/simple.c similarity index 100% rename from Examples/go/simple/example.c rename to Examples/go/simple/simple.c diff --git a/Examples/go/template/Makefile b/Examples/go/template/Makefile index 9ee0304..f79b083 100644 --- a/Examples/go/template/Makefile +++ b/Examples/go/template/Makefile @@ -1,16 +1,18 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_cpp clean: - $(MAKE) -f $(TOP)/Makefile INTERFACE='$(INTERFACE)' go_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INTERFACE='$(INTERFACE)' go_clean diff --git a/Examples/go/template/index.html b/Examples/go/template/index.html index a14e3b2..cf2b133 100644 --- a/Examples/go/template/index.html +++ b/Examples/go/template/index.html @@ -17,7 +17,7 @@ SWIG.

    The C++ Code

    -Lets take a templated function and a templated class as follows: +Let's take a templated function and a templated class as follows:
    diff --git a/Examples/go/variables/Makefile b/Examples/go/variables/Makefile
    index 452ea21..cef1186 100644
    --- a/Examples/go/variables/Makefile
    +++ b/Examples/go/variables/Makefile
    @@ -1,16 +1,18 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = example.c
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +SRCS       = variables.c
     TARGET     = example
     INTERFACE  = example.i
     SWIGOPT    =
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' go
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile INTERFACE='$(INTERFACE)' go_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INTERFACE='$(INTERFACE)' go_clean
    diff --git a/Examples/go/variables/example.c b/Examples/go/variables/variables.c
    similarity index 97%
    rename from Examples/go/variables/example.c
    rename to Examples/go/variables/variables.c
    index aa4ffe9..05e17c8 100644
    --- a/Examples/go/variables/example.c
    +++ b/Examples/go/variables/variables.c
    @@ -51,7 +51,7 @@ void print_vars() {
       printf("dvar      = %g\n", dvar);
       printf("cvar      = %c\n", cvar);
       printf("strvar    = %s\n", strvar ? strvar : "(null)");
    -  printf("cstrvar   = %s\n", cstrvar ? cstrvar : "(null)");
    +  printf("cstrvar   = %s\n", cstrvar);
       printf("iptrvar   = %p\n", iptrvar);
       printf("name      = %s\n", name);
       printf("ptptr     = %p (%d, %d)\n", ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0);
    diff --git a/Examples/guile/class/Makefile b/Examples/guile/class/Makefile
    index 8de4f29..84a7b43 100644
    --- a/Examples/guile/class/Makefile
    +++ b/Examples/guile/class/Makefile
    @@ -1,19 +1,22 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     CXXSRCS    = example.cxx
     TARGET     = example
     INTERFACE  = example.i
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile guile_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' guile_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' guile_cpp
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='my-guile' INTERFACE='$(INTERFACE)' guile_static_cpp
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' guile_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' guile_clean
    diff --git a/Examples/guile/class/example.cxx b/Examples/guile/class/example.cxx
    index 1e8e203..0463045 100644
    --- a/Examples/guile/class/example.cxx
    +++ b/Examples/guile/class/example.cxx
    @@ -1,4 +1,4 @@
    -/* File : example.c */
    +/* File : example.cxx */
     
     #include "example.h"
     #define M_PI 3.14159265358979323846
    @@ -11,18 +11,18 @@ void Shape::move(double dx, double dy) {
     
     int Shape::nshapes = 0;
     
    -double Circle::area(void) {
    +double Circle::area() {
       return M_PI*radius*radius;
     }
     
    -double Circle::perimeter(void) {
    +double Circle::perimeter() {
       return 2*M_PI*radius;
     }
     
    -double Square::area(void) {
    +double Square::area() {
       return width*width;
     }
     
    -double Square::perimeter(void) {
    +double Square::perimeter() {
       return 4*width;
     }
    diff --git a/Examples/guile/class/example.h b/Examples/guile/class/example.h
    index 0d4527e..0dff185 100644
    --- a/Examples/guile/class/example.h
    +++ b/Examples/guile/class/example.h
    @@ -7,11 +7,11 @@ public:
       }
       virtual ~Shape() {
         nshapes--;
    -  };
    +  }
       double  x, y;
       void    move(double dx, double dy);
    -  virtual double area(void) = 0;
    -  virtual double perimeter(void) = 0;
    +  virtual double area() = 0;
    +  virtual double perimeter() = 0;
       static  int nshapes;
     };
     
    @@ -19,16 +19,16 @@ class Circle : public Shape {
     private:
       double radius;
     public:
    -  Circle(double r) : radius(r) { };
    -  virtual double area(void);
    -  virtual double perimeter(void);
    +  Circle(double r) : radius(r) { }
    +  virtual double area();
    +  virtual double perimeter();
     };
     
     class Square : public Shape {
     private:
       double width;
     public:
    -  Square(double w) : width(w) { };
    -  virtual double area(void);
    -  virtual double perimeter(void);
    +  Square(double w) : width(w) { }
    +  virtual double area();
    +  virtual double perimeter();
     };
    diff --git a/Examples/guile/constants/Makefile b/Examples/guile/constants/Makefile
    index d8a3cfe..abe63d4 100644
    --- a/Examples/guile/constants/Makefile
    +++ b/Examples/guile/constants/Makefile
    @@ -1,15 +1,17 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +SRCS       =
     TARGET     = my-guile
     INTERFACE  = example.i
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' guile_augmented_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' guile_augmented_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' guile_augmented
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' guile_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' guile_clean
    diff --git a/Examples/guile/matrix/Makefile b/Examples/guile/matrix/Makefile
    index a32210e..cfe0c85 100644
    --- a/Examples/guile/matrix/Makefile
    +++ b/Examples/guile/matrix/Makefile
    @@ -1,15 +1,17 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     SRCS       = matrix.c vector.c
    -TARGET     = matrix
    +TARGET     = my-guile
     INTERFACE  = example.i
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' GUILE_RUNOPTIONS='-e do-test' guile_augmented_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' GUILE_RUNOPTIONS='-e do-test' guile_augmented_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' LIBS='-lm' guile_augmented
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' guile_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' guile_clean
    diff --git a/Examples/guile/matrix/README b/Examples/guile/matrix/README
    index db7395b..496e81b 100644
    --- a/Examples/guile/matrix/README
    +++ b/Examples/guile/matrix/README
    @@ -6,7 +6,7 @@ type the following :
     
     Alternatively, use the command-line:
     
    -	./matrix -e do-test -s runme.scm
    +	./my-guile -e do-test -s runme.scm
     
     Or, if your operating system is spiffy enough:
     
    diff --git a/Examples/guile/matrix/runme.scm b/Examples/guile/matrix/runme.scm
    old mode 100755
    new mode 100644
    diff --git a/Examples/guile/multimap/Makefile b/Examples/guile/multimap/Makefile
    index 4ca82a3..f876702 100644
    --- a/Examples/guile/multimap/Makefile
    +++ b/Examples/guile/multimap/Makefile
    @@ -1,19 +1,22 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     SRCS       = example.c
     TARGET     = example
     INTERFACE  = example.i
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile guile_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' guile_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' guile
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='my-guile' INTERFACE='$(INTERFACE)' guile_static
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' guile_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' guile_clean
    diff --git a/Examples/guile/multivalue/Makefile b/Examples/guile/multivalue/Makefile
    index 4ca82a3..f876702 100644
    --- a/Examples/guile/multivalue/Makefile
    +++ b/Examples/guile/multivalue/Makefile
    @@ -1,19 +1,22 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     SRCS       = example.c
     TARGET     = example
     INTERFACE  = example.i
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile guile_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' guile_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' guile
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='my-guile' INTERFACE='$(INTERFACE)' guile_static
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' guile_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' guile_clean
    diff --git a/Examples/guile/port/Makefile b/Examples/guile/port/Makefile
    index d6ec0ac..09ee821 100644
    --- a/Examples/guile/port/Makefile
    +++ b/Examples/guile/port/Makefile
    @@ -1,16 +1,18 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     SRCS       = example.c
    -TARGET     = port
    +TARGET     = my-guile
     INTERFACE  = example.i
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' guile_augmented_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' guile_augmented_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' guile_augmented
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' guile_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' guile_clean
     	rm -f test.out
    diff --git a/Examples/guile/port/README b/Examples/guile/port/README
    index 784e39e..174d876 100644
    --- a/Examples/guile/port/README
    +++ b/Examples/guile/port/README
    @@ -1,2 +1,2 @@
     This example illustrates the translation from Scheme file ports to
    -temporary FILE streams. Read the source and run ./port -s runme.scm
    +temporary FILE streams. Read the source and run ./my-guile -s runme.scm
    diff --git a/Examples/guile/simple/Makefile b/Examples/guile/simple/Makefile
    index da4eb90..d8fb2da 100644
    --- a/Examples/guile/simple/Makefile
    +++ b/Examples/guile/simple/Makefile
    @@ -1,15 +1,17 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     SRCS       = example.c
     TARGET     = my-guile
     INTERFACE  = example.i
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' guile_augmented_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' guile_augmented_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' guile_augmented
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' guile_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' guile_clean
    diff --git a/Examples/guile/std_vector/Makefile b/Examples/guile/std_vector/Makefile
    index fd7a843..1146242 100644
    --- a/Examples/guile/std_vector/Makefile
    +++ b/Examples/guile/std_vector/Makefile
    @@ -1,19 +1,22 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     CXXSRCS    =
     TARGET     = example
     INTERFACE  = example.i
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile guile_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' guile_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' guile_cpp
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='my-guile' INTERFACE='$(INTERFACE)' guile_static_cpp
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' guile_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' guile_clean
    diff --git a/Examples/java/callback/Makefile b/Examples/java/callback/Makefile
    index 8f274e7..c76e092 100644
    --- a/Examples/java/callback/Makefile
    +++ b/Examples/java/callback/Makefile
    @@ -1,5 +1,6 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     CXXSRCS    = example.cxx
     TARGET     = example
     INTERFACE  = example.i
    @@ -7,12 +8,13 @@ SWIGOPT    =
     JAVASRCS   = *.java
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile java_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' java_cpp
    -	$(MAKE) -f $(TOP)/Makefile JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile java_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_clean
    diff --git a/Examples/java/callback/example.i b/Examples/java/callback/example.i
    index 90beda0..cf61ef9 100644
    --- a/Examples/java/callback/example.i
    +++ b/Examples/java/callback/example.i
    @@ -4,8 +4,6 @@
     #include "example.h"
     %}
     
    -%include "std_string.i"
    -
     /* turn on director wrapping Callback */
     %feature("director") Callback;
     
    diff --git a/Examples/java/check.list b/Examples/java/check.list
    index 9728342..825d04a 100644
    --- a/Examples/java/check.list
    +++ b/Examples/java/check.list
    @@ -7,6 +7,7 @@ extend
     funcptr
     multimap
     native
    +nested
     pointer
     reference
     simple
    diff --git a/Examples/java/class/Makefile b/Examples/java/class/Makefile
    index 8f274e7..c76e092 100644
    --- a/Examples/java/class/Makefile
    +++ b/Examples/java/class/Makefile
    @@ -1,5 +1,6 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     CXXSRCS    = example.cxx
     TARGET     = example
     INTERFACE  = example.i
    @@ -7,12 +8,13 @@ SWIGOPT    =
     JAVASRCS   = *.java
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile java_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' java_cpp
    -	$(MAKE) -f $(TOP)/Makefile JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile java_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_clean
    diff --git a/Examples/java/class/example.cxx b/Examples/java/class/example.cxx
    index 1e8e203..0463045 100644
    --- a/Examples/java/class/example.cxx
    +++ b/Examples/java/class/example.cxx
    @@ -1,4 +1,4 @@
    -/* File : example.c */
    +/* File : example.cxx */
     
     #include "example.h"
     #define M_PI 3.14159265358979323846
    @@ -11,18 +11,18 @@ void Shape::move(double dx, double dy) {
     
     int Shape::nshapes = 0;
     
    -double Circle::area(void) {
    +double Circle::area() {
       return M_PI*radius*radius;
     }
     
    -double Circle::perimeter(void) {
    +double Circle::perimeter() {
       return 2*M_PI*radius;
     }
     
    -double Square::area(void) {
    +double Square::area() {
       return width*width;
     }
     
    -double Square::perimeter(void) {
    +double Square::perimeter() {
       return 4*width;
     }
    diff --git a/Examples/java/class/example.h b/Examples/java/class/example.h
    index 46d9013..0dff185 100644
    --- a/Examples/java/class/example.h
    +++ b/Examples/java/class/example.h
    @@ -7,11 +7,11 @@ public:
       }
       virtual ~Shape() {
         nshapes--;
    -  };
    -  double  x, y;   
    +  }
    +  double  x, y;
       void    move(double dx, double dy);
    -  virtual double area(void) = 0;
    -  virtual double perimeter(void) = 0;
    +  virtual double area() = 0;
    +  virtual double perimeter() = 0;
       static  int nshapes;
     };
     
    @@ -19,21 +19,16 @@ class Circle : public Shape {
     private:
       double radius;
     public:
    -  Circle(double r) : radius(r) { };
    -  virtual double area(void);
    -  virtual double perimeter(void);
    +  Circle(double r) : radius(r) { }
    +  virtual double area();
    +  virtual double perimeter();
     };
     
     class Square : public Shape {
     private:
       double width;
     public:
    -  Square(double w) : width(w) { };
    -  virtual double area(void);
    -  virtual double perimeter(void);
    +  Square(double w) : width(w) { }
    +  virtual double area();
    +  virtual double perimeter();
     };
    -
    -
    -
    -
    -  
    diff --git a/Examples/java/class/example.i b/Examples/java/class/example.i
    index 75700b3..fbdf724 100644
    --- a/Examples/java/class/example.i
    +++ b/Examples/java/class/example.i
    @@ -7,4 +7,3 @@
     
     /* Let's just grab the original header file here */
     %include "example.h"
    -
    diff --git a/Examples/java/class/index.html b/Examples/java/class/index.html
    index cf9130c..b0a5e22 100644
    --- a/Examples/java/class/index.html
    +++ b/Examples/java/class/index.html
    @@ -32,8 +32,8 @@ public:
       }
       virtual ~Shape() {
         nshapes--;
    -  };
    -  double  x, y;   
    +  }
    +  double  x, y;
       void    move(double dx, double dy);
       virtual double area() = 0;
       virtual double perimeter() = 0;
    @@ -44,7 +44,7 @@ class Circle : public Shape {
     private:
       double radius;
     public:
    -  Circle(double r) : radius(r) { };
    +  Circle(double r) : radius(r) { }
       virtual double area();
       virtual double perimeter();
     };
    @@ -53,7 +53,7 @@ class Square : public Shape {
     private:
       double width;
     public:
    -  Square(double w) : width(w) { };
    +  Square(double w) : width(w) { }
       virtual double area();
       virtual double perimeter();
     };
    @@ -146,50 +146,15 @@ Shape.setNshapes(13);       // Set a static data member
     
     
    • This high-level interface using proxy classes is not the only way to handle C++ code. -A low level interface using c functions to access member variables and member functions is the alternative SWIG -approach. This entails passing around the c pointer or c++ 'this' pointer and as such it is not difficult to crash the JVM. +A low level interface using C functions to access member variables and member functions is the alternative SWIG +approach. This entails passing around the C pointer or C++ 'this' pointer and as such it is not difficult to crash the JVM. The abstraction of the underlying pointer by the java proxy classes far better fits the java programming paradigm.

      -

    • SWIG *does* know how to properly perform upcasting of objects in an inheritance +
    • SWIG does know how to properly perform upcasting of objects in an inheritance hierarchy (including multiple inheritance). However Java classes can only derive from one base class so multiple inheritance is not implemented. Java classes can implement more than one interface so there is scope for improvement in the future. -

      -

    • A wide variety of C++ features are not currently supported by SWIG. Here is the -short and incomplete list: - -

      -

        -
      • Overloaded methods and functions. SWIG wrappers don't know how to resolve name -conflicts so you must give an alternative name to any overloaded method name using the -%name directive like this: - -
        -
        -void foo(int a);  
        -%name(foo2) void foo(double a, double b);
        -
        -
        - -

        -

      • Overloaded operators. Not supported at all. The only workaround for this is -to write a helper function. For example: - -
        -
        -%inline %{
        -    Vector *vector_add(Vector *a, Vector *b) {
        -          ... whatever ...
        -    }
        -%}
        -
        -
        - -

        -

      • Namespaces. Not supported at all. Won't be supported until SWIG2.0 (if at all). - -

    diff --git a/Examples/java/constants/Makefile b/Examples/java/constants/Makefile index 97c5b67..ddc2157 100644 --- a/Examples/java/constants/Makefile +++ b/Examples/java/constants/Makefile @@ -1,18 +1,20 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i SWIGOPT = JAVASRCS = *.java check: build - $(MAKE) -f $(TOP)/Makefile java_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' java_cpp - $(MAKE) -f $(TOP)/Makefile JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile clean: - $(MAKE) -f $(TOP)/Makefile java_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_clean diff --git a/Examples/java/enum/Makefile b/Examples/java/enum/Makefile index 8f274e7..c76e092 100644 --- a/Examples/java/enum/Makefile +++ b/Examples/java/enum/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i @@ -7,12 +8,13 @@ SWIGOPT = JAVASRCS = *.java check: build - $(MAKE) -f $(TOP)/Makefile java_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' java_cpp - $(MAKE) -f $(TOP)/Makefile JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile clean: - $(MAKE) -f $(TOP)/Makefile java_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_clean diff --git a/Examples/java/extend/Makefile b/Examples/java/extend/Makefile index 8f274e7..c76e092 100644 --- a/Examples/java/extend/Makefile +++ b/Examples/java/extend/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i @@ -7,12 +8,13 @@ SWIGOPT = JAVASRCS = *.java check: build - $(MAKE) -f $(TOP)/Makefile java_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' java_cpp - $(MAKE) -f $(TOP)/Makefile JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile clean: - $(MAKE) -f $(TOP)/Makefile java_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_clean diff --git a/Examples/java/extend/example.h b/Examples/java/extend/example.h index b27ab97..ca1aed2 100644 --- a/Examples/java/extend/example.h +++ b/Examples/java/extend/example.h @@ -14,7 +14,7 @@ public: virtual std::string getTitle() { return getPosition() + " " + getName(); } virtual std::string getName() { return name; } virtual std::string getPosition() const { return "Employee"; } - virtual ~Employee() { printf("~Employee() @ %p\n", this); } + virtual ~Employee() { printf("~Employee() @ %p\n", (void *)this); } }; diff --git a/Examples/java/extend/runme.java b/Examples/java/extend/runme.java index 629bb14..f1ec1ea 100644 --- a/Examples/java/extend/runme.java +++ b/Examples/java/extend/runme.java @@ -55,7 +55,7 @@ public class runme { // methods of all these instances are treated the same. For items 0, 1, and // 2, all methods resolve in C++. For item 3, our CEO, getTitle calls // getPosition which resolves in Java. The call to getPosition is - // slightly different, however, because of the overidden getPosition() call, since + // slightly different, however, because of the overridden getPosition() call, since // now the object reference has been "laundered" by passing through // EmployeeList as an Employee*. Previously, Java resolved the call // immediately in CEO, but now Java thinks the object is an instance of diff --git a/Examples/java/funcptr/Makefile b/Examples/java/funcptr/Makefile index e9e29f3..4babc68 100644 --- a/Examples/java/funcptr/Makefile +++ b/Examples/java/funcptr/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i @@ -7,12 +8,13 @@ SWIGOPT = JAVASRCS = *.java check: build - $(MAKE) -f $(TOP)/Makefile java_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' java - $(MAKE) -f $(TOP)/Makefile JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile clean: - $(MAKE) -f $(TOP)/Makefile java_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_clean diff --git a/Examples/java/multimap/Makefile b/Examples/java/multimap/Makefile index e9e29f3..4babc68 100644 --- a/Examples/java/multimap/Makefile +++ b/Examples/java/multimap/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i @@ -7,12 +8,13 @@ SWIGOPT = JAVASRCS = *.java check: build - $(MAKE) -f $(TOP)/Makefile java_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' java - $(MAKE) -f $(TOP)/Makefile JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile clean: - $(MAKE) -f $(TOP)/Makefile java_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_clean diff --git a/Examples/java/native/Makefile b/Examples/java/native/Makefile index 29d5a08..b43a7d1 100644 --- a/Examples/java/native/Makefile +++ b/Examples/java/native/Makefile @@ -1,18 +1,20 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -SRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = TARGET = example INTERFACE = example.i SWIGOPT = JAVASRCS = *.java check: build - $(MAKE) -f $(TOP)/Makefile java_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' java - $(MAKE) -f $(TOP)/Makefile JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile clean: - $(MAKE) -f $(TOP)/Makefile java_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_clean diff --git a/Examples/java/nested/Makefile b/Examples/java/nested/Makefile new file mode 100644 index 0000000..c76e092 --- /dev/null +++ b/Examples/java/nested/Makefile @@ -0,0 +1,20 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = example.cxx +TARGET = example +INTERFACE = example.i +SWIGOPT = +JAVASRCS = *.java + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' java_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_clean diff --git a/Examples/java/nested/example.cxx b/Examples/java/nested/example.cxx new file mode 100644 index 0000000..03bb74d --- /dev/null +++ b/Examples/java/nested/example.cxx @@ -0,0 +1,62 @@ +#include "example.h" + +int MotorCar::DesignOpinion::AceDesignCount = 0; +int MotorCar::DesignOpinion::TotalDesignCount = 0; + +int MotorCar::DesignOpinion::PercentScore() { + return AceDesignCount*100/TotalDesignCount; +} + +MotorCar::Wheels::Wheels(Shape shape, size_t count) : shape(shape), count(count) {} + +MotorCar::WindScreen::WindScreen(bool opaque) : opaque(opaque) {} + +MotorCar::MotorCar(const std::string &name, const Wheels &wheels, const WindScreen &windscreen) : name(name), wheels(wheels), windscreen(windscreen) {} + +MotorCar MotorCar::DesignFromComponents(const std::string &name, const Wheels &wheels, const WindScreen &windscreen) { + MotorCar car = MotorCar(name, wheels, windscreen); + DesignOpinion::TotalDesignCount++; + if (car.wheels.Opinion().itrocks && car.windscreen.Opinion().itrocks) + DesignOpinion::AceDesignCount++; + return car; +} + +MotorCar::DesignOpinion MotorCar::Wheels::Opinion() { + DesignOpinion opinion; + opinion.itrocks = true; + if (shape == Square) { + opinion.itrocks = false; + opinion.reason = "you'll have a few issues with wheel rotation"; + } + if (count <= 2) { + opinion.reason += opinion.itrocks ? "" : " and "; + opinion.itrocks = false; + opinion.reason += "a few more wheels are needed for stability"; + } + if (opinion.itrocks) + opinion.reason = "your choice of wheels was top notch"; + + return opinion; +} + +MotorCar::DesignOpinion MotorCar::WindScreen::Opinion() { + DesignOpinion opinion; + opinion.itrocks = !opaque; + opinion.reason = opinion.itrocks ? "the driver will have a commanding view out the window" : "you can't see out the windscreen"; + return opinion; +} + +std::string MotorCar::WillItWork() { + DesignOpinion wh = wheels.Opinion(); + DesignOpinion ws = windscreen.Opinion(); + std::string willit; + if (wh.itrocks && ws.itrocks) { + willit = "Great car design because " + wh.reason + " and " + ws.reason; + } else { + willit = "You need a rethink because "; + willit += wh.itrocks ? "" : wh.reason; + willit += (!wh.itrocks && !ws.itrocks) ? " and " : ""; + willit += ws.itrocks ? "" : ws.reason; + } + return willit; +} diff --git a/Examples/java/nested/example.dsp b/Examples/java/nested/example.dsp new file mode 100644 index 0000000..f52544b --- /dev/null +++ b/Examples/java/nested/example.dsp @@ -0,0 +1,162 @@ +# Microsoft Developer Studio Project File - Name="example" - Package Owner=<4> +# Microsoft Developer Studio Generated Build File, Format Version 6.00 +# ** DO NOT EDIT ** + +# TARGTYPE "Win32 (x86) Dynamic-Link Library" 0x0102 + +CFG=example - Win32 Release +!MESSAGE This is not a valid makefile. To build this project using NMAKE, +!MESSAGE use the Export Makefile command and run +!MESSAGE +!MESSAGE NMAKE /f "example.mak". +!MESSAGE +!MESSAGE You can specify a configuration when running NMAKE +!MESSAGE by defining the macro CFG on the command line. For example: +!MESSAGE +!MESSAGE NMAKE /f "example.mak" CFG="example - Win32 Release" +!MESSAGE +!MESSAGE Possible choices for configuration are: +!MESSAGE +!MESSAGE "example - Win32 Debug" (based on "Win32 (x86) Dynamic-Link Library") +!MESSAGE "example - Win32 Release" (based on "Win32 (x86) Dynamic-Link Library") +!MESSAGE + +# Begin Project +# PROP AllowPerConfigDependencies 0 +# PROP Scc_ProjName "" +# PROP Scc_LocalPath "" +CPP=cl.exe +MTL=midl.exe +RSC=rc.exe + +!IF "$(CFG)" == "example - Win32 Debug" + +# PROP BASE Use_MFC 0 +# PROP BASE Use_Debug_Libraries 1 +# PROP BASE Output_Dir "Debug" +# PROP BASE Intermediate_Dir "Debug" +# PROP BASE Target_Dir "" +# PROP Use_MFC 0 +# PROP Use_Debug_Libraries 1 +# PROP Output_Dir "Debug" +# PROP Intermediate_Dir "Debug" +# PROP Ignore_Export_Lib 0 +# PROP Target_Dir "" +# ADD BASE CPP /nologo /MTd /W3 /Gm /GX /ZI /Od /D "WIN32" /D "_DEBUG" /D "_WINDOWS" /D "_MBCS" /D "_USRDLL" /D "EXAMPLE_EXPORTS" /YX /FD /GZ /c +# ADD CPP /nologo /MTd /W3 /Gm /GX /ZI /Od /I "$(JAVA_INCLUDE)" /I "$(JAVA_INCLUDE)\win32" /D "WIN32" /D "_DEBUG" /D "_WINDOWS" /D "_MBCS" /D "_USRDLL" /D "EXAMPLE_EXPORTS" /YX /FD /GZ /c +# ADD BASE MTL /nologo /D "_DEBUG" /mktyplib203 /win32 +# ADD MTL /nologo /D "_DEBUG" /mktyplib203 /win32 +# ADD BASE RSC /l 0x809 /d "_DEBUG" +# ADD RSC /l 0x809 /d "_DEBUG" +BSC32=bscmake.exe +# ADD BASE BSC32 /nologo +# ADD BSC32 /nologo +LINK32=link.exe +# ADD BASE LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib /nologo /dll /debug /machine:I386 /pdbtype:sept +# ADD LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib /nologo /dll /debug /machine:I386 /out:"example.dll" /pdbtype:sept +# Begin Special Build Tool +SOURCE="$(InputPath)" +PostBuild_Desc=Java compile post-build step +PostBuild_Cmds=echo on "%JAVA_BIN%\javac" *.java +# End Special Build Tool + +!ELSEIF "$(CFG)" == "example - Win32 Release" + +# PROP BASE Use_MFC 0 +# PROP BASE Use_Debug_Libraries 0 +# PROP BASE Output_Dir "Release" +# PROP BASE Intermediate_Dir "Release" +# PROP BASE Target_Dir "" +# PROP Use_MFC 0 +# PROP Use_Debug_Libraries 0 +# PROP Output_Dir "Release" +# PROP Intermediate_Dir "Release" +# PROP Ignore_Export_Lib 0 +# PROP Target_Dir "" +# ADD BASE CPP /nologo /MT /W3 /GX /O2 /D "WIN32" /D "NDEBUG" /D "_WINDOWS" /D "_MBCS" /D "_USRDLL" /D "EXAMPLE_EXPORTS" /YX /FD /c +# ADD CPP /nologo /MT /W3 /GX /O2 /I "$(JAVA_INCLUDE)" /I "$(JAVA_INCLUDE)\win32" /D "WIN32" /D "NDEBUG" /D "_WINDOWS" /D "_MBCS" /D "_USRDLL" /D "EXAMPLE_EXPORTS" /YX /FD /c +# ADD BASE MTL /nologo /D "NDEBUG" /mktyplib203 /win32 +# ADD MTL /nologo /D "NDEBUG" /mktyplib203 /win32 +# ADD BASE RSC /l 0x809 /d "NDEBUG" +# ADD RSC /l 0x809 /d "NDEBUG" +BSC32=bscmake.exe +# ADD BASE BSC32 /nologo +# ADD BSC32 /nologo +LINK32=link.exe +# ADD BASE LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib /nologo /dll /machine:I386 +# ADD LINK32 kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib /nologo /dll /machine:I386 /out:"example.dll" +# Begin Special Build Tool +SOURCE="$(InputPath)" +PostBuild_Desc=Java compile post-build step +PostBuild_Cmds=echo on "%JAVA_BIN%\javac" *.java +# End Special Build Tool + +!ENDIF + +# Begin Target + +# Name "example - Win32 Debug" +# Name "example - Win32 Release" +# Begin Group "Source Files" + +# PROP Default_Filter "cpp;c;cxx;rc;def;r;odl;idl;hpj;bat" +# Begin Source File + +SOURCE=.\example.cxx +# End Source File +# Begin Source File + +SOURCE=.\example_wrap.cxx +# End Source File +# End Group +# Begin Group "Header Files" + +# PROP Default_Filter "h;hpp;hxx;hm;inl" +# Begin Source File + +SOURCE=.\example.h +# End Source File +# End Group +# Begin Group "Resource Files" + +# PROP Default_Filter "ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe" +# End Group +# Begin Source File + +SOURCE=.\example.i + +!IF "$(CFG)" == "example - Win32 Debug" + +# Begin Custom Build +InputPath=.\example.i +InputName=example + +"$(InputName)_wrap.cxx" : $(SOURCE) "$(INTDIR)" "$(OUTDIR)" + echo In order to function correctly, please ensure the following environment variables are correctly set: + echo JAVA_INCLUDE: %JAVA_INCLUDE% + echo JAVA_BIN: %JAVA_BIN% + echo on + ..\..\..\swig.exe -c++ -java "$(InputPath)" + +# End Custom Build + +!ELSEIF "$(CFG)" == "example - Win32 Release" + +# Begin Custom Build +InputPath=.\example.i +InputName=example + +"$(InputName)_wrap.cxx" : $(SOURCE) "$(INTDIR)" "$(OUTDIR)" + echo In order to function correctly, please ensure the following environment variables are correctly set: + echo JAVA_INCLUDE: %JAVA_INCLUDE% + echo JAVA_BIN: %JAVA_BIN% + echo on + ..\..\..\swig.exe -c++ -java "$(InputPath)" + +# End Custom Build + +!ENDIF + +# End Source File +# End Target +# End Project diff --git a/Examples/java/nested/example.h b/Examples/java/nested/example.h new file mode 100644 index 0000000..4fb107c --- /dev/null +++ b/Examples/java/nested/example.h @@ -0,0 +1,48 @@ +#include + +/** Design a motor car from various components */ +struct MotorCar { + + /** Information about an opinion of the design of a car component */ + struct DesignOpinion { + bool itrocks; + std::string reason; + static int AceDesignCount; + static int TotalDesignCount; + static int PercentScore(); + }; + + /** Wheels component */ + struct Wheels { + enum Shape { Round, Square }; + Wheels(Shape shape, size_t count); + DesignOpinion Opinion(); + private: + Shape shape; + size_t count; + }; + + /** Windscreen component */ + struct WindScreen { + WindScreen(bool opaque); + DesignOpinion Opinion(); + private: + bool opaque; + }; + + /** Factory method for creating a car */ + static MotorCar DesignFromComponents(const std::string &name, const Wheels &wheels, const WindScreen &windscreen); + + std::string Name() { + return name; + } + + /** Get an overall opinion on the car design */ + std::string WillItWork(); + +private: + MotorCar(const std::string &name, const Wheels &wheels, const WindScreen &windscreen); + std::string name; + Wheels wheels; + WindScreen windscreen; +}; diff --git a/Examples/java/nested/example.i b/Examples/java/nested/example.i new file mode 100644 index 0000000..c07c152 --- /dev/null +++ b/Examples/java/nested/example.i @@ -0,0 +1,13 @@ +%module example + +// This example shows how wrappers for numerous aspects of C++ nested classes work: +// Nested static and instance variables and methods and nested enums + +%include + +%{ +#include "example.h" +%} + +%include "example.h" + diff --git a/Examples/java/nested/runme.java b/Examples/java/nested/runme.java new file mode 100644 index 0000000..855dbea --- /dev/null +++ b/Examples/java/nested/runme.java @@ -0,0 +1,32 @@ +// This example illustrates wrapping of nested C++ classes + +public class runme { + static { + try { + System.loadLibrary("example"); + } catch (UnsatisfiedLinkError e) { + System.err.println("Native code library failed to load. See the chapter on Dynamic Linking Problems in the SWIG Java documentation for help.\n" + e); + System.exit(1); + } + } + + public static void main(String argv[]) + { + MotorCar car1 = MotorCar.DesignFromComponents("Bumpy", new MotorCar.Wheels(MotorCar.Wheels.Shape.Square, 4), new MotorCar.WindScreen(false)); + MotorCar car2 = MotorCar.DesignFromComponents("Wobbly", new MotorCar.Wheels(MotorCar.Wheels.Shape.Round, 2), new MotorCar.WindScreen(false)); + MotorCar car3 = MotorCar.DesignFromComponents("Batty", new MotorCar.Wheels(MotorCar.Wheels.Shape.Round, 4), new MotorCar.WindScreen(true)); + MotorCar car4 = MotorCar.DesignFromComponents("Spiffing", new MotorCar.Wheels(MotorCar.Wheels.Shape.Round, 4), new MotorCar.WindScreen(false)); + + System.out.println("Expert opinion on " + car1.Name() + " : \n " + car1.WillItWork()); + System.out.println("Expert opinion on " + car2.Name() + " : \n " + car2.WillItWork()); + System.out.println("Expert opinion on " + car3.Name() + " : \n " + car3.WillItWork()); + System.out.println("Expert opinion on " + car4.Name() + " : \n " + car4.WillItWork()); + + int count = MotorCar.DesignOpinion.getAceDesignCount(); + int total = MotorCar.DesignOpinion.getTotalDesignCount(); + int percent = MotorCar.DesignOpinion.PercentScore(); + System.out.println("Overall opinion rating on car design is " + count + "/" + total + " = " + percent + "%"); + + System.out.println("Single square wheel thoughts: " + new MotorCar.Wheels(MotorCar.Wheels.Shape.Square, 1).Opinion().getReason()); + } +} diff --git a/Examples/java/pointer/Makefile b/Examples/java/pointer/Makefile index e9e29f3..4babc68 100644 --- a/Examples/java/pointer/Makefile +++ b/Examples/java/pointer/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i @@ -7,12 +8,13 @@ SWIGOPT = JAVASRCS = *.java check: build - $(MAKE) -f $(TOP)/Makefile java_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' java - $(MAKE) -f $(TOP)/Makefile JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile clean: - $(MAKE) -f $(TOP)/Makefile java_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_clean diff --git a/Examples/java/pointer/example.i b/Examples/java/pointer/example.i index a8ac794..ed1c2fc 100644 --- a/Examples/java/pointer/example.i +++ b/Examples/java/pointer/example.i @@ -24,7 +24,3 @@ extern void sub(int *INPUT, int *INPUT, int *OUTPUT); %apply int *OUTPUT { int *r }; extern int divide(int n, int d, int *r); - - - - diff --git a/Examples/java/reference/Makefile b/Examples/java/reference/Makefile index 8f274e7..c76e092 100644 --- a/Examples/java/reference/Makefile +++ b/Examples/java/reference/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i @@ -7,12 +8,13 @@ SWIGOPT = JAVASRCS = *.java check: build - $(MAKE) -f $(TOP)/Makefile java_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' java_cpp - $(MAKE) -f $(TOP)/Makefile JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile clean: - $(MAKE) -f $(TOP)/Makefile java_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_clean diff --git a/Examples/java/reference/example.cxx b/Examples/java/reference/example.cxx index 8a513bf..9dbaed2 100644 --- a/Examples/java/reference/example.cxx +++ b/Examples/java/reference/example.cxx @@ -19,7 +19,7 @@ Vector operator+(const Vector &a, const Vector &b) { char *Vector::print() { static char temp[512]; - sprintf(temp,"Vector %p (%g,%g,%g)", this, x,y,z); + sprintf(temp,"Vector %p (%g,%g,%g)", (void *)this, x,y,z); return temp; } diff --git a/Examples/java/reference/example.h b/Examples/java/reference/example.h index 4915adb..bcfcfb7 100644 --- a/Examples/java/reference/example.h +++ b/Examples/java/reference/example.h @@ -4,8 +4,8 @@ class Vector { private: double x,y,z; public: - Vector() : x(0), y(0), z(0) { }; - Vector(double x, double y, double z) : x(x), y(y), z(z) { }; + Vector() : x(0), y(0), z(0) { } + Vector(double x, double y, double z) : x(x), y(y), z(z) { } friend Vector operator+(const Vector &a, const Vector &b); char *print(); }; @@ -20,7 +20,3 @@ public: Vector &operator[](int); int size(); }; - - - - diff --git a/Examples/java/reference/example.i b/Examples/java/reference/example.i index 6daa3b1..173143d 100644 --- a/Examples/java/reference/example.i +++ b/Examples/java/reference/example.i @@ -29,7 +29,7 @@ public: VectorArray(int maxsize); ~VectorArray(); int size(); - + /* This wrapper provides an alternative to the [] operator */ %extend { Vector &get(int index) { @@ -40,7 +40,3 @@ public: } } }; - - - - diff --git a/Examples/java/simple/Makefile b/Examples/java/simple/Makefile index e9e29f3..4babc68 100644 --- a/Examples/java/simple/Makefile +++ b/Examples/java/simple/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i @@ -7,12 +8,13 @@ SWIGOPT = JAVASRCS = *.java check: build - $(MAKE) -f $(TOP)/Makefile java_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' java - $(MAKE) -f $(TOP)/Makefile JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile clean: - $(MAKE) -f $(TOP)/Makefile java_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_clean diff --git a/Examples/java/template/Makefile b/Examples/java/template/Makefile index 97c5b67..ddc2157 100644 --- a/Examples/java/template/Makefile +++ b/Examples/java/template/Makefile @@ -1,18 +1,20 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i SWIGOPT = JAVASRCS = *.java check: build - $(MAKE) -f $(TOP)/Makefile java_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' java_cpp - $(MAKE) -f $(TOP)/Makefile JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile clean: - $(MAKE) -f $(TOP)/Makefile java_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_clean diff --git a/Examples/java/template/index.html b/Examples/java/template/index.html index f4408e5..31dba6d 100644 --- a/Examples/java/template/index.html +++ b/Examples/java/template/index.html @@ -16,7 +16,7 @@ This example illustrates how C++ templates can be used from Java using SWIG.

    The C++ Code

    -Lets take a templated function and a templated class as follows: +Let's take a templated function and a templated class as follows:
    diff --git a/Examples/java/typemap/Makefile b/Examples/java/typemap/Makefile
    index 29d5a08..b43a7d1 100644
    --- a/Examples/java/typemap/Makefile
    +++ b/Examples/java/typemap/Makefile
    @@ -1,18 +1,20 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +SRCS       =
     TARGET     = example
     INTERFACE  = example.i
     SWIGOPT    =
     JAVASRCS   = *.java
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile java_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' java
    -	$(MAKE) -f $(TOP)/Makefile JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile java_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_clean
    diff --git a/Examples/java/variables/Makefile b/Examples/java/variables/Makefile
    index e9e29f3..4babc68 100644
    --- a/Examples/java/variables/Makefile
    +++ b/Examples/java/variables/Makefile
    @@ -1,5 +1,6 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     SRCS       = example.c
     TARGET     = example
     INTERFACE  = example.i
    @@ -7,12 +8,13 @@ SWIGOPT    =
     JAVASRCS   = *.java
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile java_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' java
    -	$(MAKE) -f $(TOP)/Makefile JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' JAVASRCS='$(JAVASRCS)' JAVAFLAGS='$(JAVAFLAGS)' java_compile
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile java_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' java_clean
    diff --git a/Examples/java/variables/example.c b/Examples/java/variables/example.c
    index aa4ffe9..85685fe 100644
    --- a/Examples/java/variables/example.c
    +++ b/Examples/java/variables/example.c
    @@ -51,10 +51,10 @@ void print_vars() {
       printf("dvar      = %g\n", dvar);
       printf("cvar      = %c\n", cvar);
       printf("strvar    = %s\n", strvar ? strvar : "(null)");
    -  printf("cstrvar   = %s\n", cstrvar ? cstrvar : "(null)");
    -  printf("iptrvar   = %p\n", iptrvar);
    +  printf("cstrvar   = %s\n", cstrvar);
    +  printf("iptrvar   = %p\n", (void *)iptrvar);
       printf("name      = %s\n", name);
    -  printf("ptptr     = %p (%d, %d)\n", ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0);
    +  printf("ptptr     = %p (%d, %d)\n", (void *)ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0);
       printf("pt        = (%d, %d)\n", pt.x, pt.y);
       printf("status    = %d\n", status);
     }
    diff --git a/Examples/javascript/check.list b/Examples/javascript/check.list
    new file mode 100644
    index 0000000..9707e77
    --- /dev/null
    +++ b/Examples/javascript/check.list
    @@ -0,0 +1,13 @@
    +class
    +constant
    +enum
    +exception
    +functor
    +nspace
    +operator
    +overload
    +pointer
    +#reference
    +simple
    +template
    +variables
    diff --git a/Examples/javascript/class/Makefile b/Examples/javascript/class/Makefile
    new file mode 100644
    index 0000000..54a8f7b
    --- /dev/null
    +++ b/Examples/javascript/class/Makefile
    @@ -0,0 +1,3 @@
    +SRCS = example.cxx
    +
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/javascript/class/binding.gyp.in b/Examples/javascript/class/binding.gyp.in
    new file mode 100644
    index 0000000..cb2b45e
    --- /dev/null
    +++ b/Examples/javascript/class/binding.gyp.in
    @@ -0,0 +1,9 @@
    +{
    +  "targets": [
    +    {
    +      "target_name": "example",
    +      "sources": [ "
    +
    +void Foo::enum_test(speed s) {
    +  if (s == IMPULSE) {
    +    printf("IMPULSE speed\n");
    +  } else if (s == WARP) {
    +    printf("WARP speed\n");
    +  } else if (s == LUDICROUS) {
    +    printf("LUDICROUS speed\n");
    +  } else {
    +    printf("Unknown speed\n");
    +  }
    +}
    +
    +void enum_test(color c, Foo::speed s) {
    +  if (c == RED) {
    +    printf("color = RED, ");
    +  } else if (c == BLUE) {
    +    printf("color = BLUE, ");
    +  } else if (c == GREEN) {
    +    printf("color = GREEN, ");
    +  } else {
    +    printf("color = Unknown color!, ");
    +  }
    +  if (s == Foo::IMPULSE) {
    +    printf("speed = IMPULSE speed\n");
    +  } else if (s == Foo::WARP) {
    +    printf("speed = WARP speed\n");
    +  } else if (s == Foo::LUDICROUS) {
    +    printf("speed = LUDICROUS speed\n");
    +  } else {
    +    printf("speed = Unknown speed!\n");
    +  }
    +}
    diff --git a/Examples/javascript/enum/example.h b/Examples/javascript/enum/example.h
    new file mode 100644
    index 0000000..9119cd9
    --- /dev/null
    +++ b/Examples/javascript/enum/example.h
    @@ -0,0 +1,13 @@
    +/* File : example.h */
    +
    +enum color { RED, BLUE, GREEN };
    +
    +class Foo {
    + public:
    +  Foo() { }
    +  enum speed { IMPULSE=10, WARP=20, LUDICROUS=30 };
    +  void enum_test(speed s);
    +};
    +
    +void enum_test(color c, Foo::speed s);
    +
    diff --git a/Examples/javascript/enum/example.i b/Examples/javascript/enum/example.i
    new file mode 100644
    index 0000000..23ee8a8
    --- /dev/null
    +++ b/Examples/javascript/enum/example.i
    @@ -0,0 +1,11 @@
    +/* File : example.i */
    +%module example
    +
    +%{
    +#include "example.h"
    +%}
    +
    +/* Let's just grab the original header file here */
    +
    +%include "example.h"
    +
    diff --git a/Examples/javascript/enum/example.js b/Examples/javascript/enum/example.js
    new file mode 100644
    index 0000000..2e7f83a
    --- /dev/null
    +++ b/Examples/javascript/enum/example.js
    @@ -0,0 +1 @@
    +module.exports = require("build/Release/example");
    diff --git a/Examples/javascript/enum/runme.js b/Examples/javascript/enum/runme.js
    new file mode 100644
    index 0000000..851d43c
    --- /dev/null
    +++ b/Examples/javascript/enum/runme.js
    @@ -0,0 +1,34 @@
    +var example = require("example");
    +
    +// ----- Object creation -----
    +
    +// Print out the value of some enums
    +console.log("*** color ***");
    +console.log("    RED    =" + example.RED);
    +console.log("    BLUE   =" + example.BLUE);
    +console.log("    GREEN  =" + example.GREEN);
    +
    +console.log("\n*** Foo::speed ***");
    +console.log("    Foo_IMPULSE   =" + example.Foo.IMPULSE);
    +console.log("    Foo_WARP      =" + example.Foo.WARP);
    +console.log("    Foo_LUDICROUS =" + example.Foo.LUDICROUS);
    +
    +console.log("\nTesting use of enums with functions\n");
    +
    +example.enum_test(example.RED, example.Foo.IMPULSE);
    +example.enum_test(example.BLUE,  example.Foo.WARP);
    +example.enum_test(example.GREEN, example.Foo.LUDICROUS);
    +example.enum_test(1234,5678);
    +
    +console.log("\nTesting use of enum with class method");
    +f = new example.Foo();
    +
    +f.enum_test(example.Foo.IMPULSE);
    +f.enum_test(example.Foo.WARP);
    +f.enum_test(example.Foo.LUDICROUS);
    +
    +// enum value BLUE of enum color is accessed as property of cconst
    +console.log("example.BLUE= " + example.BLUE);
    +
    +// enum value LUDICROUS of enum Foo::speed is accessed as as property of cconst
    +console.log("example.speed.LUDICROUS= " + example.Foo.LUDICROUS); 
    diff --git a/Examples/javascript/example.mk b/Examples/javascript/example.mk
    new file mode 100644
    index 0000000..3ef012a
    --- /dev/null
    +++ b/Examples/javascript/example.mk
    @@ -0,0 +1,36 @@
    +# Note: as a convention an example must be in a child directory of this.
    +# These paths are relative to such an example directory
    +
    +ifneq (, $(ENGINE))
    +	JSENGINE=$(ENGINE)
    +else
    +	JSENGINE=node
    +endif
    +
    +ifneq (, $(V8_VERSION))
    +	JSV8_VERSION=$(V8_VERSION)
    +else
    +	JSV8_VERSION=0x031110
    +endif
    +
    +EXAMPLES_TOP   = ../..
    +SWIG_TOP       = ../../..
    +SWIGEXE        = $(SWIG_TOP)/swig
    +SWIG_LIB_DIR   = $(SWIG_TOP)/$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +TARGET         = example
    +INTERFACE      = example.i
    +SWIGOPT        = -$(JSENGINE) -DV8_VERSION=$(JSV8_VERSION)
    +
    +check: build
    +	$(MAKE) -f $(EXAMPLES_TOP)/Makefile SRCDIR='$(SRCDIR)' JSENGINE='$(JSENGINE)' TARGET='$(TARGET)' javascript_run
    +
    +build:
    +	$(MAKE) -f $(EXAMPLES_TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' javascript_wrapper_cpp
    +	$(MAKE) -f $(EXAMPLES_TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' JSENGINE='$(JSENGINE)' javascript_build_cpp
    +
    +clean:
    +	$(MAKE) -f $(EXAMPLES_TOP)/Makefile SRCDIR='$(SRCDIR)' javascript_clean
    diff --git a/Examples/javascript/exception/Makefile b/Examples/javascript/exception/Makefile
    new file mode 100644
    index 0000000..54a8f7b
    --- /dev/null
    +++ b/Examples/javascript/exception/Makefile
    @@ -0,0 +1,3 @@
    +SRCS = example.cxx
    +
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/javascript/exception/binding.gyp.in b/Examples/javascript/exception/binding.gyp.in
    new file mode 100644
    index 0000000..2e97d97
    --- /dev/null
    +++ b/Examples/javascript/exception/binding.gyp.in
    @@ -0,0 +1,30 @@
    +{
    +  "targets": [
    +    {
    +      "target_name": "example",
    +      "sources": [ "
    +#ifndef SWIG
    +struct A {
    +};
    +#endif
    +
    +class Exc {
    +public:
    +  Exc(int c, const char *m) {
    +    code = c;
    +    strncpy(msg,m,256);
    +  }
    +  int code;
    +  char msg[256];
    +};
    +
    +#if defined(_MSC_VER)
    +  #pragma warning(disable: 4290) // C++ exception specification ignored except to indicate a function is not __declspec(nothrow)
    +#endif
    +
    +class Test {
    +public:
    +  int simple() throw(int) {
    +      throw(37);
    +      return 1;
    +  }
    +  int message() throw(const char *) {
    +      throw("I died.");
    +      return 1;
    +  }
    +  int hosed() throw(Exc) {
    +      throw(Exc(42,"Hosed"));
    +      return 1;
    +  } 
    +  int unknown() throw(A*) {
    +      static A a;
    +      throw &a;
    +      return 1;
    +  }
    +  int multi(int x) throw(int, const char *, Exc) {
    +     if (x == 1) throw(37);
    +     if (x == 2) throw("Bleah!");
    +     if (x == 3) throw(Exc(42,"No-go-diggy-die"));
    +     return 1;
    +  }
    +};
    +
    +#if defined(_MSC_VER)
    +  #pragma warning(default: 4290) // C++ exception specification ignored except to indicate a function is not __declspec(nothrow)
    +#endif
    +
    diff --git a/Examples/javascript/exception/example.i b/Examples/javascript/exception/example.i
    new file mode 100644
    index 0000000..08672c3
    --- /dev/null
    +++ b/Examples/javascript/exception/example.i
    @@ -0,0 +1,12 @@
    +/* File : example.i */
    +%module example
    +
    +%{
    +#include "example.h"
    +%}
    +
    +%include "std_string.i"
    +
    +/* Let's just grab the original header file here */
    +%include "example.h"
    +
    diff --git a/Examples/javascript/exception/example.js b/Examples/javascript/exception/example.js
    new file mode 100644
    index 0000000..2e7f83a
    --- /dev/null
    +++ b/Examples/javascript/exception/example.js
    @@ -0,0 +1 @@
    +module.exports = require("build/Release/example");
    diff --git a/Examples/javascript/exception/runme.js b/Examples/javascript/exception/runme.js
    new file mode 100644
    index 0000000..43ce66d
    --- /dev/null
    +++ b/Examples/javascript/exception/runme.js
    @@ -0,0 +1,64 @@
    +var example = require("example");
    +
    +console.log("Trying to catch some exceptions.");
    +t = new example.Test();
    +try{
    +  t.unknown();
    +  throw -1;
    +} catch(error)
    +{
    +  if(error == -1) {
    +    console.log("t.unknown() didn't throw");
    +  } else {
    +    console.log("successfully catched throw in Test::unknown().");
    +  }
    +}
    +
    +try{
    +    t.simple();
    +    throw -1;
    +}
    +catch(error){
    +  if(error == -1) {
    +    console.log("t.simple() did not throw");
    +  } else {
    +    console.log("successfully catched throw in Test::simple().");
    +  }
    +}
    +
    +try{
    +  t.message();
    +  throw -1;
    +} catch(error){
    +  if(error == -1) {
    +    console.log("t.message() did not throw");
    +  } else {
    +    console.log("successfully catched throw in Test::message().");
    +  }
    +}
    +    
    +try{
    +  t.hosed();
    +  throw -1;
    +}
    +catch(error){ 
    +  if(error == -1) {
    +    console.log("t.hosed() did not throw");
    +  } else {
    +    console.log("successfully catched throw in Test::hosed().");
    +  }
    +}
    +
    +for (var i=1; i<4; i++) {
    +  try{
    +      t.multi(i);
    +      throw -1;
    +  }
    +  catch(error){
    +    if(error == -1) {
    +      console.log("t.multi(" + i + ") did not throw");
    +    } else {
    +      console.log("successfully catched throw in Test::multi().");
    +    }
    +  }
    +}    
    diff --git a/Examples/javascript/functor/Makefile b/Examples/javascript/functor/Makefile
    new file mode 100644
    index 0000000..0402f8d
    --- /dev/null
    +++ b/Examples/javascript/functor/Makefile
    @@ -0,0 +1,3 @@
    +SRCS =
    +
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/javascript/functor/binding.gyp.in b/Examples/javascript/functor/binding.gyp.in
    new file mode 100644
    index 0000000..59779ae
    --- /dev/null
    +++ b/Examples/javascript/functor/binding.gyp.in
    @@ -0,0 +1,9 @@
    +{
    +  "targets": [
    +    {
    +      "target_name": "example",
    +      "sources": [ "example_wrap.cxx" ],
    +      "include_dirs": ["$srcdir"]
    +    }
    +  ]
    +}
    diff --git a/Examples/javascript/functor/example.i b/Examples/javascript/functor/example.i
    new file mode 100644
    index 0000000..0450c21
    --- /dev/null
    +++ b/Examples/javascript/functor/example.i
    @@ -0,0 +1,25 @@
    +/* File : example.i */
    +%module example
    +
    +
    +%inline %{
    +// From B. Strousjoup, "The C++ Programming Language, Third Edition", p. 514
    +template class Sum {
    +   T res;
    +public:
    +   Sum(T i = 0) : res(i) { }
    +   void operator() (T x) { res += x; }
    +   T result() const { return res; }
    +};
    +
    +%}
    +
    +%rename(call)	*::operator();	// the fn call operator
    +
    +// Instantiate a few versions
    +%template(intSum) Sum;
    +%template(doubleSum) Sum;
    +
    +
    +
    +
    diff --git a/Examples/javascript/functor/example.js b/Examples/javascript/functor/example.js
    new file mode 100644
    index 0000000..2e7f83a
    --- /dev/null
    +++ b/Examples/javascript/functor/example.js
    @@ -0,0 +1 @@
    +module.exports = require("build/Release/example");
    diff --git a/Examples/javascript/functor/runme.js b/Examples/javascript/functor/runme.js
    new file mode 100644
    index 0000000..28dc643
    --- /dev/null
    +++ b/Examples/javascript/functor/runme.js
    @@ -0,0 +1,15 @@
    +var example = require("example");
    +
    +a = new example.intSum(0);
    +b = new example.doubleSum(100.0);
    +
    +// Use the objects.  They should be callable just like a normal
    +// javascript function.
    +
    +for (i=1;i<=100;i++) 
    +    a.call(i);                // Note: function call
    +    b.call(Math.sqrt(i));     // Note: function call
    +
    +console.log(a.result());
    +console.log(b.result());
    +
    diff --git a/Examples/javascript/nspace/Makefile b/Examples/javascript/nspace/Makefile
    new file mode 100644
    index 0000000..0402f8d
    --- /dev/null
    +++ b/Examples/javascript/nspace/Makefile
    @@ -0,0 +1,3 @@
    +SRCS =
    +
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/javascript/nspace/binding.gyp.in b/Examples/javascript/nspace/binding.gyp.in
    new file mode 100644
    index 0000000..59779ae
    --- /dev/null
    +++ b/Examples/javascript/nspace/binding.gyp.in
    @@ -0,0 +1,9 @@
    +{
    +  "targets": [
    +    {
    +      "target_name": "example",
    +      "sources": [ "example_wrap.cxx" ],
    +      "include_dirs": ["$srcdir"]
    +    }
    +  ]
    +}
    diff --git a/Examples/javascript/nspace/example.h b/Examples/javascript/nspace/example.h
    new file mode 100644
    index 0000000..5306698
    --- /dev/null
    +++ b/Examples/javascript/nspace/example.h
    @@ -0,0 +1,23 @@
    +#ifndef _example_guardian_
    +#define _example_guardian_
    +
    +int module_function() { return 7; }
    +int module_variable = 9;
    +
    +namespace MyWorld {
    +  class World {
    +  public:
    +    World() : world_max_count(9) {}
    +    int create_world() { return 17; }
    +    const int world_max_count; // = 9
    +  };
    +  namespace Nested {
    +    class Dweller {
    +      public:
    +        enum Gender { MALE = 0, FEMALE = 1 };
    +        static int count() { return 19; }
    +    };
    +  }
    +}
    +
    +#endif
    diff --git a/Examples/javascript/nspace/example.i b/Examples/javascript/nspace/example.i
    new file mode 100644
    index 0000000..c30f87f
    --- /dev/null
    +++ b/Examples/javascript/nspace/example.i
    @@ -0,0 +1,10 @@
    +%module example
    +
    +%{
    +#include "example.h"
    +%}
    +
    +%nspace MyWorld::Nested::Dweller;
    +%nspace MyWorld::World;
    +
    +%include "example.h"
    diff --git a/Examples/javascript/nspace/example.js b/Examples/javascript/nspace/example.js
    new file mode 100644
    index 0000000..2e7f83a
    --- /dev/null
    +++ b/Examples/javascript/nspace/example.js
    @@ -0,0 +1 @@
    +module.exports = require("build/Release/example");
    diff --git a/Examples/javascript/nspace/runme.js b/Examples/javascript/nspace/runme.js
    new file mode 100644
    index 0000000..fad7347
    --- /dev/null
    +++ b/Examples/javascript/nspace/runme.js
    @@ -0,0 +1,50 @@
    +// File: runme.js
    +
    +// This file illustrates class C++ interface generated
    +// by SWIG.
    +
    +var example = require("example");
    +
    +// Calling a module function ( aka global function )
    +if (example.module_function() !== 7) {
    +  throw new Error("example.module_function() should equal 7");
    +}
    +console.log("example.module_function(): " + example.module_function());
    +
    +// Accessing a module (aka global) variable
    +if (example.module_variable !== 9) {
    +  throw new Error("example.module_variable should equal 9");
    +}
    +console.log("example.module_variable: " + example.module_variable);
    +
    +// Creating an instance of the class
    +var w1 = new example.MyWorld.World();
    +console.log("Creating class instance: w1 = new example.MyWorld.World(): " + w1);
    +
    +// Accessing class members
    +if (w1.create_world() !== 17) {
    +  throw new Error("w1.create_world() should equal 17");
    +}
    +console.log("w1.create_world() = " + w1.create_world());
    +
    +if (w1.world_max_count !== 9) {
    +  throw new Error("w1.world_max_count should equal 9");
    +}
    +console.log("w1.world_max_count = " + w1.world_max_count);
    +
    +// Accessing enums from class within namespace
    +if (example.MyWorld.Nested.Dweller.MALE !== 0) {
    +  throw new Error("example.MyWorld.Nested.Dweller.MALE should equal 0");
    +}
    +console.log("Accessing enums: ex.MyWorld.Nested.Dweller.MALE = " + example.MyWorld.Nested.Dweller.MALE);
    +
    +if (example.MyWorld.Nested.Dweller.FEMALE !== 1) {
    +  throw new Error("example.MyWorld.Nested.Dweller.FEMALE should equal 1");
    +}
    +console.log("Accessing enums: ex.MyWorld.Nested.Dweller.FEMALE = " + example.MyWorld.Nested.Dweller.FEMALE);
    +
    +// Accessing static member function
    +if (example.MyWorld.Nested.Dweller.count() !== 19) {
    +  throw new Error("example.MyWorld.Nested.Dweller.count() should equal 19");
    +}
    +console.log("Accessing static member function: ex.MyWorld.Nested.Dweller.count() = " + example.MyWorld.Nested.Dweller.count());
    diff --git a/Examples/javascript/operator/Makefile b/Examples/javascript/operator/Makefile
    new file mode 100644
    index 0000000..0402f8d
    --- /dev/null
    +++ b/Examples/javascript/operator/Makefile
    @@ -0,0 +1,3 @@
    +SRCS =
    +
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/javascript/operator/binding.gyp.in b/Examples/javascript/operator/binding.gyp.in
    new file mode 100644
    index 0000000..59779ae
    --- /dev/null
    +++ b/Examples/javascript/operator/binding.gyp.in
    @@ -0,0 +1,9 @@
    +{
    +  "targets": [
    +    {
    +      "target_name": "example",
    +      "sources": [ "example_wrap.cxx" ],
    +      "include_dirs": ["$srcdir"]
    +    }
    +  ]
    +}
    diff --git a/Examples/javascript/operator/example.h b/Examples/javascript/operator/example.h
    new file mode 100644
    index 0000000..4da6a23
    --- /dev/null
    +++ b/Examples/javascript/operator/example.h
    @@ -0,0 +1,36 @@
    +/* File : example.h */
    +#include 
    +
    +class Complex {
    +private:
    +  double rpart, ipart;
    +public:
    +  Complex(double r = 0, double i = 0) : rpart(r), ipart(i) { }
    +  Complex(const Complex &c) : rpart(c.rpart), ipart(c.ipart) { }
    +  Complex &operator=(const Complex &c) {
    +    rpart = c.rpart;
    +    ipart = c.ipart;
    +    return *this;
    +  }
    +  Complex operator+(const Complex &c) const {
    +    return Complex(rpart+c.rpart, ipart+c.ipart);
    +  }
    +  Complex operator-(const Complex &c) const {
    +    return Complex(rpart-c.rpart, ipart-c.ipart);
    +  }
    +  Complex operator*(const Complex &c) const {
    +    return Complex(rpart*c.rpart - ipart*c.ipart,
    +		   rpart*c.ipart + c.rpart*ipart);
    +  }
    +  Complex operator-() const {
    +    return Complex(-rpart, -ipart);
    +  }
    +  
    +  double re() const { return rpart; }
    +  double im() const { return ipart; }
    +};
    +
    +
    +
    +
    +  
    diff --git a/Examples/javascript/operator/example.i b/Examples/javascript/operator/example.i
    new file mode 100644
    index 0000000..7a1bd45
    --- /dev/null
    +++ b/Examples/javascript/operator/example.i
    @@ -0,0 +1,34 @@
    +/* File : example.i */
    +%module example
    +#pragma SWIG nowarn=SWIGWARN_IGNORE_OPERATOR_EQ
    +%{
    +#include "example.h"
    +%}
    +
    +/* This header file is a little tough to handle because it has overloaded
    +   operators and constructors.  We're going to try and deal with that here */
    +
    +/* This turns the copy constructor in a function ComplexCopy() that can
    +   be called */
    +
    +%rename(assign) Complex::operator=;
    +%rename(plus) Complex::operator+;
    +%rename(minus) Complex::operator-(const Complex &) const;
    +%rename(uminus) Complex::operator-() const;
    +%rename(times) Complex::operator*;
    +
    +/* Now grab the original header file */
    +%include "example.h"
    +
    +/* An output method that turns a complex into a short string */
    +%extend Complex {
    + char *toString() {
    +   static char temp[512];
    +   sprintf(temp,"(%g,%g)", $self->re(), $self->im());
    +   return temp;
    + }
    + static Complex* copy(const Complex& c) {
    +   return new Complex(c);
    + }
    +};
    +
    diff --git a/Examples/javascript/operator/example.js b/Examples/javascript/operator/example.js
    new file mode 100644
    index 0000000..2e7f83a
    --- /dev/null
    +++ b/Examples/javascript/operator/example.js
    @@ -0,0 +1 @@
    +module.exports = require("build/Release/example");
    diff --git a/Examples/javascript/operator/runme.js b/Examples/javascript/operator/runme.js
    new file mode 100644
    index 0000000..f72ca1c
    --- /dev/null
    +++ b/Examples/javascript/operator/runme.js
    @@ -0,0 +1,25 @@
    +var example = require("example");
    +
    +a = new example.Complex(2,3);
    +b = new example.Complex(-5,10);
    +
    +console.log ("a =" + a);
    +console.log ("b   =" + b);
    +
    +c = a.plus(b);
    +
    +console.log("c   =" + c);
    +console.log("a*b =" + a.times(b));
    +console.log("a-c =" + a.minus(c));
    +
    +e = example.Complex.copy(a.minus(c));
    +console.log("e   =" + e);
    +
    +// Big expression
    +f = a.plus(b).times(c.plus(b.times(e))).plus(a.uminus());
    +console.log("f   =" + f);
    +
    +
    +
    +
    +
    diff --git a/Examples/javascript/overload/Makefile b/Examples/javascript/overload/Makefile
    new file mode 100644
    index 0000000..0402f8d
    --- /dev/null
    +++ b/Examples/javascript/overload/Makefile
    @@ -0,0 +1,3 @@
    +SRCS =
    +
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/javascript/overload/binding.gyp.in b/Examples/javascript/overload/binding.gyp.in
    new file mode 100644
    index 0000000..59779ae
    --- /dev/null
    +++ b/Examples/javascript/overload/binding.gyp.in
    @@ -0,0 +1,9 @@
    +{
    +  "targets": [
    +    {
    +      "target_name": "example",
    +      "sources": [ "example_wrap.cxx" ],
    +      "include_dirs": ["$srcdir"]
    +    }
    +  ]
    +}
    diff --git a/Examples/javascript/overload/example.h b/Examples/javascript/overload/example.h
    new file mode 100644
    index 0000000..2f112f1
    --- /dev/null
    +++ b/Examples/javascript/overload/example.h
    @@ -0,0 +1,28 @@
    +#include 
    +
    +void f() {
    +  std::cout << "Called f()." << std::endl;
    +}
    +
    +void f(int val) {
    +  std::cout << "Called f(int)." << std::endl;
    +}
    +void f(int val1, int val2) {
    +  std::cout << "Called f(int, int)." << std::endl;
    +}
    +
    +void f(const char* s) {
    +  std::cout << "Called f(const char*)." << std::endl;
    +}
    +
    +void f(bool val) {
    +  std::cout << "Called f(bool)." << std::endl;
    +}
    +
    +void f(long val) {
    +  std::cout << "Called f(long)." << std::endl;
    +}
    +
    +void f(double val) {
    +  std::cout << "Called f(double)." << std::endl;
    +}
    diff --git a/Examples/javascript/overload/example.i b/Examples/javascript/overload/example.i
    new file mode 100644
    index 0000000..b86689f
    --- /dev/null
    +++ b/Examples/javascript/overload/example.i
    @@ -0,0 +1,16 @@
    +/* File : example.i */
    +%module example
    +
    +%{
    +#include "example.h"
    +%}
    +
    +/*
    +  Note: overloading is implemented in a sloppy way currently
    +        i.e., only the number of arguments is taken into conideration
    +        for dispatching.
    +        To solve the problem one has to rename such conflicting methods.
    +*/
    +%rename(f_double) f(double val);
    +
    +%include "example.h"
    diff --git a/Examples/javascript/overload/example.js b/Examples/javascript/overload/example.js
    new file mode 100644
    index 0000000..2e7f83a
    --- /dev/null
    +++ b/Examples/javascript/overload/example.js
    @@ -0,0 +1 @@
    +module.exports = require("build/Release/example");
    diff --git a/Examples/javascript/overload/runme.js b/Examples/javascript/overload/runme.js
    new file mode 100644
    index 0000000..1c23e3b
    --- /dev/null
    +++ b/Examples/javascript/overload/runme.js
    @@ -0,0 +1,9 @@
    +var example = require("example");
    +
    +example.f();
    +example.f(1);
    +example.f(1, 2);
    +example.f("bla");
    +example.f(false);
    +example.f(11111111111);
    +example.f_double(1.0);
    diff --git a/Examples/javascript/pointer/Makefile b/Examples/javascript/pointer/Makefile
    new file mode 100644
    index 0000000..54a8f7b
    --- /dev/null
    +++ b/Examples/javascript/pointer/Makefile
    @@ -0,0 +1,3 @@
    +SRCS = example.cxx
    +
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/javascript/pointer/binding.gyp.in b/Examples/javascript/pointer/binding.gyp.in
    new file mode 100644
    index 0000000..cb2b45e
    --- /dev/null
    +++ b/Examples/javascript/pointer/binding.gyp.in
    @@ -0,0 +1,9 @@
    +{
    +  "targets": [
    +    {
    +      "target_name": "example",
    +      "sources": [ " 0) {
    +    g = x;
    +    x = y % x;
    +    y = g;
    +  }
    +  return g;
    +}
    +
    +
    diff --git a/Examples/javascript/simple/example.i b/Examples/javascript/simple/example.i
    new file mode 100644
    index 0000000..24093b9
    --- /dev/null
    +++ b/Examples/javascript/simple/example.i
    @@ -0,0 +1,7 @@
    +/* File : example.i */
    +%module example
    +
    +%inline %{
    +extern int    gcd(int x, int y);
    +extern double Foo;
    +%}
    diff --git a/Examples/javascript/simple/example.js b/Examples/javascript/simple/example.js
    new file mode 100644
    index 0000000..2e7f83a
    --- /dev/null
    +++ b/Examples/javascript/simple/example.js
    @@ -0,0 +1 @@
    +module.exports = require("build/Release/example");
    diff --git a/Examples/javascript/simple/runme.js b/Examples/javascript/simple/runme.js
    new file mode 100644
    index 0000000..4abff0e
    --- /dev/null
    +++ b/Examples/javascript/simple/runme.js
    @@ -0,0 +1,26 @@
    +var example = require("example");
    +
    +/* Call our gcd() function */
    +
    +x = 42;
    +y = 105;
    +g = example.gcd(x,y);
    +console.log("GCD of x and y is=" + g);
    +
    +/* Manipulate the Foo global variable */
    +
    +/* Output its current value */
    +console.log("Global variable Foo=" + example.Foo);
    +
    +/* Change its value */
    +example.Foo = 3.1415926;
    +
    +/* See if the change took effect */
    +console.log("Variable Foo changed to=" + example.Foo);
    +
    +
    +
    +
    + 
    + 
    + 
    diff --git a/Examples/javascript/template/Makefile b/Examples/javascript/template/Makefile
    new file mode 100644
    index 0000000..0402f8d
    --- /dev/null
    +++ b/Examples/javascript/template/Makefile
    @@ -0,0 +1,3 @@
    +SRCS =
    +
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/javascript/template/binding.gyp.in b/Examples/javascript/template/binding.gyp.in
    new file mode 100644
    index 0000000..59779ae
    --- /dev/null
    +++ b/Examples/javascript/template/binding.gyp.in
    @@ -0,0 +1,9 @@
    +{
    +  "targets": [
    +    {
    +      "target_name": "example",
    +      "sources": [ "example_wrap.cxx" ],
    +      "include_dirs": ["$srcdir"]
    +    }
    +  ]
    +}
    diff --git a/Examples/javascript/template/example.h b/Examples/javascript/template/example.h
    new file mode 100644
    index 0000000..7401df6
    --- /dev/null
    +++ b/Examples/javascript/template/example.h
    @@ -0,0 +1,32 @@
    +/* File : example.h */
    +
    +// Some template definitions
    +
    +template T max(T a, T b) { return  a>b ? a : b; }
    +
    +template class vector {
    +  T *v;
    +  int sz;
    + public:
    +  vector(int _sz) {
    +    v = new T[_sz];
    +    sz = _sz;
    +  }
    +  T &get(int index) {
    +    return v[index];
    +  }
    +  void set(int index, T &val) {
    +    v[index] = val;
    +  }
    +#ifdef SWIG
    +  %extend {
    +    T getitem(int index) {
    +      return $self->get(index);
    +    }
    +    void setitem(int index, T val) {
    +      $self->set(index,val);
    +    }
    +  }
    +#endif
    +};
    +
    diff --git a/Examples/javascript/template/example.i b/Examples/javascript/template/example.i
    new file mode 100644
    index 0000000..8f94c4d
    --- /dev/null
    +++ b/Examples/javascript/template/example.i
    @@ -0,0 +1,17 @@
    +/* File : example.i */
    +%module example
    +
    +%{
    +#include "example.h"
    +%}
    +
    +/* Let's just grab the original header file here */
    +%include "example.h"
    +
    +/* Now instantiate some specific template declarations */
    +
    +%template(maxint) max;
    +%template(maxdouble) max;
    +%template(vecint) vector;
    +%template(vecdouble) vector;
    +
    diff --git a/Examples/javascript/template/example.js b/Examples/javascript/template/example.js
    new file mode 100644
    index 0000000..2e7f83a
    --- /dev/null
    +++ b/Examples/javascript/template/example.js
    @@ -0,0 +1 @@
    +module.exports = require("build/Release/example");
    diff --git a/Examples/javascript/template/runme.js b/Examples/javascript/template/runme.js
    new file mode 100644
    index 0000000..6a29fa7
    --- /dev/null
    +++ b/Examples/javascript/template/runme.js
    @@ -0,0 +1,30 @@
    +var example = require("example");
    +
    +//Call some templated functions
    +console.log(example.maxint(3,7));
    +console.log(example.maxdouble(3.14,2.18));
    +
    +// Create some class
    +
    +iv = new example.vecint(100);
    +dv = new example.vecdouble(1000);
    +
    +for(i=0;i<100;i++)
    +      iv.setitem(i,2*i);
    +
    +for(i=0;i<1000;i++)
    +      dv.setitem(i, 1.0/(i+1));
    +
    +sum = 0;
    +for(i=0;i<100;i++)
    +      sum = sum + iv.getitem(i);
    +
    +console.log(sum);
    +
    +sum = 0.0;
    +for(i=0;i<1000;i++)
    +      sum = sum + dv.getitem(i);
    +console.log(sum);
    +
    +delete iv;
    +delete dv;
    diff --git a/Examples/javascript/variables/Makefile b/Examples/javascript/variables/Makefile
    new file mode 100644
    index 0000000..54a8f7b
    --- /dev/null
    +++ b/Examples/javascript/variables/Makefile
    @@ -0,0 +1,3 @@
    +SRCS = example.cxx
    +
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/javascript/variables/binding.gyp.in b/Examples/javascript/variables/binding.gyp.in
    new file mode 100644
    index 0000000..cb2b45e
    --- /dev/null
    +++ b/Examples/javascript/variables/binding.gyp.in
    @@ -0,0 +1,9 @@
    +{
    +  "targets": [
    +    {
    +      "target_name": "example",
    +      "sources": [ "
    +#include 
    +#include "example.h"
    +
    +int              ivar = 0;                    
    +short            svar = 0;
    +long             lvar = 0;
    +unsigned int     uivar = 0;
    +unsigned short   usvar = 0;
    +unsigned long    ulvar = 0;
    +signed char      scvar = 0;
    +unsigned char    ucvar = 0;
    +char             cvar = 0;
    +float            fvar = 0;
    +double           dvar = 0;
    +char            *strvar = 0;
    +#ifdef __cplusplus // Note: for v8 this must be linkable with g++, without extern cstrvar is mangled
    +extern const char cstrvar[] = "Goodbye";
    +#else
    +const char cstrvar[] = "Goodbye";
    +#endif
    +const 
    +int             *iptrvar = 0;
    +char             name[256] = "Dave";
    +char             path[256] = "/home/beazley";
    +
    +
    +/* Global variables involving a structure */
    +Point           *ptptr = 0;
    +Point            pt = { 10, 20 };
    +
    +/* A variable that we will make read-only in the interface */
    +int              status = 1;
    +
    +/* A debugging function to print out their values */
    +
    +void print_vars() {
    +  printf("ivar      = %d\n", ivar);
    +  printf("svar      = %d\n", svar);
    +  printf("lvar      = %ld\n", lvar);
    +  printf("uivar     = %u\n", uivar);
    +  printf("usvar     = %u\n", usvar);
    +  printf("ulvar     = %lu\n", ulvar);
    +  printf("scvar     = %d\n", scvar);
    +  printf("ucvar     = %u\n", ucvar);
    +  printf("fvar      = %g\n", fvar);
    +  printf("dvar      = %g\n", dvar);
    +  printf("cvar      = %c\n", cvar);
    +  printf("strvar    = %s\n", strvar ? strvar : "(null)");
    +  printf("cstrvar   = %s\n", cstrvar);
    +  printf("iptrvar   = %p\n", (void *)iptrvar);
    +  printf("name      = %s\n", name);
    +  printf("ptptr     = %p (%d, %d)\n", (void *)ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0);
    +  printf("pt        = (%d, %d)\n", pt.x, pt.y);
    +  printf("status    = %d\n", status);
    +}
    +
    +/* A function to create an integer (to test iptrvar) */
    +
    +int *new_int(int value) {
    +  int *ip = (int *) malloc(sizeof(int));
    +  *ip = value;
    +  return ip;
    +}
    +
    +/* A function to create a point */
    +
    +Point *new_Point(int x, int y) {
    +  Point *p = (Point *) malloc(sizeof(Point));
    +  p->x = x;
    +  p->y = y;
    +  return p;
    +}
    +
    +char * Point_print(Point *p) {
    +  static char buffer[256];
    +  if (p) {
    +    sprintf(buffer,"(%d,%d)", p->x,p->y);
    +  } else {
    +    sprintf(buffer,"null");
    +  }
    +  return buffer;
    +}
    +
    +void pt_print() {
    +  printf("(%d, %d)\n", pt.x, pt.y);
    +}
    diff --git a/Examples/javascript/variables/example.h b/Examples/javascript/variables/example.h
    new file mode 100644
    index 0000000..0f7e895
    --- /dev/null
    +++ b/Examples/javascript/variables/example.h
    @@ -0,0 +1,6 @@
    +/* File: example.h */
    +
    +typedef struct {
    +  int x,y;
    +} Point;
    +
    diff --git a/Examples/javascript/variables/example.i b/Examples/javascript/variables/example.i
    new file mode 100644
    index 0000000..591b871
    --- /dev/null
    +++ b/Examples/javascript/variables/example.i
    @@ -0,0 +1,49 @@
    +/* File : example.i */
    +%module example
    +%{
    +#include "example.h"
    +%}
    +
    +/* Some global variable declarations */
    +%inline %{
    +extern int              ivar;
    +extern short            svar;
    +extern long             lvar;
    +extern unsigned int     uivar;
    +extern unsigned short   usvar;
    +extern unsigned long    ulvar;
    +extern signed char      scvar;
    +extern unsigned char    ucvar;
    +extern char             cvar;
    +extern float            fvar;
    +extern double           dvar;
    +extern char            *strvar;
    +extern const char       cstrvar[];
    +extern int             *iptrvar;
    +extern char             name[256];
    +
    +extern Point           *ptptr;
    +extern Point            pt;
    +%}
    +
    +
    +/* Some read-only variables */
    +
    +%immutable;
    +
    +%inline %{
    +extern int  status;
    +extern char path[256];
    +%}
    +
    +%mutable;
    +
    +/* Some helper functions to make it easier to test */
    +%inline %{
    +extern void  print_vars();
    +extern int  *new_int(int value);
    +extern Point *new_Point(int x, int y);
    +extern char  *Point_print(Point *p);
    +extern void  pt_print();
    +%}
    +
    diff --git a/Examples/javascript/variables/example.js b/Examples/javascript/variables/example.js
    new file mode 100644
    index 0000000..2e7f83a
    --- /dev/null
    +++ b/Examples/javascript/variables/example.js
    @@ -0,0 +1 @@
    +module.exports = require("build/Release/example");
    diff --git a/Examples/javascript/variables/runme.js b/Examples/javascript/variables/runme.js
    new file mode 100644
    index 0000000..a2b5f79
    --- /dev/null
    +++ b/Examples/javascript/variables/runme.js
    @@ -0,0 +1,68 @@
    +var example = require("example");
    +
    +// Try to set the values of some global variables
    +example.ivar   =  42;
    +example.svar   = -31000;
    +example.lvar   =  65537;
    +example.uivar  =  123456;
    +example.usvar  =  61000;
    +example.ulvar  =  654321;
    +example.scvar  =  -13;
    +example.ucvar  =  251;
    +example.cvar   =  "S";
    +example.fvar   =  3.14159;
    +example.dvar   =  2.1828;
    +example.strvar =  "Hello World";
    +example.iptrvar= example.new_int(37);
    +example.ptptr  = example.new_Point(37,42);
    +example.name   = "Bill";
    +
    +// Now console.log out the values of the variables
    +console.log("Variables (values printed from Javascript)");
    +console.log("ivar      = " + example.ivar);
    +console.log("svar      = " + example.svar);
    +console.log("lvar      = " + example.lvar);
    +console.log("uivar     = " + example.uivar);
    +console.log("usvar     = " + example.usvar);
    +console.log("ulvar     = " + example.ulvar);
    +console.log("scvar     = " + example.scvar);
    +console.log("ucvar     = " + example.ucvar);
    +console.log("fvar      = " + example.fvar);
    +console.log("dvar      = " + example.dvar);
    +console.log("cvar      = " + example.cvar);
    +console.log("strvar    = " + example.strvar);
    +console.log("cstrvar   = " + example.cstrvar);
    +console.log("iptrvar   = " + example.iptrvar);
    +console.log("name      = " + example.name);
    +console.log("ptptr     = " + example.ptptr + ": " + example.Point_print(example.ptptr));
    +console.log("pt        = " + example.pt + ": " + example.Point_print(example.pt));
    +
    +
    +console.log("\nVariables (values printed from C)");
    +
    +example.print_vars();
    +
    +console.log("\nNow I'm going to try and modify some read only variables");
    +
    +console.log("Tring to set 'path'");
    +try{
    +    example.path = "Whoa!";
    +    console.log("Hey, what's going on?!?! This shouldn't work");
    +}
    +catch(e){
    +    console.log("Good.");
    +}
    +
    +console.log("Trying to set 'status'");
    +try{
    +    example.status = 0;
    +    console.log("Hey, what's going on?!?! This shouldn't work");
    +} catch(e){
    +    console.log("Good.");
    +}
    +
    +console.log("\nI'm going to try and update a structure variable.");
    +example.pt = example.ptptr;
    +console.log("The new value is: ");
    +example.pt_print();
    +console.log("You should see the value: " + example.Point_print(example.ptptr));
    diff --git a/Examples/lua/arrays/Makefile b/Examples/lua/arrays/Makefile
    index d398dff..70de9c4 100644
    --- a/Examples/lua/arrays/Makefile
    +++ b/Examples/lua/arrays/Makefile
    @@ -1,19 +1,22 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     SRCS       = example.c
     TARGET     = example
     INTERFACE  = example.i
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile lua_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' lua
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='mylua' INTERFACE='$(INTERFACE)' lua_static
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile lua_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_clean
    diff --git a/Examples/lua/arrays/example.c b/Examples/lua/arrays/example.c
    index ed23738..da1bd75 100644
    --- a/Examples/lua/arrays/example.c
    +++ b/Examples/lua/arrays/example.c
    @@ -13,7 +13,7 @@ void sort_int(int* arr, int len)
       qsort(arr, len, sizeof(int), compare_int);
     }
     
    -// ditto doubles
    +/* ditto doubles */
     int compare_double(const void * a, const void * b)
     {
       return (int)( *(double*)a - *(double*)b );
    diff --git a/Examples/lua/arrays/example.i b/Examples/lua/arrays/example.i
    index 3d5b60d..eafd8ff 100644
    --- a/Examples/lua/arrays/example.i
    +++ b/Examples/lua/arrays/example.i
    @@ -14,18 +14,19 @@ See the lua code for how they are called
     
     // this adds some lua code directly into the module
     // warning: you need the example. prefix if you want it added into the module
    -// addmittedly this code is a bit tedious, but its a one off effort
    +// admittedly this code is a bit tedious, but its a one off effort
     %luacode {
     function example.sort_int2(t)
    - local len=table.maxn(t) -- the len
    +-- local len=table.maxn(t) -- the len - maxn deprecated in 5.3
    + local len=0; for _ in pairs(t) do len=len+1 end
      local arr=example.new_int(len)
      for i=1,len do
    -  example.int_setitem(arr,i-1,t[i]) -- note: C index is one less then lua indea
    +  example.int_setitem(arr,i-1,t[i]) -- note: C index is one less then lua index
      end
      example.sort_int(arr,len) -- call the fn
      -- copy back
      for i=1,len do
    -  t[i]=example.int_getitem(arr,i-1) -- note: C index is one less then lua indea
    +  t[i]=example.int_getitem(arr,i-1) -- note: C index is one less then lua index
      end
      example.delete_int(arr) -- must delete it
     end
    diff --git a/Examples/lua/arrays/runme.lua b/Examples/lua/arrays/runme.lua
    index 7ab6dc4..d0aa998 100644
    --- a/Examples/lua/arrays/runme.lua
    +++ b/Examples/lua/arrays/runme.lua
    @@ -25,7 +25,7 @@ math.randomseed(0)  -- init random
     
     
     --[[ version 1: passing a C array to the code
    -lets test call sort_int()
    +let's test call sort_int()
     this requires a C array, so is the hardest to use]]
     ARRAY_SIZE=10
     arr=example.new_int(ARRAY_SIZE)
    diff --git a/Examples/lua/check.list b/Examples/lua/check.list
    index 6862e44..87dfdcd 100644
    --- a/Examples/lua/check.list
    +++ b/Examples/lua/check.list
    @@ -11,6 +11,7 @@ funcptr3
     functest
     functor
     import
    +nspace
     owner
     pointer
     simple
    diff --git a/Examples/lua/class/Makefile b/Examples/lua/class/Makefile
    index c39e8ac..dd78fdb 100644
    --- a/Examples/lua/class/Makefile
    +++ b/Examples/lua/class/Makefile
    @@ -1,20 +1,23 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     CXXSRCS    = example.cxx
     TARGET     = example
     INTERFACE  = example.i
     LIBS       = -lm
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile lua_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' lua_cpp
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='mylua' INTERFACE='$(INTERFACE)' lua_cpp_static
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile lua_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_clean
    diff --git a/Examples/lua/class/example.cxx b/Examples/lua/class/example.cxx
    index 1e8e203..0463045 100644
    --- a/Examples/lua/class/example.cxx
    +++ b/Examples/lua/class/example.cxx
    @@ -1,4 +1,4 @@
    -/* File : example.c */
    +/* File : example.cxx */
     
     #include "example.h"
     #define M_PI 3.14159265358979323846
    @@ -11,18 +11,18 @@ void Shape::move(double dx, double dy) {
     
     int Shape::nshapes = 0;
     
    -double Circle::area(void) {
    +double Circle::area() {
       return M_PI*radius*radius;
     }
     
    -double Circle::perimeter(void) {
    +double Circle::perimeter() {
       return 2*M_PI*radius;
     }
     
    -double Square::area(void) {
    +double Square::area() {
       return width*width;
     }
     
    -double Square::perimeter(void) {
    +double Square::perimeter() {
       return 4*width;
     }
    diff --git a/Examples/lua/class/example.h b/Examples/lua/class/example.h
    index 46d9013..0dff185 100644
    --- a/Examples/lua/class/example.h
    +++ b/Examples/lua/class/example.h
    @@ -7,11 +7,11 @@ public:
       }
       virtual ~Shape() {
         nshapes--;
    -  };
    -  double  x, y;   
    +  }
    +  double  x, y;
       void    move(double dx, double dy);
    -  virtual double area(void) = 0;
    -  virtual double perimeter(void) = 0;
    +  virtual double area() = 0;
    +  virtual double perimeter() = 0;
       static  int nshapes;
     };
     
    @@ -19,21 +19,16 @@ class Circle : public Shape {
     private:
       double radius;
     public:
    -  Circle(double r) : radius(r) { };
    -  virtual double area(void);
    -  virtual double perimeter(void);
    +  Circle(double r) : radius(r) { }
    +  virtual double area();
    +  virtual double perimeter();
     };
     
     class Square : public Shape {
     private:
       double width;
     public:
    -  Square(double w) : width(w) { };
    -  virtual double area(void);
    -  virtual double perimeter(void);
    +  Square(double w) : width(w) { }
    +  virtual double area();
    +  virtual double perimeter();
     };
    -
    -
    -
    -
    -  
    diff --git a/Examples/lua/class/example.i b/Examples/lua/class/example.i
    index 75700b3..fbdf724 100644
    --- a/Examples/lua/class/example.i
    +++ b/Examples/lua/class/example.i
    @@ -7,4 +7,3 @@
     
     /* Let's just grab the original header file here */
     %include "example.h"
    -
    diff --git a/Examples/lua/class/runme.lua b/Examples/lua/class/runme.lua
    index 2c3ad8c..5d140de 100644
    --- a/Examples/lua/class/runme.lua
    +++ b/Examples/lua/class/runme.lua
    @@ -53,7 +53,6 @@ print("\nGuess I'll clean up now")
     -- Note: this invokes the virtual destructor
     c=nil
     s=nil
    -s = 3
     
     -- call gc to make sure they are collected
     collectgarbage()
    diff --git a/Examples/lua/constants/Makefile b/Examples/lua/constants/Makefile
    index 51b83be..979dc7d 100644
    --- a/Examples/lua/constants/Makefile
    +++ b/Examples/lua/constants/Makefile
    @@ -1,20 +1,23 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -CXXSRCS    = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +CXXSRCS    =
     TARGET     = example
     INTERFACE  = example.i
    -LIBS       = 
    +LIBS       =
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile lua_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' lua
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='mylua' INTERFACE='$(INTERFACE)' lua_static
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile lua_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_clean
    diff --git a/Examples/lua/dual/Makefile b/Examples/lua/dual/Makefile
    index 12ee00a..53b28b6 100644
    --- a/Examples/lua/dual/Makefile
    +++ b/Examples/lua/dual/Makefile
    @@ -1,21 +1,27 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     TARGET     = dual
    -CXXSRCS    = example2_wrap.cxx
    +GENCXXSRCS = example2_wrap.cxx
     INTERFACE  = dual.i
     LUA_INTERP = dual.cpp
     
     # This is a little different to normal as we need to static link two modules and a custom interpreter
     # We need the external runtime, then swig examples2, and build the module as normal
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' lua_embed_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' lua_embed_run
     
     build:
    -	$(SWIG) -lua -external-runtime
    -	$(SWIG) -c++ -lua $(SWIGOPT) example2.i
    -	$(MAKE) -f $(TOP)/Makefile $(SWIGLIB) CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	lua_externalhdr
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	SWIGOPT='-c++' INTERFACE='example2.i' lua_swig_cpp
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' $(SWIGLIB) GENCXXSRCS='$(GENCXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='example.i' LUA_INTERP='$(LUA_INTERP)' lua_static_cpp
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile lua_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_clean
     	rm -f swigluarun.h $(TARGET)
    diff --git a/Examples/lua/dual/dual.cpp b/Examples/lua/dual/dual.cpp
    index d2a9eca..2108a72 100644
    --- a/Examples/lua/dual/dual.cpp
    +++ b/Examples/lua/dual/dual.cpp
    @@ -1,7 +1,7 @@
     /*
    -dual.cpp a test for multiple modules and multiple intrepreters staticly linked together.
    +dual.cpp a test for multiple modules and multiple interpreters statically linked together.
     
    -Earlier version of lua bindings for SWIG would fail if staticly linked.
    +Earlier version of lua bindings for SWIG would fail if statically linked.
     
     What is happening is as follows:
     example.i declares a type Foo
    @@ -28,7 +28,7 @@ both Foo and Bar.
     #include 
     #include 
     
    -// the 2 libraries which are wrappered via SWIG
    +// the 2 libraries which are wrapped via SWIG
     extern "C" int luaopen_example(lua_State*L);
     extern "C" int luaopen_example2(lua_State*L);
     
    @@ -36,19 +36,23 @@ extern "C" int luaopen_example2(lua_State*L);
     #define DEBUG2(X,Y) {printf(X,Y);fflush(stdout);}
     #define DEBUG3(X,Y,Z) {printf(X,Y,Z);fflush(stdout);}
     
    +#if LUA_VERSION_NUM > 501
    +#define lua_open luaL_newstate
    +#endif
    +
     void testModule(lua_State *L)
     {
       swig_type_info *pTypeInfo=0,*pTypeInfo2=0;
       swig_module_info *pModule=0;
       pModule=SWIG_GetModule(L);
    -  DEBUG2("  SWIG_GetModule() returns %p\n",pModule)
    +  DEBUG2("  SWIG_GetModule() returns %p\n", (void *)pModule)
       if(pModule==0) return;
       pTypeInfo = SWIG_TypeQuery(L,"Foo *");
       DEBUG2("  Type (Foo*) is %s\n",pTypeInfo==0?"unknown":"known");
    -  DEBUG3("    Module %p typeinfo(Foo*) %p\n",pModule,pTypeInfo);
    +  DEBUG3("    Module %p typeinfo(Foo*) %p\n", (void *)pModule, (void *)pTypeInfo);
       pTypeInfo2 = SWIG_TypeQuery(L,"Bar *");
       DEBUG2("  Type (Bar*) is %s\n",pTypeInfo2==0?"unknown":"known");
    -  DEBUG3("    Module %p typeinfo(Bar*) %p\n",pModule,pTypeInfo2);
    +  DEBUG3("    Module %p typeinfo(Bar*) %p\n", (void *)pModule, (void *)pTypeInfo2);
     }
     
     int main(int argc,char* argv[])
    diff --git a/Examples/lua/embed/Makefile b/Examples/lua/embed/Makefile
    index df1f8fa..7f40544 100644
    --- a/Examples/lua/embed/Makefile
    +++ b/Examples/lua/embed/Makefile
    @@ -1,19 +1,22 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     TARGET     = embed
     SRCS       = example.c
     INTERFACE  = example.i
     LUA_INTERP = embed.c
    +LIBS       = -lm
     
     # this is a little different to normal as we have our own special interpreter
     # which we want to static link
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' lua_embed_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' lua_embed_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile $(SWIGLIB) SRCS='$(SRCS)' SWIG='$(SWIG)' \
    -	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='example.i' LUA_INTERP='$(LUA_INTERP)' lua_static
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' $(SWIGLIB) SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' LIBS='$(LIBS)' INTERFACE='example.i' LUA_INTERP='$(LUA_INTERP)' lua_static
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile lua_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_clean
     	rm -f $(TARGET)
    diff --git a/Examples/lua/embed/embed.c b/Examples/lua/embed/embed.c
    index 9df168f..1f10cc8 100644
    --- a/Examples/lua/embed/embed.c
    +++ b/Examples/lua/embed/embed.c
    @@ -1,9 +1,9 @@
    -/* embed.c a simple test for an embeded interpreter
    +/* embed.c a simple test for an embedded interpreter
      
     The idea is that we wrapper a few simple function (example.c)
     and write our own app to call it.
      
    -What it will do is load the wrappered lib, load runme.lua and then call some functions.
    +What it will do is load the wrapped lib, load runme.lua and then call some functions.
     To make life easier, all the printf's have either [C] or [Lua] at the start
     so you can see where they are coming from.
      
    @@ -13,19 +13,24 @@ We will be using the luaL_dostring()/lua_dostring() function to call into lua
     
     #include 
     #include 
    +#include 
     
     #include 
     #include 
     #include 
     
    +#if LUA_VERSION_NUM > 501
    +#define lua_open luaL_newstate
    +#endif
    +
     /* the SWIG wrappered library */
     extern int luaopen_example(lua_State*L);
     
     /* a really simple way of calling lua from C
      just give it a lua state & a string to execute
     Unfortunately lua keeps changing its API's.
    -In lua 5.0.X its lua_dostring()
    -In lua 5.1.X its luaL_dostring()
    +In lua 5.0.X it's lua_dostring()
    +In lua 5.1.X it's luaL_dostring()
     so we have a few extra compiles
     */
     int dostring(lua_State *L, char* str) {
    @@ -54,28 +59,32 @@ int main(int argc,char* argv[]) {
       luaopen_base(L);
       luaopen_string(L);
       luaopen_math(L);
    -  printf("[C] now loading the SWIG wrappered library\n");
    +  printf("[C] now loading the SWIG wrapped library\n");
       luaopen_example(L);
       printf("[C] all looks ok\n");
       printf("\n");
    -  printf("[C] lets load the file 'runme.lua'\n");
    +  if (argc != 2 || argv[1] == NULL || strlen(argv[1]) == 0) {
    +    printf("[C] ERROR: no lua file given on command line\n");
    +    exit(3);
    +  }
    +  printf("[C] let's load the file '%s'\n", argv[1]);
       printf("[C] any lua code in this file will be executed\n");
    -  if (luaL_loadfile(L, "runme.lua") || lua_pcall(L, 0, 0, 0)) {
    +  if (luaL_loadfile(L, argv[1]) || lua_pcall(L, 0, 0, 0)) {
         printf("[C] ERROR: cannot run lua file: %s",lua_tostring(L, -1));
         exit(3);
       }
       printf("[C] We are now back in C, all looks ok\n");
       printf("\n");
    -  printf("[C] lets call the function 'do_tests()'\n");
    +  printf("[C] let's call the function 'do_tests()'\n");
       ok=dostring(L,"do_tests()");
       printf("[C] We are back in C, the dostring() function returned %d\n",ok);
       printf("\n");
    -  printf("[C] Lets call lua again, but create an error\n");
    +  printf("[C] Let's call lua again, but create an error\n");
       ok=dostring(L,"no_such_function()");
       printf("[C] We are back in C, the dostring() function returned %d\n",ok);
       printf("[C] it should also have returned 1 and printed an error message\n");
       printf("\n");
    -  printf("[C] Lets call lua again, calling the greeting function\n");
    +  printf("[C] Let's call lua again, calling the greeting function\n");
       ok=dostring(L,"call_greeting()");
       printf("[C] This was C=>Lua=>C (getting a bit complex)\n");
       printf("\n");
    diff --git a/Examples/lua/embed/runme.lua b/Examples/lua/embed/runme.lua
    index e02fd1d..a75f740 100644
    --- a/Examples/lua/embed/runme.lua
    +++ b/Examples/lua/embed/runme.lua
    @@ -1,7 +1,7 @@
     print "[lua] This is runme.lua"
    --- test program for embeded lua
    --- we do not need to load the library, as it was already in the intrepreter
    --- but lets check anyway
    +-- test program for embedded lua
    +-- we do not need to load the library, as it was already in the interpreter
    +-- but let's check anyway
     assert(type(example)=='table',"Don't appear to have loaded the example module")
     
     -- a test function to run the tests
    diff --git a/Examples/lua/embed2/Makefile b/Examples/lua/embed2/Makefile
    index fc309ac..28d9682 100644
    --- a/Examples/lua/embed2/Makefile
    +++ b/Examples/lua/embed2/Makefile
    @@ -1,19 +1,22 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     TARGET     = embed2
     SRCS       = example.c
     INTERFACE  = example.i
     LUA_INTERP = embed2.c
    +LIBS       = -lm
     
     # this is a little different to normal as we have our own special interpreter
     # which we want to static link
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' lua_embed_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' lua_embed_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile $(SWIGLIB) SRCS='$(SRCS)' SWIG='$(SWIG)' \
    -	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='example.i' LUA_INTERP='$(LUA_INTERP)' lua_static
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' $(SWIGLIB) SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' LIBS='$(LIBS)' INTERFACE='example.i' LUA_INTERP='$(LUA_INTERP)' lua_static
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile lua_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_clean
     	rm -f $(TARGET)
    diff --git a/Examples/lua/embed2/embed2.c b/Examples/lua/embed2/embed2.c
    index 8d28ee6..0ce9f8f 100644
    --- a/Examples/lua/embed2/embed2.c
    +++ b/Examples/lua/embed2/embed2.c
    @@ -1,9 +1,9 @@
    -/* embed2.c some more test for an embeded interpreter
    +/* embed2.c some more tests for an embedded interpreter
      
     This will go a bit further as it will pass values to and from the lua code.
     It uses less of the SWIG code, and more of the raw lua API's
      
    -What it will do is load the wrappered lib, load runme.lua and then call some functions.
    +What it will do is load the wrapped lib, load runme.lua and then call some functions.
     To make life easier, all the printf's have either [C] or [Lua] at the start
     so you can see where they are coming from.
      
    @@ -24,6 +24,7 @@ We will be using the luaL_dostring()/lua_dostring() function to call into lua
     
     #include 
     #include 
    +#include 
     
     #include 
     #include 
    @@ -31,13 +32,16 @@ We will be using the luaL_dostring()/lua_dostring() function to call into lua
     #include 
     #include 
     
    +#if LUA_VERSION_NUM > 501
    +#define lua_open luaL_newstate
    +#endif
     
    -/* the SWIG wrappered library */
    +/* the SWIG wrapped library */
     extern int luaopen_example(lua_State*L);
     
     /* This is an example of how to call the Lua function
         int add(int,int) 
    -  its very tedious, but gives you an idea of the issues involded.
    +  its very tedious, but gives you an idea of the issues involved.
       (look below for a better idea)
     */
     int call_add(lua_State *L,int a,int b,int* res) {
    @@ -46,11 +50,10 @@ int call_add(lua_State *L,int a,int b,int* res) {
       push a, push b, call 'add' check & return res
       */
       top=lua_gettop(L);  /* for later */
    -  lua_pushstring(L, "add");                                  /* function name */
    -  lua_gettable(L, LUA_GLOBALSINDEX);               /* function to be called */
    +  lua_getglobal(L, "add");               /* function to be called */
       if (!lua_isfunction(L,-1)) {
         printf("[C] error: cannot find function 'add'\n");
    -    lua_settop(L,top);  // reset
    +    lua_settop(L,top);
         return 0;
       }
       lua_pushnumber(L,a);
    @@ -58,25 +61,25 @@ int call_add(lua_State *L,int a,int b,int* res) {
       if (lua_pcall(L, 2, 1, 0) != 0)  /* call function with 2 arguments and 1 result */
       {
         printf("[C] error running function `add': %s\n",lua_tostring(L, -1));
    -    lua_settop(L,top);  // reset
    +    lua_settop(L,top);
         return 0;
       }
    -  // check results
    +  /* check results */
       if (!lua_isnumber(L,-1)) {
         printf("[C] error: returned value is not a number\n");
    -    lua_settop(L,top);  // reset
    +    lua_settop(L,top);
         return 0;
       }
       *res=(int)lua_tonumber(L,-1);
       lua_settop(L,top);  /* reset stack */
    -  return 1;   // ok
    +  return 1;
     }
     
     /* This is a variargs call function for calling from C into Lua.
     Original Code from Programming in Lua (PIL) by Roberto Ierusalimschy
     ISBN 85-903798-1-7 
     http://www.lua.org/pil/25.3.html
    -This has been modified slightly to make it compile, and its still a bit rough.
    +This has been modified slightly to make it compile, and it's still a bit rough.
     But it gives the idea of how to make it work.
     */
     int call_va (lua_State *L,const char *func, const char *sig, ...) {
    @@ -187,20 +190,24 @@ int main(int argc,char* argv[]) {
       luaopen_example(L);
       printf("[C] all looks ok\n");
       printf("\n");
    -  printf("[C] lets load the file 'runme.lua'\n");
    +  if (argc != 2 || argv[1] == NULL || strlen(argv[1]) == 0) {
    +    printf("[C] ERROR: no lua file given on command line\n");
    +    exit(3);
    +  }
    +  printf("[C] let's load the file '%s'\n", argv[1]);
       printf("[C] any lua code in this file will be executed\n");
    -  if (luaL_loadfile(L, "runme.lua") || lua_pcall(L, 0, 0, 0)) {
    +  if (luaL_loadfile(L, argv[1]) || lua_pcall(L, 0, 0, 0)) {
         printf("[C] ERROR: cannot run lua file: %s",lua_tostring(L, -1));
         exit(3);
       }
       printf("[C] We are now back in C, all looks ok\n");
       printf("\n");
    -  printf("[C] lets call the Lua function 'add(1,1)'\n");
    +  printf("[C] let's call the Lua function 'add(1,1)'\n");
       printf("[C] using the C function 'call_add'\n");
       ok=call_add(L,1,1,&res);
       printf("[C] the function returned %d with value %d\n",ok,res);
       printf("\n");
    -  printf("[C] lets do this rather easier\n");
    +  printf("[C] let's do this rather easier\n");
       printf("[C] we will call the same Lua function using a generic C function 'call_va'\n");
       ok=call_va(L,"add","ii>i",1,1,&res);
       printf("[C] the function returned %d with value %d\n",ok,res);
    diff --git a/Examples/lua/embed2/runme.lua b/Examples/lua/embed2/runme.lua
    index 73af9c5..6e93164 100644
    --- a/Examples/lua/embed2/runme.lua
    +++ b/Examples/lua/embed2/runme.lua
    @@ -1,27 +1,27 @@
     print "[lua] This is runme.lua"
    --- test program for embeded lua
    --- we do not need to load the library, as it was already in the intrepreter
    --- but lets check anyway
    +-- test program for embedded lua
    +-- we do not need to load the library, as it was already in the interpreter
    +-- but let's check anyway
     assert(type(example)=='table',"Don't appear to have loaded the example module")
    -
    --- note: we will copy the functions from example table into global
    --- this will help us later
    -for k,v in pairs(example) do _G[k]=v end
     
    --- our add function
    +-- note: we will copy the functions from example table into global
    +-- this will help us later
    +for k,v in pairs(example) do _G[k]=v end
    +
    +-- our add function
     -- we will be calling this from C
    -function add(a,b)
    -    print("[lua] this is function add(",a,b,")")
    -    c=a+b
    -    print("[lua] returning",c)
    -    return c
    +function add(a,b)
    +    print("[lua] this is function add(",a,b,")")
    +    c=a+b
    +    print("[lua] returning",c)
    +    return c
     end
     
    -function append(a,b)
    -    print("[lua] this is function append(",a,b,")")
    -    c=a..b
    -    print("[lua] returning",c)
    -    return c
    +function append(a,b)
    +    print("[lua] this is function append(",a,b,")")
    +    c=a..b
    +    print("[lua] returning",c)
    +    return c
     end
     
     
    diff --git a/Examples/lua/embed3/Makefile b/Examples/lua/embed3/Makefile
    index 8cfa974..d8e7c73 100644
    --- a/Examples/lua/embed3/Makefile
    +++ b/Examples/lua/embed3/Makefile
    @@ -1,5 +1,6 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     TARGET     = embed3
     SRCS       = example.cpp
     INTERFACE  = example.i
    @@ -9,13 +10,16 @@ LUA_INTERP = embed3.cpp
     # which we want to static link
     # we also need the external runtime, so we can get access to certain internals of SWIG
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' lua_embed_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' lua_embed_run
     
     build:
    -	$(SWIG) -c++ -lua $(SWIGOPT) -external-runtime swigluarun.h
    -	$(MAKE) -f $(TOP)/Makefile $(SWIGLIB) SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	lua_externalhdr
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='example.i' LUA_INTERP='$(LUA_INTERP)' lua_static_cpp
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile lua_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_clean
     	rm -f swigluarun.h $(TARGET)
    diff --git a/Examples/lua/embed3/embed3.cpp b/Examples/lua/embed3/embed3.cpp
    index e5e0e0a..9be49ad 100644
    --- a/Examples/lua/embed3/embed3.cpp
    +++ b/Examples/lua/embed3/embed3.cpp
    @@ -1,4 +1,4 @@
    -/* embed3.cpp A C++ embeded interpreter
    +/* embed3.cpp A C++ embedded interpreter
      
     This will register a C++ class with Lua, and then call a Lua function
     passing C++ objects to this function.
    @@ -26,15 +26,19 @@ extern "C" {
     #include 
     #include 
     }
    -
    -/* The SWIG external runtime is generated by using.
    -swig -lua -externalruntime swigluarun.h
    -It contains useful function used by SWIG in its wrappering
    -SWIG_TypeQuery() SWIG_NewPointerObj()
    +
    +#if LUA_VERSION_NUM > 501
    +#define lua_open luaL_newstate
    +#endif
    +
    +/* The SWIG external runtime is generated by using.
    +swig -lua -externalruntime swigluarun.h
    +It contains useful function used by SWIG in its wrapper
    +SWIG_TypeQuery() SWIG_NewPointerObj()
     */
     #include "swigluarun.h"   // the SWIG external runtime
     
    -/* the SWIG wrappered library */
    +/* the SWIG wrapped library */
     extern "C" int luaopen_example(lua_State*L);
     
     // the code itself
    @@ -65,8 +69,7 @@ int call_onEvent(lua_State *L, Event e) {
       push a, push b, call 'add' check & return res
       */
       top = lua_gettop(L);  /* for later */
    -  lua_pushstring(L, "onEvent");                                  /* function name */
    -  lua_gettable(L, LUA_GLOBALSINDEX);               /* function to be called */
    +  lua_getglobal(L, "onEvent");               /* function to be called */
       if (!lua_isfunction(L, -1)) {
         printf("[C++] error: cannot find function 'OnEvent'\n");
         lua_settop(L, top);  // reset
    @@ -97,10 +100,10 @@ int main(int argc, char* argv[]) {
       luaopen_example(L);
       printf("[C++] all looks ok\n");
       printf("\n");
    -  printf("[C++] lets create an Engine and pass a pointer to Lua\n");
    +  printf("[C++] let's create an Engine and pass a pointer to Lua\n");
       Engine engine;
       /* this code will pass a pointer into lua, but C++ still owns the object
    -  this is a little tedious, to do, but lets do it
    +  this is a little tedious, to do, but let's do it
       we need to pass the pointer (obviously), the type name 
       and a flag which states if Lua should delete the pointer once its finished with it
       The type name is a class name string which is registered with SWIG
    @@ -110,16 +113,20 @@ int main(int argc, char* argv[]) {
       push_pointer(L,&engine,"Engine *",0);
       lua_setglobal(L, "pEngine");  // set as global variable
     
    -  printf("[C++] now lets load the file 'runme.lua'\n");
    +  if (argc != 2 || argv[1] == NULL || strlen(argv[1]) == 0) {
    +    printf("[C++] ERROR: no lua file given on command line\n");
    +    exit(3);
    +  }
    +  printf("[C++] now let's load the file '%s'\n", argv[1]);
       printf("[C++] any lua code in this file will be executed\n");
    -  if (luaL_loadfile(L, "runme.lua") || lua_pcall(L, 0, 0, 0)) {
    -    printf("[C++] ERROR: cannot run lua file: %s", lua_tostring(L, -1));
    +  if (luaL_loadfile(L, argv[1]) || lua_pcall(L, 0, 0, 0)) {
    +    printf("[C++] ERROR: cannot run lua file: %s",lua_tostring(L, -1));
         exit(3);
       }
       printf("[C++] We are now back in C++, all looks ok\n");
       printf("\n");
     
    -  printf("[C++] Lets call the Lua function onEvent(e)\n");
    +  printf("[C++] Let's call the Lua function onEvent(e)\n");
       printf("[C++] We will give it different events, as we wish\n");
       printf("[C++] Starting with STARTUP\n");
       Event ev;
    diff --git a/Examples/lua/embed3/example.h b/Examples/lua/embed3/example.h
    index 41c13e9..df189e3 100644
    --- a/Examples/lua/embed3/example.h
    +++ b/Examples/lua/embed3/example.h
    @@ -13,7 +13,7 @@ public:
     };
     
     
    -/* We also want to pass some events to Lua, so lets have a few classes
    +/* We also want to pass some events to Lua, so let's have a few classes
     to do this.
     */
     class Event
    diff --git a/Examples/lua/embed3/runme.lua b/Examples/lua/embed3/runme.lua
    index 3a44bd2..8d5b1ea 100644
    --- a/Examples/lua/embed3/runme.lua
    +++ b/Examples/lua/embed3/runme.lua
    @@ -1,7 +1,7 @@
     print "[lua] This is runme.lua"
    --- test program for embeded lua
    --- we do not need to load the library, as it was already in the intrepreter
    --- but lets check anyway
    +-- test program for embedded lua
    +-- we do not need to load the library, as it was already in the interpreter
    +-- but let's check anyway
     
     assert(type(example)=='table',"Don't appear to have loaded the example module. Do not run this file directly, run the embed3 executable")
     
    @@ -13,12 +13,12 @@ else
     end
     
     
    --- the embed program expects a function void onEvent(Event)
    +-- the embedded program expects a function void onEvent(Event)
     -- this is it
     
     function onEvent(e)
         print("[Lua] onEvent with event",e.mType)
    -    -- lets do something with the Engine
    +    -- let's do something with the Engine
         -- nothing clever, but ...
         if e.mType==example.Event_STARTUP then
             pEngine:start()
    diff --git a/Examples/lua/exception/Makefile b/Examples/lua/exception/Makefile
    index 01bee5c..a476f0b 100644
    --- a/Examples/lua/exception/Makefile
    +++ b/Examples/lua/exception/Makefile
    @@ -1,20 +1,23 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -CXXSRCS    = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +CXXSRCS    =
     TARGET     = example
     INTERFACE  = example.i
     LIBS       = -lm
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile lua_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' lua_cpp
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='mylua' INTERFACE='$(INTERFACE)' lua_cpp_static
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile lua_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_clean
    diff --git a/Examples/lua/exception/runme.lua b/Examples/lua/exception/runme.lua
    index d8125ca..a798efc 100644
    --- a/Examples/lua/exception/runme.lua
    +++ b/Examples/lua/exception/runme.lua
    @@ -70,7 +70,7 @@ function b()
         t:message()
     end
     print [[
    -Now lets call function a()
    +Now let's call function a()
      which calls b() 
      which calls into C++
      which will throw an exception!]]
    @@ -80,7 +80,7 @@ if ok then
     else
         print("  call failed with error:",res)
     end
    -print "Now lets do the same using xpcall(a,debug.traceback)"
    +print "Now let's do the same using xpcall(a,debug.traceback)"
     ok,res=xpcall(a,debug.traceback)
     if ok then 
         print "  that worked! Funny"
    diff --git a/Examples/lua/funcptr3/Makefile b/Examples/lua/funcptr3/Makefile
    index 00bfe79..fb363cb 100644
    --- a/Examples/lua/funcptr3/Makefile
    +++ b/Examples/lua/funcptr3/Makefile
    @@ -1,20 +1,23 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     SRCS       = example.c
     TARGET     = example
     INTERFACE  = example.i
    -LIBS       = 
    +LIBS       =
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile lua_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' lua
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='mylua' INTERFACE='$(INTERFACE)' lua_static
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile lua_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_clean
    diff --git a/Examples/lua/functest/Makefile b/Examples/lua/functest/Makefile
    index 00bfe79..fb363cb 100644
    --- a/Examples/lua/functest/Makefile
    +++ b/Examples/lua/functest/Makefile
    @@ -1,20 +1,23 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     SRCS       = example.c
     TARGET     = example
     INTERFACE  = example.i
    -LIBS       = 
    +LIBS       =
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile lua_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' lua
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='mylua' INTERFACE='$(INTERFACE)' lua_static
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile lua_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_clean
    diff --git a/Examples/lua/functest/example.i b/Examples/lua/functest/example.i
    index 631e060..9bb64cb 100644
    --- a/Examples/lua/functest/example.i
    +++ b/Examples/lua/functest/example.i
    @@ -1,13 +1,12 @@
     /* File : example.i */
     %module example
     
    -%include "typemaps.i" // you must have this for the typemaps for ptrs
    -// basic function testing
    -//
    +%include "typemaps.i"
    +
     %inline %{
    -extern int add1(int x, int y);              // return x+y -- basic function test
    -extern void add2(int x, int *INPUT, int *OUTPUT); // *z = x+*y  -- argin and argout test
    -extern int add3(int x, int y, int *OUTPUT);    // return x+y, *z=x-y -- returning 2 values
    -extern void add4(int x, int *INOUT);        // *y += x    -- INOUT dual purpose variable
    +extern int add1(int x, int y);              /* return x+y -- basic function test */
    +extern void add2(int x, int *INPUT, int *OUTPUT); /* *z = x+*y  -- argin and argout test */
    +extern int add3(int x, int y, int *OUTPUT);    /* return x+y, *z=x-y -- returning 2 values */
    +extern void add4(int x, int *INOUT);        /* *y += x    -- INOUT dual purpose variable */
     %}
     
    diff --git a/Examples/lua/functor/Makefile b/Examples/lua/functor/Makefile
    index 9220dfe..1bc860a 100644
    --- a/Examples/lua/functor/Makefile
    +++ b/Examples/lua/functor/Makefile
    @@ -1,21 +1,24 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -CXXSRCS    = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +CXXSRCS    =
     TARGET     = example
     INTERFACE  = example.i
     LIBS       = -lm
    -SWIGOPT    = 
    +SWIGOPT    =
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile lua_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' lua_cpp
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='mylua' INTERFACE='$(INTERFACE)' lua_cpp_static
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile lua_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_clean
    diff --git a/Examples/lua/import.lua b/Examples/lua/import.lua
    index b2a40b0..4a0f0d3 100644
    --- a/Examples/lua/import.lua
    +++ b/Examples/lua/import.lua
    @@ -1,7 +1,7 @@
     -- import
     -- the lua 5.0 loading mechanism is rather poor & relies upon the loadlib() fn
     -- the lua 5.1 loading mechanism is simplicity itself
    --- for now we need a bridge which will use the correct verion
    +-- for now we need a bridge which will use the correct version
     
     function import_5_0(module)
     	-- imports the file into the program
    @@ -10,7 +10,7 @@ function import_5_0(module)
     	-- and look for the fn 'Example_Init()' (note the capitalisation)
     	if rawget(_G,module)~=nil then return end -- module appears to be loaded
     		
    -	-- capitialising the first letter
    +	-- capitalising the first letter
     	local c=string.upper(string.sub(module,1,1))
     	local fnname=c..string.sub(module,2).."_Init"
     	
    @@ -26,7 +26,7 @@ function import_5_0(module)
     	end
     	assert(lib,"error loading module:"..module)
     	
    -	lib() -- execute the function: initalising the lib
    +	lib() -- execute the function: initialising the lib
     	local m=rawget(_G,module)	-- gets the module object
     	assert(m~=nil,"no module table found")
     end
    @@ -39,4 +39,4 @@ if string.sub(_VERSION,1,7)=='Lua 5.0' then
     	import=import_5_0
     else
     	import=import_5_1
    -end
    \ No newline at end of file
    +end
    diff --git a/Examples/lua/import/Makefile b/Examples/lua/import/Makefile
    index 0bf47c1..ff73702 100644
    --- a/Examples/lua/import/Makefile
    +++ b/Examples/lua/import/Makefile
    @@ -1,20 +1,25 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     SWIGOPT    =
     LIBS       =
    - 
    +
     check: build
    -	$(MAKE) -f $(TOP)/Makefile lua_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \
    -	LIBS='$(LIBS)' TARGET='base' INTERFACE='base.i' lua_cpp
    -	$(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \
    -	LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' lua_cpp
    -	$(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \
    -	LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' lua_cpp
    -	$(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \
    -	LIBS='$(LIBS)' TARGET='spam' INTERFACE='spam.i' lua_cpp
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='base' INTERFACE='base.i' lua_cpp
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' lua_cpp
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' lua_cpp
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='spam' INTERFACE='spam.i' lua_cpp
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile lua_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_clean
    diff --git a/Examples/lua/import/README b/Examples/lua/import/README
    index 1a52e3c..af83d29 100644
    --- a/Examples/lua/import/README
    +++ b/Examples/lua/import/README
    @@ -1,36 +1,36 @@
    -This example tests the %import directive and working with multiple modules.
    -
    -Use 'lua runme.lua' to run a test.
    -
    -Overview:
    ----------
    -
    -The example defines 4 different extension modules--each wrapping
    -a separate C++ class.
    -
    -     base.i     -  Base class
    -     foo.i      -  Foo class derived from Base
    -     bar.i      -  Bar class derived from Base
    -     spam.i     -  Spam class derived from Bar
    -
    -Each module uses %import to refer to another module.  For
    -example, the 'foo.i' module uses '%import base.i' to get
    -definitions for its base class.
    -
    -If everything is okay, all of the modules will load properly and
    -type checking will work correctly. Caveat: Some compilers, for example
    -gcc-3.2.x, generate broken vtables with the inline methods in this test.
    -This is not a SWIG problem and can usually be solved with non-inlined
    -destructors compiled into separate shared objects/DLLs.
    -
    -Unix:
    ------
    -- Run make
    -- Run the test as described above
    -
    -Windows:
    +This example tests the %import directive and working with multiple modules.
    +
    +Use 'lua runme.lua' to run a test.
    +
    +Overview:
    +---------
    +
    +The example defines 4 different extension modules--each wrapping
    +a separate C++ class.
    +
    +     base.i     -  Base class
    +     foo.i      -  Foo class derived from Base
    +     bar.i      -  Bar class derived from Base
    +     spam.i     -  Spam class derived from Bar
    +
    +Each module uses %import to refer to another module.  For
    +example, the 'foo.i' module uses '%import base.i' to get
    +definitions for its base class.
    +
    +If everything is okay, all of the modules will load properly and
    +type checking will work correctly. Caveat: Some compilers, for example
    +gcc-3.2.x, generate broken vtables with the inline methods in this test.
    +This is not a SWIG problem and can usually be solved with non-inlined
    +destructors compiled into separate shared objects/DLLs.
    +
    +Unix:
    +-----
    +- Run make
    +- Run the test as described above
    +
    +Windows:
     --------
     Sorry, no files here.
    -If you know how, you could copy the python or ruby example dsw & dsp and try editing that
    +If you know how, you could copy the python or ruby example dsw & dsp and try editing that
    +
     
    -
    diff --git a/Examples/lua/import/base.h b/Examples/lua/import/base.h
    index fec0f32..ff6fecd 100644
    --- a/Examples/lua/import/base.h
    +++ b/Examples/lua/import/base.h
    @@ -1,7 +1,7 @@
     class Base {
      public:
    -     Base() { };
    -     virtual ~Base() { };
    +     Base() { }
    +     virtual ~Base() { }
          virtual const char * A() const {
              return "Base::A";
          }
    diff --git a/Examples/lua/nspace/Makefile b/Examples/lua/nspace/Makefile
    new file mode 100644
    index 0000000..fdedebc
    --- /dev/null
    +++ b/Examples/lua/nspace/Makefile
    @@ -0,0 +1,22 @@
    +TOP        = ../..
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +CXXSRCS    =
    +TARGET     = example
    +INTERFACE  = example.i
    +
    +check: build
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_run
    +
    +build:
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' lua_cpp
    +
    +static:
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	TARGET='mylua' INTERFACE='$(INTERFACE)' lua_cpp_static
    +
    +clean:
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_clean
    diff --git a/Examples/lua/nspace/example.h b/Examples/lua/nspace/example.h
    new file mode 100644
    index 0000000..5306698
    --- /dev/null
    +++ b/Examples/lua/nspace/example.h
    @@ -0,0 +1,23 @@
    +#ifndef _example_guardian_
    +#define _example_guardian_
    +
    +int module_function() { return 7; }
    +int module_variable = 9;
    +
    +namespace MyWorld {
    +  class World {
    +  public:
    +    World() : world_max_count(9) {}
    +    int create_world() { return 17; }
    +    const int world_max_count; // = 9
    +  };
    +  namespace Nested {
    +    class Dweller {
    +      public:
    +        enum Gender { MALE = 0, FEMALE = 1 };
    +        static int count() { return 19; }
    +    };
    +  }
    +}
    +
    +#endif
    diff --git a/Examples/lua/nspace/example.i b/Examples/lua/nspace/example.i
    new file mode 100644
    index 0000000..c30f87f
    --- /dev/null
    +++ b/Examples/lua/nspace/example.i
    @@ -0,0 +1,10 @@
    +%module example
    +
    +%{
    +#include "example.h"
    +%}
    +
    +%nspace MyWorld::Nested::Dweller;
    +%nspace MyWorld::World;
    +
    +%include "example.h"
    diff --git a/Examples/lua/nspace/runme.lua b/Examples/lua/nspace/runme.lua
    new file mode 100644
    index 0000000..8768140
    --- /dev/null
    +++ b/Examples/lua/nspace/runme.lua
    @@ -0,0 +1,46 @@
    +-- file: runme.lua
    +
    +-- This file illustrates class C++ interface generated
    +-- by SWIG.
    +
    +---- importing ----
    +if string.sub(_VERSION,1,7)=='Lua 5.0' then
    +	-- lua5.0 doesnt have a nice way to do this
    +	lib=loadlib('example.dll','luaopen_example') or loadlib('example.so','luaopen_example')
    +	assert(lib)()
    +else
    +	-- lua 5.1 does
    +	require('example')
    +end
    +
    +ex = example
    +
    +-- Calling a module function ( aka global function )
    +assert( ex.module_function() == 7 )
    +print("example.module_function(): ", ex.module_function())
    +
    +-- Accessing a module (aka global) variable
    +assert( ex.module_variable == 9 )
    +print("example.module_variable: ", ex.module_variable)
    +
    +-- Creating an instance of the class
    +w1 = ex.MyWorld.World()
    +print("Creating class instance: w1 = ex.MyWorld.World(): ", w1)
    +
    +-- Accessing class members 
    +assert( ex.MyWorld.World():create_world() == 17 )
    +print( "w1:create_world() = ", w1:create_world() )
    +assert( w1:create_world() == 17 )
    +print( "w1:world_max_count = ", w1.world_max_count )
    +assert( w1.world_max_count == 9 )
    +
    +-- Accessing enums from class within namespace
    +print( "Accessing enums: ex.MyWorld.Nested.Dweller.MALE = ", ex.MyWorld.Nested.Dweller.MALE )
    +assert( ex.MyWorld.Nested.Dweller.MALE == 0 )
    +print( "Accessing enums: ex.MyWorld.Nested.Dweller.FEMALE = ", ex.MyWorld.Nested.Dweller.FEMALE )
    +assert( ex.MyWorld.Nested.Dweller.FEMALE == 1 )
    +
    +-- Accessing static member function
    +print( "Accessing static member function: ex.MyWorld.Nested.Dweller.count() = ", ex.MyWorld.Nested.Dweller.count() )
    +assert( ex.MyWorld.Nested.Dweller.count() == 19 )
    +
    diff --git a/Examples/lua/owner/Makefile b/Examples/lua/owner/Makefile
    index c39e8ac..dd78fdb 100644
    --- a/Examples/lua/owner/Makefile
    +++ b/Examples/lua/owner/Makefile
    @@ -1,20 +1,23 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     CXXSRCS    = example.cxx
     TARGET     = example
     INTERFACE  = example.i
     LIBS       = -lm
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile lua_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' lua_cpp
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='mylua' INTERFACE='$(INTERFACE)' lua_cpp_static
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile lua_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' lua_clean
    diff --git a/Examples/lua/owner/example.cxx b/Examples/lua/owner/example.cxx
    index bce484a..c2c073d 100644
    --- a/Examples/lua/owner/example.cxx
    +++ b/Examples/lua/owner/example.cxx
    @@ -39,12 +39,15 @@ Square* createSquare(double w)
         return new Square(w);
     }
     
    -ShapeOwner::ShapeOwner() {printf("  ShapeOwner(%p)\n",this);}
    +ShapeOwner::ShapeOwner() {
    +  printf("  ShapeOwner(%p)\n", (void *)this);
    +}
    +
     ShapeOwner::~ShapeOwner()
     {
    -    printf("  ~ShapeOwner(%p)\n",this);
    -    for(unsigned i=0;ix : 0, ptptr ? ptptr->y : 0);
    +  printf("ptptr     = %p (%d, %d)\n", (void *)ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0);
       printf("pt        = (%d, %d)\n", pt.x, pt.y);
       printf("status    = %d\n", status);
     }
    diff --git a/Examples/modula3/class/Makefile b/Examples/modula3/class/Makefile
    index 9976e6f..b25f636 100644
    --- a/Examples/modula3/class/Makefile
    +++ b/Examples/modula3/class/Makefile
    @@ -1,6 +1,7 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +SRCS       =
     TARGET     = example
     PLATFORM   = LINUXLIBC6
     INTERFACE  = example.i
    @@ -8,10 +9,11 @@ SWIGOPT    = -c++
     MODULA3SRCS = *.[im]3
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile modula3_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' modula3_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' modula3
     	m3ppinplace $(MODULA3SRCS)
     # compilation of example_wrap.cxx is started by cm3
    @@ -21,4 +23,4 @@ build:
     	cm3
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile modula3_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' modula3_clean
    diff --git a/Examples/modula3/class/example.cxx b/Examples/modula3/class/example.cxx
    index 1e8e203..0463045 100644
    --- a/Examples/modula3/class/example.cxx
    +++ b/Examples/modula3/class/example.cxx
    @@ -1,4 +1,4 @@
    -/* File : example.c */
    +/* File : example.cxx */
     
     #include "example.h"
     #define M_PI 3.14159265358979323846
    @@ -11,18 +11,18 @@ void Shape::move(double dx, double dy) {
     
     int Shape::nshapes = 0;
     
    -double Circle::area(void) {
    +double Circle::area() {
       return M_PI*radius*radius;
     }
     
    -double Circle::perimeter(void) {
    +double Circle::perimeter() {
       return 2*M_PI*radius;
     }
     
    -double Square::area(void) {
    +double Square::area() {
       return width*width;
     }
     
    -double Square::perimeter(void) {
    +double Square::perimeter() {
       return 4*width;
     }
    diff --git a/Examples/modula3/class/example.h b/Examples/modula3/class/example.h
    index 9c1f479..0dff185 100644
    --- a/Examples/modula3/class/example.h
    +++ b/Examples/modula3/class/example.h
    @@ -1,44 +1,34 @@
     /* File : example.h */
     
    -class Shape
    -{
    +class Shape {
     public:
    -  Shape ()
    -  {
    +  Shape() {
         nshapes++;
       }
    -  virtual ~ Shape ()
    -  {
    +  virtual ~Shape() {
         nshapes--;
    -  };
    -  double x, y;
    -  void move (double dx, double dy);
    -  virtual double area (void) const = 0;
    -  virtual double perimeter (void) const = 0;
    -protected:
    -  static int nshapes;
    +  }
    +  double  x, y;
    +  void    move(double dx, double dy);
    +  virtual double area() = 0;
    +  virtual double perimeter() = 0;
    +  static  int nshapes;
     };
     
    -class Circle:public Shape
    -{
    +class Circle : public Shape {
     private:
       double radius;
     public:
    -    Circle (double r):radius (r)
    -  {
    -  };
    -  virtual double area (void) const;
    -  virtual double perimeter (void) const;
    +  Circle(double r) : radius(r) { }
    +  virtual double area();
    +  virtual double perimeter();
     };
     
    -class Square:public Shape
    -{
    +class Square : public Shape {
     private:
       double width;
     public:
    -    Square (double w):width (w)
    -  {
    -  };
    -  virtual double area (void) const;
    -  virtual double perimeter (void) const;
    +  Square(double w) : width(w) { }
    +  virtual double area();
    +  virtual double perimeter();
     };
    diff --git a/Examples/modula3/enum/Makefile b/Examples/modula3/enum/Makefile
    index a3b4998..2c5c9b0 100644
    --- a/Examples/modula3/enum/Makefile
    +++ b/Examples/modula3/enum/Makefile
    @@ -1,6 +1,7 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +SRCS       =
     TARGET     = example
     INTERFACE  = example.i
     CONSTNUMERIC = example_const
    @@ -8,18 +9,19 @@ SWIGOPT      = -c++
     MODULA3SRCS  = *.[im]3
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile modula3_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' modula3_run
     
     build:
    -	$(SWIG) -modula3 $(SWIGOPT) -module Example -generateconst $(CONSTNUMERIC) $(TARGET).h
    +	$(SWIGEXE) -modula3 $(SWIGOPT) -module Example -generateconst $(CONSTNUMERIC) $(TARGET).h
     	$(CXX) -Wall $(CONSTNUMERIC).c -o $(CONSTNUMERIC)
     	$(CONSTNUMERIC) >$(CONSTNUMERIC).i
     
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' modula3
     	m3ppinplace $(MODULA3SRCS)
     	mv m3makefile $(MODULA3SRCS) src/
     	cm3
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile modula3_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' modula3_clean
    diff --git a/Examples/modula3/exception/Makefile b/Examples/modula3/exception/Makefile
    index 8d45255..8d12ef1 100644
    --- a/Examples/modula3/exception/Makefile
    +++ b/Examples/modula3/exception/Makefile
    @@ -1,5 +1,6 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     CXXSRCS    = example.cxx
     TARGET     = example
     INTERFACE  = example.i
    @@ -8,15 +9,16 @@ MODULA3SRCS = *.[im]3
     MODULA3FLAGS= -o runme
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile modula3_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' modula3_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' modula3_cpp
    -#	$(MAKE) -f $(TOP)/Makefile MODULA3SRCS='$(MODULA3SRCS)' MODULA3FLAGS='$(MODULA3FLAGS)' modula3_compile
    +#	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' MODULA3SRCS='$(MODULA3SRCS)' MODULA3FLAGS='$(MODULA3FLAGS)' modula3_compile
     	m3ppinplace $(MODULA3SRCS)
     	mv m3makefile $(MODULA3SRCS) src/
     	cm3
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile modula3_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' modula3_clean
    diff --git a/Examples/modula3/reference/Makefile b/Examples/modula3/reference/Makefile
    index 6218393..eaceceb 100644
    --- a/Examples/modula3/reference/Makefile
    +++ b/Examples/modula3/reference/Makefile
    @@ -1,20 +1,22 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +SRCS       =
     TARGET     = example
     INTERFACE  = example.i
     SWIGOPT    = -c++
     MODULA3SRCS = *.[im]3
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile modula3_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' modula3_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' modula3
     	m3ppinplace $(MODULA3SRCS)
     	mv m3makefile $(MODULA3SRCS) src/
     	cm3
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile modula3_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' modula3_clean
    diff --git a/Examples/modula3/reference/example.cxx b/Examples/modula3/reference/example.cxx
    index 649b016..9dbaed2 100644
    --- a/Examples/modula3/reference/example.cxx
    +++ b/Examples/modula3/reference/example.cxx
    @@ -19,7 +19,7 @@ Vector operator+(const Vector &a, const Vector &b) {
     
     char *Vector::print() {
       static char temp[512];
    -  sprintf(temp,"Vector %x (%g,%g,%g)", (int)this, x,y,z);
    +  sprintf(temp,"Vector %p (%g,%g,%g)", (void *)this, x,y,z);
       return temp;
     }
     
    diff --git a/Examples/modula3/reference/example.h b/Examples/modula3/reference/example.h
    index 0a9cd44..7b4ba8f 100644
    --- a/Examples/modula3/reference/example.h
    +++ b/Examples/modula3/reference/example.h
    @@ -4,8 +4,8 @@ struct Vector {
     private:
       double x,y,z;
     public:
    -  Vector() : x(0), y(0), z(0) { };
    -  Vector(double x, double y, double z) : x(x), y(y), z(z) { };
    +  Vector() : x(0), y(0), z(0) { }
    +  Vector(double x, double y, double z) : x(x), y(y), z(z) { }
       Vector operator+(const Vector &b) const;
       char *print();
     };
    diff --git a/Examples/modula3/simple/Makefile b/Examples/modula3/simple/Makefile
    index 6a0ca4f..3ba35d1 100644
    --- a/Examples/modula3/simple/Makefile
    +++ b/Examples/modula3/simple/Makefile
    @@ -1,20 +1,22 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +SRCS       =
     TARGET     = example
     INTERFACE  = example.i
     SWIGOPT    =
     MODULA3SRCS = *.[im]3
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile modula3_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' modula3_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' modula3
     	m3ppinplace $(MODULA3SRCS)
     	mv m3makefile $(MODULA3SRCS) src/
     	cm3
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile modula3_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' modula3_clean
    diff --git a/Examples/modula3/typemap/Makefile b/Examples/modula3/typemap/Makefile
    index 6a0ca4f..3ba35d1 100644
    --- a/Examples/modula3/typemap/Makefile
    +++ b/Examples/modula3/typemap/Makefile
    @@ -1,20 +1,22 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +SRCS       =
     TARGET     = example
     INTERFACE  = example.i
     SWIGOPT    =
     MODULA3SRCS = *.[im]3
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile modula3_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' modula3_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' modula3
     	m3ppinplace $(MODULA3SRCS)
     	mv m3makefile $(MODULA3SRCS) src/
     	cm3
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile modula3_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' modula3_clean
    diff --git a/Examples/mzscheme/multimap/Makefile b/Examples/mzscheme/multimap/Makefile
    index d1b4a3f..713ee43 100644
    --- a/Examples/mzscheme/multimap/Makefile
    +++ b/Examples/mzscheme/multimap/Makefile
    @@ -1,15 +1,17 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     SRCS       = example.c
     TARGET     = example
     INTERFACE  = example.i
    -SWIGOPT    = 
    +SWIGOPT    =
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile mzscheme_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' mzscheme_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' mzscheme
     clean:
    -	$(MAKE) -f $(TOP)/Makefile mzscheme_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' mzscheme_clean
    diff --git a/Examples/mzscheme/simple/Makefile b/Examples/mzscheme/simple/Makefile
    index d1b4a3f..713ee43 100644
    --- a/Examples/mzscheme/simple/Makefile
    +++ b/Examples/mzscheme/simple/Makefile
    @@ -1,15 +1,17 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     SRCS       = example.c
     TARGET     = example
     INTERFACE  = example.i
    -SWIGOPT    = 
    +SWIGOPT    =
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile mzscheme_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' mzscheme_run
     
     build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' mzscheme
     clean:
    -	$(MAKE) -f $(TOP)/Makefile mzscheme_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' mzscheme_clean
    diff --git a/Examples/mzscheme/std_vector/Makefile b/Examples/mzscheme/std_vector/Makefile
    index 28b9115..96f5e80 100644
    --- a/Examples/mzscheme/std_vector/Makefile
    +++ b/Examples/mzscheme/std_vector/Makefile
    @@ -1,20 +1,21 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +SRCS       =
     TARGET     = example
     INTERFACE  = example.i
    -SWIGOPT    = 
    +SWIGOPT    =
     
     GPP        = `which g++`
     MZC        = test -n "/usr/bin/mzc" && /usr/bin/mzc
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile mzscheme_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' mzscheme_run
     
     build:
    -	$(SWIG) -mzscheme -c++ $(SWIGOPT) $(INTERFACE)
    +	$(SWIGEXE) -mzscheme -c++ $(SWIGOPT) $(INTERFACE)
     	$(MZC) --compiler $(GPP) ++ccf "-I." --cc example_wrap.cxx
    -	$(MZC) --linker $(GPP) --ld $(TARGET).so example_wrap.o 
    -	
    +	$(MZC) --linker $(GPP) --ld $(TARGET).so example_wrap.o
    +
     clean:
    -	$(MAKE) -f $(TOP)/Makefile mzscheme_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' mzscheme_clean
    diff --git a/Examples/ocaml/argout_ref/Makefile b/Examples/ocaml/argout_ref/Makefile
    index 4e12e37..8b7fc95 100644
    --- a/Examples/ocaml/argout_ref/Makefile
    +++ b/Examples/ocaml/argout_ref/Makefile
    @@ -1,5 +1,6 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     SRCS       = example.c
     TARGET     = example
     INTERFACE  = example.i
    @@ -8,21 +9,23 @@ PROGFILE   = example_prog.ml
     OBJS       = example.o
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' ocaml_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' ocaml_run
     
     build: static
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' MLFILE='$(MLFILE)' \
     	PROGFILE='$(PROGFILE)' OBJS='$(OBJS)' \
     	ocaml_static_cpp
     
     dynamic:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' MLFILE='$(MLFILE)' \
     	PROGFILE='$(PROGFILE)' OBJS='$(OBJS)' \
     	ocaml_dynamic_cpp
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile MLFILE='$(MLFILE)' ocaml_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' MLFILE='$(MLFILE)' ocaml_clean
    diff --git a/Examples/ocaml/contract/Makefile b/Examples/ocaml/contract/Makefile
    index 91d3924..c77e6dc 100644
    --- a/Examples/ocaml/contract/Makefile
    +++ b/Examples/ocaml/contract/Makefile
    @@ -1,34 +1,38 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +SRCS       =
     TARGET     = example
     INTERFACE  = example.i
     MLFILE     = example.ml
     PROGFILE   = example_prog.ml
    -OBJS       = 
    +OBJS       =
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' ocaml_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' ocaml_run
     
     build: static
     
     dynamic:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' MLFILE='$(MLFILE)' \
     	PROGFILE='$(PROGFILE)' OBJS='$(OBJS)' \
     	ocaml_dynamic
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' MLFILE='$(MLFILE)' \
     	PROGFILE='$(PROGFILE)' OBJS='$(OBJS)' \
     	ocaml_static
     
     toplevel:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' MLFILE='$(MLFILE)' \
     	PROGFILE='$(PROGFILE)' OBJS='$(OBJS)' \
     	ocaml_static_toplevel
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile MLFILE='$(MLFILE)' ocaml_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' MLFILE='$(MLFILE)' ocaml_clean
    diff --git a/Examples/ocaml/scoped_enum/Makefile b/Examples/ocaml/scoped_enum/Makefile
    index 4920e3b..9655c98 100644
    --- a/Examples/ocaml/scoped_enum/Makefile
    +++ b/Examples/ocaml/scoped_enum/Makefile
    @@ -1,34 +1,38 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +SRCS       =
     TARGET     = example
     INTERFACE  = example.i
     MLFILE     = example.ml
     PROGFILE   = example_prog.ml
    -OBJS       = 
    +OBJS       =
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' ocaml_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' ocaml_run
     
     build: static
     
     dynamic:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' MLFILE='$(MLFILE)' \
     	PROGFILE='$(PROGFILE)' OBJS='$(OBJS)' \
     	ocaml_dynamic_cpp
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' MLFILE='$(MLFILE)' \
     	PROGFILE='$(PROGFILE)' OBJS='$(OBJS)' \
     	ocaml_static_cpp
     
     toplevel:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' MLFILE='$(MLFILE)' \
     	PROGFILE='$(PROGFILE)' OBJS='$(OBJS)' \
     	ocaml_static_cpp_toplevel
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile MLFILE='$(MLFILE)' ocaml_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' MLFILE='$(MLFILE)' ocaml_clean
    diff --git a/Examples/ocaml/shapes/Makefile b/Examples/ocaml/shapes/Makefile
    index 38230eb..b291d07 100644
    --- a/Examples/ocaml/shapes/Makefile
    +++ b/Examples/ocaml/shapes/Makefile
    @@ -1,6 +1,7 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SWIGOPT    = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +SWIGOPT    =
     SRCS       = example.c
     TARGET     = example
     INTERFACE  = example.i
    @@ -9,27 +10,30 @@ PROGFILE   = example_prog.ml
     OBJS       = example.o
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' ocaml_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' ocaml_run
     
     build: static static_top
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \
     	MLFILE='$(MLFILE)' PROGFILE='$(PROGFILE)' OBJS='$(OBJS)' \
     	ocaml_static_cpp
     
     static_top:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \
     	MLFILE='$(MLFILE)' PROGFILE='$(PROGFILE)' OBJS='$(OBJS)' \
     	ocaml_static_cpp_toplevel
     
     dynamic:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)'
     	MLFILE='$(MLFILE)' PROGFILE='$(PROGFILE)' OBJS='$(OBJS)' \
     	ocaml_dynamic_cpp
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile MLFILE='$(MLFILE)' ocaml_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' MLFILE='$(MLFILE)' ocaml_clean
    diff --git a/Examples/ocaml/simple/Makefile b/Examples/ocaml/simple/Makefile
    index 64c7256..88fef74 100644
    --- a/Examples/ocaml/simple/Makefile
    +++ b/Examples/ocaml/simple/Makefile
    @@ -1,5 +1,6 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     SRCS       = example.c
     TARGET     = example
     INTERFACE  = example.i
    @@ -8,27 +9,30 @@ PROGFILE   = example_prog.ml
     OBJS       = example.o
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' ocaml_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' ocaml_run
     
     build: static
     
     dynamic:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' MLFILE='$(MLFILE)' \
     	PROGFILE='$(PROGFILE)' OBJS='$(OBJS)' \
     	ocaml_dynamic
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' MLFILE='$(MLFILE)' \
     	PROGFILE='$(PROGFILE)' OBJS='$(OBJS)' \
     	ocaml_static
     
     toplevel:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' MLFILE='$(MLFILE)' \
     	PROGFILE='$(PROGFILE)' OBJS='$(OBJS)' \
     	ocaml_static_toplevel
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile MLFILE='$(MLFILE)' ocaml_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' MLFILE='$(MLFILE)' ocaml_clean
    diff --git a/Examples/ocaml/std_string/Makefile b/Examples/ocaml/std_string/Makefile
    index 0250cfd..099b1fc 100644
    --- a/Examples/ocaml/std_string/Makefile
    +++ b/Examples/ocaml/std_string/Makefile
    @@ -1,24 +1,27 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +SRCS       =
     TARGET     = example
     INTERFACE  = example.i
     PROGFILE   = runme.ml
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' ocaml_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' ocaml_run
     
     build: static
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	PROGFILE='$(PROGFILE)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \
     	ocaml_static_cpp
     
     dynamic:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	PROGFILE='$(PROGFILE)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \
     	ocaml_dynamic_cpp
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' ocaml_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' ocaml_clean
    diff --git a/Examples/ocaml/std_vector/Makefile b/Examples/ocaml/std_vector/Makefile
    index 0250cfd..099b1fc 100644
    --- a/Examples/ocaml/std_vector/Makefile
    +++ b/Examples/ocaml/std_vector/Makefile
    @@ -1,24 +1,27 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +SRCS       =
     TARGET     = example
     INTERFACE  = example.i
     PROGFILE   = runme.ml
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' ocaml_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' ocaml_run
     
     build: static
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	PROGFILE='$(PROGFILE)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \
     	ocaml_static_cpp
     
     dynamic:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	PROGFILE='$(PROGFILE)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \
     	ocaml_dynamic_cpp
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' ocaml_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' ocaml_clean
    diff --git a/Examples/ocaml/stl/Makefile b/Examples/ocaml/stl/Makefile
    index 545f322..912dd9f 100644
    --- a/Examples/ocaml/stl/Makefile
    +++ b/Examples/ocaml/stl/Makefile
    @@ -1,34 +1,39 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +SRCS       =
     TARGET     = example
     INTERFACE  = example.i
     PROGFILE   = runme.ml
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' ocaml_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' ocaml_run
     
     build: static
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	PROGFILE='$(PROGFILE)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \
     	ocaml_static_cpp
     
     director:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	PROGFILE='$(PROGFILE)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \
     	ocaml_static_cpp_director
     
     dynamic:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	PROGFILE='$(PROGFILE)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \
     	ocaml_static_cpp
     
     toplevel:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	PROGFILE='$(PROGFILE)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \
     	ocaml_static_cpp_toplevel
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' ocaml_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' ocaml_clean
    diff --git a/Examples/ocaml/string_from_ptr/Makefile b/Examples/ocaml/string_from_ptr/Makefile
    index f7b8089..f9b0278 100644
    --- a/Examples/ocaml/string_from_ptr/Makefile
    +++ b/Examples/ocaml/string_from_ptr/Makefile
    @@ -1,35 +1,39 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
     SWIGOPT    = -c++
    -SRCS       = 
    +SRCS       =
     TARGET     = example
     INTERFACE  = foolib.i
     MLFILE     = foolib.ml
     PROGFILE   = example_prog.ml
    -OBJS       = 
    +OBJS       =
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' ocaml_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' ocaml_run
     
     build: static static_top
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \
     	MLFILE='$(MLFILE)' PROGFILE='$(PROGFILE)' OBJS='$(OBJS)' \
     	ocaml_static_cpp
     
     static_top:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \
     	MLFILE='$(MLFILE)' PROGFILE='$(PROGFILE)' OBJS='$(OBJS)' \
     	ocaml_static_cpp_toplevel
     
     dynamic:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)'
     	MLFILE='$(MLFILE)' PROGFILE='$(PROGFILE)' OBJS='$(OBJS)' \
     	ocaml_dynamic_cpp
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile MLFILE='$(MLFILE)' ocaml_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' MLFILE='$(MLFILE)' ocaml_clean
    diff --git a/Examples/ocaml/strings_test/Makefile b/Examples/ocaml/strings_test/Makefile
    index 14f55e0..24e2e6c 100644
    --- a/Examples/ocaml/strings_test/Makefile
    +++ b/Examples/ocaml/strings_test/Makefile
    @@ -1,29 +1,33 @@
     TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = 
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +SRCS       =
     TARGET     = example
     INTERFACE  = example.i
     PROGFILE   = runme.ml
     
     check: build
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' ocaml_run
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' ocaml_run
     
     build: static top
     
     static:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	PROGFILE='$(PROGFILE)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \
     	ocaml_static_cpp
     
     dynamic:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	PROGFILE='$(PROGFILE)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \
     	ocaml_static_cpp
     
     top:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
     	PROGFILE='$(PROGFILE)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \
     	ocaml_static_cpp_toplevel
     
     clean:
    -	$(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' ocaml_clean
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' ocaml_clean
    diff --git a/Examples/octave/callback/Makefile b/Examples/octave/callback/Makefile
    index d38d7f8..3b746de 100644
    --- a/Examples/octave/callback/Makefile
    +++ b/Examples/octave/callback/Makefile
    @@ -1,17 +1,3 @@
    -TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -CXXSRCS    = example.cxx
    -TARGET     = swigexample
    -INTERFACE  = example.i
    -LIBS       = -lm
    -SWIGOPT    =
    +CXXSRCS = example.cxx
     
    -check: build
    -	$(MAKE) -f $(TOP)/Makefile octave_run
    -
    -build:
    -	$(MAKE) -f $(TOP)/Makefile $(SWIGLIB) CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    -	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' octave_cpp
    -
    -clean:
    -	$(MAKE) -f $(TOP)/Makefile octave_clean
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/octave/callback/example.i b/Examples/octave/callback/example.i
    index 3192904..333127a 100644
    --- a/Examples/octave/callback/example.i
    +++ b/Examples/octave/callback/example.i
    @@ -1,11 +1,12 @@
     /* File : example.i */
     %module(directors="1") swigexample
    +
    +%feature("autodoc", 1);
    +
     %{
     #include "example.h"
     %}
     
    -%include "std_string.i"
    -
     /* turn on director wrapping Callback */
     %feature("director") Callback;
     
    diff --git a/Examples/octave/class/Makefile b/Examples/octave/class/Makefile
    index d38d7f8..3b746de 100644
    --- a/Examples/octave/class/Makefile
    +++ b/Examples/octave/class/Makefile
    @@ -1,17 +1,3 @@
    -TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -CXXSRCS    = example.cxx
    -TARGET     = swigexample
    -INTERFACE  = example.i
    -LIBS       = -lm
    -SWIGOPT    =
    +CXXSRCS = example.cxx
     
    -check: build
    -	$(MAKE) -f $(TOP)/Makefile octave_run
    -
    -build:
    -	$(MAKE) -f $(TOP)/Makefile $(SWIGLIB) CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    -	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' octave_cpp
    -
    -clean:
    -	$(MAKE) -f $(TOP)/Makefile octave_clean
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/octave/class/example.cxx b/Examples/octave/class/example.cxx
    index 1e8e203..0463045 100644
    --- a/Examples/octave/class/example.cxx
    +++ b/Examples/octave/class/example.cxx
    @@ -1,4 +1,4 @@
    -/* File : example.c */
    +/* File : example.cxx */
     
     #include "example.h"
     #define M_PI 3.14159265358979323846
    @@ -11,18 +11,18 @@ void Shape::move(double dx, double dy) {
     
     int Shape::nshapes = 0;
     
    -double Circle::area(void) {
    +double Circle::area() {
       return M_PI*radius*radius;
     }
     
    -double Circle::perimeter(void) {
    +double Circle::perimeter() {
       return 2*M_PI*radius;
     }
     
    -double Square::area(void) {
    +double Square::area() {
       return width*width;
     }
     
    -double Square::perimeter(void) {
    +double Square::perimeter() {
       return 4*width;
     }
    diff --git a/Examples/octave/class/example.h b/Examples/octave/class/example.h
    index 0d4527e..0dff185 100644
    --- a/Examples/octave/class/example.h
    +++ b/Examples/octave/class/example.h
    @@ -7,11 +7,11 @@ public:
       }
       virtual ~Shape() {
         nshapes--;
    -  };
    +  }
       double  x, y;
       void    move(double dx, double dy);
    -  virtual double area(void) = 0;
    -  virtual double perimeter(void) = 0;
    +  virtual double area() = 0;
    +  virtual double perimeter() = 0;
       static  int nshapes;
     };
     
    @@ -19,16 +19,16 @@ class Circle : public Shape {
     private:
       double radius;
     public:
    -  Circle(double r) : radius(r) { };
    -  virtual double area(void);
    -  virtual double perimeter(void);
    +  Circle(double r) : radius(r) { }
    +  virtual double area();
    +  virtual double perimeter();
     };
     
     class Square : public Shape {
     private:
       double width;
     public:
    -  Square(double w) : width(w) { };
    -  virtual double area(void);
    -  virtual double perimeter(void);
    +  Square(double w) : width(w) { }
    +  virtual double area();
    +  virtual double perimeter();
     };
    diff --git a/Examples/octave/class/example.i b/Examples/octave/class/example.i
    index b109bcb..52e9fd3 100644
    --- a/Examples/octave/class/example.i
    +++ b/Examples/octave/class/example.i
    @@ -1,6 +1,8 @@
     /* File : example.i */
     %module swigexample
     
    +%feature("autodoc", 1);
    +
     %{
     #include "example.h"
     %}
    diff --git a/Examples/octave/constants/Makefile b/Examples/octave/constants/Makefile
    index 03501bd..acf4d05 100644
    --- a/Examples/octave/constants/Makefile
    +++ b/Examples/octave/constants/Makefile
    @@ -1,17 +1,3 @@
    -TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -CXXSRCS    =
    -TARGET     = swigexample
    -INTERFACE  = example.i
    -LIBS       = -lm
    -SWIGOPT    =
    +CXXSRCS =
     
    -check: build
    -	$(MAKE) -f $(TOP)/Makefile octave_run
    -
    -build:
    -	$(MAKE) -f $(TOP)/Makefile $(SWIGLIB) CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    -	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' octave_cpp
    -
    -clean:
    -	$(MAKE) -f $(TOP)/Makefile octave_clean
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/octave/constants/example.i b/Examples/octave/constants/example.i
    index 405974b..ab42a6b 100644
    --- a/Examples/octave/constants/example.i
    +++ b/Examples/octave/constants/example.i
    @@ -1,6 +1,8 @@
     /* File : example.i */
     %module swigexample
     
    +%feature("autodoc", 1);
    +
     /* A few preprocessor macros */
     
     #define    ICONST      42
    diff --git a/Examples/octave/contract/Makefile b/Examples/octave/contract/Makefile
    index 73e3962..413b64b 100644
    --- a/Examples/octave/contract/Makefile
    +++ b/Examples/octave/contract/Makefile
    @@ -1,15 +1,3 @@
    -TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = example.c
    -TARGET     = swigexample
    -INTERFACE  = example.i
    +SRCS = example.c
     
    -check: build
    -	$(MAKE) -f $(TOP)/Makefile octave_run
    -
    -build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    -	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' octave
    -
    -clean:
    -	$(MAKE) -f $(TOP)/Makefile octave_clean
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/octave/contract/example.i b/Examples/octave/contract/example.i
    index 78c459e..8976607 100644
    --- a/Examples/octave/contract/example.i
    +++ b/Examples/octave/contract/example.i
    @@ -1,6 +1,8 @@
     /* File : example.i */
     %module swigexample
     
    +%feature("autodoc", 1);
    +
     %contract gcd(int x, int y) {
     require:
     	x >= 0;
    diff --git a/Examples/octave/enum/Makefile b/Examples/octave/enum/Makefile
    index d38d7f8..3b746de 100644
    --- a/Examples/octave/enum/Makefile
    +++ b/Examples/octave/enum/Makefile
    @@ -1,17 +1,3 @@
    -TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -CXXSRCS    = example.cxx
    -TARGET     = swigexample
    -INTERFACE  = example.i
    -LIBS       = -lm
    -SWIGOPT    =
    +CXXSRCS = example.cxx
     
    -check: build
    -	$(MAKE) -f $(TOP)/Makefile octave_run
    -
    -build:
    -	$(MAKE) -f $(TOP)/Makefile $(SWIGLIB) CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    -	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' octave_cpp
    -
    -clean:
    -	$(MAKE) -f $(TOP)/Makefile octave_clean
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/octave/enum/example.i b/Examples/octave/enum/example.i
    index cee9af4..084bab0 100644
    --- a/Examples/octave/enum/example.i
    +++ b/Examples/octave/enum/example.i
    @@ -1,6 +1,8 @@
     /* File : example.i */
     %module swigexample
     
    +%feature("autodoc", 1);
    +
     %{
     #include "example.h"
     %}
    diff --git a/Examples/octave/example.mk b/Examples/octave/example.mk
    new file mode 100644
    index 0000000..1ab96f0
    --- /dev/null
    +++ b/Examples/octave/example.mk
    @@ -0,0 +1,37 @@
    +# Note: as a convention an example must be in a child directory of this.
    +# These paths are relative to such an example directory
    +
    +TOP        = ../..
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +TARGET     = swigexample
    +INTERFACE  = example.i
    +
    +check: build
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' octave_run
    +
    +build:
    +ifneq (,$(SRCS))
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' octave
    +else
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' octave_cpp
    +endif
    +ifneq (,$(TARGET2)$(SWIGOPT2))
    +ifneq (,$(SRCS))
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	SWIGOPT='$(SWIGOPT2)' TARGET='$(TARGET2)' INTERFACE='$(INTERFACE)' octave
    +else
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	SWIGOPT='$(SWIGOPT2)' TARGET='$(TARGET2)' INTERFACE='$(INTERFACE)' octave_cpp
    +endif
    +endif
    +
    +
    +clean:
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' octave_clean
    diff --git a/Examples/octave/extend/Makefile b/Examples/octave/extend/Makefile
    index d38d7f8..3b746de 100644
    --- a/Examples/octave/extend/Makefile
    +++ b/Examples/octave/extend/Makefile
    @@ -1,17 +1,3 @@
    -TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -CXXSRCS    = example.cxx
    -TARGET     = swigexample
    -INTERFACE  = example.i
    -LIBS       = -lm
    -SWIGOPT    =
    +CXXSRCS = example.cxx
     
    -check: build
    -	$(MAKE) -f $(TOP)/Makefile octave_run
    -
    -build:
    -	$(MAKE) -f $(TOP)/Makefile $(SWIGLIB) CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    -	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' octave_cpp
    -
    -clean:
    -	$(MAKE) -f $(TOP)/Makefile octave_clean
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/octave/extend/example.h b/Examples/octave/extend/example.h
    index 9e15cf8..77a26ec 100644
    --- a/Examples/octave/extend/example.h
    +++ b/Examples/octave/extend/example.h
    @@ -14,7 +14,7 @@ public:
     	virtual std::string getTitle() { return getPosition() + " " + getName(); }
     	virtual std::string getName() { return name; }
     	virtual std::string getPosition() const { return "Employee"; }
    -	virtual ~Employee() { printf("~Employee() @ %p\n", this); }
    +	virtual ~Employee() { printf("~Employee() @ %p\n", (void *)this); }
     };
     
     
    diff --git a/Examples/octave/extend/example.i b/Examples/octave/extend/example.i
    index 953c2f3..3b9ac53 100644
    --- a/Examples/octave/extend/example.i
    +++ b/Examples/octave/extend/example.i
    @@ -1,5 +1,8 @@
     /* File : example.i */
     %module(directors="1") swigexample
    +
    +%feature("autodoc", 1);
    +
     %{
     #include "example.h"
     %}
    diff --git a/Examples/octave/funcptr/Makefile b/Examples/octave/funcptr/Makefile
    index 73e3962..413b64b 100644
    --- a/Examples/octave/funcptr/Makefile
    +++ b/Examples/octave/funcptr/Makefile
    @@ -1,15 +1,3 @@
    -TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = example.c
    -TARGET     = swigexample
    -INTERFACE  = example.i
    +SRCS = example.c
     
    -check: build
    -	$(MAKE) -f $(TOP)/Makefile octave_run
    -
    -build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    -	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' octave
    -
    -clean:
    -	$(MAKE) -f $(TOP)/Makefile octave_clean
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/octave/funcptr/example.i b/Examples/octave/funcptr/example.i
    index 163a199..c6fcfe7 100644
    --- a/Examples/octave/funcptr/example.i
    +++ b/Examples/octave/funcptr/example.i
    @@ -1,5 +1,8 @@
     /* File : example.i */
     %module swigexample
    +
    +%feature("autodoc", 1);
    +
     %{
     #include "example.h"
     %}
    diff --git a/Examples/octave/funcptr2/Makefile b/Examples/octave/funcptr2/Makefile
    index 73e3962..413b64b 100644
    --- a/Examples/octave/funcptr2/Makefile
    +++ b/Examples/octave/funcptr2/Makefile
    @@ -1,15 +1,3 @@
    -TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = example.c
    -TARGET     = swigexample
    -INTERFACE  = example.i
    +SRCS = example.c
     
    -check: build
    -	$(MAKE) -f $(TOP)/Makefile octave_run
    -
    -build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    -	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' octave
    -
    -clean:
    -	$(MAKE) -f $(TOP)/Makefile octave_clean
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/octave/funcptr2/example.i b/Examples/octave/funcptr2/example.i
    index 33378a1..bbe50fb 100644
    --- a/Examples/octave/funcptr2/example.i
    +++ b/Examples/octave/funcptr2/example.i
    @@ -1,5 +1,8 @@
     /* File : example.i */
     %module swigexample
    +
    +%feature("autodoc", 1);
    +
     %{
     #include "example.h"
     %}
    diff --git a/Examples/octave/functor/Makefile b/Examples/octave/functor/Makefile
    index 94fb963..acf4d05 100644
    --- a/Examples/octave/functor/Makefile
    +++ b/Examples/octave/functor/Makefile
    @@ -1,17 +1,3 @@
    -TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -CXXSRCS    =
    -TARGET     = swigexample
    -INTERFACE  = example.i
    -LIBS       = -lm
    -SWIGOPT    =
    +CXXSRCS =
     
    -check: build
    -	$(MAKE) -f $(TOP)/Makefile octave_run
    -
    -build:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    -	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' octave_cpp
    -
    -clean:
    -	$(MAKE) -f $(TOP)/Makefile octave_clean
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/octave/functor/example.i b/Examples/octave/functor/example.i
    index ade20c5..0c21a8e 100644
    --- a/Examples/octave/functor/example.i
    +++ b/Examples/octave/functor/example.i
    @@ -1,6 +1,7 @@
     /* File : example.i */
     %module swigexample
     
    +%feature("autodoc", 1);
     
     %inline %{
     // From B. Strousjoup, "The C++ Programming Language, Third Edition", p. 514
    diff --git a/Examples/octave/module_load/Makefile b/Examples/octave/module_load/Makefile
    index e388763..d2cd66e 100644
    --- a/Examples/octave/module_load/Makefile
    +++ b/Examples/octave/module_load/Makefile
    @@ -1,18 +1,7 @@
    -TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = example.c
    -TARGET     = swigexample
    -INTERFACE  = example.i
    +SRCS     = example.c
    +TARGET   = swigexample
    +SWIGOPT  = -module swigexample
    +TARGET2  = swigexample2
    +SWIGOPT2 = -module swigexample2 -globals .
     
    -check: build
    -	$(MAKE) -f $(TOP)/Makefile octave_run
    -
    -build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    -	TARGET='$(TARGET)' SWIGOPT='-module $$(TARGET)' INTERFACE='$(INTERFACE)' octave
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    -	TARGET='$(TARGET)2' SWIGOPT='-module $$(TARGET) -globals .' INTERFACE='$(INTERFACE)' octave
    -
    -clean:
    -	$(MAKE) -f $(TOP)/Makefile octave_clean
    -	rm -f $(TARGET).m
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/octave/module_load/example.i b/Examples/octave/module_load/example.i
    index fd074d4..bd0e399 100644
    --- a/Examples/octave/module_load/example.i
    +++ b/Examples/octave/module_load/example.i
    @@ -1,5 +1,8 @@
     /* File : example.i */
     /* module name given on cmdline */
    +
    +%feature("autodoc", 1);
    +
     %{
     #include "example.h"
     %}
    diff --git a/Examples/octave/module_load/runme.m b/Examples/octave/module_load/runme.m
    index bc311b5..30b7bad 100644
    --- a/Examples/octave/module_load/runme.m
    +++ b/Examples/octave/module_load/runme.m
    @@ -61,9 +61,8 @@ testme
     testme
     clear all
     
    -# octave 3.0.5 randomly crashes on the remaining tests, so skip them
    -api_version = sscanf(octave_config_info("api_version"), "api-v%i");
    -if api_version < 37
    +# octave 3.0.5 randomly crashes on the remaining tests
    +if !swig_octave_prereq(3,2,0)
       exit
     endif
     
    diff --git a/Examples/octave/operator/Makefile b/Examples/octave/operator/Makefile
    index 94fb963..acf4d05 100644
    --- a/Examples/octave/operator/Makefile
    +++ b/Examples/octave/operator/Makefile
    @@ -1,17 +1,3 @@
    -TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -CXXSRCS    =
    -TARGET     = swigexample
    -INTERFACE  = example.i
    -LIBS       = -lm
    -SWIGOPT    =
    +CXXSRCS =
     
    -check: build
    -	$(MAKE) -f $(TOP)/Makefile octave_run
    -
    -build:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    -	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' octave_cpp
    -
    -clean:
    -	$(MAKE) -f $(TOP)/Makefile octave_clean
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/octave/operator/example.i b/Examples/octave/operator/example.i
    index a2d9773..937e8d3 100644
    --- a/Examples/octave/operator/example.i
    +++ b/Examples/octave/operator/example.i
    @@ -1,6 +1,10 @@
     /* File : example.i */
     %module swigexample
    +
    +%feature("autodoc", 1);
    +
     #pragma SWIG nowarn=SWIGWARN_IGNORE_OPERATOR_EQ
    +
     %{
     #include "example.h"
     %}
    @@ -22,4 +26,25 @@
        ComplexVal __paren__(int j) {
          return ComplexVal($self->re()*j,$self->im()*j);
        }
    +
    +   double __float__() {
    +     return (double) $self->re();
    +   }
    +
    +   double __real__() {
    +     return $self->re();
    +   }
    +   double __imag__() {
    +     return $self->im();
    +   }
    +   double __abs__() {
    +     return sqrt($self->re()*$self->re() + $self->im()*$self->im());
    +   }
    +   ComplexVal __conj__() {
    +     return ComplexVal($self->re(), -$self->im());
    +   }
    +   ComplexVal __exp__() {
    +     return exp($self->re()) * ComplexVal(cos($self->im()), sin($self->im()));
    +   }
    +
     };
    diff --git a/Examples/octave/operator/runme.m b/Examples/octave/operator/runme.m
    index 9ab614f..83197b4 100644
    --- a/Examples/octave/operator/runme.m
    +++ b/Examples/octave/operator/runme.m
    @@ -24,3 +24,16 @@ printf("a(3)= %s\n",disp(a(3)));
     
     # friend operator
     printf("2*a = %s\n",disp(2*a));
    +
    +# conversions
    +printf("single(a) = %g\n", single(a));
    +printf("double(a) = %g\n", double(a));
    +
    +# unary functions
    +if swig_octave_prereq(3,8,0)
    +  printf("real(a) = %g\n", real(a));
    +  printf("imag(a) = %g\n", imag(a));
    +  printf("abs(a) = %g\n", abs(a));
    +  printf("conj(a) = %s\n", disp(conj(a)));
    +  printf("exp(a) = %s\n", disp(exp(a)));
    +endif
    diff --git a/Examples/octave/pointer/Makefile b/Examples/octave/pointer/Makefile
    index 73e3962..413b64b 100644
    --- a/Examples/octave/pointer/Makefile
    +++ b/Examples/octave/pointer/Makefile
    @@ -1,15 +1,3 @@
    -TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = example.c
    -TARGET     = swigexample
    -INTERFACE  = example.i
    +SRCS = example.c
     
    -check: build
    -	$(MAKE) -f $(TOP)/Makefile octave_run
    -
    -build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    -	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' octave
    -
    -clean:
    -	$(MAKE) -f $(TOP)/Makefile octave_clean
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/octave/pointer/example.i b/Examples/octave/pointer/example.i
    index 545e3ad..8b9e0f1 100644
    --- a/Examples/octave/pointer/example.i
    +++ b/Examples/octave/pointer/example.i
    @@ -1,6 +1,8 @@
     /* File : example.i */
     %module swigexample
     
    +%feature("autodoc", 1);
    +
     %{
     extern void add(int *, int *, int *);
     extern void sub(int *, int *, int *);
    diff --git a/Examples/octave/reference/Makefile b/Examples/octave/reference/Makefile
    index d38d7f8..3b746de 100644
    --- a/Examples/octave/reference/Makefile
    +++ b/Examples/octave/reference/Makefile
    @@ -1,17 +1,3 @@
    -TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -CXXSRCS    = example.cxx
    -TARGET     = swigexample
    -INTERFACE  = example.i
    -LIBS       = -lm
    -SWIGOPT    =
    +CXXSRCS = example.cxx
     
    -check: build
    -	$(MAKE) -f $(TOP)/Makefile octave_run
    -
    -build:
    -	$(MAKE) -f $(TOP)/Makefile $(SWIGLIB) CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    -	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' octave_cpp
    -
    -clean:
    -	$(MAKE) -f $(TOP)/Makefile octave_clean
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/octave/reference/example.cxx b/Examples/octave/reference/example.cxx
    index 9b72ca6..632a03a 100644
    --- a/Examples/octave/reference/example.cxx
    +++ b/Examples/octave/reference/example.cxx
    @@ -19,7 +19,7 @@ Vector operator+(const Vector &a, const Vector &b) {
     
     char *Vector::print() {
       static char temp[512];
    -  sprintf(temp,"Vector %p (%g,%g,%g)", this, x,y,z);
    +  sprintf(temp,"Vector %p (%g,%g,%g)", (void *)this, x,y,z);
       return temp;
     }
     
    diff --git a/Examples/octave/reference/example.h b/Examples/octave/reference/example.h
    index 697afaf..bcfcfb7 100644
    --- a/Examples/octave/reference/example.h
    +++ b/Examples/octave/reference/example.h
    @@ -4,8 +4,8 @@ class Vector {
     private:
       double x,y,z;
     public:
    -  Vector() : x(0), y(0), z(0) { };
    -  Vector(double x, double y, double z) : x(x), y(y), z(z) { };
    +  Vector() : x(0), y(0), z(0) { }
    +  Vector(double x, double y, double z) : x(x), y(y), z(z) { }
       friend Vector operator+(const Vector &a, const Vector &b);
       char *print();
     };
    diff --git a/Examples/octave/reference/example.i b/Examples/octave/reference/example.i
    index da09800..0aa7334 100644
    --- a/Examples/octave/reference/example.i
    +++ b/Examples/octave/reference/example.i
    @@ -4,6 +4,8 @@
     
     %module swigexample
     
    +%feature("autodoc", 1);
    +
     %{
     #include "example.h"
     %}
    diff --git a/Examples/octave/simple/Makefile b/Examples/octave/simple/Makefile
    index 73e3962..413b64b 100644
    --- a/Examples/octave/simple/Makefile
    +++ b/Examples/octave/simple/Makefile
    @@ -1,15 +1,3 @@
    -TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = example.c
    -TARGET     = swigexample
    -INTERFACE  = example.i
    +SRCS = example.c
     
    -check: build
    -	$(MAKE) -f $(TOP)/Makefile octave_run
    -
    -build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    -	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' octave
    -
    -clean:
    -	$(MAKE) -f $(TOP)/Makefile octave_clean
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/octave/simple/example.i b/Examples/octave/simple/example.i
    index 127bfcd..a3006f2 100644
    --- a/Examples/octave/simple/example.i
    +++ b/Examples/octave/simple/example.i
    @@ -1,6 +1,8 @@
     /* File : example.i */
     %module swigexample
     
    +%feature("autodoc", 1);
    +
     %inline %{
     extern int    gcd(int x, int y);
     extern double Foo;
    diff --git a/Examples/octave/template/Makefile b/Examples/octave/template/Makefile
    index 94fb963..acf4d05 100644
    --- a/Examples/octave/template/Makefile
    +++ b/Examples/octave/template/Makefile
    @@ -1,17 +1,3 @@
    -TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -CXXSRCS    =
    -TARGET     = swigexample
    -INTERFACE  = example.i
    -LIBS       = -lm
    -SWIGOPT    =
    +CXXSRCS =
     
    -check: build
    -	$(MAKE) -f $(TOP)/Makefile octave_run
    -
    -build:
    -	$(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \
    -	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' octave_cpp
    -
    -clean:
    -	$(MAKE) -f $(TOP)/Makefile octave_clean
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/octave/template/example.i b/Examples/octave/template/example.i
    index cfff18d..3c57f38 100644
    --- a/Examples/octave/template/example.i
    +++ b/Examples/octave/template/example.i
    @@ -1,6 +1,8 @@
     /* File : example.i */
     %module swigexample
     
    +%feature("autodoc", 1);
    +
     %{
     #include "example.h"
     %}
    diff --git a/Examples/octave/variables/Makefile b/Examples/octave/variables/Makefile
    index 73e3962..413b64b 100644
    --- a/Examples/octave/variables/Makefile
    +++ b/Examples/octave/variables/Makefile
    @@ -1,15 +1,3 @@
    -TOP        = ../..
    -SWIG       = $(TOP)/../preinst-swig
    -SRCS       = example.c
    -TARGET     = swigexample
    -INTERFACE  = example.i
    +SRCS = example.c
     
    -check: build
    -	$(MAKE) -f $(TOP)/Makefile octave_run
    -
    -build:
    -	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
    -	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' octave
    -
    -clean:
    -	$(MAKE) -f $(TOP)/Makefile octave_clean
    +include $(SRCDIR)../example.mk
    diff --git a/Examples/octave/variables/example.c b/Examples/octave/variables/example.c
    index 15dcc1b..a9102a9 100644
    --- a/Examples/octave/variables/example.c
    +++ b/Examples/octave/variables/example.c
    @@ -51,10 +51,10 @@ void print_vars() {
       printf("dvar      = %g\n", dvar);
       printf("cvar      = %c\n", cvar);
       printf("strvar    = %s\n", strvar ? strvar : "(null)");
    -  printf("cstrvar   = %s\n", cstrvar ? cstrvar : "(null)");
    -  printf("iptrvar   = %p\n", iptrvar);
    +  printf("cstrvar   = %s\n", cstrvar);
    +  printf("iptrvar   = %p\n", (void *)iptrvar);
       printf("name      = %s\n", name);
    -  printf("ptptr     = %p (%d, %d)\n", ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0);
    +  printf("ptptr     = %p (%d, %d)\n", (void *)ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0);
       printf("pt        = (%d, %d)\n", pt.x, pt.y);
       printf("status    = %d\n", status);
     }
    diff --git a/Examples/octave/variables/example.i b/Examples/octave/variables/example.i
    index 3e11495..9d8b03e 100644
    --- a/Examples/octave/variables/example.i
    +++ b/Examples/octave/variables/example.i
    @@ -1,5 +1,8 @@
     /* File : example.i */
     %module swigexample
    +
    +%feature("autodoc", 1);
    +
     %{
     #include "example.h"
     %}
    diff --git a/Examples/perl5/callback/Makefile b/Examples/perl5/callback/Makefile
    new file mode 100644
    index 0000000..0827176
    --- /dev/null
    +++ b/Examples/perl5/callback/Makefile
    @@ -0,0 +1,23 @@
    +TOP        = ../..
    +SWIGEXE    = $(TOP)/../swig
    +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib
    +CXXSRCS    = example.cxx
    +TARGET     = example
    +INTERFACE  = example.i
    +LIBS       = -lm
    +
    +check: build
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_run
    +
    +build:
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' perl5_cpp
    +
    +static:
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \
    +	SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \
    +	TARGET='myperl' INTERFACE='$(INTERFACE)' perl5_cpp_static
    +
    +clean:
    +	$(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_clean
    diff --git a/Examples/perl5/callback/example.cxx b/Examples/perl5/callback/example.cxx
    new file mode 100644
    index 0000000..450d756
    --- /dev/null
    +++ b/Examples/perl5/callback/example.cxx
    @@ -0,0 +1,4 @@
    +/* File : example.cxx */
    +
    +#include "example.h"
    +
    diff --git a/Examples/perl5/callback/example.h b/Examples/perl5/callback/example.h
    new file mode 100644
    index 0000000..1a0e8c4
    --- /dev/null
    +++ b/Examples/perl5/callback/example.h
    @@ -0,0 +1,23 @@
    +/* File : example.h */
    +
    +#include 
    +#include 
    +
    +class Callback {
    +public:
    +	virtual ~Callback() { std::cout << "Callback::~Callback()" << std:: endl; }
    +	virtual void run() { std::cout << "Callback::run()" << std::endl; }
    +};
    +
    +
    +class Caller {
    +private:
    +	Callback *_callback;
    +public:
    +	Caller(): _callback(0) {}
    +	~Caller() { delCallback(); }
    +	void delCallback() { delete _callback; _callback = 0; }
    +	void setCallback(Callback *cb) { delCallback(); _callback = cb; }
    +	void call() { if (_callback) _callback->run(); }
    +};
    +
    diff --git a/Examples/perl5/callback/example.i b/Examples/perl5/callback/example.i
    new file mode 100644
    index 0000000..821a9e6
    --- /dev/null
    +++ b/Examples/perl5/callback/example.i
    @@ -0,0 +1,15 @@
    +/* File : example.i */
    +%module(directors="1") example
    +%{
    +#include "example.h"
    +%}
    +
    +/* turn on director wrapping Callback */
    +%feature("director") Callback;
    +
    +/* Caller::setCallback(Callback *cb) gives ownership of the cb to the
    + * Caller object.  The wrapper code should understand this. */
    +%apply SWIGTYPE *DISOWN { Callback *cb }; 
    +
    +%include "example.h"
    +
    diff --git a/Examples/perl5/callback/index.html b/Examples/perl5/callback/index.html
    new file mode 100644
    index 0000000..82f5e97
    --- /dev/null
    +++ b/Examples/perl5/callback/index.html
    @@ -0,0 +1,20 @@
    +
    +
    +SWIG:Examples:perl5:callback
    +
    +
    +
    +
    +
    +SWIG/Examples/perl/callback/
    +
    + +

    Implementing C++ callbacks in Perl

    + +

    +This example illustrates how to use directors to implement C++ callbacks. +

    + +
    + + diff --git a/Examples/perl5/callback/runme.pl b/Examples/perl5/callback/runme.pl new file mode 100644 index 0000000..54d8678 --- /dev/null +++ b/Examples/perl5/callback/runme.pl @@ -0,0 +1,48 @@ +# file: runme.pl + +# This file illustrates the cross language polymorphism using directors. + +use example; + + +{ + package PlCallback; + use base 'example::Callback'; + sub run { + print "PlCallback->run()\n"; + } +} + +# Create an Caller instance + +$caller = example::Caller->new(); + +# Add a simple C++ callback (caller owns the callback, so +# we disown it first by clearing the .thisown flag). + +print "Adding and calling a normal C++ callback\n"; +print "----------------------------------------\n"; + +$callback = example::Callback->new(); +$callback->DISOWN(); +$caller->setCallback($callback); +$caller->call(); +$caller->delCallback(); + +print "\n"; +print "Adding and calling a Perl callback\n"; +print "----------------------------------\n"; + +# Add a Perl callback (caller owns the callback, so we +# disown it first by calling DISOWN). + +$callback = PlCallback->new(); +$callback->DISOWN(); +$caller->setCallback($callback); +$caller->call(); +$caller->delCallback(); + +# All done. + +print "\n"; +print "perl exit\n"; diff --git a/Examples/perl5/check.list b/Examples/perl5/check.list index e15f02e..dda8493 100644 --- a/Examples/perl5/check.list +++ b/Examples/perl5/check.list @@ -1,7 +1,9 @@ # see top-level Makefile.in +callback class constants constants2 +extend funcptr import java diff --git a/Examples/perl5/class/Makefile b/Examples/perl5/class/Makefile index 544d136..0827176 100644 --- a/Examples/perl5/class/Makefile +++ b/Examples/perl5/class/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile perl5_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' perl5_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myperl' INTERFACE='$(INTERFACE)' perl5_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile perl5_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_clean diff --git a/Examples/perl5/class/example.cxx b/Examples/perl5/class/example.cxx index 1e8e203..0463045 100644 --- a/Examples/perl5/class/example.cxx +++ b/Examples/perl5/class/example.cxx @@ -1,4 +1,4 @@ -/* File : example.c */ +/* File : example.cxx */ #include "example.h" #define M_PI 3.14159265358979323846 @@ -11,18 +11,18 @@ void Shape::move(double dx, double dy) { int Shape::nshapes = 0; -double Circle::area(void) { +double Circle::area() { return M_PI*radius*radius; } -double Circle::perimeter(void) { +double Circle::perimeter() { return 2*M_PI*radius; } -double Square::area(void) { +double Square::area() { return width*width; } -double Square::perimeter(void) { +double Square::perimeter() { return 4*width; } diff --git a/Examples/perl5/class/example.h b/Examples/perl5/class/example.h index b0671d5..fd69435 100644 --- a/Examples/perl5/class/example.h +++ b/Examples/perl5/class/example.h @@ -7,11 +7,11 @@ public: } virtual ~Shape() { nshapes--; - }; - double x, y; + } + double x, y; void move(double dx, double dy); - virtual double area(void) = 0; - virtual double perimeter(void) = 0; + virtual double area() = 0; + virtual double perimeter() = 0; static int nshapes; }; @@ -19,29 +19,24 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; - virtual double area(void); - virtual double perimeter(void); + Circle(double r) : radius(r) { } + virtual double area(); + virtual double perimeter(); }; class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; - virtual double area(void); - virtual double perimeter(void); + Square(double w) : width(w) { } + virtual double area(); + virtual double perimeter(); }; typedef Square TSquare; class CFoo { public: - static Square MakeSquare(void) {return Square(4.0);}; - static TSquare MakeTSquare(void) {return Square(4.0);}; + static Square MakeSquare(void) {return Square(4.0);} + static TSquare MakeTSquare(void) {return Square(4.0);} }; - - - - - diff --git a/Examples/perl5/class/example.i b/Examples/perl5/class/example.i index 23ee8a8..fbdf724 100644 --- a/Examples/perl5/class/example.i +++ b/Examples/perl5/class/example.i @@ -6,6 +6,4 @@ %} /* Let's just grab the original header file here */ - %include "example.h" - diff --git a/Examples/perl5/class/index.html b/Examples/perl5/class/index.html index 58a50ad..b4f923b 100644 --- a/Examples/perl5/class/index.html +++ b/Examples/perl5/class/index.html @@ -32,8 +32,8 @@ public: } virtual ~Shape() { nshapes--; - }; - double x, y; + } + double x, y; void move(double dx, double dy); virtual double area() = 0; virtual double perimeter() = 0; @@ -44,7 +44,7 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; + Circle(double r) : radius(r) { } virtual double area(); virtual double perimeter(); }; @@ -53,7 +53,7 @@ class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; + Square(double w) : width(w) { } virtual double area(); virtual double perimeter(); }; @@ -82,7 +82,7 @@ like this: Note: when creating a C++ extension, you must run SWIG with the -c++ option like this:
    -% swig -c++ -python example.i
    +% swig -c++ -perl example.i
     
    @@ -97,60 +97,45 @@ Click here to see a script that calls the C++ functions f
    -$c = example::new_Circle(10.0);
    +$c = new example::Circle(10.0);
     

    -

  • To access member data, a pair of accessor functions are used. -For example: +
  • You can access member data like so:
    -example::Shape_x_set($c,15);    # Set member data
    -$x = example::Shape_x_get($c);   # Get member data
    +$c->{x} = 15;    # Set member data
    +$x = $c->{x};    # Get member data
     
    -Note: when accessing member data, the name of the class in which -the data member is defined is used. For example Shape_x_get(). -

    -

  • To invoke a member function, you simply do this +
  • To invoke a member function, you simply do this:
    -print "The area is ", example::Shape_area($c);
    +print "The area is ", $c->area();
     

    -

  • Type checking knows about the inheritance structure of C++. For example: +
  • To invoke a destructor, simply do this:
    -example::Shape_area($c);       # Works (c is a Shape)
    -example::Circle_area($c);      # Works (c is a Circle)
    -example::Square_area($c);      # Fails (c is definitely not a Square)
    +$c->DESTROY();   # Deletes a shape
     

    -

  • To invoke a destructor, simply do this +
  • Static member variables are wrapped like so:
    -example::delete_Shape($c);     # Deletes a shape
    -
    -
    - -

    -

  • Static member variables are wrapped as C global variables. For example: - -
    -
    -$n = $example::Shape_nshapes;     # Get a static data member
    -$example::Shapes_nshapes = 13;   # Set a static data member
    +$n = $example::Shape::nshapes;    # Get a static data member
    +$example::Shapes::nshapes = 13;   # Set a static data member
     
    @@ -159,47 +144,11 @@ $example::Shapes_nshapes = 13; # Set a static data member

    General Comments

      -
    • This low-level interface is not the only way to handle C++ code. Proxy classes -provide a much higher-level interface. - -

      -

    • SWIG *does* know how to properly perform upcasting of objects in an inheritance +
    • SWIG does know how to properly perform upcasting of objects in an inheritance hierarchy (including multiple inheritance). Therefore it is perfectly safe to pass an object of a derived class to any function involving a base class. -

      -

    • A wide variety of C++ features are not currently supported by SWIG. Here is the -short and incomplete list: - -

      -

        -
      • Overloaded methods and functions. SWIG wrappers don't know how to resolve name -conflicts so you must give an alternative name to any overloaded method name using the -%name directive like this: - -
        -
        -void foo(int a);  
        -%name(foo2) void foo(double a, double b);
        -
        -
        - -

        -

      • Overloaded operators. Not supported at all. The only workaround for this is -to write a helper function. For example: - -
        -
        -%inline %{
        -    Vector *vector_add(Vector *a, Vector *b) {
        -          ... whatever ...
        -    }
        -%}
        -
        -
        - -

        -

      • Namespaces. Not supported at all. Won't be supported until SWIG2.0 (if at all). +
      • C++ Namespaces - %nspace isn't yet supported for Perl.
      diff --git a/Examples/perl5/class/runme.pl b/Examples/perl5/class/runme.pl index 076e143..e45e2b8 100644 --- a/Examples/perl5/class/runme.pl +++ b/Examples/perl5/class/runme.pl @@ -40,7 +40,7 @@ foreach $o ($c,$s) { print " $o\n"; print " area = ", $o->area(), "\n"; print " perimeter = ", $o->perimeter(), "\n"; - } +} # ----- Delete everything ----- diff --git a/Examples/perl5/constants/Makefile b/Examples/perl5/constants/Makefile index 8992829..b0dc678 100644 --- a/Examples/perl5/constants/Makefile +++ b/Examples/perl5/constants/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = TARGET = example INTERFACE = example.i SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile perl5_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' perl5 static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myperl' INTERFACE='$(INTERFACE)' perl5_static clean: - $(MAKE) -f $(TOP)/Makefile perl5_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_clean diff --git a/Examples/perl5/constants2/Makefile b/Examples/perl5/constants2/Makefile index 2ed10d7..db676cc 100644 --- a/Examples/perl5/constants2/Makefile +++ b/Examples/perl5/constants2/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = TARGET = example INTERFACE = example.i SWIGOPT = -const check: build - $(MAKE) -f $(TOP)/Makefile perl5_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' perl5 static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myperl' INTERFACE='$(INTERFACE)' perl5_static clean: - $(MAKE) -f $(TOP)/Makefile perl5_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_clean diff --git a/Examples/perl5/extend/Makefile b/Examples/perl5/extend/Makefile new file mode 100644 index 0000000..0827176 --- /dev/null +++ b/Examples/perl5/extend/Makefile @@ -0,0 +1,23 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = example.cxx +TARGET = example +INTERFACE = example.i +LIBS = -lm + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' perl5_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='myperl' INTERFACE='$(INTERFACE)' perl5_cpp_static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_clean diff --git a/Examples/perl5/extend/example.cxx b/Examples/perl5/extend/example.cxx new file mode 100644 index 0000000..450d756 --- /dev/null +++ b/Examples/perl5/extend/example.cxx @@ -0,0 +1,4 @@ +/* File : example.cxx */ + +#include "example.h" + diff --git a/Examples/python/swigrun/example.h b/Examples/perl5/extend/example.h similarity index 92% rename from Examples/python/swigrun/example.h rename to Examples/perl5/extend/example.h index 69e6fe4..ca1aed2 100644 --- a/Examples/python/swigrun/example.h +++ b/Examples/perl5/extend/example.h @@ -14,7 +14,7 @@ public: virtual std::string getTitle() { return getPosition() + " " + getName(); } virtual std::string getName() { return name; } virtual std::string getPosition() const { return "Employee"; } - virtual ~Employee() { printf("~Employee() @ %p\n", this); } + virtual ~Employee() { printf("~Employee() @ %p\n", (void *)this); } }; @@ -54,5 +54,3 @@ public: } }; -Manager* convert_to_Manager(PyObject *obj); - diff --git a/Examples/python/swigrun/example.i b/Examples/perl5/extend/example.i similarity index 57% rename from Examples/python/swigrun/example.i rename to Examples/perl5/extend/example.i index c8ec32e..f5e142b 100644 --- a/Examples/python/swigrun/example.i +++ b/Examples/perl5/extend/example.i @@ -11,5 +11,10 @@ %feature("director") Employee; %feature("director") Manager; +/* EmployeeList::addEmployee(Employee *p) gives ownership of the + * employee to the EmployeeList object. The wrapper code should + * understand this. */ +%apply SWIGTYPE *DISOWN { Employee *p }; + %include "example.h" diff --git a/Examples/perl5/extend/index.html b/Examples/perl5/extend/index.html new file mode 100644 index 0000000..e9d886b --- /dev/null +++ b/Examples/perl5/extend/index.html @@ -0,0 +1,19 @@ + + +SWIG:Examples:perl5:extend + + + + + +SWIG/Examples/perl5/extend/ +
      + +

      Extending a simple C++ class

      + +

      +This example illustrates the extending of a C++ class with cross language polymorphism. + +


      + + diff --git a/Examples/perl5/extend/runme.pl b/Examples/perl5/extend/runme.pl new file mode 100644 index 0000000..76ee849 --- /dev/null +++ b/Examples/perl5/extend/runme.pl @@ -0,0 +1,79 @@ +# file: runme.pl + +# This file illustrates the cross language polymorphism using directors. + +use example; + + +# CEO class, which overrides Employee::getPosition(). + +{ + package CEO; + use base 'example::Manager'; + sub getPosition { + return "CEO"; + } +} + + +# Create an instance of our employee extension class, CEO. The calls to +# getName() and getPosition() are standard, the call to getTitle() uses +# the director wrappers to call CEO->getPosition. $e = CEO->new("Alice") + +$e = CEO->new("Alice"); +print $e->getName(), " is a ", $e->getPosition(), "\n"; +printf "Just call her \"%s\"\n", $e->getTitle(); +print "----------------------\n"; + + +# Create a new EmployeeList instance. This class does not have a C++ +# director wrapper, but can be used freely with other classes that do. + +$list = example::EmployeeList->new(); + +# EmployeeList owns its items, so we must surrender ownership of objects +# we add. This involves calling the DISOWN method to tell the +# C++ director to start reference counting. + +$e->DISOWN(); +$list->addEmployee($e); +print "----------------------\n"; + +# Now we access the first four items in list (three are C++ objects that +# EmployeeList's constructor adds, the last is our CEO). The virtual +# methods of all these instances are treated the same. For items 0, 1, and +# 2, both all methods resolve in C++. For item 3, our CEO, getTitle calls +# getPosition which resolves in Perl. The call to getPosition is +# slightly different, however, from the $e->getPosition() call above, since +# now the object reference has been "laundered" by passing through +# EmployeeList as an Employee*. Previously, Perl resolved the call +# immediately in CEO, but now Perl thinks the object is an instance of +# class Employee (actually EmployeePtr). So the call passes through the +# Employee proxy class and on to the C wrappers and C++ director, +# eventually ending up back at the CEO implementation of getPosition(). +# The call to getTitle() for item 3 runs the C++ Employee::getTitle() +# method, which in turn calls getPosition(). This virtual method call +# passes down through the C++ director class to the Perl implementation +# in CEO. All this routing takes place transparently. + +print "(position, title) for items 0-3:\n"; + +printf " %s, \"%s\"\n", $list->get_item(0)->getPosition(), $list->get_item(0)->getTitle(); +printf " %s, \"%s\"\n", $list->get_item(1)->getPosition(), $list->get_item(1)->getTitle(); +printf " %s, \"%s\"\n", $list->get_item(2)->getPosition(), $list->get_item(2)->getTitle(); +printf " %s, \"%s\"\n", $list->get_item(3)->getPosition(), $list->get_item(3)->getTitle(); +print "----------------------\n"; + +# Time to delete the EmployeeList, which will delete all the Employee* +# items it contains. The last item is our CEO, which gets destroyed as its +# reference count goes to zero. The Perl destructor runs, and is still +# able to call self.getName() since the underlying C++ object still +# exists. After this destructor runs the remaining C++ destructors run as +# usual to destroy the object. + +undef $list; +print "----------------------\n"; + +# All done. + +print "perl exit\n"; diff --git a/Examples/perl5/funcptr/Makefile b/Examples/perl5/funcptr/Makefile index c4d1000..dfc0184 100644 --- a/Examples/perl5/funcptr/Makefile +++ b/Examples/perl5/funcptr/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile perl5_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' perl5 static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myperl' INTERFACE='$(INTERFACE)' perl5_static clean: - $(MAKE) -f $(TOP)/Makefile perl5_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_clean diff --git a/Examples/perl5/import/Makefile b/Examples/perl5/import/Makefile index baa8277..e9225af 100644 --- a/Examples/perl5/import/Makefile +++ b/Examples/perl5/import/Makefile @@ -1,20 +1,25 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SWIGOPT = LIBS = check: build - $(MAKE) -f $(TOP)/Makefile perl5_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_run build: - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='baseclass' INTERFACE='base.i' perl5_cpp - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' perl5_cpp - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' perl5_cpp - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='spam' INTERFACE='spam.i' perl5_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='baseclass' INTERFACE='base.i' perl5_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' perl5_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' perl5_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='spam' INTERFACE='spam.i' perl5_cpp clean: - $(MAKE) -f $(TOP)/Makefile perl5_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_clean diff --git a/Examples/perl5/import/base.h b/Examples/perl5/import/base.h index 5a266f6..c0b4795 100644 --- a/Examples/perl5/import/base.h +++ b/Examples/perl5/import/base.h @@ -2,8 +2,8 @@ class Base { public: - Base() { }; - virtual ~Base() { }; + Base() { } + virtual ~Base() { } virtual void A() { printf("I'm Base::A\n"); } diff --git a/Examples/perl5/index.html b/Examples/perl5/index.html index db46023..23c8ff6 100644 --- a/Examples/perl5/index.html +++ b/Examples/perl5/index.html @@ -20,6 +20,8 @@ certain C declarations are turned into constants.
    • reference. C++ references.
    • pointer. Simple pointer handling.
    • funcptr. Pointers to functions. +
    • callback. C++ callbacks using directors. +
    • extend. Extending a simple C++ class.

    Compilation Issues

    diff --git a/Examples/perl5/inline/Makefile b/Examples/perl5/inline/Makefile index d544a65..5c98748 100644 --- a/Examples/perl5/inline/Makefile +++ b/Examples/perl5/inline/Makefile @@ -1,6 +1,6 @@ run: - $(MAKE) -f $(TOP)/Makefile perl5_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_run clean: - $(MAKE) -f $(TOP)/Makefile perl5_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_clean rm -rf _Inline diff --git a/Examples/perl5/java/Makefile b/Examples/perl5/java/Makefile index b007cfd..7c13323 100644 --- a/Examples/perl5/java/Makefile +++ b/Examples/perl5/java/Makefile @@ -1,22 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile perl5_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_run -build: Example.class - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ - TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' CXX="gcj" \ +build: Example.class Example.h + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ CXXSHARED="gcj -fpic -shared Example.class" PERL5_CCFLAGS='' PERL5_EXP='' LIBS="-lstdc++" perl5_cpp clean: - $(MAKE) -f $(TOP)/Makefile perl5_clean - rm -f *.class Example.h + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_clean + rm -f *.class Example.h -Example.class: Example.java - gcj -fPIC -C -c -g Example.java - gcjh Example +Example.class Example.h: $(SRCDIR)Example.java + gcj -d . -fPIC -C -c -g $(SRCDIR)Example.java + gcjh Example.class diff --git a/Examples/perl5/multimap/Makefile b/Examples/perl5/multimap/Makefile index c4d1000..dfc0184 100644 --- a/Examples/perl5/multimap/Makefile +++ b/Examples/perl5/multimap/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile perl5_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' perl5 static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myperl' INTERFACE='$(INTERFACE)' perl5_static clean: - $(MAKE) -f $(TOP)/Makefile perl5_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_clean diff --git a/Examples/perl5/multiple_inheritance/Makefile b/Examples/perl5/multiple_inheritance/Makefile index 18c3058..b73356e 100644 --- a/Examples/perl5/multiple_inheritance/Makefile +++ b/Examples/perl5/multiple_inheritance/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i -LIBS = +LIBS = check: build - $(MAKE) -f $(TOP)/Makefile perl5_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' perl5_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myperl' INTERFACE='$(INTERFACE)' perl5_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile perl5_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_clean diff --git a/Examples/perl5/pointer/Makefile b/Examples/perl5/pointer/Makefile index c4d1000..dfc0184 100644 --- a/Examples/perl5/pointer/Makefile +++ b/Examples/perl5/pointer/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile perl5_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' perl5 static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myperl' INTERFACE='$(INTERFACE)' perl5_static clean: - $(MAKE) -f $(TOP)/Makefile perl5_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_clean diff --git a/Examples/perl5/reference/Makefile b/Examples/perl5/reference/Makefile index d33dd89..c421209 100644 --- a/Examples/perl5/reference/Makefile +++ b/Examples/perl5/reference/Makefile @@ -1,21 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm -SWIGOPT = -noproxy +SWIGOPT = -noproxy check: build - $(MAKE) -f $(TOP)/Makefile perl5_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' SWIGOPT='$(SWIGOPT)' perl5_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myperl' INTERFACE='$(INTERFACE)' SWIGOPT='$(SWIGOPT)' perl5_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile perl5_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_clean diff --git a/Examples/perl5/reference/example.cxx b/Examples/perl5/reference/example.cxx index 8a513bf..9dbaed2 100644 --- a/Examples/perl5/reference/example.cxx +++ b/Examples/perl5/reference/example.cxx @@ -19,7 +19,7 @@ Vector operator+(const Vector &a, const Vector &b) { char *Vector::print() { static char temp[512]; - sprintf(temp,"Vector %p (%g,%g,%g)", this, x,y,z); + sprintf(temp,"Vector %p (%g,%g,%g)", (void *)this, x,y,z); return temp; } diff --git a/Examples/perl5/reference/example.h b/Examples/perl5/reference/example.h index 4915adb..bcfcfb7 100644 --- a/Examples/perl5/reference/example.h +++ b/Examples/perl5/reference/example.h @@ -4,8 +4,8 @@ class Vector { private: double x,y,z; public: - Vector() : x(0), y(0), z(0) { }; - Vector(double x, double y, double z) : x(x), y(y), z(z) { }; + Vector() : x(0), y(0), z(0) { } + Vector(double x, double y, double z) : x(x), y(y), z(z) { } friend Vector operator+(const Vector &a, const Vector &b); char *print(); }; @@ -20,7 +20,3 @@ public: Vector &operator[](int); int size(); }; - - - - diff --git a/Examples/perl5/reference/example.i b/Examples/perl5/reference/example.i index 6daa3b1..173143d 100644 --- a/Examples/perl5/reference/example.i +++ b/Examples/perl5/reference/example.i @@ -29,7 +29,7 @@ public: VectorArray(int maxsize); ~VectorArray(); int size(); - + /* This wrapper provides an alternative to the [] operator */ %extend { Vector &get(int index) { @@ -40,7 +40,3 @@ public: } } }; - - - - diff --git a/Examples/perl5/simple/Makefile b/Examples/perl5/simple/Makefile index c4d1000..dfc0184 100644 --- a/Examples/perl5/simple/Makefile +++ b/Examples/perl5/simple/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile perl5_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' perl5 static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myperl' INTERFACE='$(INTERFACE)' perl5_static clean: - $(MAKE) -f $(TOP)/Makefile perl5_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_clean diff --git a/Examples/perl5/value/Makefile b/Examples/perl5/value/Makefile index c4d1000..dfc0184 100644 --- a/Examples/perl5/value/Makefile +++ b/Examples/perl5/value/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile perl5_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' perl5 static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myperl' INTERFACE='$(INTERFACE)' perl5_static clean: - $(MAKE) -f $(TOP)/Makefile perl5_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_clean diff --git a/Examples/perl5/value/example.i b/Examples/perl5/value/example.i index 98fd60e..39663c6 100644 --- a/Examples/perl5/value/example.i +++ b/Examples/perl5/value/example.i @@ -26,7 +26,7 @@ Vector *new_Vector(double x, double y, double z) { } void vector_print(Vector *v) { - printf("Vector %p = (%g, %g, %g)\n", v, v->x, v->y, v->z); + printf("Vector %p = (%g, %g, %g)\n", (void *)v, v->x, v->y, v->z); } %} diff --git a/Examples/perl5/variables/Makefile b/Examples/perl5/variables/Makefile index c4d1000..dfc0184 100644 --- a/Examples/perl5/variables/Makefile +++ b/Examples/perl5/variables/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile perl5_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' perl5 static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myperl' INTERFACE='$(INTERFACE)' perl5_static clean: - $(MAKE) -f $(TOP)/Makefile perl5_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_clean diff --git a/Examples/perl5/variables/example.c b/Examples/perl5/variables/example.c index aa4ffe9..85685fe 100644 --- a/Examples/perl5/variables/example.c +++ b/Examples/perl5/variables/example.c @@ -51,10 +51,10 @@ void print_vars() { printf("dvar = %g\n", dvar); printf("cvar = %c\n", cvar); printf("strvar = %s\n", strvar ? strvar : "(null)"); - printf("cstrvar = %s\n", cstrvar ? cstrvar : "(null)"); - printf("iptrvar = %p\n", iptrvar); + printf("cstrvar = %s\n", cstrvar); + printf("iptrvar = %p\n", (void *)iptrvar); printf("name = %s\n", name); - printf("ptptr = %p (%d, %d)\n", ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0); + printf("ptptr = %p (%d, %d)\n", (void *)ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0); printf("pt = (%d, %d)\n", pt.x, pt.y); printf("status = %d\n", status); } diff --git a/Examples/perl5/xmlstring/Makefile b/Examples/perl5/xmlstring/Makefile index df9dabd..3b4ba0e 100644 --- a/Examples/perl5/xmlstring/Makefile +++ b/Examples/perl5/xmlstring/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lxerces-c -lxerces-depdom -lm check: build - $(MAKE) -f $(TOP)/Makefile perl5_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' LIBS=$(LIBS) CXX="g++ -g3" perl5_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myperl' INTERFACE='$(INTERFACE)' perl5_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile perl5_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' perl5_clean diff --git a/Examples/perl5/xmlstring/xmlstring.i b/Examples/perl5/xmlstring/xmlstring.i index 3ef5316..861e1b8 100644 --- a/Examples/perl5/xmlstring/xmlstring.i +++ b/Examples/perl5/xmlstring/xmlstring.i @@ -93,6 +93,17 @@ SWIG_FromXMLChPtrAndSize(const XMLCh* input, size_t size) } } +%fragment("SWIG_XMLStringNLen","header") { +size_t +SWIG_XMLStringNLen(const XMLCh* s, size_t maxlen) +{ + const XMLCh *p; + for (p = s; maxlen-- && *p; p++) + ; + return p - s; +} +} + %init { if (!SWIG_UTF8Transcoder()) { croak("ERROR: XML::Xerces: INIT: Could not create UTF-8 transcoder"); @@ -106,6 +117,7 @@ SWIG_FromXMLChPtrAndSize(const XMLCh* input, size_t size) SWIG_AsXMLChPtrAndSize, SWIG_FromXMLChPtrAndSize, XERCES_CPP_NAMESPACE::XMLString::stringLen, + SWIG_XMLStringNLen, "", INT_MIN, INT_MAX); diff --git a/Examples/php/callback/Makefile b/Examples/php/callback/Makefile index 08b2710..cbc7577 100644 --- a/Examples/php/callback/Makefile +++ b/Examples/php/callback/Makefile @@ -1,21 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile php_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_run build: - $(MAKE) -f $(TOP)/Makefile $(SWIGLIB) CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' $(SWIGLIB) CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' php_cpp static: - $(MAKE) -f $(TOP)/Makefile $(SWIGLIB) CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' $(SWIGLIB) CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myphp' INTERFACE='$(INTERFACE)' php_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile php_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_clean diff --git a/Examples/php/callback/example.i b/Examples/php/callback/example.i index 90beda0..cf61ef9 100644 --- a/Examples/php/callback/example.i +++ b/Examples/php/callback/example.i @@ -4,8 +4,6 @@ #include "example.h" %} -%include "std_string.i" - /* turn on director wrapping Callback */ %feature("director") Callback; diff --git a/Examples/php/class/Makefile b/Examples/php/class/Makefile index cefd81f..02a8668 100644 --- a/Examples/php/class/Makefile +++ b/Examples/php/class/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i @@ -7,17 +8,19 @@ LIBS = SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile php_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ php_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myphp' INTERFACE='$(INTERFACE)' \ php_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile php_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_clean diff --git a/Examples/php/class/example.cxx b/Examples/php/class/example.cxx index f171f10..0463045 100644 --- a/Examples/php/class/example.cxx +++ b/Examples/php/class/example.cxx @@ -1,14 +1,7 @@ -/* File : example.c */ +/* File : example.cxx */ #include "example.h" -#include -#ifndef M_PI -# define M_PI 3.14159265358979323846 -#endif - -int Shape::get_nshapes() { - return nshapes; -} +#define M_PI 3.14159265358979323846 /* Move the shape to a new location */ void Shape::move(double dx, double dy) { @@ -18,22 +11,18 @@ void Shape::move(double dx, double dy) { int Shape::nshapes = 0; -void Circle::set_radius( double r ) { - radius = r; -} - -double Circle::area(void) { +double Circle::area() { return M_PI*radius*radius; } -double Circle::perimeter(void) { +double Circle::perimeter() { return 2*M_PI*radius; } -double Square::area(void) { +double Square::area() { return width*width; } -double Square::perimeter(void) { +double Square::perimeter() { return 4*width; } diff --git a/Examples/php/class/example.h b/Examples/php/class/example.h index 02eaf72..0dff185 100644 --- a/Examples/php/class/example.h +++ b/Examples/php/class/example.h @@ -10,10 +10,9 @@ public: } double x, y; void move(double dx, double dy); - virtual double area(void) = 0; - virtual double perimeter(void) = 0; + virtual double area() = 0; + virtual double perimeter() = 0; static int nshapes; - static int get_nshapes(); }; class Circle : public Shape { @@ -21,10 +20,8 @@ private: double radius; public: Circle(double r) : radius(r) { } - ~Circle() { } - void set_radius( double r ); - virtual double area(void); - virtual double perimeter(void); + virtual double area(); + virtual double perimeter(); }; class Square : public Shape { @@ -32,7 +29,6 @@ private: double width; public: Square(double w) : width(w) { } - ~Square() { } - virtual double area(void); - virtual double perimeter(void); + virtual double area(); + virtual double perimeter(); }; diff --git a/Examples/php/class/example.i b/Examples/php/class/example.i index 75700b3..fbdf724 100644 --- a/Examples/php/class/example.i +++ b/Examples/php/class/example.i @@ -7,4 +7,3 @@ /* Let's just grab the original header file here */ %include "example.h" - diff --git a/Examples/php/class/runme.php b/Examples/php/class/runme.php index 12b6860..99c253b 100644 --- a/Examples/php/class/runme.php +++ b/Examples/php/class/runme.php @@ -14,7 +14,7 @@ print " Created square\n"; # ----- Access a static member ----- -print "\nA total of " . Shape::get_nshapes() . " shapes were created\n"; +print "\nA total of " . Shape::nshapes() . " shapes were created\n"; # ----- Member data access ----- @@ -54,7 +54,7 @@ $s = NULL; # the square. $o = NULL; -print Shape::get_nshapes() . " shapes remain\n"; +print Shape::nshapes() . " shapes remain\n"; print "Goodbye\n"; ?> diff --git a/Examples/php/constants/Makefile b/Examples/php/constants/Makefile index 3f24a39..9dbd384 100644 --- a/Examples/php/constants/Makefile +++ b/Examples/php/constants/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = TARGET = example INTERFACE = example.i @@ -7,17 +8,19 @@ LIBS = SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile php_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ php static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myphp' INTERFACE='$(INTERFACE)' \ php_static clean: - $(MAKE) -f $(TOP)/Makefile php_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_clean diff --git a/Examples/php/cpointer/Makefile b/Examples/php/cpointer/Makefile index 57785ac..05679f8 100644 --- a/Examples/php/cpointer/Makefile +++ b/Examples/php/cpointer/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i @@ -7,17 +8,19 @@ LIBS = SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile php_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ php static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myphp' INTERFACE='$(INTERFACE)' \ php_static clean: - $(MAKE) -f $(TOP)/Makefile php_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_clean diff --git a/Examples/php/cpointer/example.c b/Examples/php/cpointer/example.c index 3326dec..04dd08d 100644 --- a/Examples/php/cpointer/example.c +++ b/Examples/php/cpointer/example.c @@ -1,6 +1,6 @@ /* File : example.c */ -void add(double *x, double *y, double *result) { +void add(int *x, int *y, int *result) { *result = *x + *y; } diff --git a/Examples/php/disown/Makefile b/Examples/php/disown/Makefile index cefd81f..02a8668 100644 --- a/Examples/php/disown/Makefile +++ b/Examples/php/disown/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i @@ -7,17 +8,19 @@ LIBS = SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile php_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ php_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myphp' INTERFACE='$(INTERFACE)' \ php_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile php_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_clean diff --git a/Examples/php/disown/example.h b/Examples/php/disown/example.h index 985bc33..e9f9674 100644 --- a/Examples/php/disown/example.h +++ b/Examples/php/disown/example.h @@ -9,7 +9,7 @@ public: } virtual ~Shape() { nshapes--; - }; + } double x, y; void move(double dx, double dy); virtual double area(void) = 0; @@ -22,8 +22,8 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; - ~Circle() { }; + Circle(double r) : radius(r) { } + ~Circle() { } void set_radius( double r ); virtual double area(void); virtual double perimeter(void); @@ -33,7 +33,7 @@ class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; + Square(double w) : width(w) { } ~Square() { } virtual double area(void); virtual double perimeter(void); @@ -44,7 +44,7 @@ private: typedef std::vector::iterator iterator; std::vector shapes; public: - ShapeContainer() : shapes() {}; + ShapeContainer() : shapes() {} ~ShapeContainer(); void addShape( Shape *s ); }; diff --git a/Examples/php/enum/Makefile b/Examples/php/enum/Makefile index 22f979d..95ebf8f 100644 --- a/Examples/php/enum/Makefile +++ b/Examples/php/enum/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i @@ -7,17 +8,19 @@ LIBS = SWIGOPT = -noproxy check: build - $(MAKE) -f $(TOP)/Makefile php_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ php_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myphp' INTERFACE='$(INTERFACE)' \ php_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile php_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_clean diff --git a/Examples/php/extend/Makefile b/Examples/php/extend/Makefile index 08b2710..cbc7577 100644 --- a/Examples/php/extend/Makefile +++ b/Examples/php/extend/Makefile @@ -1,21 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile php_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_run build: - $(MAKE) -f $(TOP)/Makefile $(SWIGLIB) CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' $(SWIGLIB) CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' php_cpp static: - $(MAKE) -f $(TOP)/Makefile $(SWIGLIB) CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' $(SWIGLIB) CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myphp' INTERFACE='$(INTERFACE)' php_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile php_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_clean diff --git a/Examples/php/extend/example.h b/Examples/php/extend/example.h index b27ab97..ca1aed2 100644 --- a/Examples/php/extend/example.h +++ b/Examples/php/extend/example.h @@ -14,7 +14,7 @@ public: virtual std::string getTitle() { return getPosition() + " " + getName(); } virtual std::string getName() { return name; } virtual std::string getPosition() const { return "Employee"; } - virtual ~Employee() { printf("~Employee() @ %p\n", this); } + virtual ~Employee() { printf("~Employee() @ %p\n", (void *)this); } }; diff --git a/Examples/php/funcptr/Makefile b/Examples/php/funcptr/Makefile index 57785ac..05679f8 100644 --- a/Examples/php/funcptr/Makefile +++ b/Examples/php/funcptr/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i @@ -7,17 +8,19 @@ LIBS = SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile php_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ php static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myphp' INTERFACE='$(INTERFACE)' \ php_static clean: - $(MAKE) -f $(TOP)/Makefile php_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_clean diff --git a/Examples/php/overloading/Makefile b/Examples/php/overloading/Makefile index cefd81f..02a8668 100644 --- a/Examples/php/overloading/Makefile +++ b/Examples/php/overloading/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i @@ -7,17 +8,19 @@ LIBS = SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile php_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ php_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myphp' INTERFACE='$(INTERFACE)' \ php_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile php_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_clean diff --git a/Examples/php/pointer/Makefile b/Examples/php/pointer/Makefile index 57785ac..05679f8 100644 --- a/Examples/php/pointer/Makefile +++ b/Examples/php/pointer/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i @@ -7,17 +8,19 @@ LIBS = SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile php_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ php static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myphp' INTERFACE='$(INTERFACE)' \ php_static clean: - $(MAKE) -f $(TOP)/Makefile php_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_clean diff --git a/Examples/php/pointer/runme.php b/Examples/php/pointer/runme.php index 5e86de6..e79b238 100644 --- a/Examples/php/pointer/runme.php +++ b/Examples/php/pointer/runme.php @@ -15,7 +15,7 @@ print " c = $c\n"; # Call the add() function wuth some pointers - add(&$a,&$b,&$c); + add($a,$b,$c); print " $a + $b = $c\n"; diff --git a/Examples/php/pragmas/Makefile b/Examples/php/pragmas/Makefile index 3f24a39..9dbd384 100644 --- a/Examples/php/pragmas/Makefile +++ b/Examples/php/pragmas/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = TARGET = example INTERFACE = example.i @@ -7,17 +8,19 @@ LIBS = SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile php_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ php static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myphp' INTERFACE='$(INTERFACE)' \ php_static clean: - $(MAKE) -f $(TOP)/Makefile php_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_clean diff --git a/Examples/php/pragmas/runme.php b/Examples/php/pragmas/runme.php old mode 100755 new mode 100644 diff --git a/Examples/php/proxy/Makefile b/Examples/php/proxy/Makefile index cefd81f..02a8668 100644 --- a/Examples/php/proxy/Makefile +++ b/Examples/php/proxy/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i @@ -7,17 +8,19 @@ LIBS = SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile php_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ php_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myphp' INTERFACE='$(INTERFACE)' \ php_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile php_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_clean diff --git a/Examples/php/proxy/example.h b/Examples/php/proxy/example.h index 361dff8..0683f07 100644 --- a/Examples/php/proxy/example.h +++ b/Examples/php/proxy/example.h @@ -9,7 +9,7 @@ public: } virtual ~Shape() { nshapes--; - }; + } double x, y; void move(double dx, double dy); virtual double area(void) = 0; @@ -22,8 +22,8 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; - ~Circle() { }; + Circle(double r) : radius(r) { } + ~Circle() { } void set_radius( double r ); virtual double area(void); virtual double perimeter(void); @@ -33,7 +33,7 @@ class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; + Square(double w) : width(w) { } ~Square() { } virtual double area(void); virtual double perimeter(void); diff --git a/Examples/php/reference/Makefile b/Examples/php/reference/Makefile index cefd81f..02a8668 100644 --- a/Examples/php/reference/Makefile +++ b/Examples/php/reference/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i @@ -7,17 +8,19 @@ LIBS = SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile php_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ php_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myphp' INTERFACE='$(INTERFACE)' \ php_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile php_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_clean diff --git a/Examples/php/reference/example.cxx b/Examples/php/reference/example.cxx index 13e47ea..7ead7fb 100644 --- a/Examples/php/reference/example.cxx +++ b/Examples/php/reference/example.cxx @@ -19,23 +19,23 @@ Vector operator+(const Vector &a, const Vector &b) { char *Vector::as_string() { static char temp[512]; - sprintf(temp,"Vector %p (%g,%g,%g)", this, x,y,z); + sprintf(temp,"Vector %p (%g,%g,%g)", (void *)this, x,y,z); return temp; } VectorArray::VectorArray(int size) { items = new Vector[size]; maxsize = size; - printf("VectorArray new: self=%p\n",this); + printf("VectorArray new: self=%p\n", (void *)this); } VectorArray::~VectorArray() { - printf("VectorArray delete: self=%p\n",this); + printf("VectorArray delete: self=%p\n", (void *)this); delete [] items; } Vector &VectorArray::operator[](int index) { - printf("VectorArray: read[%d] self=%p\n",index,this); + printf("VectorArray: read[%d] self=%p\n", index, (void *)this); if ((index < 0) || (index >= maxsize)) { printf("Panic! Array index out of bounds.\n"); exit(1); @@ -44,6 +44,6 @@ Vector &VectorArray::operator[](int index) { } int VectorArray::size() { - printf("VectorArray: size %d self=%p\n",maxsize,this); + printf("VectorArray: size %d self=%p\n", maxsize, (void *)this); return maxsize; } diff --git a/Examples/php/reference/example.h b/Examples/php/reference/example.h index 1b88cbf..353b888 100644 --- a/Examples/php/reference/example.h +++ b/Examples/php/reference/example.h @@ -4,8 +4,8 @@ class Vector { private: double x,y,z; public: - Vector() : x(0), y(0), z(0) { }; - Vector(double x, double y, double z) : x(x), y(y), z(z) { }; + Vector() : x(0), y(0), z(0) { } + Vector(double x, double y, double z) : x(x), y(y), z(z) { } friend Vector operator+(const Vector &a, const Vector &b); char *as_string(); }; @@ -20,7 +20,3 @@ public: Vector &operator[](int); int size(); }; - - - - diff --git a/Examples/php/reference/example.i b/Examples/php/reference/example.i index d612286..df14599 100644 --- a/Examples/php/reference/example.i +++ b/Examples/php/reference/example.i @@ -1,10 +1,6 @@ /* File : example.i */ -/* This example has nothing to do with references but the name is used by all - * the other languages so it's hard to rename to something more meaningful. - * - * Mostly it shows how to use %extend. - */ +/* This file has a few "typical" uses of C++ references. */ %module example @@ -33,11 +29,11 @@ public: VectorArray(int maxsize); ~VectorArray(); int size(); - - /* This wrapper provides an alternative to the [] operator */ + + /* This wrapper provides an alternative to the [] operator */ %extend { Vector &get(int index) { - printf("VectorArray extended get: %p %d\n",$self,index); + printf("VectorArray extended get: %p %d\n", (void *)$self, index); return (*$self)[index]; } void set(int index, Vector &a) { diff --git a/Examples/php/simple/Makefile b/Examples/php/simple/Makefile index 57785ac..05679f8 100644 --- a/Examples/php/simple/Makefile +++ b/Examples/php/simple/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i @@ -7,17 +8,19 @@ LIBS = SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile php_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ php static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myphp' INTERFACE='$(INTERFACE)' \ php_static clean: - $(MAKE) -f $(TOP)/Makefile php_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_clean diff --git a/Examples/php/simple/runme.php b/Examples/php/simple/runme.php old mode 100755 new mode 100644 diff --git a/Examples/php/sync/Makefile b/Examples/php/sync/Makefile index cefd81f..02a8668 100644 --- a/Examples/php/sync/Makefile +++ b/Examples/php/sync/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i @@ -7,17 +8,19 @@ LIBS = SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile php_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ php_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myphp' INTERFACE='$(INTERFACE)' \ php_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile php_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_clean diff --git a/Examples/php/sync/example.cxx b/Examples/php/sync/example.cxx index 31ed202..0942279 100644 --- a/Examples/php/sync/example.cxx +++ b/Examples/php/sync/example.cxx @@ -10,4 +10,4 @@ void Sync::printer(void) { printf("The value of global x is %d\n", x); printf("The value of class s is %s\n", s); printf("The value of class x is %d\n", x); -}; +} diff --git a/Examples/php/value/Makefile b/Examples/php/value/Makefile index 4496867..674e436 100644 --- a/Examples/php/value/Makefile +++ b/Examples/php/value/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i @@ -7,17 +8,19 @@ LIBS = SWIGOPT = -noproxy check: build - $(MAKE) -f $(TOP)/Makefile php_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ php static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myphp' INTERFACE='$(INTERFACE)' \ php_static clean: - $(MAKE) -f $(TOP)/Makefile php_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_clean diff --git a/Examples/php/value/example.i b/Examples/php/value/example.i index 386fa3b..20a4534 100644 --- a/Examples/php/value/example.i +++ b/Examples/php/value/example.i @@ -11,7 +11,7 @@ %inline %{ void vector_print(Vector *v) { - printf("Vector %p = (%g, %g, %g)\n", v, v->x, v->y, v->z); + printf("Vector %p = (%g, %g, %g)\n", (void *)v, v->x, v->y, v->z); } %} diff --git a/Examples/php/variables/Makefile b/Examples/php/variables/Makefile index 57785ac..05679f8 100644 --- a/Examples/php/variables/Makefile +++ b/Examples/php/variables/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i @@ -7,17 +8,19 @@ LIBS = SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile php_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ php static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myphp' INTERFACE='$(INTERFACE)' \ php_static clean: - $(MAKE) -f $(TOP)/Makefile php_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' php_clean diff --git a/Examples/php/variables/example.c b/Examples/php/variables/example.c index 3114c7c..d4c6d02 100644 --- a/Examples/php/variables/example.c +++ b/Examples/php/variables/example.c @@ -51,10 +51,10 @@ void print_vars() { printf("dvar = %g\n", dvar); printf("cvar = %c\n", cvar); printf("strvar = %s\n", strvar ? strvar : "(null)"); - printf("cstrvar = %s\n", cstrvar ? cstrvar : "(null)"); - printf("iptrvar = %p\n", iptrvar); + printf("cstrvar = %s\n", cstrvar); + printf("iptrvar = %p\n", (void *)iptrvar); printf("name = %c%c%c%c%c\n", name[0],name[1],name[2],name[3],name[4]); - printf("ptptr = %p %s\n", ptptr, Point_print( ptptr ) ); + printf("ptptr = %p %s\n", (void *)ptptr, Point_print( ptptr ) ); printf("pt = (%d, %d)\n", pt.x, pt.y); printf("status = %d\n", status); } diff --git a/Examples/pike/class/Makefile b/Examples/pike/class/Makefile index aadc471..e5319db 100644 --- a/Examples/pike/class/Makefile +++ b/Examples/pike/class/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile pike_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' pike_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' pike_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypike' INTERFACE='$(INTERFACE)' pike_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile pike_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' pike_clean diff --git a/Examples/pike/class/example.cxx b/Examples/pike/class/example.cxx index c7a3194..0463045 100644 --- a/Examples/pike/class/example.cxx +++ b/Examples/pike/class/example.cxx @@ -1,46 +1,28 @@ -/* File : example.c */ +/* File : example.cxx */ #include "example.h" - -#include - #define M_PI 3.14159265358979323846 -// Static member initializer -int Shape::nshapes = 0; - -// Constructor -Shape::Shape() { - nshapes++; -} - -// Move the shape to a new location +/* Move the shape to a new location */ void Shape::move(double dx, double dy) { x += dx; y += dy; } -// Destructor -Shape::~Shape() { - nshapes--; -} +int Shape::nshapes = 0; -// Circle area -double Circle::area() const { +double Circle::area() { return M_PI*radius*radius; } -// Circle perimeter -double Circle::perimeter() const { +double Circle::perimeter() { return 2*M_PI*radius; } -// Square area -double Square::area() const { +double Square::area() { return width*width; } -// Square perimeter -double Square::perimeter() const { +double Square::perimeter() { return 4*width; } diff --git a/Examples/pike/class/example.h b/Examples/pike/class/example.h index f74a4fe..0dff185 100644 --- a/Examples/pike/class/example.h +++ b/Examples/pike/class/example.h @@ -2,12 +2,16 @@ class Shape { public: - Shape(); - virtual ~Shape(); - double x, y; + Shape() { + nshapes++; + } + virtual ~Shape() { + nshapes--; + } + double x, y; void move(double dx, double dy); - virtual double area() const = 0; - virtual double perimeter() const = 0; + virtual double area() = 0; + virtual double perimeter() = 0; static int nshapes; }; @@ -15,21 +19,16 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; - virtual double area() const; - virtual double perimeter() const; + Circle(double r) : radius(r) { } + virtual double area(); + virtual double perimeter(); }; class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; - virtual double area() const; - virtual double perimeter() const; + Square(double w) : width(w) { } + virtual double area(); + virtual double perimeter(); }; - - - - - diff --git a/Examples/pike/class/example.i b/Examples/pike/class/example.i index 75700b3..fbdf724 100644 --- a/Examples/pike/class/example.i +++ b/Examples/pike/class/example.i @@ -7,4 +7,3 @@ /* Let's just grab the original header file here */ %include "example.h" - diff --git a/Examples/pike/class/runme.pike b/Examples/pike/class/runme.pike old mode 100755 new mode 100644 diff --git a/Examples/pike/constants/Makefile b/Examples/pike/constants/Makefile index 9a882bd..45da7d2 100644 --- a/Examples/pike/constants/Makefile +++ b/Examples/pike/constants/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -SRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile pike_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' pike_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' pike static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypike' INTERFACE='$(INTERFACE)' pike_static clean: - $(MAKE) -f $(TOP)/Makefile pike_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' pike_clean diff --git a/Examples/pike/constants/runme.pike b/Examples/pike/constants/runme.pike old mode 100755 new mode 100644 diff --git a/Examples/pike/enum/Makefile b/Examples/pike/enum/Makefile index aadc471..e5319db 100644 --- a/Examples/pike/enum/Makefile +++ b/Examples/pike/enum/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile pike_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' pike_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' pike_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypike' INTERFACE='$(INTERFACE)' pike_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile pike_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' pike_clean diff --git a/Examples/pike/overload/Makefile b/Examples/pike/overload/Makefile index 8d799ef..5e5fe66 100644 --- a/Examples/pike/overload/Makefile +++ b/Examples/pike/overload/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lstdc++ -lm check: build - $(MAKE) -f $(TOP)/Makefile pike_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' pike_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' pike_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypike' INTERFACE='$(INTERFACE)' pike_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile pike_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' pike_clean diff --git a/Examples/pike/simple/Makefile b/Examples/pike/simple/Makefile index f58ed4e..8b49b4e 100644 --- a/Examples/pike/simple/Makefile +++ b/Examples/pike/simple/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile pike_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' pike_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' pike static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypike' INTERFACE='$(INTERFACE)' pike_static clean: - $(MAKE) -f $(TOP)/Makefile pike_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' pike_clean diff --git a/Examples/pike/template/Makefile b/Examples/pike/template/Makefile index 73a31ee..513dc3b 100644 --- a/Examples/pike/template/Makefile +++ b/Examples/pike/template/Makefile @@ -1,21 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i LIBS = -lm -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile pike_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' pike_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' pike_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='mypike' INTERFACE='$(INTERFACE)' pike_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile pike_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' pike_clean diff --git a/Examples/pike/template/runme.pike b/Examples/pike/template/runme.pike old mode 100755 new mode 100644 diff --git a/Examples/python/callback/Makefile b/Examples/python/callback/Makefile index 21e88ad..71926f3 100644 --- a/Examples/python/callback/Makefile +++ b/Examples/python/callback/Makefile @@ -1,21 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile $(SWIGLIB) CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' $(SWIGLIB) CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile $(SWIGLIB) CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' $(SWIGLIB) CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/callback/example.i b/Examples/python/callback/example.i index 90beda0..cf61ef9 100644 --- a/Examples/python/callback/example.i +++ b/Examples/python/callback/example.i @@ -4,8 +4,6 @@ #include "example.h" %} -%include "std_string.i" - /* turn on director wrapping Callback */ %feature("director") Callback; diff --git a/Examples/python/callback/runme.py b/Examples/python/callback/runme.py index 026e952..345a3eb 100644 --- a/Examples/python/callback/runme.py +++ b/Examples/python/callback/runme.py @@ -2,14 +2,16 @@ # This file illustrates the cross language polymorphism using directors. -import example +import example class PyCallback(example.Callback): - def __init__(self): - example.Callback.__init__(self) - def run(self): - print "PyCallback.run()" + + def __init__(self): + example.Callback.__init__(self) + + def run(self): + print "PyCallback.run()" # Create an Caller instance @@ -25,7 +27,7 @@ callback = example.Callback() callback.thisown = 0 caller.setCallback(callback) caller.call() -caller.delCallback(); +caller.delCallback() print print "Adding and calling a Python callback" @@ -42,7 +44,7 @@ print print "Adding and calling another Python callback" print "------------------------------------------" -# Lets do the same but use the weak reference this time. +# Let's do the same but use the weak reference this time. callback = PyCallback().__disown__() caller.setCallback(callback) @@ -53,4 +55,3 @@ caller.delCallback() print print "python exit" - diff --git a/Examples/python/check.list b/Examples/python/check.list index 7cfe437..a43a5fc 100644 --- a/Examples/python/check.list +++ b/Examples/python/check.list @@ -13,6 +13,7 @@ funcptr2 functor import import_template +import_packages java #libffi multimap @@ -23,7 +24,6 @@ simple smartptr std_vector std_map -swigrun template varargs variables diff --git a/Examples/python/class/Makefile b/Examples/python/class/Makefile index e940c1f..471e390 100644 --- a/Examples/python/class/Makefile +++ b/Examples/python/class/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/class/example.cxx b/Examples/python/class/example.cxx index 1e8e203..0463045 100644 --- a/Examples/python/class/example.cxx +++ b/Examples/python/class/example.cxx @@ -1,4 +1,4 @@ -/* File : example.c */ +/* File : example.cxx */ #include "example.h" #define M_PI 3.14159265358979323846 @@ -11,18 +11,18 @@ void Shape::move(double dx, double dy) { int Shape::nshapes = 0; -double Circle::area(void) { +double Circle::area() { return M_PI*radius*radius; } -double Circle::perimeter(void) { +double Circle::perimeter() { return 2*M_PI*radius; } -double Square::area(void) { +double Square::area() { return width*width; } -double Square::perimeter(void) { +double Square::perimeter() { return 4*width; } diff --git a/Examples/python/class/example.h b/Examples/python/class/example.h index 46d9013..0dff185 100644 --- a/Examples/python/class/example.h +++ b/Examples/python/class/example.h @@ -7,11 +7,11 @@ public: } virtual ~Shape() { nshapes--; - }; - double x, y; + } + double x, y; void move(double dx, double dy); - virtual double area(void) = 0; - virtual double perimeter(void) = 0; + virtual double area() = 0; + virtual double perimeter() = 0; static int nshapes; }; @@ -19,21 +19,16 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; - virtual double area(void); - virtual double perimeter(void); + Circle(double r) : radius(r) { } + virtual double area(); + virtual double perimeter(); }; class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; - virtual double area(void); - virtual double perimeter(void); + Square(double w) : width(w) { } + virtual double area(); + virtual double perimeter(); }; - - - - - diff --git a/Examples/python/class/example.i b/Examples/python/class/example.i index 75700b3..fbdf724 100644 --- a/Examples/python/class/example.i +++ b/Examples/python/class/example.i @@ -7,4 +7,3 @@ /* Let's just grab the original header file here */ %include "example.h" - diff --git a/Examples/python/class/index.html b/Examples/python/class/index.html index 12c5ede..2e1baa3 100644 --- a/Examples/python/class/index.html +++ b/Examples/python/class/index.html @@ -12,9 +12,7 @@

    Wrapping a simple C++ class

    -This example illustrates the most primitive form of C++ class wrapping performed -by SWIG. In this case, C++ classes are simply transformed into a collection of -C-style functions that provide access to class members. +This example illustrates wrapping a simple C++ class to give a Python class.

    The C++ Code

    @@ -32,8 +30,8 @@ public: } virtual ~Shape() { nshapes--; - }; - double x, y; + } + double x, y; void move(double dx, double dy); virtual double area() = 0; virtual double perimeter() = 0; @@ -44,7 +42,7 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; + Circle(double r) : radius(r) { } virtual double area(); virtual double perimeter(); }; @@ -53,7 +51,7 @@ class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; + Square(double w) : width(w) { } virtual double area(); virtual double perimeter(); }; @@ -102,52 +100,35 @@ c = example.new_Circle(10.0)
  • -

  • To access member data, a pair of accessor functions are used. +
  • Member variables of the C++ class are wrapped as attributes of the Python class. For example:
    -example.Shape_x_set(c,15)    # Set member data
    -x = example.Shape_x_get(c)    # Get member data
    +c.x = 15   # Set member data
    +x = c.x    # Get member data
     
    -Note: when accessing member data, the name of the class in which -the member data was must be used. In this case, Shape_x_get() -and Shape_x_set() are used since 'x' was defined in Shape. -

    -

  • To invoke a member function, you simply do this +
  • Member function are invoked as you would expect:
    -print "The area is ", example.Shape_area(c)
    +print "The area is ", c.area()
     

    -

  • Type checking knows about the inheritance structure of C++. For example: +
  • To invoke a destructor, simply call del on the object:
    -example.Shape_area(c)       # Works (c is a Shape)
    -example.Circle_area(c)      # Works (c is a Circle)
    -example.Square_area(c)      # Fails (c is definitely not a Square)
    +del c    # Deletes a shape
     

    -

  • To invoke a destructor, simply do this - -
    -
    -example.delete_Shape(c)     # Deletes a shape
    -
    -
    - -(Note: destructors are currently not inherited. This might change later). - -

  • Static member variables are wrapped as C global variables. For example:
    @@ -162,52 +143,12 @@ example.cvar.Shapes_nshapes = 13 # Set a static data member

    General Comments

      -
    • This low-level interface is not the only way to handle C++ code. -Proxy classes provide a much higher-level interface. - -

      -

    • SWIG *does* know how to properly perform upcasting of objects in +
    • SWIG does know how to properly perform upcasting of objects in an inheritance hierarchy (including multiple inheritance). Therefore it is perfectly safe to pass an object of a derived class to any function involving a base class. -

      -

    • A wide variety of C++ features are not currently supported by SWIG. Here is the -short and incomplete list: - -

      -

        -
      • Overloaded methods and functions. SWIG wrappers don't know how to resolve name -conflicts so you must give an alternative name to any overloaded method name using the -%name directive like this: - -
        -
        -void foo(int a);  
        -%name(foo2) void foo(double a, double b);
        -
        -
        - -

        -

      • Overloaded operators. Not supported at all. The only workaround for this is -to write a helper function. For example: - -
        -
        -%inline %{
        -    Vector *vector_add(Vector *a, Vector *b) {
        -          ... whatever ...
        -    }
        -%}
        -
        -
        - -

        -

      • Namespaces. Not supported at all. Won't be supported until SWIG2.0 (if at all). - -

        -

      • Dave's snide remark: Like a large bottle of strong Tequilla, it's better to -use C++ in moderation. +
      • C++ Namespaces - %nspace isn't yet supported for Python.
      diff --git a/Examples/python/class/runme.py b/Examples/python/class/runme.py index f1272ae..34d2150 100644 --- a/Examples/python/class/runme.py +++ b/Examples/python/class/runme.py @@ -3,7 +3,7 @@ # This file illustrates the proxy class C++ interface generated # by SWIG. -import example +import example # ----- Object creation ----- @@ -15,7 +15,7 @@ print " Created square", s # ----- Access a static member ----- -print "\nA total of", example.cvar.Shape_nshapes,"shapes were created" +print "\nA total of", example.cvar.Shape_nshapes, "shapes were created" # ----- Member data access ----- @@ -28,16 +28,18 @@ s.x = -10 s.y = 5 print "\nHere is their current position:" -print " Circle = (%f, %f)" % (c.x,c.y) -print " Square = (%f, %f)" % (s.x,s.y) +print " Circle = (%f, %f)" % (c.x, c.y) +print " Square = (%f, %f)" % (s.x, s.y) # ----- Call some methods ----- print "\nHere are some properties of the shapes:" -for o in [c,s]: - print " ", o - print " area = ", o.area() - print " perimeter = ", o.perimeter() +for o in [c, s]: + print " ", o + print " area = ", o.area() + print " perimeter = ", o.perimeter() +# prevent o from holding a reference to the last object looked at +o = None print "\nGuess I'll clean up now" @@ -45,7 +47,5 @@ print "\nGuess I'll clean up now" del c del s -s = 3 -print example.cvar.Shape_nshapes,"shapes remain" +print example.cvar.Shape_nshapes, "shapes remain" print "Goodbye" - diff --git a/Examples/python/constants/Makefile b/Examples/python/constants/Makefile index 505f199..a412cf2 100644 --- a/Examples/python/constants/Makefile +++ b/Examples/python/constants/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -SRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/constants/runme.py b/Examples/python/constants/runme.py index 8d25b87..415d1ad 100644 --- a/Examples/python/constants/runme.py +++ b/Examples/python/constants/runme.py @@ -1,6 +1,6 @@ # file: runme.py -import example +import example print "ICONST =", example.ICONST, "(should be 42)" print "FCONST =", example.FCONST, "(should be 2.1828)" @@ -8,7 +8,7 @@ print "CCONST =", example.CCONST, "(should be 'x')" print "CCONST2 =", example.CCONST2, "(this should be on a new line)" print "SCONST =", example.SCONST, "(should be 'Hello World')" print "SCONST2 =", example.SCONST2, "(should be '\"Hello World\"')" -print "EXPR =", example.EXPR, "(should be 48.5484)" +print "EXPR =", example.EXPR, "(should be 48.5484)" print "iconst =", example.iconst, "(should be 37)" print "fconst =", example.fconst, "(should be 3.14)" @@ -21,7 +21,3 @@ try: print "FOO = ", example.FOO, "(Arg! This shouldn't print anything)" except AttributeError: print "FOO isn't defined (good)" - - - - diff --git a/Examples/python/contract/Makefile b/Examples/python/contract/Makefile index a448877..54817c7 100644 --- a/Examples/python/contract/Makefile +++ b/Examples/python/contract/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - TARGET='mypython' INTERFACE='$(INTERFACE)' python_static + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' TARGET='mypython' INTERFACE='$(INTERFACE)' python_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/contract/runme.py b/Examples/python/contract/runme.py index d484ae9..ce01e5a 100644 --- a/Examples/python/contract/runme.py +++ b/Examples/python/contract/runme.py @@ -1,13 +1,13 @@ # file: runme.py -import example +import example # Call our gcd() function x = 42 y = 105 -g = example.gcd(x,y) -print "The gcd of %d and %d is %d" % (x,y,g) +g = example.gcd(x, y) +print "The gcd of %d and %d is %d" % (x, y, g) # Manipulate the Foo global variable @@ -19,12 +19,3 @@ example.cvar.Foo = 3.1415926 # See if the change took effect print "Foo = ", example.cvar.Foo - - - - - - - - - diff --git a/Examples/python/docstrings/Makefile b/Examples/python/docstrings/Makefile index 51552f3..f1365a5 100644 --- a/Examples/python/docstrings/Makefile +++ b/Examples/python/docstrings/Makefile @@ -1,5 +1,6 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i @@ -7,17 +8,19 @@ LIBS = -lm SWIGOPT = -O check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/docstrings/runme.py b/Examples/python/docstrings/runme.py index b6c95e6..c25d291 100644 --- a/Examples/python/docstrings/runme.py +++ b/Examples/python/docstrings/runme.py @@ -1,6 +1,5 @@ # file: runme.py -import example +import example print "example.Foo.bar.__doc__ =", repr(example.Foo.bar.__doc__), "(Should be 'No comment')" - diff --git a/Examples/python/enum/Makefile b/Examples/python/enum/Makefile index e940c1f..471e390 100644 --- a/Examples/python/enum/Makefile +++ b/Examples/python/enum/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/enum/runme.py b/Examples/python/enum/runme.py index 10c4a26..def01b1 100644 --- a/Examples/python/enum/runme.py +++ b/Examples/python/enum/runme.py @@ -18,9 +18,9 @@ print " Foo_LUDICROUS =", example.Foo.LUDICROUS print "\nTesting use of enums with functions\n" example.enum_test(example.RED, example.Foo.IMPULSE) -example.enum_test(example.BLUE, example.Foo.WARP) +example.enum_test(example.BLUE, example.Foo.WARP) example.enum_test(example.GREEN, example.Foo.LUDICROUS) -example.enum_test(1234,5678) +example.enum_test(1234, 5678) print "\nTesting use of enum with class method" f = example.Foo() @@ -28,4 +28,3 @@ f = example.Foo() f.enum_test(example.Foo.IMPULSE) f.enum_test(example.Foo.WARP) f.enum_test(example.Foo.LUDICROUS) - diff --git a/Examples/python/exception/Makefile b/Examples/python/exception/Makefile index b2b163e..8420c82 100644 --- a/Examples/python/exception/Makefile +++ b/Examples/python/exception/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/exception/example.i b/Examples/python/exception/example.i index 08672c3..817c522 100644 --- a/Examples/python/exception/example.i +++ b/Examples/python/exception/example.i @@ -10,3 +10,12 @@ /* Let's just grab the original header file here */ %include "example.h" +%inline %{ +// The -builtin SWIG option results in SWIGPYTHON_BUILTIN being defined +#ifdef SWIGPYTHON_BUILTIN +bool is_python_builtin() { return true; } +#else +bool is_python_builtin() { return false; } +#endif +%} + diff --git a/Examples/python/exception/runme.py b/Examples/python/exception/runme.py index 7187078..7fae490 100644 --- a/Examples/python/exception/runme.py +++ b/Examples/python/exception/runme.py @@ -6,31 +6,37 @@ import example t = example.Test() try: - t.unknown() -except RuntimeError,e: - print "incomplete type", e.args[0] + t.unknown() +except RuntimeError, e: + print "incomplete type", e.args[0] try: - t.simple() -except RuntimeError,e: - print e.args[0] + t.simple() +except RuntimeError, e: + print e.args[0] try: - t.message() -except RuntimeError,e: - print e.args[0] - -try: - t.hosed() -except example.Exc,e: - print e.code, e.msg - -for i in range(1,4): - try: - t.multi(i) - except RuntimeError,e: - print e.args[0] - except example.Exc,e: - print e.code, e.msg - - + t.message() +except RuntimeError, e: + print e.args[0] + +if not example.is_python_builtin(): + try: + t.hosed() + except example.Exc, e: + print e.code, e.msg +else: + try: + t.hosed() + except BaseException, e: + # Throwing builtin classes as exceptions not supported (-builtin + # option) + print e + +for i in range(1, 4): + try: + t.multi(i) + except RuntimeError, e: + print e.args[0] + except example.Exc, e: + print e.code, e.msg diff --git a/Examples/python/exceptproxy/Makefile b/Examples/python/exceptproxy/Makefile index 06bce65..65af5ec 100644 --- a/Examples/python/exceptproxy/Makefile +++ b/Examples/python/exceptproxy/Makefile @@ -1,21 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i LIBS = -lm -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/exceptproxy/example.i b/Examples/python/exceptproxy/example.i index 4a1e0ba..0a46afb 100644 --- a/Examples/python/exceptproxy/example.i +++ b/Examples/python/exceptproxy/example.i @@ -109,6 +109,12 @@ %template(doubleQueue) Queue; - - +%inline %{ +// The -builtin SWIG option results in SWIGPYTHON_BUILTIN being defined +#ifdef SWIGPYTHON_BUILTIN +bool is_python_builtin() { return true; } +#else +bool is_python_builtin() { return false; } +#endif +%} diff --git a/Examples/python/exceptproxy/runme.py b/Examples/python/exceptproxy/runme.py index a2ae555..970d620 100644 --- a/Examples/python/exceptproxy/runme.py +++ b/Examples/python/exceptproxy/runme.py @@ -1,23 +1,29 @@ # file: runme.py import example +if example.is_python_builtin(): + print "Skipping example: -builtin option does not support %exceptionclass" + exit(0) + q = example.intQueue(10) print "Inserting items into intQueue" +print type(example.FullError) + try: - for i in range(0,100): - q.enqueue(i) -except example.FullError,e: - print "Maxsize is", e.maxsize + for i in range(0, 100): + q.enqueue(i) +except example.FullError, e: + print "Maxsize is", e.maxsize print "Removing items" try: - while 1: - q.dequeue() -except example.EmptyError,e: - pass + while 1: + q.dequeue() +except example.EmptyError, e: + pass q = example.doubleQueue(1000) @@ -25,21 +31,15 @@ q = example.doubleQueue(1000) print "Inserting items into doubleQueue" try: - for i in range(0,10000): - q.enqueue(i*1.5) -except example.FullError,e: - print "Maxsize is", e.maxsize + for i in range(0, 10000): + q.enqueue(i * 1.5) +except example.FullError, e: + print "Maxsize is", e.maxsize print "Removing items" try: - while 1: - q.dequeue() -except example.EmptyError,e: - pass - - - - - - + while 1: + q.dequeue() +except example.EmptyError, e: + pass diff --git a/Examples/python/extend/Makefile b/Examples/python/extend/Makefile index 21e88ad..71926f3 100644 --- a/Examples/python/extend/Makefile +++ b/Examples/python/extend/Makefile @@ -1,21 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile $(SWIGLIB) CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' $(SWIGLIB) CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile $(SWIGLIB) CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' $(SWIGLIB) CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/extend/example.h b/Examples/python/extend/example.h index b27ab97..ca1aed2 100644 --- a/Examples/python/extend/example.h +++ b/Examples/python/extend/example.h @@ -14,7 +14,7 @@ public: virtual std::string getTitle() { return getPosition() + " " + getName(); } virtual std::string getName() { return name; } virtual std::string getPosition() const { return "Employee"; } - virtual ~Employee() { printf("~Employee() @ %p\n", this); } + virtual ~Employee() { printf("~Employee() @ %p\n", (void *)this); } }; diff --git a/Examples/python/extend/runme.py b/Examples/python/extend/runme.py index 240b098..2bb38fa 100644 --- a/Examples/python/extend/runme.py +++ b/Examples/python/extend/runme.py @@ -2,16 +2,18 @@ # This file illustrates the cross language polymorphism using directors. -import example +import example # CEO class, which overrides Employee::getPosition(). class CEO(example.Manager): - def __init__(self, name): - example.Manager.__init__(self, name) - def getPosition(self): - return "CEO" + + def __init__(self, name): + example.Manager.__init__(self, name) + + def getPosition(self): + return "CEO" # Create an instance of our employee extension class, CEO. The calls to @@ -78,4 +80,3 @@ print "----------------------" # All done. print "python exit" - diff --git a/Examples/python/funcptr/Makefile b/Examples/python/funcptr/Makefile index df3bc86..26bfd94 100644 --- a/Examples/python/funcptr/Makefile +++ b/Examples/python/funcptr/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/funcptr/runme.py b/Examples/python/funcptr/runme.py index bce0650..bf0c6e1 100644 --- a/Examples/python/funcptr/runme.py +++ b/Examples/python/funcptr/runme.py @@ -1,6 +1,6 @@ # file: runme.py -import example +import example a = 37 b = 42 @@ -10,9 +10,9 @@ b = 42 print "Trying some C callback functions" print " a =", a print " b =", b -print " ADD(a,b) =", example.do_op(a,b,example.ADD) -print " SUB(a,b) =", example.do_op(a,b,example.SUB) -print " MUL(a,b) =", example.do_op(a,b,example.MUL) +print " ADD(a,b) =", example.do_op(a, b, example.ADD) +print " SUB(a,b) =", example.do_op(a, b, example.SUB) +print " MUL(a,b) =", example.do_op(a, b, example.MUL) print "Here is what the C callback function objects look like in Python" print " ADD =", example.ADD diff --git a/Examples/python/funcptr2/Makefile b/Examples/python/funcptr2/Makefile index df3bc86..26bfd94 100644 --- a/Examples/python/funcptr2/Makefile +++ b/Examples/python/funcptr2/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/funcptr2/runme.py b/Examples/python/funcptr2/runme.py index bd58fb6..a4405d9 100644 --- a/Examples/python/funcptr2/runme.py +++ b/Examples/python/funcptr2/runme.py @@ -1,6 +1,6 @@ # file: runme.py -import example +import example a = 37 b = 42 @@ -10,9 +10,9 @@ b = 42 print "Trying some C callback functions" print " a =", a print " b =", b -print " ADD(a,b) =", example.do_op(a,b,example.ADD) -print " SUB(a,b) =", example.do_op(a,b,example.SUB) -print " MUL(a,b) =", example.do_op(a,b,example.MUL) +print " ADD(a,b) =", example.do_op(a, b, example.ADD) +print " SUB(a,b) =", example.do_op(a, b, example.SUB) +print " MUL(a,b) =", example.do_op(a, b, example.MUL) print "Here is what the C callback function objects look like in Python" print " ADD =", example.ADD @@ -20,5 +20,5 @@ print " SUB =", example.SUB print " MUL =", example.MUL print "Call the functions directly..." -print " add(a,b) =", example.add(a,b) -print " sub(a,b) =", example.sub(a,b) +print " add(a,b) =", example.add(a, b) +print " sub(a,b) =", example.sub(a, b) diff --git a/Examples/python/functor/Makefile b/Examples/python/functor/Makefile index 6ef1583..e5de5c5 100644 --- a/Examples/python/functor/Makefile +++ b/Examples/python/functor/Makefile @@ -1,21 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i LIBS = -lm -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/functor/runme.py b/Examples/python/functor/runme.py index 8fc0f2f..7f6f2b6 100644 --- a/Examples/python/functor/runme.py +++ b/Examples/python/functor/runme.py @@ -8,10 +8,9 @@ b = example.doubleSum(100.0) # Use the objects. They should be callable just like a normal # python function. -for i in range(0,100): +for i in range(0, 100): a(i) # Note: function call b(math.sqrt(i)) # Note: function call print a.result() print b.result() - diff --git a/Examples/python/import/Makefile b/Examples/python/import/Makefile index f63e122..ad208b3 100644 --- a/Examples/python/import/Makefile +++ b/Examples/python/import/Makefile @@ -1,22 +1,27 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SWIGOPT = LIBS = check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='base' INTERFACE='base.i' python_cpp - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='spam' INTERFACE='spam.i' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='base' INTERFACE='base.i' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='spam' INTERFACE='spam.i' python_cpp clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean rm -f foo.py bar.py spam.py base.py diff --git a/Examples/python/import/base.h b/Examples/python/import/base.h index 5a266f6..c0b4795 100644 --- a/Examples/python/import/base.h +++ b/Examples/python/import/base.h @@ -2,8 +2,8 @@ class Base { public: - Base() { }; - virtual ~Base() { }; + Base() { } + virtual ~Base() { } virtual void A() { printf("I'm Base::A\n"); } diff --git a/Examples/python/import/runme.py b/Examples/python/import/runme.py index 6b800ec..0e83aca 100644 --- a/Examples/python/import/runme.py +++ b/Examples/python/import/runme.py @@ -81,31 +81,27 @@ x = d.toBase() print " Spam -> Base -> Foo : ", y = foo.Foo_fromBase(x) if y: - print "bad swig" + print "bad swig" else: - print "good swig" + print "good swig" print " Spam -> Base -> Bar : ", y = bar.Bar_fromBase(x) if y: - print "good swig" + print "good swig" else: - print "bad swig" - + print "bad swig" + print " Spam -> Base -> Spam : ", y = spam.Spam_fromBase(x) if y: - print "good swig" + print "good swig" else: - print "bad swig" + print "bad swig" print " Foo -> Spam : ", y = spam.Spam_fromBase(b) if y: - print "bad swig" + print "bad swig" else: - print "good swig" - - - - + print "good swig" diff --git a/Examples/python/import_packages/Makefile b/Examples/python/import_packages/Makefile new file mode 100644 index 0000000..f428d6f --- /dev/null +++ b/Examples/python/import_packages/Makefile @@ -0,0 +1,48 @@ +TOP = ../.. +SWIGOPT = +LIBS = + +import_packages_subdirs = \ + same_modnames1 \ + same_modnames2 \ + from_init1 \ + from_init2 \ + from_init3 \ + relativeimport1 \ + relativeimport2 \ + relativeimport3 \ + split_modules \ + namespace_pkg + + +check: build + if test "x$(SRCDIR)" != x; then \ + for file in `cd $(SRCDIR) && find . -type f -name "*.py"`; do \ + mkdir -p `dirname $$file`; \ + cp "${SRCDIR}$$file" "$$file" || exit 1; \ + done; \ + fi; \ + for s in $(import_packages_subdirs); do \ + (cd $$s && $(MAKE) check); \ + done + +build: + for s in $(import_packages_subdirs); do \ + (cd $$s && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build); \ + done + +static: + for s in $(import_packages_subdirs); do \ + (cd $$s && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static); \ + done + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + if test "x$(SRCDIR)" != x; then \ + for file in `cd $(SRCDIR) && find . -type f -name "*.py"`; do \ + rm -f "$$file" || exit 1; \ + done; \ + fi; \ + for s in $(import_packages_subdirs); do \ + (cd $$s && $(MAKE) clean); \ + done diff --git a/Examples/python/import_packages/README b/Examples/python/import_packages/README new file mode 100644 index 0000000..187a5d6 --- /dev/null +++ b/Examples/python/import_packages/README @@ -0,0 +1,4 @@ +These are actually regression tests for SF bug #1297 (GH issue #7). +The namespace_pkg is an example of python3's namespace packages. + +See individual READMEs in subdirectories. \ No newline at end of file diff --git a/Examples/python/import_packages/from_init1/Makefile b/Examples/python/import_packages/from_init1/Makefile new file mode 100644 index 0000000..90c92ab --- /dev/null +++ b/Examples/python/import_packages/from_init1/Makefile @@ -0,0 +1,22 @@ +TOP = ../../.. +LIBS = + +ifeq (,$(PY3)) + PKG1DIR = "py2" +else + PKG1DIR = "py3" +endif + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run + +build: + cd $(PKG1DIR) && $(MAKE) SWIGOPT='$(SWIGOPT) -relativeimport' LIBS='$(LIBS)' build + +static: + cd $(PKG1DIR) && $(MAKE) SWIGOPT='$(SWIGOPT) -relativeimport' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd py2 && $(MAKE) clean + cd py3 && $(MAKE) clean diff --git a/Examples/python/import_packages/from_init1/README b/Examples/python/import_packages/from_init1/README new file mode 100644 index 0000000..e7d7eca --- /dev/null +++ b/Examples/python/import_packages/from_init1/README @@ -0,0 +1,63 @@ +This example tests the %import directive and python import from __init__.py. + +This case is not correctly handled by swig 2. + +The issue was reported as Source Forge bug #1297 and later as GitHub issue #7. + +Use 'python runme.py' to run a test. + + +Overview: +--------- + +The example defines 2 different extension modules--each wrapping a separate C++ +class. + + pyX/pkg2/foo.i - Pkg2_Foo class + pyX/pkg2/bar.i - Pkg2_Bar class derived from Pkg2_Foo + +and the package pyX.pkg2 has: + + pyX/pkg2/__init__.py - which imports something from "bar" module (we + import Pkg2_Bar class, but it is not the clue, + the clue is the 'from' keyword) + +For example with python2.x the py2/pkg2/__init__.py imports Pkg2_Bar class +as follows + + from bar import Pkg2_Bar # [1] + +Such cases doesn't work when fully qualified python module names are used by +swig (swig 2.0.10, e.g.) to generate python import directives (SF bug #1297). +The generated file "py2/pkg2/bar.py" has following lines: + + import py2.pkg2.foo # [2] + class Pkg2_Bar(py2.pkg2.foo.Pkg2_Foo): # [3] + +but it's not possible to import anything from py2.pkg2 subpackage, e.g. + + import py2.pkg2 + +fails with the following exception: + +Traceback (most recent call last): + File "runme.py", line 3, in + import py2.pkg2 + File "py2/pkg2/__init__.py", line 7, in + from .bar import Pkg2_Bar + File "py2/pkg2/bar.py", line 71, in + class Pkg2_Bar(py2.pkg2.foo.Pkg2_Foo): + AttributeError: 'module' object has no attribute 'pkg2' + + +It seems like during the import [1], the sub-package pkg2 is not yet fully +initialized, so py2.pkg2 is not known. The above exception is raised at +line [3]. The problem disappears, for example, if we force swig to use relative +package names. + +If everything works well, the package py2.pkg2 shall load properly. + +Unix: +----- +- Run make +- Run the test as described above diff --git a/Examples/python/import_packages/from_init1/py2/Makefile b/Examples/python/import_packages/from_init1/py2/Makefile new file mode 100644 index 0000000..6296251 --- /dev/null +++ b/Examples/python/import_packages/from_init1/py2/Makefile @@ -0,0 +1,13 @@ +TOP = ../../../.. +SWIGOPT = +LIBS = + +build: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg2 && $(MAKE) clean diff --git a/Examples/python/import_packages/from_init1/py2/__init__.py b/Examples/python/import_packages/from_init1/py2/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/from_init1/py2/pkg2/Makefile b/Examples/python/import_packages/from_init1/py2/pkg2/Makefile new file mode 100644 index 0000000..102a893 --- /dev/null +++ b/Examples/python/import_packages/from_init1/py2/pkg2/Makefile @@ -0,0 +1,25 @@ +TOP = ../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp_static + +clean:: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='bar' python_clean diff --git a/Examples/python/import_packages/from_init1/py2/pkg2/__init__.py b/Examples/python/import_packages/from_init1/py2/pkg2/__init__.py new file mode 100644 index 0000000..0f9c902 --- /dev/null +++ b/Examples/python/import_packages/from_init1/py2/pkg2/__init__.py @@ -0,0 +1 @@ +from bar import Pkg2_Bar diff --git a/Examples/python/import_packages/from_init1/py2/pkg2/bar.hpp b/Examples/python/import_packages/from_init1/py2/pkg2/bar.hpp new file mode 100644 index 0000000..b369161 --- /dev/null +++ b/Examples/python/import_packages/from_init1/py2/pkg2/bar.hpp @@ -0,0 +1,5 @@ +#ifndef PY2_PKG2_BAR_HPP +#define PY2_PKG2_BAR_HPP +#include "../../py2/pkg2/foo.hpp" +struct Pkg2_Bar : Pkg2_Foo {}; +#endif /* PY2_PKG2_BAR_HPP */ diff --git a/Examples/python/import_packages/from_init1/py2/pkg2/bar.i b/Examples/python/import_packages/from_init1/py2/pkg2/bar.i new file mode 100644 index 0000000..0795a77 --- /dev/null +++ b/Examples/python/import_packages/from_init1/py2/pkg2/bar.i @@ -0,0 +1,6 @@ +%module(package="py2.pkg2") bar +%{ +#include "../../py2/pkg2/bar.hpp" +%} +%import "../../py2/pkg2/foo.i" +%include "../../py2/pkg2/bar.hpp" diff --git a/Examples/python/import_packages/from_init1/py2/pkg2/foo.hpp b/Examples/python/import_packages/from_init1/py2/pkg2/foo.hpp new file mode 100644 index 0000000..fed8239 --- /dev/null +++ b/Examples/python/import_packages/from_init1/py2/pkg2/foo.hpp @@ -0,0 +1,4 @@ +#ifndef PY2_PKG2_FOO_HPP +#define PY2_PKG2_FOO_HPP +struct Pkg2_Foo {}; +#endif /* PY2_PKG2_FOO_HPP */ diff --git a/Examples/python/import_packages/from_init1/py2/pkg2/foo.i b/Examples/python/import_packages/from_init1/py2/pkg2/foo.i new file mode 100644 index 0000000..37b2e1f --- /dev/null +++ b/Examples/python/import_packages/from_init1/py2/pkg2/foo.i @@ -0,0 +1,5 @@ +%module(package="py2.pkg2") foo +%{ +#include "../../py2/pkg2/foo.hpp" +%} +%include "../../py2/pkg2/foo.hpp" diff --git a/Examples/python/import_packages/from_init1/py3/Makefile b/Examples/python/import_packages/from_init1/py3/Makefile new file mode 100644 index 0000000..6296251 --- /dev/null +++ b/Examples/python/import_packages/from_init1/py3/Makefile @@ -0,0 +1,13 @@ +TOP = ../../../.. +SWIGOPT = +LIBS = + +build: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg2 && $(MAKE) clean diff --git a/Examples/python/import_packages/from_init1/py3/__init__.py b/Examples/python/import_packages/from_init1/py3/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/from_init1/py3/pkg2/Makefile b/Examples/python/import_packages/from_init1/py3/pkg2/Makefile new file mode 100644 index 0000000..102a893 --- /dev/null +++ b/Examples/python/import_packages/from_init1/py3/pkg2/Makefile @@ -0,0 +1,25 @@ +TOP = ../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp_static + +clean:: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='bar' python_clean diff --git a/Examples/python/import_packages/from_init1/py3/pkg2/__init__.py b/Examples/python/import_packages/from_init1/py3/pkg2/__init__.py new file mode 100644 index 0000000..2097aaf --- /dev/null +++ b/Examples/python/import_packages/from_init1/py3/pkg2/__init__.py @@ -0,0 +1 @@ +from .bar import Pkg2_Bar diff --git a/Examples/python/import_packages/from_init1/py3/pkg2/bar.hpp b/Examples/python/import_packages/from_init1/py3/pkg2/bar.hpp new file mode 100644 index 0000000..d16463d --- /dev/null +++ b/Examples/python/import_packages/from_init1/py3/pkg2/bar.hpp @@ -0,0 +1,5 @@ +#ifndef PY3_PKG2_BAR_HPP +#define PY3_PKG2_BAR_HPP +#include "../../py3/pkg2/foo.hpp" +struct Pkg2_Bar : Pkg2_Foo {}; +#endif /* PY3_PKG2_BAR_HPP */ diff --git a/Examples/python/import_packages/from_init1/py3/pkg2/bar.i b/Examples/python/import_packages/from_init1/py3/pkg2/bar.i new file mode 100644 index 0000000..8d8d627 --- /dev/null +++ b/Examples/python/import_packages/from_init1/py3/pkg2/bar.i @@ -0,0 +1,6 @@ +%module(package="py3.pkg2") bar +%{ +#include "../../py3/pkg2/bar.hpp" +%} +%import "../../py3/pkg2/foo.i" +%include "../../py3/pkg2/bar.hpp" diff --git a/Examples/python/import_packages/from_init1/py3/pkg2/foo.hpp b/Examples/python/import_packages/from_init1/py3/pkg2/foo.hpp new file mode 100644 index 0000000..c2469dc --- /dev/null +++ b/Examples/python/import_packages/from_init1/py3/pkg2/foo.hpp @@ -0,0 +1,4 @@ +#ifndef PY3_PKG2_FOO_HPP +#define PY3_PKG2_FOO_HPP +struct Pkg2_Foo {}; +#endif /* PY3_PKG2_FOO_HPP */ diff --git a/Examples/python/import_packages/from_init1/py3/pkg2/foo.i b/Examples/python/import_packages/from_init1/py3/pkg2/foo.i new file mode 100644 index 0000000..76613b5 --- /dev/null +++ b/Examples/python/import_packages/from_init1/py3/pkg2/foo.i @@ -0,0 +1,5 @@ +%module(package="py3.pkg2") foo +%{ +#include "../../py3/pkg2/foo.hpp" +%} +%include "../../py3/pkg2/foo.hpp" diff --git a/Examples/python/import_packages/from_init1/runme.py b/Examples/python/import_packages/from_init1/runme.py new file mode 100644 index 0000000..dda3974 --- /dev/null +++ b/Examples/python/import_packages/from_init1/runme.py @@ -0,0 +1,13 @@ +import sys +import os.path + +# Test import of modules content from within __init__.py +testname = os.path.basename(os.path.dirname(os.path.abspath(__file__))) +print "Testing " + testname + " - %module(package=...) + python 'import' in __init__.py" + +if sys.version_info < (3, 0): + import py2.pkg2 + print " Finished importing py2.pkg2" +else: + import py3.pkg2 + print " Finished importing py3.pkg2" diff --git a/Examples/python/import_packages/from_init2/Makefile b/Examples/python/import_packages/from_init2/Makefile new file mode 100644 index 0000000..90c92ab --- /dev/null +++ b/Examples/python/import_packages/from_init2/Makefile @@ -0,0 +1,22 @@ +TOP = ../../.. +LIBS = + +ifeq (,$(PY3)) + PKG1DIR = "py2" +else + PKG1DIR = "py3" +endif + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run + +build: + cd $(PKG1DIR) && $(MAKE) SWIGOPT='$(SWIGOPT) -relativeimport' LIBS='$(LIBS)' build + +static: + cd $(PKG1DIR) && $(MAKE) SWIGOPT='$(SWIGOPT) -relativeimport' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd py2 && $(MAKE) clean + cd py3 && $(MAKE) clean diff --git a/Examples/python/import_packages/from_init2/README b/Examples/python/import_packages/from_init2/README new file mode 100644 index 0000000..a0eb418 --- /dev/null +++ b/Examples/python/import_packages/from_init2/README @@ -0,0 +1,81 @@ +This example tests the %import directive and python import from __init__.py. + +This case is not correctly handled by swig 2. + +The issue was reported as Source Forge bug #1297 and later as GitHub issue #7. + +Use 'python runme.py' to run a test. + +Overview: +--------- + +The example defines 2 different extension modules--each wrapping a separate C++ +class. + + pyX/pkg2/pkg3/foo.i - Pkg3_Foo class + pyX/pkg2/bar.i - Pkg2_Bar class derived from Pkg3_Foo + +and the package pyX.pkg2 has: + + pyX/pkg2/__init__.py - which imports something from "bar" module + +For example with python 2.x the py2/pkg2/__init__.py imports Pkg2_Bar class as +follows + + from bar import Pkg2_Bar # [1] + +Such cases doesn't work when fully qualified python module names are used by +swig to generate python import directives (SF bug #1297). The generated file +"py2/pkg2/bar.py" has following lines: + + import py2.pkg2.pkg3.foo # [2] + class Pkg2_Bar(py2.pkg2.pkg3.foo.Pkg3_Foo): # [3] + +and it's not possible to import anything from py2.pkg2 subpackage, e.g. + + import py2.pkg2 + +fails with the following exception: + +Traceback (most recent call last): + File "runme.py", line 3, in + import py2.pkg2 + File "py2/pkg2/__init__.py", line 4, in + from bar import Pkg2_Bar + File "py2/pkg2/bar.py", line 71, in + class Pkg2_Bar(py2.pkg2.pkg3.foo.Pkg3_Foo): +AttributeError: 'module' object has no attribute 'pkg2' + +It seems like during the import [1], the subpackage pkg2 is not yet fully +initialized, so pyX.pkg2 is not known. The above exception is raised at line [3]. +The problem disappears, for example, if we force swig to use relative package +names. + +The difference between this ('from_init2') case and the case +'from_init1' is that here it's not sufficient to import relative module +by just ignoring the package part of the fully qualified module name. IOW +it is not correct to force swig to put: + + import foo + class Pkg2_Bar(foo.Pkg3_Foo) + +into pyX/pkg2/bar.py (note, that this would work for 'from_init1' case). +The import directive shall be rather: + + import pkg3.foo + +for python 2.x and: + + from . import pkg3 + import pkg3.foo + +for python 3, and the class definition shall begin with: + + class Pkg2_Bar(pkg3.foo.Pkg3_Foo) + +If everything works well, the package pyX.pkg2 shall load properly. + +Unix: +----- +- Run make +- Run the test as described above diff --git a/Examples/python/import_packages/from_init2/py2/Makefile b/Examples/python/import_packages/from_init2/py2/Makefile new file mode 100644 index 0000000..6296251 --- /dev/null +++ b/Examples/python/import_packages/from_init2/py2/Makefile @@ -0,0 +1,13 @@ +TOP = ../../../.. +SWIGOPT = +LIBS = + +build: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg2 && $(MAKE) clean diff --git a/Examples/python/import_packages/from_init2/py2/__init__.py b/Examples/python/import_packages/from_init2/py2/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/from_init2/py2/pkg2/Makefile b/Examples/python/import_packages/from_init2/py2/pkg2/Makefile new file mode 100644 index 0000000..c1f234e --- /dev/null +++ b/Examples/python/import_packages/from_init2/py2/pkg2/Makefile @@ -0,0 +1,21 @@ +TOP = ../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='bar' python_clean + cd pkg3 && $(MAKE) clean diff --git a/Examples/python/import_packages/from_init2/py2/pkg2/__init__.py b/Examples/python/import_packages/from_init2/py2/pkg2/__init__.py new file mode 100644 index 0000000..0f9c902 --- /dev/null +++ b/Examples/python/import_packages/from_init2/py2/pkg2/__init__.py @@ -0,0 +1 @@ +from bar import Pkg2_Bar diff --git a/Examples/python/import_packages/from_init2/py2/pkg2/bar.hpp b/Examples/python/import_packages/from_init2/py2/pkg2/bar.hpp new file mode 100644 index 0000000..8f09cd5 --- /dev/null +++ b/Examples/python/import_packages/from_init2/py2/pkg2/bar.hpp @@ -0,0 +1,5 @@ +#ifndef PY2_PKG2_BAR_HPP +#define PY2_PKG2_BAR_HPP +#include "../../py2/pkg2/pkg3/foo.hpp" +struct Pkg2_Bar : Pkg3_Foo {}; +#endif /* PY2_PKG2_BAR_HPP */ diff --git a/Examples/python/import_packages/from_init2/py2/pkg2/bar.i b/Examples/python/import_packages/from_init2/py2/pkg2/bar.i new file mode 100644 index 0000000..28a4c90 --- /dev/null +++ b/Examples/python/import_packages/from_init2/py2/pkg2/bar.i @@ -0,0 +1,6 @@ +%module(package="py2.pkg2") bar +%{ +#include "../../py2/pkg2/bar.hpp" +%} +%import "../../py2/pkg2/pkg3/foo.i" +%include "../../py2/pkg2/bar.hpp" diff --git a/Examples/python/import_packages/from_init2/py2/pkg2/pkg3/Makefile b/Examples/python/import_packages/from_init2/py2/pkg2/pkg3/Makefile new file mode 100644 index 0000000..7a0cb18 --- /dev/null +++ b/Examples/python/import_packages/from_init2/py2/pkg2/pkg3/Makefile @@ -0,0 +1,18 @@ +TOP = ../../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean diff --git a/Examples/python/import_packages/from_init2/py2/pkg2/pkg3/__init__.py b/Examples/python/import_packages/from_init2/py2/pkg2/pkg3/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/from_init2/py2/pkg2/pkg3/foo.hpp b/Examples/python/import_packages/from_init2/py2/pkg2/pkg3/foo.hpp new file mode 100644 index 0000000..b6c89a4 --- /dev/null +++ b/Examples/python/import_packages/from_init2/py2/pkg2/pkg3/foo.hpp @@ -0,0 +1,4 @@ +#ifndef PY2_PKG2_PKG3_FOO_HPP +#define PY2_PKG2_PKG3_FOO_HPP +struct Pkg3_Foo {}; +#endif /* PY2_PKG2_PKG3_FOO_HPP */ diff --git a/Examples/python/import_packages/from_init2/py2/pkg2/pkg3/foo.i b/Examples/python/import_packages/from_init2/py2/pkg2/pkg3/foo.i new file mode 100644 index 0000000..ba32483 --- /dev/null +++ b/Examples/python/import_packages/from_init2/py2/pkg2/pkg3/foo.i @@ -0,0 +1,5 @@ +%module(package="py2.pkg2.pkg3") foo +%{ +#include "../../../py2/pkg2/pkg3/foo.hpp" +%} +%include "../../../py2/pkg2/pkg3/foo.hpp" diff --git a/Examples/python/import_packages/from_init2/py3/Makefile b/Examples/python/import_packages/from_init2/py3/Makefile new file mode 100644 index 0000000..6296251 --- /dev/null +++ b/Examples/python/import_packages/from_init2/py3/Makefile @@ -0,0 +1,13 @@ +TOP = ../../../.. +SWIGOPT = +LIBS = + +build: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg2 && $(MAKE) clean diff --git a/Examples/python/import_packages/from_init2/py3/__init__.py b/Examples/python/import_packages/from_init2/py3/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/from_init2/py3/pkg2/Makefile b/Examples/python/import_packages/from_init2/py3/pkg2/Makefile new file mode 100644 index 0000000..c1f234e --- /dev/null +++ b/Examples/python/import_packages/from_init2/py3/pkg2/Makefile @@ -0,0 +1,21 @@ +TOP = ../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='bar' python_clean + cd pkg3 && $(MAKE) clean diff --git a/Examples/python/import_packages/from_init2/py3/pkg2/__init__.py b/Examples/python/import_packages/from_init2/py3/pkg2/__init__.py new file mode 100644 index 0000000..2097aaf --- /dev/null +++ b/Examples/python/import_packages/from_init2/py3/pkg2/__init__.py @@ -0,0 +1 @@ +from .bar import Pkg2_Bar diff --git a/Examples/python/import_packages/from_init2/py3/pkg2/bar.hpp b/Examples/python/import_packages/from_init2/py3/pkg2/bar.hpp new file mode 100644 index 0000000..408d910 --- /dev/null +++ b/Examples/python/import_packages/from_init2/py3/pkg2/bar.hpp @@ -0,0 +1,5 @@ +#ifndef PY3_PKG2_BAR_HPP +#define PY3_PKG2_BAR_HPP +#include "../../py3/pkg2/pkg3/foo.hpp" +struct Pkg2_Bar : Pkg3_Foo {}; +#endif /* PY3_PKG2_BAR_HPP */ diff --git a/Examples/python/import_packages/from_init2/py3/pkg2/bar.i b/Examples/python/import_packages/from_init2/py3/pkg2/bar.i new file mode 100644 index 0000000..1468932 --- /dev/null +++ b/Examples/python/import_packages/from_init2/py3/pkg2/bar.i @@ -0,0 +1,6 @@ +%module(package="py3.pkg2") bar +%{ +#include "../../py3/pkg2/bar.hpp" +%} +%import "../../py3/pkg2/pkg3/foo.i" +%include "../../py3/pkg2/bar.hpp" diff --git a/Examples/python/import_packages/from_init2/py3/pkg2/pkg3/Makefile b/Examples/python/import_packages/from_init2/py3/pkg2/pkg3/Makefile new file mode 100644 index 0000000..7a0cb18 --- /dev/null +++ b/Examples/python/import_packages/from_init2/py3/pkg2/pkg3/Makefile @@ -0,0 +1,18 @@ +TOP = ../../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean diff --git a/Examples/python/import_packages/from_init2/py3/pkg2/pkg3/__init__.py b/Examples/python/import_packages/from_init2/py3/pkg2/pkg3/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/from_init2/py3/pkg2/pkg3/foo.hpp b/Examples/python/import_packages/from_init2/py3/pkg2/pkg3/foo.hpp new file mode 100644 index 0000000..531721d --- /dev/null +++ b/Examples/python/import_packages/from_init2/py3/pkg2/pkg3/foo.hpp @@ -0,0 +1,4 @@ +#ifndef PY3_PKG2_PKG3_FOO_HPP +#define PY3_PKG2_PKG3_FOO_HPP +struct Pkg3_Foo {}; +#endif /* PY3_PKG2_PKG3_FOO_HPP */ diff --git a/Examples/python/import_packages/from_init2/py3/pkg2/pkg3/foo.i b/Examples/python/import_packages/from_init2/py3/pkg2/pkg3/foo.i new file mode 100644 index 0000000..c6ba529 --- /dev/null +++ b/Examples/python/import_packages/from_init2/py3/pkg2/pkg3/foo.i @@ -0,0 +1,5 @@ +%module(package="py3.pkg2.pkg3") foo +%{ +#include "../../../py3/pkg2/pkg3/foo.hpp" +%} +%include "../../../py3/pkg2/pkg3/foo.hpp" diff --git a/Examples/python/import_packages/from_init2/runme.py b/Examples/python/import_packages/from_init2/runme.py new file mode 100644 index 0000000..dda3974 --- /dev/null +++ b/Examples/python/import_packages/from_init2/runme.py @@ -0,0 +1,13 @@ +import sys +import os.path + +# Test import of modules content from within __init__.py +testname = os.path.basename(os.path.dirname(os.path.abspath(__file__))) +print "Testing " + testname + " - %module(package=...) + python 'import' in __init__.py" + +if sys.version_info < (3, 0): + import py2.pkg2 + print " Finished importing py2.pkg2" +else: + import py3.pkg2 + print " Finished importing py3.pkg2" diff --git a/Examples/python/import_packages/from_init3/Makefile b/Examples/python/import_packages/from_init3/Makefile new file mode 100644 index 0000000..90c92ab --- /dev/null +++ b/Examples/python/import_packages/from_init3/Makefile @@ -0,0 +1,22 @@ +TOP = ../../.. +LIBS = + +ifeq (,$(PY3)) + PKG1DIR = "py2" +else + PKG1DIR = "py3" +endif + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run + +build: + cd $(PKG1DIR) && $(MAKE) SWIGOPT='$(SWIGOPT) -relativeimport' LIBS='$(LIBS)' build + +static: + cd $(PKG1DIR) && $(MAKE) SWIGOPT='$(SWIGOPT) -relativeimport' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd py2 && $(MAKE) clean + cd py3 && $(MAKE) clean diff --git a/Examples/python/import_packages/from_init3/README b/Examples/python/import_packages/from_init3/README new file mode 100644 index 0000000..131d589 --- /dev/null +++ b/Examples/python/import_packages/from_init3/README @@ -0,0 +1,67 @@ +This example tests the %import directive and python import from __init__.py. + +This case is not correctly handled by swig 2. + +The issue was reported as Source Forge bug #1297 and later as GitHub issue #7. + +Use 'python runme.py' to run a test. + +Overview: +--------- + +The example defines 2 different extension modules--each wrapping a separate C++ +class. + + pyX/pkg2/pkg3/pkg4/foo.i - Pkg4_Foo class + pyX/pkg2/bar.i - Pkg2_Bar class derived from Pkg4_Foo + +and the package pyX.pkg2 has: + + pyX/pkg2/__init__.py - which imports something from "bar" module + +For example with python 2.x the py2/pkg2/__init__.py imports Pkg2_Bar class as +follows + + from bar import Pkg2_Bar # [1] + +Such cases doesn't work when fully qualified python module names are used by +swig to generate python import directives (SF bug 1297). The generated file +"py2/pkg2/bar.py" has following lines: + + import py2.pkg2.pkg3.pkg4.foo # [2] + class Pkg2_Bar(py2.pkg2.pkg3.pkg4.foo.P1_S1_S2_Foo): # [3] + +and it's not possible to import anything from py2.pkg2 subpackage, e.g. + + import py2.pkg2 + +fails with the following exception: + + Traceback (most recent call last): + File "runme.py", line 3, in + import py2.pkg2 + File "py2/pkg2/__init__.py", line 4, in + from bar import Pkg2_Bar + File "py2/pkg2/bar.py", line 71, in + class Pkg2_Bar(py2.pkg2.pkg3.pkg4.foo.Pkg4_Foo): + AttributeError: 'module' object has no attribute 'pkg2' + +It seems like during the import [1], the subpackage pkg2 is not yet fully +initialized, so py2.pkg2 can't be used. The above exception is raised at +line [3]. The problem disappears, for example, if we force swig to use relative +package names. + +The difference between this ('from_init3') case and the case +'from_init2' is that here we import base class from module +pyX.pkg2.pkg3.pkg4.foo, which is nested deeper than it was in +'from_init2'. This is just to ensure, that two (and more) levels of +subpackages get imported correctly by generated python code, i.e, not only +'pkg3.foo' is handled properly (one-level subpackage) but the code works also +for 'pkg3.pkg4.foo', and so on. + +If everything works well, the package pyX.pkg2 shall load properly. + +Unix: +----- +- Run make +- Run the test as described above diff --git a/Examples/python/import_packages/from_init3/py2/Makefile b/Examples/python/import_packages/from_init3/py2/Makefile new file mode 100644 index 0000000..6296251 --- /dev/null +++ b/Examples/python/import_packages/from_init3/py2/Makefile @@ -0,0 +1,13 @@ +TOP = ../../../.. +SWIGOPT = +LIBS = + +build: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg2 && $(MAKE) clean diff --git a/Examples/python/import_packages/from_init3/py2/__init__.py b/Examples/python/import_packages/from_init3/py2/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/from_init3/py2/pkg2/Makefile b/Examples/python/import_packages/from_init3/py2/pkg2/Makefile new file mode 100644 index 0000000..c1f234e --- /dev/null +++ b/Examples/python/import_packages/from_init3/py2/pkg2/Makefile @@ -0,0 +1,21 @@ +TOP = ../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='bar' python_clean + cd pkg3 && $(MAKE) clean diff --git a/Examples/python/import_packages/from_init3/py2/pkg2/__init__.py b/Examples/python/import_packages/from_init3/py2/pkg2/__init__.py new file mode 100644 index 0000000..0f9c902 --- /dev/null +++ b/Examples/python/import_packages/from_init3/py2/pkg2/__init__.py @@ -0,0 +1 @@ +from bar import Pkg2_Bar diff --git a/Examples/python/import_packages/from_init3/py2/pkg2/bar.hpp b/Examples/python/import_packages/from_init3/py2/pkg2/bar.hpp new file mode 100644 index 0000000..20a0019 --- /dev/null +++ b/Examples/python/import_packages/from_init3/py2/pkg2/bar.hpp @@ -0,0 +1,5 @@ +#ifndef PY2_PKG2_HPP +#define PY2_PKG2_HPP +#include "../../py2/pkg2/pkg3/pkg4/foo.hpp" +struct Pkg2_Bar : Pkg4_Foo {}; +#endif /* PY2_PKG2_HPP */ diff --git a/Examples/python/import_packages/from_init3/py2/pkg2/bar.i b/Examples/python/import_packages/from_init3/py2/pkg2/bar.i new file mode 100644 index 0000000..0a932a2 --- /dev/null +++ b/Examples/python/import_packages/from_init3/py2/pkg2/bar.i @@ -0,0 +1,6 @@ +%module(package="py2.pkg2") bar +%{ +#include "../../py2/pkg2/bar.hpp" +%} +%import "../../py2/pkg2/pkg3/pkg4/foo.i" +%include "../../py2/pkg2/bar.hpp" diff --git a/Examples/python/import_packages/from_init3/py2/pkg2/pkg3/Makefile b/Examples/python/import_packages/from_init3/py2/pkg2/pkg3/Makefile new file mode 100644 index 0000000..6f193fa --- /dev/null +++ b/Examples/python/import_packages/from_init3/py2/pkg2/pkg3/Makefile @@ -0,0 +1,13 @@ +TOP = ../../../../../.. +SWIGOPT = +LIBS = + +build: + cd pkg4 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg4 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg4 && $(MAKE) clean diff --git a/Examples/python/import_packages/from_init3/py2/pkg2/pkg3/__init__.py b/Examples/python/import_packages/from_init3/py2/pkg2/pkg3/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/from_init3/py2/pkg2/pkg3/pkg4/Makefile b/Examples/python/import_packages/from_init3/py2/pkg2/pkg3/pkg4/Makefile new file mode 100644 index 0000000..a870607 --- /dev/null +++ b/Examples/python/import_packages/from_init3/py2/pkg2/pkg3/pkg4/Makefile @@ -0,0 +1,18 @@ +TOP = ../../../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean diff --git a/Examples/python/import_packages/from_init3/py2/pkg2/pkg3/pkg4/__init__.py b/Examples/python/import_packages/from_init3/py2/pkg2/pkg3/pkg4/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/from_init3/py2/pkg2/pkg3/pkg4/foo.hpp b/Examples/python/import_packages/from_init3/py2/pkg2/pkg3/pkg4/foo.hpp new file mode 100644 index 0000000..2df933c --- /dev/null +++ b/Examples/python/import_packages/from_init3/py2/pkg2/pkg3/pkg4/foo.hpp @@ -0,0 +1,4 @@ +#ifndef PY2_PKG2_PKG3_PKG4 +#define PY2_PKG2_PKG3_PKG4 +struct Pkg4_Foo {}; +#endif /* PY2_PKG2_PKG3_PKG4 */ diff --git a/Examples/python/import_packages/from_init3/py2/pkg2/pkg3/pkg4/foo.i b/Examples/python/import_packages/from_init3/py2/pkg2/pkg3/pkg4/foo.i new file mode 100644 index 0000000..311d716 --- /dev/null +++ b/Examples/python/import_packages/from_init3/py2/pkg2/pkg3/pkg4/foo.i @@ -0,0 +1,5 @@ +%module(package="py2.pkg2.pkg3.pkg4") foo +%{ +#include "../../../../py2/pkg2/pkg3/pkg4/foo.hpp" +%} +%include "../../../../py2/pkg2/pkg3/pkg4/foo.hpp" diff --git a/Examples/python/import_packages/from_init3/py3/Makefile b/Examples/python/import_packages/from_init3/py3/Makefile new file mode 100644 index 0000000..6296251 --- /dev/null +++ b/Examples/python/import_packages/from_init3/py3/Makefile @@ -0,0 +1,13 @@ +TOP = ../../../.. +SWIGOPT = +LIBS = + +build: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg2 && $(MAKE) clean diff --git a/Examples/python/import_packages/from_init3/py3/__init__.py b/Examples/python/import_packages/from_init3/py3/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/from_init3/py3/pkg2/Makefile b/Examples/python/import_packages/from_init3/py3/pkg2/Makefile new file mode 100644 index 0000000..c1f234e --- /dev/null +++ b/Examples/python/import_packages/from_init3/py3/pkg2/Makefile @@ -0,0 +1,21 @@ +TOP = ../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='bar' python_clean + cd pkg3 && $(MAKE) clean diff --git a/Examples/python/import_packages/from_init3/py3/pkg2/__init__.py b/Examples/python/import_packages/from_init3/py3/pkg2/__init__.py new file mode 100644 index 0000000..2097aaf --- /dev/null +++ b/Examples/python/import_packages/from_init3/py3/pkg2/__init__.py @@ -0,0 +1 @@ +from .bar import Pkg2_Bar diff --git a/Examples/python/import_packages/from_init3/py3/pkg2/bar.hpp b/Examples/python/import_packages/from_init3/py3/pkg2/bar.hpp new file mode 100644 index 0000000..16fdd36 --- /dev/null +++ b/Examples/python/import_packages/from_init3/py3/pkg2/bar.hpp @@ -0,0 +1,5 @@ +#ifndef PY3_PKG2_HPP +#define PY3_PKG2_HPP +#include "../../py3/pkg2/pkg3/pkg4/foo.hpp" +struct Pkg2_Bar : Pkg4_Foo {}; +#endif /* PY3_PKG2_HPP */ diff --git a/Examples/python/import_packages/from_init3/py3/pkg2/bar.i b/Examples/python/import_packages/from_init3/py3/pkg2/bar.i new file mode 100644 index 0000000..3abbb05 --- /dev/null +++ b/Examples/python/import_packages/from_init3/py3/pkg2/bar.i @@ -0,0 +1,6 @@ +%module(package="py3.pkg2") bar +%{ +#include "../../py3/pkg2/bar.hpp" +%} +%import "../../py3/pkg2/pkg3/pkg4/foo.i" +%include "../../py3/pkg2/bar.hpp" diff --git a/Examples/python/import_packages/from_init3/py3/pkg2/pkg3/Makefile b/Examples/python/import_packages/from_init3/py3/pkg2/pkg3/Makefile new file mode 100644 index 0000000..6f193fa --- /dev/null +++ b/Examples/python/import_packages/from_init3/py3/pkg2/pkg3/Makefile @@ -0,0 +1,13 @@ +TOP = ../../../../../.. +SWIGOPT = +LIBS = + +build: + cd pkg4 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg4 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg4 && $(MAKE) clean diff --git a/Examples/python/import_packages/from_init3/py3/pkg2/pkg3/__init__.py b/Examples/python/import_packages/from_init3/py3/pkg2/pkg3/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/from_init3/py3/pkg2/pkg3/pkg4/Makefile b/Examples/python/import_packages/from_init3/py3/pkg2/pkg3/pkg4/Makefile new file mode 100644 index 0000000..a870607 --- /dev/null +++ b/Examples/python/import_packages/from_init3/py3/pkg2/pkg3/pkg4/Makefile @@ -0,0 +1,18 @@ +TOP = ../../../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean diff --git a/Examples/python/import_packages/from_init3/py3/pkg2/pkg3/pkg4/__init__.py b/Examples/python/import_packages/from_init3/py3/pkg2/pkg3/pkg4/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/from_init3/py3/pkg2/pkg3/pkg4/foo.hpp b/Examples/python/import_packages/from_init3/py3/pkg2/pkg3/pkg4/foo.hpp new file mode 100644 index 0000000..e24654c --- /dev/null +++ b/Examples/python/import_packages/from_init3/py3/pkg2/pkg3/pkg4/foo.hpp @@ -0,0 +1,4 @@ +#ifndef PY3_PKG2_PKG3_PKG4 +#define PY3_PKG2_PKG3_PKG4 +struct Pkg4_Foo {}; +#endif /* PY3_PKG2_PKG3_PKG4 */ diff --git a/Examples/python/import_packages/from_init3/py3/pkg2/pkg3/pkg4/foo.i b/Examples/python/import_packages/from_init3/py3/pkg2/pkg3/pkg4/foo.i new file mode 100644 index 0000000..36c5f01 --- /dev/null +++ b/Examples/python/import_packages/from_init3/py3/pkg2/pkg3/pkg4/foo.i @@ -0,0 +1,5 @@ +%module(package="py3.pkg2.pkg3.pkg4") foo +%{ +#include "../../../../py3/pkg2/pkg3/pkg4/foo.hpp" +%} +%include "../../../../py3/pkg2/pkg3/pkg4/foo.hpp" diff --git a/Examples/python/import_packages/from_init3/runme.py b/Examples/python/import_packages/from_init3/runme.py new file mode 100644 index 0000000..dda3974 --- /dev/null +++ b/Examples/python/import_packages/from_init3/runme.py @@ -0,0 +1,13 @@ +import sys +import os.path + +# Test import of modules content from within __init__.py +testname = os.path.basename(os.path.dirname(os.path.abspath(__file__))) +print "Testing " + testname + " - %module(package=...) + python 'import' in __init__.py" + +if sys.version_info < (3, 0): + import py2.pkg2 + print " Finished importing py2.pkg2" +else: + import py3.pkg2 + print " Finished importing py3.pkg2" diff --git a/Examples/python/import_packages/namespace_pkg/Makefile b/Examples/python/import_packages/namespace_pkg/Makefile new file mode 100644 index 0000000..d868713 --- /dev/null +++ b/Examples/python/import_packages/namespace_pkg/Makefile @@ -0,0 +1,17 @@ +TOP = ../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +TARGET = robin +INTERFACE = robin.i + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean + rm -rf path1 path2 path3 path4.zip diff --git a/Examples/python/import_packages/namespace_pkg/README b/Examples/python/import_packages/namespace_pkg/README new file mode 100644 index 0000000..8f7297a --- /dev/null +++ b/Examples/python/import_packages/namespace_pkg/README @@ -0,0 +1,25 @@ + This is an example (and test) of using swig generated modules in the context +of python3's namespace packages: + +https://www.python.org/dev/peps/pep-0420/ + + Consequently, this example requires python (3.3 or newer) to build and run. + + This example creates a simple swig module named robin. The robin.py module +has a companion C module named _robin.so. The robin module is tested in four +ways: + + 1) As a non-package module (tested by nonpkg.py) + + 2) With robin.py and _robin.so in the brave package under the path1 + subdirectory. (tested by normal.py) + + 3) With robin.py in path2/brave and _robin.so in path3/brave + (tested by split.py) + + 4) With robin.py contained in a zip file (path4.zip) as brave/robin.py and + _robin.so found on the filesystem under path3/brave (tested by zipsplit.py) + +Note: Using namespace packages with subpackages (such as brave.sir.robin) where + robin.py is located in a zipfile requires python-3.5.1 or newer as + python's zipimporter only worked with packages of depth 1 until then. \ No newline at end of file diff --git a/Examples/python/import_packages/namespace_pkg/nonpkg.py b/Examples/python/import_packages/namespace_pkg/nonpkg.py new file mode 100644 index 0000000..acf0aed --- /dev/null +++ b/Examples/python/import_packages/namespace_pkg/nonpkg.py @@ -0,0 +1,5 @@ +# import robin as a module in the global namespace + +import robin + +assert(robin.run() == "AWAY!") diff --git a/Examples/python/import_packages/namespace_pkg/normal.py b/Examples/python/import_packages/namespace_pkg/normal.py new file mode 100644 index 0000000..fc26c02 --- /dev/null +++ b/Examples/python/import_packages/namespace_pkg/normal.py @@ -0,0 +1,7 @@ +import sys +# Package brave found under one path +sys.path.insert(0, 'path1') + +from brave import robin + +assert(robin.run() == "AWAY!") diff --git a/Examples/python/import_packages/namespace_pkg/nstest.py b/Examples/python/import_packages/namespace_pkg/nstest.py new file mode 100644 index 0000000..9b075ad --- /dev/null +++ b/Examples/python/import_packages/namespace_pkg/nstest.py @@ -0,0 +1,45 @@ +import sys +import os +import shutil +import zipfile + + +def copyMods(): + dirs = ['path1', 'path2', 'path3'] + + # Clean out any old package paths + for d in dirs: + if os.path.isdir(d): + shutil.rmtree(d) + + for d in dirs: + os.mkdir(d) + os.mkdir(os.path.join(d, 'brave')) + + shutil.copy('robin.py', os.path.join('path1', 'brave')) + os.system('cp _robin.* ' + os.path.join('path1', 'brave')) + + shutil.copy('robin.py', os.path.join('path2', 'brave')) + os.system('cp _robin.* ' + os.path.join('path3', 'brave')) + + mkzip() + +def mkzip(): + zf = zipfile.ZipFile("path4.zip", "w") + zf.writestr("brave/", b'') + zf.write('robin.py', 'brave/robin.py') + zf.close() + + +def main(): + copyMods() + + # Run each test with a separate interpreter + os.system(sys.executable + " nonpkg.py") + os.system(sys.executable + " normal.py") + os.system(sys.executable + " split.py") + os.system(sys.executable + " zipsplit.py") + + +if __name__ == "__main__": + main() diff --git a/Examples/python/import_packages/namespace_pkg/robin.i b/Examples/python/import_packages/namespace_pkg/robin.i new file mode 100644 index 0000000..3949221 --- /dev/null +++ b/Examples/python/import_packages/namespace_pkg/robin.i @@ -0,0 +1,7 @@ +%module robin + +%inline %{ +const char *run(void) { + return "AWAY!"; +} +%} diff --git a/Examples/python/import_packages/namespace_pkg/runme.py b/Examples/python/import_packages/namespace_pkg/runme.py new file mode 100644 index 0000000..9c22d36 --- /dev/null +++ b/Examples/python/import_packages/namespace_pkg/runme.py @@ -0,0 +1,17 @@ +# These examples rely on namespace packages. Don't +# run them for old python interpreters. +import sys +import os.path + +testname = os.path.basename(os.path.dirname(os.path.abspath(__file__))) +print "Testing " + testname + " - namespace packages" + +if sys.version_info < (3, 3, 0): + print " Not importing nstest as Python version is < 3.3" + sys.exit(0) + +import nstest + +print " Finished importing nstest" + +nstest.main() diff --git a/Examples/python/import_packages/namespace_pkg/split.py b/Examples/python/import_packages/namespace_pkg/split.py new file mode 100644 index 0000000..1b66c2d --- /dev/null +++ b/Examples/python/import_packages/namespace_pkg/split.py @@ -0,0 +1,9 @@ +import sys +# Package brave split into two paths. +# path2/brave/robin.py and path3/brave/_robin.so +sys.path.insert(0, 'path2') +sys.path.insert(0, 'path3') + +from brave import robin + +assert(robin.run() == "AWAY!") diff --git a/Examples/python/import_packages/namespace_pkg/zipsplit.py b/Examples/python/import_packages/namespace_pkg/zipsplit.py new file mode 100644 index 0000000..9e35559 --- /dev/null +++ b/Examples/python/import_packages/namespace_pkg/zipsplit.py @@ -0,0 +1,9 @@ +import sys +# Package brave split into two paths. +# brave/robin.py (in path4.zip) and path3/brave/_robin.so +sys.path.insert(0, 'path4.zip') +sys.path.insert(0, 'path3') + +from brave import robin + +assert(robin.run() == "AWAY!") diff --git a/Examples/python/import_packages/relativeimport1/Makefile b/Examples/python/import_packages/relativeimport1/Makefile new file mode 100644 index 0000000..90c92ab --- /dev/null +++ b/Examples/python/import_packages/relativeimport1/Makefile @@ -0,0 +1,22 @@ +TOP = ../../.. +LIBS = + +ifeq (,$(PY3)) + PKG1DIR = "py2" +else + PKG1DIR = "py3" +endif + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run + +build: + cd $(PKG1DIR) && $(MAKE) SWIGOPT='$(SWIGOPT) -relativeimport' LIBS='$(LIBS)' build + +static: + cd $(PKG1DIR) && $(MAKE) SWIGOPT='$(SWIGOPT) -relativeimport' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd py2 && $(MAKE) clean + cd py3 && $(MAKE) clean diff --git a/Examples/python/import_packages/relativeimport1/README b/Examples/python/import_packages/relativeimport1/README new file mode 100644 index 0000000..a99ef24 --- /dev/null +++ b/Examples/python/import_packages/relativeimport1/README @@ -0,0 +1,22 @@ +This example tests the %import directive and -relativeimport swig option. + +Use 'python runme.py' to run a test. + +Overview: +--------- + +The example defines 2 different extension modules--each wrapping a separate C++ +class. + + pyX/pkg2/pkg3/foo.i - Pkg3_Foo class + pyX/pkg2/bar.i - Pkg2_Bar class derived from Pkg3_Foo + +The code is processed by swig with -relativeimport flag. The runtime test +imports pyX.pkg2.bar module. + +If everything works well, the module pyX.pkg2.bar shall load properly. + +Unix: +----- +- Run make +- Run the test as described above diff --git a/Examples/python/import_packages/relativeimport1/py2/Makefile b/Examples/python/import_packages/relativeimport1/py2/Makefile new file mode 100644 index 0000000..6296251 --- /dev/null +++ b/Examples/python/import_packages/relativeimport1/py2/Makefile @@ -0,0 +1,13 @@ +TOP = ../../../.. +SWIGOPT = +LIBS = + +build: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg2 && $(MAKE) clean diff --git a/Examples/python/import_packages/relativeimport1/py2/__init__.py b/Examples/python/import_packages/relativeimport1/py2/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport1/py2/pkg2/Makefile b/Examples/python/import_packages/relativeimport1/py2/pkg2/Makefile new file mode 100644 index 0000000..c1f234e --- /dev/null +++ b/Examples/python/import_packages/relativeimport1/py2/pkg2/Makefile @@ -0,0 +1,21 @@ +TOP = ../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='bar' python_clean + cd pkg3 && $(MAKE) clean diff --git a/Examples/python/import_packages/relativeimport1/py2/pkg2/__init__.py b/Examples/python/import_packages/relativeimport1/py2/pkg2/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport1/py2/pkg2/bar.hpp b/Examples/python/import_packages/relativeimport1/py2/pkg2/bar.hpp new file mode 100644 index 0000000..8f09cd5 --- /dev/null +++ b/Examples/python/import_packages/relativeimport1/py2/pkg2/bar.hpp @@ -0,0 +1,5 @@ +#ifndef PY2_PKG2_BAR_HPP +#define PY2_PKG2_BAR_HPP +#include "../../py2/pkg2/pkg3/foo.hpp" +struct Pkg2_Bar : Pkg3_Foo {}; +#endif /* PY2_PKG2_BAR_HPP */ diff --git a/Examples/python/import_packages/relativeimport1/py2/pkg2/bar.i b/Examples/python/import_packages/relativeimport1/py2/pkg2/bar.i new file mode 100644 index 0000000..28a4c90 --- /dev/null +++ b/Examples/python/import_packages/relativeimport1/py2/pkg2/bar.i @@ -0,0 +1,6 @@ +%module(package="py2.pkg2") bar +%{ +#include "../../py2/pkg2/bar.hpp" +%} +%import "../../py2/pkg2/pkg3/foo.i" +%include "../../py2/pkg2/bar.hpp" diff --git a/Examples/python/import_packages/relativeimport1/py2/pkg2/pkg3/Makefile b/Examples/python/import_packages/relativeimport1/py2/pkg2/pkg3/Makefile new file mode 100644 index 0000000..7a0cb18 --- /dev/null +++ b/Examples/python/import_packages/relativeimport1/py2/pkg2/pkg3/Makefile @@ -0,0 +1,18 @@ +TOP = ../../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean diff --git a/Examples/python/import_packages/relativeimport1/py2/pkg2/pkg3/__init__.py b/Examples/python/import_packages/relativeimport1/py2/pkg2/pkg3/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport1/py2/pkg2/pkg3/foo.hpp b/Examples/python/import_packages/relativeimport1/py2/pkg2/pkg3/foo.hpp new file mode 100644 index 0000000..b6c89a4 --- /dev/null +++ b/Examples/python/import_packages/relativeimport1/py2/pkg2/pkg3/foo.hpp @@ -0,0 +1,4 @@ +#ifndef PY2_PKG2_PKG3_FOO_HPP +#define PY2_PKG2_PKG3_FOO_HPP +struct Pkg3_Foo {}; +#endif /* PY2_PKG2_PKG3_FOO_HPP */ diff --git a/Examples/python/import_packages/relativeimport1/py2/pkg2/pkg3/foo.i b/Examples/python/import_packages/relativeimport1/py2/pkg2/pkg3/foo.i new file mode 100644 index 0000000..ba32483 --- /dev/null +++ b/Examples/python/import_packages/relativeimport1/py2/pkg2/pkg3/foo.i @@ -0,0 +1,5 @@ +%module(package="py2.pkg2.pkg3") foo +%{ +#include "../../../py2/pkg2/pkg3/foo.hpp" +%} +%include "../../../py2/pkg2/pkg3/foo.hpp" diff --git a/Examples/python/import_packages/relativeimport1/py3/Makefile b/Examples/python/import_packages/relativeimport1/py3/Makefile new file mode 100644 index 0000000..6296251 --- /dev/null +++ b/Examples/python/import_packages/relativeimport1/py3/Makefile @@ -0,0 +1,13 @@ +TOP = ../../../.. +SWIGOPT = +LIBS = + +build: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg2 && $(MAKE) clean diff --git a/Examples/python/import_packages/relativeimport1/py3/__init__.py b/Examples/python/import_packages/relativeimport1/py3/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport1/py3/pkg2/Makefile b/Examples/python/import_packages/relativeimport1/py3/pkg2/Makefile new file mode 100644 index 0000000..c1f234e --- /dev/null +++ b/Examples/python/import_packages/relativeimport1/py3/pkg2/Makefile @@ -0,0 +1,21 @@ +TOP = ../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='bar' python_clean + cd pkg3 && $(MAKE) clean diff --git a/Examples/python/import_packages/relativeimport1/py3/pkg2/__init__.py b/Examples/python/import_packages/relativeimport1/py3/pkg2/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport1/py3/pkg2/bar.hpp b/Examples/python/import_packages/relativeimport1/py3/pkg2/bar.hpp new file mode 100644 index 0000000..408d910 --- /dev/null +++ b/Examples/python/import_packages/relativeimport1/py3/pkg2/bar.hpp @@ -0,0 +1,5 @@ +#ifndef PY3_PKG2_BAR_HPP +#define PY3_PKG2_BAR_HPP +#include "../../py3/pkg2/pkg3/foo.hpp" +struct Pkg2_Bar : Pkg3_Foo {}; +#endif /* PY3_PKG2_BAR_HPP */ diff --git a/Examples/python/import_packages/relativeimport1/py3/pkg2/bar.i b/Examples/python/import_packages/relativeimport1/py3/pkg2/bar.i new file mode 100644 index 0000000..1468932 --- /dev/null +++ b/Examples/python/import_packages/relativeimport1/py3/pkg2/bar.i @@ -0,0 +1,6 @@ +%module(package="py3.pkg2") bar +%{ +#include "../../py3/pkg2/bar.hpp" +%} +%import "../../py3/pkg2/pkg3/foo.i" +%include "../../py3/pkg2/bar.hpp" diff --git a/Examples/python/import_packages/relativeimport1/py3/pkg2/pkg3/Makefile b/Examples/python/import_packages/relativeimport1/py3/pkg2/pkg3/Makefile new file mode 100644 index 0000000..7a0cb18 --- /dev/null +++ b/Examples/python/import_packages/relativeimport1/py3/pkg2/pkg3/Makefile @@ -0,0 +1,18 @@ +TOP = ../../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean diff --git a/Examples/python/import_packages/relativeimport1/py3/pkg2/pkg3/__init__.py b/Examples/python/import_packages/relativeimport1/py3/pkg2/pkg3/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport1/py3/pkg2/pkg3/foo.hpp b/Examples/python/import_packages/relativeimport1/py3/pkg2/pkg3/foo.hpp new file mode 100644 index 0000000..531721d --- /dev/null +++ b/Examples/python/import_packages/relativeimport1/py3/pkg2/pkg3/foo.hpp @@ -0,0 +1,4 @@ +#ifndef PY3_PKG2_PKG3_FOO_HPP +#define PY3_PKG2_PKG3_FOO_HPP +struct Pkg3_Foo {}; +#endif /* PY3_PKG2_PKG3_FOO_HPP */ diff --git a/Examples/python/import_packages/relativeimport1/py3/pkg2/pkg3/foo.i b/Examples/python/import_packages/relativeimport1/py3/pkg2/pkg3/foo.i new file mode 100644 index 0000000..c6ba529 --- /dev/null +++ b/Examples/python/import_packages/relativeimport1/py3/pkg2/pkg3/foo.i @@ -0,0 +1,5 @@ +%module(package="py3.pkg2.pkg3") foo +%{ +#include "../../../py3/pkg2/pkg3/foo.hpp" +%} +%include "../../../py3/pkg2/pkg3/foo.hpp" diff --git a/Examples/python/import_packages/relativeimport1/runme.py b/Examples/python/import_packages/relativeimport1/runme.py new file mode 100644 index 0000000..997476b --- /dev/null +++ b/Examples/python/import_packages/relativeimport1/runme.py @@ -0,0 +1,13 @@ +import sys +import os.path + +# Test import of modules content from within __init__.py +testname = os.path.basename(os.path.dirname(os.path.abspath(__file__))) +print "Testing " + testname + " - %module(package=...) with -relativeimport" + +if sys.version_info < (3, 0): + import py2.pkg2.bar + print " Finished importing py2.pkg2.bar" +else: + import py3.pkg2.bar + print " Finished importing py3.pkg2.bar" diff --git a/Examples/python/import_packages/relativeimport2/Makefile b/Examples/python/import_packages/relativeimport2/Makefile new file mode 100644 index 0000000..90c92ab --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/Makefile @@ -0,0 +1,22 @@ +TOP = ../../.. +LIBS = + +ifeq (,$(PY3)) + PKG1DIR = "py2" +else + PKG1DIR = "py3" +endif + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run + +build: + cd $(PKG1DIR) && $(MAKE) SWIGOPT='$(SWIGOPT) -relativeimport' LIBS='$(LIBS)' build + +static: + cd $(PKG1DIR) && $(MAKE) SWIGOPT='$(SWIGOPT) -relativeimport' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd py2 && $(MAKE) clean + cd py3 && $(MAKE) clean diff --git a/Examples/python/import_packages/relativeimport2/README b/Examples/python/import_packages/relativeimport2/README new file mode 100644 index 0000000..af2d284 --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/README @@ -0,0 +1,22 @@ +This example tests the %import directive and -relativeimport option. + +Use 'python runme.py' to run a test. + +Overview: +--------- + +The example defines 2 different extension modules--each wrapping a separate C++ +class. + + pyX/pkg2/pkg3/pkg4/foo.i - Pkg4_Foo class + pyX/pkg2/bar.i - Pkg2_Bar class derived from Pkg4_Foo + +The difference between this ('relativeimport2') case and the case +'relativeimport1' is the "distance" between importer and importee. + +If everything works well, the package pyX.pkg2 shall load properly. + +Unix: +----- +- Run make +- Run the test as described above diff --git a/Examples/python/import_packages/relativeimport2/py2/Makefile b/Examples/python/import_packages/relativeimport2/py2/Makefile new file mode 100644 index 0000000..6296251 --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/py2/Makefile @@ -0,0 +1,13 @@ +TOP = ../../../.. +SWIGOPT = +LIBS = + +build: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg2 && $(MAKE) clean diff --git a/Examples/python/import_packages/relativeimport2/py2/__init__.py b/Examples/python/import_packages/relativeimport2/py2/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport2/py2/pkg2/Makefile b/Examples/python/import_packages/relativeimport2/py2/pkg2/Makefile new file mode 100644 index 0000000..c1f234e --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/py2/pkg2/Makefile @@ -0,0 +1,21 @@ +TOP = ../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='bar' python_clean + cd pkg3 && $(MAKE) clean diff --git a/Examples/python/import_packages/relativeimport2/py2/pkg2/__init__.py b/Examples/python/import_packages/relativeimport2/py2/pkg2/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport2/py2/pkg2/bar.hpp b/Examples/python/import_packages/relativeimport2/py2/pkg2/bar.hpp new file mode 100644 index 0000000..20a0019 --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/py2/pkg2/bar.hpp @@ -0,0 +1,5 @@ +#ifndef PY2_PKG2_HPP +#define PY2_PKG2_HPP +#include "../../py2/pkg2/pkg3/pkg4/foo.hpp" +struct Pkg2_Bar : Pkg4_Foo {}; +#endif /* PY2_PKG2_HPP */ diff --git a/Examples/python/import_packages/relativeimport2/py2/pkg2/bar.i b/Examples/python/import_packages/relativeimport2/py2/pkg2/bar.i new file mode 100644 index 0000000..0a932a2 --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/py2/pkg2/bar.i @@ -0,0 +1,6 @@ +%module(package="py2.pkg2") bar +%{ +#include "../../py2/pkg2/bar.hpp" +%} +%import "../../py2/pkg2/pkg3/pkg4/foo.i" +%include "../../py2/pkg2/bar.hpp" diff --git a/Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/Makefile b/Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/Makefile new file mode 100644 index 0000000..6f193fa --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/Makefile @@ -0,0 +1,13 @@ +TOP = ../../../../../.. +SWIGOPT = +LIBS = + +build: + cd pkg4 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg4 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg4 && $(MAKE) clean diff --git a/Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/__init__.py b/Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/pkg4/Makefile b/Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/pkg4/Makefile new file mode 100644 index 0000000..a870607 --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/pkg4/Makefile @@ -0,0 +1,18 @@ +TOP = ../../../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean diff --git a/Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/pkg4/__init__.py b/Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/pkg4/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/pkg4/foo.hpp b/Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/pkg4/foo.hpp new file mode 100644 index 0000000..2df933c --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/pkg4/foo.hpp @@ -0,0 +1,4 @@ +#ifndef PY2_PKG2_PKG3_PKG4 +#define PY2_PKG2_PKG3_PKG4 +struct Pkg4_Foo {}; +#endif /* PY2_PKG2_PKG3_PKG4 */ diff --git a/Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/pkg4/foo.i b/Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/pkg4/foo.i new file mode 100644 index 0000000..311d716 --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/py2/pkg2/pkg3/pkg4/foo.i @@ -0,0 +1,5 @@ +%module(package="py2.pkg2.pkg3.pkg4") foo +%{ +#include "../../../../py2/pkg2/pkg3/pkg4/foo.hpp" +%} +%include "../../../../py2/pkg2/pkg3/pkg4/foo.hpp" diff --git a/Examples/python/import_packages/relativeimport2/py3/Makefile b/Examples/python/import_packages/relativeimport2/py3/Makefile new file mode 100644 index 0000000..6296251 --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/py3/Makefile @@ -0,0 +1,13 @@ +TOP = ../../../.. +SWIGOPT = +LIBS = + +build: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg2 && $(MAKE) clean diff --git a/Examples/python/import_packages/relativeimport2/py3/__init__.py b/Examples/python/import_packages/relativeimport2/py3/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport2/py3/pkg2/Makefile b/Examples/python/import_packages/relativeimport2/py3/pkg2/Makefile new file mode 100644 index 0000000..c1f234e --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/py3/pkg2/Makefile @@ -0,0 +1,21 @@ +TOP = ../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='bar' python_clean + cd pkg3 && $(MAKE) clean diff --git a/Examples/python/import_packages/relativeimport2/py3/pkg2/__init__.py b/Examples/python/import_packages/relativeimport2/py3/pkg2/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport2/py3/pkg2/bar.hpp b/Examples/python/import_packages/relativeimport2/py3/pkg2/bar.hpp new file mode 100644 index 0000000..16fdd36 --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/py3/pkg2/bar.hpp @@ -0,0 +1,5 @@ +#ifndef PY3_PKG2_HPP +#define PY3_PKG2_HPP +#include "../../py3/pkg2/pkg3/pkg4/foo.hpp" +struct Pkg2_Bar : Pkg4_Foo {}; +#endif /* PY3_PKG2_HPP */ diff --git a/Examples/python/import_packages/relativeimport2/py3/pkg2/bar.i b/Examples/python/import_packages/relativeimport2/py3/pkg2/bar.i new file mode 100644 index 0000000..3abbb05 --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/py3/pkg2/bar.i @@ -0,0 +1,6 @@ +%module(package="py3.pkg2") bar +%{ +#include "../../py3/pkg2/bar.hpp" +%} +%import "../../py3/pkg2/pkg3/pkg4/foo.i" +%include "../../py3/pkg2/bar.hpp" diff --git a/Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/Makefile b/Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/Makefile new file mode 100644 index 0000000..6f193fa --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/Makefile @@ -0,0 +1,13 @@ +TOP = ../../../../../.. +SWIGOPT = +LIBS = + +build: + cd pkg4 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg4 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg4 && $(MAKE) clean diff --git a/Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/__init__.py b/Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/pkg4/Makefile b/Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/pkg4/Makefile new file mode 100644 index 0000000..a870607 --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/pkg4/Makefile @@ -0,0 +1,18 @@ +TOP = ../../../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean diff --git a/Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/pkg4/__init__.py b/Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/pkg4/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/pkg4/foo.hpp b/Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/pkg4/foo.hpp new file mode 100644 index 0000000..e24654c --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/pkg4/foo.hpp @@ -0,0 +1,4 @@ +#ifndef PY3_PKG2_PKG3_PKG4 +#define PY3_PKG2_PKG3_PKG4 +struct Pkg4_Foo {}; +#endif /* PY3_PKG2_PKG3_PKG4 */ diff --git a/Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/pkg4/foo.i b/Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/pkg4/foo.i new file mode 100644 index 0000000..36c5f01 --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/py3/pkg2/pkg3/pkg4/foo.i @@ -0,0 +1,5 @@ +%module(package="py3.pkg2.pkg3.pkg4") foo +%{ +#include "../../../../py3/pkg2/pkg3/pkg4/foo.hpp" +%} +%include "../../../../py3/pkg2/pkg3/pkg4/foo.hpp" diff --git a/Examples/python/import_packages/relativeimport2/runme.py b/Examples/python/import_packages/relativeimport2/runme.py new file mode 100644 index 0000000..9789afc --- /dev/null +++ b/Examples/python/import_packages/relativeimport2/runme.py @@ -0,0 +1,13 @@ +import sys +import os.path + +# Test import of modules content from within __init__.py +testname = os.path.basename(os.path.dirname(os.path.abspath(__file__))) +print "Testing " + testname + " - %module(package=...) + python 'import' in __init__.py" + +if sys.version_info < (3, 0): + import py2.pkg2.bar + print " Finished importing py2.pkg2.bar" +else: + import py3.pkg2.bar + print " Finished importing py3.pkg2.bar" diff --git a/Examples/python/import_packages/relativeimport3/Makefile b/Examples/python/import_packages/relativeimport3/Makefile new file mode 100644 index 0000000..90c92ab --- /dev/null +++ b/Examples/python/import_packages/relativeimport3/Makefile @@ -0,0 +1,22 @@ +TOP = ../../.. +LIBS = + +ifeq (,$(PY3)) + PKG1DIR = "py2" +else + PKG1DIR = "py3" +endif + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run + +build: + cd $(PKG1DIR) && $(MAKE) SWIGOPT='$(SWIGOPT) -relativeimport' LIBS='$(LIBS)' build + +static: + cd $(PKG1DIR) && $(MAKE) SWIGOPT='$(SWIGOPT) -relativeimport' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd py2 && $(MAKE) clean + cd py3 && $(MAKE) clean diff --git a/Examples/python/import_packages/relativeimport3/README b/Examples/python/import_packages/relativeimport3/README new file mode 100644 index 0000000..a99ef24 --- /dev/null +++ b/Examples/python/import_packages/relativeimport3/README @@ -0,0 +1,22 @@ +This example tests the %import directive and -relativeimport swig option. + +Use 'python runme.py' to run a test. + +Overview: +--------- + +The example defines 2 different extension modules--each wrapping a separate C++ +class. + + pyX/pkg2/pkg3/foo.i - Pkg3_Foo class + pyX/pkg2/bar.i - Pkg2_Bar class derived from Pkg3_Foo + +The code is processed by swig with -relativeimport flag. The runtime test +imports pyX.pkg2.bar module. + +If everything works well, the module pyX.pkg2.bar shall load properly. + +Unix: +----- +- Run make +- Run the test as described above diff --git a/Examples/python/import_packages/relativeimport3/py2/Makefile b/Examples/python/import_packages/relativeimport3/py2/Makefile new file mode 100644 index 0000000..6296251 --- /dev/null +++ b/Examples/python/import_packages/relativeimport3/py2/Makefile @@ -0,0 +1,13 @@ +TOP = ../../../.. +SWIGOPT = +LIBS = + +build: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg2 && $(MAKE) clean diff --git a/Examples/python/import_packages/relativeimport3/py2/__init__.py b/Examples/python/import_packages/relativeimport3/py2/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport3/py2/pkg2/Makefile b/Examples/python/import_packages/relativeimport3/py2/pkg2/Makefile new file mode 100644 index 0000000..c1f234e --- /dev/null +++ b/Examples/python/import_packages/relativeimport3/py2/pkg2/Makefile @@ -0,0 +1,21 @@ +TOP = ../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='bar' python_clean + cd pkg3 && $(MAKE) clean diff --git a/Examples/python/import_packages/relativeimport3/py2/pkg2/__init__.py b/Examples/python/import_packages/relativeimport3/py2/pkg2/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport3/py2/pkg2/bar.hpp b/Examples/python/import_packages/relativeimport3/py2/pkg2/bar.hpp new file mode 100644 index 0000000..8f09cd5 --- /dev/null +++ b/Examples/python/import_packages/relativeimport3/py2/pkg2/bar.hpp @@ -0,0 +1,5 @@ +#ifndef PY2_PKG2_BAR_HPP +#define PY2_PKG2_BAR_HPP +#include "../../py2/pkg2/pkg3/foo.hpp" +struct Pkg2_Bar : Pkg3_Foo {}; +#endif /* PY2_PKG2_BAR_HPP */ diff --git a/Examples/python/import_packages/relativeimport3/py2/pkg2/bar.i b/Examples/python/import_packages/relativeimport3/py2/pkg2/bar.i new file mode 100644 index 0000000..6f4690b --- /dev/null +++ b/Examples/python/import_packages/relativeimport3/py2/pkg2/bar.i @@ -0,0 +1,6 @@ +%module(package="py2.pkg2") bar +%{ +#include "../../py2/pkg2/bar.hpp" +%} +%import (module="foo", package="py2.pkg2.pkg3") "../../py2/pkg2/pkg3/foo.hpp" +%include "../../py2/pkg2/bar.hpp" diff --git a/Examples/python/import_packages/relativeimport3/py2/pkg2/pkg3/Makefile b/Examples/python/import_packages/relativeimport3/py2/pkg2/pkg3/Makefile new file mode 100644 index 0000000..7a0cb18 --- /dev/null +++ b/Examples/python/import_packages/relativeimport3/py2/pkg2/pkg3/Makefile @@ -0,0 +1,18 @@ +TOP = ../../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean diff --git a/Examples/python/import_packages/relativeimport3/py2/pkg2/pkg3/__init__.py b/Examples/python/import_packages/relativeimport3/py2/pkg2/pkg3/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport3/py2/pkg2/pkg3/foo.hpp b/Examples/python/import_packages/relativeimport3/py2/pkg2/pkg3/foo.hpp new file mode 100644 index 0000000..b6c89a4 --- /dev/null +++ b/Examples/python/import_packages/relativeimport3/py2/pkg2/pkg3/foo.hpp @@ -0,0 +1,4 @@ +#ifndef PY2_PKG2_PKG3_FOO_HPP +#define PY2_PKG2_PKG3_FOO_HPP +struct Pkg3_Foo {}; +#endif /* PY2_PKG2_PKG3_FOO_HPP */ diff --git a/Examples/python/import_packages/relativeimport3/py2/pkg2/pkg3/foo.i b/Examples/python/import_packages/relativeimport3/py2/pkg2/pkg3/foo.i new file mode 100644 index 0000000..ba32483 --- /dev/null +++ b/Examples/python/import_packages/relativeimport3/py2/pkg2/pkg3/foo.i @@ -0,0 +1,5 @@ +%module(package="py2.pkg2.pkg3") foo +%{ +#include "../../../py2/pkg2/pkg3/foo.hpp" +%} +%include "../../../py2/pkg2/pkg3/foo.hpp" diff --git a/Examples/python/import_packages/relativeimport3/py3/Makefile b/Examples/python/import_packages/relativeimport3/py3/Makefile new file mode 100644 index 0000000..6296251 --- /dev/null +++ b/Examples/python/import_packages/relativeimport3/py3/Makefile @@ -0,0 +1,13 @@ +TOP = ../../../.. +SWIGOPT = +LIBS = + +build: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg2 && $(MAKE) clean diff --git a/Examples/python/import_packages/relativeimport3/py3/__init__.py b/Examples/python/import_packages/relativeimport3/py3/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport3/py3/pkg2/Makefile b/Examples/python/import_packages/relativeimport3/py3/pkg2/Makefile new file mode 100644 index 0000000..c1f234e --- /dev/null +++ b/Examples/python/import_packages/relativeimport3/py3/pkg2/Makefile @@ -0,0 +1,21 @@ +TOP = ../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + cd pkg3 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='bar' python_clean + cd pkg3 && $(MAKE) clean diff --git a/Examples/python/import_packages/relativeimport3/py3/pkg2/__init__.py b/Examples/python/import_packages/relativeimport3/py3/pkg2/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport3/py3/pkg2/bar.hpp b/Examples/python/import_packages/relativeimport3/py3/pkg2/bar.hpp new file mode 100644 index 0000000..408d910 --- /dev/null +++ b/Examples/python/import_packages/relativeimport3/py3/pkg2/bar.hpp @@ -0,0 +1,5 @@ +#ifndef PY3_PKG2_BAR_HPP +#define PY3_PKG2_BAR_HPP +#include "../../py3/pkg2/pkg3/foo.hpp" +struct Pkg2_Bar : Pkg3_Foo {}; +#endif /* PY3_PKG2_BAR_HPP */ diff --git a/Examples/python/import_packages/relativeimport3/py3/pkg2/bar.i b/Examples/python/import_packages/relativeimport3/py3/pkg2/bar.i new file mode 100644 index 0000000..157c62e --- /dev/null +++ b/Examples/python/import_packages/relativeimport3/py3/pkg2/bar.i @@ -0,0 +1,6 @@ +%module(package="py3.pkg2") bar +%{ +#include "../../py3/pkg2/bar.hpp" +%} +%import (module="foo", package="py3.pkg2.pkg3") "../../py3/pkg2/pkg3/foo.hpp" +%include "../../py3/pkg2/bar.hpp" diff --git a/Examples/python/import_packages/relativeimport3/py3/pkg2/pkg3/Makefile b/Examples/python/import_packages/relativeimport3/py3/pkg2/pkg3/Makefile new file mode 100644 index 0000000..7a0cb18 --- /dev/null +++ b/Examples/python/import_packages/relativeimport3/py3/pkg2/pkg3/Makefile @@ -0,0 +1,18 @@ +TOP = ../../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean diff --git a/Examples/python/import_packages/relativeimport3/py3/pkg2/pkg3/__init__.py b/Examples/python/import_packages/relativeimport3/py3/pkg2/pkg3/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/relativeimport3/py3/pkg2/pkg3/foo.hpp b/Examples/python/import_packages/relativeimport3/py3/pkg2/pkg3/foo.hpp new file mode 100644 index 0000000..531721d --- /dev/null +++ b/Examples/python/import_packages/relativeimport3/py3/pkg2/pkg3/foo.hpp @@ -0,0 +1,4 @@ +#ifndef PY3_PKG2_PKG3_FOO_HPP +#define PY3_PKG2_PKG3_FOO_HPP +struct Pkg3_Foo {}; +#endif /* PY3_PKG2_PKG3_FOO_HPP */ diff --git a/Examples/python/import_packages/relativeimport3/py3/pkg2/pkg3/foo.i b/Examples/python/import_packages/relativeimport3/py3/pkg2/pkg3/foo.i new file mode 100644 index 0000000..c6ba529 --- /dev/null +++ b/Examples/python/import_packages/relativeimport3/py3/pkg2/pkg3/foo.i @@ -0,0 +1,5 @@ +%module(package="py3.pkg2.pkg3") foo +%{ +#include "../../../py3/pkg2/pkg3/foo.hpp" +%} +%include "../../../py3/pkg2/pkg3/foo.hpp" diff --git a/Examples/python/import_packages/relativeimport3/runme.py b/Examples/python/import_packages/relativeimport3/runme.py new file mode 100644 index 0000000..997476b --- /dev/null +++ b/Examples/python/import_packages/relativeimport3/runme.py @@ -0,0 +1,13 @@ +import sys +import os.path + +# Test import of modules content from within __init__.py +testname = os.path.basename(os.path.dirname(os.path.abspath(__file__))) +print "Testing " + testname + " - %module(package=...) with -relativeimport" + +if sys.version_info < (3, 0): + import py2.pkg2.bar + print " Finished importing py2.pkg2.bar" +else: + import py3.pkg2.bar + print " Finished importing py3.pkg2.bar" diff --git a/Examples/python/import_packages/same_modnames1/Makefile b/Examples/python/import_packages/same_modnames1/Makefile new file mode 100644 index 0000000..57148c6 --- /dev/null +++ b/Examples/python/import_packages/same_modnames1/Makefile @@ -0,0 +1,18 @@ +TOP = ../../.. +LIBS = + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run + +build: + cd pkg1 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg1 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + cd pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg1 && $(MAKE) clean + cd pkg2 && $(MAKE) clean diff --git a/Examples/python/import_packages/same_modnames1/README b/Examples/python/import_packages/same_modnames1/README new file mode 100644 index 0000000..ee3f8d6 --- /dev/null +++ b/Examples/python/import_packages/same_modnames1/README @@ -0,0 +1,26 @@ +This example tests the %import directive and working with multiple modules. + +There are two modules having same name but belonging to different packages. +This case is not correctly handled by swig 2. + +The issue was reported as Source Forge bug #1297 and later as GitHub issue #7. + +Use 'python runme.py' to run a test. + +Overview: +--------- + +The example defines 2 different extension modules--each wrapping a separate C++ +class. + + pkg1/foo.i - Pkg1_Foo class. + pkg2/foo.i - Pkg2_Foo class (derived from Pkg1_Foo). + +The pkg2/foo.i module uses %import to refer to pkg1/foo.i. + +If everything works well, the module pkg2.foo shall load properly. + +Unix: +----- +- Run make +- Run the test as described above. diff --git a/Examples/python/import_packages/same_modnames1/pkg1/Makefile b/Examples/python/import_packages/same_modnames1/pkg1/Makefile new file mode 100644 index 0000000..3ca7fab --- /dev/null +++ b/Examples/python/import_packages/same_modnames1/pkg1/Makefile @@ -0,0 +1,18 @@ +TOP = ../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean diff --git a/Examples/python/import_packages/same_modnames1/pkg1/__init__.py b/Examples/python/import_packages/same_modnames1/pkg1/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/same_modnames1/pkg1/foo.hpp b/Examples/python/import_packages/same_modnames1/pkg1/foo.hpp new file mode 100644 index 0000000..b07c983 --- /dev/null +++ b/Examples/python/import_packages/same_modnames1/pkg1/foo.hpp @@ -0,0 +1,4 @@ +#ifndef PKG1_FOO_HPP +#define PKG1_FOO_HPP +struct Pkg1_Foo{}; +#endif /* PKG1_FOO_HPP */ diff --git a/Examples/python/import_packages/same_modnames1/pkg1/foo.i b/Examples/python/import_packages/same_modnames1/pkg1/foo.i new file mode 100644 index 0000000..9939f42 --- /dev/null +++ b/Examples/python/import_packages/same_modnames1/pkg1/foo.i @@ -0,0 +1,5 @@ +%module(package="pkg1") foo +%{ +#include "../pkg1/foo.hpp" +%} +%include "../pkg1/foo.hpp" diff --git a/Examples/python/import_packages/same_modnames1/pkg2/Makefile b/Examples/python/import_packages/same_modnames1/pkg2/Makefile new file mode 100644 index 0000000..3ca7fab --- /dev/null +++ b/Examples/python/import_packages/same_modnames1/pkg2/Makefile @@ -0,0 +1,18 @@ +TOP = ../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean diff --git a/Examples/python/import_packages/same_modnames1/pkg2/__init__.py b/Examples/python/import_packages/same_modnames1/pkg2/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/same_modnames1/pkg2/foo.hpp b/Examples/python/import_packages/same_modnames1/pkg2/foo.hpp new file mode 100644 index 0000000..72563a9 --- /dev/null +++ b/Examples/python/import_packages/same_modnames1/pkg2/foo.hpp @@ -0,0 +1,5 @@ +#ifndef PKG2_FOO_HPP +#define PKG2_FOO_HPP +#include "../pkg1/foo.hpp" +struct Pkg2_Foo : public Pkg1_Foo{}; +#endif /* PKG2_FOO_HPP */ diff --git a/Examples/python/import_packages/same_modnames1/pkg2/foo.i b/Examples/python/import_packages/same_modnames1/pkg2/foo.i new file mode 100644 index 0000000..3a1ce01 --- /dev/null +++ b/Examples/python/import_packages/same_modnames1/pkg2/foo.i @@ -0,0 +1,6 @@ +%module(package="pkg2") foo +%{ +#include "../pkg2/foo.hpp" +%} +%import "../pkg1/foo.i" +%include "../pkg2/foo.hpp" diff --git a/Examples/python/import_packages/same_modnames1/runme.py b/Examples/python/import_packages/same_modnames1/runme.py new file mode 100644 index 0000000..3c3c00c --- /dev/null +++ b/Examples/python/import_packages/same_modnames1/runme.py @@ -0,0 +1,19 @@ +import os.path + +# Test import of same modules from different packages +testname = os.path.basename(os.path.dirname(os.path.abspath(__file__))) +print "Testing " + testname + " - %module(package=...) + python 'import' in __init__.py" + +import pkg2.foo +print " Finished importing pkg2.foo" + +var2 = pkg2.foo.Pkg2_Foo() + +classname = str(type(var2)) +# Check for an old-style class if swig was run in -classic mode +if classname == "": + classname = str(var2.__class__) + +if classname.find("pkg2.foo.Pkg2_Foo") == -1: + raise RuntimeError("failed type checking: " + classname) +print " Successfully created object pkg2.foo.Pkg2_Foo" diff --git a/Examples/python/import_packages/same_modnames2/Makefile b/Examples/python/import_packages/same_modnames2/Makefile new file mode 100644 index 0000000..cf6db0c --- /dev/null +++ b/Examples/python/import_packages/same_modnames2/Makefile @@ -0,0 +1,18 @@ +TOP = ../../.. +LIBS = + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run + +build: + cd pkg1 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + cd pkg1/pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build + +static: + cd pkg1 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + cd pkg1/pkg2 && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + cd pkg1 && $(MAKE) clean + cd pkg1/pkg2 && $(MAKE) clean diff --git a/Examples/python/import_packages/same_modnames2/README b/Examples/python/import_packages/same_modnames2/README new file mode 100644 index 0000000..9b0233f --- /dev/null +++ b/Examples/python/import_packages/same_modnames2/README @@ -0,0 +1,26 @@ +This example tests the %import directive and working with multiple modules. + +There are two modules having same name but belonging to different packages. +This case is not correctly handled by swig 2. + +The issue was reported as Source Forge bug #1297 and later as GitHub issue #7. + +Use 'python runme.py' to run a test. + +Overview: +--------- + +The example defines 2 different extension modules--each wrapping a separate C++ +class. + + pkg1/foo.i - Pkg1_Foo class + pkg1/pkg2/foo.i - Pkg2_Foo class derived from Pkg1_Foo + +The pkg1/pkg2/foo module uses %import to refer to pkg1/foo. + +If everything works well, the module pkg1.pkg2.foo shall load properly. + +Unix: +----- +- Run make +- Run the test as described above diff --git a/Examples/python/import_packages/same_modnames2/pkg1/Makefile b/Examples/python/import_packages/same_modnames2/pkg1/Makefile new file mode 100644 index 0000000..3ca7fab --- /dev/null +++ b/Examples/python/import_packages/same_modnames2/pkg1/Makefile @@ -0,0 +1,18 @@ +TOP = ../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean diff --git a/Examples/python/import_packages/same_modnames2/pkg1/__init__.py b/Examples/python/import_packages/same_modnames2/pkg1/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/same_modnames2/pkg1/foo.hpp b/Examples/python/import_packages/same_modnames2/pkg1/foo.hpp new file mode 100644 index 0000000..b07c983 --- /dev/null +++ b/Examples/python/import_packages/same_modnames2/pkg1/foo.hpp @@ -0,0 +1,4 @@ +#ifndef PKG1_FOO_HPP +#define PKG1_FOO_HPP +struct Pkg1_Foo{}; +#endif /* PKG1_FOO_HPP */ diff --git a/Examples/python/import_packages/same_modnames2/pkg1/foo.i b/Examples/python/import_packages/same_modnames2/pkg1/foo.i new file mode 100644 index 0000000..9939f42 --- /dev/null +++ b/Examples/python/import_packages/same_modnames2/pkg1/foo.i @@ -0,0 +1,5 @@ +%module(package="pkg1") foo +%{ +#include "../pkg1/foo.hpp" +%} +%include "../pkg1/foo.hpp" diff --git a/Examples/python/import_packages/same_modnames2/pkg1/pkg2/Makefile b/Examples/python/import_packages/same_modnames2/pkg1/pkg2/Makefile new file mode 100644 index 0000000..921bb99 --- /dev/null +++ b/Examples/python/import_packages/same_modnames2/pkg1/pkg2/Makefile @@ -0,0 +1,18 @@ +TOP = ../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean diff --git a/Examples/python/import_packages/same_modnames2/pkg1/pkg2/__init__.py b/Examples/python/import_packages/same_modnames2/pkg1/pkg2/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/Examples/python/import_packages/same_modnames2/pkg1/pkg2/foo.hpp b/Examples/python/import_packages/same_modnames2/pkg1/pkg2/foo.hpp new file mode 100644 index 0000000..1b4a1d5 --- /dev/null +++ b/Examples/python/import_packages/same_modnames2/pkg1/pkg2/foo.hpp @@ -0,0 +1,5 @@ +#ifndef PKG1_PKG2_FOO_HPP +#define PKG1_PKG2_FOO_HPP +#include "../../pkg1/foo.hpp" +struct Pkg2_Foo : public Pkg1_Foo{}; +#endif /* PKG1_PKG2_FOO_HPP */ diff --git a/Examples/python/import_packages/same_modnames2/pkg1/pkg2/foo.i b/Examples/python/import_packages/same_modnames2/pkg1/pkg2/foo.i new file mode 100644 index 0000000..1741b37 --- /dev/null +++ b/Examples/python/import_packages/same_modnames2/pkg1/pkg2/foo.i @@ -0,0 +1,6 @@ +%module(package="pkg1.pkg2") foo +%{ +#include "../../pkg1/pkg2/foo.hpp" +%} +%import "../../pkg1/foo.i" +%include "../../pkg1/pkg2/foo.hpp" diff --git a/Examples/python/import_packages/same_modnames2/runme.py b/Examples/python/import_packages/same_modnames2/runme.py new file mode 100644 index 0000000..38daad0 --- /dev/null +++ b/Examples/python/import_packages/same_modnames2/runme.py @@ -0,0 +1,18 @@ +import os.path + +testname = os.path.basename(os.path.dirname(os.path.abspath(__file__))) +print "Testing " + testname + " - %module(package=...) + python 'import' in __init__.py" + +import pkg1.pkg2.foo +print " Finished importing pkg1.pkg2.foo" + +var2 = pkg1.pkg2.foo.Pkg2_Foo() + +classname = str(type(var2)) +# Check for an old-style class if swig was run in -classic mode +if classname == "": + classname = str(var2.__class__) + +if classname.find("pkg1.pkg2.foo.Pkg2_Foo") == -1: + raise RuntimeError("failed type checking: " + classname) +print " Successfully created object pkg1.pkg2.foo.Pkg2_Foo" diff --git a/Examples/python/import_packages/split_modules/Makefile b/Examples/python/import_packages/split_modules/Makefile new file mode 100644 index 0000000..65d635b --- /dev/null +++ b/Examples/python/import_packages/split_modules/Makefile @@ -0,0 +1,26 @@ +TOP = ../../.. +LIBS = + +subdirs = vanilla vanilla_split + + +check: build + for s in $(subdirs); do \ + (cd $$s && $(MAKE) check); \ + done + +build: + for s in $(subdirs); do \ + (cd $$s && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' build); \ + done + +static: + for s in $(subdirs); do \ + (cd $$s && $(MAKE) SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' static); \ + done + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean + for s in $(subdirs); do \ + (cd $$s && $(MAKE) clean); \ + done diff --git a/Examples/python/import_packages/split_modules/README b/Examples/python/import_packages/split_modules/README new file mode 100644 index 0000000..0cb543e --- /dev/null +++ b/Examples/python/import_packages/split_modules/README @@ -0,0 +1,7 @@ + These examples/tests are for when the SWIG generated wrapper module is split +between two packages. Specifically the pure python part is part of a package +and the C/C++ part is not in any package at all. Historically SWIG has +supported this sort of thing. + +vanilla # "plane Jane" module both halves in pkg1 +vanilla_split # python 1/2 in pkg1 C 1/2 in global namespace diff --git a/Examples/python/import_packages/split_modules/vanilla/Makefile b/Examples/python/import_packages/split_modules/vanilla/Makefile new file mode 100644 index 0000000..b679d60 --- /dev/null +++ b/Examples/python/import_packages/split_modules/vanilla/Makefile @@ -0,0 +1,18 @@ +TOP = ../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run + +build: + cd pkg1 && $(MAKE) build + +static: + cd pkg1 && $(MAKE) static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean + cd pkg1 && $(MAKE) -f $(TOP)/../Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean diff --git a/Examples/python/import_packages/split_modules/vanilla/pkg1/Makefile b/Examples/python/import_packages/split_modules/vanilla/pkg1/Makefile new file mode 100644 index 0000000..921bb99 --- /dev/null +++ b/Examples/python/import_packages/split_modules/vanilla/pkg1/Makefile @@ -0,0 +1,18 @@ +TOP = ../../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = +LIBS = + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean diff --git a/Examples/python/import_packages/split_modules/vanilla/pkg1/__init__.py b/Examples/python/import_packages/split_modules/vanilla/pkg1/__init__.py new file mode 100644 index 0000000..7b1594c --- /dev/null +++ b/Examples/python/import_packages/split_modules/vanilla/pkg1/__init__.py @@ -0,0 +1 @@ +# killroy was here diff --git a/Examples/python/import_packages/split_modules/vanilla/pkg1/foo.i b/Examples/python/import_packages/split_modules/vanilla/pkg1/foo.i new file mode 100644 index 0000000..60ce16e --- /dev/null +++ b/Examples/python/import_packages/split_modules/vanilla/pkg1/foo.i @@ -0,0 +1,10 @@ +%module(package="pkg1") foo +%{ +static unsigned count(void) +{ + return 3; +} +%} + +unsigned count(void); + diff --git a/Examples/python/import_packages/split_modules/vanilla/runme.py b/Examples/python/import_packages/split_modules/vanilla/runme.py new file mode 100644 index 0000000..a188364 --- /dev/null +++ b/Examples/python/import_packages/split_modules/vanilla/runme.py @@ -0,0 +1,10 @@ +import os.path + +testname = os.path.basename(os.path.dirname(os.path.abspath(__file__))) +print "Testing " + testname + " - split modules" + +import pkg1.foo + +print " Finished importing pkg1.foo" + +assert(pkg1.foo.count() == 3) diff --git a/Examples/python/import_packages/split_modules/vanilla_split/Makefile b/Examples/python/import_packages/split_modules/vanilla_split/Makefile new file mode 100644 index 0000000..c322b5a --- /dev/null +++ b/Examples/python/import_packages/split_modules/vanilla_split/Makefile @@ -0,0 +1,22 @@ +TOP = ../../../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SWIGOPT = -outdir pkg1 +LIBS = + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + +static: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp_static + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean + cd pkg1 && $(MAKE) -f $(TOP)/../Makefile SRCDIR='$(SRCDIR)' TARGET='foo' python_clean diff --git a/Examples/python/import_packages/split_modules/vanilla_split/foo.i b/Examples/python/import_packages/split_modules/vanilla_split/foo.i new file mode 100644 index 0000000..60ce16e --- /dev/null +++ b/Examples/python/import_packages/split_modules/vanilla_split/foo.i @@ -0,0 +1,10 @@ +%module(package="pkg1") foo +%{ +static unsigned count(void) +{ + return 3; +} +%} + +unsigned count(void); + diff --git a/Examples/python/import_packages/split_modules/vanilla_split/pkg1/__init__.py b/Examples/python/import_packages/split_modules/vanilla_split/pkg1/__init__.py new file mode 100644 index 0000000..7b1594c --- /dev/null +++ b/Examples/python/import_packages/split_modules/vanilla_split/pkg1/__init__.py @@ -0,0 +1 @@ +# killroy was here diff --git a/Examples/python/import_packages/split_modules/vanilla_split/runme.py b/Examples/python/import_packages/split_modules/vanilla_split/runme.py new file mode 100644 index 0000000..a188364 --- /dev/null +++ b/Examples/python/import_packages/split_modules/vanilla_split/runme.py @@ -0,0 +1,10 @@ +import os.path + +testname = os.path.basename(os.path.dirname(os.path.abspath(__file__))) +print "Testing " + testname + " - split modules" + +import pkg1.foo + +print " Finished importing pkg1.foo" + +assert(pkg1.foo.count() == 3) diff --git a/Examples/python/import_template/Makefile b/Examples/python/import_template/Makefile index f63e122..ad208b3 100644 --- a/Examples/python/import_template/Makefile +++ b/Examples/python/import_template/Makefile @@ -1,22 +1,27 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SWIGOPT = LIBS = check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='base' INTERFACE='base.i' python_cpp - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='spam' INTERFACE='spam.i' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='base' INTERFACE='base.i' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='spam' INTERFACE='spam.i' python_cpp clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean rm -f foo.py bar.py spam.py base.py diff --git a/Examples/python/import_template/base.h b/Examples/python/import_template/base.h index c755a6f..8faafb3 100644 --- a/Examples/python/import_template/base.h +++ b/Examples/python/import_template/base.h @@ -2,8 +2,8 @@ template class Base { public: - Base() { }; - virtual ~Base() { }; + Base() { } + virtual ~Base() { } virtual void A() { printf("I'm Base::A\n"); } diff --git a/Examples/python/import_template/runme.py b/Examples/python/import_template/runme.py index 0d5aded..35f8924 100644 --- a/Examples/python/import_template/runme.py +++ b/Examples/python/import_template/runme.py @@ -81,31 +81,27 @@ x = d.toBase() print " Spam -> Base -> Foo : ", y = foo.intFoo_fromBase(x) if y: - print "bad swig" + print "bad swig" else: - print "good swig" + print "good swig" print " Spam -> Base -> Bar : ", y = bar.intBar_fromBase(x) if y: - print "good swig" + print "good swig" else: - print "bad swig" - + print "bad swig" + print " Spam -> Base -> Spam : ", y = spam.intSpam_fromBase(x) if y: - print "good swig" + print "good swig" else: - print "bad swig" + print "bad swig" print " Foo -> Spam : ", y = spam.intSpam_fromBase(b) if y: - print "bad swig" + print "bad swig" else: - print "good swig" - - - - + print "good swig" diff --git a/Examples/python/index.html b/Examples/python/index.html index 37f4b55..3bbdd66 100644 --- a/Examples/python/index.html +++ b/Examples/python/index.html @@ -56,8 +56,7 @@ Copyright 1991-1995 Stichting Mathematisch Centrum, Amsterdam
  • The politically "correct" way to compile a Python extension is to follow the steps -described at www.python.org -or in the most excellent (and shamelessly plugged) Python Essential Reference: +described at www.python.org:

      diff --git a/Examples/python/java/Makefile b/Examples/python/java/Makefile index 47b865d..7c75e6b 100644 --- a/Examples/python/java/Makefile +++ b/Examples/python/java/Makefile @@ -1,23 +1,25 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i LIBS = -lm check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run -build: Example.class - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ - TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' CXX="gcj" \ +build: Example.class Example.h + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ CXXSHARED="gcj -fpic -shared Example.class" DEFS='' LIBS="-lstdc++" python_cpp clean: - $(MAKE) -f $(TOP)/Makefile python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_clean rm -f $(TARGET).py rm -f *.class Example.h -Example.class: Example.java - gcj -fPIC -C -c -g Example.java - gcjh Example - +Example.class Example.h: $(SRCDIR)Example.java + gcj -d . -fPIC -C -c -g $(SRCDIR)Example.java + gcjh Example.class diff --git a/Examples/python/java/example.i b/Examples/python/java/example.i index 13d5b5e..80e0887 100644 --- a/Examples/python/java/example.i +++ b/Examples/python/java/example.i @@ -7,3 +7,7 @@ %include Example.h + +%extend Example { + ~Example() {} +} diff --git a/Examples/python/java/runme.py b/Examples/python/java/runme.py index 0cec8a7..641ba27 100644 --- a/Examples/python/java/runme.py +++ b/Examples/python/java/runme.py @@ -6,11 +6,11 @@ JvAttachCurrentThread(None, None) e1 = Example(1) e2 = Example(2) -print e1.Add(1,2) -print e1.Add(1.0,2.0) -e3 = e1.Add(e1,e2) +print e1.Add(1, 2) +print e1.Add(1.0, 2.0) +e3 = e1.Add(e1, e2) print e3.mPublicInt -print e1.Add("1","2") +print e1.Add("1", "2") JvDetachCurrentThread() diff --git a/Examples/python/libffi/Makefile b/Examples/python/libffi/Makefile index e0620f6..0875fdd 100644 --- a/Examples/python/libffi/Makefile +++ b/Examples/python/libffi/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -SRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' LIBS='-L/usr/local/lib -lffi' python static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/multimap/Makefile b/Examples/python/multimap/Makefile index df3bc86..26bfd94 100644 --- a/Examples/python/multimap/Makefile +++ b/Examples/python/multimap/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/multimap/example.i b/Examples/python/multimap/example.i index 3f6fc3d..635f61c 100644 --- a/Examples/python/multimap/example.i +++ b/Examples/python/multimap/example.i @@ -20,7 +20,7 @@ extern int gcd(int x, int y); if (!PyList_Check($input)) { SWIG_exception(SWIG_ValueError, "Expecting a list"); } - $1 = PyList_Size($input); + $1 = (int)PyList_Size($input); if ($1 == 0) { SWIG_exception(SWIG_ValueError, "List must contain at least 1 element"); } @@ -73,7 +73,7 @@ extern int gcdmain(int argc, char *argv[]); } utf8str = PyUnicode_AsUTF8String($input); PyBytes_AsStringAndSize(utf8str, &cstr, &len); - $1 = strndup(cstr, (size_t)len); + $1 = strncpy((char *)malloc(len+1), cstr, (size_t)len); $2 = (int)len; Py_DECREF(utf8str); %#else @@ -82,7 +82,7 @@ extern int gcdmain(int argc, char *argv[]); return NULL; } $1 = PyString_AsString($input); - $2 = PyString_Size($input); + $2 = (int)PyString_Size($input); %#endif } @@ -98,7 +98,7 @@ extern int count(char *bytes, int len, char c); /* This example shows how to wrap a function that mutates a string */ /* Since str is modified, we make a copy of the Python object - so that we don't violate it's mutability */ + so that we don't violate its mutability */ %typemap(in) (char *str, int len) { %#if PY_VERSION_HEX >= 0x03000000 @@ -106,11 +106,11 @@ extern int count(char *bytes, int len, char c); Py_ssize_t len; PyObject *utf8str = PyUnicode_AsUTF8String($input); PyBytes_AsStringAndSize(utf8str, &cstr, &len); - $1 = strndup(cstr, (size_t)len); + $1 = strncpy((char *)malloc(len+1), cstr, (size_t)len); $2 = (int)len; Py_DECREF(utf8str); %#else - $2 = PyString_Size($input); + $2 = (int)PyString_Size($input); $1 = (char *) malloc($2+1); memmove($1,PyString_AsString($input),$2); %#endif diff --git a/Examples/python/multimap/runme.py b/Examples/python/multimap/runme.py index f996ab3..ad693b7 100644 --- a/Examples/python/multimap/runme.py +++ b/Examples/python/multimap/runme.py @@ -1,16 +1,16 @@ # file: runme.py -import example +import example # Call our gcd() function x = 42 y = 105 -g = example.gcd(x,y) -print "The gcd of %d and %d is %d" % (x,y,g) +g = example.gcd(x, y) +print "The gcd of %d and %d is %d" % (x, y, g) # Call the gcdmain() function -example.gcdmain(["gcdmain","42","105"]) +example.gcdmain(["gcdmain", "42", "105"]) # Call the count function print example.count("Hello World", "l") @@ -18,10 +18,3 @@ print example.count("Hello World", "l") # Call the capitalize function print example.capitalize("hello world") - - - - - - - diff --git a/Examples/python/operator/Makefile b/Examples/python/operator/Makefile index 6ef1583..e5de5c5 100644 --- a/Examples/python/operator/Makefile +++ b/Examples/python/operator/Makefile @@ -1,21 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i LIBS = -lm -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/operator/runme.py b/Examples/python/operator/runme.py index 3687a38..ac48f26 100644 --- a/Examples/python/operator/runme.py +++ b/Examples/python/operator/runme.py @@ -1,21 +1,20 @@ # Operator overloading example import example -a = example.Complex(2,3) -b = example.Complex(-5,10) +a = example.Complex(2, 3) +b = example.Complex(-5, 10) -print "a =",a -print "b =",b +print "a =", a +print "b =", b c = a + b -print "c =",c -print "a*b =",a*b -print "a-c =",a-c +print "c =", c +print "a*b =", a * b +print "a-c =", a - c -e = example.ComplexCopy(a-c) -print "e =",e +e = example.ComplexCopy(a - c) +print "e =", e # Big expression -f = ((a+b)*(c+b*e)) + (-a) -print "f =",f - +f = ((a + b) * (c + b * e)) + (-a) +print "f =", f diff --git a/Examples/python/performance/constructor/Makefile b/Examples/python/performance/constructor/Makefile index 98a50ec..cbc1154 100644 --- a/Examples/python/performance/constructor/Makefile +++ b/Examples/python/performance/constructor/Makefile @@ -1,21 +1,26 @@ TOP = ../../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = TARGET = Simple INTERFACE = Simple.i build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG) -module Simple_baseline' \ - TARGET='$(TARGET)_baseline' INTERFACE='$(INTERFACE)' python_cpp - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG) -O -module Simple_optimized' \ - TARGET='$(TARGET)_optimized' INTERFACE='$(INTERFACE)' python_cpp - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG) -builtin -O -module Simple_builtin' \ - TARGET='$(TARGET)_builtin' INTERFACE='$(INTERFACE)' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='-module Simple_baseline' TARGET='$(TARGET)_baseline' INTERFACE='$(INTERFACE)' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='-O -module Simple_optimized' TARGET='$(TARGET)_optimized' INTERFACE='$(INTERFACE)' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='-builtin -O -module Simple_builtin' TARGET='$(TARGET)_builtin' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean rm -f $(TARGET)_*.py diff --git a/Examples/python/performance/constructor/runme.py b/Examples/python/performance/constructor/runme.py index 23577a1..1771fba 100644 --- a/Examples/python/performance/constructor/runme.py +++ b/Examples/python/performance/constructor/runme.py @@ -1,11 +1,10 @@ -#!/usr/bin/env - import sys sys.path.append('..') import harness -def proc (mod) : - for i in range(1000000) : + +def proc(mod): + for i in range(1000000): x = mod.MyClass() harness.run(proc) diff --git a/Examples/python/performance/func/Makefile b/Examples/python/performance/func/Makefile index 98a50ec..cbc1154 100644 --- a/Examples/python/performance/func/Makefile +++ b/Examples/python/performance/func/Makefile @@ -1,21 +1,26 @@ TOP = ../../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = TARGET = Simple INTERFACE = Simple.i build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG) -module Simple_baseline' \ - TARGET='$(TARGET)_baseline' INTERFACE='$(INTERFACE)' python_cpp - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG) -O -module Simple_optimized' \ - TARGET='$(TARGET)_optimized' INTERFACE='$(INTERFACE)' python_cpp - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG) -builtin -O -module Simple_builtin' \ - TARGET='$(TARGET)_builtin' INTERFACE='$(INTERFACE)' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='-module Simple_baseline' TARGET='$(TARGET)_baseline' INTERFACE='$(INTERFACE)' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='-O -module Simple_optimized' TARGET='$(TARGET)_optimized' INTERFACE='$(INTERFACE)' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='-builtin -O -module Simple_builtin' TARGET='$(TARGET)_builtin' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean rm -f $(TARGET)_*.py diff --git a/Examples/python/performance/func/runme.py b/Examples/python/performance/func/runme.py index fd2fb17..760a8ab 100644 --- a/Examples/python/performance/func/runme.py +++ b/Examples/python/performance/func/runme.py @@ -1,12 +1,11 @@ -#!/usr/bin/env - import sys sys.path.append('..') import harness -def proc (mod) : + +def proc(mod): x = mod.MyClass() - for i in range(10000000) : + for i in range(10000000): x.func() harness.run(proc) diff --git a/Examples/python/performance/harness.py b/Examples/python/performance/harness.py index 8e9b604..c3d38b4 100644 --- a/Examples/python/performance/harness.py +++ b/Examples/python/performance/harness.py @@ -1,13 +1,12 @@ -#!/usr/bin/env - import sys import time import imp from subprocess import * -def run (proc) : - try : +def run(proc): + + try: mod = imp.find_module(sys.argv[1]) mod = imp.load_module(sys.argv[1], *mod) @@ -16,15 +15,18 @@ def run (proc) : t2 = time.clock() print "%s took %f seconds" % (mod.__name__, t2 - t1) - except IndexError : - proc = Popen([sys.executable, 'runme.py', 'Simple_baseline'], stdout=PIPE) + except IndexError: + proc = Popen( + [sys.executable, 'runme.py', 'Simple_baseline'], stdout=PIPE) (stdout, stderr) = proc.communicate() print stdout - proc = Popen([sys.executable, 'runme.py', 'Simple_optimized'], stdout=PIPE) + proc = Popen( + [sys.executable, 'runme.py', 'Simple_optimized'], stdout=PIPE) (stdout, stderr) = proc.communicate() print stdout - proc = Popen([sys.executable, 'runme.py', 'Simple_builtin'], stdout=PIPE) + proc = Popen( + [sys.executable, 'runme.py', 'Simple_builtin'], stdout=PIPE) (stdout, stderr) = proc.communicate() print stdout diff --git a/Examples/python/performance/hierarchy/Makefile b/Examples/python/performance/hierarchy/Makefile index 98a50ec..cbc1154 100644 --- a/Examples/python/performance/hierarchy/Makefile +++ b/Examples/python/performance/hierarchy/Makefile @@ -1,21 +1,26 @@ TOP = ../../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = TARGET = Simple INTERFACE = Simple.i build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG) -module Simple_baseline' \ - TARGET='$(TARGET)_baseline' INTERFACE='$(INTERFACE)' python_cpp - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG) -O -module Simple_optimized' \ - TARGET='$(TARGET)_optimized' INTERFACE='$(INTERFACE)' python_cpp - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG) -builtin -O -module Simple_builtin' \ - TARGET='$(TARGET)_builtin' INTERFACE='$(INTERFACE)' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='-module Simple_baseline' TARGET='$(TARGET)_baseline' INTERFACE='$(INTERFACE)' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='-O -module Simple_optimized' TARGET='$(TARGET)_optimized' INTERFACE='$(INTERFACE)' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='-builtin -O -module Simple_builtin' TARGET='$(TARGET)_builtin' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean rm -f $(TARGET)_*.py diff --git a/Examples/python/performance/hierarchy/runme.py b/Examples/python/performance/hierarchy/runme.py index 8a57da0..8255cdc 100644 --- a/Examples/python/performance/hierarchy/runme.py +++ b/Examples/python/performance/hierarchy/runme.py @@ -1,12 +1,11 @@ -#!/usr/bin/env - import sys sys.path.append('..') import harness -def proc (mod) : + +def proc(mod): x = mod.H() - for i in range(10000000) : + for i in range(10000000): x.func() harness.run(proc) diff --git a/Examples/python/performance/hierarchy_operator/Makefile b/Examples/python/performance/hierarchy_operator/Makefile index 98a50ec..cbc1154 100644 --- a/Examples/python/performance/hierarchy_operator/Makefile +++ b/Examples/python/performance/hierarchy_operator/Makefile @@ -1,21 +1,26 @@ TOP = ../../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = TARGET = Simple INTERFACE = Simple.i build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG) -module Simple_baseline' \ - TARGET='$(TARGET)_baseline' INTERFACE='$(INTERFACE)' python_cpp - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG) -O -module Simple_optimized' \ - TARGET='$(TARGET)_optimized' INTERFACE='$(INTERFACE)' python_cpp - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG) -builtin -O -module Simple_builtin' \ - TARGET='$(TARGET)_builtin' INTERFACE='$(INTERFACE)' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='-module Simple_baseline' TARGET='$(TARGET)_baseline' INTERFACE='$(INTERFACE)' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='-O -module Simple_optimized' TARGET='$(TARGET)_optimized' INTERFACE='$(INTERFACE)' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='-builtin -O -module Simple_builtin' TARGET='$(TARGET)_builtin' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean rm -f $(TARGET)_*.py diff --git a/Examples/python/performance/hierarchy_operator/runme.py b/Examples/python/performance/hierarchy_operator/runme.py index cf20036..eabfae8 100644 --- a/Examples/python/performance/hierarchy_operator/runme.py +++ b/Examples/python/performance/hierarchy_operator/runme.py @@ -1,12 +1,11 @@ -#!/usr/bin/env - import sys sys.path.append('..') import harness -def proc (mod) : + +def proc(mod): x = mod.H() - for i in range(10000000) : + for i in range(10000000): x += i harness.run(proc) diff --git a/Examples/python/performance/operator/Makefile b/Examples/python/performance/operator/Makefile index 98a50ec..cbc1154 100644 --- a/Examples/python/performance/operator/Makefile +++ b/Examples/python/performance/operator/Makefile @@ -1,21 +1,26 @@ TOP = ../../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = TARGET = Simple INTERFACE = Simple.i build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG) -module Simple_baseline' \ - TARGET='$(TARGET)_baseline' INTERFACE='$(INTERFACE)' python_cpp - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG) -O -module Simple_optimized' \ - TARGET='$(TARGET)_optimized' INTERFACE='$(INTERFACE)' python_cpp - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG) -builtin -O -module Simple_builtin' \ - TARGET='$(TARGET)_builtin' INTERFACE='$(INTERFACE)' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='-module Simple_baseline' TARGET='$(TARGET)_baseline' INTERFACE='$(INTERFACE)' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='-O -module Simple_optimized' TARGET='$(TARGET)_optimized' INTERFACE='$(INTERFACE)' python_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='-builtin -O -module Simple_builtin' TARGET='$(TARGET)_builtin' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean rm -f $(TARGET)_*.py diff --git a/Examples/python/performance/operator/runme.py b/Examples/python/performance/operator/runme.py index 61a0e8e..d75ae40 100644 --- a/Examples/python/performance/operator/runme.py +++ b/Examples/python/performance/operator/runme.py @@ -1,12 +1,11 @@ -#!/usr/bin/env - import sys sys.path.append('..') import harness -def proc (mod) : + +def proc(mod): x = mod.MyClass() - for i in range(10000000) : + for i in range(10000000): x = x + i harness.run(proc) diff --git a/Examples/python/pointer/Makefile b/Examples/python/pointer/Makefile index df3bc86..26bfd94 100644 --- a/Examples/python/pointer/Makefile +++ b/Examples/python/pointer/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/pointer/runme.py b/Examples/python/pointer/runme.py index e38a306..5b5f16b 100644 --- a/Examples/python/pointer/runme.py +++ b/Examples/python/pointer/runme.py @@ -1,25 +1,25 @@ # file: runme.py -import example; +import example # First create some objects using the pointer library. -print "Testing the pointer library"; -a = example.new_intp(); -b = example.new_intp(); -c = example.new_intp(); -example.intp_assign(a,37); -example.intp_assign(b,42); +print "Testing the pointer library" +a = example.new_intp() +b = example.new_intp() +c = example.new_intp() +example.intp_assign(a, 37) +example.intp_assign(b, 42) -print " a =",a -print " b =",b -print " c =",c +print " a =", a +print " b =", b +print " c =", c # Call the add() function with some pointers -example.add(a,b,c) +example.add(a, b, c) # Now get the result r = example.intp_value(c) -print " 37 + 42 =",r +print " 37 + 42 =", r # Clean up the pointers example.delete_intp(a) @@ -30,15 +30,12 @@ example.delete_intp(c) # This should be much easier. Now how it is no longer # necessary to manufacture pointers. -print "Trying the typemap library"; -r = example.sub(37,42) -print " 37 - 42 =",r +print "Trying the typemap library" +r = example.sub(37, 42) +print " 37 - 42 =", r # Now try the version with multiple return values -print "Testing multiple return values"; -q,r = example.divide(42,37) -print " 42/37 = %d remainder %d" % (q,r) - - - +print "Testing multiple return values" +q, r = example.divide(42, 37) +print " 42/37 = %d remainder %d" % (q, r) diff --git a/Examples/python/reference/Makefile b/Examples/python/reference/Makefile index e940c1f..471e390 100644 --- a/Examples/python/reference/Makefile +++ b/Examples/python/reference/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/reference/example.cxx b/Examples/python/reference/example.cxx index 8a513bf..9dbaed2 100644 --- a/Examples/python/reference/example.cxx +++ b/Examples/python/reference/example.cxx @@ -19,7 +19,7 @@ Vector operator+(const Vector &a, const Vector &b) { char *Vector::print() { static char temp[512]; - sprintf(temp,"Vector %p (%g,%g,%g)", this, x,y,z); + sprintf(temp,"Vector %p (%g,%g,%g)", (void *)this, x,y,z); return temp; } diff --git a/Examples/python/reference/example.h b/Examples/python/reference/example.h index 4915adb..bcfcfb7 100644 --- a/Examples/python/reference/example.h +++ b/Examples/python/reference/example.h @@ -4,8 +4,8 @@ class Vector { private: double x,y,z; public: - Vector() : x(0), y(0), z(0) { }; - Vector(double x, double y, double z) : x(x), y(y), z(z) { }; + Vector() : x(0), y(0), z(0) { } + Vector(double x, double y, double z) : x(x), y(y), z(z) { } friend Vector operator+(const Vector &a, const Vector &b); char *print(); }; @@ -20,7 +20,3 @@ public: Vector &operator[](int); int size(); }; - - - - diff --git a/Examples/python/reference/example.i b/Examples/python/reference/example.i index 8c95b32..8af8397 100644 --- a/Examples/python/reference/example.i +++ b/Examples/python/reference/example.i @@ -31,7 +31,7 @@ public: VectorArray(int maxsize); ~VectorArray(); int size(); - + /* This wrapper provides an alternative to the [] operator */ %extend { Vector &get(int index) { @@ -42,7 +42,3 @@ public: } } }; - - - - diff --git a/Examples/python/reference/runme.py b/Examples/python/reference/runme.py index a1f5336..0ff217b 100644 --- a/Examples/python/reference/runme.py +++ b/Examples/python/reference/runme.py @@ -7,22 +7,22 @@ import example # ----- Object creation ----- print "Creating some objects:" -a = example.Vector(3,4,5) -b = example.Vector(10,11,12) +a = example.Vector(3, 4, 5) +b = example.Vector(10, 11, 12) -print " Created",a.cprint() -print " Created",b.cprint() +print " Created", a.cprint() +print " Created", b.cprint() # ----- Call an overloaded operator ----- # This calls the wrapper we placed around # -# operator+(const Vector &a, const Vector &) +# operator+(const Vector &a, const Vector &) # # It returns a new allocated object. print "Adding a+b" -c = example.addv(a,b) +c = example.addv(a, b) print " a+b =", c.cprint() # Note: Unless we free the result, a memory leak will occur @@ -33,25 +33,25 @@ del c # Note: Using the high-level interface here print "Creating an array of vectors" va = example.VectorArray(10) -print " va = ",va +print " va = ", va # ----- Set some values in the array ----- # These operators copy the value of $a and $b to the vector array -va.set(0,a) -va.set(1,b) +va.set(0, a) +va.set(1, b) -va.set(2,example.addv(a,b)) +va.set(2, example.addv(a, b)) # Get some values from the array print "Getting some array values" -for i in range(0,5): +for i in range(0, 5): print " va(%d) = %s" % (i, va.get(i).cprint()) # Watch under resource meter to check on this print "Making sure we don't leak memory." -for i in xrange(0,1000000): +for i in xrange(0, 1000000): c = va.get(i % 10) # ----- Clean up ----- @@ -60,4 +60,3 @@ print "Cleaning up" del va del a del b - diff --git a/Examples/python/simple/Makefile b/Examples/python/simple/Makefile index df3bc86..26bfd94 100644 --- a/Examples/python/simple/Makefile +++ b/Examples/python/simple/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/simple/runme.py b/Examples/python/simple/runme.py index d484ae9..ce01e5a 100644 --- a/Examples/python/simple/runme.py +++ b/Examples/python/simple/runme.py @@ -1,13 +1,13 @@ # file: runme.py -import example +import example # Call our gcd() function x = 42 y = 105 -g = example.gcd(x,y) -print "The gcd of %d and %d is %d" % (x,y,g) +g = example.gcd(x, y) +print "The gcd of %d and %d is %d" % (x, y, g) # Manipulate the Foo global variable @@ -19,12 +19,3 @@ example.cvar.Foo = 3.1415926 # See if the change took effect print "Foo = ", example.cvar.Foo - - - - - - - - - diff --git a/Examples/python/smartptr/Makefile b/Examples/python/smartptr/Makefile index 140d482..34edcfc 100644 --- a/Examples/python/smartptr/Makefile +++ b/Examples/python/smartptr/Makefile @@ -1,21 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/smartptr/example.h b/Examples/python/smartptr/example.h index c0f9b1d..c18e7ea 100644 --- a/Examples/python/smartptr/example.h +++ b/Examples/python/smartptr/example.h @@ -7,7 +7,7 @@ public: } virtual ~Shape() { nshapes--; - }; + } double x, y; void move(double dx, double dy); virtual double area() = 0; @@ -19,7 +19,7 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; + Circle(double r) : radius(r) { } virtual double area(); virtual double perimeter(); }; diff --git a/Examples/python/smartptr/runme.py b/Examples/python/smartptr/runme.py index 5ea1fb9..5f8b734 100644 --- a/Examples/python/smartptr/runme.py +++ b/Examples/python/smartptr/runme.py @@ -3,7 +3,7 @@ # This file illustrates the proxy class C++ interface generated # by SWIG. -import example +import example # ----- Object creation ----- @@ -17,7 +17,7 @@ print " Created square", s # ----- Access a static member ----- -print "\nA total of", example.cvar.Shape_nshapes,"shapes were created" +print "\nA total of", example.cvar.Shape_nshapes, "shapes were created" # ----- Member data access ----- @@ -30,16 +30,16 @@ s.x = -10 s.y = 5 print "\nHere is their current position:" -print " Circle = (%f, %f)" % (c.x,c.y) -print " Square = (%f, %f)" % (s.x,s.y) +print " Circle = (%f, %f)" % (c.x, c.y) +print " Square = (%f, %f)" % (s.x, s.y) # ----- Call some methods ----- print "\nHere are some properties of the shapes:" -for o in [c,s]: - print " ", o - print " area = ", o.area() - print " perimeter = ", o.perimeter() +for o in [c, s]: + print " ", o + print " area = ", o.area() + print " perimeter = ", o.perimeter() print "\nGuess I'll clean up now" @@ -50,6 +50,5 @@ del cc del ss s = 3 -print example.cvar.Shape_nshapes,"shapes remain" +print example.cvar.Shape_nshapes, "shapes remain" print "Goodbye" - diff --git a/Examples/python/std_map/Makefile b/Examples/python/std_map/Makefile index 06bce65..65af5ec 100644 --- a/Examples/python/std_map/Makefile +++ b/Examples/python/std_map/Makefile @@ -1,21 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i LIBS = -lm -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/std_map/runme.py b/Examples/python/std_map/runme.py index b521c9c..26031f3 100644 --- a/Examples/python/std_map/runme.py +++ b/Examples/python/std_map/runme.py @@ -7,8 +7,6 @@ pmap["hi"] = 1 pmap["hello"] = 2 - - dmap = {} dmap["hello"] = 1.0 dmap["hi"] = 2.0 @@ -28,8 +26,8 @@ for i in dmap.iterkeys(): for i in dmap.itervalues(): print "val", i -for k,v in dmap.iteritems(): - print "item", k,v +for k, v in dmap.iteritems(): + print "item", k, v dmap = example.DoubleMap() dmap["hello"] = 1.0 @@ -41,8 +39,8 @@ for i in dmap.iterkeys(): for i in dmap.itervalues(): print "val", i -for k,v in dmap.iteritems(): - print "item", k,v +for k, v in dmap.iteritems(): + print "item", k, v print dmap.items() @@ -54,7 +52,6 @@ print hmap.keys() print hmap.values() - dmap = {} dmap["hello"] = 2 dmap["hi"] = 4 @@ -76,7 +73,7 @@ for i in dmap.itervalues(): for i in dmap.iteritems(): print "item", i -for k,v in dmap.iteritems(): - print "item", k,v +for k, v in dmap.iteritems(): + print "item", k, v print dmap diff --git a/Examples/python/std_vector/Makefile b/Examples/python/std_vector/Makefile index 06bce65..65af5ec 100644 --- a/Examples/python/std_vector/Makefile +++ b/Examples/python/std_vector/Makefile @@ -1,21 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i LIBS = -lm -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/std_vector/runme.py b/Examples/python/std_vector/runme.py index d248ccb..d7d3c2e 100644 --- a/Examples/python/std_vector/runme.py +++ b/Examples/python/std_vector/runme.py @@ -4,13 +4,13 @@ import example # Call average with a Python list... -print example.average([1,2,3,4]) +print example.average([1, 2, 3, 4]) # ... or a wrapped std::vector v = example.IntVector(4) for i in range(len(v)): - v[i] = i+1 + v[i] = i + 1 print example.average(v) @@ -22,8 +22,8 @@ print example.half((1.0, 1.5, 2.0, 2.5, 3.0)) # ... or a wrapped std::vector v = example.DoubleVector() -for i in [1,2,3,4]: - v.append(i) +for i in [1, 2, 3, 4]: + v.append(i) print example.half(v) @@ -31,6 +31,5 @@ print example.half(v) example.halve_in_place(v) for i in range(len(v)): - print v[i], "; ", + print v[i], "; ", print - diff --git a/Examples/python/swigrun/Makefile b/Examples/python/swigrun/Makefile deleted file mode 100644 index fe9f64e..0000000 --- a/Examples/python/swigrun/Makefile +++ /dev/null @@ -1,23 +0,0 @@ -TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = example.cxx -TARGET = example -INTERFACE = example.i -LIBS = -lm -SWIGOPT = - -check: build - $(MAKE) -f $(TOP)/Makefile python_run - -build: - $(SWIG) -python -external-runtime - $(MAKE) -f $(TOP)/Makefile $(SWIGLIB) CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ - SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python_cpp - -static: - $(MAKE) -f $(TOP)/Makefile $(SWIGLIB) CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ - SWIGOPT='$(SWIGOPT)' TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static - -clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean - rm -f swigpyrun.h diff --git a/Examples/python/swigrun/example.cxx b/Examples/python/swigrun/example.cxx deleted file mode 100644 index 25906a5..0000000 --- a/Examples/python/swigrun/example.cxx +++ /dev/null @@ -1,20 +0,0 @@ -/* File : example.cxx */ - -#include -#include "swigpyrun.h" -#include "example.h" - - -Manager* convert_to_Manager(PyObject *py_obj) -{ - Manager* c_ptr; - swig_type_info *ty = SWIG_TypeQuery("Manager *"); - printf("manager ty %p \n", ty); - if (SWIG_ConvertPtr(py_obj, (void **) &c_ptr, ty, 0) == -1) { - c_ptr = 0; - } else { - Py_XINCREF(py_obj); - } - return c_ptr; -} - diff --git a/Examples/python/swigrun/runme.py b/Examples/python/swigrun/runme.py deleted file mode 100644 index abcd964..0000000 --- a/Examples/python/swigrun/runme.py +++ /dev/null @@ -1,28 +0,0 @@ -# file: runme.py - -# This file illustrates the cross language polymorphism using directors. - -import example - - -# CEO class, which overrides Employee::getPosition(). - -class CEO(example.Manager): - def __init__(self, name): - example.Manager.__init__(self, name) - def getPosition(self): - return "CEO" - def __del__(self): - print "CEO.__del__(),", self.getName() - # for proxy class extensions that are not "disowned" and - # define a __del__ method, it is very important to call the - # base class __del__. otherwise the c++ objects will never - # be deleted. - example.Manager.__del__(self) - - - - -e = CEO("Alice") -m = example.convert_to_Manager(e) -print m diff --git a/Examples/python/template/Makefile b/Examples/python/template/Makefile index 06bce65..65af5ec 100644 --- a/Examples/python/template/Makefile +++ b/Examples/python/template/Makefile @@ -1,21 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i LIBS = -lm -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='mypython' INTERFACE='$(INTERFACE)' python_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/template/runme.py b/Examples/python/template/runme.py index 05940bc..e408e15 100644 --- a/Examples/python/template/runme.py +++ b/Examples/python/template/runme.py @@ -3,32 +3,30 @@ import example # Call some templated functions -print example.maxint(3,7) -print example.maxdouble(3.14,2.18) +print example.maxint(3, 7) +print example.maxdouble(3.14, 2.18) # Create some class iv = example.vecint(100) dv = example.vecdouble(1000) -for i in range(0,100): - iv.setitem(i,2*i) +for i in range(0, 100): + iv.setitem(i, 2 * i) -for i in range(0,1000): - dv.setitem(i, 1.0/(i+1)) +for i in range(0, 1000): + dv.setitem(i, 1.0 / (i + 1)) sum = 0 -for i in range(0,100): - sum = sum + iv.getitem(i) +for i in range(0, 100): + sum = sum + iv.getitem(i) print sum sum = 0.0 -for i in range(0,1000): - sum = sum + dv.getitem(i) +for i in range(0, 1000): + sum = sum + dv.getitem(i) print sum del iv del dv - - diff --git a/Examples/python/varargs/Makefile b/Examples/python/varargs/Makefile index 505f199..a412cf2 100644 --- a/Examples/python/varargs/Makefile +++ b/Examples/python/varargs/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -SRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/varargs/runme.py b/Examples/python/varargs/runme.py index 8eab770..48e3134 100644 --- a/Examples/python/varargs/runme.py +++ b/Examples/python/varargs/runme.py @@ -1,13 +1,13 @@ # file: runme.py import sys -import example +import example # Call printf example.printf("Hello World. I'm printf\n") # Note: We call printf, but use *python* string formatting -for i in range(0,10): +for i in range(0, 10): example.printf("i is %d\n" % i) # This will probably be garbled because %d is interpreted by C @@ -15,21 +15,13 @@ example.printf("The value is %d\n") stdout = example.stdout_stream() # Call fprintf -example.fprintf(stdout,"Hello World. I'm fprintf\n") -for i in range(0,10): - example.fprintf(stdout,"i is %d\n" % i) +example.fprintf(stdout, "Hello World. I'm fprintf\n") +for i in range(0, 10): + example.fprintf(stdout, "i is %d\n" % i) # This won't be garbled since %d is not interpreted -example.fprintf(stdout,"The value is %d\n") +example.fprintf(stdout, "The value is %d\n") # This function calls our NULL-terminated function -example.printv("Hello","World","this","is","a","test.") - - - - - - - - +example.printv("Hello", "World", "this", "is", "a", "test.") diff --git a/Examples/python/variables/Makefile b/Examples/python/variables/Makefile index df3bc86..26bfd94 100644 --- a/Examples/python/variables/Makefile +++ b/Examples/python/variables/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile python_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' python_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' python static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mypython' INTERFACE='$(INTERFACE)' python_static clean: - $(MAKE) -f $(TOP)/Makefile TARGET='$(TARGET)' python_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' TARGET='$(TARGET)' python_clean diff --git a/Examples/python/variables/example.c b/Examples/python/variables/example.c index aa4ffe9..85685fe 100644 --- a/Examples/python/variables/example.c +++ b/Examples/python/variables/example.c @@ -51,10 +51,10 @@ void print_vars() { printf("dvar = %g\n", dvar); printf("cvar = %c\n", cvar); printf("strvar = %s\n", strvar ? strvar : "(null)"); - printf("cstrvar = %s\n", cstrvar ? cstrvar : "(null)"); - printf("iptrvar = %p\n", iptrvar); + printf("cstrvar = %s\n", cstrvar); + printf("iptrvar = %p\n", (void *)iptrvar); printf("name = %s\n", name); - printf("ptptr = %p (%d, %d)\n", ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0); + printf("ptptr = %p (%d, %d)\n", (void *)ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0); printf("pt = (%d, %d)\n", pt.x, pt.y); printf("status = %d\n", status); } diff --git a/Examples/python/variables/runme.py b/Examples/python/variables/runme.py index b635b98..3388a0e 100644 --- a/Examples/python/variables/runme.py +++ b/Examples/python/variables/runme.py @@ -4,21 +4,21 @@ import example # Try to set the values of some global variables -example.cvar.ivar = 42 -example.cvar.svar = -31000 -example.cvar.lvar = 65537 -example.cvar.uivar = 123456 -example.cvar.usvar = 61000 -example.cvar.ulvar = 654321 -example.cvar.scvar = -13 -example.cvar.ucvar = 251 -example.cvar.cvar = "S" -example.cvar.fvar = 3.14159 -example.cvar.dvar = 2.1828 -example.cvar.strvar = "Hello World" -example.cvar.iptrvar= example.new_int(37) -example.cvar.ptptr = example.new_Point(37,42) -example.cvar.name = "Bill" +example.cvar.ivar = 42 +example.cvar.svar = -31000 +example.cvar.lvar = 65537 +example.cvar.uivar = 123456 +example.cvar.usvar = 61000 +example.cvar.ulvar = 654321 +example.cvar.scvar = -13 +example.cvar.ucvar = 251 +example.cvar.cvar = "S" +example.cvar.fvar = 3.14159 +example.cvar.dvar = 2.1828 +example.cvar.strvar = "Hello World" +example.cvar.iptrvar = example.new_int(37) +example.cvar.ptptr = example.new_Point(37, 42) +example.cvar.name = "Bill" # Now print out the values of the variables @@ -46,16 +46,16 @@ print "\nVariables (values printed from C)" example.print_vars() -print "\nNow I'm going to try and modify some read only variables"; +print "\nNow I'm going to try and modify some read only variables" -print " Tring to set 'path'"; +print " Tring to set 'path'" try: example.cvar.path = "Whoa!" print "Hey, what's going on?!?! This shouldn't work" except: print "Good." -print " Trying to set 'status'"; +print " Trying to set 'status'" try: example.cvar.status = 0 print "Hey, what's going on?!?! This shouldn't work" @@ -70,6 +70,3 @@ example.cvar.pt = example.cvar.ptptr print "The new value is" example.pt_print() print "You should see the value", example.Point_print(example.cvar.ptptr) - - - diff --git a/Examples/r/class/Makefile b/Examples/r/class/Makefile index 8a64f49..6b4b306 100644 --- a/Examples/r/class/Makefile +++ b/Examples/r/class/Makefile @@ -1,15 +1,17 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile r_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' r_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' r_cpp clean: - $(MAKE) -f $(TOP)/Makefile INTERFACE='$(INTERFACE)' r_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INTERFACE='$(INTERFACE)' r_clean diff --git a/Examples/r/class/example.cxx b/Examples/r/class/example.cxx index 1e8e203..0463045 100644 --- a/Examples/r/class/example.cxx +++ b/Examples/r/class/example.cxx @@ -1,4 +1,4 @@ -/* File : example.c */ +/* File : example.cxx */ #include "example.h" #define M_PI 3.14159265358979323846 @@ -11,18 +11,18 @@ void Shape::move(double dx, double dy) { int Shape::nshapes = 0; -double Circle::area(void) { +double Circle::area() { return M_PI*radius*radius; } -double Circle::perimeter(void) { +double Circle::perimeter() { return 2*M_PI*radius; } -double Square::area(void) { +double Square::area() { return width*width; } -double Square::perimeter(void) { +double Square::perimeter() { return 4*width; } diff --git a/Examples/r/class/example.h b/Examples/r/class/example.h index 46d9013..0dff185 100644 --- a/Examples/r/class/example.h +++ b/Examples/r/class/example.h @@ -7,11 +7,11 @@ public: } virtual ~Shape() { nshapes--; - }; - double x, y; + } + double x, y; void move(double dx, double dy); - virtual double area(void) = 0; - virtual double perimeter(void) = 0; + virtual double area() = 0; + virtual double perimeter() = 0; static int nshapes; }; @@ -19,21 +19,16 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; - virtual double area(void); - virtual double perimeter(void); + Circle(double r) : radius(r) { } + virtual double area(); + virtual double perimeter(); }; class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; - virtual double area(void); - virtual double perimeter(void); + Square(double w) : width(w) { } + virtual double area(); + virtual double perimeter(); }; - - - - - diff --git a/Examples/r/class/example.i b/Examples/r/class/example.i index 4654d26..fbdf724 100644 --- a/Examples/r/class/example.i +++ b/Examples/r/class/example.i @@ -1,9 +1,9 @@ /* File : example.i */ %module example -%inline %{ +%{ #include "example.h" %} -%include "example.h" - +/* Let's just grab the original header file here */ +%include "example.h" diff --git a/Examples/r/simple/Makefile b/Examples/r/simple/Makefile index 8a8e0e1..add8818 100644 --- a/Examples/r/simple/Makefile +++ b/Examples/r/simple/Makefile @@ -1,15 +1,17 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile r_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' r_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' r clean: - $(MAKE) -f $(TOP)/Makefile INTERFACE='$(INTERFACE)' r_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' INTERFACE='$(INTERFACE)' r_clean diff --git a/Examples/ruby/class/Makefile b/Examples/ruby/class/Makefile index ef267bc..0d469c6 100644 --- a/Examples/ruby/class/Makefile +++ b/Examples/ruby/class/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/class/example.cxx b/Examples/ruby/class/example.cxx index 1e8e203..0463045 100644 --- a/Examples/ruby/class/example.cxx +++ b/Examples/ruby/class/example.cxx @@ -1,4 +1,4 @@ -/* File : example.c */ +/* File : example.cxx */ #include "example.h" #define M_PI 3.14159265358979323846 @@ -11,18 +11,18 @@ void Shape::move(double dx, double dy) { int Shape::nshapes = 0; -double Circle::area(void) { +double Circle::area() { return M_PI*radius*radius; } -double Circle::perimeter(void) { +double Circle::perimeter() { return 2*M_PI*radius; } -double Square::area(void) { +double Square::area() { return width*width; } -double Square::perimeter(void) { +double Square::perimeter() { return 4*width; } diff --git a/Examples/ruby/class/example.h b/Examples/ruby/class/example.h index 46d9013..0dff185 100644 --- a/Examples/ruby/class/example.h +++ b/Examples/ruby/class/example.h @@ -7,11 +7,11 @@ public: } virtual ~Shape() { nshapes--; - }; - double x, y; + } + double x, y; void move(double dx, double dy); - virtual double area(void) = 0; - virtual double perimeter(void) = 0; + virtual double area() = 0; + virtual double perimeter() = 0; static int nshapes; }; @@ -19,21 +19,16 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; - virtual double area(void); - virtual double perimeter(void); + Circle(double r) : radius(r) { } + virtual double area(); + virtual double perimeter(); }; class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; - virtual double area(void); - virtual double perimeter(void); + Square(double w) : width(w) { } + virtual double area(); + virtual double perimeter(); }; - - - - - diff --git a/Examples/ruby/class/example.i b/Examples/ruby/class/example.i index 75700b3..fbdf724 100644 --- a/Examples/ruby/class/example.i +++ b/Examples/ruby/class/example.i @@ -7,4 +7,3 @@ /* Let's just grab the original header file here */ %include "example.h" - diff --git a/Examples/ruby/class/index.html b/Examples/ruby/class/index.html index 67eeac9..927c001 100644 --- a/Examples/ruby/class/index.html +++ b/Examples/ruby/class/index.html @@ -12,9 +12,7 @@

      Wrapping a simple C++ class

      -This example illustrates C++ class wrapping performed by SWIG. -C++ classes are simply transformed into Ruby classes that provide methods to -access class members. +This example illustrates wrapping a simple C++ class to give a Ruby class.

      The C++ Code

      @@ -32,8 +30,8 @@ public: } virtual ~Shape() { nshapes--; - }; - double x, y; + } + double x, y; void move(double dx, double dy); virtual double area() = 0; virtual double perimeter() = 0; @@ -44,7 +42,7 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; + Circle(double r) : radius(r) { } virtual double area(); virtual double perimeter(); }; @@ -53,7 +51,7 @@ class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; + Square(double w) : width(w) { } virtual double area(); virtual double perimeter(); }; @@ -122,10 +120,8 @@ print "The area is ", c.area, "\n"
  • -

  • When a instance of Ruby level wrapper class is garbage collected by +
  • When a instance of Ruby level wrapper class is garbage collected by the Ruby interpreter, the corresponding C++ destructor is automatically invoked. -(Note: destructors are currently not inherited. This might change later. -Until then, use -make_default).

  • Static member variables are wrapped as Ruby class accessor methods. @@ -144,53 +140,14 @@ Shapes.nshapes = 13 # Set a static data member
    • Ruby module of SWIG differs from other language modules in wrapping C++ -interfaces. They provides lower-level interfaces and optional higher-level +interfaces. They provide lower-level interfaces and optional higher-level interfaces know as proxy classes. Ruby module needs no such redundancy due to Ruby's sophisticated extension API. -

      -

    • SWIG *does* know how to properly perform upcasting of objects in +
    • SWIG does know how to properly perform upcasting of objects in an inheritance hierarchy except for multiple inheritance. -

      -

    • A wide variety of C++ features are not currently supported by SWIG. Here is the -short and incomplete list: - -

      -

        -
      • Overloaded methods and functions. SWIG wrappers don't know how to resolve name -conflicts so you must give an alternative name to any overloaded method name using the -%name directive like this: - -
        -
        -void foo(int a);  
        -%name(foo2) void foo(double a, double b);
        -
        -
        - -

        -

      • Overloaded operators. Not supported at all. The only workaround for this is -to write a helper function. For example: - -
        -
        -%inline %{
        -    Vector *vector_add(Vector *a, Vector *b) {
        -          ... whatever ...
        -    }
        -%}
        -
        -
        - -

        -

      • Namespaces. Not supported at all. Won't be supported until SWIG2.0 (if at all). - -
      -

      - -

    • Dave's snide remark: Like a large bottle of strong Tequilla, it's better to -use C++ in moderation. +
    • C++ Namespaces - %nspace isn't yet supported for Ruby.
    diff --git a/Examples/ruby/class/runme.rb b/Examples/ruby/class/runme.rb index de73bcd..971e149 100644 --- a/Examples/ruby/class/runme.rb +++ b/Examples/ruby/class/runme.rb @@ -45,5 +45,9 @@ end # Notice how the Shape#area() and Shape#perimeter() functions really # invoke the appropriate virtual method on each object. +# Remove references to the object and force a garbage collection run. +c = s = o = nil +GC.start() + print "\n", Example::Shape.nshapes," shapes remain\n" print "Goodbye\n" diff --git a/Examples/ruby/constants/Makefile b/Examples/ruby/constants/Makefile index e0f6a03..24698f2 100644 --- a/Examples/ruby/constants/Makefile +++ b/Examples/ruby/constants/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -SRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/constants/runme.rb b/Examples/ruby/constants/runme.rb old mode 100755 new mode 100644 diff --git a/Examples/ruby/enum/Makefile b/Examples/ruby/enum/Makefile index ef267bc..0d469c6 100644 --- a/Examples/ruby/enum/Makefile +++ b/Examples/ruby/enum/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/exception_class/Makefile b/Examples/ruby/exception_class/Makefile index 46bb799..2d4518e 100644 --- a/Examples/ruby/exception_class/Makefile +++ b/Examples/ruby/exception_class/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/free_function/Makefile b/Examples/ruby/free_function/Makefile index ef267bc..0d469c6 100644 --- a/Examples/ruby/free_function/Makefile +++ b/Examples/ruby/free_function/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/funcptr/Makefile b/Examples/ruby/funcptr/Makefile index ddbc1ae..d320c9a 100644 --- a/Examples/ruby/funcptr/Makefile +++ b/Examples/ruby/funcptr/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/funcptr2/Makefile b/Examples/ruby/funcptr2/Makefile index ddbc1ae..d320c9a 100644 --- a/Examples/ruby/funcptr2/Makefile +++ b/Examples/ruby/funcptr2/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/functor/Makefile b/Examples/ruby/functor/Makefile index 662baa1..c7f998c 100644 --- a/Examples/ruby/functor/Makefile +++ b/Examples/ruby/functor/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/hashargs/Makefile b/Examples/ruby/hashargs/Makefile index cee97f2..2d0d943 100644 --- a/Examples/ruby/hashargs/Makefile +++ b/Examples/ruby/hashargs/Makefile @@ -1,21 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -SRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = TARGET = example INTERFACE = example.i LIBS = -lm -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/hashargs/runme.rb b/Examples/ruby/hashargs/runme.rb old mode 100755 new mode 100644 diff --git a/Examples/ruby/import/Makefile b/Examples/ruby/import/Makefile index fc6a9f1..586e488 100644 --- a/Examples/ruby/import/Makefile +++ b/Examples/ruby/import/Makefile @@ -1,20 +1,25 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SWIGOPT = LIBS = - + check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='base' INTERFACE='base.i' ruby_cpp - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' ruby_cpp - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' ruby_cpp - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='spam' INTERFACE='spam.i' ruby_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='base' INTERFACE='base.i' ruby_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' ruby_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' ruby_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='spam' INTERFACE='spam.i' ruby_cpp clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/import_template/Makefile b/Examples/ruby/import_template/Makefile index fc6a9f1..586e488 100644 --- a/Examples/ruby/import_template/Makefile +++ b/Examples/ruby/import_template/Makefile @@ -1,20 +1,25 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SWIGOPT = LIBS = - + check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='base' INTERFACE='base.i' ruby_cpp - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' ruby_cpp - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' ruby_cpp - $(MAKE) -f $(TOP)/Makefile SWIG='$(SWIG)' SWIGOPT='$(SWIGOPT)' \ - LIBS='$(LIBS)' TARGET='spam' INTERFACE='spam.i' ruby_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='base' INTERFACE='base.i' ruby_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='foo' INTERFACE='foo.i' ruby_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='bar' INTERFACE='bar.i' ruby_cpp + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + SWIGOPT='$(SWIGOPT)' LIBS='$(LIBS)' TARGET='spam' INTERFACE='spam.i' ruby_cpp clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/index.html b/Examples/ruby/index.html index f04146e..4f4aa0a 100644 --- a/Examples/ruby/index.html +++ b/Examples/ruby/index.html @@ -1,4 +1,4 @@ - + SWIG:Examples:ruby diff --git a/Examples/ruby/java/Makefile b/Examples/ruby/java/Makefile index c06bfb7..bec5e18 100644 --- a/Examples/ruby/java/Makefile +++ b/Examples/ruby/java/Makefile @@ -1,23 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run -build: Example.class - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ - TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' CXX="gcj" \ +build: Example.class Example.h + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' \ CXXSHARED="gcj -fpic -shared Example.class" LIBS="-lstdc++" DEFS='' ruby_cpp clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean rm -f *.class Example.h -Example.class: Example.java - gcj -fPIC -C -c -g Example.java - gcjh Example - +Example.class Example.h: $(SRCDIR)Example.java + gcj -d . -fPIC -C -c -g $(SRCDIR)Example.java + gcjh Example.class diff --git a/Examples/ruby/mark_function/Makefile b/Examples/ruby/mark_function/Makefile index ef267bc..0d469c6 100644 --- a/Examples/ruby/mark_function/Makefile +++ b/Examples/ruby/mark_function/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/mark_function/runme.rb b/Examples/ruby/mark_function/runme.rb index 6d84ee8..a7c5b04 100644 --- a/Examples/ruby/mark_function/runme.rb +++ b/Examples/ruby/mark_function/runme.rb @@ -9,7 +9,7 @@ begin zoo.add_animal(tiger1) # unset variables to force gc - tiger = nil + tiger1 = nil end GC.start @@ -20,4 +20,4 @@ tiger2 = zoo.get_animal(0) # Call a method to verify the animal is still valid and not gc'ed if tiger2.get_name != "tiger1" raise RuntimeError, "Wrong animal name" -end +end diff --git a/Examples/ruby/multimap/Makefile b/Examples/ruby/multimap/Makefile index ddbc1ae..d320c9a 100644 --- a/Examples/ruby/multimap/Makefile +++ b/Examples/ruby/multimap/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/multimap/runme.rb b/Examples/ruby/multimap/runme.rb old mode 100755 new mode 100644 diff --git a/Examples/ruby/operator/Makefile b/Examples/ruby/operator/Makefile index c7a21d0..53241ee 100644 --- a/Examples/ruby/operator/Makefile +++ b/Examples/ruby/operator/Makefile @@ -1,21 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i LIBS = -lm -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/overloading/Makefile b/Examples/ruby/overloading/Makefile index ef267bc..0d469c6 100644 --- a/Examples/ruby/overloading/Makefile +++ b/Examples/ruby/overloading/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/pointer/Makefile b/Examples/ruby/pointer/Makefile index ddbc1ae..d320c9a 100644 --- a/Examples/ruby/pointer/Makefile +++ b/Examples/ruby/pointer/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/reference/Makefile b/Examples/ruby/reference/Makefile index ef267bc..0d469c6 100644 --- a/Examples/ruby/reference/Makefile +++ b/Examples/ruby/reference/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/reference/example.cxx b/Examples/ruby/reference/example.cxx index 8a513bf..9dbaed2 100644 --- a/Examples/ruby/reference/example.cxx +++ b/Examples/ruby/reference/example.cxx @@ -19,7 +19,7 @@ Vector operator+(const Vector &a, const Vector &b) { char *Vector::print() { static char temp[512]; - sprintf(temp,"Vector %p (%g,%g,%g)", this, x,y,z); + sprintf(temp,"Vector %p (%g,%g,%g)", (void *)this, x,y,z); return temp; } diff --git a/Examples/ruby/reference/example.h b/Examples/ruby/reference/example.h index 4915adb..bcfcfb7 100644 --- a/Examples/ruby/reference/example.h +++ b/Examples/ruby/reference/example.h @@ -4,8 +4,8 @@ class Vector { private: double x,y,z; public: - Vector() : x(0), y(0), z(0) { }; - Vector(double x, double y, double z) : x(x), y(y), z(z) { }; + Vector() : x(0), y(0), z(0) { } + Vector(double x, double y, double z) : x(x), y(y), z(z) { } friend Vector operator+(const Vector &a, const Vector &b); char *print(); }; @@ -20,7 +20,3 @@ public: Vector &operator[](int); int size(); }; - - - - diff --git a/Examples/ruby/reference/example.i b/Examples/ruby/reference/example.i index 6daa3b1..173143d 100644 --- a/Examples/ruby/reference/example.i +++ b/Examples/ruby/reference/example.i @@ -29,7 +29,7 @@ public: VectorArray(int maxsize); ~VectorArray(); int size(); - + /* This wrapper provides an alternative to the [] operator */ %extend { Vector &get(int index) { @@ -40,7 +40,3 @@ public: } } }; - - - - diff --git a/Examples/ruby/simple/Makefile b/Examples/ruby/simple/Makefile index ddbc1ae..d320c9a 100644 --- a/Examples/ruby/simple/Makefile +++ b/Examples/ruby/simple/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/simple/runme.rb b/Examples/ruby/simple/runme.rb old mode 100755 new mode 100644 diff --git a/Examples/ruby/std_vector/Makefile b/Examples/ruby/std_vector/Makefile index f7b1480..636a0f1 100644 --- a/Examples/ruby/std_vector/Makefile +++ b/Examples/ruby/std_vector/Makefile @@ -1,21 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i LIBS = -lm -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/template/Makefile b/Examples/ruby/template/Makefile index f7b1480..636a0f1 100644 --- a/Examples/ruby/template/Makefile +++ b/Examples/ruby/template/Makefile @@ -1,21 +1,24 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig -CXXSRCS = +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = TARGET = example INTERFACE = example.i LIBS = -lm -SWIGOPT = +SWIGOPT = check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ SWIGOPT='$(SWIGOPT)' TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/value/Makefile b/Examples/ruby/value/Makefile index ddbc1ae..d320c9a 100644 --- a/Examples/ruby/value/Makefile +++ b/Examples/ruby/value/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/value/example.i b/Examples/ruby/value/example.i index 98fd60e..39663c6 100644 --- a/Examples/ruby/value/example.i +++ b/Examples/ruby/value/example.i @@ -26,7 +26,7 @@ Vector *new_Vector(double x, double y, double z) { } void vector_print(Vector *v) { - printf("Vector %p = (%g, %g, %g)\n", v, v->x, v->y, v->z); + printf("Vector %p = (%g, %g, %g)\n", (void *)v, v->x, v->y, v->z); } %} diff --git a/Examples/ruby/variables/Makefile b/Examples/ruby/variables/Makefile index ddbc1ae..d320c9a 100644 --- a/Examples/ruby/variables/Makefile +++ b/Examples/ruby/variables/Makefile @@ -1,19 +1,22 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib SRCS = example.c TARGET = example INTERFACE = example.i check: build - $(MAKE) -f $(TOP)/Makefile ruby_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_run build: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' ruby static: - $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='myruby' INTERFACE='$(INTERFACE)' ruby_static clean: - $(MAKE) -f $(TOP)/Makefile ruby_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' ruby_clean diff --git a/Examples/ruby/variables/example.c b/Examples/ruby/variables/example.c index aa4ffe9..85685fe 100644 --- a/Examples/ruby/variables/example.c +++ b/Examples/ruby/variables/example.c @@ -51,10 +51,10 @@ void print_vars() { printf("dvar = %g\n", dvar); printf("cvar = %c\n", cvar); printf("strvar = %s\n", strvar ? strvar : "(null)"); - printf("cstrvar = %s\n", cstrvar ? cstrvar : "(null)"); - printf("iptrvar = %p\n", iptrvar); + printf("cstrvar = %s\n", cstrvar); + printf("iptrvar = %p\n", (void *)iptrvar); printf("name = %s\n", name); - printf("ptptr = %p (%d, %d)\n", ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0); + printf("ptptr = %p (%d, %d)\n", (void *)ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0); printf("pt = (%d, %d)\n", pt.x, pt.y); printf("status = %d\n", status); } diff --git a/Examples/s-exp/uffi.lisp b/Examples/s-exp/uffi.lisp index 253f85a..aea9a14 100644 --- a/Examples/s-exp/uffi.lisp +++ b/Examples/s-exp/uffi.lisp @@ -15,7 +15,7 @@ (defvar *swig-source-directory* #p"/home/mkoeppe/s/swig1.3/") -(defvar *swig-program* (merge-pathnames "preinst-swig" *swig-source-directory*)) +(defvar *swig-program* (merge-pathnames "swig" *swig-source-directory*)) (defun run-swig (swig-interface-file-name &key directory-search-list module ignore-errors c++) diff --git a/Examples/scilab/check.list b/Examples/scilab/check.list new file mode 100644 index 0000000..0bcf457 --- /dev/null +++ b/Examples/scilab/check.list @@ -0,0 +1,16 @@ +# see top-level Makefile.in +class +constants +contract +enum +funcptr +matrix +matrix2 +pointer +simple +std_list +std_vector +struct +template +variables + diff --git a/Examples/scilab/class/Makefile b/Examples/scilab/class/Makefile new file mode 100644 index 0000000..40c97a5 --- /dev/null +++ b/Examples/scilab/class/Makefile @@ -0,0 +1,17 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = example.cxx +TARGET = example +INTERFACE = example.i + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' scilab_cpp + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_clean diff --git a/Examples/scilab/class/example.cxx b/Examples/scilab/class/example.cxx new file mode 100644 index 0000000..0463045 --- /dev/null +++ b/Examples/scilab/class/example.cxx @@ -0,0 +1,28 @@ +/* File : example.cxx */ + +#include "example.h" +#define M_PI 3.14159265358979323846 + +/* Move the shape to a new location */ +void Shape::move(double dx, double dy) { + x += dx; + y += dy; +} + +int Shape::nshapes = 0; + +double Circle::area() { + return M_PI*radius*radius; +} + +double Circle::perimeter() { + return 2*M_PI*radius; +} + +double Square::area() { + return width*width; +} + +double Square::perimeter() { + return 4*width; +} diff --git a/Examples/scilab/class/example.h b/Examples/scilab/class/example.h new file mode 100644 index 0000000..0dff185 --- /dev/null +++ b/Examples/scilab/class/example.h @@ -0,0 +1,34 @@ +/* File : example.h */ + +class Shape { +public: + Shape() { + nshapes++; + } + virtual ~Shape() { + nshapes--; + } + double x, y; + void move(double dx, double dy); + virtual double area() = 0; + virtual double perimeter() = 0; + static int nshapes; +}; + +class Circle : public Shape { +private: + double radius; +public: + Circle(double r) : radius(r) { } + virtual double area(); + virtual double perimeter(); +}; + +class Square : public Shape { +private: + double width; +public: + Square(double w) : width(w) { } + virtual double area(); + virtual double perimeter(); +}; diff --git a/Examples/scilab/class/example.i b/Examples/scilab/class/example.i new file mode 100644 index 0000000..fbdf724 --- /dev/null +++ b/Examples/scilab/class/example.i @@ -0,0 +1,9 @@ +/* File : example.i */ +%module example + +%{ +#include "example.h" +%} + +/* Let's just grab the original header file here */ +%include "example.h" diff --git a/Examples/scilab/class/runme.sci b/Examples/scilab/class/runme.sci new file mode 100644 index 0000000..236e541 --- /dev/null +++ b/Examples/scilab/class/runme.sci @@ -0,0 +1,52 @@ +lines(0); +ilib_verbose(0); +ierr = exec('loader.sce', 'errcatch'); +if ierr <> 0 then + disp(lasterror()); + exit(ierr); +end + +// ----- Object creation ----- + +printf("Creating some objects:\n"); +c = new_Circle(10) +s = new_Square(10) + +// ----- Access a static member ----- + +printf("\nA total of %i shapes were created\n", Shape_nshapes_get()); + +// ----- Member data access ----- + +// Set the location of the object + +Shape_x_set(c, 20); +Shape_y_set(c, 30); + +Shape_x_set(s, -10); +Shape_y_set(s, 5); + +printf("\nHere is their current position:\n"); +printf(" Circle = (%f, %f)\n", Shape_x_get(c), Shape_y_get(c)); +printf(" Square = (%f, %f)\n", Shape_x_get(s), Shape_y_get(s)); + +// ----- Call some methods ----- + +printf("\nHere are some properties of the shapes:\n"); +function print_shape(o) + printf(" area = %f\n", Shape_area(o)); + printf(" perimeter = %f\n", Shape_perimeter(o)); +endfunction +print_shape(c); +print_shape(s); + +printf("\nGuess I will clean up now\n"); + +// Note: this invokes the virtual destructor +delete_Circle(c); +delete_Square(s); + +printf("%i shapes remain\n", Shape_nshapes_get()); +printf("Goodbye\n"); + +exit diff --git a/Examples/scilab/constants/Makefile b/Examples/scilab/constants/Makefile new file mode 100644 index 0000000..d47674b --- /dev/null +++ b/Examples/scilab/constants/Makefile @@ -0,0 +1,17 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = +TARGET = example +INTERFACE = example.i + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' scilab + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_clean diff --git a/Examples/scilab/constants/example.i b/Examples/scilab/constants/example.i new file mode 100644 index 0000000..1172a4e --- /dev/null +++ b/Examples/scilab/constants/example.i @@ -0,0 +1,30 @@ +/* File : example.i */ +%module example + +/* Wraps enums and constants as Scilab variables (instead of functions) */ +%scilabconst(1); + +/* A few preprocessor macros */ + +#define ICONST 42 +#define FCONST 2.1828 +#define CCONST 'x' +#define CCONST2 '\n' +#define SCONST "Hello World" +#define SCONST2 "\"Hello World\"" + +/* This should work just fine */ +#define EXPR ICONST + 3*(FCONST) + +/* This shouldn't do anything */ +#define EXTERN extern + +/* Neither should this (BAR isn't defined) */ +#define FOO (ICONST + BAR) + +/* The following directives also produce constants */ + +%constant int iconst = 37; +%constant double fconst = 3.14; + + diff --git a/Examples/scilab/constants/runme.sci b/Examples/scilab/constants/runme.sci new file mode 100644 index 0000000..cfb28b6 --- /dev/null +++ b/Examples/scilab/constants/runme.sci @@ -0,0 +1,18 @@ +lines(0); +ilib_verbose(0); +ierr = exec('loader.sce', 'errcatch'); +if ierr <> 0 then + disp(lasterror()); + exit(ierr); +end +example_Init(); + +printf("\nTest constants\n"); +printf("ICONST = %i (should be 42)\n", ICONST); +printf("FCONST = %5.4f (should be 2.1828)\n", FCONST); +printf("SCONST = ''%s'' (should be ''Hello World'')\n", SCONST); +printf("EXPR = %5.4f (should be 48.5484)\n", EXPR); +printf("iconst = %i (should be 37)\n", iconst); +printf("fconst = %3.2f (should be 3.14)\n", fconst); + +exit diff --git a/Examples/scilab/contract/Makefile b/Examples/scilab/contract/Makefile new file mode 100644 index 0000000..6604d19 --- /dev/null +++ b/Examples/scilab/contract/Makefile @@ -0,0 +1,17 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = example.c +TARGET = example +INTERFACE = example.i + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' scilab + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_clean diff --git a/Examples/scilab/contract/example.c b/Examples/scilab/contract/example.c new file mode 100644 index 0000000..1a64454 --- /dev/null +++ b/Examples/scilab/contract/example.c @@ -0,0 +1,23 @@ +/* File : example.c */ + +/* A global variable */ +double Foo = 3.0; + +/* Compute the greatest common divisor of positive integers */ +int gcd(int x, int y) { + int g; + g = y; + while (x > 0) { + g = x; + x = y % x; + y = g; + } + return g; +} + +int fact(int n) { + if (n <= 0) return 1; + return n*fact(n-1); +} + + diff --git a/Examples/scilab/contract/example.i b/Examples/scilab/contract/example.i new file mode 100644 index 0000000..8fd1a80 --- /dev/null +++ b/Examples/scilab/contract/example.i @@ -0,0 +1,21 @@ +/* File : example.i */ +%module example + +%contract gcd(int x, int y) { +require: + x >= 0; + y >= 0; +} + +%contract fact(int n) { +require: + n >= 0; +ensure: + fact >= 1; +} + +%inline %{ +extern int gcd(int x, int y); +extern int fact(int n); +extern double Foo; +%} diff --git a/Examples/scilab/contract/runme.sci b/Examples/scilab/contract/runme.sci new file mode 100644 index 0000000..718424b --- /dev/null +++ b/Examples/scilab/contract/runme.sci @@ -0,0 +1,46 @@ +lines(0); +ilib_verbose(0); +ierr = exec('loader.sce', 'errcatch'); +if ierr <> 0 then + disp(lasterror()); + exit(ierr); +end + + +// Call our gcd() function +x = 42; +y = 105; +g = gcd(x, y); +printf("The gcd of %d and %d is %d\n", x, y, g); + +// Call our fact() function +x = 5; +g = fact(x); +printf("The fact of %d is %d\n", x, g); + +// Manipulate the Foo global variable + +// Output its current value +printf("Foo = %f\n", Foo_get()); + +// Change its value +Foo_set(3.1415926); + +// See if the change took effect +printf("Foo = %f\n", Foo_get()); + +// Check error messages when violating contract +ierr = execstr('gcd(-42, 105)', 'errcatch'); +if ierr <> 20003 then + error("gcd(-42, 105) must provoke a RunTimeError") +end + +ierr = execstr('fact(-4)', 'errcatch'); +if ierr <> 20003 then + error("fact(-4) must provoke a RunTimeError") +end + +exit + + + diff --git a/Examples/scilab/enum/Makefile b/Examples/scilab/enum/Makefile new file mode 100644 index 0000000..40c97a5 --- /dev/null +++ b/Examples/scilab/enum/Makefile @@ -0,0 +1,17 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = example.cxx +TARGET = example +INTERFACE = example.i + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' scilab_cpp + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_clean diff --git a/Examples/scilab/enum/example.cxx b/Examples/scilab/enum/example.cxx new file mode 100644 index 0000000..6785e57 --- /dev/null +++ b/Examples/scilab/enum/example.cxx @@ -0,0 +1,37 @@ +/* File : example.c */ + +#include "example.h" +#include + +void Foo::enum_test(speed s) { + if (s == IMPULSE) { + printf("IMPULSE speed\n"); + } else if (s == WARP) { + printf("WARP speed\n"); + } else if (s == LUDICROUS) { + printf("LUDICROUS speed\n"); + } else { + printf("Unknown speed\n"); + } +} + +void enum_test(color c, Foo::speed s) { + if (c == RED) { + printf("color = RED, "); + } else if (c == BLUE) { + printf("color = BLUE, "); + } else if (c == GREEN) { + printf("color = GREEN, "); + } else { + printf("color = Unknown color!, "); + } + if (s == Foo::IMPULSE) { + printf("speed = IMPULSE speed\n"); + } else if (s == Foo::WARP) { + printf("speed = WARP speed\n"); + } else if (s == Foo::LUDICROUS) { + printf("speed = LUDICROUS speed\n"); + } else { + printf("speed = Unknown speed!\n"); + } +} diff --git a/Examples/scilab/enum/example.h b/Examples/scilab/enum/example.h new file mode 100644 index 0000000..525d62a --- /dev/null +++ b/Examples/scilab/enum/example.h @@ -0,0 +1,13 @@ +/* File : example.h */ + +enum color { RED, BLUE, GREEN }; + +class Foo { + public: + Foo() { } + enum speed { IMPULSE, WARP, LUDICROUS }; + void enum_test(speed s); +}; + +void enum_test(color c, Foo::speed s); + diff --git a/Examples/scilab/enum/example.i b/Examples/scilab/enum/example.i new file mode 100644 index 0000000..a9c71c5 --- /dev/null +++ b/Examples/scilab/enum/example.i @@ -0,0 +1,10 @@ +/* File : example.i */ +%module example + +%{ +#include "example.h" +%} + +%include "example.h" + + diff --git a/Examples/scilab/enum/runme.sci b/Examples/scilab/enum/runme.sci new file mode 100644 index 0000000..0895fc3 --- /dev/null +++ b/Examples/scilab/enum/runme.sci @@ -0,0 +1,36 @@ +lines(0); +ilib_verbose(0); +ierr = exec('loader.sce', 'errcatch'); +if ierr <> 0 then + disp(lasterror()); + exit(ierr); +end +example_Init(); + +printf("\nTest enums\n"); +printf("*** color ***\n"); +printf(" RED_get() = %i\n", RED_get()); +printf(" BLUE_get() = %i\n", BLUE_get()); +printf(" GREEN_get() = %i\n", GREEN_get()); + +printf("\n*** Foo::speed ***\n") +printf(" Foo_IMPULSE = %i\n", Foo_IMPULSE_get()); +printf(" Foo_WARP = %i\n", Foo_WARP_get()); +printf(" Foo_LUDICROUS = %i\n", Foo_LUDICROUS_get()); + +printf("\nTest enums as argument of functions\n"); + +enum_test(RED_get(), Foo_IMPULSE_get()); +enum_test(BLUE_get(), Foo_WARP_get()); +enum_test(GREEN_get(), Foo_LUDICROUS_get()); +enum_test(1234, 5678); + +printf("\nTest enums as argument of class methods\n"); + +f = new_Foo(); +Foo_enum_test(f, Foo_IMPULSE_get()); +Foo_enum_test(f, Foo_WARP_get()); +Foo_enum_test(f, Foo_LUDICROUS_get()); +delete_Foo(f); + +exit diff --git a/Examples/scilab/funcptr/Makefile b/Examples/scilab/funcptr/Makefile new file mode 100644 index 0000000..6604d19 --- /dev/null +++ b/Examples/scilab/funcptr/Makefile @@ -0,0 +1,17 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = example.c +TARGET = example +INTERFACE = example.i + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' scilab + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_clean diff --git a/Examples/scilab/funcptr/example.c b/Examples/scilab/funcptr/example.c new file mode 100644 index 0000000..5c4a3da --- /dev/null +++ b/Examples/scilab/funcptr/example.c @@ -0,0 +1,19 @@ +/* File : example.c */ + +int do_op(int a, int b, int (*op)(int,int)) { + return (*op)(a,b); +} + +int add(int a, int b) { + return a+b; +} + +int sub(int a, int b) { + return a-b; +} + +int mul(int a, int b) { + return a*b; +} + +int (*funcvar)(int,int) = add; diff --git a/Examples/scilab/funcptr/example.h b/Examples/scilab/funcptr/example.h new file mode 100644 index 0000000..9936e24 --- /dev/null +++ b/Examples/scilab/funcptr/example.h @@ -0,0 +1,9 @@ +/* file: example.h */ + +extern int do_op(int,int, int (*op)(int,int)); +extern int add(int,int); +extern int sub(int,int); +extern int mul(int,int); + +extern int (*funcvar)(int,int); + diff --git a/Examples/scilab/funcptr/example.i b/Examples/scilab/funcptr/example.i new file mode 100644 index 0000000..e8af50e --- /dev/null +++ b/Examples/scilab/funcptr/example.i @@ -0,0 +1,11 @@ +/* File : example.i */ +%module example +%{ +#include "example.h" +%} + +/* Wrap a function taking a pointer to a function */ +extern int do_op(int a, int b, int (*op)(int, int)); + +extern int (*funcvar)(int,int); + diff --git a/Examples/scilab/funcptr/runme.sci b/Examples/scilab/funcptr/runme.sci new file mode 100644 index 0000000..d3cbed3 --- /dev/null +++ b/Examples/scilab/funcptr/runme.sci @@ -0,0 +1,22 @@ +lines(0); +ilib_verbose(0); +ierr = exec('loader.sce', 'errcatch'); +if ierr <> 0 then + disp(lasterror()); + exit(ierr); +end + +a = 37 +b = 42 + +// Now call our C function with a bunch of callbacks + +printf("Trying some C callback functions\n"); +printf(" a = %i\n", a); +printf(" b = %i\n", b); +printf(" ADD(a,b) = %i\n", do_op(a,b,funcvar_get())); + +exit + + + diff --git a/Examples/scilab/matrix/Makefile b/Examples/scilab/matrix/Makefile new file mode 100644 index 0000000..6604d19 --- /dev/null +++ b/Examples/scilab/matrix/Makefile @@ -0,0 +1,17 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = example.c +TARGET = example +INTERFACE = example.i + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' scilab + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_clean diff --git a/Examples/scilab/matrix/example.c b/Examples/scilab/matrix/example.c new file mode 100644 index 0000000..6ce1009 --- /dev/null +++ b/Examples/scilab/matrix/example.c @@ -0,0 +1,61 @@ +/* FILE : matrix.c : some simple 4x4 matrix operations */ +#include +#include + +double **new_matrix() { + + int i; + double **M; + + M = (double **) malloc(4*sizeof(double *)); + M[0] = (double *) malloc(16*sizeof(double)); + + for (i = 0; i < 4; i++) { + M[i] = M[0] + 4*i; + } + return M; +} + +void destroy_matrix(double **M) { + + free(M[0]); + free(M); + +} + +void print_matrix(double **M) { + + int i,j; + + for (i = 0; i < 4; i++) { + for (j = 0; j < 4; j++) { + printf("%10g ", M[i][j]); + } + printf("\n"); + } + +} + +void mat_mult(double **m1, double **m2, double **m3) { + + int i,j,k; + double temp[4][4]; + + for (i = 0; i < 4; i++) + for (j = 0; j < 4; j++) { + temp[i][j] = 0; + for (k = 0; k < 4; k++) + temp[i][j] += m1[i][k]*m2[k][j]; + } + + for (i = 0; i < 4; i++) + for (j = 0; j < 4; j++) + m3[i][j] = temp[i][j]; +} + + + + + + + diff --git a/Examples/scilab/matrix/example.i b/Examples/scilab/matrix/example.i new file mode 100644 index 0000000..c930e92 --- /dev/null +++ b/Examples/scilab/matrix/example.i @@ -0,0 +1,36 @@ +%module example +// FILE : matrix.i + +%{ + +void set_m(double **M, int i, int j, double val) { + M[i][j] = val; +} + +double get_m(double **M, int i, int j) { + return M[i][j]; +} +%} + +%inline { +/*** Matrix Operations ***/ + +extern double **new_matrix(); +/* Creates a new matrix and returns a pointer to it */ + +extern void destroy_matrix(double **M); +/* Destroys the matrix M */ + +extern void print_matrix(double **M); +/* Prints out the matrix M */ + +extern void set_m(double **M, int i, int j, double val); +/* Sets M[i][j] = val*/ + +extern double get_m(double **M, int i, int j); +/* Returns M[i][j] */ + +extern void mat_mult(double **a, double **b, double **c); +/* Multiplies matrix a by b and places the result in c*/ + +} diff --git a/Examples/scilab/matrix/runme.sci b/Examples/scilab/matrix/runme.sci new file mode 100644 index 0000000..26943b1 --- /dev/null +++ b/Examples/scilab/matrix/runme.sci @@ -0,0 +1,43 @@ +lines(0); +ilib_verbose(0); +ierr = exec('loader.sce', 'errcatch'); +if ierr <> 0 then + disp(lasterror()); + exit(ierr); +end + +// create a new matrix +x = new_matrix(); +for i = 0 : 3; + for j = 0 : 3; + set_m(x, i, j, i+j); + end; +end; + +// print the matrix +print_matrix(x); + +// another matrix +y = new_matrix(); + for i = 0 : 3; + for j = 0 : 3; + set_m(y, i, j, i-j); + end; + end; + +// print the matrix +print_matrix(y); + +// mat_mult the two matrix, and the result is stored in a new matrix +z = new_matrix(); + +mat_mult(x, y, z); + +print_matrix(z); + +//destroy the matrix +destroy_matrix(x); +destroy_matrix(y); +destroy_matrix(z); + +exit diff --git a/Examples/scilab/matrix2/Makefile b/Examples/scilab/matrix2/Makefile new file mode 100644 index 0000000..6604d19 --- /dev/null +++ b/Examples/scilab/matrix2/Makefile @@ -0,0 +1,17 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = example.c +TARGET = example +INTERFACE = example.i + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' scilab + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_clean diff --git a/Examples/scilab/matrix2/example.c b/Examples/scilab/matrix2/example.c new file mode 100644 index 0000000..476067d --- /dev/null +++ b/Examples/scilab/matrix2/example.c @@ -0,0 +1,118 @@ +#include +#include +#include + + +// Double matrix functions + +double sumDoubleMatrix(double *inputMatrix, int nbRow, int nbCol) +{ + int i; + double total = 0.0; + for (i=0; i myMatrix=[ 103 3 1 12;0 0 2043 1]; + * --> sumitems(myMatrix); + * 32 + */ + double B[] = {1,3,4,9,2,8,3,2}; /* Declare the matrix */ + int rowB = 2, colB = 4; + printf("sumitems: %6.2f\n",sumitems(B, rowB, colB)); + + +/** + * --> myOtherMatrix=generateValues(); + * --> size(myOtherMatrix); + */ + int numberRow, numberCol, i; + double * matrix=getValues(&numberRow, &numberCol); + printf("Matrix of size [%d,%d]",numberRow, numberCol); + for(i=0; i < numberRow*numberCol; i++) + { + printf("A[%d] = %5.2f\n",i,matrix[i]); + } +} diff --git a/Examples/scilab/matrix2/runme.sci b/Examples/scilab/matrix2/runme.sci new file mode 100644 index 0000000..0af7df4 --- /dev/null +++ b/Examples/scilab/matrix2/runme.sci @@ -0,0 +1,51 @@ +lines(0); +ilib_verbose(0); +ierr = exec('loader.sce', 'errcatch'); +if ierr <> 0 then + disp(lasterror()); + exit(ierr); +end + +// Test lib double matrix functions +disp("Call lib function getDoubleMatrix()"); +doubleMatrix = getDoubleMatrix(); +disp(doubleMatrix); + +disp("Call lib function sumDoubleMatrix()"); +s = sumDoubleMatrix(doubleMatrix); +disp(s); + +disp("Call lib function squareDoubleMatrix()"); +sqrd = squareDoubleMatrix(doubleMatrix); +disp(sqrd); + + +// Test lib integer matrix functions + +disp("Call lib function getIntegerMatrix()"); +integerMatrix = getIntegerMatrix(); +disp(integerMatrix); + +disp("Call lib function sumIntegerMatrix()"); +s = sumIntegerMatrix(integerMatrix); +disp(s); + +disp("Call lib function squareIntegerMatrix()"); +sqri = squareIntegerMatrix(integerMatrix); +disp(sqri); + + +// Test lib string matrix functions + +disp("Call lib function getStringVector()"); +stringVector = getStringVector(); +disp(stringVector); + +disp("Call lib function concatStringVector()"); +stringVector2 = concatStringVector(stringVector); +disp(stringVector2); + +exit + + + diff --git a/Examples/scilab/pointer/Makefile b/Examples/scilab/pointer/Makefile new file mode 100644 index 0000000..9ce2685 --- /dev/null +++ b/Examples/scilab/pointer/Makefile @@ -0,0 +1,17 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = example.c +TARGET = example +INTERFACE = example.i + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' scilab + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_clean diff --git a/Examples/scilab/pointer/example.c b/Examples/scilab/pointer/example.c new file mode 100644 index 0000000..b877d9a --- /dev/null +++ b/Examples/scilab/pointer/example.c @@ -0,0 +1,16 @@ +/* File : example.c */ + +void add(int *x, int *y, int *result) { + *result = *x + *y; +} + +void sub(int *x, int *y, int *result) { + *result = *x - *y; +} + +int divide(int n, int d, int *r) { + int q; + q = n/d; + *r = n - q*d; + return q; +} diff --git a/Examples/scilab/pointer/example.i b/Examples/scilab/pointer/example.i new file mode 100644 index 0000000..a8ac794 --- /dev/null +++ b/Examples/scilab/pointer/example.i @@ -0,0 +1,30 @@ +/* File : example.i */ +%module example + +%{ +extern void add(int *, int *, int *); +extern void sub(int *, int *, int *); +extern int divide(int, int, int *); +%} + +/* This example illustrates a couple of different techniques + for manipulating C pointers */ + +/* First we'll use the pointer library */ +extern void add(int *x, int *y, int *result); +%include cpointer.i +%pointer_functions(int, intp); + +/* Next we'll use some typemaps */ + +%include typemaps.i +extern void sub(int *INPUT, int *INPUT, int *OUTPUT); + +/* Next we'll use typemaps and the %apply directive */ + +%apply int *OUTPUT { int *r }; +extern int divide(int n, int d, int *r); + + + + diff --git a/Examples/scilab/pointer/runme.sci b/Examples/scilab/pointer/runme.sci new file mode 100644 index 0000000..3400ab3 --- /dev/null +++ b/Examples/scilab/pointer/runme.sci @@ -0,0 +1,47 @@ +lines(0); +ilib_verbose(0); +ierr = exec('loader.sce', 'errcatch'); +if ierr <> 0 then + disp(lasterror()); + exit(ierr); +end + +// First create some objects using the pointer library. +printf("Testing the pointer library\n") +a = new_intp(); +b = new_intp(); +c = new_intp(); // Memory for result + +intp_assign(a, 37); +intp_assign(b, 42); + +printf(" a = %d\n", intp_value(a)); +printf(" b = %d\n", intp_value(b)); +printf(" c = %d\n", intp_value(c)); + +// Call the add() function with some pointers +add(a, b, c); + +// Now get the result +r = intp_value(c); +printf(" 37 + 42 = %d\n", r); + +// Clean up the pointers +delete_intp(a); +delete_intp(b); +delete_intp(c); + +// Now try the typemap library +// This should be much easier. Now how it is no longer +// necessary to manufacture pointers. +printf("Trying the typemap library\n"); +r = sub(37, 42); +printf(" 37 - 42 = %d\n", r); + +// Now try the version with multiple return values +printf("Testing multiple return values\n"); +[q, r] = divide(42, 37); +printf(" 42/37 = %d remainder %d\n", q, r); + +exit + diff --git a/Examples/scilab/simple/Makefile b/Examples/scilab/simple/Makefile new file mode 100644 index 0000000..6604d19 --- /dev/null +++ b/Examples/scilab/simple/Makefile @@ -0,0 +1,17 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = example.c +TARGET = example +INTERFACE = example.i + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' scilab + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_clean diff --git a/Examples/scilab/simple/example.c b/Examples/scilab/simple/example.c new file mode 100644 index 0000000..1c2af78 --- /dev/null +++ b/Examples/scilab/simple/example.c @@ -0,0 +1,18 @@ +/* File : example.c */ + +/* A global variable */ +double Foo = 3.0; + +/* Compute the greatest common divisor of positive integers */ +int gcd(int x, int y) { + int g; + g = y; + while (x > 0) { + g = x; + x = y % x; + y = g; + } + return g; +} + + diff --git a/Examples/scilab/simple/example.i b/Examples/scilab/simple/example.i new file mode 100644 index 0000000..24093b9 --- /dev/null +++ b/Examples/scilab/simple/example.i @@ -0,0 +1,7 @@ +/* File : example.i */ +%module example + +%inline %{ +extern int gcd(int x, int y); +extern double Foo; +%} diff --git a/Examples/scilab/simple/runme.sci b/Examples/scilab/simple/runme.sci new file mode 100644 index 0000000..ed8b0f6 --- /dev/null +++ b/Examples/scilab/simple/runme.sci @@ -0,0 +1,29 @@ +lines(0); +ilib_verbose(0); +ierr = exec('loader.sce', 'errcatch'); +if ierr <> 0 then + disp(lasterror()); + exit(ierr); +end + +// Call our gcd() function + +x = 42; +y = 105; +g = gcd(x,y); +printf("The gcd of %d and %d is %d\n",x,y,g); + +// Manipulate the Foo global variable + +// Get its default value (see in example.c) +defaultValue = Foo_get() +if defaultValue <> 3 then pause; end + +// Change its value +Foo_set(3.1415926) + +// See if the change took effect +if Foo_get() <> 3.1415926 then pause,end + +exit + diff --git a/Examples/scilab/std_list/Makefile b/Examples/scilab/std_list/Makefile new file mode 100644 index 0000000..40c97a5 --- /dev/null +++ b/Examples/scilab/std_list/Makefile @@ -0,0 +1,17 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = example.cxx +TARGET = example +INTERFACE = example.i + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' scilab_cpp + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_clean diff --git a/Examples/scilab/std_list/example.cxx b/Examples/scilab/std_list/example.cxx new file mode 100644 index 0000000..e58d6a3 --- /dev/null +++ b/Examples/scilab/std_list/example.cxx @@ -0,0 +1,61 @@ +/* File : example.cpp */ + +#include "example.h" + +#include +#include +#include +#include +#include + + +template +std::list concat_list(const std::list list, const std::list other_list) +{ + std::list out_list(list); + out_list.insert(out_list.end(), other_list.begin(), other_list.end()); + return out_list; +} + +// int lists + +std::list create_integer_list(const int rangemin, const int rangemax) +{ + std::list out_list; + for (int i = rangemin; i <= rangemax; i++) + { + out_list.push_back(i); + } + return out_list; +} + +int sum_integer_list(const std::list& list) +{ + return std::accumulate(list.begin(), list.end(), 0); +} + +std::list concat_integer_list(const std::list list, const std::list other_list) +{ + return concat_list(list, other_list); +} + +// string lists + +std::list create_string_list(const char* svalue) +{ + std::list out_list; + std::string str(svalue); + + std::istringstream iss(str); + std::copy(std::istream_iterator(iss), + std::istream_iterator(), + std::inserter >(out_list, out_list.begin())); + + return out_list; +} + +std::list concat_string_list(const std::list list, const std::list other_list) +{ + return concat_list(list, other_list); +} + diff --git a/Examples/scilab/std_list/example.h b/Examples/scilab/std_list/example.h new file mode 100644 index 0000000..769627e --- /dev/null +++ b/Examples/scilab/std_list/example.h @@ -0,0 +1,14 @@ +/* File : example.h */ + +#include +#include + + +// integer lists +std::list create_integer_list(const int size, const int value); +int sum_integer_list(const std::list& list); +std::list concat_integer_list(const std::list list, const std::list other_list); + +// string lists +std::list create_string_list(const char* value); +std::list concat_string_list(const std::list list, const std::list other_list); diff --git a/Examples/scilab/std_list/example.i b/Examples/scilab/std_list/example.i new file mode 100644 index 0000000..dbe2a73 --- /dev/null +++ b/Examples/scilab/std_list/example.i @@ -0,0 +1,19 @@ +/* File : example.i */ + +%module example + +%{ +#include "example.h" +%} + +%include stl.i +%include std_list.i + +/* instantiate the required template specializations */ +namespace std +{ + %template(IntList) list; + %template(StringList) list; +} + +%include "example.h" diff --git a/Examples/scilab/std_list/runme.sci b/Examples/scilab/std_list/runme.sci new file mode 100644 index 0000000..e4c04b0 --- /dev/null +++ b/Examples/scilab/std_list/runme.sci @@ -0,0 +1,39 @@ +lines(0); +ilib_verbose(0); +ierr = exec('loader.sce', 'errcatch'); +if ierr <> 0 then + disp(lasterror()); + exit(ierr); +end +example_Init(); + +// This example shows how to use C++ fonctions with STL lists arguments +// Here, STL lists are converted from/to Scilab matrices (SWIG_SCILAB_EXTRA_NATIVE_CONTAINERS is not defined) + +// integer lists + +disp("Example of passing matrices of int as list arguments of C++ functions."); +disp("get a list of int {1...4} from create_integer_list():"); +is = create_integer_list(1, 4); +disp(is); +disp("get the sum of this list elements with sum_integer_list():") +sum = sum_integer_list(is); +disp(is); +is2 = create_integer_list(3, 6); +disp("concat this list with the list of int {3...6} with concat_integer_list():"); +is3 = concat_integer_list(is, is2); +disp(is3); + +// string lists + +disp("Example of passing matrices of string as list arguments of C++ functions."); +disp("get a list of string {''aa'', ''bb'', ''cc'', ''dd''} with create_string_list():"); +ss = create_string_list("aa bb cc dd"); +disp(ss); +ss2 = create_string_list("cc dd ee ff"); +disp("concat this list with the list of string {''cc'', ''dd'', ''ee'', ''ff''} with concat_string_list():"); +ss3 = concat_string_list(ss, ss2); +disp(ss3); + +exit + diff --git a/Examples/scilab/std_vector/Makefile b/Examples/scilab/std_vector/Makefile new file mode 100644 index 0000000..490ac73 --- /dev/null +++ b/Examples/scilab/std_vector/Makefile @@ -0,0 +1,17 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = +TARGET = example +INTERFACE = example.i + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' scilab_cpp + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_clean diff --git a/Examples/scilab/std_vector/example.h b/Examples/scilab/std_vector/example.h new file mode 100644 index 0000000..4f0dac7 --- /dev/null +++ b/Examples/scilab/std_vector/example.h @@ -0,0 +1,25 @@ +/* File : example.h */ + +#include +#include +#include +#include + +double average(std::vector v) { + return std::accumulate(v.begin(),v.end(),0.0)/v.size(); +} + +std::vector half(const std::vector& v) { + std::vector w(v); + for (unsigned int i=0; i& v) { + // would you believe this is the same as the above? + std::transform(v.begin(),v.end(),v.begin(), + std::bind2nd(std::divides(),2.0)); +} + + diff --git a/Examples/scilab/std_vector/example.i b/Examples/scilab/std_vector/example.i new file mode 100644 index 0000000..1ba9e92 --- /dev/null +++ b/Examples/scilab/std_vector/example.i @@ -0,0 +1,19 @@ +/* File : example.i */ +%module example + +%warnfilter(SWIGWARN_SCILAB_TRUNCATED_NAME) std::vector::get_allocator; + +%{ +#include "example.h" +%} + +%include stl.i +/* instantiate the required template specializations */ +namespace std { + %template(IntVector) vector; + %template(DoubleVector) vector; +} + +/* Let's just grab the original header file here */ +%include "example.h" + diff --git a/Examples/scilab/std_vector/runme.sci b/Examples/scilab/std_vector/runme.sci new file mode 100644 index 0000000..3e56945 --- /dev/null +++ b/Examples/scilab/std_vector/runme.sci @@ -0,0 +1,37 @@ +lines(0); +ilib_verbose(0); +ierr = exec('loader.sce', 'errcatch'); +if ierr <> 0 then + disp(lasterror()); + exit(ierr); +end +example_Init(); + + +disp(mean([1,2,3,4])); + +// ... or a wrapped std::vector + +v = new_IntVector(); +for i = 1:4 + IntVector_push_back(v, i); +end; +disp(average(v)); + + +// half will return a Scilab matrix. +// Call it with a Scilab matrix... + +disp(half([1.0, 1.5, 2.0, 2.5, 3.0])); + + +// ... or a wrapped std::vector + +v = new_DoubleVector(); +for i = 1:4 + DoubleVector_push_back(v, i); +end; +disp(half(v)); + +exit + diff --git a/Examples/scilab/struct/Makefile b/Examples/scilab/struct/Makefile new file mode 100644 index 0000000..9f8b7e8 --- /dev/null +++ b/Examples/scilab/struct/Makefile @@ -0,0 +1,17 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = +TARGET = example +INTERFACE = example.i + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SRCDIR='$(SRCDIR)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' scilab + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_clean diff --git a/Examples/scilab/struct/example.i b/Examples/scilab/struct/example.i new file mode 100644 index 0000000..af2cd3f --- /dev/null +++ b/Examples/scilab/struct/example.i @@ -0,0 +1,11 @@ +%module example + +%rename(Bar) Foo; + +%inline %{ +typedef struct { + int x; +} Foo; + +%} + diff --git a/Examples/scilab/struct/runme.sci b/Examples/scilab/struct/runme.sci new file mode 100644 index 0000000..4d47ef0 --- /dev/null +++ b/Examples/scilab/struct/runme.sci @@ -0,0 +1,18 @@ +lines(0); +ilib_verbose(0); +ierr = exec('loader.sce', 'errcatch'); +if ierr <> 0 then + disp(lasterror()); + exit(ierr); +end + +// Test use of a struct (Bar) + +a = new_Bar(); + +Bar_x_set(a, 100); +printf("a.x = %d (Should be 100)\n", Bar_x_get(a)); + +delete_Bar(a); + +exit diff --git a/Examples/scilab/template/Makefile b/Examples/scilab/template/Makefile new file mode 100644 index 0000000..490ac73 --- /dev/null +++ b/Examples/scilab/template/Makefile @@ -0,0 +1,17 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +CXXSRCS = +TARGET = example +INTERFACE = example.i + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' scilab_cpp + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_clean diff --git a/Examples/scilab/template/example.h b/Examples/scilab/template/example.h new file mode 100644 index 0000000..7401df6 --- /dev/null +++ b/Examples/scilab/template/example.h @@ -0,0 +1,32 @@ +/* File : example.h */ + +// Some template definitions + +template T max(T a, T b) { return a>b ? a : b; } + +template class vector { + T *v; + int sz; + public: + vector(int _sz) { + v = new T[_sz]; + sz = _sz; + } + T &get(int index) { + return v[index]; + } + void set(int index, T &val) { + v[index] = val; + } +#ifdef SWIG + %extend { + T getitem(int index) { + return $self->get(index); + } + void setitem(int index, T val) { + $self->set(index,val); + } + } +#endif +}; + diff --git a/Examples/scilab/template/example.i b/Examples/scilab/template/example.i new file mode 100644 index 0000000..8f94c4d --- /dev/null +++ b/Examples/scilab/template/example.i @@ -0,0 +1,17 @@ +/* File : example.i */ +%module example + +%{ +#include "example.h" +%} + +/* Let's just grab the original header file here */ +%include "example.h" + +/* Now instantiate some specific template declarations */ + +%template(maxint) max; +%template(maxdouble) max; +%template(vecint) vector; +%template(vecdouble) vector; + diff --git a/Examples/scilab/template/runme.sci b/Examples/scilab/template/runme.sci new file mode 100644 index 0000000..35ca9d1 --- /dev/null +++ b/Examples/scilab/template/runme.sci @@ -0,0 +1,45 @@ +lines(0); +ilib_verbose(0); +ierr = exec('loader.sce', 'errcatch'); +if ierr <> 0 then + disp(lasterror()); + exit(ierr); +end +example_Init(); + +// Call some templated functions +printf("maxint(3, 7) = %i\n", maxint(3, 7)); +printf("maxdouble(3.14, 2.18) = %3.2f\n", maxdouble(3.14, 2.18)); + +// Create some class + +iv = new_vecint(100); +dv = new_vecdouble(1000); + +for i = 0:100 + vecint_setitem(iv, i, 2*i); +end + +for i = 0:100 + vecdouble_setitem(dv, i, 1.0/(i+1)); +end + +isum = 0 +for i = 0:100 + isum = isum + vecint_getitem(iv, i); +end + +printf("isum = %i\n", isum); + +dsum = 0 +for i = 0:100 + dsum = dsum + vecdouble_getitem(dv, i); +end + +printf("dsum = %3.2f\n", dsum); + +delete_vecint(iv); +delete_vecdouble(dv); + +exit + diff --git a/Examples/scilab/variables/Makefile b/Examples/scilab/variables/Makefile new file mode 100644 index 0000000..6604d19 --- /dev/null +++ b/Examples/scilab/variables/Makefile @@ -0,0 +1,17 @@ +TOP = ../.. +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib +SRCS = example.c +TARGET = example +INTERFACE = example.i + +check: build + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_run + +build: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' SRCS='$(SRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ + TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' scilab + +clean: + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' scilab_clean diff --git a/Examples/scilab/variables/example.c b/Examples/scilab/variables/example.c new file mode 100644 index 0000000..9f88d90 --- /dev/null +++ b/Examples/scilab/variables/example.c @@ -0,0 +1,95 @@ +/* File : example.c */ + +/* I'm a file containing some C global variables */ + +/* Deal with Microsoft's attempt at deprecating C standard runtime functions */ +#if !defined(SWIG_NO_CRT_SECURE_NO_DEPRECATE) && defined(_MSC_VER) +# define _CRT_SECURE_NO_DEPRECATE +#endif + +#include +#include +#include "example.h" + +int ivar = 0; +short svar = 0; +long lvar = 0; +unsigned int uivar = 0; +unsigned short usvar = 0; +unsigned long ulvar = 0; +signed char scvar = 0; +unsigned char ucvar = 0; +char cvar = 0; +float fvar = 0; +double dvar = 0; +char *strvar = 0; +const char cstrvar[] = "Goodbye"; +int *iptrvar = 0; +char name[256] = "Dave"; +char path[256] = "/home/beazley"; + + +/* Global variables involving a structure */ +Point *ptptr = 0; +Point pt = { 10, 20 }; + +/* A variable that we will make read-only in the interface */ +int status = 1; + +/* A debugging function to print out their values */ + +void print_vars() { + printf("ivar = %d\n", ivar); + printf("svar = %d\n", svar); + printf("lvar = %ld\n", lvar); + printf("uivar = %u\n", uivar); + printf("usvar = %u\n", usvar); + printf("ulvar = %lu\n", ulvar); + printf("scvar = %d\n", scvar); + printf("ucvar = %u\n", ucvar); + printf("fvar = %g\n", fvar); + printf("dvar = %g\n", dvar); + printf("cvar = %c\n", cvar); + printf("strvar = %s\n", strvar ? strvar : "(null)"); + printf("cstrvar = %s\n", cstrvar); + printf("iptrvar = %p\n", (void *)iptrvar); + printf("name = %s\n", name); + printf("ptptr = %p (%d, %d)\n", (void *)ptptr, ptptr ? ptptr->x : 0, ptptr ? ptptr->y : 0); + printf("pt = (%d, %d)\n", pt.x, pt.y); + printf("status = %d\n", status); +} + +/* A function to create an integer (to test iptrvar) */ + +int *new_int(int value) { + int *ip = (int *) malloc(sizeof(int)); + *ip = value; + return ip; +} + +int value_int(int *value) { + return *value; +} + +/* A function to create a point */ + +Point *new_Point(int x, int y) { + Point *p = (Point *) malloc(sizeof(Point)); + p->x = x; + p->y = y; + return p; +} + +char * Point_print(Point *p) { + static char buffer[256]; + if (p) { + sprintf(buffer,"(%d,%d)", p->x,p->y); + } else { + sprintf(buffer,"null"); + } + return buffer; +} + +void pt_print() { + printf("(%d, %d)\n", pt.x, pt.y); +} diff --git a/Examples/scilab/variables/example.h b/Examples/scilab/variables/example.h new file mode 100644 index 0000000..0f7e895 --- /dev/null +++ b/Examples/scilab/variables/example.h @@ -0,0 +1,6 @@ +/* File: example.h */ + +typedef struct { + int x,y; +} Point; + diff --git a/Examples/scilab/variables/example.i b/Examples/scilab/variables/example.i new file mode 100644 index 0000000..97ba1f0 --- /dev/null +++ b/Examples/scilab/variables/example.i @@ -0,0 +1,52 @@ +/* File : example.i */ +%module example +%{ +#include "example.h" +%} + +#pragma SWIG nowarn=SWIGWARN_TYPEMAP_SWIGTYPELEAK + +/* Some global variable declarations */ +%inline %{ +extern int ivar; +extern short svar; +extern long lvar; +extern unsigned int uivar; +extern unsigned short usvar; +extern unsigned long ulvar; +extern signed char scvar; +extern unsigned char ucvar; +extern char cvar; +extern float fvar; +extern double dvar; +extern char *strvar; +extern const char cstrvar[]; +extern int *iptrvar; +extern char name[256]; + +extern Point *ptptr; +extern Point pt; +%} + + +/* Some read-only variables */ + +%immutable; + +%inline %{ +extern int status; +extern char path[256]; +%} + +%mutable; + +/* Some helper functions to make it easier to test */ +%inline %{ +extern void print_vars(); +extern int *new_int(int value); +extern int value_int(int *value); +extern Point *new_Point(int x, int y); +extern char *Point_print(Point *p); +extern void pt_print(); +%} + diff --git a/Examples/scilab/variables/runme.sci b/Examples/scilab/variables/runme.sci new file mode 100644 index 0000000..98d76cf --- /dev/null +++ b/Examples/scilab/variables/runme.sci @@ -0,0 +1,73 @@ +lines(0); +ilib_verbose(0); +ierr = exec('loader.sce', 'errcatch'); +if ierr <> 0 then + disp(lasterror()); + exit(ierr); +end + +// Try to set the values of some global variables +ivar_set(42); +svar_set(-31000); +lvar_set(65537); +uivar_set(uint32(123456)); +usvar_set(uint16(61000)); +ulvar_set(654321); +scvar_set(int8(-13)); +ucvar_set(uint8(251)); +cvar_set("S"); +fvar_set(3.14159); +dvar_set(2.1828); +strvar_set("Hello World"); +iptrvar_set(new_int(37)); +ptptr_set(new_Point(37,42)); +name_set("Bill"); + +// Now print out the values of the variables +printf("Variables (values printed from Scilab)\n"); +printf("ivar = %i\n", ivar_get()); +printf("svar = %i\n", svar_get()); +printf("lvar = %i\n", lvar_get()); +printf("uivar = %i\n", uivar_get()); +printf("usvar = %i\n", usvar_get()); +printf("ulvar = %i\n", ulvar_get()); +printf("scvar = %i\n", scvar_get()); +printf("ucvar = %i\n", ucvar_get()); +printf("fvar = %f\n", fvar_get()); +printf("dvar = %f\n", dvar_get()); +printf("cvar = %s\n", cvar_get()); +printf("strvar = %s\n", strvar_get()); +printf("cstrvar = %s\n", cstrvar_get()); +printf("iptrvar = %i\n", value_int(iptrvar_get())); +printf("name = %s\n", name_get()); +printf("ptptr = %s\n", Point_print(ptptr_get())); +printf("pt = %s\n", Point_print(pt_get())); +printf("status = %d\n", status_get()); + +printf("\nVariables (values printed from C)\n"); +print_vars() + +// Immutable variables +printf("\nNow I''m going to try and modify some read only variables\n"); +printf(" Tring to set ''path''\n"); +try + path_set("Whoa!"); + printf("Hey, what''s going on?!?! This shouldn''t work\n"); +catch + printf("Good.\n"); +end +printf(" Trying to set ''status''\n"); +try + status_set(0); + printf("Hey, what''s going on?!?! This shouldn''t work\n"); +catch + printf("Good.\n"); +end + +// Structure +printf("\nI''m going to try and update a structure variable.\n"); +pt_set(ptptr_get()); +printf("The new value is %s\n", Point_print(pt_get())); + +exit + diff --git a/Examples/tcl/class/Makefile b/Examples/tcl/class/Makefile index db6149c..3fd77cf 100644 --- a/Examples/tcl/class/Makefile +++ b/Examples/tcl/class/Makefile @@ -1,20 +1,23 @@ TOP = ../.. -SWIG = $(TOP)/../preinst-swig +SWIGEXE = $(TOP)/../swig +SWIG_LIB_DIR = $(TOP)/../$(TOP_BUILDDIR_TO_TOP_SRCDIR)Lib CXXSRCS = example.cxx TARGET = example INTERFACE = example.i LIBS = -lm check: build - $(MAKE) -f $(TOP)/Makefile tcl_run + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' tcl_run build: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' tcl_cpp static: - $(MAKE) -f $(TOP)/Makefile CXXSRCS='$(CXXSRCS)' SWIG='$(SWIG)' \ + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' CXXSRCS='$(CXXSRCS)' \ + SWIG_LIB_DIR='$(SWIG_LIB_DIR)' SWIGEXE='$(SWIGEXE)' \ TARGET='mytclsh' INTERFACE='$(INTERFACE)' tclsh_cpp_static clean: - $(MAKE) -f $(TOP)/Makefile tcl_clean + $(MAKE) -f $(TOP)/Makefile SRCDIR='$(SRCDIR)' tcl_clean diff --git a/Examples/tcl/class/example.cxx b/Examples/tcl/class/example.cxx index 1e8e203..0463045 100644 --- a/Examples/tcl/class/example.cxx +++ b/Examples/tcl/class/example.cxx @@ -1,4 +1,4 @@ -/* File : example.c */ +/* File : example.cxx */ #include "example.h" #define M_PI 3.14159265358979323846 @@ -11,18 +11,18 @@ void Shape::move(double dx, double dy) { int Shape::nshapes = 0; -double Circle::area(void) { +double Circle::area() { return M_PI*radius*radius; } -double Circle::perimeter(void) { +double Circle::perimeter() { return 2*M_PI*radius; } -double Square::area(void) { +double Square::area() { return width*width; } -double Square::perimeter(void) { +double Square::perimeter() { return 4*width; } diff --git a/Examples/tcl/class/example.h b/Examples/tcl/class/example.h index 46d9013..0dff185 100644 --- a/Examples/tcl/class/example.h +++ b/Examples/tcl/class/example.h @@ -7,11 +7,11 @@ public: } virtual ~Shape() { nshapes--; - }; - double x, y; + } + double x, y; void move(double dx, double dy); - virtual double area(void) = 0; - virtual double perimeter(void) = 0; + virtual double area() = 0; + virtual double perimeter() = 0; static int nshapes; }; @@ -19,21 +19,16 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; - virtual double area(void); - virtual double perimeter(void); + Circle(double r) : radius(r) { } + virtual double area(); + virtual double perimeter(); }; class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; - virtual double area(void); - virtual double perimeter(void); + Square(double w) : width(w) { } + virtual double area(); + virtual double perimeter(); }; - - - - - diff --git a/Examples/tcl/class/example.i b/Examples/tcl/class/example.i index 23ee8a8..fbdf724 100644 --- a/Examples/tcl/class/example.i +++ b/Examples/tcl/class/example.i @@ -6,6 +6,4 @@ %} /* Let's just grab the original header file here */ - %include "example.h" - diff --git a/Examples/tcl/class/index.html b/Examples/tcl/class/index.html index fd8cfe5..16dbeea 100644 --- a/Examples/tcl/class/index.html +++ b/Examples/tcl/class/index.html @@ -32,8 +32,8 @@ public: } virtual ~Shape() { nshapes--; - }; - double x, y; + } + double x, y; void move(double dx, double dy); virtual double area() = 0; virtual double perimeter() = 0; @@ -44,7 +44,7 @@ class Circle : public Shape { private: double radius; public: - Circle(double r) : radius(r) { }; + Circle(double r) : radius(r) { } virtual double area(); virtual double perimeter(); }; @@ -53,7 +53,7 @@ class Square : public Shape { private: double width; public: - Square(double w) : width(w) { }; + Square(double w) : width(w) { } virtual double area(); virtual double perimeter(); }; @@ -91,10 +91,10 @@ Note: when creating a C++ extension, you must run SWIG with the -c++ op SWIG performs two forms of C++ wrapping-- a low level interface and a high level widget-like interface.
    • -Click here to see a script that calls the C++ functions using the +Click here to see a script that calls the C++ functions using the low-level interface.
    • -Click here to see a the same script written with the high-level +Click here to see the same script written with the high-level interface.
    @@ -225,47 +225,15 @@ set Shapes_nshapes 13 # Set a static data member

    General Comments

  • KMjD(&L(C@GHY2#!wpuSg|;>?|{QsLkl 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