mirror of
https://github.com/jerryscript-project/jerryscript.git
synced 2025-12-15 16:29:21 +00:00
0d7ea70b41
* Fix "end of file while inside a group" doxygen warnings. * Fix "unknown command" doxygen warnings caused by incorrect argument references. Instead of `@foo`, `@a foo` is the proper format. * Fix "unknown command" doxygen warnings caused by incorrect parameter direction specifications. Instead of `@in`, `@out`, and `@in-out`, `[in]`, `[out]`, and `[in,out]` are the proper formats. * Wrapping special characters in quotes to avoid doxygen confusion. Raw pipe, semicolon, dot, backslash, etc. characters can drive doxygen into various misinterpretations and warnings. E.g.: ``` End of list marker found without any preceding list items Found unknown command ``` Putting quotes around such text snipets eliminates the errors. * Fix the documentation of `ecma_builtin_global_object_print`. Raw <> and \ sequences confused doxygen in various ways (it tried to interpret them as XML tags and doxygen commands). * Fix "ignoring title that does not match old title" doxygen warnings. At some places, the group titles were out of sync, at others, the group names were incorrect. * Fix "parameters are not documented" doxygen warnings. Fixing various typos in the inline parameter documentations (`/*`, `/**`, `/** <`, and `/**>` are all considered incorrect, the right format is `/**<`). JerryScript-DCO-1.0-Signed-off-by: Akos Kiss akiss@inf.u-szeged.hu
123 lines
3.4 KiB
C
123 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
|
|
|
|
/**
|
|
* Undefined character (out of the range of the codeunit)
|
|
*/
|
|
#define RE_CHAR_UNDEF 0xFFFFFFFF
|
|
|
|
/**
|
|
* 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
|
|
{
|
|
lit_utf8_byte_t *input_start_p; /**< start of input pattern */
|
|
lit_utf8_byte_t *input_curr_p; /**< current position in input pattern */
|
|
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, uint32_t start, uint32_t end);
|
|
|
|
ecma_completion_value_t
|
|
re_parse_char_class (re_parser_ctx_t *, re_char_class_callback, void *, re_token_t *);
|
|
|
|
ecma_completion_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 */
|