Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

`io.StringIO.read`: odczyt tekstu z pamięci

Odczytuj tekst od bieżącej pozycji w strumieniu `StringIO` i odróżniaj taki odczyt od pobrania całej zawartości bufora za pomocą `getvalue()`.

Wersja: Python 3.12

Składnia

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

io.StringIO.read to metoda instancji klasy StringIO z modułu io. Czyta od bieżącej pozycji w buforze tekstowym w pamięci i zwraca str, a nie bytes. Nowy strumień zaczyna na początku bufora, nawet jeśli konstruktor otrzymał tekst początkowy.

Przekaż size pozycyjnie: stream.read(2) zwraca najwyżej dwa znaki i przesuwa pozycję o liczbę odczytanych znaków. read() bez argumentu, z ujemnym rozmiarem lub z None czyta do końca strumienia. Na końcu kolejny odczyt zwraca ''; read(0) także zwraca '', ale bez przesuwania pozycji, więc nie świadczy o końcu strumienia. Aby znów czytać od początku, wywołaj seek(0).

write(s) zapisuje tekst na bieżącej pozycji, przesuwa ją i zwraca liczbę zapisanych znaków. Może nadpisać istniejący tekst, zamiast dopisać go na końcu. getvalue() zwraca cały tekst z bufora bez zmiany pozycji — nie trzeba wywoływać seek(0). Pobierz wynik wewnątrz bloku with: po wyjściu z niego strumień zostaje zamknięty, bufor jest usuwany, a próba odczytu zgłasza ValueError.

Przykłady

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

Wynik

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

`repr()` pokazuje pusty wynik jako `''`. Po `seek(0)` znów odczytujemy `'ab'`, a `getvalue()` pobiera `'ab|cde'` ze strumienia wyjściowego bez cofania go.

Powiązane lekcje

  • Python · Lekcja 32 · Średniozaawansowany · Wersja: 3

Źródła