Struct Code

pub struct Code<T> {
    pub symbols: Vec<(usize, String)>,
    pub code: Vec<usize>,
    pub data: Vec<T>,
    pub labels: Vec<(usize, String)>,
}

A structure containing runnable or dumpable code.

See the module-level docs for more details.

Fields

symbols: Vec<(usize, String)>

code: Vec<usize>

data: Vec<T>

labels: Vec<(usize, String)>

Implementations

impl<T: Debug> Code<T>

pub fn empty() -> Code<T>

Create an empty code.

Not useful for anything except tests and documentation.

pub fn symbols(&self) -> &[(usize, String)]

Retrieve a list of all symbols in the code.

This is a list of tuples containing op codes and instruction names.

pub fn code(&self) -> &[usize]

Retrieve a list of instructions in the code.

This is the executable source program of the code. It is a simple format based around the following:

| Op Code | No of args | Args ...         |
| 0x01    | 0x03       | 0x01, 0x02, 0x03 |

pub fn data(&self) -> &[T]

Retrieve the constant data compiled into the code.

pub fn labels(&self) -> &[(usize, String)]

Retrieve a list of labels used in the program.

Returns a list of tuples containing the IP of the label and the name of the label.

pub fn get_label_ip(&self, name: &str) -> Option<usize>

Returns the IP for a given label.

This function is used within the Machine to perform jumps.

Trait Implementations

impl<T: Debug> Debug for Code<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a, T: Debug + PartialEq> From<Builder<'a, T>> for Code<T>

fn from(builder: Builder<'_, T>) -> Code<T>

Convert a Builder into Code.

This function consumes the builder and returns a Code.

impl<T: FromByteCode + Debug> FromByteCode for Code<T>

fn from_byte_code(buf: &mut dyn Read) -> Code<T>

Convert from MsgPack to your type.

impl<T: ToByteCode + Debug> ToByteCode for Code<T>

fn to_byte_code(&self, buf: &mut dyn Write)

Create bytecode for this Code.

Encodes into a Map of the following format:

{
    "code" => [ 0, 1, 0, 0, 1, 1, 1, 0 ],
    "data" => [ 123, 456 ],
    "symbols" => [ 0, "push", 1, "add" ],
    "labels" => [ 0, "main" ]
}