vert 0.1.1

The 51th Rust Game Engine, to write the 6th Game in Rust
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

use std::{any::TypeId, fmt::Display, marker::PhantomData};

use slotmap::{Key as KeyT, KeyData};

/// An owned key cannot be cloned or in any way duplicated (except with unsafe of course). it is unique.
///
/// But it can be converted into any number of normal keys that can be passed around.
#[repr(C)]
pub struct OwnedKey<T: 'static + Sized>(pub(super) Key<T>);

impl<T: 'static + Sized> OwnedKey<T> {
    pub fn key(&self) -> Key<T> {
        self.0
    }
}

// only from Owned -> Normal is allowed!
impl<T: 'static + Sized> From<OwnedKey<T>> for Key<T> {
    fn from(value: OwnedKey<T>) -> Self {
        value.0
    }
}

#[repr(C)]
pub struct Key<T: 'static + Sized> {
    value: KeyData,
    phantom: PhantomData<T>,
}

impl<T: 'static + Sized> Key<T> {
    #[inline]
    pub fn as_u64(&self) -> u64 {
        unsafe { std::mem::transmute(*self) }
    }

    /// a weak pseudo hash of the key. Used to check for equality
    #[inline]
    pub fn as_u64_xor_type(&self) -> u64 {
        // just copy the first 8 bytes of the type id:
        let ty: u64 = unsafe { std::mem::transmute_copy(&TypeId::of::<T>()) };
        let key = self.as_u64();
        ty ^ key
    }
}

impl<T: 'static + Sized> Display for Key<T> {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{:?}", self)
    }
}

impl<T: 'static + Sized> Clone for Key<T> {
    fn clone(&self) -> Self {
        Self {
            value: self.value,
            phantom: self.phantom,
        }
    }
}

impl<T: 'static + Sized> Copy for Key<T> {}

impl<T: 'static + Sized> std::fmt::Debug for Key<T> {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("Key").field("value", &self.value).finish()
    }
}

impl<T: 'static + Sized> std::hash::Hash for Key<T> {
    fn hash<H: std::hash::Hasher>(&self, state: &mut H) {
        self.value.hash(state);
    }
}

impl<T: 'static + Sized> PartialEq for Key<T> {
    fn eq(&self, other: &Self) -> bool {
        self.value == other.value
    }
}

impl<T: 'static + Sized> PartialOrd for Key<T> {
    fn partial_cmp(&self, other: &Self) -> Option<std::cmp::Ordering> {
        self.value.partial_cmp(&other.value)
    }
}

impl<T: 'static + Sized> Default for Key<T> {
    fn default() -> Self {
        Self {
            value: Default::default(),
            phantom: Default::default(),
        }
    }
}

impl<T: 'static + Sized> Eq for Key<T> {}

impl<T: 'static + Sized> Ord for Key<T> {
    fn cmp(&self, other: &Self) -> std::cmp::Ordering {
        self.value.cmp(&other.value)
    }
}

unsafe impl<T: 'static + Sized> KeyT for Key<T> {
    fn data(&self) -> KeyData {
        self.value
    }
}
impl<T: 'static + Sized> From<KeyData> for Key<T> {
    fn from(value: KeyData) -> Self {
        Key {
            value,
            phantom: PhantomData,
        }
    }
}