Added new 'jerry_binary_operation' API function

JerryScript-DCO-1.0-Signed-off-by: László Langó [email protected]

Author: LaszloLango

docs/02.API-REFERENCE.md

@@ -276,6 +276,18 @@ An opaque declaration of the JerryScript context structure.
 typedef struct jerry_context_t jerry_context_t;
 ```
 
+
+## jerry_binary_operation_t
+
+Enum that contains the supperted binary operation types
+ - JERRY_BIN_OP_EQUAL - equal comparison (==)
+ - JERRY_BIN_OP_STRICT_EQUAL - strict equal comparison (===)
+ - JERRY_BIN_OP_LESS - less relation (<)
+ - JERRY_BIN_OP_LESS_EQUAL - less or equal relation (<=)
+ - JERRY_BIN_OP_GREATER - greater relation (>)
+ - JERRY_BIN_OP_GREATER_EQUAL - greater or equal relation (>=)
+
+
 ## jerry_property_descriptor_t
 
 **Summary**
@@ -1701,6 +1713,70 @@ jerry_is_feature_enabled (const jerry_feature_t feature);
 }
 ```
 
+**See also**
+- [jerry_feature_t](#jerry_feature_t)
+
+
+# Binary operations
+
+## jerry_binary_operation
+
+**Summary**
+
+Perform binary operation on the given operands (==, ===, <, >, etc.).
+
+**Prototype**
+
+```c
+jerry_value_t
+jerry_binary_operation (jerry_binary_operation_t op,
+                        const jerry_value_t lhs,
+                        const jerry_value_t rhs);
+```
+
+- `op` - binary operation
+- `lhs` - left-hand side operand
+- `rhs` - right-hand side operand
+- return value
+  - error, if argument has an error flag
+  - true, if the two operands are strictly equal
+  - false, otherwise
+
+**Example**
+
+```c
+{
+  jerry_value_t value1;
+  jerry_value_t value2;
+  ... // create or acquire value
+  jerry_value_t result = jerry_binary_operation (JERRY_BIN_OP_EQUAL, value1, value2)
+
+  if (!jerry_value_is_error (result))
+  {
+    if (jerry_get_boolean_value (result))
+    {
+       // value1 and value2 are equal
+    }
+    else
+    {
+      // value1 and value2 are NOT equal
+    }
+  }
+  else
+  {
+    ... // handle error
+  }
+
+  jerry_release_value (value1);
+  jerry_release_value (value2);
+  jerry_release_value (result);
+}
+```
+
+**See also**
+- [jerry_binary_operation_t](#jerry_binary_operation_t)
+
+
 # Error manipulation functions
 
 ## jerry_create_abort_from_value

jerry-core/api/jerry.c

@@ -21,6 +21,7 @@
 #include "ecma-arraybuffer-object.h"
 #include "ecma-builtin-helpers.h"
 #include "ecma-builtins.h"
+#include "ecma-comparison.h"
 #include "ecma-exceptions.h"
 #include "ecma-eval.h"
 #include "ecma-function-object.h"
@@ -34,6 +35,7 @@
 #include "ecma-regexp-object.h"
 #include "ecma-promise-object.h"
 #include "ecma-typedarray-object.h"
+#include "opcodes.h"
 #include "jcontext.h"
 #include "jerryscript.h"
 #include "jerryscript-debugger-transport.h"
@@ -901,6 +903,58 @@ jerry_is_feature_enabled (const jerry_feature_t feature) /**< feature to check *
           );
 } /* jerry_is_feature_enabled */
 
+/**
+ * Perform binary operation on the given operands (==, ===, <, >, etc.).
+ *
+ * @return true  - if the two operands are strictly equal
+ *         false - otherwise
+ *         error - if argument has an error flag or operation is unsupported
+ */
+jerry_value_t
+jerry_binary_operation (jerry_binary_operation_t op, /**< operation */
+                        const jerry_value_t lhs, /**< first operand */
+                        const jerry_value_t rhs) /**< second operand */
+{
+  jerry_assert_api_available ();
+
+  if (ecma_is_value_error_reference (lhs) || ecma_is_value_error_reference (rhs))
+  {
+    return jerry_throw (ecma_raise_type_error (ECMA_ERR_MSG (error_value_msg_p)));
+  }
+
+  switch (op)
+  {
+    case JERRY_BIN_OP_EQUAL:
+    {
+      return  ecma_op_abstract_equality_compare (lhs, rhs);
+    }
+    case JERRY_BIN_OP_STRICT_EQUAL:
+    {
+      return  ecma_make_boolean_value (ecma_op_strict_equality_compare (lhs, rhs));
+    }
+    case JERRY_BIN_OP_LESS:
+    {
+      return opfunc_relation (lhs, rhs, true, false);
+    }
+    case JERRY_BIN_OP_LESS_EQUAL:
+    {
+      return opfunc_relation (lhs, rhs, false, true);
+    }
+    case JERRY_BIN_OP_GREATER:
+    {
+      return opfunc_relation (lhs, rhs, false, false);
+    }
+    case JERRY_BIN_OP_GREATER_EQUAL:
+    {
+      return opfunc_relation (lhs, rhs, true, true);
+    }
+    default:
+    {
+      return jerry_throw (ecma_raise_type_error (ECMA_ERR_MSG ("Unsupported binary operation")));
+    }
+  }
+} /* jerry_binary_operation */
+
 /**
  * Create abort from an api value.
  *

jerry-core/include/jerryscript-core.h

@@ -308,6 +308,19 @@ typedef struct
  */
 typedef struct jerry_context_t jerry_context_t;
 
+/**
+  * Enum that contains the supperted binary operation types
+  */
+typedef enum
+{
+  JERRY_BIN_OP_EQUAL = 0u,
+  JERRY_BIN_OP_STRICT_EQUAL,
+  JERRY_BIN_OP_LESS,
+  JERRY_BIN_OP_LESS_EQUAL,
+  JERRY_BIN_OP_GREATER,
+  JERRY_BIN_OP_GREATER_EQUAL
+} jerry_binary_operation_t;
+
 /**
  * General engine functions.
  */
@@ -379,6 +392,13 @@ jerry_type_t jerry_value_get_type (const jerry_value_t value);
  */
 bool jerry_is_feature_enabled (const jerry_feature_t feature);
 
+/**
+ * Binary operations
+ */
+jerry_value_t jerry_binary_operation (jerry_binary_operation_t op,
+                                      const jerry_value_t lhs,
+                                      const jerry_value_t rhs);
+
 /**
  * Error manipulation functions.
  */