1//! Trivial, internal byte transmutation.
2//!
3//! A dependency like bytemuck would give us extra assurance of the safety but overall would not
4//! reduce the amount of total unsafety. We don't use it in the interface where the traits would
5//! really become useful.
6//!
7//! SAFETY: These are benign casts as we apply them to fixed size integer types only. All of them
8//! are naturally aligned, valid for all bit patterns and their alignment is surely at most their
9//! size (we assert the latter fact since it is 'implementation defined' if following the letter of
10//! the unsafe code guidelines).
11//!
12//! TODO: Would like to use std-lib here.
13use std::{mem, slice};
14
15macro_rules! integral_slice_as_bytes{($int:ty, $const:ident $(,$mut:ident)*) => {
16 pub(crate) fn $const(slice: &[$int]) -> &[u8] {
17 assert!(mem::align_of::<$int>() <= mem::size_of::<$int>());
18 unsafe { slice::from_raw_parts(slice.as_ptr() as *const u8, mem::size_of_val(slice)) }
19 }
20 $(pub(crate) fn $mut(slice: &mut [$int]) -> &mut [u8] {
21 assert!(mem::align_of::<$int>() <= mem::size_of::<$int>());
22 unsafe { slice::from_raw_parts_mut(slice.as_mut_ptr() as *mut u8, mem::size_of_val(slice)) }
23 })*
24}}
25
26integral_slice_as_bytes!(i8, i8_as_ne_bytes, i8_as_ne_mut_bytes);
27integral_slice_as_bytes!(u16, u16_as_ne_bytes, u16_as_ne_mut_bytes);
28integral_slice_as_bytes!(i16, i16_as_ne_bytes, i16_as_ne_mut_bytes);
29integral_slice_as_bytes!(u32, u32_as_ne_bytes, u32_as_ne_mut_bytes);
30integral_slice_as_bytes!(i32, i32_as_ne_bytes, i32_as_ne_mut_bytes);
31integral_slice_as_bytes!(u64, u64_as_ne_bytes, u64_as_ne_mut_bytes);
32integral_slice_as_bytes!(i64, i64_as_ne_bytes, i64_as_ne_mut_bytes);
33integral_slice_as_bytes!(f32, f32_as_ne_bytes, f32_as_ne_mut_bytes);
34integral_slice_as_bytes!(f64, f64_as_ne_bytes, f64_as_ne_mut_bytes);
35