CKTIS / Python
io.TextIOBase
TextIOBase določa vmesnik besedilnih tokov, ki delajo z vrednostmi str.
Različica: Python 3.14; repository image, production runtime not attested
Sintaksa
io.TextIOBase()TextIOBase določa vmesnik besedilnih tokov, ki delajo z vrednostmi str.
encoding pomeni kodiranje, errors obravnavo napak, newlines pa konce vrstic, zaznane pri univerzalnem branju. Pri TextIOWrapper omogoča buffer dostop do binarnega toka. detach() ga vrne in ovoj postane neuporaben. StringIO nima binarnega medpomnilnika in detach() sproži io.UnsupportedOperation. TextIOWrapper dekodira bajte z izbranim kodiranjem. Pri UTF-8 trije klici read(1) vrnejo 'é', 'x' in na koncu '', čeprav 'é' zavzame dva bajta.
tell() lahko vrne neprozorno vrednost za obnovitev položaja s seek(), ki je ne moremo obravnavati kot indeks znaka.
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
Primeri
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)))
Rezultat
True é x ''
tell() lahko vrne neprozorno vrednost za obnovitev položaja s seek(), ki je ne moremo obravnavati kot indeks znaka.