python3 ctypes模块使用方法与心得体会--- int* ,char*等指针类型互转

Fu_Lin_

已于 2023-06-15 16:15:39 修改

阅读量7.9k

点赞数 28

分类专栏： Python 文章标签： python 开发语言

于 2020-08-11 09:18:14 首次发布

本文链接：https://blog.csdn.net/CLinuxF/article/details/107913199

版权

Python 专栏收录该内容

39 篇文章 3 订阅

订阅专栏

文章目录

欢迎大家关注我的公众号，内有 PyCharm 专业版 安装教程，csdn不允许发布此等博客，
更有大量PDF书籍下载
在这里插入图片描述

前言

需求是python3 和 C写的dll打交道，调用dll中的方法，但是要传递参数，char还好一点，int搞了半天才搞定，所以想着还是记录下，以免后面忘记了

网上找了好多文章，没有什么满意，自己总结了些七七八八的汇总，也算是将网上七七八八的文章取其精华，去其糟粕！！！

看完了觉得可以的点个赞，觉得无用的也不要吐槽，只是单纯的记录，毕竟烂大街的知识了，我只是汇总一下，以免多浪费时间

正文

1 简介

ctypes是一个自Python 2.5开始引入的，Python自带的函数库。其提供了一系列与C、C++语言兼容的数据结构类与方法，可基于由C源代码编译而来的DLL动态链接库文件，进行Python程序与C程序之间的数据交换与相互调用。本文基于Python 3.6.3

注意，在使用ctypes的过程中，Python解释器与C编译器所支持的位数必须一致，即：32位Python解释器必须与32位C编译器配合使用，同理，64位编译器也必须保持一致使用，否则将很有可能导致DLL文件无法被解析、调用等问题。

2. DLL文件解析与简单函数调用

我在这边只强调类型互转，至于dll的调用不做过多介绍，下面会写出调用示例，不再讲解

首先，为方便起见，本文中所有的模块导入均通过“*”语法导入，但在实际代码的编写中，强烈不建议使用这种语法：

from ctypes import *

python3 加载dll 并调用其方法

当编译好一个dll或so动态库文件后，在Python中就可通过ctypes模块去解析与调用了。解析dll文件可调用CDLL函数，其接受dll文件名作为参数，返回一个解析后的实例对象：

dllObj = CDLL('xx.dll')

取得此对象后，即可像调用实例方法那样，以此对象调用dll文件中的各种函数。也就是说，dll文件中的所有函数，在经过CDLL函数解析并返回一个对象后，均可看做是此对象的实例方法，可以以点号的形式进行调用。

假设定义了如下 C源代码，并已编译为 “a.dll”文件：

int addNum(int xNum, int yNum)
{
   return xNum + yNum;
}

而后即可在Python中传入参数并调用此函数：

dllObj = CDLL('a.dll')

print(dllObj.addNum(1, 2))

输出结果为3。

由此可见，当调用CDLL函数解析dll文件，并得到解析对象后，即可像调用实例方法那样调用dll文件中的函数，且函数的参数就是实例方法的参数。

3.基本ctypes数据类型

首先贴出ctypes 数据类型和 C数据类型和 python 类型对照表

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/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_size_t	size_t	nt/long
c_ssize_t	ssize_t or Py_ssize_t	int/long
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/long or None

由上表可以看出，ctypes的命名规律是前置的“c_”加上C语言中的数据类型名，构成ctypes中定义的C语言数据类型。上表中较为常用的类型主要包括c_int、c_double、c_char以及c_char_p等。这三种类型将在下一节详细讨论。

4.函数的输入、输出数据类型

首先考虑如下改写的代码：

double addNum(double xNum, double yNum)
{
   return xNum + yNum;
}

此代码唯一的改动之处在于将上文的addNum函数的输入以及输出的数据类型均由int转成了double。此时如果直接编译此文件，并在Python中调用，就会发现程序抛出了ctypes定义的ctypes.ArgumentError异常，提示参数有错误。

出现此问题的原因在于DLL文件无法在调用其中函数时自动设定数据类型，而如果不对类型进行设定，则调用函数时默认的输入、输出类型均为int。故如果函数的参数或返回值包含非int类型时，就需要对函数的参数以及返回值的数据类型进行设定。

设定某个函数的参数和返回值的数据类型分别通过设定每个函数的argtypes与restype属性实现。argtypes需要设定为一个tuple，其中依次给出各个参数的数据类型，这里的数据类型均指ctypes中定义的类型。同理，由于C语言函数只能返回一个值，故restype属性就需要指定为单个ctypes类型。

对于上文的返回值为double的addNum，代码修改为如下形式即可运行：

dllObj = CDLL('a.dll')

dllObj.addNum.argtypes = (c_double,c_double)

dllObj.addNum.restype = c_double

print(dllObj.addNum(1.1, 2.2))

上述代码在调用addNum之前，分别设定了此函数的输入参数为两个double，返回值也为double，然后以两个小数作为参数调用这个函数，返回值为3.3，结果正确。

对于一个返回值类型为char指针的C语言函数，则只需要设定restype为c_char_p，函数即可直接返回Python的str类型至Python代码中。例：

设有如下返回字符串指针的C语言函数：

char * helloStr()
{
   return "Hello!";
}

则Python的调用代码：

dllObj = CDLL('a.dll')

dllObj.addNum.restype = c_char_p

print(dllObj.helloStr())

上述代码调用了返回字符串指针的helloStr函数，并先行设定返回值类型为c_char_p，则调用后即可直接获得一个Python字符串 “Hello！”。

5. 类方法的调用

对于C++中类方法的调用，可以通过多种方法实现。一般情况下，可以编写一个函数，其中动态地声明一个实例指针，然后通过指针调用某个类方法，调用完成后，再释放此时动态申请的内存。例：

extern "C"
{
   void hello();
}

class Test
{
   public:
       void hello();
};

void Test::hello()
{
   printf("Hello!");
}

void hello()
{
   Test *testP = new Test;

   testP -> hello();

   delete testP;
}

上述代码定义了一个Test类，而后定义了一个Test类的hello方法，再定义了一个名为hello的函数作为接口函数。在接口函数中，首先通过new语句创建了一个实例指针，然后通过此指针调用了Test类的hello方法，调用完成后，再释放此指针。故在Python中，只需要调用这个接口函数hello，即可实现调用Teat类中的hello方法。