Difference between revisions of "MC-Basic:ADDBREAKPOINT"
| (13 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| + | {{Languages|MC-Basic:ADDBREAKPOINT}} | ||
{{MC-Basic | {{MC-Basic | ||
|SHORT FORM= | |SHORT FORM= | ||
| Line 4: | Line 5: | ||
|SYNTAX= | |SYNTAX= | ||
| − | AddBreakPoint '' | + | AddBreakPoint <''file name''> <''program line number''> {<''taskname''>} |
|AVAILABILITY= | |AVAILABILITY= | ||
| Line 10: | Line 11: | ||
|DESCRIPTION= | |DESCRIPTION= | ||
| − | This command inserts a breakpoint in the task or library functions/subroutines at the specified program line number. When the breakpoint is reached, the | + | This command inserts a breakpoint in the task or library functions/subroutines at the specified program line number. When the breakpoint is reached, the softMC halts execution of the task and sends a message to the host that the breakpoint has been reached. |
When a breakpoint is reached, the task switches to the idle state. Program execution is resumed by issuing the CONTINUETASK command, or by using the program debugging commands: STEPIN, STEPOVER, and STEPOUT. | When a breakpoint is reached, the task switches to the idle state. Program execution is resumed by issuing the CONTINUETASK command, or by using the program debugging commands: STEPIN, STEPOVER, and STEPOUT. | ||
|TYPE= | |TYPE= | ||
| − | '' | + | <''program line number''>: Long |
|RANGE= | |RANGE= | ||
| − | '' | + | <''file name''>: Name of a task that is loaded in memory (May be program or library) <br> |
| − | '' | + | <''program line number''>: 1 to MaxLong<br> |
| − | '' | + | {<''taskname''>}: Name of program, <font color="red"> using that is loaded in memory. |
| − | + | '' ''It's the option, what is useful for library, where taskname and file name are not the same. If the task name is not specified, breakpoint will be valid (global) for all the tasks that pass through the specified file and line.</font color> | |
|UNITS= | |UNITS= | ||
| Line 34: | Line 35: | ||
|LIMITATIONS= | |LIMITATIONS= | ||
| − | Write | + | Write only. The task must be loaded into memory. |
|EXAMPLE= | |EXAMPLE= | ||
| Line 42: | Line 43: | ||
|SEE ALSO= | |SEE ALSO= | ||
| − | * [[ | + | * [[MC-Basic:CLEARBREAKPOINT|CLEARBREAKPOINT]] |
| − | * [[ | + | * [[MC-Basic:CONTINUETASK|CONTINUETASK]] |
| − | * [[ | + | * [[MC-Basic:STEPIN|STEPIN]] |
| − | * [[ | + | * [[MC-Basic:STEPOUT|STEPOUT]] |
| − | * [[ | + | * [[MC-Basic:STEPOVER|STEPOVER]] |
* [[AXY:MC-Basic:SERCMAXPOS|SERCMAXPOS]] | * [[AXY:MC-Basic:SERCMAXPOS|SERCMAXPOS]] | ||
* [[AXY:MC-Basic:SERCMINPOS|SERCMINPOS]] | * [[AXY:MC-Basic:SERCMINPOS|SERCMINPOS]] | ||
| − | [[Category | + | [[Category:MC-Basic:Debug Tools|ADDBREAKPOINT]] |
}} | }} | ||
Latest revision as of 03:03, 17 April 2017
| Language: | English • 中文（简体） |
|---|
This command inserts a breakpoint in the task or library functions/subroutines at the specified program line number. When the breakpoint is reached, the softMC halts execution of the task and sends a message to the host that the breakpoint has been reached.
When a breakpoint is reached, the task switches to the idle state. Program execution is resumed by issuing the CONTINUETASK command, or by using the program debugging commands: STEPIN, STEPOVER, and STEPOUT.
Short form
ABPoint
Syntax
AddBreakPoint <file name> <program line number> {<taskname>}
Availability
Up to 0. 4.2.1 version
Type
<program line number>: Long
Range
<file name>: Name of a task that is loaded in memory (May be program or library)
<program line number>: 1 to MaxLong
{<taskname>}: Name of program, using that is loaded in memory.
It's the option, what is useful for library, where taskname and file name are not the same. If the task name is not specified, breakpoint will be valid (global) for all the tasks that pass through the specified file and line.
Scope
Terminal
Limitations
Write only. The task must be loaded into memory.
Examples
AddBreakPoint MAKECUT.prg 20
AddBreakPoint user.lib 1001 mytask.prg