liblex/include/eval.h
Danila Fedorin 0b6d73ebdf Write initial code for matching the patterns to a single string.
The code is limited in two aspects, at the moment:
* It's not very well tested
* The current "best" match is just the one that occurred last. While
this is just fine in terms of length, this leaves open to chance which
pattern type will be returned if multiple patterns of the same length
match.
2017-02-04 00:28:36 -08:00

120 lines
3.0 KiB
C

#ifndef LIBLEX_EVAL_H
#define LIBLEX_EVAL_H
#include "pattern.h"
#include "pairmap.h"
#include "ll.h"
/**
* A pattern match.
* During lexing / evaluation, structs of this type
* are used to represent "matched" hypohteses.
*/
struct match_s {
int from;
int to;
int pattern;
};
/**
* Used in matching a single word / lexeme / etc
* from some input.
*/
struct eval_s {
/**
* The input being evaluated.
*/
char* string;
/**
* The current index in the input.
*/
int index;
/**
* The index where the valuation began.
*/
int begin;
/**
* The number of nodes / states matched in
* the last iteration.
*/
int matched;
/**
* Set A of the two sets of pattern nodes / states.
*/
ht set_a;
/**
* Set B of the two sets of pattern nodes / states.
*/
ht set_b;
/**
* The matches that were found so far.
*/
ll matches;
/**
* The current set of states.
*/
ht* set_current;
/**
* The next set of states.
*/
ht* set_next;
};
/**
* Configuration for evaluation.
* This contains a list of states that should be started with when
* the evaluation of a single token begins.
*/
struct eval_config_s {
/**
* The inital list of states to be checked.
*/
ll states;
};
typedef struct match_s match;
typedef struct eval_s eval;
typedef struct eval_config_s eval_config;
/**
* Initializes the evaluation configuration.
* @param config the configuration to initialize.
*/
void eval_config_init(eval_config* config);
/**
* Frees data allocated by an evaluation configuration.
* @param config the configuration file to free.
* @return LIBLEX_SUCCESS if all goes well, or LIBLEX_MALLC if there was an allocaton failure.
*/
liblex_result eval_config_free(eval_config* config);
/**
* Adds a new pattern to the configuration, with a given pattern ID.
* @param config the configuration to add the pattern to.
* @param pattern the pattern to add
* @param pattern_id the id to associate with the pattern
* @return LIBLEX_SUCCESS if all goes well, or LIBLEX_MALLOC if there was an allocation failure.
*/
liblex_result eval_config_add(eval_config* config, char* pattern, int pattern_id);
/**
* Evaluates / finds a single word.
* @param string the string to evaluate.
* @param index the index to start at.
* @param config the configuration to use
* @param match pointer to where to store the newly created match.
* @return LIBLEX_SUCCESS if all goes well, or LIBLEX_MALLOC if there was an allocation failure.
*/
liblex_result eval_word(char* string, int index, eval_config* config, match* match);
/**
* Evaluates input starting at the index until it reaches the null terminator,
* adding the best matches to the linked list.
* @param string the string to evaluate.
* @param index the index to start at
* @param config the config to use
* @param matches the linked list to populate with matches
* @return LIBLEX_SUCCESS if all goes well, or LIBLEX_MALLOC if there was an allocation failure.
*/
liblex_result eval_all(char* string, int index, eval_config* config, ll* matches);
#endif