KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen