break

Syntax

break [ location ] [ if condition ]

{ [module.]function
| [module:]line
}

1. module is the name of a source file, without extension.
2. function is a function name.
3. line is a source code line.
4. condition is an expression evaluated dynamically.

Usage

The break command sets a break point at a given source code line of the program.

When the program is running, the debugger stops automatically at breakpoints defined by this command.

If a condition is specified, the program stops at the breakpoint only if the condition evaluates to true. For example, with break 10 if var = 1, the debugger adds a conditional breakpoint at line 10, and stops the program execution at line 10 if the var variable is equal to 1.

If you do not specify any location, the breakpoint is created for the current line.

Breakpoints are defined on source code lines with executable instructions. When the break command specifies a function name or a line number that does not contain an executable instruction, the debugger automatically selects the next executable line. For example, if you enter break main, the breakpoint will be defined on the first executable line in the MAIN block.

Use the info breakpoints command to list existing breakpoints.

Use the enable / disable commands to activate / deactivate breakpoints.

Use the delete or clear command to remove a breakpoint.