Py_BuildValue如何传递二维数组

在Python中，`Py_BuildValue` 是用于将 Python 对象转换为 C 语言的结构化数据，通常用于扩展模块之间进行数据交换。当你需要传递二维数组时，你需要创建一个适合的 C 结构体，并使用 `Py_BuildValue` 来填充这个结构。

二维数组在 C 里通常表示为一个包含指向一维数组指针的一维数组，或者使用类似 `struct` 定义的嵌套数组。这里是一个例子：

#include <Python.h>
#include <structmember.h>

typedef struct {
    PyObject *data;  // 存储二维数组的内部一维数组
    int rows;
    int cols;
} PyMyArray;

static PyMemberDef memberdef[] = {
    {"data", T_OBJECT, offsetof(PyMyArray, data), READONLY, "Data of the array"},
    {NULL}  // 结束定义
};

static PyTypeObject PyMyArrayType = {
    PyVarObject_HEAD_INIT(NULL, 0)
    .tp_name = "PyMyArray",
    .tp_basicsize = sizeof(PyMyArray),
    .tp_itemsize = 0,
    .tp_members = memberdef,
    .tp_doc = "Custom type for a 2D array in Python",
};

static int PyMyArray_init(PyMyArray *self, PyObject *args, PyObject *kwargs) {
    // 初始化rows和cols
    if (!PyArg_ParseTuple(args, ":PyMyArray", &self->rows, &self->cols)) {
        return -1;
    }

    // 用PyObject的array API 创建一个内部的二维数组
    self->data = PyList_New(self->rows);
    if (self->data == NULL) {
        return -1;
    }

    // 进行进一步的数据填充或初始化
    // ...
    return 0;
}

static void PyMyArray_dealloc(PyMyArray *self) {
    Py_XDECREF(self->data);
    Py_TYPE(self)->tp_free((PyObject *)self);
}

static PyMethodDef PyMyArray_methods[] = {
    {NULL}  /* Sentinel */
};

PyDoc_STRVAR(PyMyArray_doc, 
    "A custom class representing a 2D array in Python.\n"
    "Parameters:\n"
    "    rows: The number of rows.\n"
    "    cols: The number of columns.\n"
);

static PyModuleDef moduledef = {
    PyModuleDef_HEAD_INIT,
    "my_array_extension",
    PyMyArray_doc,
    -1,
    PyMyArray_methods,
    NULL,
    NULL,
    NULL,
    NULL
};

PyMODINIT_FUNC PyInit_my_array_extension(void) {
    PyObject *m = PyModule_Create(&moduledef);
    if (m == NULL) {
        return NULL;
    }

    PyMyArray_Type.tp_base = &PyVarObject_Type;
    Py_INCREF(&PyMyArray_Type);
    if (PyModule_AddObject(m, "PyMyArray", (PyObject *)&PyMyArray_Type) < 0) {
        Py_DECREF(&PyMyArray_Type);
        return NULL;
    }

    return m;
}