Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri