dbstatus

列出所有断点

语法

dbstatus

dbstatus file

dbstatus -completenames

dbstatus file -completenames

b = dbstatus(___)

说明

dbstatus 列出所有有效断点，包括错误、捕获的错误、警告和 naninfs。对于非错误断点，MATLAB^® 将显示设置断点的行号。每个行号都是一个超链接，点击后可以直接转到编辑器中的该行。

dbstatus file 将列出对于指定 file 有效的所有断点。

dbstatus -completenames 将为每个断点显示包含该断点的函数或文件的完全限定名称。

dbstatus file -completenames 将为指定文件中的每个断点显示包含该断点的函数或文件的完全限定名称。

b = dbstatus(___) 将以 m×1 结构体形式返回断点信息。要保存当前断点以便以后使用 dbstop(b) 还原它们，请使用此语法。您还可以指定文件名和 'completenames'。

示例

列出所有断点

创建文件 myfile.m，其中包含以下语句。

function n = myfile(x)
n = myfunction(x-1);

function z = myfunction(y)
z = 2/y ;

设置一个错误断点，并在 myfile 的第一行设置一个标准断点。

dbstop if error
dbstop in myfile

运行 dbstatus 命令。MATLAB 显示活动断点，其中包括 myfile 中的标准断点以及错误断点。

dbstatus

Breakpoint for myfile is on line 2.
Stop if error.

列出文件中的所有断点

列出指定文件中的所有断点，显示完整的名称。

创建文件 myfile.m，其中包含以下语句。

function n = myfile(x)
n = myfunction(x-1);

function z = myfunction(y)
z = 2 / y ;

设置一个错误断点，并在 myfile 的第一行设置一个标准断点。

dbstop if error
dbstop in myfile

运行 dbstatus 命令，指定文件 myfile 并请求完整名称。MATLAB 将显示活动断点，其中包括 myfile 中的标准断点以及错误断点。

dbstatus myfile -completenames

Breakpoint for C:\myProject\myfile.m>myfile is on line 2.

请注意，错误断点并未列出。列表中只包括特定于指定文件的断点。

恢复保存的断点

设置、保存、清除并还原保存的断点。

创建文件 buggy.m，其中包含以下语句。

function z = buggy(x)
n = length(x);
z = (1:n)./x;

设置一个错误断点，并在 buggy 的第二行设置一个标准断点。

dbstop at 2 in buggy
dbstop if error

运行 dbstatus。MATLAB 描述您所设置的断点。

dbstatus

Breakpoint for buggy is on line 2.
Stop if error.

将代表断点的结构体赋值给变量 b，然后将 b 保存到 MAT 文件 buggybrkpnts。使用 b=dbstatus('-completenames') 保存绝对路径和断点功能嵌套顺序。

b = dbstatus('-completenames');
save buggybrkpnts b

清除全部断点。

dbclear all

通过加载 MAT 文件并对已保存结构体 b 调用 dbstop 来还原断点。

load buggybrkpnts
dbstop(b)

输入参数

file — 文件名

字符向量 | 字符串标量

文件名，指定为字符向量或字符串标量。文件名称可以包括部分路径，但必须位于搜索路径上的文件夹中或当前文件夹中。

示例: myfile.m

指定方法、私有函数或私有方法时，请使用 / 字符。

示例: myclass/myfunction

示例: private/myfunction

示例: myclass/private/myfunction

此外，file 可以包括一个文件标记 (>)，用来指定到特定局部函数或到文件内的嵌套函数的路径。

示例: myfile>myfunction

数据类型: char | string

输出参量

b — 断点列表

结构体数组

当前有效的断点的列表，以 m×1 结构体形式返回，其中 m 是断点数量。下表显示了结构体中的字段。

name	函数名称。
file	包含断点的文件的完整路径。
line	断点行号的向量。
anonymous	整数的向量，其中各整数代表由 line 字段表示的行号中的匿名函数。例如，2 表示该行中的第 2 个匿名函数。0 值表示该断点位于行开头，不在匿名函数中。
expression	字符向量的元胞向量，包含对应于 line 字段中的行号的断点条件表达式。
cond	包含条件（'error'、'caught error'、'warning' 或 'naninf'）的字符向量。
identifier	如果 cond 是 'error'、'caught error' 或 'warning'，该字段是一个字符向量元胞向量，包含设置了该特定 cond 状态的 MATLAB 消息标识符。

版本历史记录

在 R2006a 之前推出

另请参阅

dbclear | dbcont | dbquit | dbstop | error | warning