Main Content

verifySameHandle

类: matlab.unittest.qualifications.Verifiable
命名空间: matlab.unittest.qualifications

验证两个句柄数组是否相同

全页展开

语法

verifySameHandle(testCase,actual,expected)
verifySameHandle(testCase,actual,expected,diagnostic)

说明

示例

verifySameHandle(testCase,actual,expected) 验证 actual 是否与预期的句柄数组相同。如果两个句柄数组具有相同的大小，并且它们对应的元素引用相同的句柄对象，则它们相同。

示例

verifySameHandle(testCase,actual,expected,diagnostic) 还将 diagnostic 中的诊断信息与鉴定相关联。

输入参数

全部展开

测试用例，指定为 matlab.unittest.qualifications.Verifiable 对象。由于 matlab.unittest.TestCase 类会子类化 matlab.unittest.qualifications.Verifiable 并继承其方法，因此 testCase 通常是 matlab.unittest.TestCase 对象。

要测试的值，指定为任何数据类型的值。虽然您可以提供任何数据类型的值，但如果 actual 不是句柄数组，测试将失败。

预期值，指定为句柄数组。

当鉴定通过或失败时显示的诊断信息，指定为字符串数组、字符数组、函数句柄或 matlab.automation.diagnostics.Diagnostic 对象数组。

根据测试运行器的配置，测试框架可能会在鉴定通过或失败时显示诊断信息。默认情况下，框架仅在鉴定失败时显示诊断信息。您可以通过自定义测试运行器来覆盖默认行为。例如，使用 DiagnosticsOutputPlugin 实例来显示失败和通过事件诊断信息。

示例: "My Custom Diagnostic"

示例: @dir

属性

Sealedtrue

要了解方法的属性，请参阅方法属性。

示例

全部展开

打开脚本

测试 actual 值是否与指定的句柄数组相同。

在当前文件夹下的文件中，创建 ExampleHandle 句柄类。

classdef ExampleHandle < handle
    properties
        Number = 1;
    end
end

创建两个 ExampleHandle 对象，将它们分别赋给变量 h1 和 h2。然后，将 h2 的值赋给另一个变量 h3。变量 h1 和 h2 指向不同对象，但变量 h2 和 h3 指向相同的对象。

h1 = ExampleHandle;
h2 = ExampleHandle;
h3 = h2;

创建一个供交互测试的测试用例。

testCase = matlab.unittest.TestCase.forInteractiveUse;

测试 h1 和 h2 是否指向同一个对象。测试失败。

verifySameHandle(testCase,h1,h2,"Values must point to the same object.")

Verification failed.
    ----------------
    Test Diagnostic:
    ----------------
    Values must point to the same object.
    ---------------------
    Framework Diagnostic:
    ---------------------
    verifySameHandle failed.
    --> Values do not refer to the same handle.
    
    Actual Value:
      ExampleHandle with properties:
    
        Number: 1
    Expected Handle Object:
      ExampleHandle with properties:
    
        Number: 1
    ------------------
    Stack Information:
    ------------------
    In C:\work\TestHandlesForEqualityExample.m (TestHandlesForEqualityExample) at 29

验证 h2 和 h3 指向同一个对象。

verifySameHandle(testCase,h2,h3)

Verification passed.

验证 [h2 h3] 和 [h3 h2] 是否相同。测试通过，因为对应的向量元素指向同一个对象。

verifySameHandle(testCase,[h2 h3],[h3 h2])

Verification passed.

测试 [h1 h2] 和 [h2 h1] 是否相同。测试失败，因为对应的向量元素指向不同对象。

verifySameHandle(testCase,[h1 h2],[h2 h1])

Verification failed.
    ---------------------
    Framework Diagnostic:
    ---------------------
    verifySameHandle failed.
    --> Some elements in the handle array refer to the wrong handle.
    
    Actual Value:
      1×2 ExampleHandle array with properties:
    
        Number
    Expected Handle Object:
      1×2 ExampleHandle array with properties:
    
        Number
    ------------------
    Stack Information:
    ------------------
    In C:\work\TestHandlesForEqualityExample.m (TestHandlesForEqualityExample) at 43

测试两个不同形状的句柄数组是否相同。测试失败。

verifySameHandle(testCase,[h1 h1 h2 h3],[h1 h1; h2 h3])

Verification failed.
    ---------------------
    Framework Diagnostic:
    ---------------------
    verifySameHandle failed.
    --> Sizes do not match.
        	Actual Value Size           : [1  4]
        	Expected Handle Object Size : [2  2]
    
    Actual Value:
      1×4 ExampleHandle array with properties:
    
        Number
    Expected Handle Object:
      2×2 ExampleHandle array with properties:
    
        Number
    ------------------
    Stack Information:
    ------------------
    In C:\work\TestHandlesForEqualityExample.m (TestHandlesForEqualityExample) at 48

提示

  • verifySameHandle 方法非常方便。例如，verifySameHandle(testCase,actual,expected) 在功能上等效于以下代码。

    import matlab.unittest.constraints.IsSameHandleAs
testCase.verifyThat(actual,IsSameHandleAs(expected))

  • 使用此确认在不引发异常的条件下生成和记录失败。由于确认不会引发异常，因此即使出现确认失败的情形，依然会完成所有的测试内容。通常，确认指的是对单元测试的主要鉴定，因为这些确认一般不要求提前从测试中退出。使用其他鉴定类型来测试是否违反先决条件或测试安装是否正确：

    • 使用断言鉴定确保测试环境满足无论如何都不会导致测试失败的先决条件。假设失败会生成已过滤的测试，且测试框架会将测试设为 Incomplete。有关详细信息，请参阅 matlab.unittest.qualifications.Assumable。

    • 当失败条件导致当前测试内容的剩余部分都失效，但不会阻止后续测试正确执行时，使用断言鉴定。断言点处的失败会将当前测试展现为 Failed 和 Incomplete。有关详细信息，请参阅 matlab.unittest.qualifications.Assertable。

    • 使用致命断言鉴定在失败时中止测试会话。当失败涉及根本以致继续测试已经没有意义时，这些鉴定非常有用。当脚手架拆解不能正确还原环境状态，适合中止测试并启动一个新会话时，致命断言也很有用。有关详细信息，请参阅 matlab.unittest.qualifications.FatalAssertable。

版本历史记录

在 R2013a 中推出

全部展开

另请参阅

| | | |

主题