netfp 0.1.1

Rust primitives and implementations for network fingerprinting
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

use crate::error::Error;

/// Represents an unsigned 24-bit integer.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub struct U24(usize);

impl U24 {
    pub const MAX: usize = (1 << 24) - 1;

    /// Creates a new 24-bit unsigned integer.
    ///
    /// # Errors
    ///
    /// Returns [`Error::LengthOverflow`] if `value` exceeds `0xFF_FFFF`.
    pub const fn new(value: usize) -> Result<Self, Error> {
        if value > Self::MAX {
            return Err(Error::LengthOverflow {
                max: Self::MAX,
                actual: value,
            });
        }

        Ok(Self(value))
    }

    /// Returns the value encoded as three bytes in network byte order.
    pub const fn to_be_bytes(self) -> [u8; 3] {
        [(self.0 >> 16) as u8, (self.0 >> 8) as u8, self.0 as u8]
    }
}