getReport

获取异常的错误消息

语法

msgText = getReport(exception)

msgText = getReport(exception,type)

msgText = getReport(exception,type,'hyperlinks',hlink)

msgText = getReport(exception) 获取异常错误消息并以格式化文本 msgText 的形式返回。消息是 MException 对象 exception 的 message 属性的值。这是 MATLAB^® 在引发异常时显示的相同文本。

msgText = getReport(exception,type) 使用由 type 指定的特定详细信息级别返回错误消息。

msgText = getReport(exception,type,'hyperlinks',hlink) 使用 hlink 的值确定是否将失败代码行的有效超链接包含在错误消息内。

导致 MATLAB 引发异常。

plus

Error using +
Not enough input arguments.

从异常获取错误消息。

exception = MException.last;
msgText = getReport(exception)

msgText =

Error using +
Not enough input arguments.

在当前工作文件夹下的文件中，在 testFunc.m 中创建以下函数。

function a = testFunc
try
    a = notaFunction(5,6);
catch a

end

由于函数 notaFunction 不存在，testFunc 返回一个 MException 对象。

在命令提示符处，调用 testFunc 并获取错误消息。

m = testFunc;
msgText = getReport(m)

msgText =

Undefined function 'notaFunction' for input arguments of type 'double'.

Error in testFunc (line 3)
    a = notaFunction(5,6);

指定错误消息仅包含错误消息，不包含堆栈信息。

msgText = getReport(m,'basic')

msgText =

Undefined function 'notaFunction' for input arguments of type 'double'.

导致 MATLAB 引发异常。

try 
    surf
catch exception
end

从异常获取错误消息。

msgText = getReport(exception)

msgText =

Error using surf (line 49)
Not enough input arguments.

获取错误消息，但没有指向 surf.m 的有效超链接。

msgText = getReport(exception,'extended','hyperlinks','off')

msgText =

Error using surf (line 49)
Not enough input arguments.

提供错误消息的异常对象，指定为标量 MException 对象。

返回的消息的详细级别指示符，指定为 'extended' 或 'basic'。

`type` 值	`msgText` 详细信息级别
`'extended'`（默认值）	`msgText` 包含行号、错误消息、原因和堆栈摘要。要显示合适的堆栈，MATLAB 首先必须引发异常。
`'basic'`	`msgText` 包含错误消息。

消息的超链接指示符，包含指向失败代码行的有效超链接，指定为 'default'、'on' 或 'off'。

`hlink` 值	操作
`'default'`	使用命令行窗口的默认值确定是否在错误消息中使用超链接。
`'on'`	显示指向失败代码行的超链接（默认值）。
`'off'`	不显示指向失败代码行的超链接。