| 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. |
| 13 |
// Until we implement predictors for f16, we don't need f16_as_ne_bytes. (Due to the macro we do |
| 14 |
// not apply this directly to the functions). And rust-version is not new enough for `expect`. |
| 15 |
#![allow(dead_code)] |
| 16 |
use std::{mem, slice}; |
| 17 |
|
| 18 |
use half::f16; |
| 19 |
|
| 20 |
macro_rules! integral_slice_as_bytes{($int:ty, $const:ident $(,$mut:ident)*) => { |
| 21 |
pub(crate) fn $const(slice: &[$int]) -> &[u8] { |
| 22 |
assert!(mem::align_of::<$int>() <= mem::size_of::<$int>()); |
| 23 |
unsafe { slice::from_raw_parts(slice.as_ptr() as *const u8, mem::size_of_val(slice)) } |
| 24 |
} |
| 25 |
$(pub(crate) fn $mut(slice: &mut [$int]) -> &mut [u8] { |
| 26 |
assert!(mem::align_of::<$int>() <= mem::size_of::<$int>()); |
| 27 |
unsafe { slice::from_raw_parts_mut(slice.as_mut_ptr() as *mut u8, mem::size_of_val(slice)) } |
| 28 |
})* |
| 29 |
}} |
| 30 |
|
| 31 |
integral_slice_as_bytes!(i8, i8_as_ne_bytes, i8_as_ne_mut_bytes); |
| 32 |
integral_slice_as_bytes!(u16, u16_as_ne_bytes, u16_as_ne_mut_bytes); |
| 33 |
integral_slice_as_bytes!(i16, i16_as_ne_bytes, i16_as_ne_mut_bytes); |
| 34 |
integral_slice_as_bytes!(u32, u32_as_ne_bytes, u32_as_ne_mut_bytes); |
| 35 |
integral_slice_as_bytes!(i32, i32_as_ne_bytes, i32_as_ne_mut_bytes); |
| 36 |
integral_slice_as_bytes!(u64, u64_as_ne_bytes, u64_as_ne_mut_bytes); |
| 37 |
integral_slice_as_bytes!(i64, i64_as_ne_bytes, i64_as_ne_mut_bytes); |
| 38 |
integral_slice_as_bytes!(f32, f32_as_ne_bytes, f32_as_ne_mut_bytes); |
| 39 |
integral_slice_as_bytes!(f16, f16_as_ne_bytes, f16_as_ne_mut_bytes); |
| 40 |
integral_slice_as_bytes!(f64, f64_as_ne_bytes, f64_as_ne_mut_bytes); |