Python C扩展中如何将元组转换为Point结构体并访问数据？

你的核心问题是直接将Python元组的PyObject*指针当作C的Point*结构体指针使用，这完全错误——两者内存布局完全不同，会导致非法内存访问。以下是两种正确的修改方案：

方法一：直接通过PyArg_ParseTuple解析元组内容 #

这种方法最简洁，适合无需动态分配结构体的场景：

#define PY_SSIZE_T_CLEAN
#include <Python.h>
#include <stdio.h>
#include <stdlib.h>

typedef struct Point {
    int x;
    int y;
} Point;

static PyObject *test(PyObject *self, PyObject *args) {
    // 直接在栈上声明结构体变量，无需手动管理内存
    Point start, end;

    // 格式字符串"(ii)(ii)"表示：接受两个元组，每个元组包含两个整数
    if(!PyArg_ParseTuple(args, "(ii)(ii)", &start.x, &start.y, &end.x, &end.y)) {
        return NULL;
    }

    printf("%d %d\n", start.x, start.y);
    printf("%d %d\n", end.x, end.y);

    // 后续可直接使用start、end结构体进行业务逻辑处理
    return PyLong_FromLong(0);
}

方法二：手动解析PyObject元组（动态分配结构体） #

如果需要在函数外保留结构体实例，可采用动态分配内存的方式，需注意手动管理内存：

#define PY_SSIZE_T_CLEAN
#include <Python.h>
#include <stdio.h>
#include <stdlib.h>

typedef struct Point {
    int x;
    int y;
} Point;

static PyObject *test(PyObject *self, PyObject *args) {
    PyObject *start_tuple, *end_tuple;
    Point *start = malloc(sizeof(Point));
    Point *end = malloc(sizeof(Point));

    // 内存分配失败时抛出Python内存异常
    if (!start || !end) {
        PyErr_NoMemory();
        return NULL;
    }

    // 先将参数解析为PyObject元组
    if(!PyArg_ParseTuple(args, "OO", &start_tuple, &end_tuple)) {
        free(start);
        free(end);
        return NULL;
    }

    // 解析第一个元组
    if (!PyTuple_Check(start_tuple) || PyTuple_Size(start_tuple) != 2) {
        PyErr_SetString(PyExc_TypeError, "第一个参数必须是包含两个整数的元组");
        free(start);
        free(end);
        return NULL;
    }
    start->x = (int)PyLong_AsLong(PyTuple_GetItem(start_tuple, 0));
    start->y = (int)PyLong_AsLong(PyTuple_GetItem(start_tuple, 1));
    if (PyErr_Occurred()) {
        free(start);
        free(end);
        return NULL;
    }

    // 解析第二个元组
    if (!PyTuple_Check(end_tuple) || PyTuple_Size(end_tuple) != 2) {
        PyErr_SetString(PyExc_TypeError, "第二个参数必须是包含两个整数的元组");
        free(start);
        free(end);
        return NULL;
    }
    end->x = (int)PyLong_AsLong(PyTuple_GetItem(end_tuple, 0));
    end->y = (int)PyLong_AsLong(PyTuple_GetItem(end_tuple, 1));
    if (PyErr_Occurred()) {
        free(start);
        free(end);
        return NULL;
    }

    printf("%d %d\n", start->x, start->y);
    printf("%d %d\n", end->x, end->y);

    // 用完动态分配的结构体，必须手动释放内存
    free(start);
    free(end);

    return PyLong_FromLong(0);
}

关键注意事项 #

• 绝对不能将PyObject*直接强制转换为C结构体指针，两者内存结构完全不兼容，会导致程序崩溃或未知错误。
• 解析参数时必须做合法性校验：检查元组类型、元素数量、元素类型，避免非法输入导致的运行时错误。
• 动态分配内存后，在函数返回前必须释放，防止内存泄漏；栈上声明的结构体无需手动释放。
• 使用PyLong_AsLong转换Python整数时，若输入非整数类型，函数会自动设置Python异常，需及时返回NULL终止函数。

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