dbstatus (MATLAB Functions)

List all breakpoints

Graphical Interface

Part of the information shown by dbstatus (namely, the breakpoint line numbers) is displayed graphically via the breakpoint icons when the file is open in the Editor/Debugger.

Syntax

dbstatus
dbstatus mfile
dbstatus('-completenames')
s = dbstatus(...)

Description

dbstatus lists all the breakpoints in effect including errors, caught errors, warnings, and naninfs.

dbstatus mfile displays a list of the line numbers for which breakpoints are set in the specified M-file, where mfile is an M-file function name or a MATLAB relative partial pathname. Each line number is a hyperlink you can click to go directly to that line in the Editor/Debugger.

dbstatus('-completenames') displays, for each breakpoint, the absolute filename and the sequence of functions that nest the function containing the breakpoint.

s = dbstatus(...) returns breakpoint information in an m-by-1 structure with the fields

name
Function name.

file
Full pathname for file containing breakpoints.

line
Vector of breakpoint line numbers.

anonymous
Vector of integers representing the anonymous functions in the line field. For example, 2 means the second anonymous function in that line. A value of 0 means the breakpoint is at the start of the line, not in an anonymous function.

expression
Cell vector of breakpoint conditional expression strings corresponding to lines in the line field.

cond
Condition string ('error', 'caught error', 'warning', or 'naninf').

identifier
When cond is 'error', 'caught error', or 'warning', a cell vector of MATLAB message identifier strings for which the particular cond state is set.

`name`	Function name.
`file`	Full pathname for file containing breakpoints.
`line`	Vector of breakpoint line numbers.
`anonymous`	Vector of integers representing the anonymous functions in the `line` field. For example, `2` means the second anonymous function in that line. A value of `0` means the breakpoint is at the start of the line, not in an anonymous function.
`expression`	Cell vector of breakpoint conditional expression strings corresponding to lines in the `line` field.
`cond`	Condition string (`'error'`, `'caught error'`, `'warning'`, or `'naninf'`).
`identifier`	When `cond` is `'error'`, `'caught error'`, or `'warning'`, a cell vector of MATLAB message identifier strings for which the particular `cond` state is set.

Use dbstatus class/function, dbstatus private/function, or dbstatus class/private/function to determine the status for methods, private functions, or private methods (for a class named class).

In all forms you can further qualify the function name with a subfunction name, as in dbstatus function>subfunction.

Remarks

In the syntax, mfile can be an M-file, or the path to a function within a file. For example

```
Breakpoint for foo>mfun is on line 9
```

means there is a breakpoint at the myfun subfunction, which is line 9 in the file foo.m.

See Also

dbclear, dbcont, dbdown, dbquit, dbstack, dbstep, dbstop, dbtype, dbup, error, partialpath, warning

dbstack dbstep