struct — ilkel veri türlerini paketle ve paketten çıkar

Bu modül, verinin düzenini açıklamak için biçim dizgeleri kullanarak Python değerleri ile Python bytes nesneleri olarak temsil edilen C tarzı struct’lar arasında dönüşümler gerçekleştirir.

Aşağıdaki bayt sıralamaları desteklenir:

Karakter	Bayt sırası	Boyut	Hizalama
@	yerel (native)	yerel (native)	yerel (native)
<	küçük-endian (little-endian)	standart	yok
>	büyük-endian (big-endian)	standart	yok
!	ağ (= büyük-endian)	standart	yok

Aşağıdaki veri türleri desteklenir:

Biçim	C Türü	Python türü	Standart boyut
b	signed char	tamsayı	1
B	unsigned char	tamsayı	1
h	short	tamsayı	2
H	unsigned short	tamsayı	2
i	int	tamsayı (1)	4
I	unsigned int	tamsayı (1)	4
l	long	tamsayı (1)	4
L	unsigned long	tamsayı (1)	4
q	long long	tamsayı (1)	8
Q	unsigned long long	tamsayı (1)	8
e	yok (yarı-float)	float (2)	2
f	float	float (2)	4
d	double	float (2)	8
s	char[]	bytes
P	void *	tamsayı

1. 30 bitten büyük değerlerle kullanıldığında long desteği gerektirir.

2. Kayan nokta desteği gerektirir.

CPython’dan Farkı

Biçim dizgelerinde boşluk desteklenmez.

Örnekler

Küçük-endian değerleri paketle ve paketten çıkar. < öneki, standart boyutlar ve hizalama olmaksızın küçük-endian bayt sırasını seçer:

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

Mevcut bir arabelleğe bir bayt ofsetinde paketle ve paketten çıkar:

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,)

İşlevler

struct.calcsize(fmt: str) → int

Verilen fmt öğesini saklamak için gereken bayt sayısını döndürür.

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

values değerlerini fmt biçim dizgesine göre paketler. Dönüş değeri, değerleri kodlayan bir bytes nesnesidir.

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

values değerlerini fmt biçim dizgesine göre bir buffer içine offset konumundan başlayarak paketler. offset, buffer öğesinin sonundan saymak için negatif olabilir.

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

data öğesinden fmt biçim dizgesine göre paketten çıkarır. Dönüş değeri, paketten çıkarılan değerlerin bir demetidir.

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

data öğesinden offset konumundan başlayarak fmt biçim dizgesine göre paketten çıkarır. offset, data öğesinin sonundan saymak için negatif olabilir. Dönüş değeri, paketten çıkarılan değerlerin bir demetidir.