Ce document est relatif à une vieille version de Python qui n'est plus soutenue. Mettez à jour votre version et lisez Bienvenue sur la documentation de la version stable actuelle de Python.

# `sndhdr` — Détermine le type d'un fichier audio

Code source : Lib/sndhdr.py

Obsolète depuis la version 3.11: The `sndhdr` module is deprecated (see PEP 594 for details and alternatives).

Le module `sndhdr` fournit des fonctions permettant d'essayer de déterminer le type de données audio contenues dans un fichier. Lorsque ces fonctions parviennent à déterminer le format de données, elles renvoient un `namedtuple()`, contenant cinq attributs : (`filetype`, `framerate`, `nchannels`, `nframes`, `sampwidth`). La valeur de type indique le format de données parmi `'aifc'`, `'aiff'`, `'au'`, `'hcom'`, `'sndr'`, `'sndt'`, `'voc'`, `'wav'`, `'8svx'`, `'sb'`, `'ub'`, et `'ul'`. La valeur de sampling_rate sera soit la vraie valeur, soit, si elle est inconnue ou compliquée à obtenir, `0`. De même, channels vaut soit le nombre de canaux soit `0` s'il ne peut pas être déterminé ou si la valeur est compliquée à décoder. La valeur de frames sera soit le nombre de frames soit `-1`. Le dernier élément du n-uplet, bits_per_sample sera soit la taille d'un échantillon en bits, soit `'A'` pour A-LAW ou `'U'` pour u-LAW.

`sndhdr.``what`(filename)

  Détermine le type de données audio stockée dans le fichier filename en utilisant `whathdr()`. Si elle y parvient, le namedtuple décrit plus haut est renvoyé, sinon, `None`.

  Modifié dans la version 3.5: Le type renvoyé passe d'un n-uplet à un n-uplet nommé.

`sndhdr.``whathdr`(filename)

  Détermine le type de données audio contenue dans un fichier, en se basant sur ses entêtes. Le nom du fichier est donné par filename. Cette fonction renvoie un namedtuple tel que décrit plus haut, si elle y parvient, sinon `None`.

  Modifié dans la version 3.5: Le type renvoyé passe d'un n-uplet à un n-uplet nommé.