Struct TarArchiveRef 

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

Wrapper type around bytes, which represents a Tar archive. To iterate the entries, use TarArchiveRef::entries.

Implementations

impl<'a> TarArchiveRef<'a>

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

Creates a borrowed wrapper around validated Tar archive bytes.

The supplied data must have a valid block layout, contain at least the minimum number of blocks, and end with two zero blocks. Each archive header must have a valid checksum and type flag, and every payload size must lead to a header or the terminating zero blocks within the archive.

Validation checks the archive structure required for safe iteration. It does not guarantee that every supported entry can be consumed without further format-specific limitations; see ArchiveEntryIterator.

Errors

Returns CorruptDataError if validation fails.

pub fn entries(&self) -> ArchiveEntryIterator<'a>

Iterates over the regular files in the Tar archive.

See ArchiveEntryIterator for format support and limitations.

pub fn headers(&self) -> ArchiveHeaderIterator<'a>

Iterates over the headers in the Tar archive.

PAX extended headers are returned as normal PosixHeader values, while their payload blocks are skipped before the next iteration.

Trait Implementations

impl<'a> Clone for TarArchiveRef<'a>

fn clone(&self) -> TarArchiveRef<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for TarArchiveRef<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for TarArchiveRef<'a>

impl<'a> PartialEq for TarArchiveRef<'a>

fn eq(&self, other: &TarArchiveRef<'a>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<'a> StructuralPartialEq for TarArchiveRef<'a>