passerine 0.7.2

A small extensible programming language designed for concise expression with little 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

/// This enum represents a single opcode.
/// Under the hood, it's just a byte.
/// This allows non opcode bytes to be inserted in bytecode streams.
#[repr(u8)]
#[derive(Debug)]
pub enum Opcode {
    /// Load a constant.
    Con = 0,
    /// Delete a value off the stack.
    Del = 1,
    /// Moves a variable onto the heap.
    Capture = 2,
    /// Save a constant into a variable.
    Save = 3,
    /// Save a value to a captured variable.
    SaveCap = 4,
    /// Push a copy of a variable onto the stack.
    Load = 5,
    /// Load a copy of a captured variable.
    LoadCap = 6,
    /// Call a function.
    Call = 7,
    /// Return from a function.
    Return = 8,
    /// Creates a closure over the current local environment.
    Closure = 9,
    /// Prints a value.
    Print = 10,
}

impl Opcode {
    /// Convert a raw byte to an opcode.
    /// Note that non-opcode bytes should never be interpreted as an opcode.
    /// Under the hood, this is just a transmute, so the regular cautions apply.
    /// This *should* never cause a crash
    /// and if it does, the vm's designed to crash hard
    /// so it'll be pretty obvious.
    pub fn from_byte(byte: u8) -> Opcode {
        unsafe { std::mem::transmute(byte) }
    }
}