182 lines
3.6 KiB
C
182 lines
3.6 KiB
C
#ifndef LIBLEX_PATTERN_H
|
|
#define LIBLEX_PATTERN_H
|
|
|
|
#include "liblex.h"
|
|
|
|
/**
|
|
* Enum that represents the type
|
|
* of a NFA node / state.
|
|
*/
|
|
enum pattern_node_type_e {
|
|
/**
|
|
* Represents a clear, un-configured node.
|
|
*/
|
|
PNODE_CLEAR,
|
|
/**
|
|
* Represents a single value to be matched.
|
|
*/
|
|
PNODE_VALUE,
|
|
/**
|
|
* Represents a range of values, inclusive.
|
|
*/
|
|
PNODE_RANGE,
|
|
/**
|
|
* Represents any character other than the NULL terminator.
|
|
*/
|
|
PNODE_ANY,
|
|
/**
|
|
* Represents a "connection" between nodes, does not
|
|
* match any value.
|
|
* */
|
|
PNODE_CONNECT,
|
|
/**
|
|
* Represents a fork / divide in possible "next" states.
|
|
*/
|
|
PNODE_FORK,
|
|
/**
|
|
* Represents a succesfully matched pattern.
|
|
*/
|
|
PNODE_END
|
|
};
|
|
|
|
/**
|
|
* Struct representing a single NFA node / state.
|
|
*/
|
|
struct pattern_node_s {
|
|
/**
|
|
* The type of this node.
|
|
*/
|
|
enum pattern_node_type_e type;
|
|
/**
|
|
* The id of this node.
|
|
* The id is unique within the pattern.
|
|
*/
|
|
int id;
|
|
/**
|
|
* The id of the pattern that this node belongs to.
|
|
*/
|
|
int pattern_id;
|
|
|
|
/**
|
|
* The node's data that varies based on type.
|
|
*/
|
|
union {
|
|
/**
|
|
* Data for a "value" node.
|
|
*/
|
|
struct {
|
|
/**
|
|
* The value this node matches.
|
|
*/
|
|
char value;
|
|
/**
|
|
* The next state in the pattern.
|
|
*/
|
|
struct pattern_node_s* next;
|
|
} value_s;
|
|
|
|
/**
|
|
* Data for a "range" node.
|
|
*/
|
|
struct {
|
|
/**
|
|
* The beginning of the range, inclusive, of matched values.
|
|
*/
|
|
char from;
|
|
/**
|
|
* The end of the range, inclusive, of matched values.
|
|
*/
|
|
char to;
|
|
/**
|
|
* The next state in the pattern.
|
|
*/
|
|
struct pattern_node_s* next;
|
|
} range_s;
|
|
|
|
/**
|
|
* Data for an "any" node.
|
|
*/
|
|
struct {
|
|
/**
|
|
* The next state in the pattern.
|
|
*/
|
|
struct pattern_node_s* next;
|
|
} any_s;
|
|
|
|
/**
|
|
* Data for a "connect" node.
|
|
*/
|
|
struct {
|
|
/**
|
|
* The next node in the pattern.
|
|
*/
|
|
struct pattern_node_s* next;
|
|
} connect_s;
|
|
|
|
/**
|
|
* Data for a "fork" node.
|
|
*/
|
|
struct {
|
|
/**
|
|
* The left node in the fork.
|
|
*/
|
|
struct pattern_node_s* left;
|
|
/**
|
|
* The right node in the fork.
|
|
*/
|
|
struct pattern_node_s* right;
|
|
} fork_s;
|
|
} data_u;
|
|
};
|
|
|
|
/**
|
|
* A chain of pattern nodes.
|
|
*/
|
|
struct pattern_chain_s {
|
|
/**
|
|
* The beginning of the chain, its first state.
|
|
*/
|
|
struct pattern_node_s* head;
|
|
/**
|
|
* The end of the chain, its last state.
|
|
*/
|
|
struct pattern_node_s* tail;
|
|
};
|
|
|
|
/**
|
|
* Represents a single compiled pattern.
|
|
*/
|
|
struct pattern_s {
|
|
/**
|
|
* The first NFA state of the pattern.
|
|
*/
|
|
struct pattern_node_s* head;
|
|
/**
|
|
* The number of NFA nodes in this pattern.
|
|
*/
|
|
int size;
|
|
};
|
|
|
|
typedef enum pattern_node_type_e pattern_node_type;
|
|
typedef struct pattern_node_s pattern_node;
|
|
typedef struct pattern_chain_s pattern_chain;
|
|
typedef struct pattern_s pattern;
|
|
|
|
/**
|
|
* Compiles a string representation of a pattern into a pattern NFA,
|
|
* and stores the first node of the new NFA in root.
|
|
* @param root the node to store the resulting pattern into.
|
|
* @param expression the pattern represented as a string.
|
|
* @param id the id of the pattern.
|
|
* @return LIBLEX_SUCCESS if all goes well, otherwise some other liblex_result.
|
|
*/
|
|
liblex_result pattern_compile(pattern* ptrn, const char* expression, int id);
|
|
/**
|
|
* Frees a pattern NFA allocated by pattern_compile.
|
|
* @param root the root node to start freeing from.
|
|
* @return LIBLEX_SUCCESS if all goes well, otherwise some other liblex_result.
|
|
*/
|
|
liblex_result pattern_free(pattern* ptrn);
|
|
|
|
#endif
|