nilang 0.4.1

A scripting language interpreter for Advent of Code
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
112
113
114
115

use crate::spanned::{PackedSpans, Span};
use crate::runtime::ByteCode;

#[derive(Debug, PartialEq)]
pub enum Local {
    FuncId(u32),
    Sym(u32),
    Int(i64),
    Float(f64),
    String(String),
}

#[derive(Debug)]
pub struct Func {
    id: u32,
    auto_binds: bool,
    arg_count: u8,
    max_clique: u8,
    locals: Vec<Local>,
    instrs: Vec<ByteCode>,
    spans: PackedSpans,
}

impl Func {
    pub fn new(id: u32, auto_binds: bool, arg_count: u8, max_clique: u8) -> Self {
        Self {
            id,
            auto_binds,
            arg_count,
            max_clique,
            locals: vec![],
            instrs: vec![],
            spans: PackedSpans::new(),
        }
    }

    pub fn id(&self) -> u32 {
        self.id
    }

    pub fn spans(&self) -> &PackedSpans {
        &self.spans
    }

    pub fn arg_count(&self) -> u8 {
        self.arg_count
    }

    pub fn max_clique(&self) -> u8 {
        self.max_clique
    }

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

    pub fn get_locals(&self) -> &Vec<Local> {
        &self.locals
    }

    pub fn get_local(&self, local: &Local) -> Option<u16> {
        self.locals
            .iter()
            .position(|l| l == local)
            .map(|id| u16::try_from(id).unwrap())
    }

    pub fn push_local(&mut self, local: Local) -> u16 {
        let id = self.locals.len();
        self.locals.push(local);
        u16::try_from(id).unwrap()
    }

    pub fn push_instr(&mut self, instr: ByteCode) {
        self.instrs.push(instr)
    }

    pub fn get_instrs(&self) -> &Vec<ByteCode> {
        &self.instrs
    }

    pub fn get_instrs_mut(&mut self) -> &mut Vec<ByteCode> {
        &mut self.instrs
    }

    pub fn push_instr_spanned(&mut self, instr: ByteCode, span: Option<Span>) {
        let i = self.len();

        self.instrs.push(instr);

        if let Some(s) = span {
            self.spans.push(s, i);
        }
    }

    pub fn to_string(&self) -> String {
        let mut result = String::new();

        result.push_str(&format!("=== FN {} START ===\n", self.id));
        for instr in self.instrs.iter() {
            let s = format!("{instr}");

            result.push_str(&s);
            result.push('\n');
        }

        result.push_str("=== END ===\n");

        result
    }

    pub fn auto_binds(&self) -> bool {
        self.auto_binds
    }
}