Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

In 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