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.