CKTIS / Python
io.StringIO
StringIO uchovává text Unicode v paměti a při zápisu přijímá str.
Verze: Python 3.14; repository image, production runtime not attested
Syntaxe
io.StringIO(initial_value='', newline='\n')StringIO uchovává text Unicode v paměti a při zápisu přijímá str.
U dat zakončených CRLF nastavení newline=None převede konec řádku na LF, zatímco newline='' jej zachová. Volání getvalue() po close() vyvolá ValueError. I pro počáteční text 'abc' začíná kurzor na nule, takže zápis 'X' vytvoří 'Xbc'. Po seek(0, 2) se '!' připíše na konec. getvalue() vrátí celý text bez posunu kurzoru.
Zápis bytes vyvolá 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) přečte od kurzoru nejvýše size znaků a posune jej. Bez velikosti nebo se zápornou velikostí čte do konce, kde vrátí prázdný řetězec. write vrátí počet zapsaných znaků, getvalue celý text bez posunu.
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"
Příklady
import io
with io.StringIO("abc") as stream:
stream.write("X")
print(stream.getvalue())
stream.seek(0, 2)
stream.write("!")
print(stream.getvalue())
Výsledek
Xbc Xbc!
Zápis bytes vyvolá TypeError.