Struct gimli::write::UnitTable

pub struct UnitTable { /* private fields */ }

A table of units that will be stored in the .debug_info section.

Implementations

impl UnitTable

pub fn from<R: Reader<Offset = usize>>( dwarf: &Dwarf<R>, line_strings: &mut LineStringTable, strings: &mut StringTable, convert_address: &dyn Fn(u64) -> Option<Address>, ) -> ConvertResult<UnitTable>

Create a unit table by reading the data in the given sections.

This also updates the given tables with the values that are referenced from attributes in this section.

convert_address is a function to convert read addresses into the Address type. For non-relocatable addresses, this function may simply return Address::Constant(address). For relocatable addresses, it is the caller’s responsibility to determine the symbol and addend corresponding to the address and return Address::Symbol { symbol, addend }.

impl UnitTable

pub fn add(&mut self, unit: Unit) -> UnitId

Create a new unit and add it to the table.

address_size must be in bytes.

Returns the UnitId of the new unit.

pub fn count(&self) -> usize

Return the number of units.

pub fn id(&self, index: usize) -> UnitId

Return the id of a unit.

Panics

Panics if index >= self.count().

pub fn get(&self, id: UnitId) -> &Unit

Get a reference to a unit.

Panics

Panics if id is invalid.

pub fn get_mut(&mut self, id: UnitId) -> &mut Unit

Get a mutable reference to a unit.

Panics

Panics if id is invalid.

pub fn iter(&self) -> impl Iterator<Item = (UnitId, &Unit)>

Get an iterator for the units.

pub fn iter_mut(&mut self) -> impl Iterator<Item = (UnitId, &mut Unit)>

Get a mutable iterator for the units.

pub fn write<W: Writer>( &mut self, sections: &mut Sections<W>, line_strings: &DebugLineStrOffsets, strings: &DebugStrOffsets, ) -> Result<DebugInfoOffsets>

Write the units to the given sections.

strings must contain the .debug_str offsets of the corresponding StringTable.

Trait Implementations

impl Debug for UnitTable

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

Formats the value using the given formatter.

impl Default for UnitTable

fn default() -> UnitTable

Returns the “default value” for a type.