pybind11是一个轻量级C++库,用于将C++代码无缝导出到Python。它基于C++11,语法简洁,支持函数、类、STL容器的绑定,仅需包含头文件并链接Python库。通过CMake构建后,生成的模块可在Python中直接调用,实现高效混合编程。

在现代软件开发中,C++ 和 Python 经常需要协同工作。C++ 适合高性能计算和底层操作,而 Python 擅长快速开发、数据处理和机器学习。pybind11 是一个轻量级但功能强大的库,能够将 C++ 代码暴露给 Python 使用,实现高效混合编程。
什么是 pybind11
pybind11 是一个开源的头文件库,允许 C++ 代码与 Python 无缝交互。它使用现代 C++(C++11 及以上)特性,通过简洁的语法将 C++ 类、函数、变量等导出到 Python 中。相比传统的 Boost.Python,pybind11 更轻便、编译更快,且依赖极少。
只需要包含 pybind11 的头文件,并链接 Python 库,就能编写绑定代码。
环境准备与安装
开始前需确保系统中已安装:
立即学习“Python免费学习笔记(深入)”;
Python(建议 3.6+)CMake(用于构建项目)支持 C++11 的编译器(如 g++、clang 或 MSVC)
安装 pybind11 的推荐方式:
可通过 pip 安装:
pip install pybind11
或使用 CMake 直接引入(推荐项目集成):
find_package(pybind11 REQUIRED)
如果你通过 vcpkg 或 conda 安装,也能轻松集成。
编写简单的 C++ 函数并导出
以下是一个将 C++ 函数绑定到 Python 的例子:
example.cpp
#includeint add(int a, int b) {return a + b;}
namespace py = pybind11;PYBIND11_MODULE(example, m) {m.doc() = "pybind11 example plugin";m.def("add", &add, "A function that adds two numbers");}
这个模块定义了一个名为 example 的 Python 模块,其中包含一个函数 add。
编译生成 Python 扩展模块
使用 CMake 编译上述代码为 Python 可导入的模块。
CMakeLists.txt
cmake_minimum_required(VERSION 3.10)project(example)find_package(pybind11 REQUIRED)
pybind11_add_module(example example.cpp)
构建步骤:
mkdir buildcd buildcmake ..make
成功后会生成 example.cpython-xxx.so(Linux/Mac)或 example.pyd(Windows)。
在 Python 中使用:
import exampleprint(example.add(3, 4)) # 输出: 7
导出 C++ 类到 Python
pybind11 支持完整地将 C++ 类暴露给 Python,包括构造函数、成员函数、属性等。
#includeclass MyClass {public:MyClass(const std::string &name) : name(name) {}void set_name(const std::string &n) { name = n; }std::string get_name() const { return name; }private:std::string name;};
namespace py = pybind11;PYBIND11_MODULE(exampleclass, m) {py::class(m, "MyClass").def(py::init()).def("set_name", &MyClass::set_name).def("get_name", &MyClass::get_name);}
Python 中使用:
from example_class import MyClassobj = MyClass("Alice")print(obj.get_name()) # 输出: Aliceobj.set_name("Bob")print(obj.get_name()) # 输出: Bob
处理复杂类型与 STL 容器
pybind11 支持自动转换常见 STL 类型,如 vector、map 等。
只需包含额外头文件:
#include
之后 C++ 函数中使用 std::vector 或 std::map 时,pybind11 会自动将其映射为 Python 的 list 或 dict。
示例:
std::vector get_numbers() { return {1, 2, 3, 4, 5};}PYBIND11_MODULE(example_stl, m) {m.def("get_numbers", &get_numbers);}
Python 调用返回的就是标准 list。
基本上就这些。pybind11 让 C++ 与 Python 的互操作变得直观又高效,适合性能敏感场景下的混合开发。只要写好绑定代码,Python 就能像调用原生函数一样使用 C++ 功能。不复杂但容易忽略的是编译配置和类型转换细节,建议结合官方文档逐步调试。
以上就是C++如何与Python交互_C++使用pybind11库进行混合编程的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1488792.html
微信扫一扫
支付宝扫一扫