oxygenlance 1.0.5

A simple crate to run BF Joust matches 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

#ifndef INTERFACE_H
#define INTERFACE_H 1

#include <stddef.h>

#include "consts.h"

struct gearlance_compile_input {
    const char* data; // borrowed
    size_t length;
};

struct gearlance_compiled_program;

struct gearlance_compile_result {
    bool error_encountered;
    const char* err_msg; // static
    struct gearlance_compiled_program *program; // owned
};

struct gearlance_execute_input {
    struct gearlance_compiled_program *program_left; // borrowed
    struct gearlance_compiled_program *program_right; // borrowed
    bool track_stats;
};

enum gearlance_end_type {
    gearlance_end_time,
    gearlance_end_flag,
    gearlance_end_tape,
    gearlance_end_unknown, // should never happen
};

struct gearlance_execute_result {
    int scores[2][MAXTAPE+1];
    enum gearlance_end_type end_type[2][MAXTAPE+1];
    unsigned long long cycles;
    unsigned char tape_max[2][MAXTAPE];
    unsigned heat_position[2][MAXTAPE];
};

extern struct gearlance_compile_result gearlance_compile(struct gearlance_compile_input input);
extern void gearlance_execute(struct gearlance_execute_input input, struct gearlance_execute_result* output);
extern void gearlance_free_program(struct gearlance_compiled_program *program);

#endif