Struct Header

pub struct Header { /* private fields */ }

Representation of an archive entry header.

Implementations

impl Header

pub fn new(identifier: Vec<u8>, size: u64) -> Header

Creates a header with the given file identifier and size, and all other fields set to zero.

pub fn from_metadata(identifier: Vec<u8>, meta: &Metadata) -> Header

Creates a header with the given file identifier and all other fields set from the given filesystem metadata.

pub fn identifier(&self) -> &[u8]

Returns the file identifier.

Examples found in repository

examples/extract.rs (line 39)

fn main() {
    let num_args = env::args().count();
    if num_args != 2 {
        println!("Usage: extract <path/to/archive.a>");
        return;
    }

    let input_path = env::args().nth(1).unwrap();
    let input_path = Path::new(&input_path);
    let input_file =
        File::open(input_path).expect("failed to open input file");
    let mut archive = ar::Archive::new(input_file);

    while let Some(entry) = archive.next_entry() {
        let mut entry = entry.expect("failed to parse archive entry");
        let output_path = Path::new(
            str::from_utf8(entry.header().identifier())
                .expect("Non UTF-8 filename"),
        )
        .to_path_buf();
        let mut output_file = File::create(&output_path)
            .expect(&format!("unable to create file {:?}", output_path));
        io::copy(&mut entry, &mut output_file)
            .expect(&format!("failed to extract file {:?}", output_path));
    }
}

pub fn set_identifier(&mut self, identifier: Vec<u8>)

Sets the file identifier.

pub fn mtime(&self) -> u64

Returns the last modification time in Unix time format.

pub fn set_mtime(&mut self, mtime: u64)

Sets the last modification time in Unix time format.

pub fn uid(&self) -> u32

Returns the value of the owner’s user ID field.

pub fn set_uid(&mut self, uid: u32)

Sets the value of the owner’s user ID field.

pub fn gid(&self) -> u32

Returns the value of the group’s user ID field.

pub fn set_gid(&mut self, gid: u32)

Returns the value of the group’s user ID field.

pub fn mode(&self) -> u32

Returns the mode bits for this file.

pub fn set_mode(&mut self, mode: u32)

Sets the mode bits for this file.

pub fn size(&self) -> u64

Returns the length of the file, in bytes.

pub fn set_size(&mut self, size: u64)

Sets the length of the file, in bytes.

Trait Implementations

impl Clone for Header

fn clone(&self) -> Header

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Header

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

Formats the value using the given formatter.

impl PartialEq for Header

fn eq(&self, other: &Header) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Header

impl StructuralPartialEq for Header