136 lines
3.4 KiB
C
136 lines
3.4 KiB
C
#ifndef ARC_STD_PARSER_H_
|
|
#define ARC_STD_PARSER_H_
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include "arc/std/array.h"
|
|
//#include "arc/std/bool.h"
|
|
#include "arc/std/lexer.h"
|
|
#include <stdint.h>
|
|
|
|
/**
|
|
* @brief a parser type
|
|
*/
|
|
typedef struct ARC_Parser ARC_Parser;
|
|
|
|
/**
|
|
* @brief TODO: write this
|
|
*/
|
|
typedef void (* ARC_ParserData_CreateFn)(void **data);
|
|
|
|
/**
|
|
* @brief TODO: write this
|
|
*/
|
|
typedef void (* ARC_ParserData_DestroyFn)(void *data);
|
|
|
|
/**
|
|
* @brief TODO: write this
|
|
*/
|
|
typedef void (* ARC_ParserLanguageTag_AddDataFn)(void **data, uint32_t tagId, ARC_LexerToken *token, void *userData);
|
|
|
|
/**
|
|
* @brief a langue tag type for the parser //TODO: explain this better
|
|
*/
|
|
typedef struct ARC_ParserLanguageTag {
|
|
uint32_t tagId;
|
|
|
|
uint32_t **tokensOrTags;
|
|
uint32_t tokensOrTagsSize;
|
|
|
|
ARC_ParserLanguageTag_AddDataFn *addDataFn;
|
|
void *addUserData;
|
|
} ARC_ParserLanguageTag;
|
|
|
|
/**
|
|
* @brief a callback function to initialize the lexer the parser uses with rules
|
|
*
|
|
* @param lexer the lexer used by the parser that rules should be added to
|
|
*/
|
|
typedef void (* ARC_Parser_InitLexerRulesFn)(ARC_Lexer *lexer);
|
|
|
|
/**
|
|
* @brief creates an ARC_Parser type
|
|
*
|
|
* @TODO: fix this documentation to reflect changes
|
|
*
|
|
* @TODO: probs want to move the note to another file
|
|
* @note array of tokens for langauge? like
|
|
* ARC_ParserTag tag = {
|
|
* VARIABLE_NAME, //tagId
|
|
* {
|
|
* { 2, CHAR_OR_NUM, VARIABLE_NAME },
|
|
* { 1, LAMBDA },
|
|
* }, //components
|
|
* 2 //componentsSize
|
|
* };
|
|
*
|
|
* @param[out] parser ARC_Parser to create
|
|
* @param[in] language an arry of ARC_ParserLanguageTags defining a langauge
|
|
* @param[in] initLexerRulesFn a callback used to initalize the token rules the lexer within the parser will use
|
|
*/
|
|
void ARC_Parser_Create(ARC_Parser **parser, ARC_Array *language, ARC_Parser_InitLexerRulesFn initLexerRulesFn, ARC_ParserData_CreateFn *createDataFn, ARC_ParserData_DestroyFn *destroyDataFn);
|
|
|
|
/**
|
|
* @brief creates an ARC_Parser type from a string
|
|
*
|
|
* @TODO: probs want to move the note to another file
|
|
* @note the syntax looks like:
|
|
* <variable> -> CHAR <variableName> EOF
|
|
* <variableName> -> <charOrNum> <variableName> | LAMBDA
|
|
* <charOrNum> -> CHAR | NUM
|
|
*
|
|
* @param[out] parser ARC_Parser to create
|
|
* @param[in] language an arry of ARC_ParserLanguageTags defining a langauge
|
|
* @param[in] initLexerRulesFn a callback used to initalize the token rules the lexer within the parser will use
|
|
*/
|
|
void ARC_Parser_CreateFromString(ARC_Parser **parser, ARC_String *languageString, ARC_Parser_InitLexerRulesFn initLexerRulesFn);
|
|
|
|
/**
|
|
* @brief destroys an ARC_Parser type
|
|
*
|
|
* @param[in] parser ARC_Parser to free
|
|
*/
|
|
void ARC_Parser_Destroy(ARC_Parser *parser);
|
|
|
|
/**
|
|
* @brief
|
|
*
|
|
* @param[in] parser
|
|
* @param[in/out] data the string to parse, will be freed and set to NULL by the end of this function
|
|
*/
|
|
void ARC_Parser_Parse(ARC_Parser *parser, ARC_String **data);
|
|
|
|
/**
|
|
* @brief
|
|
*
|
|
* @param[in] parser
|
|
* @param[in] language
|
|
*/
|
|
void ARC_Parser_ParseFile(ARC_Parser *parser, ARC_String *path);
|
|
|
|
/**
|
|
* @brief
|
|
*
|
|
* @param[in] parser
|
|
*/
|
|
void ARC_Parser_ClearData(ARC_Parser *parser);
|
|
|
|
/**
|
|
* @brief
|
|
*
|
|
* @param[in] parser
|
|
*/
|
|
void *ARC_Parser_GetData(ARC_Parser *parser);
|
|
|
|
/**
|
|
* @brief basic tag for letting the parser know it is ok to end
|
|
*/
|
|
#define ARC_PARSER_TAG_LAMBDA 0
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif // !ARC_STD_PARSER_H_
|