Struct pdb::SectionOffset

pub struct SectionOffset {
    pub offset: u32,
    pub section: u16,
}

An offset relative to a PE section.

This offset can be converted to an Rva to receive the address relative to the entire image. Note that this offset applies to the actual PE headers. The PDB debug information actually stores PdbInternalSectionOffsets.

Fields

offset: u32

The memory offset relative from the start of the section’s memory.

section: u16

The index of the section in the PE’s section headers list, incremented by 1. A value of 0 indicates an invalid or missing reference.

Implementations

impl SectionOffset

pub fn new(section: u16, offset: u32) -> Self

Creates a new section offset.

pub fn is_valid(self) -> bool

Returns whether this section offset points to a valid section or into the void.

pub fn checked_add(self, offset: u32) -> Option<Self>

Checked addition of an offset. Returns None if overflow occurred.

This does not check whether the offset is still valid within the given section. If the offset is out of bounds, the conversion to Rva will return None.

pub fn saturating_add(self, offset: u32) -> Self

Saturating addition of an offset, clipped at the numeric bounds.

This does not check whether the offset is still valid within the given section. If the offset is out of bounds, the conversion to Rva will return None.

pub fn wrapping_add(self, offset: u32) -> Self

Wrapping (modular) addition of an offset.

This does not check whether the offset is still valid within the given section. If the offset is out of bounds, the conversion to Rva will return None.

impl SectionOffset

pub fn to_rva(self, translator: &AddressMap<'_>) -> Option<Rva>

Resolves an actual Relative Virtual Address in the executable’s address space.

pub fn to_internal_rva(
    self,
    translator: &AddressMap<'_>
) -> Option<PdbInternalRva>

Resolves a PDB-internal Relative Virtual Address.

This address is not necessarily compatible with the executable’s address space and should therefore not be used for debugging purposes.

pub fn to_internal_offset(
    self,
    translator: &AddressMap<'_>
) -> Option<PdbInternalSectionOffset>

Resolves the PDB internal section offset.

Trait Implementations

impl Add<u32> for SectionOffset

fn add(self, offset: u32) -> Self

Adds the given offset to this section offset.

This does not check whether the offset is still valid within the given section. If the offset is out of bounds, the conversion to Rva will return None.

type Output = SectionOffset

The resulting type after applying the + operator.

impl AddAssign<u32> for SectionOffset

fn add_assign(&mut self, offset: u32)

Adds the given offset to this section offset.

This does not check whether the offset is still valid within the given section. If the offset is out of bounds, the conversion to Rva will return None.

impl Clone for SectionOffset

fn clone(&self) -> SectionOffset

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SectionOffset

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

Formats the value using the given formatter.

impl Default for SectionOffset

fn default() -> SectionOffset

Returns the “default value” for a type.

impl Hash for SectionOffset

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<SectionOffset> for SectionOffset

fn eq(&self, other: &SectionOffset) -> bool

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

fn ne(&self, other: &SectionOffset) -> bool

This method tests for !=.

impl PartialOrd<SectionOffset> for SectionOffset

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

Compares offsets if they reside in the same section.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for SectionOffset

impl Eq for SectionOffset

impl StructuralEq for SectionOffset

impl StructuralPartialEq for SectionOffset