/* Copyright 2014-2015 Samsung Electronics Co., Ltd.
 *
 * 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.
 */

/** \addtogroup ecma ECMA
 * @{
 *
 * \addtogroup ecmaalloc Routines for allocation/freeing memory for ECMA data types
 * @{
 */

#ifndef JERRY_ECMA_ALLOC_H
#define  JERRY_ECMA_ALLOC_H

#include "ecma-globals.h"

/**
 * Allocate memory for ecma-object
 *
 * @return pointer to allocated memory
 */
extern ecma_object_t *ecma_alloc_object (void);

/**
 * Dealloc memory from an ecma-object
 */
extern void ecma_dealloc_object (ecma_object_t *object_p);

/**
 * Allocate memory for ecma-property
 *
 * @return pointer to allocated memory
 */
extern ecma_property_t *ecma_alloc_property (void);

/**
 * Dealloc memory from an ecma-property
 */
extern void ecma_dealloc_property (ecma_property_t *property_p);

/**
 * Allocate memory for ecma-number
 *
 * @return pointer to allocated memory
 */
extern ecma_number_t *ecma_alloc_number (void);

/**
 * Dealloc memory from an ecma-number
 */
extern void ecma_dealloc_number (ecma_number_t *number_p);

/**
 * Allocate memory for header of a collection
 *
 * @return pointer to allocated memory
 */
extern ecma_collection_header_t *ecma_alloc_collection_header (void);

/**
 * Dealloc memory from the collection's header
 */
extern void ecma_dealloc_collection_header (ecma_collection_header_t *collection_header_p);

/**
 * Allocate memory for non-first chunk of a collection
 *
 * @return pointer to allocated memory
 */
extern ecma_collection_chunk_t* ecma_alloc_collection_chunk (void);

/**
 * Dealloc memory from non-first chunk of a collection
 */
extern void ecma_dealloc_collection_chunk (ecma_collection_chunk_t *non_first_chunk_p);

/**
 * Allocate memory for ecma-string descriptor
 *
 * @return pointer to allocated memory
 */
extern ecma_string_t *ecma_alloc_string (void);

/**
 * Dealloc memory from ecma-string descriptor
 */
extern void ecma_dealloc_string (ecma_string_t *string_p);

/**
 * Allocate memory for label descriptor
 *
 * @return pointer to allocated memory
 */
extern ecma_label_descriptor_t *ecma_alloc_label_descriptor (void);

/**
 * Dealloc memory from label descriptor
 */
extern void ecma_dealloc_label_descriptor (ecma_label_descriptor_t *label_desc_p);

/**
 * Allocate memory for getter-setter pointer pair
 *
 * @return pointer to allocated memory
 */
extern ecma_getter_setter_pointers_t *ecma_alloc_getter_setter_pointers (void);

/**
 * Dealloc memory from getter-setter pointer pair
 */
extern void ecma_dealloc_getter_setter_pointers (ecma_getter_setter_pointers_t *pointer_pair_p);

/**
* Allocate memory for external pointer
*
* @return pointer to allocated memory
*/
extern ecma_external_pointer_t *ecma_alloc_external_pointer (void);

/**
* Dealloc memory from external pointer
*/
extern void ecma_dealloc_external_pointer (ecma_external_pointer_t *external_pointer_p);


#endif /* JERRY_ECMA_ALLOC_H */

/**
 * @}
 * @}
 */
