Сообщить об ошибке.

Класс io.TextIOBase() модуля io в Python

Базовый класс текстовых потоков

Синтаксис:

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), с которым работает ioTextIOBase. АтрибутTextIOBase.encodingне является частью APITextIOBase` и может не существовать в некоторых реализациях.

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 в поток и возвращает количество записанных символов.