repl_tools.h

This header provides a number of tools for compiling and running Toy, and is used primarily by the repl. However, it can also be modified and used by any host program with a little effort.

This is not a core part of Toy or a library, and as such repl_tools.h and repl_tools.c can both be found in the repl/ folder.

Defined Functions

const char* Toy_readFile(const char* path, size_t* fileSize)

This function reads in a file, and returns it as a constant buffer. It also sets the variable pointed to by fileSize to the size of the given buffer.

On error, this function returns NULL.

int Toy_writeFile(const char* path, const unsigned char* bytes, size_t size)

This function writes the buffer pointed to by bytes to a file specified by path. The buffer’s size should be specified by size.

On error, this function returns a non-zero value.

const unsigned char* Toy_compileString(const char* source, size_t* size)

This function takes a cstring of Toy source code, and returns a compiled buffer based on that source code. The variable pointed to by size is set to the size of the bytecode.

On error, this function returns NULL.

void Toy_runBinary(const unsigned char* tb, size_t size)

This function takes a bytecode array of size size, and executes it. The libraries available to the code are currently:

• lib_about
• lib_standard
• lib_random
• lib_runner

void Toy_runBinaryFile(const char* fname)

This function loads in the binary file specified by fname, and passes it to Toy_runBinary().

void Toy_runSource(const char* source)

This function compiles the source with Toy_compileString(), and passes it to Toy_runBinary().

void Toy_runSourceFile(const char* fname)

This function loads in the file specified by fname, compiles it, and passes it to Toy_runBinary().

void Toy_parseBinaryFileHeader(const char* fname)

This function parses the header information stored within the bytecode file fname.

This is only used for debugging and validation purposes.