CKTIS / Python
io.StringIO: odczyt, zapis i pobieranie całego bufora
Użyj `read()` do odczytu od bieżącej pozycji, `write()` do zapisu tekstu po kawałku, a `getvalue()` do pobrania całej zawartości bez zmiany pozycji.
Wersja: Python 3.12
Składnia
io.StringIO(initial_value='', newline='\n')
Methods on a StringIO instance (signature notation):
read(size=-1, /) -> str
write(s, /) -> int
getvalue() -> strW Pythonie 3.12 io.StringIO to strumień tekstowy przechowywany w pamięci, a nie plik na dysku. Możesz podać początkowy tekst wejściowy i użyć osobnego, pustego strumienia do gromadzenia wyniku. Początkowa pozycja znajduje się na początku bufora, nawet jeśli zawiera on już tekst.
read() zwraca str od bieżącej pozycji do końca i przesuwa pozycję o odczytany tekst. read(n) odczytuje najwyżej n znaków, jeśli n jest nieujemne. Na końcu strumienia read() zwraca ''. write(s) zapisuje str w bieżącej pozycji, przesuwa ją i zwraca liczbę zapisanych znaków. Nie dopisuje zawsze na końcu: może nadpisać istniejący tekst. Przekazanie bytes do write() powoduje TypeError.
getvalue() nie przyjmuje argumentów i zwraca cały bufor jako str, niezależnie od bieżącej pozycji. Nie zmienia jej ani nie opróżnia bufora, więc nie trzeba wywoływać seek(0). Znaki końca wiersza są interpretowane tak jak w read(), zgodnie z ustawieniem newline.
Pobierz wynik przed wyjściem z bloku with: zamknięcie strumienia usuwa bufor, a późniejsze wywołanie getvalue() kończy się błędem. Pobrany wcześniej str pozostaje dostępny.
Przykłady
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)Wynik
'' [GO]
Przykład odczytuje `go` i buduje `[GO]` dwoma zapisami. `getvalue()` pobiera cały wynik bez zmiany pozycji; późniejsze `read()` zwraca `''`, bo pozycja nadal jest na końcu. Zapisany wynik można wypisać po zamknięciu strumienia.
Powiązane lekcje
- Python · Lekcja 32 · Średniozaawansowany · Wersja: 3
Źródła
- 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