Struct pdb_addr2line::ContextPdbData

pub struct ContextPdbData<'p, 's, S: Source<'s> + 's> { /* private fields */ }

Allows to easily create a Context directly from a pdb::PDB.

let pdb = pdb::PDB::open(stream)?;
let context_data = pdb_addr2line::ContextPdbData::try_from_pdb(pdb)?;
let context = context_data.make_context()?;

Implementation note: It would be nice if a Context could be created from a PDB directly, without going through an intermediate ContextPdbData object. However, there doesn’t seem to be an easy way to do this, due to certain lifetime dependencies: The Context object wants to store certain objects inside itself (mostly for caching) which have a lifetime dependency on pdb::ModuleInfo, so the ModuleInfo has to be owned outside of the Context. So the ContextPdbData object acts as that external ModuleInfo owner.

Implementations

impl<'p, 's, S: Source<'s> + 's> ContextPdbData<'p, 's, S>

pub fn try_from_pdb(pdb: PDB<'s, S>) -> Result<Self, Error>

Create a ContextPdbData from a PDB. This parses many of the PDB streams and stores them in the ContextPdbData. This creator function takes ownership of the pdb object and never gives it back.

pub fn try_from_pdb_ref(pdb: &'p mut PDB<'s, S>) -> Result<Self, Error>

Create a ContextPdbData from a PDB. This parses many of the PDB streams and stores them in the ContextPdbData. This creator function takes an exclusive reference to the pdb object, for consumers that want to keep using the pdb object once the ContextPdbData object is dropped.

pub fn make_type_formatter(&self) -> Result<TypeFormatter<'_, 's>, Error>

Create a TypeFormatter. This uses the default TypeFormatter settings.

pub fn make_type_formatter_with_flags(
    &self,
    flags: TypeFormatterFlags
) -> Result<TypeFormatter<'_, 's>, Error>

Create a TypeFormatter, using the specified TypeFormatter flags.

pub fn make_context(&self) -> Result<Context<'_, 's>, Error>

Create a Context. This uses the default TypeFormatter settings.

pub fn make_context_with_formatter_flags(
    &self,
    flags: TypeFormatterFlags
) -> Result<Context<'_, 's>, Error>

Create a Context, using the specified TypeFormatterFlags.

Trait Implementations

impl<'p, 's, S: Source<'s> + 's> ModuleProvider<'s> for ContextPdbData<'p, 's, S>

fn get_module_info(
    &self,
    module_index: usize,
    module: &Module<'_>
) -> Result<Option<&ModuleInfo<'s>>, Error>

Get the module info for this module from the PDB.