struct模塊用於二進制和結構體之間的互相轉化,此模塊中大部分函數接受一個實現了Buffer協議的對象,最常見的實現了Buffer協議的對象包括bytes、bytearray等,大多數像byte數組這樣的對象都實現了Buffer協議。
struct模塊的函數
struct模塊的函數很少,只有6個。
struct.pack(format, v1, v2, ...)
:將多個value如v1、v2按照format進行格式化struct.pack_into(format, buffer, offset, v1, v2, ...)
:將多個value如v1、v2按照format格式化到buffer的offset處struct.unpack(format, buffer)
:從buffer中按照format解析對象struct.unpack_from(format, buffer, offset=0)
:從buffer的某個offset處解析對象struct.iter_unpack(format, buffer)
:以迭代的形式從buffer中解析對象struct.calcsize(format)
:返回format所指定的數據類型的字節數
從以上函數看出,struct模塊中格式化字符串format非常重要,format包括兩部分:控制部分、類型部分。
以Struct的形式調用struct包的能
struct包提供了Struct類,這個類的構造函數接受一個format串,從而可以使用對象的函數了,可以避免傳format參數。
msgpack中的Packer和Unpacker也是類似的作用。
舉例
demo1:將int轉換為bytes
buf1 = 256 bin_buf1 = struct.pack('i', buf1) # 'i'代表'integer' ret1 = struct.unpack('i', bin_buf1) print(bin_buf1, ' <====> ', ret1)
這段程序將256這個數字通過pack函數轉化成了bytes類型,其中pack的第一個參數i表示buf1為int類型的數據。
demo2:將浮點數轉化為bytes
buf2 = 3.1415 bin_buf2 = struct.pack('d', buf2) # 'd'代表'double' ret2 = struct.unpack('d', bin_buf2) print(bin_buf2, ' <====> ', ret2)
demo3:將字符串轉換為bytes
# 字符串 -> 二進制流 buf3 = 'Hello World' bin_buf3 = struct.pack('11s', bytes(buf3,encoding='ascii')) # '11s'代表長度為11的'string'字符數組 ret3 = struct.unpack('11s', bin_buf3) print(bin_buf3, ' <====> ', ret3)
這里的11s表示buf3為長度11個字符的數組。同理,也可以使用“11i”表示11個int類型的數據,還可以使用“iiiiiiiiiii”表示11i
demo4:將結構體轉化為bytes
# 結構體 -> 二進制流 # 假設有一個結構體 # struct header { # int buf1; # double buf2; # char buf3[11]; # } bin_buf_all = struct.pack('id11s', buf1, buf2, bytes(buf3,encoding='ascii')) ret_all = struct.unpack('id11s', bin_buf_all) print(bin_buf_all, ' <====> ', ret_all)
demo5:常用方法
# 按照給定的格式化字符串,把數據封裝成字符串(實際上是類似於c結構體的字節流) string = struct.pack(fmt, v1, v2, ...) # 按照給定的格式(fmt)解析字節流string,返回解析出來的tuple tuple = unpack(fmt, string) # 計算給定的格式(fmt)占用多少字節的內存 offset = calcsize(fmt)
手冊
格式化字符串的存儲部分
從表中可以發現如下規律:
- 整數類型b、h、i、q分別表示1個字節、2個字節、4個字節、8個字節,對應的大寫字母表示無符號整數
- f、d表示float和double
- c表示字符、s表示字符串,需要注意:struct模塊並不能直接將str類型轉為bytes,當format為c和s時,對象需要是byte類型或者bytes類型
Format | C Type | Python | 字節數 |
---|---|---|---|
x | pad byte | no value | 1 |
c | char | string of length 1 | 1 |
b | signed char | integer | 1 |
B | unsigned char | integer | 1 |
? | _Bool | bool | 1 |
h | short | integer | 2 |
H | unsigned short | integer | 2 |
i | int | integer | 4 |
I | unsigned int | integer or lon | 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 | 8 |
s | char[] | string | 1 |
p | char[] | string | 1 |
P | void * | long |
格式化字符串的控制部分
@
表示默認,一切以本地為主=
表示對象的大小使用標准大小<
、>
表示小頭序和大頭序!
永遠不會用到,可以忽略
Character | Byte order | Size and alignment |
---|---|---|
@ | native | native 湊夠4個字節 |
= | native | standard 按原字節數 |
< | little-endian | standard 按原字節數 |
> | big-endian | standard 按原字節數 |
! | network (= big-endian) | standard 按原字節數 |
#參考資料 [monitor1379](http://www.jianshu.com/p/5a985f29fa81)