最近要使用python调用C++编译生成的DLL动态链接库,因此学习了一下ctypes库的基本使用。
ctypes是一个用于Python的外部函数库,它提供C兼容的数据类型,并允许在DLL或共享库中调用函数。
一、Python调用DLL里面的导出函数
生成dll
1.1 新建动态链接库项目
在中输入以下内容:
// : 定义 DLL 应用程序的导出函数。
//
#include ""
#define DLLEXPORT extern "C" __declspec(dllexport) //放在 #include "" 之后
//两数相加
DLLEXPORT int sum(int a, int b) {
return a + b;
}
注意:导出函数前面要加 extern "C" __declspec(dllexport) ,这是因为ctypes只能调用C函数。如果不用extern "C",构建后的动态链接库没有这些函数的符号表。采用C++的工程,导出的接口需要extern "C",这样python中才能识别导出的函数。
生成dll动态链接库
因为我的python3是64位的,所以VS生成的dll要选择64位的,如下所示:
点击标题栏的 生成 -> 生成解决方案
查看生成的dll动态链接库
导入dll动态链接库
用python将动态链接库导入,然后调用动态链接库的函数。为此,新建文件,输入如下内容:
from ctypes import *
#----------以下四种加载DLL方式皆可—————————
# pDLL = WinDLL("./")
# pDll = ("./")
# pDll = ("./")
pDll = CDLL("./")
#调用动态链接库函数
res = (1,2)
#打印返回结果
print(res)
运行结果如下所示:
二、Python调用DLL里面的实例方法更新全局变量值
生成dll
1.1 添加 mainClass 类,内容如下:
:
#pragma once
extern int dta;
class mainClass
{
public:
mainClass();
~mainClass();
void produceData();
};
:
#include ""
#include ""
int dta = 0;
mainClass::mainClass()
{
}
mainClass::~mainClass()
{
}
void mainClass::produceData() {
dta = 10;
}
更改 内容
:
#include ""
#define DLLEXPORT extern "C" __declspec(dllexport) //放在 #include "" 之后
#include ""
//返回实例方法里面更新数据后的值
DLLEXPORT int getRandData() {
mainClass dataClass = mainClass();
();
return dta;
}
生成64位dll
导入dll动态链接库
明显可以看出,在C++里设置的全局变量的值已经从0变为10了,说明python可以通过调用dll里面的实例方法来更新全局变量值
三、Python_ctypes 指定函数参数类型和返回类型
前面两个例子C++动态链接库导出函数的返回类型都是int型,而Python 默认函数的参数类型和返回类型为 int 型,所以Python 理所当然的 以为 dll导出函数返回了一个 int 类型的值。但是如果C++动态链接库导出的函数返回类型不是int型,而是特定类型,就需要指定ctypes的函数返回类型 restype 。同样,通过ctypes给函数传递参数时,参数类型默认为int型,如果不是int型,而是特定类型,就需要指定ctypes的函数形参类型 argtypes 。
接下来,我将举一个简单例子来说明一下
:
#include ""
#define DLLEXPORT extern "C" __declspec(dllexport) //放在 #include "" 之后
#include <string> //使用string类型 需要包含头文件 <string>
using namespace std; //string类是一个模板类,位于名字空间std中
//字符串
DLLEXPORT char *getRandData(char *arg) {
return arg;
}
python代码:
from ctypes import *
pDll = CDLL("./")
########## 指定 函数的参数类型 #################
.argtypes = [c_char_p]
#第一个参数
arg1 = c_char_p(bytes("hello", 'utf-8'))
########## 指定 函数的返回类型 #################
.restype = c_char_p
########### 调用动态链接库函数 ##################
res = (arg1)
#打印返回结果
print(()) #返回的是utf-8编码的数据,需要解码
或者如下形式:
from ctypes import *
pDll = CDLL("./")
########## 指定 函数的返回类型 #################
.restype = c_char_p
########### 调用动态链接库函数 ##################
res = (b'hello') # 或者变量.encode()
#打印返回结果
print(()) #返回的是utf-8编码的数据,需要解码
运行结果:
四、Python_ctypes dll返回数组_结构体
在ctypes里,可以把数组指针传递给dll,但是我们无法通过dll获取到c++返回的数组指针。由于python中没有对应的数组指针类型,因此,要获取dll返回的数组,我们需要借助结构体。
:
#include ""
#define DLLEXPORT extern "C" __declspec(dllexport) //放在 #include "" 之后
#include <string> //使用string类型 需要包含头文件 <string>
using namespace std; //string类是一个模板类,位于名字空间std中
typedef struct StructPointerTest
{
char name[20];
int age;
int arr[3];
int arrTwo[2][3];
}StructTest, *StructPointer;
//sizeof(StructTest)就是求 struct StructPointerTest 这个结构体占用的字节数
//malloc(sizeof(StructTest))就是申请 struct StructPointerTest 这个结构体占用字节数大小的空间
//(StructPointer)malloc(sizeof(StructTest))就是将申请的空间的地址强制转化为 struct StructPointerTest * 指针类型
//StructPointer p = (StructPointer)malloc(sizeof(StructTest))就是将那个强制转化的地址赋值给 p
StructPointer p = (StructPointer)malloc(sizeof(StructTest));
//字符串
DLLEXPORT StructPointer test() // 返回结构体指针
{
strcpy_s(p->name, "Lakers");
p->age = 20;
p->arr[0] = 3;
p->arr[1] = 5;
p->arr[2] = 10;
for (int i = 0; i < 2; i++)
for (int j = 0; j < 3; j++)
p->arrTwo[i][j] = i*10+j;
return p;
}
python代码:
# 返回结构体
import ctypes
path = r'./'
dll = (path)
#定义结构体
class StructPointer(): #Structure在ctypes中是基于类的结构体
_fields_ = [("name", * 20), #定义一维数组
("age", ),
("arr", * 3), #定义一维数组
("arrTwo", ( * 3) * 2)] #定义二维数组
#设置导出函数返回类型
.restype = ctypes.POINTER(StructPointer) # POINTER(StructPointer)表示一个结构体指针
#调用导出函数
p = ()
print(()) #返回要指向点的对象 #返回的字符串是utf-8编码的数据,需要解码
print(.age)
print(.arr[0]) #返回一维数组第一个元素
print(.arr[:]) #返回一维数组所有元素
print(.arrTwo[0][:]) #返回二维数组第一行所有元素
print(.arrTwo[1][:]) #返回二维数组第二行所有元素
运行结果:
以上就是python使用ctypes库调用DLL动态链接库的详细内容,更多关于python 调用DLL动态链接库的资料请关注脚本之家其它相关文章!