Update the webpage (#1542)

JerryScript-DCO-1.0-Signed-off-by: Zsolt Borbély zsborbely.u-szeged@partner.samsung.com
2017-01-26 08:48:27 +01:00
parent dd84f11996
commit b89c74fd39
4 changed files with 125 additions and 16 deletions
@@ -1409,6 +1409,109 @@ jerry_string_to_utf8_char_buffer (const jerry_value_t value,
 - [jerry_create_string_from_utf8](#jerrycreatestringfromutf8)
 - [jerry_get_utf8_string_size](#jerrygetutf8stringsize)

+## jerry_substring_to_char_buffer
+
+**Summary**
+
+Copy the characters of a cesu-8 encoded substring into a specified buffer.
+The '\0' character could occur in character buffer. Returns 0, if the value
+parameter is not a string. It will extract the substring between the
+specified start position and the end position (or the end of the string,
+whichever comes first).
+
+**Prototype**
+
+```c
+jerry_size_t
+jerry_substring_to_char_buffer (const jerry_value_t value,
+                                jerry_length_t start_pos,
+                                jerry_length_t end_pos,
+                                jerry_char_t *buffer_p,
+                                jerry_size_t buffer_size);
+```
+
+- `value` - input string value
+- `start_pos` - position of the first character
+- `end_pos` - position of the last character
+- `buffer_p` - pointer to output buffer
+- `buffer_size` - size of the buffer
+- return value - number of bytes, actually copied to the buffer
+
+**Example**
+
+```c
+{
+  jerry_value_t value;
+  ... // create or acquire value
+
+  jerry_size_t req_sz = jerry_get_string_size (value);
+  jerry_char_t str_buf_p[req_sz];
+  jerry_length_t start_pos = 0;
+  jerry_length_t end_pos = jerry_get_string_length (value);
+
+  jerry_substring_to_char_buffer (value, start_pos, end_pos, str_buf_p, req_sz);
+
+  jerry_release_value (value);
+}
+```
+
+**See also**
+
+- [jerry_create_string](#jerrycreatestring)
+- [jerry_get_string_size](#jerrygetstringsize)
+- [jerry_get_string_length](#jerrygetstringlength)
+
+## jerry_substring_to_utf8_char_buffer
+
+**Summary**
+
+Copy the characters of an utf-8 encoded substring into a specified buffer.
+The '\0' character could occur in character buffer. Returns 0, if the value
+parameter is not a string. It will extract the substring between the specified
+start position and the end position (or the end of the string, whichever
+comes first).
+
+**Prototype**
+
+```c
+jerry_size_t
+jerry_substring_to_utf8_char_buffer (const jerry_value_t value,
+                                     jerry_length_t start_pos,
+                                     jerry_length_t end_pos,
+                                     jerry_char_t *buffer_p,
+                                     jerry_size_t buffer_size);
+```
+
+- `value` - input string value
+- `start_pos` - position of the first character
+- `end_pos` - position of the last character
+- `buffer_p` - pointer to output buffer
+- `buffer_size` - size of the buffer
+- return value - number of bytes, actually copied to the buffer
+
+**Example**
+
+```c
+{
+  jerry_value_t value;
+  ... // create or acquire value
+
+  jerry_size_t req_sz = jerry_get_utf8_string_size (value);
+  jerry_char_t str_buf_p[req_sz];
+  jerry_length_t start_pos = 0;
+  jerry_length_t end_pos = jerry_get_utf8_string_length (value);
+
+  jerry_substring_to_utf8_char_buffer (value, start_pos, end_pos, str_buf_p, req_sz);
+
+  jerry_release_value (value);
+}
+```
+
+**See also**
+
+- [jerry_create_string_from_utf8](#jerrycreatestring)
+- [jerry_get_utf8_string_size](#jerrygetutf8stringsize)
+- [jerry_get_utf8_string_length](#jerrygetutf8stringlength)
 # Functions for array object values

 ## jerry_get_array_length
@@ -2774,8 +2877,9 @@ jerry_free_property_descriptor_fields (const jerry_property_descriptor_t *prop_d

 **Summary**

-Call function specified by a function value. Error flag
-must not be set for any arguments of this function.
+Call function specified by a function value. Error flag must
+not be set for any arguments of this function. Value of `this`
+parameter should be set to `undefined` for non-method calls.

 *Note*: Returned value must be freed with [jerry_release_value](#jerryreleasevalue) when it
 is no longer needed.
@@ -2817,6 +2921,8 @@ jerry_call_function (const jerry_value_t func_obj_val,
    jerry_release_value (ret_val);
    jerry_release_value (this_val);
  }
+
+  jerry_release_value (val);
 }
 ```

@@ -3241,6 +3347,7 @@ jerry_exec_snapshot (const void *snapshot_p,
  size_t global_mode_snapshot_size = jerry_parse_and_save_snapshot (code_to_snapshot_p,
                                                                    strlen ((const char *) code_to_snapshot_p),
                                                                    true,
+                                                                    false,
                                                                    global_mode_snapshot_buffer,
                                                                    sizeof (global_mode_snapshot_buffer));
  jerry_cleanup ();