Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje