dangerous 0.10.0

Safely and explicitly parse untrusted / dangerous data
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

use crate::display::byte_count;
use crate::fmt;

/// Length that was expected in an operation.
#[derive(Debug, Copy, Clone, PartialEq, Eq)]
#[must_use]
pub enum Length {
    /// A minimum length was expected.
    AtLeast(usize),
    /// An exact length was expected.
    Exactly(usize),
}

impl Length {
    /// The minimum length that was expected.
    #[must_use]
    #[inline(always)]
    pub fn min(self) -> usize {
        match self {
            Length::AtLeast(min) | Length::Exactly(min) => min,
        }
    }

    /// The maximum length that was expected, if applicable.
    #[must_use]
    #[inline(always)]
    pub fn max(self) -> Option<usize> {
        match self {
            Length::AtLeast(_) => None,
            Length::Exactly(max) => Some(max),
        }
    }
}

impl fmt::DisplayBase for Length {
    fn fmt(&self, w: &mut dyn fmt::Write) -> fmt::Result {
        match *self {
            Self::AtLeast(min) => {
                w.write_str("at least ")?;
                byte_count(w, min)
            }
            Self::Exactly(exact) => {
                w.write_str("exactly ")?;
                byte_count(w, exact)
            }
        }
    }
}