Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

`io.StringIO.read`: leggere testo in memoria

Leggi dalla posizione corrente di un flusso di testo `StringIO` e distingui questa lettura dal recupero dell’intero buffer con `getvalue()`.

Versione: Python 3.12

Sintassi

stream.read(size=-1, /) -> str  # Method signature; stream is an io.StringIO instance

io.StringIO.read è un metodo di istanza della classe StringIO del modulo io. Legge dalla posizione corrente in un buffer di testo in memoria e restituisce una str, non dei bytes. Un nuovo flusso si trova all’inizio del buffer, anche se fornisci del testo iniziale.

Passa size come argomento posizionale: stream.read(2) restituisce al massimo due caratteri e avanza di tanti caratteri quanti ne ha letti. Senza argomento, con una dimensione negativa o con None, read() legge fino alla fine del flusso. A quel punto un’altra lettura restituisce ''. Anche read(0) restituisce '' senza spostare la posizione, quindi non serve a rilevare la fine del flusso. Usa seek(0) per rileggere dall’inizio.

write(s) scrive alla posizione corrente, la fa avanzare e restituisce il numero di caratteri scritti. Può sovrascrivere il testo esistente anziché aggiungerlo in coda. getvalue() restituisce tutto il testo del buffer senza cambiare la posizione, quindi non occorre chiamare prima seek(0). Recupera il risultato nel blocco with: all’uscita il flusso viene chiuso e il buffer viene scartato. Leggere dopo la chiusura solleva ValueError.

Esempi

import io

with io.StringIO('abcde') as source, io.StringIO() as target:
    first = source.read(2)
    rest = source.read()
    print(repr(first))
    print(repr(rest))
    print(repr(source.read(1)))

    source.seek(0)
    print(repr(source.read(2)))

    target.write(first)
    target.write('|')
    target.write(rest)
    result = target.getvalue()

print(repr(result))

Risultato

'ab'
'cde'
''
'ab'
'ab|cde'

`repr()` rende visibile il risultato vuoto come `''`. Dopo `seek(0)`, dal flusso di ingresso si legge di nuovo `'ab'`, mentre `getvalue()` recupera `'ab|cde'` dal flusso di uscita senza riportarlo all’inizio.

Lezioni correlate

  • Python · Lezione 32 · Intermedio · Versione: 3

Fonti