Error conditions and messages

In case the script is malformed or provides invalid data to functions or operators, an exception may occur. It is then handled by the software calling the interpreter and the exception class name is logged. Below there is a list of the error conditions that can occur.

In case of ASTER script execution issue, the script execution breaks and the Int4 tooling produces an error messages which should be helpful to address the problem at hand. The error message contains the exception name, textual description and sometimes additional information, as in the example below.

Examples

Example of error message when RETURN is used outside a function definition.

Example of error message when wrong number of parameters was provided to a function call.

Generic error classes

Exception Class Name	Explanation in Natural Language
`lcx_aster_error`	A general error class for ASTER-related issues.
`lcx_aster_execution_fail`	Execution resulted in an unexpected error.

Specialized error classes

Exception Class Name	Explanation in Natural Language
`lcx_fun_invalid_params`	Function was called with invalid parameters.
`lcx_fun_invalid_params_count`	Function was called with an incorrect number of parameters.
`lcx_function_not_found`	Requested function was not found.
`lcx_impossible_math`	Attempted a mathematical operation that cannot be performed (e.g., division by zero).
`lcx_index_out_of_bounds`	Index was out of the valid range, typically for arrays.
`lcx_invalid_escape_sequence`	Invalid escape sequence was encountered in the code.
`lcx_invalid_function_object`	Function object was invalid or malformed.
`lcx_invalid_lvalue`	Invalid lvalue (left-hand side of an expression) was encountered.
`lcx_invalid_regex`	Regular expression provided as parameter could not be interpreted and was considered invalid.
`lcx_key_not_found`	Key was not found in a data structure like a map or dictionary.
`lcx_logic_error`	Logical errors encountered during the execution, such as inconsistent conditions or invalid usage of control flow operators.
`lcx_operator_not_unary`	An operator was used in an unary context but it is not unary. The only unary operators are `NOT` and `-` (minus).
`lcx_operator_unknown`	An unknown or unsupported operator was encountered.
`lcx_parse_error`	Parser encountered code that could not be interpreted, most likely due to an invalid syntax.
`lcx_shadow_stack_error`	Stack shadowing failed - error likely related to variable scoping.
`lcx_unmatched_par`	Parser found unmatched parentheses or brackets in the code.