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.