Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

W 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