SWIG学习记录（一）SWIG基础

SWIG学习记录

• SWIG官网链接
  SWIG是一种实现将C/C++语言编写的代码移植到其他高级语言编程项目中的开发工具。简而言之，就是将C/C++语言编写的功能封装起来，以供其他高级语言调用。SWIG可用于不同类型的目标语言，包括常见的脚本语言，如Javascript、Perl、PHP、Python、Tcl和Ruby。支持的语言列表还包括非脚本语言，如c#， D, Go语言，Java，包括Android, Lua, OCaml, Octave, Scilab和r。还支持一些解释和编译的Scheme实现(Guile, MzScheme/Racket)。
  SWIG通常用于解析C/ c++接口，并生成上述目标语言调用C/ c++代码所需的“粘合代码”。除此之外，解析树还可以导出为XML。
  SWIG是Simple Wrapper and Interface的缩写，是一个帮助将C++函数接口封装成其他高级语言可调用API的开发工具。在以往，想要为C++代码创建.NET的API，一般情况下，必须使用C++托管(Managed C++)，去写大量托管代码才能生成的。SWIG开发编译工具让这个过程变得简单，你只需要在接口文件中告诉SWIG要为哪些类创建.NET API，SWIG就会自动托管代码，生成.NET API。

  SWIG官网下载swigwin压缩包，然后解压缩到一个目录中。这就是Windows平台需要下载的全部内容。
  2、设置环境变量，以便使用Visual c++运行示例。
  使用Microsoft Visual c++是编译和链接SWIG输出的最常见方法。
  官网下载： 直接在官网下载相应运行环境下的swig版本，我下载的是windows系统下的swigwin。

  
  系统环境变量配置： swig可执行程序运行需要链接到目标语言环境，需要配置系统环境变量，因为SWIG需要找到高级语言的include和库目录。如果你不想使用环境变量，那么就用硬编码的值更改.dsp文件中出现的所有环境变量。
  下表是各类高级语言需要配置的环境变量：

  语言	变量名	变量值	备注
  C#	无	无	C#无序配置环境变量，因为C#项目文件中已包含所需环境路径。
  Java	JAVA_INCLUDE	包含jni.h文件的目录	以JDK1.3为例：D:\jdk1.3\include
  	JAVA_BIN	包含javac.exe执行文件的bin目录	以JDK1.3为例：D:\jdk1.3\bin
  Perl	PERL5_INCLUDE	包含perl.h文件的目录	以nsPerl 5.004_04为例：D:\nsPerl5.004_04\lib\CORE
  	PERL5_LIB	Perl library链接路径	以nsPerl 5.004_04为例：D:\nsPerl5.004_04\lib\CORE\perl.lib
  Python	PYTHON_INCLUDE	包含Python.h文件的目录	以Python 2.1.1为例：D:\python21\include
  	PYTHON_LIB	Python library链接路径	以Python 2.1.1为例：D:\python21\libs\python21.lib

  从官网下载的swigwin-4.0.2压缩包，解压后如下图所示，我们使用其中的开发工具swig.exe。
  
  在解压目录下直接进入cmd，在命令行中运行swig.exe程序，查看帮助信息，可以看到swig可以将C++链接到如下的目标语言。
  

  https://swig.org/Doc4.0/SWIG.html#SWIG，如果想详细了解SWIG接口文件工作机制，可以看看这篇文章。
  查看帮助命令： swig - -help，例如：查询有关C#的帮助信息。

  swig -csharp -help
  

  swig的基本命令形式形如：swig [options] filename，其中filename是SWIG的接口文件或C/C++头文件。[options]是各种可选的SWIG命令参数。
  参数也可以在命令行选项文件(也称为响应文件)中传递，这在超过系统命令行长度限制时很有用。为此，将参数放在一个文件中，然后提供文件名@前缀，就像这样:

  swig @file
  

  文件中的选项由空格分隔。

  C++ Nested classes
  在出现解析错误时，可以使用条件编译跳过违规代码，或者直接从接口文件中删除有问题的代码。
  SWIG不提供完整的c++解析器实现的原因之一是，它被设计为使用不完整的规范，并且在处理C/ C++数据类型时非常宽松(例如，即使缺少类声明或不透明的数据类型，SWIG也可以生成接口)。不幸的是，这种方法使得实现C/ c++解析器的某些部分变得极其困难。