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

// Basic example using cluFullTransmute with size check.

use cluFullTransmute::try_transmute_or_panic;

fn main() {
	let input: [u8; 4] = [0x01, 0x02, 0x03, 0x04];

	// Attempt safe transmute to u32
	let value: u32 = unsafe { try_transmute_or_panic(input) };

	println!("Transmuted value: {value:#010X}");

	// Example of failed transmutation:
	let bad_input: [u8; 3] = [0x01, 0x02, 0x03];

	match unsafe { cluFullTransmute::try_transmute::<_, u32>(bad_input) } {
		Ok(v) => println!("Unexpected success: {v}"),
		Err(e) => {
			println!("Transmutation failed due to: {e}");
			if e.kind().is_size_mismatch() {
				println!(
					"Expected size: {:?}, Actual size: {:?}",
					e.into_kind(),
					e.as_data().len()
				);
			}
		}
	}
}