Struct SymbolTable

pub struct SymbolTable<'data, R = &'data [u8], Coff = ImageFileHeader>
where
    R: ReadRef<'data>,
    Coff: CoffHeader,
{
    symbols: &'data [Coff::ImageSymbolBytes],
    strings: StringTable<'data, R>,
}

A table of symbol entries in a COFF or PE file.

Also includes the string table used for the symbol names.

Returned by CoffHeader::symbols and ImageNtHeaders::symbols.

Fields

symbols: &'data [Coff::ImageSymbolBytes]

strings: StringTable<'data, R>

Implementations

impl<'data, R: ReadRef<'data>, Coff: CoffHeader> SymbolTable<'data, R, Coff>

pub fn parse(header: &Coff, data: R) -> Result<Self>

Read the symbol table.

pub fn strings(&self) -> StringTable<'data, R>

Return the string table used for the symbol names.

pub fn is_empty(&self) -> bool

Return true if the symbol table is empty.

pub fn len(&self) -> usize

The number of symbol table entries.

This includes auxiliary symbol table entries.

pub fn iter<'table>(&'table self) -> SymbolIterator<'data, 'table, R, Coff>

Iterate over the symbols.

pub fn symbol(&self, index: SymbolIndex) -> Result<&'data Coff::ImageSymbol>

Return the symbol table entry at the given index.

pub fn aux_function( &self, index: SymbolIndex, ) -> Result<&'data ImageAuxSymbolFunction>

Return the auxiliary function symbol for the symbol table entry at the given index.

Note that the index is of the symbol, not the first auxiliary record.

pub fn aux_section( &self, index: SymbolIndex, ) -> Result<&'data ImageAuxSymbolSection>

Return the auxiliary section symbol for the symbol table entry at the given index.

Note that the index is of the symbol, not the first auxiliary record.

pub fn aux_weak_external( &self, index: SymbolIndex, ) -> Result<&'data ImageAuxSymbolWeak>

Return the auxiliary weak external symbol for the symbol table entry at the given index.

Note that the index is of the symbol, not the first auxiliary record.

pub fn aux_file_name( &self, index: SymbolIndex, aux_count: u8, ) -> Result<&'data [u8]>

Return the auxiliary file name for the symbol table entry at the given index.

Note that the index is of the symbol, not the first auxiliary record.

pub fn get<T: Pod>(&self, index: SymbolIndex, offset: usize) -> Result<&'data T>

Return the symbol table entry or auxiliary record at the given index and offset.

pub fn map<Entry: SymbolMapEntry, F: Fn(&'data Coff::ImageSymbol) -> Option<Entry>>( &self, f: F, ) -> SymbolMap<Entry>

Construct a map from addresses to a user-defined map entry.

Trait Implementations

impl<'data, R, Coff> Debug for SymbolTable<'data, R, Coff>

where R: ReadRef<'data> + Debug, Coff: CoffHeader + Debug, Coff::ImageSymbolBytes: Debug,

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

Formats the value using the given formatter.

impl<'data, R: ReadRef<'data>, Coff: CoffHeader> Default for SymbolTable<'data, R, Coff>

fn default() -> Self

Returns the “default value” for a type.