Struct gimli::read::Attribute

pub struct Attribute<R: Reader> { /* fields omitted */ }

An attribute in a DebuggingInformationEntry, consisting of a name and associated value.

Implementations

impl<R: Reader> Attribute<R>

pub fn name(&self) -> DwAt

Get this attribute's name.

pub fn raw_value(&self) -> AttributeValue<R>

Get this attribute's raw value.

pub fn value(&self) -> AttributeValue<R>

Get this attribute's normalized value.

Attribute values can potentially be encoded in multiple equivalent forms, and may have special meaning depending on the attribute name. This method converts the attribute value to a normalized form based on the attribute name.

See "Table 7.5: Attribute encodings" and "Table 7.6: Attribute form encodings".

pub fn u8_value(&self) -> Option<u8>

Try to convert this attribute's value to a u8.

pub fn u16_value(&self) -> Option<u16>

Try to convert this attribute's value to a u16.

pub fn udata_value(&self) -> Option<u64>

Try to convert this attribute's value to an unsigned integer.

pub fn sdata_value(&self) -> Option<i64>

Try to convert this attribute's value to a signed integer.

pub fn offset_value(&self) -> Option<R::Offset>

Try to convert this attribute's value to an offset.

pub fn exprloc_value(&self) -> Option<Expression<R>>

Try to convert this attribute's value to an expression or location buffer.

Expressions and locations may be DW_FORM_block* or DW_FORM_exprloc. The standard doesn't mention DW_FORM_block* as a possible form, but it is encountered in practice.

pub fn string_value(&self, debug_str: &DebugStr<R>) -> Option<R>

Try to return this attribute's value as a string slice.

If this attribute's value is either an inline DW_FORM_string string, or a DW_FORM_strp reference to an offset into the .debug_str section, return the attribute's string value as Some. Other attribute value forms are returned as None.

Warning: this function does not handle all possible string forms. Use Dwarf::attr_string instead.

pub fn string_value_sup(
    &self,
    debug_str: &DebugStr<R>,
    debug_str_sup: Option<&DebugStr<R>>
) -> Option<R>

Try to return this attribute's value as a string slice.

If this attribute's value is either an inline DW_FORM_string string, or a DW_FORM_strp reference to an offset into the .debug_str section, or a DW_FORM_strp_sup reference to an offset into a supplementary object file, return the attribute's string value as Some. Other attribute value forms are returned as None.

Warning: this function does not handle all possible string forms. Use Dwarf::attr_string instead.

Trait Implementations

impl<R: Clone + Reader> Clone for Attribute<R>

fn clone(&self) -> Attribute<R>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<R: Copy + Reader> Copy for Attribute<R>

impl<R: Debug + Reader> Debug for Attribute<R>

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

Formats the value using the given formatter.

impl<R: Eq + Reader> Eq for Attribute<R>

impl<R: PartialEq + Reader> PartialEq<Attribute<R>> for Attribute<R>

fn eq(&self, other: &Attribute<R>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Attribute<R>) -> bool

This method tests for !=.

impl<R: Reader> StructuralEq for Attribute<R>

impl<R: Reader> StructuralPartialEq for Attribute<R>