4.9.1.2 Oggetti StreamWriter

La classe StreamWriter è una classe derivata di Codec e definisce i seguenti metodi che ogni stream writer deve definire per essere compatibile con il registro dei codec Python.

class StreamWriter( stream[, errors])
Costruttore per un'istanza StreamWriter.

Tutti i writers di flusso devono fornire questa interfaccia del costruttore. Sono liberi di aggiungere degli argomenti chiave addizionali, ma solo quelli qui definiti vengono usati dal registro Python dei codec.

stream deve essere un oggetto simile a file aperto in modalità di scrittura dati (modo binario).

La classe StreamWriter può implementare differenti schemi di gestione dell'errore, fornendo l'argomento chiave errors. Questi sono i parametri definiti:

L'argomento errors verrà assegnato ad un attributo con lo stesso nome. Assegnamenti a questo attributo rendono possibile il cambio tra differenti strategie di gestione dell'errore durante la vita dell'oggetto StreamWriter.

L'insieme dei valori consentiti per l'argomento errors può venire esteso con register_error().

write( object)
Scrive il contenuto codificato dell'oggetto nello stream.

writelines( list)
Scrive la lista concatenata di stringhe nello stream (possibilmente riutilizzando il metodo write()).

reset( )
Svuota e azzera i buffer del codec usati per il mantenimento dello stato.

La chiamata a questo metodo dovrebbe assicurare che i dati in uscita vengano messi in uno stato chiaro, che consenta l'aggiunta di nuovi dati senza dover ricontrollare l'intero stream per recuperare lo stato.

In aggiunta ai metodi già indicati, StreamWriter deve anche ereditare tutti gli altri metodi e attributi dello stream sottostante.

Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.