技术标签: python调用c动态库函数
本文以windows环境下的.dll动态链接库为背景展开,有关linux下的.so动态链接库的相关用法会在另外一篇文章中展开讲解。
1. 背景知识
一直以来python都被称为胶水语言,能够轻易地操作其他程序,轻易地包装使用其他语言编写的库。下面简单介绍下如何使用python来调用C/C++编写的动态库。首先了解下动态链接库及C/C++动态库的区别。
1.1 动态链接库
使用VS2017创建动态链接库DllDemo,代码如下:
//整型相加
__declspec(dllexport) int addInt(int a, int b)
{
return a + b;
}
//浮点型相加
__declspec(dllexport) float addFloat(float a, float b)
{
return a + b;
}
//传递float指针类型参数
__declspec(dllexport) void changeFloat(float *a)
{
*a = 100.00;
}
//传递char指针类型参数,返回指针类型参数
__declspec(dllexport) char* pointCh(char *a)
{
return a;
}
使用dumpbin.exe工具,在cmd命令行使用
dumpbin.exe -exports DllDemo.dll
查看动态库的导出函数如下:
从上图可以看出动态库导出了4个函数,与上面代码中的导出函数一致。但是函数名长得很奇怪,这是因为在编译链接时,C++会按照自己的规则篡改函数的名称,这一过程称为"名字改编",C++支持函数重载,就是在函数名字改编阶段记录下函数的相关参数信息。
C++标准并没有定义名字改编的标准,因此会导致不同编译器编译出来的动态库不能通用。
1.2 extern "C"作用
相比之下,C标准规定了名字改编的标准,extern "C"指示编译器在编译代码是按照C的标准进行编译。
在上述代码的每个函数名前都加上extern "C"关键字。
extern "C" __declspec(dllexport) int addInt(int a, int b)
{
return a + b;
}
extern "C" __declspec(dllexport) float addFloat(float a, float b)
{
return a + b;
}
extern "C" __declspec(dllexport) void changeFloat(float *a)
{
*a = 100.00;
}
extern "C" __declspec(dllexport) char* pointCh(char *a)
{
return a;
}
查看动态库的导出函数,可以看到导出的函数名和函数的定义是一致的。
如果extern "C"修饰的函数进行了重载,则会在编译时报错,因为C语言并不支持函数的重载。
1.3 动态链接库加载方式
1.3.1 隐式链接
隐式链接需要.dll .lib文件
#include
#include
using namespace std;
//隐式加载需要导入动态库的导入库
#pragma comment(lib, "../Debug/DllDemo.lib")
//dll中导出的函数通过直接声明或者包含头文件的方式
extern "C" _declspec(dllimport) int addInt(int a, int b);
extern "C" _declspec(dllimport) float addFloat(float a, float b);
int main()
{
//调用动态库中的函数
cout << addInt(1, 2) << endl;
cout << addFloat(1.25, 2.25) << endl;
}
通过vs自带的工具lib,通过命令lib /list XXXX.lib,可以查看一个.lib文件是静态库还是导入库
1.3.2 显式链接
显式链接需要.dll, 需要事先知道导出函数的签名,不需要.lib和.h文件
#include
#include
using namespace std;
//声明导出函数的类型
typedef int(*addInt)(int a, int b);
typedef float(*addFloat)(float a, float b);
int main()
{
HINSTANCE hDLL;
//定义导出函数
addInt addInt_;
addFloat addFloat_;
//加载动态库,开辟内存
hDLL = LoadLibrary("./DllDemo.dll");
if (hDLL != NULL)
{
//获取导出函数
addInt_ = (addInt)GetProcAddress(hDLL, "addInt");
if (addInt_)
{
cout << addInt_(1, 2) << endl;
}
addFloat_ = (addFloat)GetProcAddress(hDLL, "addFloat");
if (addFloat_)
{
cout << addFloat_(1.25, 2.25) << endl;
}
//卸载动态库,释放内存
FreeLibrary(hDLL);
}
return 0;
}
使用显式加载的好处:
通过显式加载动态库的方式可以根据需要加载相应的函数,随时可以卸载,通过判断句柄的方式,不会因为找不到dll导致程序无法启动。
如果程序需要访问十多个dll,采用动态加载的方式可以减少程序的启动时间,减小程序占用的内存
2. python操作动态库
python操作动态库是通过ctypes这个内建的包,官方文档ctypes。因为上述C++动态库“名字改编”的问题,导致直接使用C++代码中函数名字时无法调用,必须使用经过名字改编之后的函数名,在使用C++编译的动态链接库时,最好使用extern "C"来辅助,可以通过对C++动态库进行简单的封装转换为C动态库,这样可以在使用时直接调用动态库中定义的函数即可,不需要考虑函数“名字改编”的问题。
先上代码:
#--*--utf8--*--
from ctypes import *
# 加载动态库
Objdll = cdll.LoadLibrary('DllDemo.dll')
def dllTest():
# python调用动态库默认参数为整型
print(Objdll.addInt(10, 20))
# 直接调用addFloat接口
print(Objdll.addFloat(10, 2))
# 设置动态库函数的参数和返回值类型为float
Objdll.addFloat.restype = c_float
Objdll.addFloat.argtypes = (c_float, c_float)
print(Objdll.addFloat(10.0, 20.0))
# 设置动态库的参数类型float*
infloat = c_float(1.0)
Objdll.changeFloat.restype = None
Objdll.changeFloat.argtypes = (POINTER(c_float), )
Objdll.changeFloat(byref(infloat))
print(infloat.value)
# 设置动态库的参数类型为char*
pInCh = bytes('Hello World', 'utf-8')
Objdll.pointCh.restype = c_char_p
Objdll.pointCh.argtypes = (c_char_p, )
pOutCh = Objdll.pointCh(pInCh)
print(pOutCh.decode('utf-8'))
if __name__ == "__main__":
dllTest()
代码输出:
2.1 加载动态库
Objdll = cdll.LoadLibrary('DllDemo.dll')
2.2 指定函数命名
查看在上图中直接调用addFloat的代码输出
# 直接调用addFloat接口
print(Objdll.addFloat(10, 2))
发现输出的结果并不是预期的12.0而是一个特别大的数字,这是因为python在调用动态库的函数时,如果不进行指定,则默认的参数类型和返回值类型均为整型,且调用时不会像在C/C++中一样进行自动的类型转换。python在调用动态库中的函数时需要指定函数的参数类型和返回值类型。
通过Objdll._FuncPtr.restype来指定动态库函数的返回值类型,通过Objdll._FuncPtr.argtypes来指定动态库函数的参数类型,Objdll._FuncPtr.argtypes的类型为turple,包含动态库函数的参数类型列表,指定的参数类型必须为C/C++中参数类型所对应的ctypes类型。
2.3 参数类型
python类型和C语言类型的对应关系:
ctypes type
C type
python type
c_bool
_Bool
bool (1)
c_char
char
1-character bytes object
c_wchar
wchar_t
1-character string
c_byte
char
int
c_ubyte
unsigned char
int
c_short
short
int
c_ushort
unsigned short
int
c_int
int
int
c_uint
unsigned int
int
c_long
long
int
c_ulong
unsigned long
int
c_longlong
__int64 or long long
int
c_ulonglong
unsigned __int64 or unsigned long long
int
c_size_t
size_t
int
c_ssize_t
ssize_t or Py_ssize_t
int
c_float
float
float
c_double
double
float
c_longdouble
long double
float
c_char_p
char * (NUL terminated)
bytes object or None
c_wchar_p
wchar_t * (NUL terminated)
string or None
c_void_p
void *
int or None
2.3.1 值类型
对于参数类型和返回值类型都为值类型的动态库函数,操作相对简单,只需要指定对应的参数和返回值ctype类型即可进行调用。
2.3.2 指针类型
创建ctypes类型的指针需要借助三个相关的函数:
函数
说明
byref(x[,offset])
返回x的地址,相当于C的&x。可选参数offset表示偏移量
pointer(x)
创建并返回一个指向x的指针实例,x是一个实例对象
POINTER(x)
返回一个类型,这个类型是指向ctypes类型的指针类型
byref相当于C的取地址符号,在参数传递时可以通过byref传递函数的指针。pointer的POINTER的区别是,pointer返回的是一个实例,而POINTER返回的是一个类型。
动态库函数原型:
extern "C" __declspec(dllexport) void changeFloat(float *a)
{
*a = 100.00;
}
python中调用:
# 加载动态库
Objdll = cdll.LoadLibrary('DllDemo.dll')
# 定义函数参数
infloat = c_float(1.0)
# 指定函数返回值类型为void
Objdll.changeFloat.restype = None
# 指定函数的参数类型为float*
Objdll.changeFloat.argtypes = (POINTER(c_float), )
# 调用函数,通过byref函数将参数包装成float*类型
Objdll.changeFloat(byref(infloat))
# 打印结果
print(infloat.value)
2.3.3 引用类型
C语言中没有引用类型,如果动态库是由C++编写存在引用类型参数的函数,需要先用指针类型包装成C动态库。
2.3.4 结构体类型
动态库函数定义:
typedef struct _SimpleStruce
{
int nNo;
float fVirus;
char szBuffer[512];
}SimpleStruct, *PSimpleStruct;
extern "C" __declspec(dllexport) int PrintStruct(PSimpleStruct simp)
{
cout << "nNo: " << simp->nNo << ", fVirus: " << simp->fVirus << ", szBuffer: " << simp->szBuffer << endl;
return simp->nNo;
}
python中调用
# 定义class和动态库中的类型相对应,成员变量名必须一致
class SimpStruct(Structure):
_fields_ = [("nNo", c_int), ("fVirus", c_float), ("szBuffer", c_char*512)]
# 定义变量,并对各个成员变量名进行赋值
simpStruct = SimpStruct()
simpStruct.nNo = 16
simpStruct.fVirus = 3.14
simpStruct.szBuffer = bytes('Hello World','utf-8')
# 定义函数的参数和返回值
Objdll.PrintStruct.restype = c_int
Objdll.PrintStruct.argtypes = (POINTER(SimpStruct),)
# 调用动态库函数,传递结构体指针
resnNo = Objdll.PrintStruct(byref(simpStruct))
# 打印动态库函数返回值
print(resnNo)
python调用结果:
nNo: 16, fVirus: 3.14, szBuffer: Hello World
16
3.总结
总结起来,在python中调用dll中方法的一般步骤为:
使用extern c关键字对dll进行包装。
使用ctypes库加载动态库。
根据C中类型和ctypes中类型的对应关系指定动态库函数的返回值类型和参数类型。
调用动态库中的函数。
对函数的返回结果进行转换成python中的类型进行使用。
文章浏览阅读3.4k次,点赞8次,收藏42次。一、什么是内部类?or 内部类的概念内部类是定义在另一个类中的类;下面类TestB是类TestA的内部类。即内部类对象引用了实例化该内部对象的外围类对象。public class TestA{ class TestB {}}二、 为什么需要内部类?or 内部类有什么作用?1、 内部类方法可以访问该类定义所在的作用域中的数据,包括私有数据。2、内部类可以对同一个包中的其他类隐藏起来。3、 当想要定义一个回调函数且不想编写大量代码时,使用匿名内部类比较便捷。三、 内部类的分类成员内部_成员内部类和局部内部类的区别
文章浏览阅读118次。分布式系统要求拆分分布式思想的实质搭配要求分布式系统要求按照某些特定的规则将项目进行拆分。如果将一个项目的所有模板功能都写到一起,当某个模块出现问题时将直接导致整个服务器出现问题。拆分按照业务拆分为不同的服务器,有效的降低系统架构的耦合性在业务拆分的基础上可按照代码层级进行拆分(view、controller、service、pojo)分布式思想的实质分布式思想的实质是为了系统的..._分布式系统运维工具
文章浏览阅读174次。1.数据源准备2.数据处理step1:数据表处理应用函数:①VLOOKUP函数; ② CONCATENATE函数终表:step2:数据透视表统计分析(1) 透视表汇总不同渠道用户数, 金额(2)透视表汇总不同日期购买用户数,金额(3)透视表汇总不同用户购买订单数,金额step3:讲第二步结果可视化, 比如, 柱形图(1)不同渠道用户数, 金额(2)不同日期..._exce l趋势分析数据量
文章浏览阅读3.3k次。堡垒机可以为企业实现服务器、网络设备、数据库、安全设备等的集中管控和安全可靠运行,帮助IT运维人员提高工作效率。通俗来说,就是用来控制哪些人可以登录哪些资产(事先防范和事中控制),以及录像记录登录资产后做了什么事情(事后溯源)。由于堡垒机内部保存着企业所有的设备资产和权限关系,是企业内部信息安全的重要一环。但目前出现的以下问题产生了很大安全隐患:密码设置过于简单,容易被暴力破解;为方便记忆,设置统一的密码,一旦单点被破,极易引发全面危机。在单一的静态密码验证机制下,登录密码是堡垒机安全的唯一_horizon宁盾双因素配置
文章浏览阅读7.7k次,点赞4次,收藏16次。Chrome作为一款挺不错的浏览器,其有着诸多的优良特性,并且支持跨平台。其支持(Windows、Linux、Mac OS X、BSD、Android),在绝大多数情况下,其的安装都很简单,但有时会由于网络原因,无法安装,所以在这里总结下Chrome的安装。Windows下的安装:在线安装:离线安装:Linux下的安装:在线安装:离线安装:..._chrome linux debian离线安装依赖
文章浏览阅读153次。中国发达城市榜单每天都在刷新,但无非是北上广轮流坐庄。北京拥有最顶尖的文化资源,上海是“摩登”的国际化大都市,广州是活力四射的千年商都。GDP和发展潜力是衡量城市的数字指...
文章浏览阅读3.3k次。前言spark在java使用比较少,多是scala的用法,我这里介绍一下我在项目中使用的代码配置详细算法的使用请点击我主页列表查看版本jar版本说明spark3.0.1scala2.12这个版本注意和spark版本对应,只是为了引jar包springboot版本2.3.2.RELEASEmaven<!-- spark --> <dependency> <gro_使用java调用spark注册进去的程序
文章浏览阅读4.8k次。汽车零部件开发工具巨头V公司全套bootloader中UDS协议栈源代码,自己完成底层外设驱动开发后,集成即可使用,代码精简高效,大厂出品有量产保证。:139800617636213023darcy169_uds协议栈 源代码
文章浏览阅读4.6k次,点赞20次,收藏148次。AUTOSAR基础篇之OS(下)前言首先,请问大家几个小小的问题,你清楚:你知道多核OS在什么场景下使用吗?多核系统OS又是如何协同启动或者关闭的呢?AUTOSAR OS存在哪些功能安全等方面的要求呢?多核OS之间的启动关闭与单核相比又存在哪些异同呢?。。。。。。今天,我们来一起探索并回答这些问题。为了便于大家理解,以下是本文的主题大纲:[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-JCXrdI0k-1636287756923)(https://gite_autosar 定义了 5 种多核支持类型
文章浏览阅读2.2k次,点赞6次,收藏14次。原因:自己写的头文件没有被加入到方案的包含目录中去,无法被检索到,也就无法打开。将自己写的头文件都放入header files。然后在VS界面上,右键方案名,点击属性。将自己头文件夹的目录添加进去。_vs2013打不开自己定义的头文件
文章浏览阅读3.3w次,点赞80次,收藏342次。此时,可以将系统中所有用户的 Session 数据全部保存到 Redis 中,用户在提交新的请求后,系统先从Redis 中查找相应的Session 数据,如果存在,则再进行相关操作,否则跳转到登录页面。此时,可以将系统中所有用户的 Session 数据全部保存到 Redis 中,用户在提交新的请求后,系统先从Redis 中查找相应的Session 数据,如果存在,则再进行相关操作,否则跳转到登录页面。当数据量很大时,count 的数量的指定可能会不起作用,Redis 会自动调整每次的遍历数目。_redis命令
文章浏览阅读449次,点赞3次,收藏3次。URP的设计目标是在保持高性能的同时,提供更多的渲染功能和自定义选项。与普通项目相比,会多出Presets文件夹,里面包含着一些设置,包括本色,声音,法线,贴图等设置。全局只有主光源和附加光源,主光源只支持平行光,附加光源数量有限制,主光源和附加光源在一次Pass中可以一起着色。URP:全局只有主光源和附加光源,主光源只支持平行光,附加光源数量有限制,一次Pass可以计算多个光源。可编程渲染管线:渲染策略是可以供程序员定制的,可以定制的有:光照计算和光源,深度测试,摄像机光照烘焙,后期处理策略等等。_urp渲染管线