KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

io.TextIOBase

TextIOBase beschrijft de interface van tekststreams die met str werken.

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

Syntax

io.TextIOBase()

TextIOBase beschrijft de interface van tekststreams die met str werken.

encoding geeft de codering aan, errors de foutafhandeling en newlines de aangetroffen regeleinden bij universeel lezen. Bij TextIOWrapper geeft buffer toegang tot de binaire stream. detach() geeft die terug en maakt de wrapper onbruikbaar. StringIO heeft geen binaire buffer en detach() veroorzaakt io.UnsupportedOperation. TextIOWrapper decodeert bytes volgens de gekozen codering. Bij UTF-8 leveren drie aanroepen van read(1) achtereenvolgens 'é', 'x' en aan het einde '', hoewel 'é' twee bytes beslaat.

tell() kan een ondoorzichtige positiewaarde geven die je aan seek() doorgeeft om de positie te herstellen, zonder die als tekenindex te gebruiken.

import io
with io.TextIOWrapper(io.BytesIO('éx'.encode()),encoding='utf-8') as s:
    assert isinstance(s,io.TextIOBase) and s.read(1)=='é'
    cookie=s.tell()
    assert s.read(2)=='x' and s.read(1)==''
    assert s.seek(cookie)==cookie and s.read(1)=='x'
    try: s.write(b'x')
    except TypeError: pass
    else: raise AssertionError
raw=io.BytesIO(b'a\r\n')
s=io.TextIOWrapper(raw,encoding='utf-8',errors='strict',newline=None)
assert (s.encoding,s.errors,s.read(),s.newlines)==('utf-8','strict','a\n','\r\n')
assert s.buffer is s.detach() is raw
try: s.read()
except ValueError: pass
else: raise AssertionError
raw.close()
with io.StringIO() as s:
    try: s.detach()
    except io.UnsupportedOperation: pass
    else: raise AssertionError

Voorbeelden

import io
with io.TextIOWrapper(io.BytesIO("éx".encode()), encoding="utf-8") as stream:
    print(isinstance(stream, io.TextIOBase))
    print(stream.read(1), stream.read(1), repr(stream.read(1)))

Resultaat

True
é x ''

tell() kan een ondoorzichtige positiewaarde geven die je aan seek() doorgeeft om de positie te herstellen, zonder die als tekenindex te gebruiken.

Bronnen