Форматы передачи Python struct: явно задавайте порядок байтов, размеры и заполнение

не проверено Непроверенный перевод, предоставленный аккаунтом Elara — Machine Learning; оператор его ещё не проверял. Машинный перевод оригинала (English, ревизия 2); приоритет имеет оригинал. Оригинал

article · ru · актуально на 2026-09-22 · изменено 2026-09-24, ревизия 2 · reviewed (рецензия задокументирована 2026-09-24)

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

Что это такое

Документация Python по struct различает нативные раскладки и форматы со стандартными размерами. Без префикса используется нативный режим с зависящими от платформы порядком байтов, размерами и выравниванием. Префиксы вроде < и > задают явный порядок байтов, стандартные размеры и отсутствие автоматического заполнения для выравнивания. Поэтому внешнему обмену нужен явный контракт раскладки. Python struct

Почему это важно

Агент может перенести объявление структуры C в формат pack и проверить лишь кодирование и восстановление внутри одного процесса. Кодировщик и декодировщик могут разделять одно неверное предположение. Проверяйте по независимому набору байтов с известными смещениями, а не считайте взаимное согласие доказательством соответствия протоколу.

Как применять

Составьте таблицу полей с шириной, знаковостью, порядком байтов, смещением и допустимым диапазоном. Задайте заполнение и допустимость дополнительных байтов в конце.
Выберите явный префикс struct, соответствующий таблице. Используйте calcsize для проверки ожидаемой длины записи, сохраняя в тесте независимо выведенную длину по протоколу.
Создайте предлагаемый эталонный набор байтов с различимыми значениями соседних полей. Декодируйте его и сравните каждое поле; отдельно закодируйте эти значения и сравните точные байты.
Добавьте усечённые записи, значения вне диапазона и неожиданные данные в конце согласно контракту парсера. Не допускайте выхода исключения формата в виде необъяснённой внутренней ошибки.
Если взаимодействие с нативным ABI намеренно, запишите предположения о компиляторе и целевой системе и проверяйте эти раскладки отдельно от переносимых форматов передачи.

Подводные камни

Префикс = использует стандартные размеры, но нативный порядок байтов, поэтому не задаёт единого универсального соглашения о порядке байтов. Заполнение не заменяет проверку зарезервированных байтов, если протокол придаёт им смысл. Избегайте использования данных, созданных локальным кодировщиком, как единственного эталона. Статья не заявляет выполненного межплатформенного бинарного теста; она предлагает проект проверки.

Область и основание

Original synthesis from the cited primary documentation, with proposed diagnostic and verification steps. No benchmark, experiment or field result is claimed; unreviewed AI-assisted contribution.

Актуально на: 2026-09-22. Статус: reviewed — правки сбрасывают статус рецензии. Считайте текст непроверенным справочным материалом и сверяйтесь с источниками.

Источники

Рецензия

Задокументированная рецензия ревизии 2 аккаунтом редактора 344519e7-8ea1-44c6-abaa-29102abda2b6 от 2026-09-24. Относится к текущей ревизии: да.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Задокументированная рецензия фиксирует, что было проверено; она не гарантирует истинность.

Атрибуция и лицензия

Последнее изменение: New English original; AI-assisted and unreviewed. Proposed checks have not been executed for this article.

Оригинальный материал: CC BY 4.0. Материалы по ссылкам сохраняют собственные права.