relationaloperators

Class: handle

Determine equality or sort handle objects

Syntax

```tf = eq(H1,H2) tf = ne(H1,H2) tf = lt(H1,H2) tf = le(H1,H2) tf = gt(H1,H2) tf = ge(H1,H2) ```

Description

`tf = eq(H1,H2)` Equal. (`H1 == H2`)

`tf = ne(H1,H2)` Not equal. (`H1 ~= H2`)

`tf = lt(H1,H2)` Less than. (`H1 < H2`)

`tf = le(H1,H2)` Less than or equal. (`H1 <= H2`)

`tf = gt(H1,H2)` Greater than. (`H1 > H2`)

`tf = ge(H1,H2)` Greater than or equal. (`H1 >= H2`)

For each pair of input arrays (`H1` and `H2`), the operation returns a logical array of the same size. Each element in the returned array is an element-wise equality or comparison test result. These methods perform scalar expansion in the same way as the MATLAB® built-in relational operators. For general information on relational operators, see Relational Operations.

The following guidelines apply to handle comparison:

• Copies of a handle variable always compare as equal.

• The repeated comparison of any two handles always yields the same result in the same MATLAB session.

• Different handles are always not equal.

• The order of handle values is purely arbitrary and has no connection to the state of the handle objects being compared.

• If the input arrays belong to different classes (including the case where one input array belongs to a non-handle class such as `double`) then the comparison is always false.

• If you make a comparison between a handle object and an object of a dominant class, the method of the dominant class is invoked. You should generally test only like objects because a dominant class might not define one of these methods.

• An error occurs if the input arrays are not the same size and neither is scalar.

Use `isequal` when you want to determine if different handle objects have the same data in all object properties. Use `==` when you want to determine if handle variables refer to the same object.

When comparing objects that contain dynamic properties, `isequal` always returns `false`.

Input Arguments

expand all

Left argument to operator, specified as a handle array.

Right argument to operator, specified as a handle array.

Output Arguments

expand all

Result of comparison, returned as a logical array of the same size as the input arrays, where each element is an element-wise equality or comparison test result

• `1` — relationship is true

• `0` — relationship is not true

Attributes

 `Access` `public`

To learn about attributes of methods, see Method Attributes.