sndhdr
— Determine type of sound file¶
Source code: Lib/sndhdr.py
Deprecated since version 3.11, will be removed in version 3.13: The sndhdr
module is deprecated
(see PEP 594 for details and alternatives).
The sndhdr
provides utility functions which attempt to determine the type
of sound data which is in a file. When these functions are able to determine
what type of sound data is stored in a file, they return a
namedtuple()
, containing five attributes: (filetype
,
framerate
, nchannels
, nframes
, sampwidth
). The value for type
indicates the data type and will be one of the strings 'aifc'
, 'aiff'
,
'au'
, 'hcom'
, 'sndr'
, 'sndt'
, 'voc'
, 'wav'
, '8svx'
,
'sb'
, 'ub'
, or 'ul'
. The sampling_rate will be either the actual
value or 0
if unknown or difficult to decode. Similarly, channels will be
either the number of channels or 0
if it cannot be determined or if the
value is difficult to decode. The value for frames will be either the number
of frames or -1
. The last item in the tuple, bits_per_sample, will either
be the sample size in bits or 'A'
for A-LAW or 'U'
for u-LAW.
- sndhdr.what(filename)¶
Determines the type of sound data stored in the file filename using
whathdr()
. If it succeeds, returns a namedtuple as described above, otherwiseNone
is returned.Zmienione w wersji 3.5: Result changed from a tuple to a namedtuple.
- sndhdr.whathdr(filename)¶
Determines the type of sound data stored in a file based on the file header. The name of the file is given by filename. This function returns a namedtuple as described above on success, or
None
.Zmienione w wersji 3.5: Result changed from a tuple to a namedtuple.
The following sound header types are recognized, as listed below with the return value
from whathdr()
: and what()
:
Wartość |
Sound header format |
---|---|
|
Compressed Audio Interchange Files |
|
Audio Interchange Files |
|
Au Files |
|
HCOM Files |
|
Sndtool Sound Files |
|
Creative Labs Audio Files |
|
Waveform Audio File Format Files |
|
8-Bit Sampled Voice Files |
|
Signed Byte Audio Data Files |
|
UB Files |
|
uLAW Audio Files |
- sndhdr.tests¶
A list of functions performing the individual tests. Each function takes two arguments: the byte-stream and an open file-like object. When
what()
is called with a byte-stream, the file-like object will beNone
.The test function should return a string describing the image type if the test succeeded, or
None
if it failed.
Example:
>>> import sndhdr
>>> imghdr.what('bass.wav')
'wav'
>>> imghdr.whathdr('bass.wav')
'wav'