База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

io.TextIOBase

TextIOBase определя интерфейса на текстовите потоци, които работят със str.

Версия: Python 3.14; repository image, production runtime not attested

Синтаксис

io.TextIOBase()

TextIOBase определя интерфейса на текстовите потоци, които работят със str.

encoding обозначава кодировката, errors обработката на грешки, а newlines срещнатите окончания на редове при универсално четене. При TextIOWrapper buffer дава достъп до двоичния поток. detach() го връща и обвивката става неизползваема. StringIO няма двоичен буфер и detach() предизвиква io.UnsupportedOperation. TextIOWrapper декодира байтовете според избраната кодировка. При UTF-8 три извиквания на read(1) връщат 'é', 'x' и накрая '', въпреки че 'é' заема два байта.

tell() може да върне непрозрачна стойност за възстановяване на позицията чрез seek(), която не е индекс на символ.

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

Примери

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

Резултат

True
é x ''

tell() може да върне непрозрачна стойност за възстановяване на позицията чрез seek(), която не е индекс на символ.

Източници