mirror of
https://github.com/krgamestudios/Toy.git
synced 2026-04-16 07:14:07 +10:00
Kayne Ruse
2e2bee4fa3
Basically, all Toy varaibles, functions, etc. are prepended with "Toy_", and macros are prepended with "TOY_". This is to reduce namespace pollution, which was an issue pointed out to be - blame @GyroVorbis. I've also bumped the minor version number - theoretically I should bump the major number, but I'm not quite ready for 1.0 yet.
57 lines
2.2 KiB
C
57 lines
2.2 KiB
C
#pragma once
|
|
|
|
#include "toy_common.h"
|
|
#include "toy_literal.h"
|
|
#include "toy_literal_array.h"
|
|
#include "toy_literal_dictionary.h"
|
|
#include "toy_scope.h"
|
|
|
|
typedef void (*Toy_PrintFn)(const char*);
|
|
|
|
//the interpreter acts depending on the bytecode instructions
|
|
typedef struct Toy_Interpreter {
|
|
//input
|
|
unsigned char* bytecode;
|
|
int length;
|
|
int count;
|
|
int codeStart; //BUGFIX: for jumps, must be initialized to -1
|
|
Toy_LiteralArray literalCache; //read-only - built from the bytecode, refreshed each time new bytecode is provided
|
|
|
|
//operation
|
|
Toy_Scope* scope;
|
|
Toy_LiteralArray stack;
|
|
|
|
//Library APIs
|
|
Toy_LiteralDictionary* hooks;
|
|
|
|
//debug outputs
|
|
Toy_PrintFn printOutput;
|
|
Toy_PrintFn assertOutput;
|
|
Toy_PrintFn errorOutput;
|
|
|
|
int depth; //don't overflow
|
|
bool panic;
|
|
} Toy_Interpreter;
|
|
|
|
//native API
|
|
typedef int (*Toy_NativeFn)(Toy_Interpreter* interpreter, Toy_LiteralArray* arguments);
|
|
TOY_API bool Toy_injectNativeFn(Toy_Interpreter* interpreter, char* name, Toy_NativeFn func);
|
|
|
|
typedef int (*Toy_HookFn)(Toy_Interpreter* interpreter, Toy_Literal identifier, Toy_Literal alias);
|
|
TOY_API bool Toy_injectNativeHook(Toy_Interpreter* interpreter, char* name, Toy_HookFn hook);
|
|
|
|
TOY_API bool Toy_callLiteralFn(Toy_Interpreter* interpreter, Toy_Literal func, Toy_LiteralArray* arguments, Toy_LiteralArray* returns);
|
|
TOY_API bool Toy_callFn(Toy_Interpreter* interpreter, char* name, Toy_LiteralArray* arguments, Toy_LiteralArray* returns);
|
|
|
|
//utilities for the host program
|
|
TOY_API bool Toy_parseIdentifierToValue(Toy_Interpreter* interpreter, Toy_Literal* literalPtr);
|
|
TOY_API void Toy_setInterpreterPrint(Toy_Interpreter* interpreter, Toy_PrintFn printOutput);
|
|
TOY_API void Toy_setInterpreterAssert(Toy_Interpreter* interpreter, Toy_PrintFn assertOutput);
|
|
TOY_API void Toy_setInterpreterError(Toy_Interpreter* interpreter, Toy_PrintFn errorOutput);
|
|
|
|
//main access
|
|
TOY_API void Toy_initInterpreter(Toy_Interpreter* interpreter); //start of program
|
|
TOY_API void Toy_runInterpreter(Toy_Interpreter* interpreter, unsigned char* bytecode, int length); //run the code
|
|
TOY_API void Toy_resetInterpreter(Toy_Interpreter* interpreter); //use this to reset the interpreter's environment between runs
|
|
TOY_API void Toy_freeInterpreter(Toy_Interpreter* interpreter); //end of program
|