CKTIS / Python
io.TextIOBase
TextIOBase definira sučelje tekstnih tokova koji rade s objektima str.
Verzija: Python 3.14; repository image, production runtime not attested
Sintaksa
io.TextIOBase()TextIOBase definira sučelje tekstnih tokova koji rade s objektima str.
encoding označava kodiranje, errors obradu pogrešaka, a newlines završetke redaka pronađene pri univerzalnom čitanju. Kod TextIOWrapper, buffer omogućuje pristup binarnom toku. detach() ga vraća i omotač postaje neupotrebljiv. StringIO nema binarni međuspremnik i detach() izaziva io.UnsupportedOperation. TextIOWrapper dekodira bajtove prema zadanom kodiranju. Uz UTF-8 tri poziva read(1) vraćaju 'é', 'x' i na kraju '', iako 'é' zauzima dva bajta.
tell() može vratiti neprozirnu vrijednost za obnovu položaja pomoću seek(), koja nije 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
Primjeri
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() može vratiti neprozirnu vrijednost za obnovu položaja pomoću seek(), koja nije indeks znaka.