Function equal

Test whether two values are equal.

The function tests whether the relative difference between x and y is smaller than the configured epsilon. The function cannot be used to compare values smaller than approximately 2.22e-16.

For matrices, the function is evaluated element wise. In case of complex numbers, must equal, and must equal

Values null and undefined are compared strictly, thus null is only equal to null and nothing else, and undefined is only equal to undefined and nothing else.


equal(x, y)


Parameter Type Description
x number | BigNumber | boolean | Complex | Unit | string | Array | Matrix First value to compare
y number | BigNumber | boolean | Complex | Unit | string | Array | Matrix Second value to compare


Type Description
boolean | Array | Matrix Returns true when the compared values are equal, else returns false


equal(2 + 2, 3);         // returns false
equal(2 + 2, 4);         // returns true

var a = unit('50 cm');
var b = unit('5 m');
equal(a, b);             // returns true

var c = [2, 5, 1];
var d = [2, 7, 1];

equal(c, d);             // returns [true, false, true]
deepEqual(c, d);         // returns false

equal(0, null);          // returns false

See also

unequal, smaller, smallerEq, larger, largerEq, compare, deepEqual