sndhdr —- 推测声音文件的类型

源代码 Lib/sndhdr.py

从 3.11 版起不建议使用，将在 3.13 版中移除: sndhdr 模块已被弃用（请参阅 PEP 594 了解详情及其替代品）。

sndhdr 提供了企图猜测文件中的声音数据类型的功能函数。当这些函数可以推测出存储在文件中的声音数据的类型是，它们返回一个 collections.namedtuple()，包含了五种属性：（filetype, framerate, nchannels, nframes, sampwidth）。这些 type 的值表示数据的类型，会是以下字符串之一： 'aifc', 'aiff', 'au', 'hcom', 'sndr', 'sndt', 'voc', 'wav', '8svx', 'sb', 'ub', or 'ul' 。 sampling_rate 可能是实际值或者当未知或者难以解码时的 0。类似的， channels 也会返回实际值或者在无法推测或者难以解码时返回 0。 frames 则是实际值或 -1。 元组的最后一项， bits_per_sample 将会为比特表示的 sample 大小或者 A-LAW 时为 'A'， u-LAW 时为 'U'。

sndhdr.what(filename)

使用 whathdr() 推测存储在 filename 文件中的声音数据的类型。如果成功，返回上述的命名元组，否则返回 None。

在 3.5 版更改: 将结果从元组改为命名元组。

sndhdr.whathdr(filename)

基于文件头推测存储在文件中的声音数据类型。文件名由 filename 给出。这个函数在成功时返回上述命名元组，或者在失败时返回 None。

在 3.5 版更改: 将结果从元组改为命名元组。

下列音频标头类型是可识别的，带有如下来自 whathdr() 的返回值: 以及 what():

sndhdr.tests

执行单个测试的函数列表。每个函数都有两个参数：字节流和类似开放文件的对象。当 what() 用字节流调用时，类文件对象将是 None。

如果测试成功，这个测试函数应当返回一个描述图像类型的字符串，否则返回 None。

示例:

>>> import sndhdr
>>> imghdr.what('bass.wav')
'wav'
>>> imghdr.whathdr('bass.wav')
'wav'