如何在pybind11方案中集成返回PyObject*的遗留C++函数？

你完全不需要修改原foo函数的实现，pybind11原生支持直接注册返回PyObject*的C++函数，步骤非常简单：

1. 直接在pybind11模块中注册函数 #

只需要在你的pybind11模块定义代码里，把原函数直接绑定到Python模块即可。示例代码如下：

#include <pybind11/pybind11.h>
#include <string>

namespace py = pybind11;

// 你的原生PyAPI实现函数，完全不需要修改
PyObject *foo(const std::string& file) {
    // 原有的逻辑，比如创建字典并填充内容
    PyObject* result_dict = PyDict_New();
    PyDict_SetItemString(result_dict, "input_file", PyUnicode_FromString(file.c_str()));
    PyDict_SetItemString(result_dict, "result", PyUnicode_FromString("success"));
    return result_dict;
}

// 定义pybind11模块
PYBIND11_MODULE(my_module, m) {
    // 直接绑定foo函数，指定参数名和文档字符串
    m.def("foo", &foo, py::arg("file"), "根据输入文件路径生成包含结果的字典");
}

2. 关键注意事项 #

• 引用计数处理：pybind11会自动接管你返回的PyObject*引用，前提是你的原函数符合Python C API规范——返回的是新引用（比如PyDict_New、PyUnicode_FromString这类函数返回的都是新引用），不需要手动调用Py_DECREF或Py_INCREF。
• 异常处理兼容：如果原函数在出错时返回NULL并设置了Python异常（比如调用PyErr_SetString），pybind11会自动识别并将其转换成Python层面的异常抛出，完全符合原生Python的错误处理逻辑。

可选：将返回值转为pybind11类型（如果需要） #

如果你后续想在C++代码里用pybind11的封装类型（比如py::dict）操作返回结果，可以用py::reinterpret_steal接管原生对象的引用，示例：

// 封装成返回py::dict的函数，再绑定到Python
py::dict foo_wrapper(const std::string& file) {
    PyObject* raw_obj = foo(file);
    if (!raw_obj) {
        // 捕获已设置的Python异常
        throw py::error_already_set();
    }
    // 接管raw_obj的引用，转为pybind11的dict类型
    return py::reinterpret_steal<py::dict>(raw_obj);
}

// 在模块中注册封装后的函数
PYBIND11_MODULE(my_module, m) {
    m.def("foo", &foo_wrapper, py::arg("file"), "根据输入文件路径生成包含结果的字典");
}

内容的提问来源于stack exchange，提问作者user2052153