CKTIS / Python
io.StringIO: leggere, scrivere e recuperare l’intero buffer
Usa `read()` per leggere dalla posizione corrente, `write()` per costruire l’output a più riprese e `getvalue()` per recuperare tutto il testo senza spostare la posizione.
Versione: Python 3.12
Sintassi
io.StringIO(initial_value='', newline='\n')
Methods on a StringIO instance (signature notation):
read(size=-1, /) -> str
write(s, /) -> int
getvalue() -> strIn Python 3.12, io.StringIO è un flusso di testo in memoria, non un file su disco. Puoi fornire del testo iniziale come input e usare un flusso distinto e vuoto per raccogliere l’output. La posizione iniziale è all’inizio del buffer, anche se contiene già del testo.
read() restituisce uno str dalla posizione corrente fino alla fine e fa avanzare la posizione oltre il testo letto. read(n) legge al massimo n caratteri se n non è negativo. Alla fine del flusso, read() restituisce ''. write(s) scrive uno str nella posizione corrente, fa avanzare la posizione e restituisce il numero di caratteri scritti. Non aggiunge sempre in coda: può sovrascrivere il testo esistente. Passare dei bytes a write() solleva TypeError.
getvalue() non accetta argomenti e restituisce l’intero buffer come str, a prescindere dalla posizione corrente. Non sposta la posizione e non svuota il buffer, quindi non serve chiamare seek(0). Interpreta le terminazioni di riga come read(), in base all’impostazione newline.
Recupera il risultato prima di uscire dal blocco with: alla chiusura del flusso il buffer viene scartato e una successiva chiamata a getvalue() solleva un’eccezione. Lo str già recuperato rimane disponibile.
Esempi
import io
with io.StringIO("go") as src, io.StringIO() as dst:
text = src.read()
dst.write("[")
dst.write(text.upper() + "]")
position = dst.tell()
result = dst.getvalue()
assert dst.tell() == position
print(repr(dst.read()))
print(result)Risultato
'' [GO]
L’esempio legge `go` e costruisce `[GO]` con due scritture. `getvalue()` recupera tutto il risultato senza spostare la posizione. La chiamata successiva a `read()` restituisce `''` perché la posizione è ancora alla fine. Il risultato salvato può essere stampato dopo la chiusura del flusso.
Lezioni correlate
- Python · Lezione 32 · Intermedio · Versione: 3
Fonti
- io — Core tools for working with streams: StringIO.getvalue()
- io — Core tools for working with streams: StringIO
- io — Core tools for working with streams: TextIOBase.read()
- io — Core tools for working with streams: TextIOBase.write()
- io — Core tools for working with streams: IOBase
- io — Core tools for working with streams: Overview