4.7.1.5 Objets StreamRecoder

StreamRecoder fournit une vue frontend - backend des données d'encodage qui sont parfois utiles pour traiter différents environnements d'encodage.

La conception est telle qu'on peut employer les fonctions d'usine retournées par la fonction lookup() pour construire l'instance.

StreamRecoder(stream, encode, decode, Reader, Writer, errors)

Créé une instance de StreamRecoder qui implémente une conversion bi-directionnelle: encode et decode travaille sur le frontend (l'entrée pour read() et la sortie pour write()) tandis que Reader et Writer travaille sur le backend (lecture et écriture du flux).

Vous pouvez employer ces objets pour faire des réencodages transparents directs, par exemple de Latin-1 à UTF-8 et l'inverse.

stream doit être un objet fichier (ou similaire).

encode, decode doivent adhérer à l'interface de Codec, Reader, Writer doivent être des fonctions d'usine ou des classes fournissant des objets des interfaces StreamReader et StreamWriter respectivement.

encode et decode sont nécessaires pour la traduction de frontend, Reader et Writer pour la traduction de backend. Le format intermédiaire utilisé est déterminé par les deux ensembles de codecs, par exemple les codecs d'Unicode emploieront Unicode en tant que codage intermédiaire.

La gestion d'erreurs est faite comme défini pour les lecteurs et les générateurs de flux.

Les instances de StreamRecoder définissent les interfaces combinées des StreamReader et StreamWriter. Ils héritent de toutes les autres méthodes et attribut du flux.