Struct gimli::read::DebugStrOffsets

source ·
pub struct DebugStrOffsets<R> { /* private fields */ }
Expand description

The raw contents of the .debug_str_offsets section.

Implementations§

source§

impl<R: Reader> DebugStrOffsets<R>

source

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.

source§

impl<T> DebugStrOffsets<T>

source

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§

source§

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

source§

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

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

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

source§

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

Formats the value using the given formatter. Read more
source§

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

source§

fn default() -> DebugStrOffsets<R>

Returns the “default value” for a type. Read more
source§

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

source§

fn from(section: R) -> Self

Converts to this type from the input type.
source§

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

source§

fn id() -> SectionId

Returns the section id for this type.
source§

fn reader(&self) -> &R

Returns the Reader for this section.
source§

fn section_name() -> &'static str

Returns the ELF section name for this type.
source§

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

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

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

Returns the XCOFF section name (if any) for this type when used in a XCOFF file.
source§

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.
source§

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

Auto Trait Implementations§

§

impl<R> RefUnwindSafe for DebugStrOffsets<R>
where R: RefUnwindSafe,

§

impl<R> Send for DebugStrOffsets<R>
where R: Send,

§

impl<R> Sync for DebugStrOffsets<R>
where R: Sync,

§

impl<R> Unpin for DebugStrOffsets<R>
where R: Unpin,

§

impl<R> UnwindSafe for DebugStrOffsets<R>
where R: UnwindSafe,

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<!> for T

source§

fn from(t: !) -> T

Converts to this type from the input type.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.