CKTIS / Python
`io.StringIO.read`: ler texto em memória
Lê a partir da posição atual de um fluxo de texto `StringIO` e distingue essa leitura da obtenção de todo o conteúdo do buffer com `getvalue()`.
Versão: Python 3.12
Sintaxe
stream.read(size=-1, /) -> str # Method signature; stream is an io.StringIO instanceio.StringIO.read é um método de instância da classe StringIO do módulo io. Lê a partir da posição atual num buffer de texto em memória e devolve uma str, não bytes. Um fluxo novo fica posicionado no início do buffer, mesmo que forneças texto inicial.
Passa size como argumento posicional: stream.read(2) devolve no máximo dois carateres e avança tantos carateres quantos os que leu. Sem argumento, com um tamanho negativo ou com None, read() lê até ao fim do fluxo. No fim, uma nova leitura devolve ''. read(0) também devolve '', sem alterar a posição, pelo que não serve para detetar o fim do fluxo. Usa seek(0) para voltar a ler desde o início.
write(s) escreve texto na posição atual, faz avançar essa posição e devolve o número de carateres escritos. Pode substituir texto existente em vez de acrescentar texto no fim. getvalue() devolve todo o texto do buffer sem alterar a posição, pelo que não é preciso chamar seek(0) antes. Obtém o resultado dentro do bloco with: à saída, o fluxo é fechado e o buffer é descartado. Ler após o fecho gera ValueError.
Exemplos
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))Resultado
'ab' 'cde' '' 'ab' 'ab|cde'
`repr()` torna o resultado vazio visível como `''`. Depois de `seek(0)`, o fluxo de entrada volta a devolver `'ab'`, enquanto `getvalue()` obtém `'ab|cde'` do fluxo de saída sem voltar ao início desse fluxo.
Lições relacionadas
- Python · Lição 32 · Intermédio · Versão: 3