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
128 lines
3.5 KiB
C
128 lines
3.5 KiB
C
/* Copyright 2014-2016 Samsung Electronics Co., Ltd.
|
|
* Copyright 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.
|
|
*/
|
|
|
|
#include "ecma-gc.h"
|
|
#include "ecma-globals.h"
|
|
#include "ecma-helpers.h"
|
|
#include "ecma-lex-env.h"
|
|
#include "ecma-reference.h"
|
|
#include "jrt.h"
|
|
|
|
/** \addtogroup ecma ECMA
|
|
* @{
|
|
*
|
|
* \addtogroup references ECMA-Reference
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* Resolve syntactic reference.
|
|
*
|
|
* @return if reference was resolved successfully,
|
|
* pointer to lexical environment - reference's base,
|
|
* else - NULL.
|
|
*/
|
|
ecma_object_t *
|
|
ecma_op_resolve_reference_base (ecma_object_t *lex_env_p, /**< starting lexical environment */
|
|
ecma_string_t *name_p) /**< identifier's name */
|
|
{
|
|
JERRY_ASSERT (lex_env_p != NULL);
|
|
|
|
ecma_object_t *lex_env_iter_p = lex_env_p;
|
|
|
|
while (lex_env_iter_p != NULL)
|
|
{
|
|
if (ecma_op_has_binding (lex_env_iter_p, name_p))
|
|
{
|
|
return lex_env_iter_p;
|
|
}
|
|
|
|
lex_env_iter_p = ecma_get_lex_env_outer_reference (lex_env_iter_p);
|
|
}
|
|
|
|
return NULL;
|
|
} /* ecma_op_resolve_reference_base */
|
|
|
|
/**
|
|
* Resolve syntactic reference to ECMA-reference.
|
|
*
|
|
* @return ECMA-reference
|
|
* Returned value must be freed through ecma_free_reference.
|
|
*/
|
|
ecma_reference_t
|
|
ecma_op_get_identifier_reference (ecma_object_t *lex_env_p, /**< lexical environment */
|
|
ecma_string_t *name_p, /**< identifier's name */
|
|
bool is_strict) /**< strict reference flag */
|
|
{
|
|
JERRY_ASSERT (lex_env_p != NULL);
|
|
|
|
ecma_object_t *base_lex_env_p = ecma_op_resolve_reference_base (lex_env_p, name_p);
|
|
|
|
if (base_lex_env_p != NULL)
|
|
{
|
|
return ecma_make_reference (ecma_make_object_value (base_lex_env_p),
|
|
name_p,
|
|
is_strict);
|
|
}
|
|
else
|
|
{
|
|
return ecma_make_reference (ecma_make_simple_value (ECMA_SIMPLE_VALUE_UNDEFINED),
|
|
name_p,
|
|
is_strict);
|
|
}
|
|
} /* ecma_op_get_identifier_reference */
|
|
|
|
/**
|
|
* ECMA-reference constructor.
|
|
*
|
|
* @return ECMA-reference
|
|
* Returned value must be freed through ecma_free_reference.
|
|
*/
|
|
ecma_reference_t
|
|
ecma_make_reference (ecma_value_t base, /**< base value */
|
|
ecma_string_t *name_p, /**< referenced name */
|
|
bool is_strict) /**< strict reference flag */
|
|
{
|
|
name_p = ecma_copy_or_ref_ecma_string (name_p);
|
|
|
|
ecma_reference_t ref;
|
|
ref.base = ecma_copy_value (base);
|
|
ref.is_strict = (is_strict != 0);
|
|
|
|
ECMA_SET_POINTER (ref.referenced_name_cp, name_p);
|
|
|
|
return ref;
|
|
} /* ecma_make_reference */
|
|
|
|
/**
|
|
* Free specified ECMA-reference.
|
|
*
|
|
* Warning:
|
|
* freeing invalidates all copies of the reference.
|
|
*/
|
|
void
|
|
ecma_free_reference (ecma_reference_t ref) /**< reference */
|
|
{
|
|
ecma_free_value (ref.base);
|
|
ecma_deref_ecma_string (ECMA_GET_NON_NULL_POINTER (ecma_string_t,
|
|
ref.referenced_name_cp));
|
|
} /* ecma_free_reference */
|
|
|
|
/**
|
|
* @}
|
|
* @}
|
|
*/
|