on -- trace a function each time it's run

Synopsis

• Usage:

  on f

• Inputs:

  • f, a function
  • f
  • is an anonymous function (not assigned to a global variable)
• Outputs:

  • a function, a new function that returns the same values that f would have returned, but has a few side effects useful for debugging: upon entry, it prints its arguments, and upon exit it prints its return values. The display includes the name of f, a sequence number in parentheses that tells how many times the function has been called, and a number in brackets that gives the nesting (recursion) depth. The sequence number allows the entry and exit reports to be connected.
• Optional inputs:

  • CallLimit => an integer, default value 100000, the maximum number of times to permit the function f to be called
  • Name => a string, default value null, the name to use for the function, in case

Description