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.