WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

io.StringIO

StringIO speichert Unicode-Text im Speicher und nimmt beim Schreiben str entgegen.

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

Syntax

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

StringIO speichert Unicode-Text im Speicher und nimmt beim Schreiben str entgegen.

Bei Daten mit CRLF wandelt newline=None den Zeilenabschluss in LF um, newline='' erhält ihn. getvalue() nach close() löst ValueError aus. Der Cursor steht auch beim Anfangstext 'abc' auf null, daher ergibt das Schreiben von 'X' den Text 'Xbc'. Nach seek(0, 2) wird '!' angehängt. getvalue() liefert den vollständigen Text, ohne den Cursor zu verschieben.

Das Schreiben von bytes löst TypeError aus.

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) liest ab dem Cursor höchstens size Zeichen und rückt ihn vor. Ohne Größe oder bei negativer Größe wird bis zum Ende gelesen, am Ende entsteht die leere Zeichenkette. write liefert die Zahl geschriebener Zeichen, getvalue den ganzen Text ohne Positionsänderung.

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"

Beispiele

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

Ergebnis

Xbc
Xbc!

Das Schreiben von bytes löst TypeError aus.

Quellen