0

0

Python ctypes结构体深度复制:处理指针字段的完整指南

霞舞

霞舞

发布时间:2025-09-25 14:52:16

|

739人浏览过

|

来源于php中文网

原创

python ctypes结构体深度复制:处理指针字段的完整指南

本文深入探讨了在Python中使用ctypes库时,如何对包含指针字段的Structure进行深度复制。由于ctypes结构体模拟C语言内存布局,其指针字段仅存储内存地址。实现深度复制的关键在于,首先对结构体本身进行浅复制,然后遍历所有指针字段,为它们指向的外部数据创建全新的副本,并更新复制结构体中的指针以指向这些新副本,从而避免原结构体修改对复制结构体的影响。

1. ctypes.Structure与深度复制的挑战

在Python中,ctypes模块允许我们定义与C语言结构体兼容的数据类型,以便与外部C库进行交互。当一个ctypes.Structure包含基本类型(如c_int, c_float)或固定大小的数组时,复制操作相对直接。然而,当结构体包含POINTER类型(即指向外部内存的指针)时,标准的浅复制(如使用copy.copy()或Structure.from_buffer_copy())仅复制指针本身的值(内存地址),而不会复制指针所指向的数据。这意味着原始结构体和复制结构体中的指针将指向同一块外部内存。如果修改了原始结构体指向的数据,复制结构体也会受到影响,这与深度复制的预期行为相悖。

为了实现真正的深度复制,我们需要确保不仅结构体本身的成员被复制,其所有指针字段所指向的外部数据也被独立复制,并且复制结构体中的指针指向这些新复制的数据。

2. 定义包含指针的ctypes.Structure

我们以一个名为Group的结构体为例,它包含一个整型数组ChSize、一个浮点数指针数组DataChannel以及其他基本类型字段。DataChannel是一个包含9个POINTER(ct.c_float)的数组,每个指针可能指向不同长度的浮点数数据块,其长度由ChSize中对应索引的值决定。

import ctypes as ct

class Group(ct.Structure):
    _fields_ = (
        ('ChSize', ct.c_uint32 * 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):
            # 访问指针指向的数据,使用切片操作[:self.ChSize[i]]来限制长度
            # 如果指针为None,则显示空列表
            data_content = self.DataChannel[i][:self.ChSize[i]] if self.DataChannel[i] else []
            s += f'  DataChannel[{i}] = {data_content}\n'
        return s

在__repr__方法中,我们通过self.DataChannel[i][:self.ChSize[i]]来访问指针指向的数据。POINTER对象支持切片操作,使其行为类似于Python列表,允许我们读取其指向的内存区域中的数据。

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

3. 实现深度复制方法

实现Group结构体的深度复制需要以下步骤:

  1. 浅复制结构体本身:使用Structure.from_buffer_copy(self)创建一个新的Group实例。这个新实例将拥有与原始结构体相同的内存布局和直接成员值。这意味着ChSize、TriggerTimeLag和StartIndexCell会被直接复制,而DataChannel中的指针值也会被复制(即,新旧结构体中的DataChannel数组会包含相同的内存地址)。

    AVCLabs
    AVCLabs

    AI移除视频背景,100%自动和免费

    下载
  2. 深度复制指针指向的数据:遍历DataChannel数组中的每个指针。对于每个指针,根据ChSize中对应的大小,创建一块新的ctypes数组来存储原始指针指向的数据的副本。然后,将这个新数组的地址转换为POINTER(ct.c_float)类型,并更新复制结构体中对应的DataChannel字段。

下面是deepcopy方法的实现:

class Group(ct.Structure):
    _fields_ = (
        ('ChSize', ct.c_uint32 * 9),
        ('DataChannel', ct.POINTER(ct.c_float) * 9),
        ('TriggerTimeLag', ct.c_uint32),
        ('StartIndexCell', ct.c_uint16)
    )

    def __repr__(self):
        s = f'Group(ChSize={self.ChSize[:]}, TriggerTimeLag={self.TriggerTimeLag}, StartIndexCell={self.StartIndexCell})\n'
        for i in range(9):
            data_content = self.DataChannel[i][:self.ChSize[i]] if self.DataChannel[i] else []
            s += f'  DataChannel[{i}] = {data_content}\n'
        return s

    def deepcopy(self):
        # 1. 对结构体本身进行浅复制
        # from_buffer_copy 会复制结构体的所有直接成员,包括指针的值。
        # 此时,copy.DataChannel[i] 和 self.DataChannel[i] 仍然指向相同的外部数据。
        copy = Group.from_buffer_copy(self)

        # 2. 遍历DataChannel数组,深度复制指针指向的外部数据
        for i, (size, original_channel_ptr) in enumerate(zip(self.ChSize, self.DataChannel)):
            if original_channel_ptr: # 确保原始指针不为None
                # 创建一个新的ctypes数组,用于存储当前通道的数据副本
                # (*original_channel_ptr[:size]) 将原始指针指向的数据解包并填充到新数组
                new_data_buffer = (ct.c_float * size)(*original_channel_ptr[:size])

                # 将新数组转换为POINTER(ct.c_float)类型,并赋值给复制结构体
                # ct.cast 用于将一个ctypes对象(如数组)转换为指定的ctypes类型
                copy.DataChannel[i] = ct.cast(new_data_buffer, ct.POINTER(ct.c_float))
            else:
                # 如果原始指针为None,则复制结构体中的对应指针也设为None
                copy.DataChannel[i] = None
        return copy

4. 示例与验证

为了验证deepcopy方法的正确性,我们将创建一个Group实例,初始化其所有字段,包括DataChannel指向的动态数据。然后,我们进行深度复制,并修改原始Group实例的DataChannel,观察复制后的Group是否保持不变。

# 1. 创建并初始化一个Group实例
group = Group()
group.ChSize[:] = [1, 2, 3, 4, 5, 6, 7, 8, 9] # 初始化每个通道的大小

# 为每个DataChannel指针分配内存并填充数据
for i, size in enumerate(group.ChSize):
    # 创建一个ctypes浮点数数组作为数据缓冲区
    data_buffer = (ct.c_float * size)(*[1.5 * n for n in range(size)])
    # 将数组的地址转换为POINTER(ct.c_float)并赋值给DataChannel
    group.DataChannel[i] = ct.cast(data_buffer, ct.POINTER(ct.c_float))

group.TriggerTimeLag = 123
group.StartIndexCell = 456
print("--- 原始 Group 实例 ---")
print(group)

# 2. 执行深度复制
copy_group = group.deepcopy()
print("\n--- 复制后的 Group 实例 (在修改原始实例之前) ---")
print(copy_group)

# 3. 修改原始 Group 实例的 DataChannel 和 ChSize
# 将原始实例的ChSize全部设为0,DataChannel指针设为None,模拟数据被清空
group.ChSize[:] = [0] * 9
group.DataChannel[:] = [None] * 9

print("\n--- 修改原始 Group 实例后 ---")
print(group)

print("\n--- 再次打印复制后的 Group 实例 (应保持不变) ---")
print(copy_group)

预期输出分析:

  • 原始 Group 实例: 将显示所有字段的初始值,DataChannel会显示其指向的浮点数数据。
  • 复制后的 Group 实例 (在修改原始实例之前): 将与原始实例完全相同,证明复制成功。
  • 修改原始 Group 实例后: group实例的ChSize将全部变为0,DataChannel将显示为空列表(因为指针已设为None)。
  • 再次打印复制后的 Group 实例 (应保持不变): copy_group实例的ChSize和DataChannel将保持其原始复制时的状态,不受group实例修改的影响,这证明了深度复制的成功。

5. 注意事项与总结

  • 内存管理: 在Python中,通过ctypes创建的数组(如ct.c_float * size)是Python对象,由Python的垃圾回收机制管理。因此,我们不需要像C语言那样手动free内存。只要new_data_buffer对象有引用,其内存就会保持有效。当copy.DataChannel[i]被赋值为ct.cast(new_data_buffer, ...)时,new_data_buffer对象被隐式地保持了引用,从而确保其生命周期。
  • ct.cast的作用: ct.cast(obj, type)是ctypes中一个非常重要的函数,它用于将一个ctypes对象(通常是一个缓冲区或另一个指针)强制转换为指定的ctypes类型。在本例中,它将一个ctypes数组对象(本质上是一个内存块)转换为一个POINTER类型,使其可以赋值给DataChannel字段。
  • 指针的有效性: 在实际应用中,如果ctypes结构体中的指针指向的是C语言库动态分配的内存(例如通过malloc),那么在Python中进行深度复制时,您可能需要在C层实现相应的内存分配和数据复制逻辑,并通过ctypes调用这些C函数,以确保内存管理的正确性。本教程的示例假设数据缓冲区是在Python/ctypes层面创建的。
  • 通用性: 这种处理指针字段的深度复制模式可以推广到任何包含ctypes.POINTER字段的ctypes.Structure。关键在于识别哪些字段是直接数据,哪些是指针,并对指针指向的数据进行额外的复制。

通过以上步骤,我们成功地为包含指针字段的ctypes.Structure实现了深度复制,确保了复制后的对象与原始对象在数据上完全独立,避免了潜在的副作用。这对于需要在Python中安全地操作和传递复杂C结构体数据至关重要。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

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

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

401

2023.06.20

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

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

619

2023.07.25

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

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

354

2023.08.02

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

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

259

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,随机排序。

603

2023.09.05

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

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

530

2023.09.20

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

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

645

2023.09.20

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

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

603

2023.09.22

Python 自然语言处理(NLP)基础与实战
Python 自然语言处理(NLP)基础与实战

本专题系统讲解 Python 在自然语言处理(NLP)领域的基础方法与实战应用,涵盖文本预处理(分词、去停用词)、词性标注、命名实体识别、关键词提取、情感分析,以及常用 NLP 库(NLTK、spaCy)的核心用法。通过真实文本案例,帮助学习者掌握 使用 Python 进行文本分析与语言数据处理的完整流程,适用于内容分析、舆情监测与智能文本应用场景。

10

2026.01.27

热门下载

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

精品课程

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

共162课时 | 13.7万人学习

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

共28课时 | 2.5万人学习

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

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