Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

io.StringIO

StringIO przechowuje tekst Unicode w pamięci i przyjmuje w write() obiekty str.

Wersja: Python 3.14; repository image, production runtime not attested

Składnia

io.StringIO(initial_value='', newline='\n')

StringIO przechowuje tekst Unicode w pamięci i przyjmuje w write() obiekty str.

Dla danych zakończonych CRLF ustawienie newline=None normalizuje zakończenie do LF, a newline='' je zachowuje. Wywołanie getvalue() po close() zgłasza ValueError. Kursor zaczyna na pozycji zero także dla początkowego 'abc', więc zapis 'X' daje 'Xbc'. Po seek(0, 2) zapis '!' dopisuje znak na końcu. getvalue() zwraca cały tekst bez przesuwania kursora.

Próba zapisania bytes zgłasza TypeError.

import io
s=io.StringIO('éa')
assert s.tell()==0 and s.read(1)=='é'
s.seek(0)
assert s.write('猫')==1 and s.getvalue()=='猫a'
s.seek(0,2)
s.write('!')
assert s.getvalue()=='猫a!'
try: s.write(b'x')
except TypeError: pass
else: raise AssertionError
for newline,expected in [(None,'x\n'),('','x\r\n')]:
    with io.StringIO('x\r\n',newline=newline) as text:
        assert text.read()==expected
    try: text.getvalue()
    except ValueError: pass
    else: raise AssertionError

io.StringIO.read · io.StringIO.write · io.StringIO.getvalue

read(size) pobiera od bieżącej pozycji najwyżej size znaków i przesuwa kursor. Bez rozmiaru lub z ujemnym rozmiarem czyta do końca, a na końcu daje pusty napis. write zwraca liczbę zapisanych znaków. getvalue odczytuje całość bez przesunięcia.

from io import StringIO
with StringIO("éxy") as s:
    assert s.read(1)=="é" and s.tell()==1
    assert s.write("A")==1 and s.getvalue()=="éAy" and s.tell()==2
    assert s.read(8)=="y" and s.read(1)==""
    s.seek(0)
    assert s.read()=="éAy"

Przykłady

import io
with io.StringIO("abc") as stream:
    stream.write("X")
    print(stream.getvalue())
    stream.seek(0, 2)
    stream.write("!")
    print(stream.getvalue())

Wynik

Xbc
Xbc!

Próba zapisania bytes zgłasza TypeError.

Źródła