InputStream Класс

Файловый объект, представляющий входной BLOB-объект.

Наследование
InputStream
InputStream

Конструктор

InputStream()

Методы

close

Зачистите и закройте объект ввода-вывода.

Этот метод не действует, если файл уже закрыт.

detach

Отключите этот буфер от базового необработанного потока и верните его.

После отсоединения необработанного потока буфер становится непригодным для использования.

fileno

Возвращает базовый дескриптор файла, если он существует.

OSError возникает, если объект ввода-вывода не использует дескриптор файла.

flush

Сброс буферов записи, если применимо.

Это не реализовано для потоков только для чтения и неблокирующих потоков.

isatty

Возвращает значение, указывая, является ли этот поток "интерактивным".

Если его не удается определить, возвращается значение False.

read

Возвращает и считывает до размера байтов.

read1

Чтение и возврат до n байтов с не более чем одним вызовом read() базового необработанного потока. Короткий результат не означает, что EOF неизбежен.

Возвращает пустой объект байтов в EOF.

readable

Возвращает значение, указывая, был ли объект открыт для чтения.

Если значение равно False, read() вызовет OSError.

readinto
readinto1
readline

Чтение и возврат строки из потока.

Если указан размер, считывается не более байтов.

Признак конца строки всегда b'n' для двоичных файлов; Для текстовых файлов открытый аргумент newlines можно использовать для выбора распознаваемых признаков конца строки.

readlines

Возвращает список строк из потока.

для управления числом прочитанных строк можно указать подсказку: больше строки не будут считываться, если общий размер (в байтах/символах) всех строк превышает подсказку.

seek

Изменение положения потока.

Измените положение потока на заданное смещение в байтах. Смещение интерпретируется относительно позиции, указанной значением whence. Значения для параметра whence:

  • 0 — запуск потока (значение по умолчанию); смещение должно быть равно нулю или положительному значению

  • 1 – текущее положение потока; смещение может быть отрицательным

  • 2 — конец потока; смещение обычно отрицательное

Возвращает новую абсолютную позицию.

seekable

Возвращает значение, указывая, поддерживает ли объект случайный доступ.

Если задано значение False, seek(), tell() и truncate() вызовет osError. Для этого метода может потребоваться тестовый метод seek().

tell

Возвращает текущую позицию потока.

truncate

Усечение файла до размера байтов.

Указатель на файл остается без изменений. Размер по умолчанию определяет текущую позицию ввода-вывода, как указано в tell(). Возвращает новый размер.

writable

Возвращает значение, указывая, был ли объект открыт для записи.

Если задано значение False, write() вызовет osError.

write

Запись заданного буфера в поток ввода-вывода.

Возвращает число записанных байтов, которое всегда равно b в байтах.

Вызывает метод BlockingIOError, если буфер заполнен и базовый необработанный поток не может принять больше данных в данный момент.

writelines

Напишите список строк для потоковой передачи.

Разделители строк не добавляются, поэтому обычно каждая из предоставленных строк имеет разделитель строк в конце.

close

Зачистите и закройте объект ввода-вывода.

Этот метод не действует, если файл уже закрыт.

close()

detach

Отключите этот буфер от базового необработанного потока и верните его.

После отсоединения необработанного потока буфер становится непригодным для использования.

detach()

fileno

Возвращает базовый дескриптор файла, если он существует.

OSError возникает, если объект ввода-вывода не использует дескриптор файла.

fileno()

flush

Сброс буферов записи, если применимо.

Это не реализовано для потоков только для чтения и неблокирующих потоков.

flush()

isatty

Возвращает значение, указывая, является ли этот поток "интерактивным".

Если его не удается определить, возвращается значение False.

isatty()

read

Возвращает и считывает до размера байтов.

abstract read(size=-1) -> bytes

Параметры

size
int
значение по умолчанию: -1

Количество байтов, чтение которых необходимо выполнить. Если аргумент опущен или отрицательный, Noneданные считываются и возвращаются до достижения EOF.

Возвращаемое значение

Байты, считанные из входного потока.

read1

Чтение и возврат до n байтов с не более чем одним вызовом read() базового необработанного потока. Короткий результат не означает, что EOF неизбежен.

Возвращает пустой объект байтов в EOF.

read1()

readable

Возвращает значение, указывая, был ли объект открыт для чтения.

Если значение равно False, read() вызовет OSError.

readable()

readinto

readinto(buffer, /)

Параметры

buffer
Обязательно

readinto1

readinto1(buffer, /)

Параметры

buffer
Обязательно

readline

Чтение и возврат строки из потока.

Если указан размер, считывается не более байтов.

Признак конца строки всегда b'n' для двоичных файлов; Для текстовых файлов открытый аргумент newlines можно использовать для выбора распознаваемых признаков конца строки.

readline(size=-1, /)

Параметры

size
значение по умолчанию: -1

readlines

Возвращает список строк из потока.

для управления числом прочитанных строк можно указать подсказку: больше строки не будут считываться, если общий размер (в байтах/символах) всех строк превышает подсказку.

readlines(hint=-1, /)

Параметры

hint
значение по умолчанию: -1

seek

Изменение положения потока.

Измените положение потока на заданное смещение в байтах. Смещение интерпретируется относительно позиции, указанной значением whence. Значения для параметра whence:

  • 0 — запуск потока (значение по умолчанию); смещение должно быть равно нулю или положительному значению

  • 1 – текущее положение потока; смещение может быть отрицательным

  • 2 — конец потока; смещение обычно отрицательное

Возвращает новую абсолютную позицию.

seek()

seekable

Возвращает значение, указывая, поддерживает ли объект случайный доступ.

Если задано значение False, seek(), tell() и truncate() вызовет osError. Для этого метода может потребоваться тестовый метод seek().

seekable()

tell

Возвращает текущую позицию потока.

tell()

truncate

Усечение файла до размера байтов.

Указатель на файл остается без изменений. Размер по умолчанию определяет текущую позицию ввода-вывода, как указано в tell(). Возвращает новый размер.

truncate()

writable

Возвращает значение, указывая, был ли объект открыт для записи.

Если задано значение False, write() вызовет osError.

writable()

write

Запись заданного буфера в поток ввода-вывода.

Возвращает число записанных байтов, которое всегда равно b в байтах.

Вызывает метод BlockingIOError, если буфер заполнен и базовый необработанный поток не может принять больше данных в данный момент.

write()

writelines

Напишите список строк для потоковой передачи.

Разделители строк не добавляются, поэтому обычно каждая из предоставленных строк имеет разделитель строк в конце.

writelines(lines, /)

Параметры

lines
Обязательно

Атрибуты

closed

length

name

uri