0

0

Python中解析C/C++嵌套结构体数组:ctypes与struct模块实践

碧海醫心

碧海醫心

发布时间:2025-11-18 13:10:24

|

1017人浏览过

|

来源于php中文网

原创

Python中解析C/C++嵌套结构体数组:ctypes与struct模块实践

本教程详细介绍了#%#$#%@%@%$#%$#%#%#$%@_23eeeb4347bdd26bfc++6b7ee9a3b755dd解析从c/c++通过网络传输的嵌套结构体数据的方法,尤其针对包含数组指针的复杂场景。文章提供了两种策略:利用ctypes模块精确映射c结构体并手动处理指针和数组;或采用纯python的struct模块进行高效数据解包并构建python对象。通过示例,读者将掌握c数据序列化与python反序列化的关键技术,应对跨语言数据通信挑战。

在跨语言通信(如C/C++与Python之间)中,通过网络传输复杂数据结构是一个常见需求。当C/C++结构体包含指向数组的指针时,直接传输内存中的结构体数据并不能正确地将数组内容一并发送。本文将深入探讨如何正确地序列化C/C++中包含嵌套结构体数组的数据,并在Python端使用ctypes或struct模块进行有效的反序列化。

C/C++数据结构与网络传输的挑战

C/C++中的结构体在内存中是连续存储的,但当结构体成员是指针时,它存储的仅仅是另一个内存地址,而不是实际的数据内容。例如,一个struct MyStruct中包含MyInnerStruct *InnerStruct;,如果InnerStruct指向一个数组,那么sizeof(MyStruct)只包含指针本身的大小,而不包括InnerStruct所指向的数组数据。

原始的C++发送代码中:

// Serialize the struct into a byte stream
char buffer[sizeof(MyStruct)];
memcpy(buffer, &testStruct, sizeof(MyStruct));
// Send the serialized struct over the UDP socket
if (sendto(udpSocket, buffer, sizeof(MyStruct), ...) == -1) { ... }

这种做法的问题在于,它只复制了testStruct自身(包括InnerStruct指针的值,即一个内存地址),而没有复制InnerStruct指向的MyInnerStruct数组的实际内容。在接收端,这个指针地址在Python进程中是无效的,因此无法直接通过ctypes解引用获取数组数据。

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

正确的序列化策略是,在发送端,需要将主结构体的固定大小字段和其指向的数组元素数据分别或按序组合成一个连续的字节流进行发送。例如,先发送MyStruct的intValue和floatValue,然后紧接着发送MyInnerStruct数组中的每一个元素。

为了演示正确的发送方式,我们可以使用Python的struct模块模拟一个符合这种序列化规则的数据包:

import struct
import socket

# 模拟发送数据:
# field1=4 (int), field2=3.5 (float)
# 接着是4个MyInnerStruct元素,每个包含一个int和一个float
data = struct.pack('

上述代码构造了一个字节流,其中包含了主结构体的两个字段,以及其后紧跟着的四个内部结构体实例的数据。

方法一:利用 ctypes 精确映射与解析

ctypes模块允许Python代码与C库进行交互,并能够精确地映射C语言的数据结构。然而,处理C结构体中的指针(特别是指向数组的指针)需要更细致的操作。

Ideogram
Ideogram

Ideogram是一个全新的文本转图像AI绘画生成平台,擅长于生成带有文本的图像,如LOGO上的字母、数字等。

下载

Python ctypes 结构体定义

首先,在Python中定义与C结构体对应的ctypes.Structure:

import ctypes as ct

class MyInnerStruct(ct.Structure):
    _fields_ = (('field4', ct.c_int),
                ('field5', ct.c_float))
    def __repr__(self):  # 用于方便显示
        return f'({self.field4}, {self.field5})'

class MyStruct(ct.Structure):
    _fields_ = (('field1', ct.c_int),
                ('field2', ct.c_float),
                ('field3', ct.POINTER(MyInnerStruct))) # 注意这里是POINTER
    def __repr__(self):  # 用于方便显示
        # field3 是一个指针,需要切片才能作为数组访问
        return f'[{self.field1}, {self.field2}, {list(self.field3[:self.field1])})]'

这里MyStruct的field3被定义为ct.POINTER(MyInnerStruct),表示它是一个指向MyInnerStruct的指针。

接收与解包策略

由于网络传输的字节流是扁平的,Python端需要手动解析这个字节流,将数据填充到ctypes结构体中。核心步骤包括:

  1. 接收数据:通过UDP套接字接收完整的字节流。
  2. 解包主结构体字段:使用struct.unpack_from解包字节流开头的field1和field2。
  3. 初始化主结构体:使用解包出的field1和field2初始化MyStruct实例。此时field3(指针)仍为空或无效。
  4. 动态分配内部结构体数组:根据field1的值(表示数组长度),动态创建一个MyInnerStruct类型的ctypes数组。
  5. 循环解包并填充数组:从字节流中field1和field2之后的位置开始,循环解包每个MyInnerStruct的字段,并将其赋值给动态创建的ctypes数组的对应元素。
  6. 关联指针:将动态创建的ctypes数组赋值给MyStruct实例的field3指针。

示例代码 (Python 接收端)

import socket
import struct
import ctypes as ct

class MyInnerStruct(ct.Structure):
    _fields_ = (('field4', ct.c_int),
                ('field5', ct.c_float))
    def __repr__(self):
        return f'({self.field4}, {self.field5})'

class MyStruct(ct.Structure):
    _fields_ = (('field1', ct.c_int),
                ('field2', ct.c_float),
                ('field3', ct.POINTER(MyInnerStruct)))
    def __repr__(self):
        return f'[{self.field1}, {self.field2}, {list(self.field3[:self.field1])})]'

sock = socket.socket(type=socket.SOCK_DGRAM)
sock.bind(('', 5000)) # 绑定到本地所有接口的5000端口

print("等待接收数据...")
data, addr = sock.recvfrom(40960) # 接收数据,缓冲区大小足够大

# 1. 解包主结构体的前两个字段
field1, field2 = struct.unpack_from('

运行上述接收代码,然后运行之前模拟的发送代码,将得到类似如下输出:

等待接收数据...
接收到的结构体: [4, 3.5, [(1, 1.25), (2, 2.5), (3, 2.75), (4, 3.0)])]

注意事项

  • 内存管理:ctypes在Python中创建的C类型对象由Python垃圾回收机制管理,但在某些复杂场景下仍需注意生命周期。
  • 数据对齐与字节序:确保C/C++发送端和Python接收端的结构体定义、数据对齐方式(_pack_属性)和字节序(如
  • 指针有效性:在网络传输中,指针地址本身是无意义的。必须传输指针所指向的实际数据,并在接收端重新构建数据结构。

方法二:纯 Python struct 模块解析(推荐)

对于许多跨语言数据交换场景,特别是当不需要直接调用C库函数时,放弃ctypes而直接使用Python的struct模块来解析字节流,并构建纯Python对象,会更加简洁、高效且易于维护。这种方法避免了ctypes在Python对象和C类型之间进行映射的开销和复杂性。

优势与适用场景

  • 简洁性:无需定义ctypes.Structure,直接使用struct进行解包。
  • 效率:避免了ctypes的类型转换开销。
  • 灵活性:更容易将解析后的数据转换为标准的Python数据类型(如列表、字典),方便后续处理。
  • 适用场景:主要用于数据序列化和反序列化,不涉及直接调用C库函数。

Python类设计与数据解析逻辑

我们可以定义纯Python类来表示C结构体,并在这些类中实现从字节流解析数据的方法。

import socket
import struct

class MyInnerStruct:
    _format = '

示例代码 (Python 接收端)

import socket
import struct

# MyInnerStruct 和 MyStruct 的类定义同上

sock = socket.socket(type=socket.SOCK_DGRAM)
sock.bind(('', 5000))

print("等待接收数据...")
data, addr = sock.recvfrom(40960)

# 直接调用MyStruct的from_data类方法来解析整个数据包
received_struct = MyStruct.from_data(data)
print("接收到的结构体:", received_struct)

sock.close()

运行上述接收代码,然后运行之前模拟的发送代码,将得到与ctypes方案相同的输出:

等待接收数据...
接收到的结构体: [4, 3.5, [[1, 1.25], [2, 2.5], [3, 2.75], [4, 3.0]]]

比较与选择

  • ctypes
    • 优点:能够精确映射C

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

746

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

634

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

758

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

617

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1260

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

547

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

577

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

705

2023.08.11

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

80

2026.01.09

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 0.6万人学习

Django 教程
Django 教程

共28课时 | 3万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.1万人学习

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

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