cluFullTransmute 1.4.2

Extended, no-constraint type transmutation API, featuring safe checks and const-ready logic.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

//! Reinterprets the bits of a value of one type as another type without checking.

use core::mem::ManuallyDrop;

union TransmutData<In, Out> {
	r#in: ManuallyDrop<In>,
	out: ManuallyDrop<Out>,
}

/// Reinterprets the bits of a value of one type as another type.
/// The function is completely const, data dimensions are not checked.
///
/// # Safety
/// No protections.
#[track_caller]
#[cfg_attr(
	all(feature = "transmute-inline", not(feature = "transmute-inline-always")),
	inline
)]
#[cfg_attr(feature = "transmute-inline-always", inline(always))]
pub const unsafe fn transmute_unchecked<T, To>(in_data: T) -> To {
	// Add transmutation checks regardless of the selected function,
	// only works when `debug_assert` is active
	#[cfg(all(feature = "assert_transmute_mode", debug_assertions))]
	{
		use crate::err::TransmuteErrKind;

		let size_d = size_of::<T>();
		let size_to = size_of::<To>();

		if size_d != size_to {
			let errkind = TransmuteErrKind::size_mismatch_in_debug_assert(size_d, size_to);

			errkind.unwrap();
		}
	}
	let wait_transmute_data = TransmutData {
		r#in: ManuallyDrop::new(in_data),
	};
	ManuallyDrop::into_inner(unsafe { wait_transmute_data.out })
}