94 lines
4.1 KiB
Python
94 lines
4.1 KiB
Python
"""
|
|
Pack and unpack primitive data types.
|
|
|
|
MicroPython module: https://docs.micropython.org/en/v1.21.0/library/struct.html
|
|
|
|
CPython module: :mod:`python:struct` https://docs.python.org/3/library/struct.html .
|
|
|
|
The following byte orders are supported:
|
|
|
|
+-----------+------------------------+----------+-----------+
|
|
| Character | Byte order | Size | Alignment |
|
|
+===========+========================+==========+===========+
|
|
| @ | native | native | native |
|
|
+-----------+------------------------+----------+-----------+
|
|
| < | little-endian | standard | none |
|
|
+-----------+------------------------+----------+-----------+
|
|
| > | big-endian | standard | none |
|
|
+-----------+------------------------+----------+-----------+
|
|
| ! | network (= big-endian) | standard | none |
|
|
+-----------+------------------------+----------+-----------+
|
|
|
|
The following data types are supported:
|
|
|
|
+--------+--------------------+-------------------+---------------+
|
|
| Format | C Type | Python type | Standard size |
|
|
+========+====================+===================+===============+
|
|
| b | signed char | integer | 1 |
|
|
+--------+--------------------+-------------------+---------------+
|
|
| B | unsigned char | integer | 1 |
|
|
+--------+--------------------+-------------------+---------------+
|
|
| h | short | integer | 2 |
|
|
+--------+--------------------+-------------------+---------------+
|
|
| H | unsigned short | integer | 2 |
|
|
+--------+--------------------+-------------------+---------------+
|
|
| i | int | integer (`1<fn>`) | 4 |
|
|
+--------+--------------------+-------------------+---------------+
|
|
| I | unsigned int | integer (`1<fn>`) | 4 |
|
|
+--------+--------------------+-------------------+---------------+
|
|
| l | long | integer (`1<fn>`) | 4 |
|
|
+--------+--------------------+-------------------+---------------+
|
|
| L | unsigned long | integer (`1<fn>`) | 4 |
|
|
+--------+--------------------+-------------------+---------------+
|
|
| q | long long | integer (`1<fn>`) | 8 |
|
|
+--------+--------------------+-------------------+---------------+
|
|
| Q | unsigned long long | integer (`1<fn>`) | 8 |
|
|
+--------+--------------------+-------------------+---------------+
|
|
| f | float | float (`2<fn>`) | 4 |
|
|
+--------+--------------------+-------------------+---------------+
|
|
| d | double | float (`2<fn>`) | 8 |
|
|
+--------+--------------------+-------------------+---------------+
|
|
| s | char[] | bytes | |
|
|
+--------+--------------------+-------------------+---------------+
|
|
| P | void * | integer | |
|
|
+--------+--------------------+-------------------+---------------+
|
|
"""
|
|
from _typeshed import Incomplete, Incomplete as Incomplete
|
|
from typing import Tuple
|
|
|
|
def pack_into(fmt, buffer, offset, v1, *args, **kwargs) -> Incomplete:
|
|
"""
|
|
Pack the values *v1*, *v2*, ... according to the format string *fmt*
|
|
into a *buffer* starting at *offset*. *offset* may be negative to count
|
|
from the end of *buffer*.
|
|
"""
|
|
...
|
|
|
|
def unpack(fmt, data) -> Tuple:
|
|
"""
|
|
Unpack from the *data* according to the format string *fmt*.
|
|
The return value is a tuple of the unpacked values.
|
|
"""
|
|
...
|
|
|
|
def unpack_from(fmt, data, offset=0, /) -> Tuple:
|
|
"""
|
|
Unpack from the *data* starting at *offset* according to the format string
|
|
*fmt*. *offset* may be negative to count from the end of *data*. The return
|
|
value is a tuple of the unpacked values.
|
|
"""
|
|
...
|
|
|
|
def pack(fmt, v1, *args, **kwargs) -> bytes:
|
|
"""
|
|
Pack the values *v1*, *v2*, ... according to the format string *fmt*.
|
|
The return value is a bytes object encoding the values.
|
|
"""
|
|
...
|
|
|
|
def calcsize(fmt) -> int:
|
|
"""
|
|
Return the number of bytes needed to store the given *fmt*.
|
|
"""
|
|
...
|