Style fixes regarding 'empty' value: introducing ecma_is_empty_completion_value, reducing usage of the 'empty' value, listing possible usage cases of the 'empty' value in the comment to it's definition.

2014-07-28 21:21:31 +04:00
parent 177a2d1382
commit 3ee0e8a8a5
7 changed files with 81 additions and 60 deletions
@@ -63,12 +63,18 @@ typedef enum {
 * Simple ecma-values
 */
 typedef enum {
-    ECMA_SIMPLE_VALUE_EMPTY, /**< empty value (see also: ECMA-262 v5, 8.9 Completion specification type) */
+    /**
+     * Empty value is implementation defined value, used for:
+     *   - representing empty value in completion values (see also: ECMA-262 v5, 8.9 Completion specification type);
+     *   - values of uninitialized immutable bindings;
+     *   - values of empty register variables.
+     */
+    ECMA_SIMPLE_VALUE_EMPTY,
    ECMA_SIMPLE_VALUE_UNDEFINED, /**< undefined value */
    ECMA_SIMPLE_VALUE_NULL, /**< null value */
    ECMA_SIMPLE_VALUE_FALSE, /**< boolean false */
    ECMA_SIMPLE_VALUE_TRUE, /**< boolean true */
-    ECMA_SIMPLE_VALUE_ARRAY_REDIRECT, /**< special value for an array's elements that exists,
+    ECMA_SIMPLE_VALUE_ARRAY_REDIRECT, /**< implementation defined value for an array's elements that exists,
                                           but is stored directly in the array's property list
                                           (used for array elements with non-default attribute values) */
    ECMA_SIMPLE_VALUE__COUNT /** count of simple ecma-values */