150 lines
4.9 KiB
C
150 lines
4.9 KiB
C
#ifndef LIBABACUS_H
|
|
#define LIBABACUS_H
|
|
|
|
#include "custom.h"
|
|
#include "ht.h"
|
|
#include "lexer.h"
|
|
#include "parser.h"
|
|
#include "interpreter.h"
|
|
#include "result.h"
|
|
#include "table.h"
|
|
#include "impl.h"
|
|
|
|
/**
|
|
* The main struct of libabacus,
|
|
* which essentially holds all the informatiom
|
|
* for the library's state and operation.
|
|
*/
|
|
struct libab_s {
|
|
/**
|
|
* The lexer used to convert a string
|
|
* to tokens.
|
|
*/
|
|
libab_lexer lexer;
|
|
/**
|
|
* The parser used to convert
|
|
* tokens to a tree.
|
|
*/
|
|
libab_parser parser;
|
|
/**
|
|
* The interpreter used
|
|
* to run a tree.
|
|
*/
|
|
libab_interpreter intr;
|
|
|
|
/**
|
|
* The table used to store top-level
|
|
* things like functions and operators.
|
|
*/
|
|
libab_ref table;
|
|
|
|
/**
|
|
* The allocator used to construct number instances.
|
|
*/
|
|
libab_impl impl;
|
|
|
|
/**
|
|
* The number type instance.
|
|
*/
|
|
libab_ref type_num;
|
|
/**
|
|
* The function list type instance.
|
|
*/
|
|
libab_ref type_function_list;
|
|
|
|
/**
|
|
* Internal; the number basetype. This cannot be a static
|
|
* variable like other built-in types because it has a free function
|
|
* specified by the user.
|
|
*/
|
|
libab_basetype basetype_num;
|
|
};
|
|
|
|
typedef struct libab_s libab;
|
|
|
|
/**
|
|
* Initializes the libabacus struct as well
|
|
* as all its internal structures such as the lexer.
|
|
* @param ab the libabacus instance used to keep state.
|
|
* @param parse_function function used to parse a number.
|
|
* @param free_function function used to free the parsed number.
|
|
* @return the result of the initialization.
|
|
*/
|
|
libab_result libab_init(libab* ab, void* (*parse_function)(const char*),
|
|
void (*free_function)(void*));
|
|
/**
|
|
* Registers an operator with libabacus.
|
|
* @param ab the libabacus instance to reigster the operator with.
|
|
* @param op the operator string to register.
|
|
* @param precedence the precedence of the operator.
|
|
* @param associativity the associativity of the operator.
|
|
* @param type the type of this operator.
|
|
* @param func the function that describes the functionality of the operator.
|
|
* @return the result of the initialization.
|
|
*/
|
|
libab_result libab_register_operator_infix(libab* ab, const char* op,
|
|
int precedence, int associativity,
|
|
libab_ref* type,
|
|
libab_function_ptr func);
|
|
/**
|
|
* Registers an operation with libabacus that appears
|
|
* before its operand.
|
|
* @param ab the libabacus instance to register the operator with.
|
|
* @param op the operator string to register.
|
|
* @param type the type of this operator.
|
|
* @param func the function that describes the functionality of the operator.
|
|
* @return the result of the registration.
|
|
*/
|
|
libab_result libab_register_operator_prefix(libab* ab, const char* op,
|
|
libab_ref* type,
|
|
libab_function_ptr func);
|
|
/**
|
|
* Registers an operation with libabacus that appears
|
|
* after its operand.
|
|
* @param ab the libabacus instance to register the operator with.
|
|
* @param op the operator string to register.
|
|
* @param type the type of this operator.
|
|
* @param func the function that describes the functionality of the operator.
|
|
* @return the result of the registration.
|
|
*/
|
|
libab_result libab_register_operator_postfix(libab* ab, const char* op,
|
|
libab_ref* type,
|
|
libab_function_ptr func);
|
|
|
|
/**
|
|
* Registers a function with libabacus.
|
|
* @param ab the libabacus instance used to keep state.
|
|
* @param name the name of the function.
|
|
* @param type the type of this operator.
|
|
* @param func the function that describes the functionality of the function.
|
|
* @return the result of the registration.
|
|
*/
|
|
libab_result libab_register_function(libab* ab, const char* name,
|
|
libab_ref* type, libab_function_ptr func);
|
|
/**
|
|
* Registers a base type with abacus.
|
|
* @param ab the libabacus instance used to keep state.
|
|
* @param name the name to register the basetype under.
|
|
* @param basetype the basetype to register.
|
|
* @return the result of the registration.
|
|
*/
|
|
libab_result libab_register_basetype(libab* ab, const char* name,
|
|
libab_basetype* basetype);
|
|
/**
|
|
* Constructs and resolves a parse type, similarly to how it's done in the
|
|
* parser.
|
|
* @param ab the libab instance to use for constructing the type.
|
|
* @param into the reference to populate with the given type.
|
|
* @param type the type to parse.
|
|
* @return the result of the operation.
|
|
*/
|
|
libab_result libab_create_type(libab* ab, libab_ref* into, const char* type);
|
|
/**
|
|
* Releases all the resources allocated by libabacus.
|
|
* @param ab the libabacus instance to release.
|
|
* @return the result of the initialization.
|
|
*/
|
|
libab_result libab_free(libab* ab);
|
|
|
|
#endif
|