本文详解如何在 python 的 ctypes 模块中准确映射 c 语言中的 typedef struct（如 reshandle）及其指针类型（如 preshandle），包括结构体继承、字段声明、指针类型构造等核心步骤。
本文详解如何在 python 的 ctypes 模块中准确映射 c 语言中的 typedef struct（如 reshandle）及其指针类型（如 preshandle），包括结构体继承、字段声明、指针类型构造等核心步骤。
在 Python 中通过 ctypes 调用 C 动态库时，正确描述 C 头文件中定义的结构体是关键一步。以如下 C 头文件片段为例：
typedef struct {
void *Handle;
} RESHANDLE, *PRESHANDLE;
该定义声明了两个类型：
- RESHANDLE 是一个包含单个 void* 成员的匿名结构体；
- PRESHANDLE 是指向该结构体的指针类型（即 RESHANDLE*）。
在 ctypes 中，需严格遵循以下规范进行等价映射：
✅ 正确实现方式
import ctypes as ct
class RESHANDLE(ct.Structure):
_fields_ = [("Handle", ct.c_void_p)]
PRESHANDLE = ct.POINTER(RESHANDLE)
- ct.Structure 是所有 ctypes 结构体的基类，必须显式继承；
- _fields_ 是一个元组列表（每个元素为 (name, type) 形式），必须使用字符串指定字段名，且类型须为 ctypes 原生类型（如 ct.c_void_p 代表 void*）；
- ct.POINTER(RESHANDLE) 构造出与 PRESHANDLE 等效的指针类型，可用于函数参数声明或内存分配。
⚠️ 常见错误与注意事项
- ❌ 错误写法：_fields_ = 'Handle', ct.c_void_p —— 缺少外层括号或方括号，导致语法错误或字段解析失败；
- ❌ 错误写法：_fields_ = [('Handle', None)] —— 类型不能为 None，必须使用明确的 ctypes 类型；
- ✅ 若结构体后续扩展（如新增 int Status; 字段），只需同步更新 _fields_ 列表即可，无需修改调用逻辑；
- ? ct.c_void_p 可安全用于接收/传递任意指针地址，但不支持解引用操作；如需访问所指数据，应先转换为对应类型的指针（如 ct.cast(ptr, ct.POINTER(ct.c_int))）。
? 实际调用示例（补充场景）
假设 C 库导出函数：
RESHANDLE create_handle(); void destroy_handle(PRESHANDLE ph);
Python 中可这样调用：
lib = ct.CDLL("./mylib.so")
lib.create_handle.restype = RESHANDLE
lib.destroy_handle.argtypes = [PRESHANDLE]
h = lib.create_handle()
ph = ct.byref(h) # 或直接传 ct.pointer(h)
lib.destroy_handle(ph)
综上，ctypes 结构体定义的核心在于精准对应 C 层语义：结构体 → ct.Structure 子类，void* → ct.c_void_p，T* → ct.POINTER(T)。掌握这一映射规则，即可稳健支撑跨语言接口开发。
