0

0

Python ctypes结构体深度复制指南

聖光之護

聖光之護

发布时间:2025-09-25 14:03:01

|

395人浏览过

|

来源于php中文网

原创

Python ctypes结构体深度复制指南

在Python中使用ctypes处理C风格结构体时,若结构体包含指向动态分配数据的指针字段,常规的浅拷贝或copy.deepcopy无法正确复制指针所指向的数据。本教程将详细介绍如何为ctypes.Structure实现一个自定义的深度复制方法,通过from_buffer_copy进行浅拷贝,并针对指针字段手动分配新内存并复制数据,确保复制后的结构体及其所有关联数据完全独立于原结构体。

理解ctypes.Structure与深度复制的挑战

ctypes模块允许python代码与c语言库进行交互,其中ctypes.structure用于定义c语言中的结构体。当一个结构体包含指向其他内存区域的指针(例如ctypes.pointer(ctypes.c_float)),标准的python复制机制(如copy.deepcopy)并不能直接理解并深度复制这些指针所指向的底层c内存数据。

直接尝试使用memmove将数据从一个ctypes.POINTER类型复制到另一个未分配内存的ctypes.POINTER字段,会导致TypeError: invalid type错误,因为POINTER本身只是一个地址,而非实际的数据缓冲区。正确的做法是为复制后的指针字段分配新的内存,然后将原始指针所指向的数据复制到这块新内存中。

实现自定义深度复制方法

为了正确地深度复制一个包含指针字段的ctypes.Structure实例,我们需要一个两阶段的方法:

  1. 对结构体本身进行浅拷贝,以复制所有非指针字段(如c_uint32、c_uint16以及固定大小的数组如c_uint32*9)。
  2. 遍历所有指针字段,为每个指针字段分配新的内存,并将原始指针所指向的数据复制到这块新内存中。

下面以一个名为Group的结构体为例,该结构体包含一个DataChannel指针数组,每个指针指向一个c_float数组,其长度由ChSize数组对应元素决定。

import ctypes as ct

class Group(ct.Structure):
    _fields_ = (('ChSize', ct.c_uint32 * 9),          # 9个通道的尺寸数组
                ('DataChannel', ct.POINTER(ct.c_float) * 9), # 9个指向浮点数数组的指针
                ('TriggerTimeLag', ct.c_uint32),      # 触发时间延迟
                ('StartIndexCell', ct.c_uint16))     # 起始索引单元

    def __repr__(self):
        """
        为Group对象提供一个可读的字符串表示,便于调试。
        它会显示所有字段的值,并特别地展示DataChannel指针所指向的数据内容。
        """
        s = f'Group(ChSize={self.ChSize[:]}, TriggerTimeLag={self.TriggerTimeLag}, StartIndexCell={self.StartIndexCell})\n'
        for i in range(9):
            # 仅显示ChSize指定长度的数据
            s += f'  DataChannel[{i}] = {self.DataChannel[i][:self.ChSize[i]]}\n'
        return s

    def deepcopy(self):
        """
        实现Group结构体的深度复制。
        """
        # 1. 创建结构体本身的浅拷贝
        # from_buffer_copy 会复制结构体所有直接包含的值类型字段和固定大小数组。
        # 此时,copy.DataChannel 中的指针仍然指向原始 group 的数据。
        copy = Group.from_buffer_copy(self)

        # 2. 遍历指针字段并进行深度复制
        for i, (size, channel) in enumerate(zip(self.ChSize, self.DataChannel)):
            if channel: # 确保指针不为空
                # 为当前通道的数据创建一个新的C数组缓冲区
                # (*channel[:size]) 将原始指针指向的数据解引用并复制到新数组中
                data = (ct.c_float * size)(*channel[:size])

                # 将新创建的缓冲区转换为POINTER类型,并存储到副本的DataChannel字段中
                # 这确保了副本的指针指向独立的新内存区域
                copy.DataChannel[i] = ct.cast(data, ct.POINTER(ct.c_float))
            else:
                copy.DataChannel[i] = None # 如果原始指针为空,副本也设置为空

        return copy

关键点解析:

  • Group.from_buffer_copy(self): 这是实现深度复制的第一步。它会创建一个新的Group实例,并将原始实例的内存内容(包括所有值类型字段和固定大小的数组)按字节复制过来。对于POINTER类型的字段,它只会复制指针的地址值,因此此时副本的指针仍指向原始数据。
  • data = (ct.c_float * size)(*channel[:size]): 这是深度复制指针所指向数据的核心。
    • ct.c_float * size:创建一个新的C风格浮点数数组类型,其大小为size。
    • (*channel[:size]):这会解引用原始channel指针,并从其指向的内存中读取size个浮点数。*操作符将这些浮点数作为单独的参数传递给新数组的构造函数,从而完成数据的复制。
  • copy.DataChannel[i] = ct.cast(data, ct.POINTER(ct.c_float)): ct.cast用于将一个ctypes对象(这里是新创建的data数组)转换为指定的ctypes类型(这里是ct.POINTER(ct.c_float))。这样,副本的DataChannel[i]现在指向了新分配且独立于原始数据的新内存区域。

验证深度复制功能

为了验证deepcopy方法是否按预期工作,我们可以创建一个Group实例,对其进行初始化,然后进行深度复制。接着,修改原始Group实例的数据,并观察副本是否保持不变。

灵云AI开放平台
灵云AI开放平台

灵云AI开放平台

下载

立即学习Python免费学习笔记(深入)”;

# 1. 创建、初始化并显示原始Group对象
group = Group()
group.ChSize[:] = [1, 2, 3, 4, 5, 6, 7, 8, 9] # 设置每个通道的数据长度

for i, size in enumerate(group.ChSize):
    # 为每个通道动态分配数据并填充
    data = (ct.c_float * size)(*[1.5 * n for n in range(size)])
    group.DataChannel[i] = ct.cast(data, ct.POINTER(ct.c_float))

group.TriggerTimeLag = 123
group.StartIndexCell = 456
print("--- 原始 Group 对象 ---")
print(group)

# 2. 进行深度复制
copy = group.deepcopy()

# 3. 修改原始Group对象的通道数据,将其全部清零
# 注意:这里不仅将ChSize设为0,还将DataChannel指针设为None,
# 模拟原始数据被释放或修改的情况。
group.ChSize[:] = [0] * 9
group.DataChannel[:] = [None] * 9

print("\n--- 修改后的原始 Group 对象 ---")
print(group)

# 4. 显示副本Group对象,验证其数据是否未受原始对象修改的影响
print("\n--- 深度复制的副本 Group 对象 ---")
print(copy)

预期输出:

通过运行上述代码,您将看到:

  1. 原始Group对象在复制前显示其完整的初始化数据。
  2. 修改后的原始Group对象显示其ChSize和DataChannel均被清零。
  3. 深度复制的副本Group对象仍然显示与原始对象复制前完全相同的数据,证明了深度复制的成功,副本的数据是完全独立的。
--- 原始 Group 对象 ---
Group(ChSize=[1, 2, 3, 4, 5, 6, 7, 8, 9], TriggerTimeLag=123, StartIndexCell=456)
  DataChannel[0] = [0.0]
  DataChannel[1] = [0.0, 1.5]
  DataChannel[2] = [0.0, 1.5, 3.0]
  DataChannel[3] = [0.0, 1.5, 3.0, 4.5]
  DataChannel[4] = [0.0, 1.5, 3.0, 4.5, 6.0]
  DataChannel[5] = [0.0, 1.5, 3.0, 4.5, 6.0, 7.5]
  DataChannel[6] = [0.0, 1.5, 3.0, 4.5, 6.0, 7.5, 9.0]
  DataChannel[7] = [0.0, 1.5, 3.0, 4.5, 6.0, 7.5, 9.0, 10.5]
  DataChannel[8] = [0.0, 1.5, 3.0, 4.5, 6.0, 7.5, 9.0, 10.5, 12.0]

--- 修改后的原始 Group 对象 ---
Group(ChSize=[0, 0, 0, 0, 0, 0, 0, 0, 0], TriggerTimeLag=123, StartIndexCell=456)
  DataChannel[0] = []
  DataChannel[1] = []
  DataChannel[2] = []
  DataChannel[3] = []
  DataChannel[4] = []
  DataChannel[5] = []
  DataChannel[6] = []
  DataChannel[7] = []
  DataChannel[8] = []

--- 深度复制的副本 Group 对象 ---
Group(ChSize=[1, 2, 3, 4, 5, 6, 7, 8, 9], TriggerTimeLag=123, StartIndexCell=456)
  DataChannel[0] = [0.0]
  DataChannel[1] = [0.0, 1.5]
  DataChannel[2] = [0.0, 1.5, 3.0]
  DataChannel[3] = [0.0, 1.5, 3.0, 4.5]
  DataChannel[4] = [0.0, 1.5, 3.0, 4.5, 6.0]
  DataChannel[5] = [0.0, 1.5, 3.0, 4.5, 6.0, 7.5]
  DataChannel[6] = [0.0, 1.5, 3.0, 4.5, 6.0, 7.5, 9.0]
  DataChannel[7] = [0.0, 1.5, 3.0, 4.5, 6.0, 7.5, 9.0, 10.5]
  DataChannel[8] = [0.0, 1.5, 3.0, 4.5, 6.0, 7.5, 9.0, 10.5, 12.0]

注意事项与总结

  • 内存管理: 在上述deepcopy实现中,新创建的data数组(例如(ct.c_float * size))是Python ctypes对象。只要这个Python对象存在,其底层的C内存就会被ctypes管理。当copy对象被垃圾回收时,其内部的data数组也会被回收,从而避免内存泄漏。
  • 指针的有效性: 这种方法假设ChSize数组中的值准确地表示了DataChannel对应指针所指向数据的实际长度。如果ChSize不准确,可能会导致读取越界或复制不完整。
  • 多级指针: 如果结构体中包含多级指针(例如POINTER(POINTER(c_int))),则需要递归地应用类似的深度复制逻辑。
  • 性能: 对于包含大量或非常大的动态数据块的结构体,手动深度复制可能会有性能开销。在某些对性能要求极高的场景下,可能需要考虑在C层实现复制逻辑并通过ctypes调用。

总之,当ctypes.Structure包含指向动态分配内存的指针字段时,必须通过自定义的深度复制方法来确保副本及其所有关联数据完全独立于原始对象。这通常涉及先对结构体本身进行浅拷贝,然后对所有指针字段手动分配新内存并复制数据。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

410

2023.06.20

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

638

2023.07.25

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

362

2023.08.02

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

263

2023.08.09

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

632

2023.09.05

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

564

2023.09.20

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

671

2023.09.20

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

618

2023.09.22

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

69

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Excel 教程
Excel 教程

共162课时 | 21.6万人学习

成为PHP架构师-自制PHP框架
成为PHP架构师-自制PHP框架

共28课时 | 2.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号