2016-04-22 20:35:31 +01:00
|
|
|
:mod:`ustruct` -- pack and unpack primitive data types
|
|
|
|
======================================================
|
2014-11-02 23:37:02 +00:00
|
|
|
|
2016-04-22 20:35:31 +01:00
|
|
|
.. module:: ustruct
|
2014-11-02 23:37:02 +00:00
|
|
|
:synopsis: pack and unpack primitive data types
|
|
|
|
|
|
|
|
See `Python struct <https://docs.python.org/3/library/struct.html>`_ for more
|
|
|
|
information.
|
|
|
|
|
|
|
|
Functions
|
|
|
|
---------
|
|
|
|
|
|
|
|
.. function:: calcsize(fmt)
|
|
|
|
|
2016-05-01 11:34:16 +01:00
|
|
|
Return the number of bytes needed to store the given `fmt`.
|
2014-11-02 23:37:02 +00:00
|
|
|
|
|
|
|
.. function:: pack(fmt, v1, v2, ...)
|
|
|
|
|
2016-05-01 11:34:16 +01:00
|
|
|
Pack the values `v1`, `v2`, ... according to the format string `fmt`.
|
2014-11-02 23:37:02 +00:00
|
|
|
The return value is a bytes object encoding the values.
|
|
|
|
|
2016-05-01 11:17:07 +01:00
|
|
|
.. function:: pack_into(fmt, buffer, offset, v1, v2, ...)
|
|
|
|
|
|
|
|
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`.
|
|
|
|
|
2014-11-02 23:37:02 +00:00
|
|
|
.. function:: unpack(fmt, data)
|
|
|
|
|
2016-05-01 11:34:16 +01:00
|
|
|
Unpack from the `data` according to the format string `fmt`.
|
2014-11-02 23:37:02 +00:00
|
|
|
The return value is a tuple of the unpacked values.
|
2016-05-01 11:17:07 +01:00
|
|
|
|
|
|
|
.. function:: unpack_from(fmt, data, offset=0)
|
|
|
|
|
|
|
|
Unpack from the `data` starting at `offset` according to the format string
|
|
|
|
`fmt`. `offset` may be negative to count from the end of `buffer`. The return
|
|
|
|
value is a tuple of the unpacked values.
|