CKTIS / Python
io.StringIO: čtení, zápis a získání celého obsahu vyrovnávací paměti
Pomocí `read()` čtěte od aktuální pozice, pomocí `write()` sestavujte výstup po částech a pomocí `getvalue()` získejte celý text bez změny pozice.
Verze: Python 3.12
Syntaxe
io.StringIO(initial_value='', newline='\n')
Methods on a StringIO instance (signature notation):
read(size=-1, /) -> str
write(s, /) -> int
getvalue() -> strV Pythonu 3.12 je io.StringIO textový proud v paměti, nikoli soubor na disku. Můžete předat počáteční text jako vstup a výstup shromažďovat v samostatném prázdném proudu. Počáteční pozice je na začátku vyrovnávací paměti, i když už obsahuje text.
read() vrátí str od aktuální pozice do konce a posune pozici za přečtený text. read(n) přečte nejvýše n znaků, je-li n nezáporné. Na konci proudu vrátí read() ''. write(s) zapíše str na aktuální pozici, posune ji a vrátí počet zapsaných znaků. Nezapisuje vždy na konec: může přepsat existující text. Předání bytes metodě write() vyvolá TypeError.
getvalue() nepřijímá žádné argumenty a vrátí celý obsah vyrovnávací paměti jako str bez ohledu na aktuální pozici. Pozici nemění a paměť nevyprázdní, takže není třeba volat seek(0). Konce řádků zpracovává stejně jako read(), podle nastavení newline.
Výsledek získejte před opuštěním bloku with: zavřením se vyrovnávací paměť proudu uvolní a pozdější volání getvalue() vyvolá výjimku. Již získaný str zůstává k dispozici.
Příklady
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)Výsledek
'' [GO]
Příklad přečte `go` a dvěma zápisy sestaví `[GO]`. `getvalue()` získá celý výsledek beze změny pozice. Následující `read()` vrátí `''`, protože pozice je stále na konci. Uložený výsledek lze vypsat po zavření proudu.
Související lekce
- Python · Lekce 32 · Středně pokročilá · Verze: 3
Zdroje
- io — Core tools for working with streams: StringIO.getvalue()
- io — Core tools for working with streams: StringIO
- io — Core tools for working with streams: TextIOBase.read()
- io — Core tools for working with streams: TextIOBase.write()
- io — Core tools for working with streams: IOBase
- io — Core tools for working with streams: Overview