ctypes
是一个用于Python的外部函数库。它提供C兼容的数据类型,并允许在DLL或共享库中调用函数。它可以用来将这些库封装在纯Python中
1.使用Visual Studio创建dll
点击完成,创建dll导出函数,下代码为C++代码
// test_dll.cpp : 定义 DLL 应用程序的导出函数。
//
#include "stdafx.h"
//用于简单测试
extern "C" _declspec(dllexport) int add(int a, int b);
int add(int a, int b)
{
return a+b;
}
//用于指针的使用
extern "C" _declspec(dllexport) int * add_pointer(int a, int b);
int * add_pointer(int a, int b)
{
int *c = new int;
*c = a + b;
return c;
}
extern "C" _declspec(dllexport) int get_value(int *a);
int get_value(int *a)
{
int b = *a;
delete a;
return b;
}
//用于字符串使用
extern "C" _declspec(dllexport) char * str(char *a);
char * str(char *a)
{
return a;
}
//用于测试结构体使用
struct Rect{
int left;
int top;
int right;
int bottom;
};
extern "C" _declspec(dllexport) Rect struct_rect(Rect a);
Rect struct_rect(Rect a)
{
a.left += 5;
a.top += 5;
return a;
}
//用于数组测试
extern "C" _declspec(dllexport) int array1(int arr[]);
int array1(int arr[])
{
return arr[0];
}
2.ctypes引用dll调用函数
引用dll 有四个方法
CDLL(dllPath),WINDLL(dllPath),cdll.LoadLibrary(dllpath),windll.LoadLibrary(dllpath)
基本测试
from ctypes import *
dll = CDLL(r"C:\Users\DELL\Documents\visual studio 2013\Projects\test_dll\x64\Debug\test_dll.dll")#引入dll
num = dll.add(5,6)#调用函数
print(num)
ctypes支持的原生数据类型如下:
ctypes类型 | C类型 | Python类型 |
---|---|---|
c_bool | _Bool | bool (1) |
c_char | char | 1-character string |
c_wchar | wchar_t | 1-character unicode string |
c_byte | char | int/long |
c_ubyte | unsigned char | int/long |
c_short | short | int/long |
c_ushort | unsigned short | int/long |
c_int | int | int/long |
c_uint | unsigned int | int/long |
c_long | long | int/long |
c_ulong | unsigned long | int/long |
c_longlong | __int64 or long long | int/long |
c_ulonglong | unsigned __int64 or unsigned long long | int/long |
c_float | float | float |
c_double | double | float |
c_longdouble | long double | float |
c_char_p | char * (NUL terminated) | string or None |
c_wchar_p | wchar_t * (NUL terminated) | unicode or None |
c_void_p | void * | int/long or None |
指针使用
num1 = dll.add_pointer(5,6)
print(num1)
num1 = dll.get_value(num1)
porint(num1)
如果如上面代码直接获取指针和引用指针会64位的python会报出如:
OSError: exception: access violation reading 0xFFFFFFFFF179FBC0
如下图:
而且指针成了负数,应该事因为ctypes默认的返回类型都是有符号int, 最高位表示正负的原因
解决办法:
指定dll 函数的返回类型如下代码
dll.add_pointer.restype = c_uint64 #指定函数返回指针类型为c_uint64
num1_pointer =dll.add_pointer(5,6)
num1 = dll.get_value(c_uint64(num1_pointer))#参数指针类型为c_uint64
3.字符串使用
dll.str.restype = c_char_p #c_char_p对应char指针指定返回类型为c_char_p
str = dll.str( c_char_p(bytes("可以",encoding="utf-8")))#字符串参数,将字符串解码,再转(c_char_p)
print(str.decode()) #字节编码成字符串
4 结构体使用
结构体
struct Rect{
int left;
int top;
int right;
int bottom;
};
python 对应class类
class Rect(Structure):
_fields_ = [
("left", c_int),
("top", c_int),
("right", c_int),
("bottom", c_int),
]
结构体引用
class Rect(Structure):
_fields_ = [
("left", c_int),
("top", c_int),
("right", c_int),
("bottom", c_int),
]
rect = Rect(5,5,5,5)
dll.struct_rect.restype = Rect #确定返回类型为Rect
rect = dll.struct_rect(rect) # 参数直接使用对象
print(rect.left,rect.top)
5数组的使用
arr = (c_uint*5)(1,2,3,4,5) #ctypes定义C类型数据方法
i = dll.array1(arr)
print(1)
numpy 数组传入C/C++方法
arr1 = np.array([2, 3, 4])
if not arr1.flags['C_CONTIGUOUS']:
arr1 = np.ascontiguous(arr1, dtype=arr1.dtype) # 如果不是C连续的内存,必须强制转换
arr1_point = cast(arr1.ctypes.data,POINTER(c_uint)) #转换为ctypes,这里转换后的可以直接利用ctypes转换为c中的int*,然后在c中使用