Main Content

matlab.unittest.constraints.CellComparator 클래스

네임스페이스: matlab.unittest.constraints

셀형 배열의 비교 연산자

페이지 내 모두 확장

설명

matlab.unittest.constraints.CellComparator 클래스는 셀형 배열의 비교 연산자를 제공합니다. 테스트에 이 비교 연산자를 사용하려면 CellComparator 인스턴스를 만들고 IsEqualTo 제약 조건 생성자의 Using 이름-값 인수 값으로 지정합니다.

생성

설명

예제

c = matlab.unittest.constraints.CellComparator는 빈 셀형 배열의 비교 연산자를 만듭니다. 이 비교 연산자는 실제 값과 예상 값이 크기가 동일한 빈 셀형 배열일 경우 충족됩니다.

예제

c = matlab.unittest.constraints.CellComparator(comp)는 지정된 비교 연산자 comp를 사용하여 셀형 배열에 포함된 값을 비교합니다. 이 구문을 사용하면 이 비교 연산자는 실제 값과 예상 값이 크기가 동일한 셀형 배열이고 해당 셀형 배열 요소가 comp 비교 연산자를 만족할 경우 충족됩니다.

예제

c = matlab.unittest.constraints.CellComparator(___,"Recursively",tf)는 셀형 배열에 포함된 값을 비교할 때 재귀적으로 동작을 수행할지 여부까지 지정합니다. tf가 true이면 중첩된 값의 동일성이 모두 확인될 때까지 재귀가 계속됩니다. 이 구문은 이전 구문의 모든 입력 인수 조합과 함께 사용할 수 있습니다.

입력 인수

모두 확장

셀형 배열에 포함된 값을 비교하는 데 사용하는 비교 연산자로, matlab.unittest.constraints 네임스페이스에서 비교 연산자로 분류되는 클래스의 객체 배열로 지정됩니다.

예: matlab.unittest.constraints.NumericComparator

예: matlab.unittest.constraints.StringComparator("IgnoringCase",true)

예: [matlab.unittest.constraints.LogicalComparator matlab.unittest.constraints.NumericComparator]

재귀적으로 동작을 수행할지 여부로, 숫자형 또는 논리값 0(false) 또는 1(true)로 지정됩니다.

값이 true이면 실제 셀형 배열과 예상 셀형 배열의 요소는 셀형 배열도 될 수 있으며, 비교 연산자는 이러한 요소를 재귀적으로 비교합니다. 값이 false이면 실제 셀형 배열과 예상 셀형 배열의 모든 요소는 comp에서 지원하는 유형을 가져야 합니다. 예를 들어, 다음 코드에서는 c1과 c2 모두 숫자형 값으로 구성된 셀형 배열을 비교할 수 있습니다. 그러나 오로지 c2만이 셀형 배열인 요소를 포함하는 셀형 배열이나 숫자형 값인 요소를 포함하는 셀형 배열을 비교할 수 있습니다.

import matlab.unittest.constraints.CellComparator
import matlab.unittest.constraints.NumericComparator

c1 = CellComparator(NumericComparator);
c2 = CellComparator(NumericComparator,"Recursively",true);

이 인수는 Recursive 속성을 설정합니다.

속성

모두 확장

재귀적으로 동작을 수행할지 여부로, 논리값 0(false) 또는 1(true)로 반환됩니다.

이 속성은 tf 입력 인수에 의해 설정됩니다.

특성:

GetAccess
public
SetAccess
private

예제

모두 축소

스크립트 열기

CellComparator 클래스로 실제 값과 예상 값을 비교합니다.

먼저 이 예제에서 사용되는 클래스를 가져옵니다.

import matlab.unittest.TestCase
import matlab.unittest.constraints.IsEqualTo
import matlab.unittest.constraints.CellComparator
import matlab.unittest.constraints.NumericComparator
import matlab.unittest.constraints.AbsoluteTolerance

대화형 방식 테스트를 위한 테스트 케이스를 생성합니다.

testCase = TestCase.forInteractiveUse;

CellComparator 인스턴스를 사용하여 2개의 빈 셀형 배열을 비교합니다. 크기가 일치하지 않으므로 테스트가 실패합니다.

testCase.verifyThat({},IsEqualTo(cell(0,2),"Using",CellComparator))

Verification failed.
    ---------------------
    Framework Diagnostic:
    ---------------------
    IsEqualTo failed.
    --> CellComparator failed.
        --> Sizes do not match.
            
            Actual size:
                 0     0
            Expected size:
                 0     2
        
        Actual Value:
          0×0 empty cell array
        Expected Value:
          0×2 empty cell array
    ------------------
    Stack Information:
    ------------------
    In C:\work\CompareValuesUsingCellComparatorExample.m (CompareValuesUsingCellComparatorExample) at 19

비어 있지 않은 셀형 배열을 비교하려면 적절한 비교 연산자를 CellComparator 생성자에 전달합니다. 예를 들어, 숫자형 값으로 구성된 셀형 배열을 자신과 비교합니다. 테스트가 통과합니다.

testCase.verifyThat({1,2,4},IsEqualTo({1,2,4}, ...
    "Using",CellComparator(NumericComparator)))

Verification passed.

{1,2,3}과 {1,2,4}를 비교합니다. 테스트가 통과하도록 하기 위해, 대응하는 요소들이 절대 허용오차 1 내에서 동일해야 한다고 지정합니다.

testCase.verifyThat({1,2,3},IsEqualTo({1,2,4}, ...
    "Using",CellComparator(NumericComparator( ...
    "Within",AbsoluteTolerance(1)))))

Verification passed.

비교 연산자가 재귀적으로 동작하도록 지시하여 숫자형 값으로 구성된 중첩 셀형 배열을 비교합니다. 중첩된 셀형 배열이 동일하지 않으므로 테스트가 실패합니다.

testCase.verifyThat({1,2,{4,8}},IsEqualTo({1,2,{4,16}}, ...
    "Using",CellComparator(NumericComparator,"Recursively",true)))

Verification failed.
    ---------------------
    Framework Diagnostic:
    ---------------------
    IsEqualTo failed.
    --> Path to failure: <Value>{3}{2}
        --> NumericComparator failed.
            --> The numeric values are not equal using "isequaln".
            --> Failure table:
                    Actual    Expected    Error    RelativeError
                    ______    ________    _____    _____________
                                                                
                      8          16        -8          -0.5     
            
            Actual Value:
                 8
            Expected Value:
                16
    
    Actual Value:
      1×3 cell array
    
        {[1]}    {[2]}    {1×2 cell}
    Expected Value:
      1×3 cell array
    
        {[1]}    {[2]}    {1×2 cell}
    ------------------
    Stack Information:
    ------------------
    In C:\work\CompareValuesUsingCellComparatorExample.m (CompareValuesUsingCellComparatorExample) at 36

팁

  • 대부분의 경우에는 CellComparator 인스턴스를 사용할 필요가 없습니다. IsEqualTo 클래스는 셀형 배열을 포함하여 다양한 데이터형의 동일성을 테스트하는 제약 조건을 만듭니다.

    IsEqualTo 클래스가 수행하는 비교를 재정의해야 하는 경우 CellComparator 인스턴스를 사용하십시오. 예를 들어, 셀형 배열이 숫자가 아닌 값을 포함하는 경우 비교가 실패하도록 하려면 테스트에 CellComparator 인스턴스를 포함하십시오. 다음 예제에서는 실제 셀형 배열과 예상 셀형 배열에 숫자형이 아닌 값이 포함되어 있으므로 MATLAB®이 오류를 발생시킵니다.

    import matlab.unittest.TestCase
import matlab.unittest.constraints.IsEqualTo
import matlab.unittest.constraints.CellComparator
import matlab.unittest.constraints.NumericComparator

testCase = TestCase.forInteractiveUse;
exp = {1,2,{3},'abc'}; 
act = exp;
testCase.verifyThat(act,IsEqualTo(exp,"Using",CellComparator(NumericComparator)))

버전 내역

R2013a에 개발됨

참고 항목

|

도움말 항목