Python使用ctypes声明C库IedConnection对象与按引用传参咨询

类型与接口声明 #

IedConnection属于C库封装的不透明指针类型，Python侧不需要感知其内部结构体结构，直接用ctypes.c_void_p作为对应类型即可。首先需要完成动态库加载和接口参数/返回值声明：

import ctypes

# 加载动态库，根据实际操作系统和库文件路径修改
# Linux/macOS 示例
lib = ctypes.CDLL("./libied.so")
# Windows 示例
# lib = ctypes.CDLL("./ied.dll")

# 声明IedConnection_create的返回值为指针类型
lib.IedConnection_create.restype = ctypes.c_void_p
lib.IedConnection_create.argtypes = []

# 声明IedConnection_connect的参数和返回值类型，假设error为int类型、返回值为int状态码
lib.IedConnection_connect.argtypes = [
    ctypes.c_void_p,  # IedConnection对象指针
    ctypes.POINTER(ctypes.c_int),  # error变量的指针
    ctypes.c_char_p,  # hostname字符串（需传入bytes类型）
    ctypes.c_int  # tcp端口号
]
lib.IedConnection_connect.restype = ctypes.c_int

# 声明IedConnection_destroy的参数类型
lib.IedConnection_destroy.argtypes = [ctypes.c_void_p]
lib.IedConnection_destroy.restype = None

调用示例 #

# 声明IedConnection对象，等价于C代码的IedConnection con = IedConnection_create()
con = lib.IedConnection_create()

# 构造需要按引用传递的error变量
error = ctypes.c_int(0)
hostname = b"192.168.1.120"  # Python字符串需先编码为bytes类型
tcp_port = 102

# 调用连接接口，用ctypes.byref实现按引用传参，等价于C代码的&error
ret = lib.IedConnection_connect(con, ctypes.byref(error), hostname, tcp_port)
if ret != 0:
    print(f"连接失败，错误码：{error.value}")

# 资源释放
lib.IedConnection_destroy(con)

关键说明 #

• 所有C对外暴露的接口都需要提前声明argtypes（参数类型）和restype（返回值类型），避免ctypes默认类型转换出错
• 不透明结构体指针统一用c_void_p承载即可，不需要在Python侧还原完整结构体定义
• 按引用传递变量时，用ctypes.byref(变量对象)即可，等价于C语言的取地址符&
• 传递字符串参数时，需要先把Python的str类型编码为bytes类型，可通过字符串.encode('utf-8')实现

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