mirror of
https://github.com/jerryscript-project/jerryscript.git
synced 2025-12-15 16:29:21 +00:00
9aca0086b9
Fixed doc comments issues:
* Fixed mistyped param doc comments (`/**<` is OK, `/** <` is not).
* Put special characters (e.g., pipe, backslash, etc.) in quotes, as they can
confuse doxygen and it will print lots of various warnings. For the sake of
completeness and consistent style, also quote some special characters in
re-bytecode.h
* Added missing `@{`s, removed extra `@}`s.
* Turned `/*` comments to `/**<` doc comments.
Ensured same style for doc groups everywhere:
* Where `\addtogroup`, `@{`, and `@}` doxygen commands are used, the order to be
followed is: license, `#ifndef` guards (in headers), includes, `\addtogroup`
and `@{`, main code content, `@}`, `#endif` guards (in headers).
* Multiple `\addtogroup`s or multiple `@}`s should be in the same doc comment.
* First `\addtogroup` should be on the very first line of a doc comment, i.e.,
`/** \addtogroup`.
JerryScript-DCO-1.0-Signed-off-by: Akos Kiss akiss@inf.u-szeged.hu
118 lines
3.4 KiB
C
118 lines
3.4 KiB
C
/* Copyright 2015-2016 Samsung Electronics Co., Ltd.
|
|
* Copyright 2015-2016 University of Szeged.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#ifndef RE_PARSER_H
|
|
#define RE_PARSER_H
|
|
|
|
#ifndef CONFIG_ECMA_COMPACT_PROFILE_DISABLE_REGEXP_BUILTIN
|
|
|
|
/** \addtogroup parser Parser
|
|
* @{
|
|
*
|
|
* \addtogroup regexparser Regular expression
|
|
* @{
|
|
*
|
|
* \addtogroup regexparser_bytecode Bytecode
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* RegExp token type definitions
|
|
*/
|
|
typedef enum
|
|
{
|
|
RE_TOK_EOF, /**< EOF */
|
|
RE_TOK_BACKREFERENCE, /**< "\[0..9]" */
|
|
RE_TOK_CHAR, /**< any character */
|
|
RE_TOK_ALTERNATIVE, /**< "|" */
|
|
RE_TOK_ASSERT_START, /**< "^" */
|
|
RE_TOK_ASSERT_END, /**< "$" */
|
|
RE_TOK_PERIOD, /**< "." */
|
|
RE_TOK_START_CAPTURE_GROUP, /**< "(" */
|
|
RE_TOK_START_NON_CAPTURE_GROUP, /**< "(?:" */
|
|
RE_TOK_END_GROUP, /**< ")" */
|
|
RE_TOK_ASSERT_START_POS_LOOKAHEAD, /**< "(?=" */
|
|
RE_TOK_ASSERT_START_NEG_LOOKAHEAD, /**< "(?!" */
|
|
RE_TOK_ASSERT_WORD_BOUNDARY, /**< "\b" */
|
|
RE_TOK_ASSERT_NOT_WORD_BOUNDARY, /**< "\B" */
|
|
RE_TOK_DIGIT, /**< "\d" */
|
|
RE_TOK_NOT_DIGIT, /**< "\D" */
|
|
RE_TOK_WHITE, /**< "\s" */
|
|
RE_TOK_NOT_WHITE, /**< "\S" */
|
|
RE_TOK_WORD_CHAR, /**< "\w" */
|
|
RE_TOK_NOT_WORD_CHAR, /**< "\W" */
|
|
RE_TOK_START_CHAR_CLASS, /**< "[ ]" */
|
|
RE_TOK_START_INV_CHAR_CLASS, /**< "[^ ]" */
|
|
} re_token_type_t;
|
|
|
|
/**
|
|
* @}
|
|
*
|
|
* \addtogroup regexparser_parser Parser
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* RegExp constant of infinite
|
|
*/
|
|
#define RE_ITERATOR_INFINITE ((uint32_t) - 1)
|
|
|
|
/**
|
|
* Maximum number of decimal escape digits
|
|
*/
|
|
#define RE_MAX_RE_DECESC_DIGITS 9
|
|
|
|
/**
|
|
* RegExp token type
|
|
*/
|
|
typedef struct
|
|
{
|
|
re_token_type_t type; /**< type of the token */
|
|
uint32_t value; /**< value of the token */
|
|
uint32_t qmin; /**< minimum number of token iterations */
|
|
uint32_t qmax; /**< maximum number of token iterations */
|
|
bool greedy; /**< type of iteration */
|
|
} re_token_t;
|
|
|
|
/**
|
|
* RegExp parser context
|
|
*/
|
|
typedef struct
|
|
{
|
|
const lit_utf8_byte_t *input_start_p; /**< start of input pattern */
|
|
const lit_utf8_byte_t *input_curr_p; /**< current position in input pattern */
|
|
const lit_utf8_byte_t *input_end_p; /**< end of input pattern */
|
|
int num_of_groups; /**< number of groups */
|
|
uint32_t num_of_classes; /**< number of character classes */
|
|
} re_parser_ctx_t;
|
|
|
|
typedef void (*re_char_class_callback) (void *re_ctx_p, ecma_char_t start, ecma_char_t end);
|
|
|
|
ecma_value_t
|
|
re_parse_char_class (re_parser_ctx_t *, re_char_class_callback, void *, re_token_t *);
|
|
|
|
ecma_value_t
|
|
re_parse_next_token (re_parser_ctx_t *, re_token_t *);
|
|
|
|
/**
|
|
* @}
|
|
* @}
|
|
* @}
|
|
*/
|
|
|
|
#endif /* !CONFIG_ECMA_COMPACT_PROFILE_DISABLE_REGEXP_BUILTIN */
|
|
#endif /* !RE_PARSER_H */
|