diatom 0.5.2

The diatom programming 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

use crate::{gc::Gc, DiatomValue, IoWrite};

/// State of the virtual machine
pub struct State<'a, Buffer: IoWrite> {
    pub(crate) gc: &'a mut Gc<Buffer>,
}

impl<'a, Buffer: IoWrite> State<'a, Buffer> {
    /// Get string by string id
    ///
    /// Return None if id is invalid. If id is provided by parameters, it can never be invalid and
    /// thus is safe to unwrap.
    pub fn get_string_by_id(&self, id: usize) -> Option<&str> {
        self.gc.get_str(id)
    }

    /// Create a new string
    ///
    /// Return reference id to the string which can be put into `DiatomValue::Str()`.
    pub fn create_str(&mut self, s: String) -> usize {
        self.gc.alloc_str(s)
    }

    /// Get a mutable reference by reference id
    ///
    /// Return None if id is invalid. If id is provided by parameters, it can never be invalid and
    /// thus is safe to unwrap.
    pub fn get_obj_mut(&mut self, _ref_id: usize) -> Option<&mut DiatomObject> {
        todo!()
    }

    /// Same as `get_obj_mut` but this is immutable
    pub fn get_obj(&mut self, _ref_id: usize) -> Option<&DiatomObject> {
        todo!()
    }

    pub fn print(&self, value: &DiatomValue) -> String {
        self.gc.print(value)
    }
}

/// Heaped allocated object
pub enum DiatomObject {
    /// Native or Diatom Closure
    Closure,
    /// Table
    Table,
    /// Tuple
    Tuple,
}