Main Content

verifyUsing

类： matlab.unittest.plugins.QualifyingPlugin
包： matlab.unittest.plugins

确认值满足给定约束

全页展开

语法

verifyUsing(plugin,context,actual,constraint)
verifyUsing(plugin,context,actual,constraint,diagnostic)

说明

verifyUsing(plugin,context,actual,constraint) 使用验证 context 确认 actual 是满足给定约束 constraint 的值。如果实际值不满足该约束，测试框架会报告发生确认失败。

在以下 QualifyingPlugin 方法中，可以执行验证：

  • setupTestClass

  • teardownTestClass

  • setupTestMethod

  • teardownTestMethod

verifyUsing(plugin,context,actual,constraint,diagnostic) 在失败时显示诊断信息 diagnostic。

输入参数

全部展开

插件实例，指定为 matlab.unittest.plugins.QualifyingPlugin 类的实例。

插件的上下文，指定为 matlab.unittest.plugins.plugindata.QualificationContext 类的实例。此实例为插件提供上下文以对测试套件执行验证。该插件从插件数据中获取此上下文。

要测试的值，指定为工作区变量。actual 可以是任意数据类型。当 actual 满足指定的约束 constraint 时，验证会通过。

测试必须满足的条件，指定为 matlab.unittest.constraints 包中的类的实例。

失败时要显示的诊断信息，指定为字符串、字符向量、函数句柄或 matlab.unittest.diagnostics 包中的类的实例。

示例

在插件中使用验证

请参阅 QualifyingPlugin 类的示例。

提示

使用 QualifyingPlugin.verifyUsing 方法可在不引发异常的条件下生成和记录失败。因为 QualifyingPlugin 执行的附加验证超出了在单元测试中定义的范围，所以它通常会使用确认。确认不会导致测试提前退出，从而可确保测试框架执行所有测试内容。使用其他验证类型来测试是否违反先决条件或测试安装是否正确。或者，

  • 使用 QualifyingPlugin.assumeUsing 方法确保测试环境满足无论如何都不会导致测试失败的先决条件。假设失败会生成已筛选的测试，且测试框架会将测试设为 Incomplete。

  • 如果失败情况导致当前测试内容的剩余部分失效，但不会阻止后续测试方法正确执行，则使用 QualifyingPlugin.assertUsing 方法。断言点处的失败会将当前测试方法展现为失败且未完成。

  • 使用 QualifyingPlugin.fatalAssertUsing 方法可在失败时中止测试会话。当失败涉及根本以致没必要继续测试时，这种验证会很有用。当脚手架拆解未能正确还原 MATLAB® 状态，适合中止测试并启动一个新会话时，这些验证也很有用。

版本历史记录

在 R2015b 中推出

另请参阅