MicroPython:Библиотеки/ustruct

Содержание

Введение

Основы

Примеры

Библиотеки

Программы

Платы

Прошивки

Резерв

Резерв

Перевод: Максим Кузьмин

Проверка/Оформление/Редактирование: Мякишев Е.А.

Модуль ustruct – упаковка и распаковка примитивных типов данных

В этом модуле реализована часть функционала соответствующего модуля CPython. Более подробно читайте в документации к CPython о модуле struct.

Поддерживаемые префиксы для обозначения размера и порядка байтов: @, <, >, !.

Поддерживаемые коды форматов: b, B, h, H, i, I, l, L, q, Q, s, P, f, d (поддержка последних двух зависит от поддержки чисел с плавающей точкой).

Функции

• ustruct.calcsize(fmt) – возвращает количество байтов, необходимых для хранения структуры данных fmt.
• ustruct.pack(fmt, v1, v2, ...) – упаковывает значения v1, v2 и т.д. согласно строке формата fmt. Возвращаемое значение – это объект bytes с упакованными в него значениями.
• ustruct.pack_into(fmt, buffer, offset, v1, v2, ...) – упаковывает значения v1, v2 и т.д. согласно строке формата fmt в буфер buffer, начиная с позиции offset. Значение в offset может быть отрицательным, чтобы начать с конца буфера.
• ustruct.unpack(fmt, data) – распаковывает данные из data согласно строке формата fmt. Возвращаемое значение – это кортеж распакованных значений.
• ustruct.unpack_from(fmt, data, offset=0, /) – распаковывает данные из data, начиная с offset согласно строке формата fmt. Значение в offset может быть отрицательным, чтобы начать с конца буфера. Возвращаемое значение – это кортеж распакованных значений.

<syntaxhighlight lang="python" enclose="div">