Struct symbolic_debuginfo::Archive

pub struct Archive<'d>(_);

A generic archive that can contain one or more object files.

Effectively, this will only contain a single object for all file types other than MachO. Mach objects can either be single object files or so-called fat files that contain multiple objects per architecture.

Methods

impl<'d> Archive<'d>

pub fn test(data: &[u8]) -> bool

Tests whether this buffer contains a valid object archive.

pub fn peek(data: &[u8]) -> FileFormat

Tries to infer the object archive type from the start of the given buffer.

pub fn parse(data: &'d [u8]) -> Result<Self, ObjectError>

Tries to parse a generic archive from the given slice.

pub fn file_format(&self) -> FileFormat

The container format of this file.

Important traits for ObjectIterator<'d, 'a>

impl<'d, 'a> Iterator for ObjectIterator<'d, 'a> type Item = Result<Object<'d>, ObjectError>;

pub fn objects(&self) -> ObjectIterator<'d, '_>

Returns an iterator over all objects contained in this archive.

pub fn object_count(&self) -> usize

Returns the number of objects in this archive.

pub fn object_by_index(
    &self,
    index: usize
) -> Result<Option<Object<'d>>, ObjectError>

Resolves the object at the given index.

Returns Ok(None) if the index is out of bounds, or Err if the object exists but cannot be parsed.

Trait Implementations

impl<'d> Debug for Archive<'d>

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

Formats the value using the given formatter.

impl<'slf, 'd: 'slf> AsSelf<'slf> for Archive<'d>

type Ref = Archive<'slf>

The Self type with 'slf lifetimes, returned by as_self.

fn as_self(&'slf self) -> &Self::Ref

Returns a reference to self with downcasted lifetime.