二进制数据服务

struct

struct模块:用于打包、拆包Cstruct格式二进制数据

  • 使用python字节串存储Cstruct数据
  • 需要给出格式声明,指定二进制中存储格式

格式说明

字节序、对齐

格式符 字节序(大、小端) 类型大小 字段对齐方式
@(缺省值) 原生字节序 原生大小 原生对齐
= 原生字节序 标准大小 标准对齐
< lb-endian 标准大小 标准对齐
> bl-endian 标准大小 标准对齐
! >
  • 原生对齐:C对齐方式,字段起始位置须为其长度整数倍
  • 标准对齐:按字节对齐,无需使用0补齐

类型

Format C Type Python Bytes
x pad byte no value 1
? _Bool bool 1
h short integer 2
H unsigned short integer 2
i int integer 4
I unsigned int integer 4
l long integer 4
L unsigned long long 4
q long long long 8
Q unsigned long long long 8
f float float 4
d double float 4
c char str of length1 1
b signed char bytes of length1 1
B unsigned char bytes of length1 1
s char[] str 1
p pascal string,带长度 str NA
n ssize_t integer NA
N size_t integer NA
P void * 足够容纳指针的整形 NA
  • 在类型符前添加数字可以指定类型重复次数

  • 字符、字符串类型实参须以字节串形式给出

    • 字符:必须以长度为1字节串形式给出,重复须对应多参数
    • 字符串:可以是任意长度字节串,重复对应单个字符串
      • 长于格式指定长度被截断
      • 短于格式指定长度用\0x00补齐
  • python按以上长度封装各类型,但C各类型长度取决于平台, 以上近视64位机器最可能对应C类型

    • 非64位机器long long类型大部分为4bytes
  • 用途

    • 封装、解压数据
    • reinterpret_cast类型转换

Struct

1
2
3
class Struct:
def __init__(self, fmt):
pass
  • 用途:根据指定格式fmt编译Sturct对象
    • Sturct对象可以调用以下方法,无需再次指定fmt

Pack

1
2
3
4
def struct.pack(fmt, v1, v2,...) -> bytes:
pass
def struct.pack_into(fmt, buffer, offset , v1, v2, ...):
pass
  • pack:按照指定格式fmt封装数据为字节串
  • pack_into:将字节串写入buffer指定偏移offset

Unpack

1
2
3
4
5
6
def struct.unpack(fmt, buffer) -> (v1, v2,...):
pass
def struct.unpack(fmt, buffer, offset=0) -> (v1, v2, ...):
pass
def struct.iter_unpack(fmt, buffer) -> iterator(v1, v2,...):
pass
  • unpack:按照指定格式fmt拆包字节串buffer
  • unpack_from:从偏移offset处开始拆包
  • iter_unpack:迭代解压包含多个fmtbuffer

calsize

1
2
def struct.calsize(fmt) -> integer:
pass
  • 用途:计算封装指定格式fmt所需字节数

codecs

Author

UBeaRLy

Posted on

2019-06-10

Updated on

2019-06-10

Licensed under

Comments