pack1 1.1.0

Byte array newtypes for different primitive types.
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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

/// Bytes for a [`u64`], aligned to 1, big-endian.
#[derive(Clone, Copy, Default, PartialEq, Eq, PartialOrd, Ord, Hash)]
#[cfg_attr(feature = "bytemuck", derive(bytemuck::Zeroable, bytemuck::Pod))]
#[repr(transparent)]
pub struct U64BE([u8; 8]);
impl U64BE {
  /// Constructs the value from a standard [`u64`].
  #[inline]
  #[must_use]
  pub const fn new(u: u64) -> Self {
    Self(u.to_be_bytes())
  }
  /// Turns the value into a standard [`u64`].
  #[inline]
  #[must_use]
  pub const fn get(self) -> u64 {
    u64::from_be_bytes(self.0)
  }
}
impl From<u64> for U64BE {
  #[inline]
  #[must_use]
  fn from(value: u64) -> Self {
    Self::new(value)
  }
}
impl From<U64BE> for u64 {
  #[inline]
  #[must_use]
  fn from(value: U64BE) -> Self {
    value.get()
  }
}
int_fmt!(U64BE, u64);

/// Bytes for a [`u64`], aligned to 1, little-endian.
#[derive(Clone, Copy, Default, PartialEq, Eq, PartialOrd, Ord, Hash)]
#[cfg_attr(feature = "bytemuck", derive(bytemuck::Zeroable, bytemuck::Pod))]
#[repr(transparent)]
pub struct U64LE([u8; 8]);
impl U64LE {
  /// Constructs the value from a standard [`u64`].
  #[inline]
  #[must_use]
  pub const fn new(u: u64) -> Self {
    Self(u.to_le_bytes())
  }
  /// Turns the value into a standard [`u64`].
  #[inline]
  #[must_use]
  pub const fn get(self) -> u64 {
    u64::from_le_bytes(self.0)
  }
}
impl From<u64> for U64LE {
  #[inline]
  #[must_use]
  fn from(value: u64) -> Self {
    Self::new(value)
  }
}
impl From<U64LE> for u64 {
  #[inline]
  #[must_use]
  fn from(value: U64LE) -> Self {
    value.get()
  }
}
int_fmt!(U64LE, u64);

/// Bytes for a [`u64`], aligned to 1, native-endian.
#[derive(Clone, Copy, Default, PartialEq, Eq, PartialOrd, Ord, Hash)]
#[cfg_attr(feature = "bytemuck", derive(bytemuck::Zeroable, bytemuck::Pod))]
#[repr(transparent)]
pub struct U64NE([u8; 8]);
impl U64NE {
  /// Constructs the value from a standard [`u64`].
  #[inline]
  #[must_use]
  pub const fn new(u: u64) -> Self {
    Self(u.to_ne_bytes())
  }
  /// Turns the value into a standard [`u64`].
  #[inline]
  #[must_use]
  pub const fn get(self) -> u64 {
    u64::from_ne_bytes(self.0)
  }
}
impl From<u64> for U64NE {
  #[inline]
  #[must_use]
  fn from(value: u64) -> Self {
    Self::new(value)
  }
}
impl From<U64NE> for u64 {
  #[inline]
  #[must_use]
  fn from(value: U64NE) -> Self {
    value.get()
  }
}
int_fmt!(U64NE, u64);