83 lines
3.2 KiB
Rust
83 lines
3.2 KiB
Rust
// 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<I> core::ops::Index<I> for $thing
|
|
where
|
|
[$ty]: core::ops::Index<I>,
|
|
{
|
|
type Output = <[$ty] as core::ops::Index<I>>::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(())
|
|
}
|
|
}
|
|
}
|
|
}
|