pub struct DebugStr<R> { /* private fields */ }
Expand description
The DebugStr
struct represents the DWARF strings
found in the .debug_str
section.
Implementations
sourceimpl<'input, Endian> DebugStr<EndianSlice<'input, Endian>> where
Endian: Endianity,
impl<'input, Endian> DebugStr<EndianSlice<'input, Endian>> where
Endian: Endianity,
sourcepub fn new(debug_str_section: &'input [u8], endian: Endian) -> Self
pub fn new(debug_str_section: &'input [u8], endian: Endian) -> Self
Construct a new DebugStr
instance from the data in the .debug_str
section.
It is the caller’s responsibility to read the .debug_str
section and
present it as a &[u8]
slice. That means using some ELF loader on
Linux, a Mach-O loader on OSX, etc.
use gimli::{DebugStr, LittleEndian};
let debug_str = DebugStr::new(read_debug_str_section_somehow(), LittleEndian);
sourceimpl<R: Reader> DebugStr<R>
impl<R: Reader> DebugStr<R>
sourcepub fn get_str(&self, offset: DebugStrOffset<R::Offset>) -> Result<R>
pub fn get_str(&self, offset: DebugStrOffset<R::Offset>) -> Result<R>
Lookup a string from the .debug_str
section by DebugStrOffset.
use gimli::{DebugStr, DebugStrOffset, LittleEndian};
let debug_str = DebugStr::new(read_debug_str_section_somehow(), LittleEndian);
println!("Found string {:?}", debug_str.get_str(debug_str_offset_somehow()));
sourceimpl<T> DebugStr<T>
impl<T> DebugStr<T>
sourcepub fn borrow<'a, F, R>(&'a self, borrow: F) -> DebugStr<R> where
F: FnMut(&'a T) -> R,
pub fn borrow<'a, F, R>(&'a self, borrow: F) -> DebugStr<R> where
F: FnMut(&'a T) -> R,
Create a DebugStr
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::DebugStr<Vec<u8>> = load_section();
// Create a reference to the DWARF section.
let section = owned_section.borrow(|section| {
gimli::EndianSlice::new(§ion, gimli::LittleEndian)
});
Trait Implementations
sourceimpl<R> Section<R> for DebugStr<R>
impl<R> Section<R> for DebugStr<R>
sourcefn section_name() -> &'static str
fn section_name() -> &'static str
Returns the ELF section name for this type.
sourcefn dwo_section_name() -> Option<&'static str>
fn dwo_section_name() -> Option<&'static str>
Returns the ELF section name (if any) for this type when used in a dwo file. Read more
sourcefn load<F, E>(f: F) -> Result<Self, E> where
F: FnOnce(SectionId) -> Result<R, E>,
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.
sourcefn dwp_range(&self, offset: u32, size: u32) -> Result<Self> where
R: Reader,
fn dwp_range(&self, offset: u32, size: u32) -> Result<Self> where
R: Reader,
Returns the subrange of the section that is the contribution of
a unit in a .dwp
file. Read more
sourcefn lookup_offset_id(&self, id: ReaderOffsetId) -> Option<(SectionId, R::Offset)> where
R: Reader,
fn lookup_offset_id(&self, id: ReaderOffsetId) -> Option<(SectionId, R::Offset)> where
R: Reader,
Returns the Reader
for this section.
impl<R: Copy> Copy for DebugStr<R>
Auto Trait Implementations
impl<R> RefUnwindSafe for DebugStr<R> where
R: RefUnwindSafe,
impl<R> Send for DebugStr<R> where
R: Send,
impl<R> Sync for DebugStr<R> where
R: Sync,
impl<R> Unpin for DebugStr<R> where
R: Unpin,
impl<R> UnwindSafe for DebugStr<R> where
R: UnwindSafe,
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more