CKTIS / Python
io.StringIO
StringIO bewaart Unicode-tekst in het geheugen en accepteert str bij het schrijven.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
io.StringIO(initial_value='', newline='\n')StringIO bewaart Unicode-tekst in het geheugen en accepteert str bij het schrijven.
Bij gegevens met CRLF zet newline=None het regeleinde om naar LF en behoudt newline='' het oorspronkelijke einde. getvalue() na close() veroorzaakt ValueError. Ook met de begintekst 'abc' begint de cursor op nul, zodat het schrijven van 'X' de tekst 'Xbc' oplevert. Na seek(0, 2) wordt '!' achteraan toegevoegd. getvalue() geeft de volledige tekst zonder de cursor te verplaatsen.
Het schrijven van bytes veroorzaakt 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) leest hoogstens size tekens vanaf de cursor en schuift deze op. Zonder grootte of met negatieve grootte leest het tot het einde, waar de lege tekenreeks volgt. write geeft het aantal geschreven tekens en getvalue de hele tekst zonder verplaatsing.
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"
Voorbeelden
import io
with io.StringIO("abc") as stream:
stream.write("X")
print(stream.getvalue())
stream.seek(0, 2)
stream.write("!")
print(stream.getvalue())
Resultaat
Xbc Xbc!
Het schrijven van bytes veroorzaakt TypeError.