Next: , Previous: Help, Up: Top


13 Debugger

Asymptote now includes a line-based (as opposed to code-based) debugger that can assist the user in following flow control. To set a break point in file file at line line, use the command

void stop(string file, int line, code s=quote{});
The optional argument s may be used to conditionally set the variable ignore in plain_debugger.asy to true. For example, the first 10 instances of this breakpoint will be ignored (the variable int count=0 is defined in plain_debugger.asy):
stop("test",2,quote{ignore=(++count <= 10);});

To set a break point in file file at the first line containing the string text, use

void stop(string file, string text, code s=quote{});
To list all breakpoints, use:
void breakpoints();
To clear a breakpoint, use:
void clear(string file, int line);
To clear all breakpoints, use:
void clear();

The following commands may be entered at the debugging prompt:

h
help;
c
continue execution;


i
step to the next instruction;


s
step to the next executable line;


n
step to the next executable line in the current file;


f
step to the next file;


r
return to the file associated with the most recent breakpoint;


t
toggle tracing (-vvvvv) mode;


q
quit debugging and end execution;


x
exit the debugger and run to completion.
Arbitrary Asymptote code may also be entered at the debugging prompt; however, since the debugger is implemented with eval, currently only top-level (global) variables can be displayed or modified.

The debugging prompt may be entered manually with the call

void breakpoint(code s=quote{});