call_depth()

Returns the depth of the active call stack. The call depth can be used in conjunction with what_file and what_line to produce a call trace back. Returns the depth of the active call stack, where: 1 = depth if the function is called directly from the command line or menu, 2 = depth if the function is called from within another function.

Syntax:

call_depth();

Example:

defun test()
{
      fputs(stderr, call_depth());
}

If this example is invoked from the command line, outputs 0; when test() is invoked, outputs 1.

Where Used:

Measurement Expressions (Data Display equations and Schematic MeasEqns), Schematic, Layout, Simulation, GUI