roto 0.11.0

a statically-typed, compiled, embedded scripting language
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

/// A placeholder type alias representing the type parameter of the extern "C" functions
type T = ();

/// A Roto clone function
pub type CloneFn = unsafe extern "C" fn(*mut T, *const T);

/// A Roto drop function
pub type DropFn = unsafe extern "C" fn(*mut T);

/// A Roto drop function
pub type EqFn = unsafe extern "C" fn(*const T, *const T) -> bool;

/// Vtable of Roto values
///
/// This struct can be generated for every Roto value and contains the functions that
/// are available for all types. This type can be used to work with values of unknown
/// types.
///
/// If a registered function asks for this value, the compiler will ensure that the vtable
/// of the correct type is generated on demand. This should generally not be constructed
/// or modified.
#[derive(Clone, Debug)]
#[repr(C)]
pub struct VTable {
    size: usize,
    align: usize,

    /// Copies the value behind its second argument to the first
    ///
    /// It should only be `None` for `Copy` types.
    pub clone_fn: Option<CloneFn>,

    /// Drops the value behind its argument in place
    ///
    /// It should only be `None` for types that can be trivially dropped.
    pub drop_fn: Option<DropFn>,

    /// Determines whether two values of this type are equal
    pub eq_fn: EqFn,
}

impl VTable {
    pub fn new(
        size: usize,
        align: usize,
        clone_fn: Option<CloneFn>,
        drop_fn: Option<DropFn>,
        eq_fn: EqFn,
    ) -> Self {
        Self {
            size,
            align,
            clone_fn,
            drop_fn,
            eq_fn,
        }
    }

    pub fn layout(&self) -> std::alloc::Layout {
        std::alloc::Layout::from_size_align(self.size, self.align).unwrap()
    }

    pub fn size(&self) -> usize {
        self.size
    }

    pub fn align(&self) -> usize {
        self.align
    }
}