用 Boost.Python 写扩展库(1 简介)

最新推荐文章于 2024-08-25 08:44:49 发布
最新推荐文章于 2024-08-25 08:44:49 发布
阅读量2.9k 收藏 2
点赞数
分类专栏： C/C++ 文章标签： 扩展 python html c++ 语言 include
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/bz201/article/details/523624
版权

http://bug.codecarver.org/python/boost.html
Boost.Python 是 Boost 的一个组件。而 Boost 是目前很红火的准 C++ 标准库，它提供了很多组件使得人们可以用 C++ 语言更方便地实现更多的功能。 Boost.Python 就是 Boost 众多组件中的一个。但它是个特例，它的目的不是单纯地增强 C++ 语言的功能，而是希望利用 C++ 语言来增强 Python 语言的能力。使用 Boost.Python 库，我可以方便地将 C++ 语言写的程序库用于 Python 语言，可以用 Python 更好地完成更多的任务。

好吧，我承认，我忘了说很重要的一点。那就是，通过 Boost.Python，我们不仅仅可以用 C++ 来扩展 Python，我们还可以将 Python 嵌入 C++。其实 Python 运行环境本身就提供了一套嵌入 Python 到其它语言的 API，不过是 C 语言写的。有了这套 API，我们就完全可以将 Python 嵌入到 C/C++ 语言程序中去。但是，由于 Python 本身是一门面向对象的、动态类型的语言，还带垃圾收集，而 C 是个面向过程的、静态类型的、不带垃圾收集的程序设计语言。因此，直接使用这套 C API 非常痛苦。 Boost.Python 用面向对象 + 模板的方法将这套 C API 重新包装了一下，我们用起来就清爽多了。不过，目前这个包装还不完善，因此可能还是需要直接使用一部分 Python C API。等它长大了我再来介绍它。

1.1  Boost.Python 的特性

目前 Boost.Python 特性包括：

  • 支持 C++ 引用和指针

  • Globally Registered Type Coercions

  • 自动跨模块类型转换

  • 高效的函数重载

  •  C++ 异常到 Python 异常的转化

  • 参数默认值

  • 关键字参数

  • 在 C++ 程序中访问 Python 语言中的对象

  • 导出 C++ 迭代器为 Python 迭代器

  • 文档字符串

1.2  跟其它工具的比较

目前有多个工具可以实现跟 Boost.Python 类似的功能，如 SWIG，SIP等。但是它们有很大的不同。SWIG 和 SIP 都定义了一种接口描述语言。我需要先写一个接口描述文件，用于描述我要导出的 C++ 函数和类。然后通过一个翻译器，将接口描述文件翻译成 C++ 程序。最后编译连接生成的 C++ 程序来生成扩展库。而 Boost.Python 用于导出 C++ 函数和类的时候，我需要添加的也是 C++ 的代码，这是 Boost.Python 的最大特点之一。

SWIG 比较适合用来包装 C 语言程序，最近也开始增强一些对 C++ 的支持，但是到目前还不支持嵌套类等 C++ 特性。SIP 似乎除了用在包装 Qt 库之外，就没几个人用。而 Boost.Python 可能是这三者之间对 C++ 支持最好的一个。不过 Boost.Python 也有缺点，就是它使用了大量模板技巧，因此当要导出的元素比较多时，编译非常慢。不过幸好作为“胶水”，我并不需要经常修改和重编译，而且如果使用预编译头的话可以进一步提高编译速度。

Boost.Python 的另外一个优点是，它的设计目标就是让 C++ 程序库可以透明地导出到 Python 中去。即在完全不修改原来 C++ 程序的情况下，导出给 Python 用。在这种设计理念下设计出来的 Boost.Python 比同类工具支持了给完善的 C++ 特性，能够最大程度地保证不修改原 C++ 程序。要知道贸然修改别人的程序，往往会带来许多难以察觉的错误。

基于以上几点，我推荐大家在需要的时候使用 Boost.Python，而不是其它。这也是我写这篇文章的最大动力 :-)。

1.3  安装 Boost.Python

这里假定你已经阅读过 Boost 的安装说明，已经会默认安装 Boost 库。

Boost.Python 是 Boost 的一个组件，可以随 Boost 的众多组件一块安装，也可以单独安装。由于 Boost 中组件太多，我通常并不需要所有的组件。只安装我需要的组件可以节省很多时间和空间。安装 Boost.Python 和安装 Boost 的步骤差不多，但是安装 Boost.Python 我还需要：

  • 已经安装了 Python 运行环境

  • 环境变量 PYTHON_ROOT 指向 Python 运行环境所在的目录，

  • 环境变量 PYTHON_VERSION 的值为 Python 的版本号。

例如 Windows 下：PYTHON_ROOT=C:/Python24, PYTHON_VERSION=2.4。而 Linux 下，若我安装了 Python 2.4，其可执行文件为 /usr/bin/python2.4，运行库在 /usr/lib/python2.4，则：PYTHON_ROOT=/usr，PYTHON_VERSION=2.4

默认情况下，使用命令

Linux 下 

bjam "-sTOOLS=gcc" install

Windows 下 

bjam "-sTOOLS=vc7" install

每个组件会生成八份，分别是调试版/发布版、静态连接库/动态连接库、支持单线程/多线程的不同组合。对于 Boost.Python，最多可能生成十六份，因为还可以选择使用 Python 运行库的调试版/发布版。这么多个版本，我未必都用得着，而且生成还很慢。其实大多数情况下，我只需要用如下命令生成一个版本：

Linux 下 

bjam "-sTOOLS=gcc" "-sBUILD=release <runtime-link>dynamic <threading>multi" install

Windows 下 

bjam "-sTOOLS=vc7" "-sBUILD=release <runtime-link>dynamic <threading>multi" install

即选择使用发布版、动态连接库和支持多线程的版本。默认情况下会选择使用 Python 运行库的发布版，这也够用了。编译完成后，我会得到相应的库。比如我安装的 Boost 的版本是 1.32，则 Linux 下为 libboost_python-gcc-mt.so， Windows 下为 boost_python-vc7-mt-1_32.lib 和 boost_python-vc7-mt.dll。

除了组件库，我还需要安装头文件。在 Boost 的源码包的 include 目录下有一大堆 .h 文件，全部复制就可以了。值得注意的是使用 bjam 安装的 Boost.Python 经常漏掉一些头文件，导致我使用库写程序的时候经常说“xxx 头文件”找不到。我还是自己动手复制一份头文件比较安全。

在 Linux 下，安装完后还要用 root 用户运行一下 

ldconfig

1.4  例子：Hello World

我们现看一个  Hello World 的例子，导出一个 C++ 函数。
[HTML]a52a2a 1 [HTML]0000ff/*
[HTML]a52a2a 2 [HTML]0000ff * filename: helloworld.cpp
[HTML]a52a2a 3 [HTML]0000ff [HTML]0000ff*/
[HTML]a52a2a 4 [HTML]a020f0#include [HTML]ff00ff<cstdio>
[HTML]a52a2a 5 [HTML]a020f0#include [HTML]ff00ff<boost/python.hpp> [HTML]0000ff// 包含 Boost.Python 的头文件
[HTML]a52a2a 6
[HTML]a52a2a 7 [HTML]2e8b57void speak() [HTML]0000ff// 一个将被导出的 C++ 函数
[HTML]a52a2a 8 {
[HTML]a52a2a 9 printf([HTML]ff00ff"Hello World![HTML]6a5acd/n[HTML]ff00ff");
[HTML]a52a2a10 }
[HTML]a52a2a11
[HTML]a52a2a12 [HTML]a52a2ausing [HTML]2e8b57namespace boost::python; [HTML]0000ff// 引入名字空间
[HTML]a52a2a13
[HTML]a52a2a14 BOOST_PYTHON_MODULE(Baby) [HTML]0000ff// 胶水代码，导出一个名为“Baby”的模块
[HTML]a52a2a15 {
[HTML]a52a2a16 def([HTML]ff00ff"speak", &speak); [HTML]0000ff// 该模块中有一个函数，函数名为“speak”，入口地址为 &speak
[HTML]a52a2a17 }
[HTML]a52a2a18
现在我准备将上面的例子编译生成动态连接库，作为 Python 扩展库在 Python 中调用。

在 Linux 下用如下命令生成动态连接库 Baby.so： 

g++ helloworld.cpp -o Baby.so -shared -I/usr/include/python2.4 -lboost_python-gcc-mt

在 Windows 下需要先设置一些环境变量 INCLUDE，让编译起能够找到 Boost.Python 的头文件和 Python 的头文件，还要设置环境变量 LIB，让连接器能够找到 Boost.Python 的库文件和 Python 的库文件： 

set INCLUDE=%INCLUDE%;"c:/python24/include";"c:/boost/include/boost-1_32"
set LIB=%LIB%;"c:/python24/libs";"c:/boost/lib"

然后用如下命令编译连接生成动态连接库 Baby.dll： 

cl helloworld.cpp /c /EHsc /LD
link helloworld.obj /OUT:"Baby.dll" /DLL python24.lib boost_python-vc71-mt-1_32.lib

如果使用 VC7 等 IDE 来开发，同样需要对 VC 工程做相应的调整。

打开 Python 解释器，验证我是否成功： 

python
>>> import Baby
>>> Baby.speak()
Hello World!
>>>

这个例子中，我导出了一个函数 speak 到模块 Baby 中。最后生成的动态连接库就是我要的 Python 扩展模块。在 Python 中可以通过模块名 "Baby" 来引入，然后使用该模块下的函数。

提醒一下，这个例子虽然简单，但是第一次用 Boost.Python 写 Python 扩展库的人未必能够一次成功。可能因为我们安装 Python 运行环境和 Boost.Python 组件时选择的安装位置不同，也可能因为生成库的设置未必一致。就算这些都一样，我们还可能安装了其它版本。但道理都是一样的，我们需要注意的只有四点：

  1. 在编译时，需要让编译器知道 Boost.Python 和 Python 的头文件所在目录；

  2. 在连接时，需要让连接器知道 Boost.Python 和 Python 的库文件所在目录；

  3. 在连接时，让连接器知道我们要生成的是动态连接库，并且注意动态连接库的主文件名要跟模块名一致；

  4. 在运行 Python 解释器并装入 Baby 模块时，需要在当前目录或系统目录下找得到 Boost.Python 和 Baby 模块对应的动态连接库；

如果使用不同的操作系统、编译器或者 IDE、不同版本的 Python 运行环境或 Boost.Python 库，成功运行上面的例子需要的设置可能不同，但我们只要注意保证上面四点，应该不会有什么大问题。请在能够顺利运行这个例子之后，再接着看后面的内容。

c++提供python接口：pybind11，boost.python对比
2401_84475987的博客
04-18 924
在C++中提供Python接口的常用工具以及对比 pybind11 boost.python
Boost.python的源码编译安装(尝试解决Boost.Python.ArgumentError)
yucicheung的博客
03-02 9070
问题描述 在本人尝试用pycaffe运行一个程序(snntoolbox)时，出现了 Boost.Python.ArgumentError: Python argument types in Net.__init__(Net, unicode, int) did not match C++ signature:的报错，在翻过各大论坛的相关回答和官方网站的教程之后，主要意见有：1.传递参数类型与函...
boost.python 动态编译库
07-24
本资源是boost1.60源码库编译的python模块动态链接库包含x64 release和debug版本，所用的python为64位的python2.7.9 。 boost_python-vc140-mt-1_60.dll boost_python-vc140-mt-1_60.lib boost_python-vc140-mt-gd-1_60.dll boost_python-vc140-mt-gd-1_60.lib
Boost.python库学习
weixin_30530339的博客
06-15 233
以下学习内容摘录自boost官网 例1. 最简单的HelloWorld例程 #include <boost/python.hpp> // 预备导出的函数 char const* greet() { return "hello, world"; } // 注册PYTHON模块hello_ext BOOST_PYTHON_MODULE(hello_ext) {...
Boost.Python 项目教程
最新发布
gitblog_00177的博客
08-25 395
Boost.Python 项目教程 pythonBoost.org python module项目地址:https://gitcode.com/gh_mirrors/python46/python 1. 项目的目录结构及介绍 Boost.Python 是一个用于将 C++ 代码暴露给 Python 的开源库。以下是该项目的目录结构及其介绍： boostorg/ ├── boost/ │ ├─...
用Boost.Python 写扩展库
笨笨之家
07-08 6118
1  简介Boost.Python 是 Boost 的一个组件。而 Boost 是目前很红火的准 C++ 标准库，它提供了很多组件使得人们可以用 C++ 语言更方便地实现更多的功能。 Boost.Python 就是 Boost 众多组件中的一个。但它是个特例，它的目的不是单纯地增强 C++ 语言的功能，而是希望利用 C++ 语言来增强 Python 语言的能力。使用 Boost.Pyt
build boost python库
vicavo的专栏
07-25 157
1. 官网下载boost 版本：http://www.boost.org/ 2. 解压下载后的版本文件 3. 在解压后的文件中找到：bootstrap.bat文件，并双击运行脚本bootstrap.bat 4. 打开VS Developer Command Prompt命令行，切换目录到解压后的目录中 5. 运行.\b2即启动编译，整个过程持续3-5个小时。 完成！ 以下为参考链...
boost.python 编写扩展python库
02-16
环境 vs2008 构建 python26 boost_1_44 使用boost.python 编写扩展python库，使用mfc例子调用扩展的python库。 myPydll 工程为扩展python库，生成文件myPydll.dll，将该文件拷贝到python解释器可搜索的路径下，如我的电脑就是“C:\Python26\DLLs”，并改后缀名为pyd。即文件myPydll.pyd。或者与当前测试的程序在同一目录，如测试程序test.exe与myPydll.pyd在同一目录，test.exe即可正常运行 test 工程是测试调用自己编写的python扩展库的mfc例子。 文件 pyinit.hpp 是vc中使用python时的初始化封装 使用的boost库版本是1.44，我的boost库路径是“D:\Program Files\Code\boost_1_44_0” boost_python-vc90-mt-gd-1_44.dll boost_python-vc90-mt-gd-1_44.lib 文件夹中的dll和lib等文件是 boost.python库的动态库和lib的release和debug版。
python专用boost扩展模块/boost_python-1.55.win32-py3.3.rar
07-19
Python Boost扩展模块是将C++的Boost库与Python语言相结合的一种工具，旨在增强Python的性能和功能。Boost库是一个开源的C++库集合，提供了大量的高效、跨平台的实用程序，包括数学算法、图形库、多线程支持、日期...
Boost.Python.ArgumentError: Python argument types in错误解决及Boost安装配置
CycloneKid的博客
04-16 8355
报错信息 运行Python程序时报错，报错信息如下图所示。先检查函数使用的是否正确，如果确定没有问题，那么很可能是boost的安装配置问题 Boost库简介 Boost库是为C++语言标准库提供扩展的一些C++程序库的总称。 Boost库是一个可移植、提供源代码的C++库，作为标准库的后备，是C++标准化进程的开发引擎之一。 可下载Boost C++ Libraries安装boost库。大部分b...
Boost之Python
qq_33271629的博客
04-14 1332
需要注意的是，尽管 Boost::Python 提供了许多便利的功能，但它的实现依赖于 Python/C API，因此在使用时要结合 Python/C API 的相关知识。此外，Boost::Python 的某些功能可能还不完善，需要开发者对 Python/C API 有一定的了解，以便在遇到问题时能够进行调试和解决。总的来说，Boost::Python 为 C++ 和 Python 之间的互操作提供了一个强大而灵活的工具，使得开发者能够充分利用两种语言的优势，实现更加高效和强大的应用程序。
编译好的boost的python3库
11-28
boost支持python，官网提供的编译好的库只支持python2，python3的版本需要自己编译，按照网上的很多文章说的做，根本无法编译成功，这个是1.68版的boost、python3.6、vs2013编译的静态库，32位的，有需要的可以下载使用
c python boost.python_python学习笔记：安装boost python库以及使用boost.python库封装
weixin_39637571的博客
11-30 296
学习是一个累积的过程。在这个过程中，我们不仅要学习新的知识，还需要将以前学到的知识进行回顾总结。前面讲述了Python使用ctypes直接调用动态库和使用Python的C语言API封装C函数， C++写python扩展模块有很多种方式,我选择的是boost.python来编写的,感觉这个要比其他的方式要简单很多,本文概述方便封装C++类给Python使用的boost_python库。：sudo a...
boost库 python_boost.python库学习
weixin_26841743的博客
03-03 295
以下学习内容摘录自boost官网例1. 最简单的HelloWorld例程#include // 预备导出的函数char const* greet(){return "hello, world";}// 注册PYTHON模块hello_extBOOST_PYTHON_MODULE(hello_ext){using namespace boost::python;//导出函数名与实际函数绑定def("...
C++使用boost.python编写Python扩展
weixin_34417814的博客
08-05 154
很久没有写文章了，今天整理了一些东西，在这里分享一下。 最近一直在想用C++封装一些在工作中常用的Python扩展模块，因为之前没有用C++写过类似的东西，因此一直在网上找一些文章，但是我发现好多文章都描述的不是很清晰，对于老鸟来说应该会很容易，但是像我这种初学者，肯定会造成很大的困扰，因为总是出现很多的报错，搞的头很大，因此我将成功的案例分享一下，并且详细的解释下让我产生疑惑的地方。 boost...
boost库 python_如何在VS2017中使用Boost Python库进行构建
weixin_39789399的博客
12-12 234
I have built the Boost 1.64.0 Python libraries, using MS Visual Studio Professional 2017 and 32-bit Python 3.4. Now, when I write an application against the resulting library, I'm getting the followi...
Boost(2)：boost.python库介绍及简单示例
热门推荐
翔底的博客
01-05 1万+
1. boost.python介绍 将c/c++的函数接口转换为Python接口有好几种解决方案，不同于C语言的简单直接，C++因使用了大量的面向对象编程的思想导致转换为Python接口时相对比较复杂，boost.python的目标就是为了简单方便地将C++程序转换成Python的接口。 BoostPython库是boost c++库的其中一个子库，使用它可以轻松地将C++的函数接口转换成Python接口。在大部分情况下你不需要对原先的C++代码做任何修改，boost.python会对C++类再做一层封装，
C++中用Boost::Python调用Python模块
Dlite的技术笔记
02-05 1733
在C++中用Boost::Python调用Python模块，过程及避坑指南。
掌握Boost.Python库，实现C++与Python的无缝连接
使用Boost.Python库，我们可以轻松地将C++的类、函数和变量暴露给Python环境，从而扩展Python的能力，增加运行效率。同时，它也为C++开发者提供了一种利用Python库和脚本的能力。 2. Boost.Python库的作用和优势: ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值