如何用pybind11实现含C风格数组的POD结构体的Python读写？

原C++ POD结构体 #

struct Student
{
    int id;
};

struct ClassRoom
{
    Student students[10];
};

期望的Python读写方式 #

class_room = pytest.ClassRoom()
class_room.students[2].id = 7

你尝试的代码（存在问题） #

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


PYBIND11_MODULE(pytest, m)
{ 
 pybind11::class_<ClassRoom>(m,"ClassRoom")
        .def(pybind11::init<>())
        .def_readwrite("students",&ClassRoom::students);
}

问题原因 #

直接绑定C++数组students的话，pybind11无法自动将其识别为Python可索引访问的对象；同时你没有为Student结构体创建pybind11绑定，导致Python无法识别该类型的成员，自然没法修改id属性。

正确实现方案 #

步骤1：先绑定Student结构体 #

必须先让pybind11把Student暴露给Python，这样Python才能识别并操作它的id成员。

步骤2：为ClassRoom的students数组提供可访问接口 #

这里提供两种符合你需求的实现方式：

方式一：通过下标直接访问ClassRoom（类似数组）

这种方式让ClassRoom对象本身支持下标操作，直接访问内部的students数组：

#include <pybind11/pybind11.h>

struct Student
{
    int id;
};

struct ClassRoom
{
    Student students[10];
};

namespace py = pybind11;

PYBIND11_MODULE(pytest, m)
{
    // 绑定Student结构体，暴露id成员
    py::class_<Student>(m, "Student")
        .def(py::init<>())
        .def_readwrite("id", &Student::id);

    // 绑定ClassRoom结构体
    py::class_<ClassRoom>(m, "ClassRoom")
        .def(py::init<>())
        // 实现__getitem__，支持读取下标
        .def("__getitem__", [](const ClassRoom& cr, size_t idx) {
            if (idx >= 10) throw py::index_error("students index out of range");
            return &cr.students[idx];
        }, py::return_value_policy::reference_internal) // 返回原对象引用，修改会直接生效
        // 实现__setitem__，支持通过下标赋值Student对象
        .def("__setitem__", [](ClassRoom& cr, size_t idx, const Student& s) {
            if (idx >= 10) throw py::index_error("students index out of range");
            cr.students[idx] = s;
        });
}

Python使用示例：

class_room = pytest.ClassRoom()
class_room[2].id = 7  # 直接通过下标访问第3个学生
print(class_room[2].id)  # 输出7

方式二：保留students属性的访问形式

如果你希望严格按照class_room.students[2]的写法访问，可以把students数组包装成Python的tuple对象：

#include <pybind11/pybind11.h>
#include <pybind11/stl.h> // 用于tuple的支持

struct Student
{
    int id;
};

struct ClassRoom
{
    Student students[10];
};

namespace py = pybind11;

PYBIND11_MODULE(pytest, m)
{
    py::class_<Student>(m, "Student")
        .def(py::init<>())
        .def_readwrite("id", &Student::id);

    py::class_<ClassRoom>(m, "ClassRoom")
        .def(py::init<>())
        // 用property包装students属性，返回一个包含Student引用的tuple
        .def_property("students", 
            [](const ClassRoom& cr) {
                return py::make_tuple(
                    &cr.students[0], &cr.students[1], &cr.students[2],
                    &cr.students[3], &cr.students[4], &cr.students[5],
                    &cr.students[6], &cr.students[7], &cr.students[8],
                    &cr.students[9]
                );
            },
            [](ClassRoom& cr, const py::tuple& t) {
                // 可选：实现从tuple赋值回数组的逻辑
                for (size_t i = 0; i < 10; ++i) {
                    cr.students[i] = *t[i].cast<Student*>();
                }
            },
            py::return_value_policy::reference_internal);
}

Python使用示例：

class_room = pytest.ClassRoom()
class_room.students[2].id = 7  # 完全符合你期望的写法
print(class_room.students[2].id)  # 输出7

关键注意点 #

• 必须先绑定Student结构体：否则Python无法识别该类型，更没法访问其id成员。
• 使用reference_internal返回策略：确保返回的Student对象是指向原ClassRoom数组中的实例，修改操作会直接作用到原对象上，而不是拷贝后的副本。

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