python调用C++之pybind11入门（相互调用）

python调用C/C++有很多的方法，如boost.python, swig, ctypes, pybind11等，这些方法有繁有简，而pybind11的优势是对C++ 11支持很好，API比较简单，如今咱们就简单记下Pybind11的入门操做。

1. pybind11简介与环境安装
pybind11是一个轻量级的只包含头文件的库，它主要是用来在已有的 C++代码的基础上作扩展，它的语法和目标很是像Boost.Python，但Boost.Python为了兼容现有的基本全部的C++编译器而变得很是复杂和庞大，而所以付出的代价是不少晦涩的模板技巧以及不少没必要要的对旧版编译器的支持。Pybind11摒弃了这些支持，它只支持python2.7以上以及C++ 11以上的编译器，使得它比Boost.Python更加简洁高效。
为了使用pybind11，咱们须要支持C++ 11标准的编译器(GCC 4.8以上，VS 2015 Update 3以上)以及python 2.7以上的版本，还须要下载CMake，有了这些之后,
1. 首先，咱们从 pybind11 github网址：https://github.com/pybind/pybind11 上下载源码。
2. cmake工程以前，要先安装pytest pip install pytest，不然会出错
3. 用CMake编译并运行测试用例：

mkdir build
cd build
cmake ..
cmake --build . --config Release --target check
1
2
3
4
若是全部测试用例都经过了，说明安装成功了。

2. python调用C++
下载编译好pybind11以后，咱们就能够开始对着官方的pybind11 Tutorial进行学习了，详细的入门教程及语法请参考官方文档，这里，咱们简单演示下如何编写供python调用的C++模块.
首先，咱们编写一个C++源文件，命名为example.cpp

#include <pybind11/pybind11.h>
namespace py = pybind11;

int add(int i, int j)
{
return i + j;
}

PYBIND11_MODULE(example, m)
{
// optional module docstring
m.doc() = "pybind11 example plugin";
// expose add function, and add keyword arguments and default arguments
m.def("add", &add, "A function which adds two numbers", py::arg("i")=1, py::arg("j")=2);

// exporting variables
m.attr("the_answer") = 42;
py::object world = py::cast("World");
m.attr("what") = world;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
2.1 编译
而后，在windows下使用工具vs2015 x86 Native Tools Command Prompt (由于个人python是32位版本，若是是64位版本的，请使用vs2015 x64 Native Tools Command Prompt)进行编译：

cl example.cpp /I "H:/Allfiles/pybind11/include" /I "C:/Python27/include" /LD /Fe:example.pyd /link/LIBPATH:"C:/python27/libs/"

编译成功后，会在example.cpp相同目录下生成example.pyd文件，这个就是python能够直接导入的库，运行：

import example
example.add(3, 4)

[out]: 7
1
2
3
4
有了编译成功的模块，即可以使用我在另外一篇博客Python模块搜索路径中提到的方法，将其用.pth或者PYTHONPATH的方法加入到python搜索路径，之后在咱们本身的环境中就能够随时随地使用这个模块啦。

2.2 CMake的编译方法
固然，咱们也可使用CMake进行编译。首先写一个CMakeLists.txt

cmake_minimum_required(VERSION 2.8.12)
project(example)

add_subdirectory(pybind11)
pybind11_add_module(example example.cpp)
1
2
3
4
5
这里要求example.cpp放在和pybind11同一级的目录下，而后CMake，便会生成一个vs 2015的工程文件，用vs打开工程文件进行build，就能够生成example.pyd了。

3. C++调用python
使用pybind11，也很容易从C++里调用python脚本：
首先，咱们用vs 2015新建一个工程，而且将Python的包含目录和库目录，以及pybind11的包含目录配置到工程，个人配置以下：

而后，新建一个源文件example.cpp:

#include <pybind11/embed.h>
#include <iostream>

namespace py = pybind11;

int main() {
py::scoped_interpreter python;

//py::module sys = py::module::import("sys");
//py::print(sys.attr("path"));

py::module t = py::module::import("example");
t.attr("add")(1, 2);
return 0;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
最后，在工程目录下加入脚本example.py:

def add(i, j):
print("hello, pybind11")
return i+j
1
2
3
运行工程，获得以下的结果：

运行成功！！！

总结
本文中咱们简单介绍了怎么使用pybind11进行python和C++的相互调用，这些只是入门级别的例子，可是能够work了，这很重要。深刻进行研究使用，仍是等之后用到再说吧。

参考文献pybind11 githubpybind11 TutorialC++与Python的互操做Building and testing a hybrid Python/C++ package--------------------- 做者：fitzzhang 来源：CSDN 原文：https://blog.csdn.net/fitzzhang/article/details/78988682 版权声明：本文为博主原创文章，转载请附上博文连接！