Модули и функции · встроенный MicroPython FEMM 5

io

Текстовые и двоичные потоки, включая буферы в памяти.

Условия работы

StringIO хранит str; BytesIO хранит bytes. open совпадает со встроенным open.
Потоки поддерживают with; close освобождает ресурс. Не обращайтесь к потоку после закрытия.

io.openОткрывает файл для чтения/записи.

io.open

open(file, mode="r", *, encoding=None)

Открывает файл для чтения/записи.

Аргументы

Аргументы вызова `io.open`
Имя	Назначение и допустимые значения
`file`	Строка пути.
`mode`	r чтение, w замена, a дополнение, x создание; b для байтов, + для обновления.
`encoding`	Кодировка текста, например UTF-8.

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

Текстовый либо двоичный поток.

Пример

"Пример io.open.\nСреда: встроенный MicroPython FEMM 5.\nОткрывает файл для чтения/записи.\nРезультат: Текстовый либо двоичный поток."

import io
import os
import tempfile
work=tempfile.mkdtemp(prefix='femm-doc-',dir='.')
p=work+'/run.txt'
with io.open(p,'w',encoding='UTF-8') as f:
    f.write('FEMM')
with io.open(p,'r') as f:
    assert f.read() == 'FEMM'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.StringIOПозволяет применять CSV/JSON/текстовые алгоритмы без файла.

io.StringIO

StringIO(initial_value="")

Позволяет применять CSV/JSON/текстовые алгоритмы без файла.

Аргументы

Аргументы вызова `io.StringIO`
Имя	Назначение и допустимые значения
`initial_value`	Начальный текст либо байты; по умолчанию пусто.

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

Поток в памяти.

Пример

"Пример io.StringIO.\nСреда: встроенный MicroPython FEMM 5.\nПозволяет применять CSV/JSON/текстовые алгоритмы без файла.\nРезультат: Поток в памяти."

import io
s=io.StringIO('FEMM')
assert s.read() == 'FEMM'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.StringIO.readЧитает от текущего положения.

io.StringIO.read

StringIO.read(size=-1)

Читает от текущего положения.

Аргументы

Аргументы вызова `io.StringIO.read`
Имя	Назначение и допустимые значения
`size`	Максимум символов/байтов; -1 означает до конца.

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

str.

Пример

"Пример io.StringIO.read.\nСреда: встроенный MicroPython FEMM 5.\nЧитает от текущего положения.\nРезультат: str."

import io
s=io.StringIO('FEMM')
assert s.read(2) == 'FE'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.StringIO.readlineЧитает до перевода строки или конца.

io.StringIO.readline

StringIO.readline(size=-1)

Читает до перевода строки или конца.

Аргументы

Аргументы вызова `io.StringIO.readline`
Имя	Назначение и допустимые значения
`size`	Предельная длина или -1.

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

Одна строка str с переводом, если он присутствовал.

Пример

"Пример io.StringIO.readline.\nСреда: встроенный MicroPython FEMM 5.\nЧитает до перевода строки или конца.\nРезультат: Одна строка str с переводом, если он присутствовал."

import io
s=io.StringIO('FEMM')
assert s.readline() == 'FEMM'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.StringIO.getvalueВозвращает всё содержимое, независимо от позиции.

io.StringIO.getvalue

StringIO.getvalue()

Возвращает всё содержимое, независимо от позиции.

Аргументы

Аргументы не требуются.

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

str всего буфера.

Пример

"Пример io.StringIO.getvalue.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает всё содержимое, независимо от позиции.\nРезультат: str всего буфера."

import io
s=io.StringIO('FEMM')
assert s.getvalue() == 'FEMM'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.StringIO.seekПеремещает курсор потока.

io.StringIO.seek

StringIO.seek(offset, whence=0)

Перемещает курсор потока.

Аргументы

Аргументы вызова `io.StringIO.seek`
Имя	Назначение и допустимые значения
`offset`	Смещение.
`whence`	0 от начала, 1 от текущей позиции, 2 от конца.

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

Новая позиция.

Пример

"Пример io.StringIO.seek.\nСреда: встроенный MicroPython FEMM 5.\nПеремещает курсор потока.\nРезультат: Новая позиция."

import io
s=io.StringIO('FEMM')
s.read()
s.seek(0)
assert s.read() == 'FEMM'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.StringIO.tellЧитает позицию курсора.

io.StringIO.tell

StringIO.tell()

Читает позицию курсора.

Аргументы

Аргументы не требуются.

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

Текущая позиция.

Пример

"Пример io.StringIO.tell.\nСреда: встроенный MicroPython FEMM 5.\nЧитает позицию курсора.\nРезультат: Текущая позиция."

import io
s=io.StringIO('FEMM')
s.read(2)
assert s.tell() == 2

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.StringIO.flushСбрасывает накопленную запись; для буфера в памяти изменений нет.

io.StringIO.flush

StringIO.flush()

Сбрасывает накопленную запись; для буфера в памяти изменений нет.

Аргументы

Аргументы не требуются.

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

None.

Пример

"Пример io.StringIO.flush.\nСреда: встроенный MicroPython FEMM 5.\nСбрасывает накопленную запись; для буфера в памяти изменений нет.\nРезультат: None."

import io
s=io.StringIO('FEMM')
s.flush()
assert s.getvalue() == 'FEMM'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.StringIO.closeЗакрывает буфер.

io.StringIO.close

StringIO.close()

Закрывает буфер.

Аргументы

Аргументы не требуются.

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

None.

Пример

"Пример io.StringIO.close.\nСреда: встроенный MicroPython FEMM 5.\nЗакрывает буфер.\nРезультат: None."

import io
s=io.StringIO('FEMM')
s.close()

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.StringIO.writeПишет от текущей позиции с заменой существующих данных.

io.StringIO.write

StringIO.write(data)

Пишет от текущей позиции с заменой существующих данных.

Аргументы

Аргументы вызова `io.StringIO.write`
Имя	Назначение и допустимые значения
`data`	Строка текста.

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

Число записанных символов/байтов.

Пример

"Пример io.StringIO.write.\nСреда: встроенный MicroPython FEMM 5.\nПишет от текущей позиции с заменой существующих данных.\nРезультат: Число записанных символов/байтов."

import io
s=io.StringIO('FEMM')
s.seek(0)
assert s.write('X') == 1

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.BytesIOПозволяет применять CSV/JSON/текстовые алгоритмы без файла.

io.BytesIO

BytesIO(initial_value=b"")

Позволяет применять CSV/JSON/текстовые алгоритмы без файла.

Аргументы

Аргументы вызова `io.BytesIO`
Имя	Назначение и допустимые значения
`initial_value`	Начальный текст либо байты; по умолчанию пусто.

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

Поток в памяти.

Пример

"Пример io.BytesIO.\nСреда: встроенный MicroPython FEMM 5.\nПозволяет применять CSV/JSON/текстовые алгоритмы без файла.\nРезультат: Поток в памяти."

import io
s=io.BytesIO(b'FEMM')
assert s.read() == b'FEMM'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.BytesIO.readЧитает от текущего положения.

io.BytesIO.read

BytesIO.read(size=-1)

Читает от текущего положения.

Аргументы

Аргументы вызова `io.BytesIO.read`
Имя	Назначение и допустимые значения
`size`	Максимум символов/байтов; -1 означает до конца.

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

bytes.

Пример

"Пример io.BytesIO.read.\nСреда: встроенный MicroPython FEMM 5.\nЧитает от текущего положения.\nРезультат: bytes."

import io
s=io.BytesIO(b'FEMM')
assert s.read(2) == b'FE'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.BytesIO.readlineЧитает до перевода строки или конца.

io.BytesIO.readline

BytesIO.readline(size=-1)

Читает до перевода строки или конца.

Аргументы

Аргументы вызова `io.BytesIO.readline`
Имя	Назначение и допустимые значения
`size`	Предельная длина или -1.

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

Одна строка bytes с переводом, если он присутствовал.

Пример

"Пример io.BytesIO.readline.\nСреда: встроенный MicroPython FEMM 5.\nЧитает до перевода строки или конца.\nРезультат: Одна строка bytes с переводом, если он присутствовал."

import io
s=io.BytesIO(b'FEMM')
assert s.readline() == b'FEMM'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.BytesIO.getvalueВозвращает всё содержимое, независимо от позиции.

io.BytesIO.getvalue

BytesIO.getvalue()

Возвращает всё содержимое, независимо от позиции.

Аргументы

Аргументы не требуются.

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

bytes всего буфера.

Пример

"Пример io.BytesIO.getvalue.\nСреда: встроенный MicroPython FEMM 5.\nВозвращает всё содержимое, независимо от позиции.\nРезультат: bytes всего буфера."

import io
s=io.BytesIO(b'FEMM')
assert s.getvalue() == b'FEMM'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.BytesIO.seekПеремещает курсор потока.

io.BytesIO.seek

BytesIO.seek(offset, whence=0)

Перемещает курсор потока.

Аргументы

Аргументы вызова `io.BytesIO.seek`
Имя	Назначение и допустимые значения
`offset`	Смещение.
`whence`	0 от начала, 1 от текущей позиции, 2 от конца.

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

Новая позиция.

Пример

"Пример io.BytesIO.seek.\nСреда: встроенный MicroPython FEMM 5.\nПеремещает курсор потока.\nРезультат: Новая позиция."

import io
s=io.BytesIO(b'FEMM')
s.read()
s.seek(0)
assert s.read() == b'FEMM'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.BytesIO.tellЧитает позицию курсора.

io.BytesIO.tell

BytesIO.tell()

Читает позицию курсора.

Аргументы

Аргументы не требуются.

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

Текущая позиция.

Пример

"Пример io.BytesIO.tell.\nСреда: встроенный MicroPython FEMM 5.\nЧитает позицию курсора.\nРезультат: Текущая позиция."

import io
s=io.BytesIO(b'FEMM')
s.read(2)
assert s.tell() == 2

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.BytesIO.flushСбрасывает накопленную запись; для буфера в памяти изменений нет.

io.BytesIO.flush

BytesIO.flush()

Сбрасывает накопленную запись; для буфера в памяти изменений нет.

Аргументы

Аргументы не требуются.

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

None.

Пример

"Пример io.BytesIO.flush.\nСреда: встроенный MicroPython FEMM 5.\nСбрасывает накопленную запись; для буфера в памяти изменений нет.\nРезультат: None."

import io
s=io.BytesIO(b'FEMM')
s.flush()
assert s.getvalue() == b'FEMM'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.BytesIO.closeЗакрывает буфер.

io.BytesIO.close

BytesIO.close()

Закрывает буфер.

Аргументы

Аргументы не требуются.

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

None.

Пример

"Пример io.BytesIO.close.\nСреда: встроенный MicroPython FEMM 5.\nЗакрывает буфер.\nРезультат: None."

import io
s=io.BytesIO(b'FEMM')
s.close()

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.BytesIO.writeПишет от текущей позиции с заменой существующих данных.

io.BytesIO.write

BytesIO.write(data)

Пишет от текущей позиции с заменой существующих данных.

Аргументы

Аргументы вызова `io.BytesIO.write`
Имя	Назначение и допустимые значения
`data`	Байтовый объект.

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

Число записанных символов/байтов.

Пример

"Пример io.BytesIO.write.\nСреда: встроенный MicroPython FEMM 5.\nПишет от текущей позиции с заменой существующих данных.\nРезультат: Число записанных символов/байтов."

import io
s=io.BytesIO(b'FEMM')
s.seek(0)
assert s.write(b'X') == 1

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

io.BytesIO.readintoЧитает данные без создания нового bytes.

io.BytesIO.readinto

stream.readinto(buffer)

Читает данные без создания нового bytes.

Аргументы

Аргументы вызова `io.BytesIO.readinto`
Имя	Назначение и допустимые значения
`buffer`	Изменяемый байтовый буфер.

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

Число прочитанных байтов, 0 в конце.

Пример

"Пример io.BytesIO.readinto.\nСреда: встроенный MicroPython FEMM 5.\nЧитает данные без создания нового bytes.\nРезультат: Число прочитанных байтов, 0 в конце."

import io
s=io.BytesIO(b'FEMM')
b=bytearray(2)
assert s.readinto(b) == 2 and b == b'FE'

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

Имена в установленной сборке

Перечень получен во встроенном интерпретаторе. Он включает функции, классы и константы. Ссылки ведут к контрактам; для прямого доступа ulab учитывайте условия этого раздела.

BytesIOIOBaseStringIOopen