Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Python

io.StringIO

StringIO uchováva text Unicode v pamäti a pri zápise prijíma str.

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

Syntax

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

StringIO uchováva text Unicode v pamäti a pri zápise prijíma str.

Pri dátach zakončených CRLF nastavenie newline=None prevedie koniec riadka na LF, zatiaľ čo newline='' ho zachová. Volanie getvalue() po close() vyvolá ValueError. Aj pri počiatočnom texte 'abc' začína kurzor na nule, takže zápis 'X' vytvorí 'Xbc'. Po seek(0, 2) sa '!' pripíše na koniec. getvalue() vráti celý text bez posunu kurzora.

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) prečíta od kurzora najviac size znakov a posunie ho. Bez veľkosti alebo so zápornou veľkosťou číta do konca, kde vráti prázdny reťazec. write vráti počet zapísaných znakov, 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"

Prí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ýsledok

Xbc
Xbc!

Zápis bytes vyvolá TypeError.

Zdroje