CKTIS / Python
Scrivere, leggere e recuperare testo con io.StringIO
Usa `write()` per scrivere testo in memoria un pezzo alla volta, `read()` per leggere dalla posizione corrente e `getvalue()` per ottenere l’intero buffer senza tornare all’inizio.
Versione: Python 3.12
Sintassi
Python 3.12 — method signatures for a stream created with io.StringIO(...):
stream.write(s, /) -> int
stream.read(size=-1, /) -> str
stream.getvalue() -> strio.StringIO è un flusso di testo in memoria, non un file su disco. Un flusso creato con io.StringIO(testo) parte dall’inizio, quindi una scrittura immediata può sovrascrivere il testo iniziale. Per aggiungere testo in coda, chiama prima stream.seek(0, io.SEEK_END).
stream.write(s) scrive uno str alla posizione corrente, fa avanzare la posizione e restituisce il numero di caratteri scritti, non il numero di byte né il testo. Passare bytes solleva TypeError; per i dati binari in memoria usa io.BytesIO. write() non aggiunge un fine riga. Il valore predefinito newline='\n' non converte i fine riga in scrittura. In una firma, / indica che i parametri che lo precedono sono solo posizionali.
stream.read(n) restituisce come str fino a n caratteri dalla posizione corrente e avanza oltre i caratteri letti. Senza dimensione, con None o con una dimensione negativa, read() legge fino alla fine; se è già alla fine, restituisce ''. Usa stream.seek(0) per leggere dall’inizio.
stream.getvalue() restituisce l’intero buffer come str senza cambiare posizione. Recupera il risultato prima di chiamare close() o di uscire dal blocco with: la chiusura elimina il buffer e impedisce di usare ancora questi metodi, ma una stringa già recuperata resta utilizzabile.
Esempi
import io
with io.StringIO("red blue") as source, io.StringIO() as target:
first = target.write(source.read(3).upper())
second = target.write(source.read().upper())
result = target.getvalue()
print(first, second)
print(repr(target.read()))
print(result)
Risultato
3 5 '' RED BLUE
Le letture consumano prima `red` e poi ` blue`. Le due scritture salvano i frammenti in maiuscolo e restituiscono `3` e `5`; il secondo frammento include uno spazio. `getvalue()` recupera tutto `RED BLUE`, anche se `target.read()` restituisce `''` perché la posizione è ancora alla fine.
Lezioni correlate
- Python · Lezione 32 · Intermedio · Versione: 3