Struct gimli::read::DebugStrOffsets

pub struct DebugStrOffsets<R> { /* fields omitted */ }

The raw contents of the .debug_str_offsets section.

Implementations

impl<R: Reader> DebugStrOffsets<R>

pub fn get_str_offset(
    &self,
    format: Format,
    base: DebugStrOffsetsBase<R::Offset>,
    index: DebugStrOffsetsIndex<R::Offset>
) -> Result<DebugStrOffset<R::Offset>>

Returns the .debug_str offset at the given base and index.

A set of entries in the .debug_str_offsets section consists of a header followed by a series of string table offsets.

The base must be the DW_AT_str_offsets_base value from the compilation unit DIE. This is an offset that points to the first entry following the header.

The index is the value of a DW_FORM_strx attribute.

The format must be the DWARF format of the compilation unit. This format must match the header. However, note that we do not parse the header to validate this, since locating the header is unreliable, and the GNU extensions do not emit it.

impl<T> DebugStrOffsets<T>

pub fn borrow<'a, F, R>(&'a self, borrow: F) -> DebugStrOffsets<R> where
    F: FnMut(&'a T) -> R, 

Create a DebugStrOffsets section that references the data in self.

This is useful when R implements Reader but T does not.

Example Usage

// Read the DWARF section into a `Vec` with whatever object loader you're using.
let owned_section: gimli::DebugStrOffsets<Vec<u8>> = load_section();
// Create a reference to the DWARF section.
let section = owned_section.borrow(|section| {
    gimli::EndianSlice::new(&section, gimli::LittleEndian)
});

Trait Implementations

impl<R: Clone> Clone for DebugStrOffsets<R>

fn clone(&self) -> DebugStrOffsets<R>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<R: Copy> Copy for DebugStrOffsets<R>

impl<R: Debug> Debug for DebugStrOffsets<R>

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

Formats the value using the given formatter.

impl<R: Default> Default for DebugStrOffsets<R>

fn default() -> DebugStrOffsets<R>

Returns the “default value” for a type.

impl<R> From<R> for DebugStrOffsets<R>

fn from(section: R) -> Self

Performs the conversion.

impl<R> Section<R> for DebugStrOffsets<R>

fn id() -> SectionId

Returns the section id for this type.

fn reader(&self) -> &R

Returns the Reader for this section.

fn section_name() -> &'static str

Returns the ELF section name for this type.

fn dwo_section_name() -> Option<&'static str>

Returns the ELF section name (if any) for this type when used in a dwo file.

fn load<F, E>(f: F) -> Result<Self, E> where
    F: FnOnce(SectionId) -> Result<R, E>, 

Try to load the section using the given loader function.

fn lookup_offset_id(&self, id: ReaderOffsetId) -> Option<(SectionId, R::Offset)> where
    R: Reader, 

Returns the Reader for this section.