Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Python

`io.StringIO.read`: čtení textu z paměti

Čti text od aktuální pozice v proudu `StringIO` a odliš toto čtení od získání celého obsahu vyrovnávací paměti pomocí `getvalue()`.

Verze: Python 3.12

Syntaxe

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

io.StringIO.read je metoda instance třídy StringIO z modulu io. Čte od aktuální pozice v textové vyrovnávací paměti a vrací str, nikoli bytes. Nový proud je na začátku vyrovnávací paměti, i když mu předáš počáteční text.

Předávej size jako poziční argument: stream.read(2) vrátí nejvýše dva znaky a posune pozici o počet přečtených znaků. Bez argumentu, se zápornou velikostí nebo s None čte read() až do konce proudu. Na konci další čtení vrátí ''. Také read(0) vrátí '', ale neposune pozici, takže ho nelze použít k rozpoznání konce proudu. Pomocí seek(0) se vrátíš na začátek a můžeš číst znovu.

write(s) zapisuje text na aktuální pozici, posune ji a vrátí počet zapsaných znaků. Místo připsání na konec může přepsat existující text. getvalue() vrátí celý text z vyrovnávací paměti beze změny pozice, takže předem nemusíš volat seek(0). Výsledek získej uvnitř bloku with: po jeho opuštění se proud uzavře a vyrovnávací paměť se zahodí. Čtení po uzavření vyvolá ValueError.

Příklady

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

Výsledek

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

Díky `repr()` je prázdný výsledek vidět jako `''`. Po `seek(0)` se ze vstupu znovu přečte `'ab'`, zatímco `getvalue()` získá `'ab|cde'` z výstupního proudu bez návratu na jeho začátek.

Související lekce

  • Python · Lekce 32 · Středně pokročilá · Verze: 3

Zdroje