/* Copyright JS Foundation and other contributors, http://js.foundation * * 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-alloc.h" #include "ecma-conversion.h" #include "ecma-gc.h" #include "ecma-globals.h" #include "ecma-helpers.h" #include "jrt.h" /** \addtogroup ecma ECMA * @{ * * \addtogroup ecmahelpers Helpers for operations with ECMA data types * @{ */ /** * Allocate a collection of ecma values. * * @return pointer to the collection */ ecma_collection_t * ecma_new_collection (void) { ecma_collection_t *collection_p; collection_p = (ecma_collection_t *) jmem_heap_alloc_block (sizeof (ecma_collection_t)); collection_p->item_count = 0; collection_p->capacity = ECMA_COLLECTION_INITIAL_CAPACITY; const uint32_t size = ECMA_COLLECTION_ALLOCATED_SIZE (ECMA_COLLECTION_INITIAL_CAPACITY); collection_p->buffer_p = (ecma_value_t *) jmem_heap_alloc_block (size); return collection_p; } /* ecma_new_collection */ /** * Deallocate a collection of ecma values without freeing it's values */ extern inline void JERRY_ATTR_ALWAYS_INLINE ecma_collection_destroy (ecma_collection_t *collection_p) /**< value collection */ { JERRY_ASSERT (collection_p != NULL); jmem_heap_free_block (collection_p->buffer_p, ECMA_COLLECTION_ALLOCATED_SIZE (collection_p->capacity)); jmem_heap_free_block (collection_p, sizeof (ecma_collection_t)); } /* ecma_collection_destroy */ /** * Free the object collection elements and deallocate the collection */ void ecma_collection_free_objects (ecma_collection_t *collection_p) /**< value collection */ { JERRY_ASSERT (collection_p != NULL); ecma_value_t *buffer_p = collection_p->buffer_p; for (uint32_t i = 0; i < collection_p->item_count; i++) { if (ecma_is_value_object (buffer_p[i])) { ecma_deref_object (ecma_get_object_from_value (buffer_p[i])); } } ecma_collection_destroy (collection_p); } /* ecma_collection_free_objects */ #if JERRY_ESNEXT /** * Free the template literal objects and deallocate the collection */ void ecma_collection_free_template_literal (ecma_collection_t *collection_p) /**< value collection */ { for (uint32_t i = 0; i < collection_p->item_count; i++) { ecma_object_t *object_p = ecma_get_object_from_value (collection_p->buffer_p[i]); JERRY_ASSERT (ecma_get_object_type (object_p) == ECMA_OBJECT_TYPE_ARRAY); ecma_extended_object_t *array_object_p = (ecma_extended_object_t *) object_p; JERRY_ASSERT (array_object_p->u.array.length_prop_and_hole_count & ECMA_ARRAY_TEMPLATE_LITERAL); array_object_p->u.array.length_prop_and_hole_count &= (uint32_t) ~ECMA_ARRAY_TEMPLATE_LITERAL; ecma_property_value_t *property_value_p; property_value_p = ecma_get_named_data_property (object_p, ecma_get_magic_string (LIT_MAGIC_STRING_RAW)); ecma_object_t *raw_object_p = ecma_get_object_from_value (property_value_p->value); JERRY_ASSERT (ecma_get_object_type (raw_object_p) == ECMA_OBJECT_TYPE_ARRAY); array_object_p = (ecma_extended_object_t *) raw_object_p; JERRY_ASSERT (array_object_p->u.array.length_prop_and_hole_count & ECMA_ARRAY_TEMPLATE_LITERAL); array_object_p->u.array.length_prop_and_hole_count &= (uint32_t) ~ECMA_ARRAY_TEMPLATE_LITERAL; ecma_deref_object (raw_object_p); ecma_deref_object (object_p); } ecma_collection_destroy (collection_p); } /* ecma_collection_free_template_literal */ #endif /* JERRY_ESNEXT */ /** * Free the non-object collection elements and deallocate the collection */ void ecma_collection_free_if_not_object (ecma_collection_t *collection_p) /**< value collection */ { JERRY_ASSERT (collection_p != NULL); ecma_value_t *buffer_p = collection_p->buffer_p; for (uint32_t i = 0; i < collection_p->item_count; i++) { ecma_free_value_if_not_object (buffer_p[i]); } ecma_collection_destroy (collection_p); } /* ecma_collection_free_if_not_object */ /** * Free the collection elements and deallocate the collection */ void ecma_collection_free (ecma_collection_t *collection_p) /**< value collection */ { JERRY_ASSERT (collection_p != NULL); ecma_value_t *buffer_p = collection_p->buffer_p; for (uint32_t i = 0; i < collection_p->item_count; i++) { ecma_free_value (buffer_p[i]); } ecma_collection_destroy (collection_p); } /* ecma_collection_free */ /** * Append new value to ecma values collection * * Note: The reference count of the values are not increased */ void ecma_collection_push_back (ecma_collection_t *collection_p, /**< value collection */ ecma_value_t value) /**< ecma value to append */ { JERRY_ASSERT (collection_p != NULL); ecma_value_t *buffer_p = collection_p->buffer_p; if (JERRY_LIKELY (collection_p->item_count < collection_p->capacity)) { buffer_p[collection_p->item_count++] = value; return; } const uint32_t new_capacity = collection_p->capacity + ECMA_COLLECTION_GROW_FACTOR; const uint32_t old_size = ECMA_COLLECTION_ALLOCATED_SIZE (collection_p->capacity); const uint32_t new_size = ECMA_COLLECTION_ALLOCATED_SIZE (new_capacity); buffer_p = jmem_heap_realloc_block (buffer_p, old_size, new_size); buffer_p[collection_p->item_count++] = value; collection_p->capacity = new_capacity; collection_p->buffer_p = buffer_p; } /* ecma_collection_push_back */ /** * Reserve space for the given amount of ecma_values in the collection */ void ecma_collection_reserve (ecma_collection_t *collection_p, /**< value collection */ uint32_t count) /**< number of ecma values to reserve */ { JERRY_ASSERT (collection_p != NULL); JERRY_ASSERT (UINT32_MAX - count > collection_p->capacity); const uint32_t new_capacity = collection_p->capacity + count; const uint32_t old_size = ECMA_COLLECTION_ALLOCATED_SIZE (collection_p->capacity); const uint32_t new_size = ECMA_COLLECTION_ALLOCATED_SIZE (new_capacity); ecma_value_t *buffer_p = collection_p->buffer_p; buffer_p = jmem_heap_realloc_block (buffer_p, old_size, new_size); collection_p->capacity = new_capacity; collection_p->buffer_p = buffer_p; } /* ecma_collection_reserve */ /** * Append a list of values to the end of the collection */ void ecma_collection_append (ecma_collection_t *collection_p, /**< value collection */ const ecma_value_t *buffer_p, /**< values to append */ uint32_t count) /**< number of ecma values to append */ { JERRY_ASSERT (collection_p != NULL); JERRY_ASSERT (collection_p->capacity >= collection_p->item_count); uint32_t free_count = collection_p->capacity - collection_p->item_count; if (free_count < count) { ecma_collection_reserve (collection_p, count - free_count); } memcpy (collection_p->buffer_p + collection_p->item_count, buffer_p, count * sizeof (ecma_value_t)); collection_p->item_count += count; } /* ecma_collection_append */ /** * Helper function to check if a given collection have duplicated properties or not * * @return true - if there are duplicated properties in the collection * false - otherwise */ bool ecma_collection_check_duplicated_entries (ecma_collection_t *collection_p) /**< prop name collection */ { if (collection_p->item_count == 0) { return false; } ecma_value_t *buffer_p = collection_p->buffer_p; for (uint32_t i = 0; i < collection_p->item_count - 1; i++) { ecma_string_t *current_name_p = ecma_get_prop_name_from_value (buffer_p[i]); for (uint32_t j = i + 1; j < collection_p->item_count; j++) { if (ecma_compare_ecma_strings (current_name_p, ecma_get_prop_name_from_value (buffer_p[j]))) { return true; } } } return false; } /* ecma_collection_check_duplicated_entries */ /** * Check the string value existance in the collection. * * Used by: * - ecma_builtin_json_stringify step 4.b.ii.5 * - ecma_op_object_enumerate * * @return true, if the string is already in the collection. */ bool ecma_collection_has_string_value (ecma_collection_t *collection_p, /**< collection */ ecma_string_t *string_p) /**< string */ { ecma_value_t *buffer_p = collection_p->buffer_p; for (uint32_t i = 0; i < collection_p->item_count; i++) { ecma_string_t *current_p = ecma_get_string_from_value (buffer_p[i]); if (ecma_compare_ecma_strings (current_p, string_p)) { return true; } } return false; } /* ecma_collection_has_string_value */ /** * Initial capacity of an ecma-collection */ #define ECMA_COMPACT_COLLECTION_GROWTH 8 /** * Set the size of the compact collection */ #define ECMA_COMPACT_COLLECTION_SET_SIZE(compact_collection_p, item_count, unused_items) \ ((compact_collection_p)[0] = (((item_count) << ECMA_COMPACT_COLLECTION_SIZE_SHIFT) | (unused_items))) /** * Set the size of the compact collection */ #define ECMA_COMPACT_COLLECTION_GET_UNUSED_ITEM_COUNT(compact_collection_p) \ ((compact_collection_p)[0] & ((1 << ECMA_COMPACT_COLLECTION_SIZE_SHIFT) - 1)) /** * Allocate a compact collection of ecma values * * @return pointer to the compact collection */ ecma_value_t * ecma_new_compact_collection (void) { size_t size = (ECMA_COMPACT_COLLECTION_GROWTH / 2) * sizeof (ecma_value_t); ecma_value_t *compact_collection_p = (ecma_value_t *) jmem_heap_alloc_block (size); ECMA_COMPACT_COLLECTION_SET_SIZE (compact_collection_p, ECMA_COMPACT_COLLECTION_GROWTH / 2, (ECMA_COMPACT_COLLECTION_GROWTH / 2) - 1); return compact_collection_p; } /* ecma_new_compact_collection */ /** * Append a value to the compact collection * * @return updated pointer to the compact collection */ ecma_value_t * ecma_compact_collection_push_back (ecma_value_t *compact_collection_p, /**< compact collection */ ecma_value_t value) /**< ecma value to append */ { ecma_value_t size = ECMA_COMPACT_COLLECTION_GET_SIZE (compact_collection_p); ecma_value_t unused_items = ECMA_COMPACT_COLLECTION_GET_UNUSED_ITEM_COUNT (compact_collection_p); if (unused_items > 0) { compact_collection_p[size - unused_items] = value; (*compact_collection_p)--; return compact_collection_p; } if (size == ECMA_COMPACT_COLLECTION_GROWTH / 2) { size_t old_size = (ECMA_COMPACT_COLLECTION_GROWTH / 2) * sizeof (ecma_value_t); size_t new_size = ECMA_COMPACT_COLLECTION_GROWTH * sizeof (ecma_value_t); compact_collection_p = jmem_heap_realloc_block (compact_collection_p, old_size, new_size); compact_collection_p[ECMA_COMPACT_COLLECTION_GROWTH / 2] = value; ECMA_COMPACT_COLLECTION_SET_SIZE (compact_collection_p, ECMA_COMPACT_COLLECTION_GROWTH, (ECMA_COMPACT_COLLECTION_GROWTH / 2) - 1); return compact_collection_p; } size_t old_size = size * sizeof (ecma_value_t); size_t new_size = old_size + (ECMA_COMPACT_COLLECTION_GROWTH * sizeof (ecma_value_t)); compact_collection_p = jmem_heap_realloc_block (compact_collection_p, old_size, new_size); compact_collection_p[size] = value; ECMA_COMPACT_COLLECTION_SET_SIZE (compact_collection_p, size + ECMA_COMPACT_COLLECTION_GROWTH, ECMA_COMPACT_COLLECTION_GROWTH - 1); return compact_collection_p; } /* ecma_compact_collection_push_back */ /** * Discard the unused elements of a compact collection * * Note: * further items should not be added after this call * * @return updated pointer to the compact collection */ ecma_value_t * ecma_compact_collection_shrink (ecma_value_t *compact_collection_p) /**< compact collection */ { ecma_value_t unused_items = ECMA_COMPACT_COLLECTION_GET_UNUSED_ITEM_COUNT (compact_collection_p); if (unused_items == 0) { return compact_collection_p; } ecma_value_t size = ECMA_COMPACT_COLLECTION_GET_SIZE (compact_collection_p); size_t old_size = size * sizeof (ecma_value_t); size_t new_size = (size - unused_items) * sizeof (ecma_value_t); compact_collection_p = jmem_heap_realloc_block (compact_collection_p, old_size, new_size); ECMA_COMPACT_COLLECTION_SET_SIZE (compact_collection_p, size - unused_items, 0); return compact_collection_p; } /* ecma_compact_collection_shrink */ /** * Free a compact collection */ void ecma_compact_collection_free (ecma_value_t *compact_collection_p) /**< compact collection */ { ecma_value_t size = ECMA_COMPACT_COLLECTION_GET_SIZE (compact_collection_p); ecma_value_t unused_items = ECMA_COMPACT_COLLECTION_GET_UNUSED_ITEM_COUNT (compact_collection_p); ecma_value_t *end_p = compact_collection_p + size - unused_items; ecma_value_t *current_p = compact_collection_p + 1; while (current_p < end_p) { ecma_free_value (*current_p++); } jmem_heap_free_block (compact_collection_p, size * sizeof (ecma_value_t)); } /* ecma_compact_collection_free */ /** * @} * @} */