步骤0：swig简介

swig是一种可以将C++代码转换为多种脚本语言封装的工具，可以在swig官网下载，解压后将swig.exe的路径添加到环境变量path中即可使用swig

步骤1：准备C++代码

编写需要在Python中调用的C++代码，最好将函数和类的声明统一放到头文件中，函数和类的实现放到源文件中

C++头文件

头文件主要包括：

  • #include调用（例如#include <iostream>）
  • 命名空间指定using namespace std;
  • 函数和类的声明
1
2
3
4
5
6
7
8
9
10
11
#include <iostream>
using namespace std;

class example {
    private:
        int num;
    public:
        void say_hello(void);
        void change(int din);
        int get_num();
};

C++源文件

源文件为头文件中函数和类的实现

1
2
3
4
5
6
7
8
9
10
11
12
13
#include "example.h"

void example::say_hello(void) {
    cout << "hello python,I am C++" << endl;
}

void example::change(int din) {
    num = din;
}

int example::get_num(void) {
    return num;
}

步骤二：使用swig封装

编写封装说明文件

swig封装需要一个.i后缀文件的封装说明，其中

  • %module <name>为封装名称，Python调用的包名就是<name>
  • %{...%}为附加的函数说明和头文件，源文件以外的部分都要包括在这里，包括头文件和宏定义等
  • 之后为要封装的函数或类，可以直接引用头文件（若已经将要封装的部分的声明写在头文件中）
1
2
3
4
5
6
7
%module Example_swig

%{
#include "example.h"
%}

%include "example.h"

调用swig封装

在命令行中输入swig -python -c++ <swig_config>.i，其中<swig_config>.i为上面写的说明文件

1
swig -python -c++ example.i

调用后生成两个文件：

  • \_wrap.cxx文件
  • \.py文件

步骤三：使用VS编译

安装VC140编译器

python3.5使用的编译器是VC140编译器，对应版本是VS2015，本次使用的是VS2017使用VC141编译器。需要在VS2017中安装VC140编辑器，可以直接在工具->获取工具和功能中安装

配置VS编译环境

在C++的空工程基础上建立环境

配置输出类型

在生成->配置管理器中设置：

  • 活动解决方案配置为Release
  • 活动解决方案平台为X64（本机为64位机）

引入Python库（关键）

在项目->属性中配置Python的库

  • 在VC++目录中的包含目录中，导入Python安装路径下的include路径（包含Python.h）
  • 在链接器->常规的附加库目录中，导入Python安装路径下的libs路径（注意不是Lib路径，包括dll文件）

编译输出

选择生成->生成解决方案，在X64->Release文件夹下有一个dll文件，即为编译输出的动态链接库。将其名称改为_<name>.pyd（本例中为_Example_swig.pyd），将其与swig生成的<name>.py文件放在同一目录中

步骤四：测试调用

在python，使用import <name>即可调用刚才生成的包（同一目录下）

1
2
3
4
5
6
7
import Example_swig

a = Example_swig.example()
a.say_hello()

a.change(3)
print(a.get_num())
1
2
3
hello python,I am C++
3
[Finished in 0.2s]