Python/docs/3.9/library/chunk

chunk — 读取 IFF 分块数据

源代码： :source:`Lib/chunk.py`

---

该模块提供了一个用于读取使用 EA IFF 85 块的文件的接口。 1 该格式至少用于音频交换文件格式（AIFF/AIFF-C）和真实媒体文件格式（RMFF）。 WAVE 音频文件格式密切相关，也可以使用此模块读取。

一个块具有以下结构：

抵消	长度	内容
0	4	区块 ID
4	4	大端字节序的块大小，不包括头
8	n	数据字节，其中 n 是前面字段中给出的大小
8 + n	0 或 1	如果 n 是奇数并且使用块对齐，则需要填充字节

ID 是一个 4 字节的字符串，用于标识块的类型。

大小字段（一个 32 位值，使用大端字节序编码）给出了块数据的大小，不包括 8 字节的标头。

通常一个 IFF 类型的文件由一个或多个块组成。 这里定义的 Chunk 类的建议用法是在每个块的开头实例化一个实例，并从该实例中读取直到它到达末尾，之后可以实例化一个新的实例。 在文件末尾，创建新实例将失败，并出现 EOFError 异常。

class chunk.Chunk(file, align=True, bigendian=True, inclheader=False)

代表一个块的类。 file 参数应该是一个类似文件的对象。 此类的实例是特别允许的。 唯一需要的方法是read()。 如果方法 seek() 和 tell() 存在并且不引发异常，它们也会被使用。 如果这些方法存在并引发异常，则预计它们不会更改对象。 如果可选参数 align 为真，则假定块在 2 字节边界上对齐。 如果 align 为假，则假定没有对齐。 默认值是true。 如果可选参数 bigendian 为 false，则假定块大小为 little-endian 顺序。 这是 WAVE 音频文件所需要的。 默认值是true。 如果可选参数 inclheader 为真，则块头中给出的大小包括头的大小。 默认值为假。

Chunk 对象支持以下方法：

getname()

返回块的名称 (ID)。 这是块的前 4 个字节。

getsize()

返回块的大小。

close()

关闭并跳到块的末尾。 这不会关闭基础文件。

如果在调用 close() 方法之后调用，其余方法将引发 OSError。 在 Python 3.3 之前，他们曾经提出 IOError，现在是 OSError 的别名。

isatty()

返回 False。

seek(pos, whence=0)

设置块的当前位置。 whence 参数可选，默认为 0（绝对文件定位）； 其他值是 1（相对于当前位置搜索）和 2（相对于文件末尾搜索）。 没有返回值。 如果底层文件不允许搜索，则只允许向前搜索。

tell()

将当前位置返回到块中。

read(size=- 1)

从块中最多读取 size 个字节（如果在获取 size 个字节之前读取到达块的末尾，则更少）。 如果 size 参数为负数或省略，则读取所有数据，直到块结束。 当立即遇到块的结尾时，将返回一个空字节对象。

skip()

跳到块的末尾。 对该块的所有进一步调用 read() 将返回 b。 如果您对块的内容不感兴趣，则应调用此方法以使文件指向下一个块的开头。

脚注

1

“EA IFF 85”交换格式文件标准，Jerry Morrison，Electronic Arts，1985 年 1 月。