Struct goblin::pe::exception::ExceptionData

pub struct ExceptionData<'a> { /* fields omitted */ }

Exception handling and stack unwind information for functions in the image.

Methods

impl<'a> ExceptionData<'a>

pub fn parse(
    bytes: &'a [u8],
    directory: DataDirectory,
    sections: &[SectionTable],
    file_alignment: u32
) -> Result<Self>

Parses exception data from the image at the given offset.

pub fn len(&self) -> usize

The number of function entries described by this exception data.

pub fn is_empty(&self) -> bool

Indicating whether there are functions in this entry.

Important traits for RuntimeFunctionIterator<'_>

impl<'_> Iterator for RuntimeFunctionIterator<'_> type Item = Result<RuntimeFunction>;

pub fn functions(&self) -> RuntimeFunctionIterator<'a>

Iterates all function entries in order of their code offset.

To search for a function by relative instruction address, use find_function. To resolve unwind information, use get_unwind_info.

pub fn get_function(&self, index: usize) -> Result<RuntimeFunction>

Returns the function at the given index.

pub fn find_function(&self, rva: u32) -> Result<Option<RuntimeFunction>>

Performs a binary search to find a function entry covering the given RVA relative to the image.

pub fn get_unwind_info(
    &self,
    function: RuntimeFunction,
    sections: &[SectionTable]
) -> Result<UnwindInfo<'a>>

Resolves unwind information for the given function entry.

Trait Implementations

impl<'a, '_> IntoIterator for &'_ ExceptionData<'a>

type Item = Result<RuntimeFunction>

The type of the elements being iterated over.

type IntoIter = RuntimeFunctionIterator<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'_> Debug for ExceptionData<'_>

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

Formats the value using the given formatter.