`struct.unpack` 是 Python 中用于将 **字节流（bytes）转换为结构化数据（如整数、浮点数等）** 的核心函数，特别适合处理二进制协议（如 RTP、TCP 头部等）。以下是详细用法和示例： --- ### **1. 函数原型** ```python struct.unpack(format, buffer) ``` - **`format`**：指定字节流的解析规则（字符串形式，如 `">I"`）。 - **`buffer`**：待转换的字节流（如 `b'\x00\x01\x02\x03'`）。 - **返回值**：返回一个元组（即使只有一个元素）。 --- ### **2. 常用格式符** | 格式符 | C 类型 | 字节数 | 说明 | |--------|----------------|--------|-----------------------| | `B` | `unsigned char` | 1 | 无符号字节 | | `H` | `unsigned short`| 2 | 无符号短整数 | | `I` | `unsigned int` | 4 | 无符号长整数 | | `Q` | `unsigned long long` | 8 | 无符号 64 位整数 | | `f` | `float` | 4 | 单精度浮点数 | | `d` | `double` | 8 | 双精度浮点数 | --- ### **3. 字节序控制** | 符号 | 说明 | 示例（解析 `b'\x00\x01'`） | |------|---------------|-----------------------------| | `>` | 大端序（网络序） | `struct.unpack(">H", b'\x00\x01')` → `(1,)` | | `<` | 小端序 | `struct.unpack("<H", b'\x00\x01')` → `(256,)` | | `!` | 网络序（同 `>`） | | | 无 | 默认本地字节序 | 依赖系统（通常不推荐） | --- ### **4. 示例代码** #### **示例 1：解析 RTP 时间戳（4 字节大端序）** ```python import struct # 假设从 RTP 包中提取的时间戳字节流 timestamp_bytes = b'\x5A\x3F\x2C\x18' timestamp = struct.unpack(">I", timestamp_bytes)[0] print("Timestamp:", timestamp) # 输出: 1514423320 (0x5A3F2C18 的十进制) ``` #### **示例 2：解析多字段（如序列号 + 时间戳）** ```python # 模拟 RTP 头部前 8 字节（序列号 + 时间戳） rtp_header_part = b'\x00\x0F\x5A\x3F\x2C\x18' # 解析序列号（2 字节）和时间戳（4 字节），均大端序 seq_num, timestamp = struct.unpack(">HI", rtp_header_part) print("Sequence:", seq_num, "Timestamp:", timestamp) ``` 输出： ``` Sequence: 15 Timestamp: 1514423320 ``` --- ### **5. 错误处理** - **字节长度不匹配**：若 `format` 声明的长度与 `buffer` 长度不一致，会抛出 `struct.error`。 ```python try: value = struct.unpack(">I", b'\x01\x02\x03') # 缺少 1 字节 except struct.error as e: print("Error:", e) # 输出: unpack requires a buffer of 4 bytes ``` --- ### **6. 性能优化** - **预编译格式**：重复解析时，先用 `struct.Struct` 预编译格式提升速度。 ```python parser = struct.Struct(">IH") # 预编译格式：4 字节无符号整数 + 2 字节无符号短整数 data = parser.unpack(b'\x00\x01\x02\x03\x00\xFF') print(data) # 输出: (66051, 255) ``` ---