SWIG-3.0 Documentation SWIG-3.0 Documentation Table of Contents SWIG-3.0 Documentation..................................................................................................................................................................1 Sections...................................................................................................................................................................................1 SWIG Core Documentation............................................................................................................................................1 Language Module Documentation..................................................................................................................................1 Developer Documentation...............................................................................................................................................2 1 Preface...............................................................................................................................................................................................3 1.1 Introduction.......................................................................................................................................................................3 1.2 SWIG Versions.................................................................................................................................................................3 1.3 SWIG License...................................................................................................................................................................3 1.4 SWIG resources................................................................................................................................................................3 1.5 Prerequisites......................................................................................................................................................................4 1.6 Organization of this manual..............................................................................................................................................4 1.7 How to avoid reading the manual.....................................................................................................................................4 1.8 Backwards compatibility..................................................................................................................................................4 1.9 Release notes....................................................................................................................................................................5 1.10 Credits.............................................................................................................................................................................5 1.11 Bug reports......................................................................................................................................................................5 1.12 Installation......................................................................................................................................................................5 1.12.1 Windows installation............................................................................................................................................5 1.12.2 Unix installation...................................................................................................................................................5 1.12.3 Macintosh OS X installation................................................................................................................................6 1.12.4 Testing..................................................................................................................................................................6 1.12.5 Examples..............................................................................................................................................................7 2 Introduction......................................................................................................................................................................................8 2.1 What is SWIG?.................................................................................................................................................................8 2.2 Why use SWIG?...............................................................................................................................................................8 2.3 A SWIG example..............................................................................................................................................................9 2.3.1 SWIG interface file.................................................................................................................................................9 2.3.2 The swig command...............................................................................................................................................10 2.3.3 Building a Perl5 module.......................................................................................................................................10 2.3.4 Building a Python module....................................................................................................................................10 2.3.5 Shortcuts...............................................................................................................................................................11 2.4 Supported C/C++ language features...............................................................................................................................11 2.5 Non-intrusive interface building.....................................................................................................................................12 2.6 Incorporating SWIG into a build system........................................................................................................................12 2.7 Hands off code generation..............................................................................................................................................12 2.8 SWIG and freedom.........................................................................................................................................................13 3 Getting started on Windows..........................................................................................................................................................14 3.1 Installation on Windows.................................................................................................................................................14 3.1.1 Windows Executable............................................................................................................................................14 3.2 SWIG Windows Examples.............................................................................................................................................14 3.2.1 Instructions for using the Examples with Visual Studio......................................................................................14 3.2.1.1 C#...............................................................................................................................................................15 3.2.1.2 Java.............................................................................................................................................................15 3.2.1.3 Perl.............................................................................................................................................................15 3.2.1.4 Python.........................................................................................................................................................15 3.2.1.5 TCL............................................................................................................................................................15 3.2.1.6 R.................................................................................................................................................................15 3.2.1.7 Ruby...........................................................................................................................................................16 3.2.2 Instructions for using the Examples with other compilers...................................................................................16 3.3 SWIG on Cygwin and MinGW......................................................................................................................................16 i SWIG-3.0 Documentation Table of Contents 3 Getting started on Windows 3.3.1 Building swig.exe on Windows............................................................................................................................16 3.3.1.1 Building swig.exe using MinGW and MSYS............................................................................................16 3.3.1.2 Building swig.exe using Cygwin...............................................................................................................17 3.3.1.3 Building swig.exe alternatives...................................................................................................................17