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.