xmachine 0.2.1

A fast, cross platform virtual machine implemented in Rust without the Standard Library
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

extern crate xmachine;
use xmachine::{Machine, Value};

#[cfg(test)]
mod function_tests {
    use super::*;

    /// Tests that functions can return values to the stack
    #[test]
    fn function_return() {
        // Test single return value
        let mut m = Machine::new();
        m.push(Value::function(
            |m: &mut Machine| {
                m.push(Value::number(5));
            },
            &m,
        ));
        m.call();

        assert_eq!(m.stack, vec![Value::number(5)]);

        // Test multiple return values
        let mut m = Machine::new();
        m.push(Value::function(
            |m: &mut Machine| {
                m.push(Value::number(5));
                m.push(Value::string("whoa"));
                m.push(Value::tree());
            },
            &m,
        ));
        m.call();

        assert_eq!(
            m.stack,
            vec![Value::number(5), Value::string("whoa"), Value::tree()]
        );
    }

    /// This function tests the ability to pass a copy to a
    /// function and mutate it while not changing the original
    #[test]
    fn function_copy() {
        let mut m = Machine::new();

        // Store `yo yo yo` in `test`
        m.push(Value::string("yo yo yo"));
        m.push(Value::string("test"));
        m.store();
        // Store call function with argument 5
        m.push(Value::number(5));
        m.push(Value::function(
            |m: &mut Machine| {
                // Load `test` from global scope
                m.push(Value::string("test"));
                m.load();
                // Copy item on stack to remove reference
                m.copy();
                // Assign to the COPY's location in memory!
                m.assign();
            },
            &m,
        ));
        m.call();

        assert_eq!(
            m.registers[&String::from("test")],
            Value::string("yo yo yo")
        );
    }
}