### 使用 PyBind11 绑定 C++ 结构体并在 Python 中打印其内容 以下是如何通过 PyBind11 将 C++ 的结构体绑定到 Python，并在 Python 中访问和打印该结构体的内容的完整示例。 --- #### 1. **定义 C++ 结构体** 首先，在 C++ 文件中定义一个简单的结构体，包含一些成员变量。例如： ```cpp // example_struct.h #ifndef EXAMPLE_STRUCT_H #define EXAMPLE_STRUCT_H struct ExampleStruct { int integer_value; double float_value; std::string string_value; ExampleStruct(int i, double f, const std::string& s) : integer_value(i), float_value(f), string_value(s) {} }; #endif // EXAMPLE_STRUCT_H ``` --- #### 2. **编写 C++ 函数返回结构体实例** 接着，编写一个函数来创建并返回这个结构体的一个实例： ```cpp // example.cpp #include <pybind11/pybind11.h> #include <pybind11/stl.h> // 提供 STL 数据类型的自动转换支持 #include "example_struct.h" namespace py = pybind11; ExampleStruct create_example_struct() { return ExampleStruct(42, 3.14159, "Hello from C++"); } PYBIND11_MODULE(example_module, m) { m.doc() = "An example module that binds a C++ struct to Python"; // 绑定结构体 py::class_<ExampleStruct>(m, "ExampleStruct") .def(py::init<int, double, const std::string &>()) .def_readwrite("integer_value", &ExampleStruct::integer_value) .def_readwrite("float_value", &ExampleStruct::float_value) .def_readwrite("string_value", &ExampleStruct::string_value); // 绑定函数 m.def("create_example_struct", &create_example_struct, "Returns an instance of ExampleStruct"); } ``` 在此代码片段中： - `py::class_` 被用来将 C++ 类或结构体暴露给 Python。 - `.def_readwrite()` 方法允许 Python 访问结构体的成员变量[^1]。 - `PYBIND11_MODULE` 是宏，用于定义导出的模块名称和入口点。 --- #### 3. **编译生成共享库** 使用如下命令编译上述代码为共享库（假设操作系统为 Linux 或 macOS），以便可以在 Python 中加载它： ```bash c++ -O3 -Wall -shared -std=c++11 -fPIC \ $(python3 -m pybind11 --includes) example.cpp -o example_module$(python3-config --extension-suffix) ``` 这条命令的作用是： - `-O3`: 启用最高级别的优化。 - `-Wall`: 显示所有警告信息。 - `-shared`: 编译为目标动态链接库。 - `-std=c++11`: 指定标准为 C++11。 - `-fPIC`: 生成位置无关代码 (Position Independent Code)，这是共享库的要求之一。 - `$(python3 -m pybind11 --includes)` 和 `$(python3-config --extension-suffix)` 自动处理与 Python 配置相关的参数[^2]。 --- #### 4. **在 Python 中测试** 一旦编译完成，就可以在 Python 中导入刚刚生成的模块，并调用其中的方法来获取和打印结构体的内容： ```python import example_module as em # 获取 C++ 返回的结构体实例 example_instance = em.create_example_struct() # 打印结构体的内容 print(f"Integer Value: {example_instance.integer_value}") print(f"Float Value: {example_instance.float_value}") print(f"String Value: {example_instance.string_value}") ``` 运行这段脚本会输出类似于下面的结果： ``` Integer Value: 42 Float Value: 3.14159 String Value: Hello from C++ ``` --- ### 总结 通过 PyBind11，可以轻松地将复杂的 C++ 数据类型（如结构体）绑定到 Python 中，并使它们的行为如同原生 Python 对象一样自然。这种方法不仅减少了样板代码的数量，而且提高了性能和可维护性[^3]。 ---