首页 > 后端开发 > C++ > 正文

C++如何与Python交互_C++使用pybind11库进行混合编程

穿越時空
发布: 2025-12-13 20:24:07
原创
152人浏览过
pybind11是一个轻量级C++库,用于将C++代码无缝导出到Python。它基于C++11,语法简洁,支持函数、类、STL容器的绑定,仅需包含头文件并链接Python库。通过CMake构建后,生成的模块可在Python中直接调用,实现高效混合编程。

c++如何与python交互_c++使用pybind11库进行混合编程

在现代软件开发中,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

#include <pybind11/pybind11.h>
<p>int add(int a, int b) {
return a + b;
}</p><p>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

Playground AI
Playground AI

AI图片生成和修图

Playground AI 99
查看详情 Playground AI
cmake_minimum_required(VERSION 3.10)
project(example)
<p>find_package(pybind11 REQUIRED)</p><p>pybind11_add_module(example example.cpp)
登录后复制

构建步骤:

mkdir build
cd build
cmake ..
make
登录后复制

成功后会生成 example.cpython-xxx.so(Linux/Mac)或 example.pyd(Windows)。

在 Python 中使用:

import example
print(example.add(3, 4))  # 输出: 7
登录后复制

导出 C++ 类到 Python

pybind11 支持完整地将 C++ 类暴露给 Python,包括构造函数、成员函数、属性等。

#include <pybind11/pybind11.h>
<p>class 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;
};</p><p>namespace py = pybind11;
PYBIND11_MODULE(example<em>class, m) {
py::class</em><MyClass>(m, "MyClass")
.def(py::init<const std::string &>())
.def("set_name", &MyClass::set_name)
.def("get_name", &MyClass::get_name);
}
登录后复制

Python 中使用:

from example_class import MyClass
obj = MyClass("Alice")
print(obj.get_name())  # 输出: Alice
obj.set_name("Bob")
print(obj.get_name())  # 输出: Bob
登录后复制

处理复杂类型与 STL 容器

pybind11 支持自动转换常见 STL 类型,如 vector、map 等。

只需包含额外头文件:

#include <pybind11/stl.h>
登录后复制

之后 C++ 函数中使用 std::vector<int></int>std::map<:string int></:string> 时,pybind11 会自动将其映射为 Python 的 list 或 dict。

示例:

std::vector<int> get_numbers() {
    return {1, 2, 3, 4, 5};
}
<p>PYBIND11_MODULE(example_stl, m) {
m.def("get_numbers", &get_numbers);
}
登录后复制

Python 调用返回的就是标准 list。

基本上就这些。pybind11 让 C++ 与 Python 的互操作变得直观又高效,适合性能敏感场景下的混合开发。只要写好绑定代码,Python 就能像调用原生函数一样使用 C++ 功能。不复杂但容易忽略的是编译配置和类型转换细节,建议结合官方文档逐步调试。

以上就是C++如何与Python交互_C++使用pybind11库进行混合编程的详细内容,更多请关注php中文网其它相关文章!

编程速学教程(入门课程)
编程速学教程(入门课程)

编程怎么学习?编程怎么入门?编程在哪学?编程怎么学才快?不用担心,这里为大家提供了编程速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号