diff options
Diffstat (limited to 'include')
| -rw-r--r-- | include/slre.h | 100 | 
1 files changed, 100 insertions, 0 deletions
| diff --git a/include/slre.h b/include/slre.h new file mode 100644 index 000000000..4b41a4b27 --- /dev/null +++ b/include/slre.h @@ -0,0 +1,100 @@ +/* + * Copyright (c) 2004-2005 Sergey Lyubka <valenok@gmail.com> + * All rights reserved + * + * "THE BEER-WARE LICENSE" (Revision 42): + * Sergey Lyubka wrote this file.  As long as you retain this notice you + * can do whatever you want with this stuff. If we meet some day, and you think + * this stuff is worth it, you can buy me a beer in return. + */ + +/* + * Downloaded Sat Nov  5 17:42:08 CET 2011 at + * http://slre.sourceforge.net/1.0/slre.h + */ + +/* + * This is a regular expression library that implements a subset of Perl RE. + * Please refer to http://slre.sourceforge.net for detailed description. + * + * Usage example (parsing HTTP request): + * + * struct slre	slre; + * struct cap	captures[4 + 1];  // Number of braket pairs + 1 + * ... + * + * slre_compile(&slre,"^(GET|POST) (\S+) HTTP/(\S+?)\r\n"); + * + * if (slre_match(&slre, buf, len, captures)) { + *	printf("Request line length: %d\n", captures[0].len); + *	printf("Method: %.*s\n", captures[1].len, captures[1].ptr); + *	printf("URI: %.*s\n", captures[2].len, captures[2].ptr); + * } + * + * Supported syntax: + *	^		Match beginning of a buffer + *	$		Match end of a buffer + *	()		Grouping and substring capturing + *	[...]		Match any character from set + *	[^...]		Match any character but ones from set + *	\s		Match whitespace + *	\S		Match non-whitespace + *	\d		Match decimal digit + *	\r		Match carriage return + *	\n		Match newline + *	+		Match one or more times (greedy) + *	+?		Match one or more times (non-greedy) + *	*		Match zero or more times (greedy) + *	*?		Match zero or more times (non-greedy) + *	?		Match zero or once + *	\xDD		Match byte with hex value 0xDD + *	\meta		Match one of the meta character: ^$().[*+?\ + */ + +#ifndef SLRE_HEADER_DEFINED +#define	SLRE_HEADER_DEFINED + +/* + * Compiled regular expression + */ +struct slre { +	unsigned char	code[256]; +	unsigned char	data[256]; +	int		code_size; +	int		data_size; +	int		num_caps;	/* Number of bracket pairs	*/ +	int		anchored;	/* Must match from string start	*/ +	const char	*err_str;	/* Error string			*/ +}; + +/* + * Captured substring + */ +struct cap { +	const char	*ptr;		/* Pointer to the substring	*/ +	int		len;		/* Substring length		*/ +}; + +/* + * Compile regular expression. If success, 1 is returned. + * If error, 0 is returned and slre.err_str points to the error message. + */ +int slre_compile(struct slre *, const char *re); + +/* + * Return 1 if match, 0 if no match. + * If `captured_substrings' array is not NULL, then it is filled with the + * values of captured substrings. captured_substrings[0] element is always + * a full matched substring. The round bracket captures start from + * captured_substrings[1]. + * It is assumed that the size of captured_substrings array is enough to + * hold all captures. The caller function must make sure it is! So, the + * array_size = number_of_round_bracket_pairs + 1 + */ +int slre_match(const struct slre *, const char *buf, int buf_len, +	struct cap *captured_substrings); + +#ifdef SLRE_TEST +void slre_dump(const struct slre *r, FILE *fp); +#endif /* SLRE_TEST */ +#endif /* SLRE_HEADER_DEFINED */ |