Struct FilterUnitSection 

pub struct FilterUnitSection<'a, R: Reader<Offset = usize>> { /* private fields */ }

The state for identifying which DIEs in a .debug_info section need to be converted.

This is used to prune unneeded DIEs, and reserve IDs so that DIE references can be converted.

The user should call FilterUnitSection::read_unit and FilterUnit::read_entry to traverse all DIEs in the section. Once there are no more units, this state can be passed to Dwarf::convert_with_filter or ConvertUnit::convert_split_with_filter.

Example

Create a filter for the DIEs in a DWARF section.

let read_dwarf = gimli::read::Dwarf::load(loader)?;
let mut filter = gimli::write::FilterUnitSection::new(&read_dwarf)?;
while let Some(mut unit) = filter.read_unit()? {
    let mut entry = unit.null_entry();
    while unit.read_entry(&mut entry)? {
        if need_entry(&entry)? {
            unit.require_entry(entry.offset);
        }
    }
}
// `filter` can now be used to filter the DIEs during a conversion.

Implementations

impl<'a, R: Reader<Offset = usize>> FilterUnitSection<'a, R>

pub fn new(dwarf: &'a Dwarf<R>) -> ConvertResult<Self>

Start parsing a .debug_info section.

Example

let read_dwarf = gimli::read::Dwarf::load(loader)?;
let mut filter = gimli::write::FilterUnitSection::new(&read_dwarf)?;

pub fn new_split( dwarf: &'a Dwarf<R>, skeleton_unit: UnitRef<'a, R>, ) -> ConvertResult<Self>

Start parsing the .debug_info section for a split DWARF unit.

Example

let dwp = gimli::read::DwarfPackage::load(loader, Default::default())?;
let dwo_id = skeleton_unit.dwo_id.unwrap();
let split_dwarf = dwp.find_cu(dwo_id, skeleton_unit.dwarf)?.unwrap();
let mut filter = gimli::write::FilterUnitSection::new_split(&split_dwarf, skeleton_unit)?;

pub fn read_unit(&mut self) -> ConvertResult<Option<FilterUnit<'_, R>>>

Read the next unit header and prepare to parse its DIEs.

Trait Implementations

impl<'a, R: Debug + Reader<Offset = usize>> Debug for FilterUnitSection<'a, R>

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

Formats the value using the given formatter.