pewter 0.0.3

A library for reading and writing PE files
Documentation 
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

#[cfg(feature = "std")]
use crate::alloc_containers::error::Error;

pub type Result<T> = core::result::Result<T, PewterError>;

#[derive(Debug)]
pub enum PewterError {
    NotEnoughDataLeft { attempted_read: usize },
    NotEnoughSpaceLeft { attempted_write: usize },
    InvalidImageFormat { message: &'static str },
}

impl PewterError {
    #[cold]
    pub const fn not_enough_data(size: usize) -> Self {
        Self::NotEnoughDataLeft {
            attempted_read: size,
        }
    }
    #[cold]
    pub const fn not_enough_space(size: usize) -> Self {
        Self::NotEnoughSpaceLeft {
            attempted_write: size,
        }
    }
    #[cold]
    pub const fn invalid_image_format(message: &'static str) -> Self {
        Self::InvalidImageFormat { message }
    }
}

impl core::fmt::Display for PewterError {
    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
        match self {
            Self::InvalidImageFormat { message } => write!(f, "Invalid image format: {}", message),
            Self::NotEnoughDataLeft { attempted_read } => write!(
                f,
                "Attempted to read {} bytes but there was not enough data.",
                attempted_read
            ),
            Self::NotEnoughSpaceLeft { attempted_write } => write!(
                f,
                "Attempted to write {} bytes but there was not enough space.",
                attempted_write
            ),
        }
    }
}

#[cfg(feature = "std")]
impl Error for PewterError {
    fn source(&self) -> Option<&(dyn Error + 'static)> {
        None
    }

    fn description(&self) -> &str {
        "description() is deprecated; use Display"
    }

    fn cause(&self) -> Option<&dyn Error> {
        self.source()
    }
}