man pages section 1: User Commands

Exit Print View

Updated: July 2014

swig (1)


swig - swig <options> filename


/usr/bin/swig -help   [ For commandline help ]


swig 1.3.35          Last change: 19 Jun 2008                   1

User commands                                             swig(1)

     swig <options> filename

     /usr/bin/swig -help   [ For commandline help ]

     swig - The Simplified Wrapper and Interface Generator (swig)
     is an open source code interface compiler that connects pro-
     grams  written in C and C++ with scripting languages such as
     Perl, Python, Ruby, and Tcl. It works by taking the declara-
     tions found in C/C++ header files and using them to generate
     the wrapper code that scripting languages need to access the
     underlying  C/C++ code. In addition, SWIG provides a variety
     of customization features that let you tailor  the  wrapping
     process to suit your application.

     SWIG is used in a number of ways:

     Building  more  powerful C/C++ programs. Using SWIG, you can
     replace the main() function of a C program with a  scripting
     interpreter from which you can control the application. This
     adds quite a lot of flexibility and makes the program  "pro-
     grammable."  That  is,  the scripting interface allows users
     and developers to easily modifiy the behavior of the program
     without  having to modify low-level C/C++ code. The benefits
     of this are numerous. In fact think  of  all  of  the  large
     software  packages  that  you  use every day---nearly all of
     them include special a macro  language,  configuration  lan-
     guage,  or even a scripting engine that allows users to make

     Rapid prototyping and debugging. SWIG allows C/C++  programs
     to be placed in a scripting environment that can be used for
     testing and debugging. For example, you might test a library
     with  a  collection  of  scripts or use the scripting inter-
     preter as an interactive debugger. Since  SWIG  requires  no
     modifications  to  the underlying C/C++ code, it can be used
     even if the final product does not rely upon scripting.

     Systems integration. Scripting languages  work  fairly  well
     for  controlling  and gluing loosely-coupled software compo-
     nents together. With SWIG, different C/C++ programs  can  be
     turned into scripting language extension modules. These mod-
     ules can then be combined together to create new and  inter-
     esting applications.

     Construction  of  scripting language extension modules. SWIG
     can be used to turn common C/C++ libraries  into  components
     for  use in popular scripting languages. Of course, you will
     still want to make sure that no-one else has already created
     a module before doing this.

swig 1.3.35          Last change: 19 Jun 2008                   1

User commands                                             swig(1)

     See   attributes(5)   for   descriptions  of  the  following

     |Availability   | developer/swig   |
     |Stability      | Volatile         |
     Installed documentation: /usr/share/swig/1.3.35/doc

     Additional online documentation in HTML and PDF formats  for

     User Manual:

     Developer Doc:

     Quick start Tutorial:


     The  Latest  full source download:

     swig was originally written by  Dave  Beazley,  and  is  now
     maintained  and  developed  by  an  team  of developers see:  Further details are avail-
     able  at   swig is released
     under the swig License.

     This  software  was   built   from   source   available   at    The  original
     community source was downloaded from  http://iweb.dl.source-

     Further  information about this software can be found on the
     open source community website at

swig 1.3.35          Last change: 19 Jun 2008                   2