Struct gimli::read::RangeLists

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

The DWARF data found in .debug_ranges and .debug_rnglists sections.

Implementations§

source§

impl<R> RangeLists<R>

source

pub fn new( debug_ranges: DebugRanges<R>, debug_rnglists: DebugRngLists<R> ) -> RangeLists<R>

Construct a new RangeLists instance from the data in the .debug_ranges and .debug_rnglists sections.

source

pub fn debug_ranges(&self) -> &DebugRanges<R>

Return the .debug_ranges section.

source

pub fn set_debug_ranges(&mut self, debug_ranges: DebugRanges<R>)

Replace the .debug_ranges section.

This is useful for .dwo files when using the GNU split-dwarf extension to DWARF 4.

source

pub fn debug_rnglists(&self) -> &DebugRngLists<R>

Return the .debug_rnglists section.

source§

impl<T> RangeLists<T>

source

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

Create a RangeLists 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::RangeLists<Vec<u8>> = load_section();
// Create a reference to the DWARF section.
let section = owned_section.borrow(|section| {
    gimli::EndianSlice::new(&section, gimli::LittleEndian)
});
source§

impl<R: Reader> RangeLists<R>

source

pub fn ranges( &self, offset: RangeListsOffset<R::Offset>, unit_encoding: Encoding, base_address: u64, debug_addr: &DebugAddr<R>, debug_addr_base: DebugAddrBase<R::Offset> ) -> Result<RngListIter<R>>

Iterate over the Range list entries starting at the given offset.

The unit_version and address_size must match the compilation unit that the offset was contained in.

The base_address should be obtained from the DW_AT_low_pc attribute in the DW_TAG_compile_unit entry for the compilation unit that contains this range list.

Can be used with FallibleIterator.

source

pub fn raw_ranges( &self, offset: RangeListsOffset<R::Offset>, unit_encoding: Encoding ) -> Result<RawRngListIter<R>>

Iterate over the RawRngListEntryies starting at the given offset.

The unit_encoding must match the compilation unit that the offset was contained in.

This iterator does not perform any processing of the range entries, such as handling base addresses.

Can be used with FallibleIterator.

source

pub fn get_offset( &self, unit_encoding: Encoding, base: DebugRngListsBase<R::Offset>, index: DebugRngListsIndex<R::Offset> ) -> Result<RangeListsOffset<R::Offset>>

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

The base must be the DW_AT_rnglists_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_rnglistx attribute.

The unit_encoding must match the compilation unit that the index was contained in.

source

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

Call Reader::lookup_offset_id for each section, and return the first match.

Trait Implementations§

source§

impl<R: Clone> Clone for RangeLists<R>

source§

fn clone(&self) -> RangeLists<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 RangeLists<R>

source§

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

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

impl<R: Default> Default for RangeLists<R>

source§

fn default() -> RangeLists<R>

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

impl<R: Copy> Copy for RangeLists<R>

Auto Trait Implementations§

§

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

§

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

§

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

§

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

§

impl<R> UnwindSafe for RangeLists<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<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.