Struct gimli::read::EntriesTree

pub struct EntriesTree<'abbrev, 'unit, R>
where
    R: Reader,
{
    root: R,
    unit: &'unit UnitHeader<R>,
    abbreviations: &'abbrev Abbreviations,
    input: R,
    entry: Option<DebuggingInformationEntry<'abbrev, 'unit, R>>,
    depth: isize,
}

The state information for a tree view of the Debugging Information Entries.

The EntriesTree can be used to recursively iterate through the DIE tree, following the parent/child relationships. The EntriesTree contains shared state for all nodes in the tree, avoiding any duplicate parsing of entries during the traversal.

Example Usage

let unit = get_some_unit();
let abbrevs = get_abbrevs_for_unit(&unit);

let mut tree = unit.entries_tree(&abbrevs, None)?;
let root = tree.root()?;
process_tree(root)?;

fn process_tree<R>(mut node: gimli::EntriesTreeNode<R>) -> gimli::Result<()>
    where R: gimli::Reader
{
    {
        // Examine the entry attributes.
        let mut attrs = node.entry().attrs();
        while let Some(attr) = attrs.next()? {
        }
    }
    let mut children = node.children();
    while let Some(child) = children.next()? {
        // Recursively process a child.
        process_tree(child);
    }
    Ok(())
}

Fields

root: R

unit: &'unit UnitHeader<R>

abbreviations: &'abbrev Abbreviations

input: R

entry: Option<DebuggingInformationEntry<'abbrev, 'unit, R>>

depth: isize

Implementations

impl<'abbrev, 'unit, R: Reader> EntriesTree<'abbrev, 'unit, R>

fn new( root: R, unit: &'unit UnitHeader<R>, abbreviations: &'abbrev Abbreviations, ) -> Self

pub fn root<'me>( &'me mut self, ) -> Result<EntriesTreeNode<'abbrev, 'unit, 'me, R>>

Returns the root node of the tree.

fn next(&mut self, depth: isize) -> Result<bool>

Move the cursor to the next entry at the specified depth.

Requires depth <= self.depth + 1.

Returns true if successful.

Trait Implementations

impl<'abbrev, 'unit, R> Clone for EntriesTree<'abbrev, 'unit, R>

where R: Reader + Clone,

fn clone(&self) -> EntriesTree<'abbrev, 'unit, R>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'abbrev, 'unit, R> Debug for EntriesTree<'abbrev, 'unit, R>

where R: Reader + Debug,

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

Formats the value using the given formatter.