Add an API function to calculate the UTF-8 encoded string size from Jerry string. (#1450)

JerryScript-DCO-1.0-Signed-off-by: Robert Sipka rsipka.uszeged@partner.samsung.com

jerry-core/jerry.c

@@ -1044,6 +1044,27 @@ jerry_get_string_size (const jerry_value_t value) /**< input string */
   return ecma_string_get_size (ecma_get_string_from_value (value));
 } /* jerry_get_string_size */
 
+/**
+ * Get UTF-8 encoded string size from Jerry string
+ *
+ * Note:
+ *      Returns 0, if the value parameter is not a string.
+ *
+ * @return number of bytes in the buffer needed to represent the UTF-8 encoded string
+ */
+jerry_size_t
+jerry_get_utf8_string_size (const jerry_value_t value)
+{
+  jerry_assert_api_available ();
+
+  if (!ecma_is_value_string (value))
+  {
+    return 0;
+  }
+
+  return ecma_string_get_utf8_size (ecma_get_string_from_value (value));
+} /* jerry_get_utf8_string_size */
+
 /**
  * Get length of Jerry string
  *