borderless 0.1.2

SDK for borderless packages
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

use super::node::Node;

use std::borrow::{Borrow, BorrowMut};
use std::cell::RefCell;
use std::marker::PhantomData;
use std::ops::{Deref, DerefMut};
use std::rc::Rc;

pub struct Proxy<'a, V> {
    pub(super) node_ptr: Rc<RefCell<Node<V>>>,
    pub(super) elem_idx: usize,
    pub(super) _back_ref: PhantomData<&'a V>, // <- prevents the tree from being borrowed mutably, while a proxy object exists
}

impl<'a, V> AsRef<V> for Proxy<'a, V> {
    fn as_ref(&self) -> &V {
        // TODO - check if this causes UB !
        let p = unsafe { &*self.node_ptr.as_ptr() };
        &p.values[self.elem_idx]
    }
}

impl<'a, V> Deref for Proxy<'a, V> {
    type Target = V;

    fn deref(&self) -> &Self::Target {
        self.as_ref()
    }
}

impl<'a, V> Borrow<V> for Proxy<'a, V> {
    fn borrow(&self) -> &V {
        self.as_ref()
    }
}

pub struct ProxyMut<'a, V> {
    pub(super) node_ptr: Rc<RefCell<Node<V>>>,
    pub(super) elem_idx: usize,
    pub(super) _back_ref: PhantomData<&'a mut V>, // <- prevents the tree from being borrowed, while a proxy object exists
}

impl<'a, V> AsRef<V> for ProxyMut<'a, V> {
    fn as_ref(&self) -> &V {
        // TODO - check if this causes UB !
        let p = unsafe { &mut *self.node_ptr.as_ptr() };
        &p.values[self.elem_idx]
    }
}

impl<'a, V> AsMut<V> for ProxyMut<'a, V> {
    fn as_mut(&mut self) -> &mut V {
        // TODO - check if this causes UB !
        let p = unsafe { &mut *self.node_ptr.as_ptr() };
        &mut p.values[self.elem_idx]
    }
}

impl<'a, V> Deref for ProxyMut<'a, V> {
    type Target = V;

    fn deref(&self) -> &Self::Target {
        self.as_ref()
    }
}

impl<'a, V> DerefMut for ProxyMut<'a, V> {
    fn deref_mut(&mut self) -> &mut Self::Target {
        self.as_mut()
    }
}

impl<'a, V> Borrow<V> for ProxyMut<'a, V> {
    fn borrow(&self) -> &V {
        self.as_ref()
    }
}

impl<'a, V> BorrowMut<V> for ProxyMut<'a, V> {
    fn borrow_mut(&mut self) -> &mut V {
        self.as_mut()
    }
}