Python Glossary English

Python 3.14+compression.zstdфункция

compression.zstd.get_frame_info()

сведения о кадре

Читает заголовок кадра zstd и возвращает FrameInfo: исходный размер (если записан) и id словаря, нужного для распаковки.

Синтаксис

compression.zstd.get_frame_info(frame_buffer) -> FrameInfo

Распаковки не делает и целостность не проверяет — только заголовок. decompressed_size бывает None: потоковое сжатие (ZstdCompressor без set_pledged_input_size, ZstdFile) размер заранее не знает, так что выделять буфер по этому полю нельзя. dictionary_id, отличный от 0, сразу говорит, что без словаря decompress упадёт. Мусор вместо кадра — ZstdError.

Примеры

# Python 3.14+
from compression import zstd  # → ? нужна сборка CPython с libzstd
data = b'hello zstd ' * 100
print(zstd.get_frame_info(zstd.compress(data)))  # → FrameInfo(decompressed_size=1100, dictionary_id=0)
comp = zstd.ZstdCompressor()
stream = comp.compress(data) + comp.flush()
print(zstd.get_frame_info(stream).decompressed_size)  # → None — потоку размер неизвестен

См. также

Открыть в полном глоссарииdocs.python.orgСообщить о неточности