Main Content

setup

类: matlab.unittest.fixtures.Fixture
命名空间: matlab.unittest.fixtures

设置脚手架

说明

示例

setup(fixture) 在测试框架设置脚手架时对环境进行更改。派生自 Fixture 接口的类必须实现 setup 方法。

当框架拆解脚手架时,脚手架必须将环境还原到其原始状态。要还原环境,请在 setup 方法中调用 addTeardown 方法,或实现 teardown 方法。

输入参数

全部展开

脚手架,指定为 matlab.unittest.fixtures.Fixture 对象。

属性

Abstracttrue

要了解方法的属性,请参阅方法属性

示例

全部展开

创建并使用自定义脚手架,它将数值的输出显示格式更改为小数点后两位数的货币格式。

在当前文件夹的名为 CurrencyFormatFixture.m 的文件中,通过子类化 matlab.unittest.fixtures.Fixture 接口来创建 CurrencyFormatFixture 类。在类中实现 setup 方法,以便脚手架将数值的显示格式更改为货币格式。要在测试后将显示格式还原到其原始状态,请在 setup 方法中调用 addTeardown 方法。

classdef CurrencyFormatFixture < matlab.unittest.fixtures.Fixture
    methods
        function setup(fixture)
            originalFormat = format;
            fixture.addTeardown(@format,originalFormat)
            format bank
        end
    end
end

在当前文件夹内名为 ExampleTest.m 的文件中,创建 ExampleTest 类,以应用自定义脚手架,并验证数值是否以预期格式显示。为了简化此示例,实际值是通过调用 formattedDisplayText 函数生成的。在实际操作中,您要测试用户定义的代码。

classdef ExampleTest < matlab.unittest.TestCase
    methods (Test)
        function formatTest(testCase)
            testCase.applyFixture(CurrencyFormatFixture)
            actual = strtrim(formattedDisplayText(pi));
            expected = "3.14";
            testCase.verifyEqual(actual,expected)
        end
    end
end

运行 ExampleTest 类。测试框架可设置脚手架,以将显示格式更改为货币格式。一旦测试运行完毕,框架就会拆解脚手架,这会还原原始显示格式。在此示例中,测试通过。

runtests("ExampleTest");
Running ExampleTest
.
Done ExampleTest
__________

提示

  • 在设置脚手架时,只有测试框架调用 setup 方法。您无法在代码中直接调用该方法。要执行 setup 中的设置操作,请通过调用 applyFixture 方法来使用脚手架。

版本历史记录

在 R2014a 中推出