lief 1.0.0

Official Rust bindings for LIEF
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

use lief_ffi as ffi;

use std::marker::PhantomData;

use crate::DebugLocation;
use crate::DeclOpt;
use crate::common::FromFFI;
use crate::declare_fwd_iterator;

pub struct Function<'a> {
    ptr: cxx::UniquePtr<ffi::PDB_Function>,
    _owner: PhantomData<&'a ()>,
}

impl FromFFI<ffi::PDB_Function> for Function<'_> {
    fn from_ffi(ptr: cxx::UniquePtr<ffi::PDB_Function>) -> Self {
        Self {
            ptr,
            _owner: PhantomData,
        }
    }
}

impl Function<'_> {
    /// The name of the function (this name is usually demangled)
    pub fn name(&self) -> String {
        self.ptr.name().to_string()
    }

    /// The **Relative** Virtual Address of the function
    pub fn rva(&self) -> u32 {
        self.ptr.RVA()
    }

    /// The size of the function
    pub fn code_size(&self) -> u32 {
        self.ptr.code_size()
    }

    /// The name of the section in which this function is defined
    pub fn section_name(&self) -> String {
        self.ptr.section_name().to_string()
    }

    /// Original source code location
    pub fn debug_location(&self) -> DebugLocation {
        DebugLocation::from_ffi(self.ptr.debug_location())
    }

    /// Generate a C/C++ definition for this function
    pub fn to_decl(&self) -> String {
        self.ptr.to_decl().to_string()
    }

    /// Same as [`Function::to_decl`] but with the given configuration
    pub fn to_decl_with_opt(&self, opt: &DeclOpt) -> String {
        self.ptr.to_decl_with_opt(&opt.to_ffi()).to_string()
    }
}

impl std::fmt::Display for Function<'_> {
    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        write!(f, "{}", self.ptr.to_string())
    }
}

declare_fwd_iterator!(
    Functions,
    Function<'a>,
    ffi::PDB_Function,
    ffi::PDB_CompilationUnit,
    ffi::PDB_CompilationUnit_it_functions
);