log

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

记录在脚手架设置和拆解过程中的诊断信息

全页展开

语法

log(f,diagnostic)
log(f,v,diagnostic)

说明

log(f,diagnostic) 记录提供的诊断信息。您可以使用 log 方法在测试脚手架设置和拆解例程期间记录信息。测试运行器仅在您通过添加适当的插件（例如 matlab.unittest.plugins.LoggingPlugin 实例）对其进行配置后才显示记录的消息。

示例

log(f,v,diagnostic) 按指定的详细级别 v 记录诊断信息。

示例

输入参数

全部展开

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

要显示的诊断信息，指定为字符串数组、字符数组、函数句柄或 matlab.automation.diagnostics.Diagnostic 对象数组。

详细级别，指定为从 1 到 4 的整数标量、matlab.automation.Verbosity 枚举对象或枚举的文本表示。默认情况下，该方法对诊断消息使用 Concise 详细级别。

数值表示枚举成员名称详细程度描述
1Terse

最少的信息

2Concise

适中信息量

3Detailed

部分补充信息

4Verbose

大量补充信息

示例

全部展开

在您的当前工作文件夹下的文件 FormatHexFixture.m 中，创建以下脚手架。

classdef FormatHexFixture < matlab.unittest.fixtures.Fixture
    properties (Access=private)
        OriginalFormat
    end
    methods
        function setup(fixture)
            fixture.OriginalFormat = format().NumericFormat;
            fixture.log(['The previous format setting was ',...
                fixture.OriginalFormat])
            log(fixture,'Setting Format')
            format('hex')
            log(fixture,3,'Format Set')
        end
        function teardown(fixture)
            log(fixture,'Resetting Format')
            format(fixture.OriginalFormat)
            log(fixture,3,'Original Format Restored')
        end
    end
end

在您的当前工作文件夹下的文件 SampleTest.m 中，创建以下测试类。

classdef SampleTest < matlab.unittest.TestCase
    methods (Test)
        function test1(testCase)
            testCase.applyFixture(FormatHexFixture);
            actStr = getColumnForDisplay([1;2;3], 'Small Integers');
            expStr = ['Small Integers  '
                '3ff0000000000000'
                '4000000000000000'
                '4008000000000000'];
            testCase.verifyEqual(actStr, expStr)
        end
    end
end

function str = getColumnForDisplay(values, title)
elements = cell(numel(values)+1, 1);
elements{1} = title;
for idx = 1:numel(values)
    elements{idx+1} = displayNumber(values(idx));
end
str = char(elements);
end

function str = displayNumber(n)
str = strtrim(evalc('disp(n);'));
end

运行测试。

result = run(SampleTest);
Running SampleTest
.
Done SampleTest
__________

已记录的消息都没有显示，因为默认测试运行器的详细级别为 1 (Terse)，而默认日志消息的级别为 2 (Concise)。

创建一个用于报告级别 1、级别 2 和级别 3 的诊断的测试运行器，并重新运行该测试。

import matlab.unittest.TestRunner
import matlab.unittest.plugins.LoggingPlugin

ts = matlab.unittest.TestSuite.fromClass(?SampleTest);
runner = TestRunner.withNoPlugins;
p = LoggingPlugin.withVerbosity(3);
runner.addPlugin(p);

results = runner.run(ts);
 [Concise] Diagnostic logged (2022-09-30T15:36:46):
The previous format setting was 
short

 [Concise] Diagnostic logged (2022-09-30T15:36:46): Setting Format
[Detailed] Diagnostic logged (2022-09-30T15:36:46): Format Set
 [Concise] Diagnostic logged (2022-09-30T15:36:47): Resetting Format
[Detailed] Diagnostic logged (2022-09-30T15:36:47): Original Format Restored

版本历史记录

在 R2014b 中推出

另请参阅

类