Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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 instance

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

Fontes