100 lines
2.4 KiB
C
100 lines
2.4 KiB
C
#ifndef LIBABACUS_LEXER_H
|
|
#define LIBABACUS_LEXER_H
|
|
|
|
#include "eval.h"
|
|
#include "result.h"
|
|
|
|
/**
|
|
* The lexer used for reading
|
|
* a string and converting it into
|
|
* tokens.
|
|
*/
|
|
struct libab_lexer_s {
|
|
/**
|
|
* The liblex configuration used
|
|
* to convert the string into tokens.
|
|
*/
|
|
eval_config config;
|
|
};
|
|
|
|
/**
|
|
* A token that is produced by the lexer.
|
|
*/
|
|
struct libab_lexer_match_s {
|
|
/**
|
|
* The line that this token was found on.
|
|
*/
|
|
size_t line;
|
|
/**
|
|
* The first index at which this token's string
|
|
* begins.
|
|
*/
|
|
size_t from;
|
|
/**
|
|
* The index of the first character that is outside
|
|
* this token.
|
|
*/
|
|
size_t to;
|
|
/**
|
|
* The index of the beginning of the line on which
|
|
* this token is found.
|
|
*/
|
|
size_t line_from;
|
|
/**
|
|
* The type of token.
|
|
*/
|
|
int type;
|
|
};
|
|
|
|
/**
|
|
* The various tokens used by the lexer
|
|
* in order to tag meaningful sequences
|
|
* of characters.
|
|
*/
|
|
enum libab_lexer_token_e {
|
|
TOKEN_CHAR = 0,
|
|
TOKEN_ID,
|
|
TOKEN_NUM,
|
|
TOKEN_OP_INFIX,
|
|
TOKEN_OP_PREFIX,
|
|
TOKEN_OP_POSTFIX,
|
|
TOKEN_KW_IF,
|
|
TOKEN_KW_ELSE,
|
|
TOKEN_LAST
|
|
};
|
|
|
|
typedef struct libab_lexer_s libab_lexer;
|
|
typedef enum libab_lexer_token_e libab_lexer_token;
|
|
typedef struct libab_lexer_match_s libab_lexer_match;
|
|
|
|
/**
|
|
* Initializes the given lexer,
|
|
* placing the default tokens into it.
|
|
* @param lexer the lexer to intiailize.
|
|
* @return the result of the operation (can be MALLOC on failed allocation.)
|
|
*/
|
|
libab_result libab_lexer_init(libab_lexer* lexer);
|
|
/**
|
|
* Turns the given input string into tokens.
|
|
* @param lexer the lexer to use to turn the string into tokens.
|
|
* @param string the string to turn into tokens.
|
|
* @param lex_into the list which should be populated with matches.
|
|
* @return the result of the operation.
|
|
*/
|
|
libab_result libab_lexer_lex(libab_lexer* lexer, const char* string, ll* lext_into);
|
|
/**
|
|
* Releases the memory associated with the given lexer,
|
|
* removing all registered patterns from it.
|
|
* @param lexer the lexer to free.
|
|
* @return the result of the operation.
|
|
*/
|
|
libab_result libab_lexer_free(libab_lexer* lexer);
|
|
/**
|
|
* Function intended to be passed to "foreach" calls
|
|
* in libds. lexer_lex allocates matches, and passing this function
|
|
* to foreach will free the memory allocated for the matches.
|
|
*/
|
|
int libab_lexer_foreach_match_free(void* data, va_list args);
|
|
|
|
#endif
|