[go: up one dir, main page]

ref-cast 1.0.25

Safely cast &T to &U where the struct U contains a single field of type T.
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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

use core::mem;

#[doc(hidden)]
pub struct Layout<T: ?Sized>(T);

#[doc(hidden)]
pub trait LayoutUnsized<T: ?Sized> {
    const SIZE: usize = usize::MAX;
    const ALIGN: usize = usize::MAX;
}

impl<T: ?Sized> LayoutUnsized<T> for Layout<T> {}

impl<T> Layout<T> {
    pub const SIZE: usize = mem::size_of::<T>();
    pub const ALIGN: usize = mem::align_of::<T>();
}

#[doc(hidden)]
#[inline]
pub fn assert_layout<Outer: ?Sized, Inner: ?Sized>(
    name: &'static str,
    outer_size: usize,
    inner_size: usize,
    outer_align: usize,
    inner_align: usize,
) {
    if outer_size != inner_size {
        #[cfg(no_intrinsic_type_name)]
        panic!(
            "unexpected size in cast to {}: {} != {}",
            name, outer_size, inner_size,
        );
        #[cfg(not(no_intrinsic_type_name))]
        panic!(
            "unexpected size in cast from {} to {}: {} != {}",
            core::any::type_name::<Inner>(),
            core::any::type_name::<Outer>(),
            inner_size,
            outer_size,
        );
    }
    if outer_align != inner_align {
        #[cfg(no_intrinsic_type_name)]
        panic!(
            "unexpected alignment in cast to {}: {} != {}",
            name, outer_align, inner_align,
        );
        #[cfg(not(no_intrinsic_type_name))]
        panic!(
            "unexpected alignment in cast from {} to {}: {} != {}",
            core::any::type_name::<Inner>(),
            core::any::type_name::<Outer>(),
            inner_align,
            outer_align,
        );
    }
    #[cfg(not(no_intrinsic_type_name))]
    let _ = name;
}