From 2b3309b8b00f8d1380cb7b92da52e9c447c5ca72 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Zsolt=20Borb=C3=A9ly?= Date: Wed, 3 Jan 2018 14:58:54 +0100 Subject: [PATCH] Update the webpage MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit JerryScript-DCO-1.0-Signed-off-by: Zsolt Borbély zsborbely.u-szeged@partner.samsung.com --- 02.API-REFERENCE.md | 43 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) diff --git a/02.API-REFERENCE.md b/02.API-REFERENCE.md index 373ff6eb4..b1635163d 100644 --- a/02.API-REFERENCE.md +++ b/02.API-REFERENCE.md @@ -1496,6 +1496,49 @@ jerry_value_set_error_flag (jerry_value_t *value_p); - [jerry_value_t](#jerry_value_t) +## jerry_get_value_without_error_flag + +**Summary** + +If the input value is an error value, then return a new reference to its referenced value. +Otherwise, return a new reference to the value itself. + +*Note*: Returned value must be freed with [jerry_release_value](#jerry_release_value) +when it is no longer needed. + +**Prototype** + +```c +jerry_value_t +jerry_get_value_without_error_flag (jerry_value_t value) +``` + +- `value` - api value + +**Example** + +```c +{ + jerry_value_t value; + ... // create or acquire value + + jerry_value_set_error_flag (&value); + + jerry_value_t real_value = jerry_get_value_without_error_flag (value); + ... // process the real_value. Different from `jerry_value_clear_error_flag`, + // the error `value` will not be automatically released after calling + // `jerry_get_value_without_error_flag`. + + jerry_release_value (value); + jerry_release_value (real_value); +} +``` + +**See also** + +- [jerry_acquire_value](#jerry_acquire_value) +- [jerry_value_clear_error_flag](#jerry_value_clear_error_flag) + # Getter functions of 'jerry_value_t' Get raw data from API values.