summaryrefslogtreecommitdiffstatshomepage
path: root/docs/library/ustruct.rst
blob: 74e42af07a00c4c19c576f2855141ce0d6b0f52e (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
:mod:`ustruct` -- pack and unpack primitive data types
======================================================

.. module:: ustruct
   :synopsis: pack and unpack primitive data types

See `Python struct <https://docs.python.org/3/library/struct.html>`_ for more
information.

Supported size/byte order prefixes: ``@``, ``<``, ``>``, ``!``.

Supported format codes: ``b``, ``B``, ``h``, ``H``, ``i``, ``I``, ``l``,
``L``, ``q``, ``Q``, ``s``, ``P``, ``f``, ``d`` (the latter 2 depending
on the floating-point support).

Functions
---------

.. function:: calcsize(fmt)

   Return the number of bytes needed to store the given `fmt`.

.. function:: pack(fmt, v1, v2, ...)

   Pack the values `v1`, `v2`, ... according to the format string `fmt`.
   The return value is a bytes object encoding the values.

.. 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`.

.. function:: unpack(fmt, data)

   Unpack from the `data` according to the format string `fmt`.
   The return value is a tuple of the unpacked values.

.. 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.