jerryx: add jerryx_arg_array (#2052)

Related issue: #2046

JerryScript-DCO-1.0-Signed-off-by: Zidong Jiang zidong.jiang@intel.com

jerry-ext/arg/arg-transform-functions.c

@@ -404,6 +404,25 @@ jerryx_arg_transform_object_props (jerryx_arg_js_iterator_t *js_arg_iter_p, /**<
                                                  object_props->c_arg_cnt);
 } /* jerryx_arg_transform_object_props */
 
+/**
+ * Check whether the JS array's items have expected types, and transform them into native args.
+ *
+ * @return jerry undefined: the transformer passes,
+ *         jerry error: the transformer fails.
+ */
+jerry_value_t
+jerryx_arg_transform_array_items (jerryx_arg_js_iterator_t *js_arg_iter_p, /**< available JS args */
+                                  const jerryx_arg_t *c_arg_p) /**< the native arg */
+{
+  jerry_value_t js_arg = jerryx_arg_js_iterator_pop (js_arg_iter_p);
+
+  const jerryx_arg_array_items_t *array_items_p = (const jerryx_arg_array_items_t *) c_arg_p->extra_info;
+
+  return jerryx_arg_transform_array (js_arg,
+                                     array_items_p->c_arg_p,
+                                     array_items_p->c_arg_cnt);
+} /* jerryx_arg_transform_array_items */
+
 /**
  * Define transformer for optional argument.
  */
@@ -424,6 +443,7 @@ JERRYX_ARG_TRANSFORM_OPTIONAL (string_strict)
 JERRYX_ARG_TRANSFORM_OPTIONAL (function)
 JERRYX_ARG_TRANSFORM_OPTIONAL (native_pointer)
 JERRYX_ARG_TRANSFORM_OPTIONAL (object_props)
+JERRYX_ARG_TRANSFORM_OPTIONAL (array_items)
 
 JERRYX_ARG_TRANSFORM_OPTIONAL (uint8)
 JERRYX_ARG_TRANSFORM_OPTIONAL (uint16)

jerry-ext/arg/arg.c

@@ -143,3 +143,46 @@ jerryx_arg_transform_object_properties (const jerry_value_t obj_val,/**< the JS
 
   return ret;
 } /* jerryx_arg_transform_object_properties */
+
+/**
+ * Validate the items in the JS array and assign them to the native arguments.
+ *
+ * @return jerry undefined: all validators passed,
+ *         jerry error: a validator failed.
+ */
+jerry_value_t
+jerryx_arg_transform_array (const jerry_value_t array_val, /**< points to the JS array */
+                            const jerryx_arg_t *c_arg_p, /**< points to the array of validation/transformation steps */
+                            jerry_length_t c_arg_cnt) /**< the count of the `c_arg_p` array */
+{
+  if (!jerry_value_is_array (array_val))
+  {
+    return jerry_create_error (JERRY_ERROR_TYPE, (jerry_char_t *) "Not an array.");
+  }
+
+  jerry_value_t arr[c_arg_cnt];
+
+  for (jerry_length_t i = 0; i < c_arg_cnt; i++)
+  {
+    arr[i] = jerry_get_property_by_index (array_val, i);
+
+    if (jerry_value_has_error_flag (arr[i]))
+    {
+      for (jerry_length_t j = 0; j < i; j++)
+      {
+        jerry_release_value (arr[j]);
+      }
+
+      return arr[i];
+    }
+  }
+
+  const jerry_value_t ret = jerryx_arg_transform_args (arr, c_arg_cnt, c_arg_p, c_arg_cnt);
+
+  for (jerry_length_t i = 0; i < c_arg_cnt; i++)
+  {
+    jerry_release_value (arr[i]);
+  }
+
+  return ret;
+} /* jerryx_arg_transform_array */