目录
- 一、pybind11简单介绍
- 二、pybind11环境准备
- 1.配置环境说明
- 2.安装pybind11
- 三、python调用C++动态库测试例子
- 1.VS属性配置
- 2.编写绑定文件并测试
- 3.结构体类型的绑定
- 4.其它数据类型
- 四、python调用C++的测试例子
一、pybind11简单介绍
一些python和C++混编方案:
- Python官方的Python/C API, 缺点:所有数据类型必须手动改为Cpython封装的binding类型;
- Cython,编译器支持python代码转为C代码,缺点:移值和复用成本高
- SIWG 主要解决高质量语言与C和C++语言交互难题,支持10几种编程语言如java、python、C等。在python端性能表现不太好
- Boost.Python 为C++中广泛应用的Boost开源库,编译和依赖关系繁重,如果只用于解决python的交互,大材小用了。
- pyind11 领会为Boost.Python的蓝本,基于C++11应用了很多新特性,Pybind11 通过 C++ 编译时的自省来推断类型信息,来最大程度地减少传统拓展 Python 模块时繁杂的样板代码, 且实现了常见数据类型,如 STL 数据结构、智能指针、类、函数重载、实例技巧等到 Python 的自动转换,其中函数可以接收和返回自定义数据类型的值、指针或引用
简言之,Pybind11 一个轻量级的 C++ 库,用于将你的 C++ 代码暴露给 Python 调用(反之也可,但主要还是前者)。Pybind11 借鉴了 Boost::Python 库的设计,但使用了更为简洁的实现方式,保证开发效率和实用性。其帮助文档链接如下:
官方文档:pybind11 documentation
中文版本:安装库 — pybind11 文档
二、pybind11环境准备
1.配置环境说明
window10+ VS2017+python3.10(本电脑安装了Anaconda是python3.10这个环境,也可以使用其它版本,window要求Visual Studio 2017及更新版本)
2.安装pybind11
方式1:直接下载源代码 git cloneGitHub &8211; pybind/pybind11: Seamless operability between C++11 and Python
方式2:直接用pip命令安装:pip install pybind11 或使用 pip3 install pybind11 (pip3同时会下载python3.0+版本)
查看python -m 默认下载路径:
直接指定存放目录的下载方式:
python -m pip install pybind11 –target=D:pythonsite-packages
下载的pybind11目录如下:
三、python调用C++动态库测试例子
底层逻辑:把C++中编写的函数,用pybind封装为调用的pyd库,成功在python中import调用;
说明:pybind11 是只包含头文件的库,因此不需要链接到任何独特的库,也没有中间(magic)转换步骤。win体系上C++编程时只要包含到include路径就行。注意要包含对应的python库目录。
1.VS属性配置
VS2017上新建项目,属性中包含pybind 和python对应的include目录。 我使用的是conda中python3.10因此路径不一样。
附加库目录,增加python的库目录:
添加python的lib库:
在工程属性—>常规—>目标文件扩展名修改为.pyd,配置类型改为.dll
2.编写绑定文件并测试
技巧:使用PYBIND11_MODULE()将所有需要封装的代码都放在里面。
PYBIND11_MODULE()宏创建了一个函数,当 Python 内部发出import语句时将调用该函数。
第一个参数:模块名(testPyd)作为第一个宏参数给出(它不应该在引号中)。
第二个参数:m定义了类型的变量py::module_,它是创建绑定的主接口。
module_::def():会生成绑定代码,将add()函数公开给 Python。
CPP文件如下:
编译生成文件:(生成的文件要和绑定模块名称一致)
其中,pyd文件是生成的动态库,可供给python调用。下面内容为python调用testPyd.pyd的add函数的测试结局:
如图,在python中成功调用add函数。 注意运行时一定要在有testPyd.pyd文件的目录。
3.结构体类型的绑定
在python中测试如下:
上面print(p)的信息没有具体name,可以使用__repr__函数:
4.其它数据类型
可以查看帮助文档,按照上面的方式绑定到模块中。如果C++文件中代码调用了第三方dll库,在python中调用时,需要把dll文件放在py文件运行目录中
四、python调用C++的测试例子
底层逻辑:pybind11 使用C++ 封装了 Python 类型和函数,通过python解释器可以供C++调用
1.编写一个example.py文件:我存放于工程目录子文件夹python_scripts中
2.编写调用example模块的C++main文件:
3.运行测试main代码
记得在属性中把,输出文件格式改为.exe。测试打印结局如下:
结局一致!
4.遗留难题
在初始化python环境时,开始使用的是py::scoped_interpreter guard};初始化技巧,但这个技巧报如下错误,有检测自己的环境配置都是正常,也按初始环境的打印设置了路径,仍未解决。缘故不明,暂时搁置在这里:
引发了未经处理的异常:读取访问权限冲突。
this->m_ptr->ob_type 是 0xFFFFFFFFFFFFFFE7。
到此这篇关于C++/Python混合编程之Pybind11的使用的文章就介绍到这了,更多相关pybind11 c++混合编程python 内容请搜索风君子博客以前的文章或继续浏览下面的相关文章希望大家以后多多支持风君子博客!
无论兄弟们可能感兴趣的文章:
- Python调用C++,通过Pybind11制作Python接口
- pybind11: C++ 工程提供 Python 接口的实例代码
- python使用Pybind11扩展c++的实现