Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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() -> str

io.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

Fonti