Main Content

matlab.unittest.constraints.LogicalComparator class

Package: matlab.unittest.constraints

Comparator for two logical values

expand all in page

Construction

LogicalComparator creates a comparator for two logical values. The comparator is satisfied if the actual and expected values have the same sparsity and the logical values are equivalent.

Copy Semantics

Value. To learn how value classes affect copy operations, see Copying Objects.

Examples

collapse all

Create a test case for interactive testing.

import matlab.unittest.TestCase
import matlab.unittest.constraints.LogicalComparator
import matlab.unittest.constraints.IsEqualTo

testCase = TestCase.forInteractiveUse;

Test the value of true.

testCase.assertThat(true, IsEqualTo(true, ...
    'Using', LogicalComparator))
Interactive assertion passed.

Test an array of true values.

testCase.assertThat([true true true], IsEqualTo(true, ...
    'Using', LogicalComparator))
Interactive assertion failed.

---------------------
Framework Diagnostic:
---------------------
IsEqualTo failed.
--> LogicalComparator failed.
    --> The logical values are not equal

Actual Logical Value:
         1     1     1
Expected Logical Value:
         1
Assertion failed.

The actual value must be a scalar logical to satisfy the constraint.

Compare the value of 1 to true.

testCase.verifyThat(1, IsEqualTo(true, 'Using', LogicalComparator))
Interactive verification failed.

---------------------
Framework Diagnostic:
---------------------
IsEqualTo failed.
--> LogicalComparator failed.
    --> Class check failed.
        --> Classes do not match.
            
            Actual Class:
                double
            Expected Class:
                logical

Actual double:
         1
Expected logical:
         1

Compare the value of false to true.

testCase.assertThat(false, IsEqualTo(true, 'Using', LogicalComparator))
Interactive assertion failed.

---------------------
Framework Diagnostic:
---------------------
IsEqualTo failed.
--> LogicalComparator failed.
    --> The logical values are not equal

Actual Logical Value:
         0
Expected Logical Value:
         1
Assertion failed.

Tips

  • In most cases, you are not required to use a LogicalComparator object. The IsEqualTo class creates a constraint to test for equality between data of various types, including logical values.

    Use a LogicalComparator object when you need to override the comparison performed by the IsEqualTo class. For example, if you want the comparison to fail when actual and expected values are nonlogical, include a LogicalComparator object in your test. You also can use LogicalComparator to restrict the values contained in structures, cell arrays, and tables. In this example, MATLAB® throws an exception because the actual and expected values are numeric arrays.

    import matlab.unittest.constraints.IsEqualTo
import matlab.unittest.constraints.LogicalComparator
      
exp = magic(5); 
act = exp;

testCase = matlab.unittest.TestCase.forInteractiveUse;
testCase.verifyThat(act,IsEqualTo(exp,'Using',LogicalComparator))

Version History

Introduced in R2013a

See Also