Модули и функции · встроенный MicroPython FEMM 5
base64
Текстовое кодирование двоичных данных.
Условия работы
- Основной результат кодирования — bytes. Для текстового JSON или CSV явно вызывайте .decode().
- Декодирование не шифрует данные. При нарушении алфавита/дополнения возможен binascii.Error.
base64.b64encodebase64.b64decodebase64.standard_b64encodebase64.standard_b64decodebase64.urlsafe_b64encodebase64.urlsafe_b64decodebase64.b32encodebase64.b32decodebase64.b16encodebase64.b16decodebase64.encodebytesbase64.decodebytesbase64.encodebase64.decodebase64.encodestringbase64.decodestringbase64.b64encodeКодирует небольшие бинарные блоки результатов.
base64.b64encode
b64encode(s, altchars=None)Кодирует небольшие бинарные блоки результатов.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
s | Байтовые данные. |
altchars | None или два байта, заменяющие + и /. |
Возвращаемое значение
bytes Base64.
Пример
"Пример base64.b64encode.\nСреда: встроенный MicroPython FEMM 5.\nКодирует небольшие бинарные блоки результатов.\nРезультат: bytes Base64."
import base64
assert base64.b64encode(b'FEMM') == b'RkVNTQ=='
Ожидаемый результат. Проверки assert проходят без исключения.
Скачать пример · Ссылка на функцию
Этот пример выполнен в установленном FEMM 5.
base64.b64decodeДекодирует Base64; корректное дополнение = обязательно.
base64.b64decode
b64decode(s, altchars=None, validate=False)Декодирует Base64; корректное дополнение = обязательно.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
s | Base64 как bytes или ASCII-строка. |
altchars | Альтернативная пара символов алфавита. |
validate | True запрещает посторонние символы до проверки дополнения. |
Возвращаемое значение
Исходные bytes.
Особенности вызова
- validate=True использует байтовый шаблон re, неработающий в этой сборке; используйте validate=False и проверяйте формат входных данных отдельно.
Пример
"Пример base64.b64decode.\nСреда: встроенный MicroPython FEMM 5.\nДекодирует Base64; корректное дополнение = обязательно.\nРезультат: Исходные bytes."
import base64
assert base64.b64decode(b'RkVNTQ==') == b'FEMM'
Ожидаемый результат. Проверки assert проходят без исключения.
Скачать пример · Ссылка на функцию
Этот пример выполнен в установленном FEMM 5.
base64.standard_b64encodeКодирует стандартным алфавитом.
base64.standard_b64encode
standard_b64encode(s)Кодирует стандартным алфавитом.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
s | Байтовые данные. |
Возвращаемое значение
bytes Base64.
Пример
"Пример base64.standard_b64encode.\nСреда: встроенный MicroPython FEMM 5.\nКодирует стандартным алфавитом.\nРезультат: bytes Base64."
import base64
assert base64.standard_b64encode(b'A') == b'QQ=='
Ожидаемый результат. Проверки assert проходят без исключения.
Скачать пример · Ссылка на функцию
Этот пример выполнен в установленном FEMM 5.
base64.standard_b64decodeДекодирует стандартный Base64.
base64.standard_b64decode
standard_b64decode(s)Декодирует стандартный Base64.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
s | Base64 как bytes или ASCII-строка. |
Возвращаемое значение
Исходные bytes.
Пример
"Пример base64.standard_b64decode.\nСреда: встроенный MicroPython FEMM 5.\nДекодирует стандартный Base64.\nРезультат: Исходные bytes."
import base64
assert base64.standard_b64decode(b'QQ==') == b'A'
Ожидаемый результат. Проверки assert проходят без исключения.
Скачать пример · Ссылка на функцию
Этот пример выполнен в установленном FEMM 5.
base64.urlsafe_b64encodeКодирует данные для имени или URL-параметра; символ = сохраняется.
base64.urlsafe_b64encode
urlsafe_b64encode(s)Кодирует данные для имени или URL-параметра; символ = сохраняется.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
s | Байтовые данные. |
Возвращаемое значение
bytes с - и _ вместо + и /.
Пример
"Пример base64.urlsafe_b64encode.\nСреда: встроенный MicroPython FEMM 5.\nКодирует данные для имени или URL-параметра; символ = сохраняется.\nРезультат: bytes с - и _ вместо + и /."
import base64
assert base64.urlsafe_b64encode(bytes([255])) == b'_w=='
Ожидаемый результат. Проверки assert проходят без исключения.
Скачать пример · Ссылка на функцию
Этот пример выполнен в установленном FEMM 5.
base64.urlsafe_b64decodeИмя установлено, но декодер URL-варианта не реализован. Рабочий путь — base64.b64decode(s, altchars=b"-_").
base64.urlsafe_b64decode
urlsafe_b64decode(s)Имя установлено, но декодер URL-варианта не реализован. Рабочий путь — base64.b64decode(s, altchars=b"-_").
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
s | Данные алфавита Base64 с - и _. |
Возвращаемое значение
NotImplementedError при вызове в проверенной сборке.
Пример
"Пример base64.urlsafe_b64decode.\nСреда: встроенный MicroPython FEMM 5.\nИмя установлено, но декодер URL-варианта не реализован. Рабочий путь — base64.b64decode(s, altchars=b\"-_\").\nРезультат: NotImplementedError при вызове в проверенной сборке."
import base64
try:
base64.urlsafe_b64decode(b'_w==')
except NotImplementedError:
pass
else:
raise AssertionError("expected NotImplementedError")
Ожидаемый результат. Получено и перехвачено ожидаемое исключение NotImplementedError.
Скачать пример · Ссылка на функцию
Нативная проверка описанного ограничения выполнена; ожидаемая ошибка или особенность подтверждена.
base64.b32encodeКодирует буквенно-цифровым алфавитом Base32.
base64.b32encode
b32encode(s)Кодирует буквенно-цифровым алфавитом Base32.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
s | Байтовые данные. |
Возвращаемое значение
bytes Base32.
Пример
"Пример base64.b32encode.\nСреда: встроенный MicroPython FEMM 5.\nКодирует буквенно-цифровым алфавитом Base32.\nРезультат: bytes Base32."
import base64
assert base64.b32encode(b'A') == b'IE======'
Ожидаемый результат. Проверки assert проходят без исключения.
Скачать пример · Ссылка на функцию
Этот пример выполнен в установленном FEMM 5.
base64.b32decodeДекодирует Base32 с явно заданными послаблениями алфавита.
base64.b32decode
b32decode(s, casefold=False, map01=None)Декодирует Base32 с явно заданными послаблениями алфавита.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
s | Данные Base32. |
casefold | Разрешать строчные буквы. |
map01 | None запрещает 0/1; I или L задаёт замену 1, при этом 0 заменяется на O. |
Возвращаемое значение
Исходные bytes.
Пример
"Пример base64.b32decode.\nСреда: встроенный MicroPython FEMM 5.\nДекодирует Base32 с явно заданными послаблениями алфавита.\nРезультат: Исходные bytes."
import base64
assert base64.b32decode(b'IE======') == b'A'
Ожидаемый результат. Проверки assert проходят без исключения.
Скачать пример · Ссылка на функцию
Этот пример выполнен в установленном FEMM 5.
base64.b16encodeПредставляет каждый байт двумя цифрами.
base64.b16encode
b16encode(s)Представляет каждый байт двумя цифрами.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
s | Байтовые данные. |
Возвращаемое значение
bytes с прописными шестнадцатеричными цифрами.
Пример
"Пример base64.b16encode.\nСреда: встроенный MicroPython FEMM 5.\nПредставляет каждый байт двумя цифрами.\nРезультат: bytes с прописными шестнадцатеричными цифрами."
import base64
assert base64.b16encode(b'AB') == b'4142'
Ожидаемый результат. Проверки assert проходят без исключения.
Скачать пример · Ссылка на функцию
Этот пример выполнен в установленном FEMM 5.
base64.b16decodeПроверка байтового шаблона внутри re завершается TypeError. Для hex-данных используйте binascii.unhexlify.
base64.b16decode
b16decode(s, casefold=False)Проверка байтового шаблона внутри re завершается TypeError. Для hex-данных используйте binascii.unhexlify.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
s | Байтовое или строковое шестнадцатеричное представление. |
casefold | Разрешать строчные a–f. |
Возвращаемое значение
TypeError при вызове в проверенной сборке.
Пример
"Пример base64.b16decode.\nСреда: встроенный MicroPython FEMM 5.\nПроверка байтового шаблона внутри re завершается TypeError. Для hex-данных используйте binascii.unhexlify.\nРезультат: TypeError при вызове в проверенной сборке."
import base64
try:
base64.b16decode(b'4142')
except TypeError:
pass
else:
raise AssertionError("expected TypeError")
Ожидаемый результат. Получено и перехвачено ожидаемое исключение TypeError.
Скачать пример · Ссылка на функцию
Нативная проверка описанного ограничения выполнена; ожидаемая ошибка или особенность подтверждена.
base64.encodebytesКодирует многострочное текстовое представление.
base64.encodebytes
encodebytes(s)Кодирует многострочное текстовое представление.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
s | Байтовые данные. |
Возвращаемое значение
bytes Base64 с переносами строк.
Пример
"Пример base64.encodebytes.\nСреда: встроенный MicroPython FEMM 5.\nКодирует многострочное текстовое представление.\nРезультат: bytes Base64 с переносами строк."
import base64
assert base64.decodebytes(base64.encodebytes(b'FEMM')) == b'FEMM'
Ожидаемый результат. Проверки assert проходят без исключения.
Скачать пример · Ссылка на функцию
Этот пример выполнен в установленном FEMM 5.
base64.decodebytesУбирает форматирование многострочного Base64.
base64.decodebytes
decodebytes(s)Убирает форматирование многострочного Base64.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
s | Байтовое многострочное представление Base64. |
Возвращаемое значение
Исходные bytes.
Пример
"Пример base64.decodebytes.\nСреда: встроенный MicroPython FEMM 5.\nУбирает форматирование многострочного Base64.\nРезультат: Исходные bytes."
import base64
assert base64.decodebytes(b'QQ==') == b'A'
Ожидаемый результат. Проверки assert проходят без исключения.
Скачать пример · Ссылка на функцию
Этот пример выполнен в установленном FEMM 5.
base64.encodeПотоковое кодирование Base64.
base64.encode
encode(input, output)Потоковое кодирование Base64.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
input | Открытый двоичный поток с read/readline. |
output | Двоичный поток с write. |
Возвращаемое значение
None.
Пример
"Пример base64.encode.\nСреда: встроенный MicroPython FEMM 5.\nПотоковое кодирование Base64.\nРезультат: None."
import base64
import io
src = io.BytesIO(b'FEMM')
dst = io.BytesIO()
base64.encode(src,dst)
assert base64.b64decode(dst.getvalue()) == b'FEMM'
Ожидаемый результат. Проверки assert проходят без исключения.
Скачать пример · Ссылка на функцию
Этот пример выполнен в установленном FEMM 5.
base64.decodeПотоковое восстановление двоичных данных.
base64.decode
decode(input, output)Потоковое восстановление двоичных данных.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
input | Двоичный поток Base64. |
output | Двоичный поток назначения. |
Возвращаемое значение
None.
Пример
"Пример base64.decode.\nСреда: встроенный MicroPython FEMM 5.\nПотоковое восстановление двоичных данных.\nРезультат: None."
import base64
import io
src = io.BytesIO(b'RkVNTQ==')
dst = io.BytesIO()
base64.decode(src,dst)
assert dst.getvalue() == b'FEMM'
Ожидаемый результат. Проверки assert проходят без исключения.
Скачать пример · Ссылка на функцию
Этот пример выполнен в установленном FEMM 5.
base64.encodestringУстаревшее имя пытается импортировать отсутствующий warnings. Используйте encodebytes.
base64.encodestring
encodestring(s)Устаревшее имя пытается импортировать отсутствующий warnings. Используйте encodebytes.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
s | Байтовые данные соответствующего формата. |
Возвращаемое значение
ImportError при вызове в проверенной сборке.
Пример
"Пример base64.encodestring.\nСреда: встроенный MicroPython FEMM 5.\nУстаревшее имя пытается импортировать отсутствующий warnings. Используйте encodebytes.\nРезультат: ImportError при вызове в проверенной сборке."
import base64
try:
base64.encodestring(b'QQ==')
except ImportError:
pass
else:
raise AssertionError("expected ImportError")
Ожидаемый результат. Получено и перехвачено ожидаемое исключение ImportError.
Скачать пример · Ссылка на функцию
Нативная проверка описанного ограничения выполнена; ожидаемая ошибка или особенность подтверждена.
base64.decodestringУстаревшее имя пытается импортировать отсутствующий warnings. Используйте decodebytes.
base64.decodestring
decodestring(s)Устаревшее имя пытается импортировать отсутствующий warnings. Используйте decodebytes.
Аргументы
| Имя | Назначение и допустимые значения |
|---|---|
s | Байтовые данные соответствующего формата. |
Возвращаемое значение
ImportError при вызове в проверенной сборке.
Пример
"Пример base64.decodestring.\nСреда: встроенный MicroPython FEMM 5.\nУстаревшее имя пытается импортировать отсутствующий warnings. Используйте decodebytes.\nРезультат: ImportError при вызове в проверенной сборке."
import base64
try:
base64.decodestring(b'QQ==')
except ImportError:
pass
else:
raise AssertionError("expected ImportError")
Ожидаемый результат. Получено и перехвачено ожидаемое исключение ImportError.
Скачать пример · Ссылка на функцию
Нативная проверка описанного ограничения выполнена; ожидаемая ошибка или особенность подтверждена.
Имена в установленной сборке
Перечень получен во встроенном интерпретаторе. Он включает функции, классы и константы. Ссылки ведут к контрактам; для прямого доступа ulab учитывайте условия этого раздела.
MAXBINSIZEMAXLINESIZEb16decodeb16encodeb32decodeb32encodeb64decodeb64encodebinasciibytes_typesdecodedecodebytesdecodestringencodeencodebytesencodestringmainrestandard_b64decodestandard_b64encodestructtesturlsafe_b64decodeurlsafe_b64encode