import io fp = io.TextIOBase()
Класс io.TextIOBase()
это базовый класс для текстовых потоков. Этот класс предоставляет символьный и линейный интерфейс для потокового ввода-вывода. Он наследует класс io.IOBase
. Не имеет никакого публичного конструктора.
Базовый класс io.TextIOBase
наследует атрибуты и методы из класса io.IOBase
, а так же дополнительно предоставляет или переопределяет несколько атрибутов и методов.
io.TextIOBase
:TextIOBase.encoding
:Атрибут TextIOBase.encoding
имя кодировки, используемой для декодирования байтов потока в строки и для кодирования строк в байты.
TextIOBase.errors
:Атрибут TextIOBase.errors
устанавливает обработчик ошибок кодировки.
TextIOBase.newlines
:Атрибут TextIOBase.newlines
строка, кортеж строк или None
указывающих на символы новой строки. В зависимости от реализации и флагов исходного конструктора этот параметр может быть недоступен.
TextIOBase.buffer
:Атрибут TextIOBase.buffer
базовый двоичный буфер (экземпляр io.BufferedIOBase
), с которым работает io
TextIOBase. Атрибут
TextIOBase.encodingне является частью API
TextIOBase` и может не существовать в некоторых реализациях.
TextIOBase.detach()
:Метод TextIOBase.detach()
отделяет основной двоичный буфер от io.TextIOBase
и возвращает его.
После того как основной буфер был отсоединен, он io.TextIOBase
находится в непригодном для использования состоянии.
Некоторые реализации io.TextIOBase
, например io.StringIO
, могут не иметь концепции базового буфера и вызов этого метода вызовет исключение UnsupportedOperation
.
TextIOBase.read(size=-1)
:Метод TextIOBase.read()
считывает и возвращает не более size
символов из потока в виде одной строки str
. Если размер отрицательный или нет, считывает до EOF.
TextIOBase.readline(size=-1)
:Метод TextIOBase.readline()
производит считывает до новой строки или EOF и возвращайте одну строку str
. Если поток уже находится в EOF, то возвращает пустую строку.
Если указан размер size
, то будет прочитано не более size
символов.
TextIOBase.seek(offset, whence=os.SEEK_SET)
:Метод TextIOBase.seek()
изменяет положение потока на заданное смещение offset
. Поведение зависит от параметра whence
. Значение по умолчанию os.SEEK_SET
.
Значения whence
- это константы модуля os
:
os.SEEK_SET
или 0 - искать с начала потока (по умолчанию). Смещение должно быть либо числом, возвращаемым io.TextIOBase.tell()
или ноль. Любое другое значение смещения приводит к неопределенному поведению.os.SEEK_CUR
или 1 - искать с текущей позиции. Смещение должно быть равно нулю, что не является операцией, все остальные значения не поддерживаются.os.SEEK_END
или 2 - искать с конца потока. Смещение должно быть равно нулю, все остальные значения не поддерживаются.Возвращает новое абсолютное положение курсора в потоке в виде непрозрачного числа.
TextIOBase.tell()
:Метод TextIOBase.detach()
возвращает текущую позицию курсора в потоке в виде непрозрачного числа. То есть число - это НЕ количество байтов в базовом двоичном хранилище.
TextIOBase.write(s)
:Метод TextIOBase.write()
записывает строки s
в поток и возвращает количество записанных символов.