WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

io.TextIOBase

TextIOBase definiert die Schnittstelle für Textströme mit str.

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

Syntax

io.TextIOBase()

TextIOBase definiert die Schnittstelle für Textströme mit str.

encoding bezeichnet die Kodierung, errors die Fehlerbehandlung und newlines die beim universellen Lesen erkannten Zeilenenden. Bei TextIOWrapper gibt buffer Zugriff auf den Binärstrom. detach() gibt ihn zurück und macht den Wrapper unbrauchbar. StringIO hat keinen Binärpuffer und detach() löst io.UnsupportedOperation aus. TextIOWrapper dekodiert Bytes mit der angegebenen Kodierung. Bei UTF-8 liefern drei Aufrufe von read(1) nacheinander 'é', 'x' und am Ende '', obwohl 'é' zwei Bytes belegt.

tell() kann einen undurchsichtigen Positionswert für seek() zurückgeben, der keinen Zeichenindex darstellt.

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

Beispiele

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)))

Ergebnis

True
é x ''

tell() kann einen undurchsichtigen Positionswert für seek() zurückgeben, der keinen Zeichenindex darstellt.

Quellen