struct — 기본 데이터 유형 패킹 및 언패킹

이 모듈은 데이터의 레이아웃을 설명하는 형식 문자열을 사용하여 Python 값과 Python bytes 객체로 표현된 C 스타일 구조체 간의 변환을 수행합니다.

다음 바이트 순서가 지원됩니다:

문자	바이트 순서	크기	정렬
@	네이티브	네이티브	네이티브
<	리틀 엔디안	표준	없음
>	빅 엔디안	표준	없음
!	네트워크 (= 빅 엔디안)	표준	없음

다음 데이터 유형이 지원됩니다:

형식	C 유형	Python 유형	표준 크기
b	signed char	정수	1
B	unsigned char	정수	1
h	short	정수	2
H	unsigned short	정수	2
i	int	정수 (1)	4
I	unsigned int	정수 (1)	4
l	long	정수 (1)	4
L	unsigned long	정수 (1)	4
q	long long	정수 (1)	8
Q	unsigned long long	정수 (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 *	정수

1. 30비트보다 큰 값과 함께 사용할 때는 long 지원이 필요합니다.

2. 부동소수점 지원이 필요합니다.

CPython과의 차이점

형식 문자열에서 공백은 지원되지 않습니다.

예제

리틀 엔디안 값을 패킹 및 언패킹합니다. < 접두사는 표준 크기와 정렬 없음으로 리틀 엔디안 바이트 순서를 선택합니다:

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

기존 버퍼의 바이트 오프셋 위치로 패킹하고 그로부터 언패킹합니다:

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

함수

struct.calcsize(fmt: str) → int

주어진 fmt를 저장하는 데 필요한 바이트 수를 반환합니다.

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

형식 문자열 fmt에 따라 values를 패킹합니다. 반환 값은 값들을 인코딩한 bytes 객체입니다.

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

형식 문자열 fmt에 따라 values를 offset에서 시작하는 buffer로 패킹합니다. offset은 buffer의 끝에서부터 세기 위해 음수일 수 있습니다.

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

형식 문자열 fmt에 따라 data로부터 언패킹합니다. 반환 값은 언패킹된 값들의 튜플입니다.

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

형식 문자열 fmt에 따라 offset에서 시작하는 data로부터 언패킹합니다. offset은 data의 끝에서부터 세기 위해 음수일 수 있습니다. 반환 값은 언패킹된 값들의 튜플입니다.