struct — pakkaa ja pura primitiivisiä tietotyyppejä

Tämä moduuli suorittaa muunnoksia Python-arvojen ja Python-bytes-objekteina esitettyjen C-tyylisten structien välillä käyttäen muotoilumerkkijonoja tietojen asettelun kuvaamiseen.

Seuraavat tavujärjestykset ovat tuettuja:

Merkki	Tavujärjestys	Koko	Kohdistus
@	natiivi	natiivi	natiivi
<	little-endian	vakio	ei mitään
>	big-endian	vakio	ei mitään
!	verkko (= big-endian)	vakio	ei mitään

Seuraavat tietotyypit ovat tuettuja:

Muoto	C-tyyppi	Python-tyyppi	Vakiokoko
b	signed char	kokonaisluku	1
B	unsigned char	kokonaisluku	1
h	short	kokonaisluku	2
H	unsigned short	kokonaisluku	2
i	int	kokonaisluku (1)	4
I	unsigned int	kokonaisluku (1)	4
l	long	kokonaisluku (1)	4
L	unsigned long	kokonaisluku (1)	4
q	long long	kokonaisluku (1)	8
Q	unsigned long long	kokonaisluku (1)	8
e	n/a (half-float)	float (2)	2
f	float	float (2)	4
d	double	float (2)	8
s	char[]	bytes
P	void *	kokonaisluku

1. Vaatii long-tuen, kun käytetään yli 30-bittisten arvojen kanssa.

2. Vaatii liukulukutuen.

Ero CPythoniin

Välilyöntejä ei tueta muotoilumerkkijonoissa.

Esimerkit

Pakkaa ja pura little-endian-arvoja. <-etuliite valitsee little-endian-tavujärjestyksen vakiokoilla ja ilman kohdistusta:

import struct

# Pack an unsigned short (H, 2 bytes) then an unsigned int (I, 4 bytes).
data = struct.pack("<HI", 7, 1000)
# data == b'\x07\x00\xe8\x03\x00\x00'

# Unpack returns a tuple of the values, in order.
struct.unpack("<HI", data)
# (7, 1000)

# calcsize() reports how many bytes the format needs.
struct.calcsize("<HI")
# 6

Pakkaa olemassa olevaan puskuriin ja pura siitä tavusiirtymästä:

buf = bytearray(8)

# Write a little-endian signed int (i) at offset 2.
struct.pack_into("<i", buf, 2, -12345)
# buf == bytearray(b'\x00\x00\xc7\xcf\xff\xff\x00\x00')

# Read it back from the same offset.
struct.unpack_from("<i", buf, 2)
# (-12345,)

Funktiot

struct.calcsize(fmt: str) → int

Palauttaa tavujen lukumäärän, joka tarvitaan annetun fmt:n tallentamiseen.

struct.pack(fmt: str, *values: Any) → bytes

Pakkaa values muotoilumerkkijonon fmt mukaisesti. Paluuarvo on bytes-objekti, joka koodaa arvot.

struct.pack_into(fmt: str, buffer: Any, offset: int, *values: Any) → None

Pakkaa values muotoilumerkkijonon fmt mukaisesti buffer-puskuriin alkaen kohdasta offset. offset voi olla negatiivinen laskeakseen buffer-puskurin lopusta.

struct.unpack(fmt: str, data: bytes) → Tuple

Pura data-tiedoista muotoilumerkkijonon fmt mukaisesti. Paluuarvo on monikko purettuja arvoja.

struct.unpack_from(fmt: str, data: bytes, offset: int = 0, /) → Tuple

Pura data-tiedoista alkaen kohdasta offset muotoilumerkkijonon fmt mukaisesti. offset voi olla negatiivinen laskeakseen data:n lopusta. Paluuarvo on monikko purettuja arvoja.