kaon 0.1.4

A little scripting language written in rust
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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

use std::rc::Rc;

use crate::common::{Closure, Value};

#[derive(Clone, Debug)]
pub struct Frame {
    pub closure: Rc<Closure>,
    pub ip: usize,
    pub base_ip: usize,
}

impl Frame {
    pub fn new(closure: Rc<Closure>, ip: usize, base_ip: usize) -> Self {
        Frame {
            closure,
            ip,
            base_ip,
        }
    }
}

#[derive(Debug, Default)]
pub struct Stack {
    pub stack: Vec<Value>,
}

impl Stack {
    pub fn new() -> Self {
        Stack { stack: vec![] }
    }

    /// Pop a [Value] from the stack.
    #[inline]
    pub fn pop(&mut self) -> Value {
        self.stack.pop().expect("Stack should not be empty")
    }

    /// Push a [Value] from the stack.
    #[inline]
    pub fn push(&mut self, value: Value) {
        self.stack.push(value);
    }

    /// Lookup a [Value] on the stack.
    #[inline]
    pub fn peek(&self) -> Value {
        self.stack[self.stack.len() - 1].clone()
    }

    #[inline]
    pub fn set(&mut self, idx: usize, value: Value) {
        self.stack[idx] = value;
    }

    #[inline]
    pub fn get(&mut self, idx: usize) -> Value {
        self.stack[idx].clone()
    }

    #[inline]
    pub fn save_local(&mut self, idx: usize, value: Value) {
        self.stack[idx] = value;
    }

    /// Look backwards into the stack.
    #[inline]
    pub fn peek_backwards(&self, index: usize) -> &Value {
        &self.stack[self.stack.len() - index]
    }

    /// Prints the current stack to stdout.
    pub fn debug_stack(&self) {
        if self.stack.is_empty() {
            println!("[]");
        } else {
            println!(
                "{}",
                &self
                    .stack
                    .iter()
                    .map(|s| format!("[ {} ]", s))
                    .collect::<Vec<String>>()
                    .join("")
            );
        }
    }

    /// Clear the stack.
    #[inline]
    pub fn clear(&mut self) {
        self.stack.clear();
    }

    /// Helper method for getting the stack's length.
    #[inline]
    pub fn len(&self) -> usize {
        self.stack.len()
    }

    /// Check if the stack is empty.
    #[inline]
    pub fn is_empty(&self) -> bool {
        self.stack.is_empty()
    }

    /// Shorten the stack by the given size.
    #[inline]
    pub fn truncate(&mut self, size: usize) {
        self.stack.truncate(size);
    }
}