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.

Implementations

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<Archive<'d>, ObjectError>

Tries to parse a generic archive from the given slice.

pub fn file_format(&self) -> FileFormat

The container format of this file.

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.

pub fn is_multi(&self) -> bool

Returns whether this is a multi-object archive.

This may also return true if there is only a single object inside the archive.

Trait Implementations

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

type Ref = Archive<'slf>

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

pub fn as_self(&'slf self) -> &'slf <Archive<'d> as AsSelf<'slf>>::Ref

Returns a reference to self with downcasted lifetime.

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

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

Formats the value using the given formatter.