Debian Codegraph @

.cargo/vendor/tiff/src/bytecast.rs

raw
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);