// SPDX-License-Identifier: CC0-1.0 /// Implement methods and traits for types that contain an inner array. #[macro_export] macro_rules! impl_array_newtype { ($thing:ident, $ty:ty, $len:expr) => { impl $thing { /// Like `cmp::Ord` but faster and with no guarantees across library versions. /// /// The inner byte array of `Self` is passed across the FFI boundry, as such there are /// no guarantees on its layout and it is subject to change across library versions, /// even minor versions. For this reason comparison function implementations (e.g. /// `Ord`, `PartialEq`) take measures to ensure the data will remain constant (e.g., by /// serializing it to a guaranteed format). This means they may be slow, this function /// provides a faster comparison if you know that your types come from the same library /// version. pub fn cmp_fast_unstable(&self, other: &Self) -> core::cmp::Ordering { self[..].cmp(&other[..]) } /// Like `cmp::Eq` but faster and with no guarantees across library versions. /// /// The inner byte array of `Self` is passed across the FFI boundry, as such there are /// no guarantees on its layout and it is subject to change across library versions, /// even minor versions. For this reason comparison function implementations (e.g. /// `Ord`, `PartialEq`) take measures to ensure the data will remain constant (e.g., by /// serializing it to a guaranteed format). This means they may be slow, this function /// provides a faster equality check if you know that your types come from the same /// library version. pub fn eq_fast_unstable(&self, other: &Self) -> bool { self[..].eq(&other[..]) } } impl AsRef<[$ty; $len]> for $thing { #[inline] /// Gets a reference to the underlying array fn as_ref(&self) -> &[$ty; $len] { let &$thing(ref dat) = self; dat } } impl core::ops::Index for $thing where [$ty]: core::ops::Index, { type Output = <[$ty] as core::ops::Index>::Output; #[inline] fn index(&self, index: I) -> &Self::Output { &self.0[index] } } impl $crate::CPtr for $thing { type Target = $ty; fn as_c_ptr(&self) -> *const Self::Target { let &$thing(ref dat) = self; dat.as_ptr() } fn as_mut_c_ptr(&mut self) -> *mut Self::Target { let &mut $thing(ref mut dat) = self; dat.as_mut_ptr() } } } } #[macro_export] macro_rules! impl_raw_debug { ($thing:ident) => { impl core::fmt::Debug for $thing { fn fmt(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result { for i in self[..].iter().cloned() { write!(f, "{:02x}", i)?; } Ok(()) } } } }