dbstatus

List all breakpoints during debugging.

📝Syntax

dbstatus
dbstatus file
dbstatus -completenames
dbstatus file -completenames
b = dbstatus(...)

📥Input Arguments

Parameter	Description
file	Only the breakpoints of this file are listed; the error breakpoints are not included.
-completenames	Shows the full path of the file followed by the function name instead of the function name alone.

📤Output Arguments

Parameter	Description
b	Structure array listing breakpoints currently in effect.

📄Description

dbstatus lists all breakpoints currently set, one line per file: Breakpoint for buggy is on line 3. or Breakpoints for buggy are on lines 2, 3., followed by the condition of each conditional breakpoint, then by Stop if error. and Stop if caught error. when these error breakpoints are set.

Assigning the output to a variable b allows you to save and restore breakpoints later using dbstop(b).

The output structure array b contains one element per file with breakpoints and one element per error breakpoint. Each element contains:

name: function name (empty for an error breakpoint)
file: full path to the file containing the breakpoints
line: row vector of breakpoint line numbers
anonymous: row vector of zeros (anonymous function breakpoints are not supported)
expression: cell row of the conditions, one per line, empty when unconditional
cond: 'error' or 'caught error' for an error breakpoint, empty otherwise
identifier: {'all'} for an error breakpoint, empty otherwise

💡Examples

List all breakpoints in effect.

dbstop in myfile
dbstatus
dbstatus -completenames

Save current breakpoints and restore them later.

b = dbstatus();
save saved_breakpoints b
dbclear all
load saved_breakpoints
dbstop(b)

🔗See Also

dbstop dbclear dbquit dbstack

🕔Version History

Version	Description
1.16.0	initial version
2.0.0	file filter, -completenames, seven-field structure with conditions and error breakpoints

Edit this page on GitHub