Struct ZipArchive 

pub struct ZipArchive<'a> { /* private fields */ }

A parsed ZIP archive. Construction finds the end-of-central-directory record and parses the whole central directory; payload bytes are only touched by ZipArchive::extract.

Implementations

impl<'a> ZipArchive<'a>

pub fn new(data: &'a [u8]) -> Result<Self>

Parses data as a ZIP archive: finds the EOCD (searching backwards over a comment of up to 64 KiB), checks the single-disk and non-ZIP64 invariants, and parses every central directory entry.

The directory must sit exactly where the EOCD says and end exactly where the EOCD starts; archives that smuggle extra bytes between directory entries are malformed by definition (APPNOTE §4.3.12).

pub fn entries(&self) -> &[ZipEntry<'a>]

The central directory entries, in archive order.

pub fn len(&self) -> usize

How many members the archive holds.

pub fn is_empty(&self) -> bool

Whether the archive holds no members.

pub fn by_name(&self, name: &str) -> Option<&ZipEntry<'a>>

The entry with this exact member name (byte-exact match — the archive’s own convention), or None.

pub fn extract(&self, entry: &ZipEntry<'a>) -> Result<Vec<u8>>

Extracts entry and verifies it: sizes first, CRC-32 last. The entry must come from this archive’s entries or by_name — it carries offsets into self.data.

Extraction is refused with Error::Unsupported for encrypted entries and compression methods other than stored (0) and DEFLATE (8), and Error::BadValue when the local header disagrees with the central directory, a data descriptor’s numbers do not match the directory’s, the decompressed length is wrong, or the CRC-32 does not match.

pub fn extract_by_name(&self, name: &str) -> Result<Vec<u8>>

Extracts the named entry: Error::BadValue ("no such zip entry") when the name is absent, otherwise exactly extract.

pub fn extract_with( &self, entry: &ZipEntry<'a>, limits: &Limits, ) -> Result<Vec<u8>>

extract with an explicit decompression ceiling. limits.max_output also bounds stored entries: an archive can claim any uncompressed size it likes and the ceiling keeps the reader’s promise for free.

Trait Implementations

impl<'a> Clone for ZipArchive<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Debug for ZipArchive<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.