diagnose

执行诊断操作

全页展开

语法

diagnose(diagnostic)

说明

当诊断使用方（如单元测试框架）调用方法来计算诊断时，diagnose(diagnostic) 执行指定诊断的操作。

从 Diagnostic 类派生的类必须实现 diagnose 方法。当您为自定义诊断类实现此方法时，请在方法中设置 DiagnosticText 属性以使信息对诊断的使用方可用。

示例

输入参数

全部展开

诊断，指定为 matlab.automation.diagnostics.Diagnostic 对象。

属性

Abstracttrue

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

示例

全部展开

创建提供活动进程状态的自定义诊断。定义诊断的类必须从 matlab.automation.diagnostics.Diagnostic 派生，实现 diagnose 方法，并设置 DiagnosticText 属性。

在当前文件夹的名为 ProcessStatusDiagnostic.m 的文件中，通过子类化 matlab.automation.diagnostics.Diagnostic 来创建 ProcessStatusDiagnostic 类。将以下元素添加到类：

  • HeaderText 属性 - 添加此属性以在诊断构造过程中自定义诊断文本。

  • ProcessStatusDiagnostic 方法 - 实现此构造函数方法以设置 HeaderText 属性。

  • diagnose 方法 - 实现此方法以编码诊断操作。访问进程状态信息，并使用此信息设置 DiagnosticText 属性。

classdef ProcessStatusDiagnostic < matlab.automation.diagnostics.Diagnostic
    properties (SetAccess=immutable)
        HeaderText
    end

    methods
        function diagnostic = ProcessStatusDiagnostic(header)
            arguments
                header (1,1) string = "Process Status Information"
            end
            diagnostic.HeaderText = header;
        end

        function diagnose(diagnostic)
            [~,processInfo] = system("ps");
            diagnostic.DiagnosticText = diagnostic.HeaderText + ...
                newline + processInfo;
        end
    end
end

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

testCase = matlab.unittest.TestCase.forInteractiveUse;

要在测试失败时显示自定义诊断信息，请将 ProcessStatusDiagnostic 对象传递给您的鉴定方法。

testCase.verifyFail(ProcessStatusDiagnostic)
Verification failed.
    ----------------
    Test Diagnostic:
    ----------------
    Process Status Information
          PID    PPID    PGID     WINPID   TTY         UID    STIME COMMAND
        22488       1   22488      22488  ?        2964717 10:24:31 /usr/bin/ps

创建 ProcessStatusDiagnostic 对象时，通过指定可选输入来自定义诊断文本。

testCase.verifyFail(ProcessStatusDiagnostic("Status of Active Processes"))
Verification failed.
    ----------------
    Test Diagnostic:
    ----------------
    Status of Active Processes
          PID    PPID    PGID     WINPID   TTY         UID    STIME COMMAND
        22828       1   22828      22828  ?        2964717 10:24:53 /usr/bin/ps

版本历史记录

在 R2013a 中推出

另请参阅

类

主题