Python调用C++类库 (踩坑日志)
起因
开发自动化工具过程中，需要使用专业的测试射频参数的仪器IQmeasure，厂家提供的API只用C ++版本。
客户端使用python（wxpython）开发，所以遇到了python调用C ++类库的问题。
环境
- PyCharm2020
- python3.6.12 32位 （python3.8无法使用，64位python无法使用；其他版本未测试）
- IQmeasure_SCPI.dll （供应商给的dll包）
- IQmeasure.chm （dll对应的文档）
参考资料
使用
使用前请先浏览ctypes官方文档
- 创建一个新项目（python使用3.6.12 32位版本）
- 将dll文件放入根目录
- 根目录创建main.py
目录结构如下
test
├── IQmeasure_SCPI.dll
├── venv
└── main.py
基础使用方法如下（main.py）:
from ctypes import *
# 加载dll包
iq = cdll.LoadLibrary('./IQmeasure_SCPI.dll')
# 调用方法
init_result = iq.LP_Init(c_int(0), c_int(1))
print('init_result:', init_result) # init_result: 0
# 该方法中，返回0为成功
# 原C++文档中，该方法如下：
# int LP_Init(int IQtype = IQTYPE_XEL,int testerControlMethod = 1);
知识点
- 使用ctypes.cdll.LoadLibrary()加载dll包
- 参数需要转换为c的类型（如c_int()，不理解的先看一下参考资料 ctypes的python官方文档 ）
- 在C++中的可选参数，在使用python调用时不可省略，请传入方法中的默认值
有返回值
from ctypes import *
# 加载dll包
iq = cdll.LoadLibrary('./IQmeasure_SCPI.dll')
# 有返回值
# 设置返回值类型
iq.LP_GetErrorString.restype = c_char_p
# 设置初始值类型
iq.LP_GetErrorString.argtypes = [c_int]
msg = iq.LP_GetErrorString(c_int(10))
print(msg) # b'Invalid analysis type'
# 转换为string
str_msg = msg.decode("utf-8")
print(str_msg) # VSA number is out of range. Try 1-4.
# 原C++文档中，该方法如下：
# char* LP_GetErrorString(int err)
知识点
- 有返回值时，使用 .方法名.restype 设置返回值类型
- 参数值也可使用类似方法设置，使用 .方法名.argtypes 设置参数类型
参数值为 *类型
简单得查了资料，带 * 好像是指针类型吧，开发着急所以没有深入学习了，类似int * ， char * 这样的
# ...省略加载dll
# 参数值为*类型
# 使用byref()，包装对应类型即可
iq.LP_SetTesterMode(c_int(0), byref(c_int(1)), c_int(1))
# 原C++文档中，该方法如下：
# int LP_SetTesterMode( int signalMode = UP_TO_80MHZ_SIGNAL, int *selectedModules = NULL, int numOfSelectedModules = 1 );
知识点
- 参数为*类型的参数，使用byref包装
引用类型参数
# ...省略加载dll
version = create_string_buffer(4096)
iq.LP_GetVersion(version, 4096)
version_result = version.value.decode("utf-8")
# 原C++文档中，该方法如下：
# 该方法会改变*buffer，python中需要读取*buffer的值
# bool LP_GetVersion(char *buffer, int buf_size);
知识点
- 方法参数传入后，方法会改变原参数，需要读取改参数的新值
- 先创建一个buffer
- 调用方法
- 将buffer转换回来
完整测试代码
from ctypes import *
# 加载dll包
iq = cdll.LoadLibrary('./IQmeasure_SCPI.dll')
# 调用方法
init_result = iq.LP_Init(c_int(0), c_int(1))
print('init_result:', init_result) # init_result: 0
# 该方法中，返回0为成功
# 原C++文档中，该方法如下：
# int LP_Init(int IQtype = IQTYPE_XEL,int testerControlMethod = 1);
# 有返回值
# 设置返回值类型
iq.LP_GetErrorString.restype = c_char_p
# 设置初始值类型
iq.LP_GetErrorString.argtypes = [c_int]
msg = iq.LP_GetErrorString(c_int(10))
print(msg) # b'Invalid analysis type'
# 转换为string
str_msg = msg.decode("utf-8")
print(str_msg) # VSA number is out of range. Try 1-4.
# 原C++文档中，该方法如下：
# char* LP_GetErrorString(int err)
# 参数值为*类型
# 使用byref()，包装对应类型即可
iq.LP_SetTesterMode(c_int(0), byref(c_int(1)), c_int(1))
# 原C++文档中，该方法如下：
# int LP_SetTesterMode( int signalMode = UP_TO_80MHZ_SIGNAL, int *selectedModules = NULL, int numOfSelectedModules = 1 );
version = create_string_buffer(4096)
iq.LP_GetVersion(version, 4096)
version_result = version.value.decode("utf-8")
# 原C++文档中，该方法如下：
# 该方法会改变*buffer，python中需要读取*buffer的值
# bool LP_GetVersion(char *buffer, int buf_size);
总结
因为对C ++不甚了解，对C ++部分的解释、名词有偏差，水平限制勿怪，欢迎私信纠正。
内容为本人和骆小萍同学在开发实践中得到
以上
