最强大的跨语言调用生成工具：Swig 快速实用教程

swig是一个生成其他高级语言调用c和C++代码的工具，比如，大家都知道java的jni，可能没写过，因为非常麻烦，swig可以帮助生成这样的代码，编译生成的代码后，它会生成java类和c代码文件。分别编译后，就可以在java中调用c++的库了。

swig非常强大，建议每个程序员都学会它。

swig支持十几种编程语言，包括java,c#,javascript,python等，常见的编程语言都被支持了。

官方基础入门教程：

http://www.swig.org/tutorial.html

看lazy的部分，直接include c++的头文件。一般情况下，是不会自己动手写interface的。

当包含了C++的头文件之后，要使用 -c++,否则无法正确生成代码。

如:

swig -c++ -csharp example.i

1.如何忽略某些方法

有些c和c++的代码，只写了函数声明，但是没有函数的实现，而swig生成的代码会调用这些方法，所以Link的时候会找不到符号。

这种情况，用%ignore

%ignore a::somemethod;

%include xxx.h

会忽略所有名字为a::somemethod的方法。但注意，ignore要放在被包含的头文件解析之前。也就是在%xxx.h前面

2.如何生成namespace

默认情况下，所有的生成的类和结构体，枚举都没有namespace，即使c++代码里面声明了namespace

假如有个c++类叫 MyNameSpace::MyClass

%nspace MyNameSpace::MyClass;//注意行结束要有分号

就可以生成带有namespace的代码了。缺点是每个类都要声明一次。

如果想在所有代码的前面都将上一个namespace,可以这样使用命令行

swig -c++ -csharp -namespace NsPrefix example.i

这样生成的类叫 NsPrefix.MyNameSpace.MyClass

3. DllImport指定Dll名称

可以在使用命令行的时候，加上 -dllimport <name>

补充2个问题，如何映射指针

swig对于指针，默认是不做转换的，它只会把这个类型看作是“某个对象的指针”，比如，char* ,它会生成一个叫SWIGTYPE_p_char的类型，还保存这个指针。语法上是没问题，实际却很难使用，可以说基本没有实用价值。这种情况，要做TypeMap，具体我也研究的不深，只是解决了几个自己用到的问题。

1.原生类型的数组

比如，原来的函数声明是：

void MyFunction(int* data, int length);

%include <arrays_csharp.i>;//这是一个Swig定义好的TypeMap
%apply int FIXED[] {int * data}//data是要作用的参数名
%csmethodmodifiers MyFunction "public unsafe";//如果不加这句，生成的C#函数会因为缺少unsafe而出错，因为它生成的代码是使用fixed，需要unsafe上下文

2.对于stl的类

比如，std::string,希望它映射为c#的string，否则没法处理

这个swig也预定义了TypeMap，只要

%include <stl.i>

就可以了。

3.字符数组 char**

这个希望把它映射为C#的string[],否则没法调用它，这种情况就要自定义TypeMap

CSHARP_ARRAYS(char *, string)
%typemap(imtype, inattributes="[System.Runtime.InteropServices.In,System.Runtime.InteropServices.MarshalAs(System.Runtime.InteropServices.UnmanagedType.LPArray, SizeParamIndex=0, ArraySubType=System.Runtime.InteropServices.UnmanagedType.LPStr)]") char *INPUT[] "string[]"
%apply char *INPUT[] { char * shaderStrings[] }//例子1
%apply char *INPUT[] { char ** s }//例子2，与例1不同，char**和char* []是不同类型，如果写错了会不起作用