hexga_core 0.0.11-beta.56

Basic set of functionalities common to all hexga crate
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

use super::*;
use core::pin::Pin;

/// A box that will, when dropped, drop in place it's content, but not deallocate
pub struct DropOnlyBox<T: ?Sized>
{
    ptr: NonNullUnaliased<T>,
}

impl<T: ?Sized> Debug for DropOnlyBox<T>
where
    T: Debug,
{
    fn fmt(&self, f: &mut Formatter<'_>) -> core::fmt::Result { unsafe { self.ptr.as_ref().fmt(f) } }
}
impl<T: ?Sized> Display for DropOnlyBox<T>
where
    T: Display,
{
    fn fmt(&self, f: &mut Formatter<'_>) -> core::fmt::Result { unsafe { self.ptr.as_ref().fmt(f) } }
}

unsafe impl<T> FromNonNull for DropOnlyBox<T>
{
    unsafe fn from_non_null(ptr: NonNull) -> Self { unsafe { DropOnlyBox::from_raw(ptr.as_ptr() as *mut T) } }
}
unsafe impl<T> IntoNonNull for DropOnlyBox<T>
{
    unsafe fn into_non_null(self) -> NonNull { unsafe { NonNull::new_unchecked(Self::leak(self) as *mut T as *mut u8) } }

    unsafe fn as_non_null(&mut self) -> NonNull { unsafe { NonNull::new_unchecked(self.as_mut() as *mut T as *mut u8) } }
}

impl<T: ?Sized> DropOnlyBox<T>
{
    pub const unsafe fn from_non_null(ptr: NonNull<T>) -> Self { unsafe { Self::new(ptr) } }

    pub const unsafe fn from_raw(ptr: *mut T) -> Self
    {
        debug_assert!(!ptr.is_null());
        unsafe { Self::new(NonNullUnaliased::new_unchecked(ptr)) }
    }

    pub const unsafe fn new(ptr: NonNullUnaliased<T>) -> Self { Self { ptr } }

    pub const fn as_ptr(&self) -> *mut T { self.ptr.as_ptr() }
    pub const fn as_mut(&mut self) -> *mut T { unsafe { self.ptr.as_mut() } }

    pub const fn into_pin(s: Self) -> Pin<Self> where { unsafe { Pin::new_unchecked(s) } }

    pub const fn leak<'a>(mut s: Self) -> &'a mut T
    {
        let val = unsafe { s.ptr.as_mut() };
        mem::forget(s);
        val
    }
}
impl<T> DropOnlyBox<T>
{
    pub fn into_inner(s: Self) -> T
    {
        let val = unsafe { s.ptr.read() };
        mem::forget(s);
        val
    }
}

impl<T: ?Sized> Deref for DropOnlyBox<T>
{
    type Target = T;
    fn deref(&self) -> &T { unsafe { self.ptr.as_ref() } }
}

impl<T: ?Sized> DerefMut for DropOnlyBox<T>
{
    fn deref_mut(&mut self) -> &mut T { unsafe { self.ptr.as_mut() } }
}

impl<T: ?Sized> Drop for DropOnlyBox<T>
{
    fn drop(&mut self)
    {
        unsafe {
            ptr::drop_in_place(self.ptr.as_ptr());
        }
    }
}