python使用ctypes调用C编译dll函数方法

1 生成被调用的C dll

1.1 C文件编译为C动态链接库

  • 在windows下,需要配置visual studio的工程设置,将工程编译为dll,细节不在这里赘述
  • gcc环境下,需要编译为.so文件,需要修改makefile的链接参数,这里也不再赘述

1.2 用于外部引用的C函数声明

1.2.1 声明用于作为dll符号给外部调用

在函数声明加入前缀,如
__declspec(dllexport) int Fun(int a, int b)
否则在加载该dll时会提示找不到该符号

在windows下可以通过vs自带的dumpbin工具查看可被调用符号
dumpbin /exports test.dll

1.2.2 C函数的调用规定

C函数在调用过程中关于参数传递和压栈由多种规定,作为dll提供给其他程序调用时,必须明确并统一为同一种调用规定,否则会导致栈破坏,编译器负责具体实现调用规定,主要有以下几种调用规定

调用规定 声明 编译符号修饰 调用规则 说明
_stdcall __declspec(dllexport) int __stdcall fun(int a, int b) _fun@number 参数从右向左入栈,调用者压栈,被调者负责弹栈 win32 API默认调用规则
_cdecl __declspec(dllexport)int __cdecl fun(int a, int b) _fun 参数从右向左入栈,调用者负责压栈和弹栈 C/C++默认调用规则
_fastcall __declspec(dllexport)int __fastcall fun(int a, int b) @fun@number 寄存器和栈共同参数与参数传递 寄存器传参提高性能,难以跨平台

2 ctypes加载dll库接口

python下调用C库有多种方式,ctypes是其中一种比较方便的,调用时首先需要加载dll文件,根据C dll的调用规定不同需要使用不同接口,使用ctypes需要import ctypes

  • 对于stdcall的C dll
import ctypes
Objdll = ctypes.windll.LoadLibrary("dllpath") #接口1
Objdll = ctypes.WinDLL("dllpath") #接口2

以上两种接口都是可用的

  • 对于cdecl的C dll
import ctypes
Objdll = ctypes.cdll.LoadLibrary("dllpath")  
Objdll = ctypes.CDLL("dllpath")  

对于简单的C函数,例如int add(int a, int b), 此时就可以直接调用了,如

import ctypes
Objdll = ctypes.cdll.LoadLibrary("dllpath")  
Objdll = ctypes.CDLL("dllpath")  

c = Objdll.all(1,3)
print(c) # 4

3 ctypes调用C函数参数传递

对于较复杂的C函数的参数情况,ctypes调用时对入参和出餐做一定处理,这里分情况讨论

3.1 出参为指针

  • C代码
/* Divide two numbers */
int divide(int a, int b, int *remainder)
{
    int quot = a / b;
    *remainder = a % b;
    return quot;
 }
  • python代码
# int divide(int, int, int *)
_divide = _mod.divide_divide.argtypes = (ctypes.c_int, ctypes.c_int, ctypes.POINTER(ctypes.c_int))_divide.restype = ctypes.c_int

def divide(x, y):
    rem = ctypes.c_int()
    quot = _divide(x, y, rem)

    return quot,rem.value

3.2 入参为字符串

  • C代码
void PrintfInfo(char *str)
{
    printf("the str is %s\n", str);
}
  • python代码
sBuf = 'aaaaaaaaaabbbbbbbbbbbbbb'
pStr = ctypes.c_char_p( )
pStr.value = sBuf.decode() #c_char_p类型的value只接受bytes类型数据

dll.PrintInfo(pStr)

这里使用了ctypes的内置类型c_char_p,对应于C的char数组,更多ctypes类型与C类型对照在后面附上

3.4 入/出参为结构体

  • C代码

typedef struct   

{  

char words[10];  

}keywords;  



typedef struct   

{  

keywords *kws;  

unsigned int len;  

}outStruct;  

extern "C"int __declspec(dllexport) test(outStruct *o);  

int test(outStruct *o)  

{  

unsigned int i = 4;  

o->kws = (keywords *)malloc(sizeof(unsigned char) * 10 * i);  

strcpy(o->kws[0].words, "The First Data");  

strcpy(o->kws[1].words, "The Second Data");  



o->len = i;  

return 1;  

}  
  • python代码
# C结构体需要专门定义class对应
class keywords(Structure):  

        _fields_ = [('words', c_char *10),]  



class outStruct(Structure):  

        _fields_ = [('kws', POINTER(keywords)),  

                    ('len', c_int),]  

o = outStruct()  

dll.test(byref(o))  



print o.kws[0].words;  

print o.kws[1].words;  

print o.len  

以上包含了几种主要的参数传递情况,ctypes也提供了一个较为完整的python类型和C类型的对照,如下:


image.png
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 196,099评论 5 462
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 82,473评论 2 373
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 143,229评论 0 325
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,570评论 1 267
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,427评论 5 358
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,335评论 1 273
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,737评论 3 386
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,392评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,693评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,730评论 2 312
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,512评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,349评论 3 314
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,750评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,017评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,290评论 1 251
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,706评论 2 342
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,904评论 2 335

推荐阅读更多精彩内容