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

use crate::common::FromFFI;
use std::marker::PhantomData;

use lief_ffi as ffi;

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

impl<'a> FromFFI<ffi::COFF_String> for String<'a> {
    fn from_ffi(ptr: cxx::UniquePtr<ffi::COFF_String>) -> Self {
        Self {
            ptr,
            _owner: PhantomData,
        }
    }
}

/// This class represents a string located in the COFF string table.
///
/// Some of these strings can be used for section names that are greater than 8
/// bytes. See: [`crate::pe::Section::coff_string`]
///
/// Reference: <https://learn.microsoft.com/en-us/windows/win32/debug/pe-format#coff-string-table>
impl String<'_> {
    /// The actual string
    pub fn str(&self) -> std::string::String {
        self.ptr.str().to_string()
    }

    /// The offset of this string the in the COFF string table.
    /// This offset includes the first 4-bytes that holds the table size
    pub fn offset(&self) -> u32 {
        self.ptr.offset()
    }
}