Struct symbolic_debuginfo::Archive

pub struct Archive<'d>(/* private fields */);

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<Self, 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: '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.

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

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

Formats the value using the given formatter.