如何通过 SWIG 从 Python 向 C++ 函数传递数组参数-Python教程-PHP中文网

c++oding="utf-8" ?>

如何通过 SWIG 从 Python 向 C++ 函数传递数组参数

本文介绍在不修改或重新编译 SWIG 接口文件的前提下，利用 SWIG 自动生成的 array_class 封装类型（如 IntArray），安全、高效地将 Python 列表数据传递给形参为 int array[] 的 C++ 函数。

本文介绍在不修改或重新编译 swig 接口文件的前提下，利用 swig 自动生成的 `array_class` 封装类型（如 `intarray`），安全、高效地将 python 列表数据传递给形参为 `int array[]` 的 c++ 函数。

当使用 SWIG 绑定 C++ 函数（如 int func(int array[]);）到 Python 时，SWIG 默认不会自动支持原生 Python 列表或元组直接映射为 C 风格数组。尝试 func([1, 2, 3]) 或 func((1, 2, 3)) 均会失败——这是因为 SWIG 对裸指针/数组参数缺乏隐式转换规则，且未启用 %apply 或 NumPy 相关指令时，无法自动完成内存布局适配。

幸运的是，若原始 .i 接口文件中已声明类似以下指令：

%array_class(int, IntArray);

SWIG 将自动生成一个名为 IntArray 的 Python 类型，它封装了底层 C 数组的内存管理与索引访问能力。该类本质是带边界检查、可变长度、支持下标赋值的轻量容器，无需重新编译绑定模块即可直接使用。

Python Testing

Python 测试速查：运行 pytest、使用 mock/patch、参数化、fixtures、异步、覆盖率测试。

下载

✅ 正确调用方式（零修改、零重编译）

假设目标函数为 int func(int array[]);，且接口中存在 %array_class(int, IntArray);，则按以下步骤调用：

# 1. 创建指定长度的 IntArray 实例
arr = IntArray(3)  # 分配 3 个 int 的连续内存

# 2. 逐元素赋值（索引从 0 开始）
arr[0] = 1
arr[1] = 2
arr[2] = 3

# 3. 直接传入 C++ 函数（SWIG 自动转换为 int*）
result = func(arr)

⚠️ 注意：IntArray 构造时必须指定明确大小（IntArray(n)），且后续不可动态扩容；其生命周期由 Python 管理，函数调用结束后内存自动释放，无需手动 delete。

? 补充说明与常见误区

为什么 list / tuple 不行？
Python 列表是对象指针数组，内存不连续；而 C++ int[] 要求连续整型内存块。SWIG 不做隐式拷贝转换，故直接传入会触发类型不匹配异常。
如何确认 IntArray 是否可用？
在 Python 中执行 help(func) 或查看 SWIG 生成的异常提示（如 "func() takes exactly 1 argument (1 given)" 后附候选签名），若出现 func(IntArray)，即表示该类型已暴露。
替代方案（不推荐，仅作对比）
若未启用 %array_class，需借助 ctypes 手动构造 c_int * n 并传递 .as_parameter，但侵入性强、易出错，且违背“不修改绑定”的前提。

✅ 总结

在 SWIG 已编译且接口含 %array_class(int, IntArray) 的前提下，IntArray 是最简洁、安全、符合 C++ 内存语义的数组传递方案。其核心优势在于：
✅ 无需改动 .i 文件或重新编译；
✅ 自动内存管理，避免泄漏或悬垂指针；
✅ 类型强校验，提升运行时健壮性；
✅ 语法直观，接近原生数组使用体验。

务必确保数组长度与 C++ 函数预期一致——越界写入可能导致未定义行为，但 IntArray 的索引访问本身具备 Python 层面的越界检查（抛出 IndexError），提供基础防护。