8.4 Comparison Operators

Comparison operators compare numeric values for relationships such as equality. They are written using relational operators.

All of Octave’s comparison operators return a value of 1 if the comparison is true, or 0 if it is false. For matrix values, they all work on an element-by-element basis. Broadcasting rules apply. See Broadcasting. For example:

[1, 2; 3, 4] == [1, 3; 2, 4]
     ⇒  1  0
         0  1

According to broadcasting rules, if one operand is a scalar and the other is a matrix, the scalar is compared to each element of the matrix in turn, and the result is the same size as the matrix.

x < y

True if x is less than y.

x <= y

True if x is less than or equal to y.

x == y

True if x is equal to y.

x >= y

True if x is greater than or equal to y.

x > y

True if x is greater than y.

x != y
x ~= y

True if x is not equal to y.

For complex numbers, the following ordering is defined: z1 < z2 if and only if

abs (z1) < abs (z2)
  || (abs (z1) == abs (z2) && arg (z1) < arg (z2))

This is consistent with the ordering used by max, min and sort, but is not consistent with MATLAB, which only compares the real parts.

String comparisons may also be performed with the strcmp function, not with the comparison operators listed above. See Strings.

eq (x, y)

Return true if the two inputs are equal.

This function is equivalent to x == y.

See also: ne, isequal, le, ge, gt, ne, lt.

ge (x, y)

This function is equivalent to x >= y.

See also: le, eq, gt, ne, lt.

gt (x, y)

This function is equivalent to x > y.

See also: le, eq, ge, ne, lt.

isequal (x1, x2, …)

Return true if all of x1, x2, … are equal.

See also: isequaln.

isequaln (x1, x2, …)

Return true if all of x1, x2, … are equal under the additional assumption that NaN == NaN (no comparison of NaN placeholders in dataset).

See also: isequal.

le (x, y)

This function is equivalent to x <= y.

See also: eq, ge, gt, ne, lt.

lt (x, y)

This function is equivalent to x < y.

See also: le, eq, ge, gt, ne.

ne (x, y)

Return true if the two inputs are not equal.

This function is equivalent to x != y.

See also: eq, isequal, le, ge, lt.

© 1996–2020 John W. Eaton
Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.
Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.
Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions.
https://octave.org/doc/v5.2.0/Comparison-Ops.html