Macaulay2 » Documentation
Packages » Macaulay2Doc :: step
next | previous | forward | backward | up | index | toc

step -- step by single lines in the debugger

Synopsis

Description

One useful way to debug code suspected of being in error is to insert an explicit error message, such as error "debug me", and start stepping from there, as in the following demonstration.

i1 : load "Macaulay2Doc/demo2.m2"
 
i2 : code f

o2 = /usr/local/share/Macaulay2/Macaulay2Doc/
     demo2.m2:6:6-11:12: --source code:
     f = t -> (
          x := 1;
          error "debug me";
          y := t+1;
          z := 1/t;
          w := x+t;
          )
 
i3 : f 0
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:8:6:(3):[1]: error: debug me
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:8:6:(3):[1]: --entering debugger (type help to see debugger commands)
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:
8:5-8:5: --source code:
     error "debug me";
 
ii4 : return
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:9:8:(3):[1]: --stepping limit reached
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:9:8:(3):[1]: --entering debugger (type help to see debugger commands)
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:
9:7-9:12: --source code:
     y := t+1;
 
ii5 : disassemble current

oo5 = (local-assign 2 0 (2-OP + (fetch 0 0) 1))
 
ii6 : step(-3)
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:9:8:(3):[1]: --evaluating: (local-assign 2 0 (2-OP + (fetch 0 0) 1))
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:9:12:(3):[1]: --evaluating: (2-OP + (fetch 0 0) 1)
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:9:11:(3):[1]: --evaluating: (fetch 0 0)
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:9:13:(3):[1]: --stepping limit reached
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:9:13:(3):[1]: --entering debugger (type help to see debugger commands)
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:
9:12-9:12: --source code:
     y := t+1;
 
ii7 : step
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:10:8:(3):[1]: --stepping limit reached
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:10:8:(3):[1]: --entering debugger (type help to see debugger commands)
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:
10:7-10:12: --source code:
     z := 1/t;
 
ii8 : step
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:10:12:(3):[1]: error: division by zero
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:10:12:(3):[1]: --entering debugger (type help to see debugger commands)
/usr/local/share/Macaulay2/Macaulay2Doc/demo2.m2:
10:10-10:12: --source code:
     z := 1/t;
 
ii9 : t

oo9 = 0

See also

For the programmer

The object step is a keyword.