help/calclevel

   1 NAME
   2     calclevel - current calculation level
   3
   4 SYNOPSIS
   5     calclevel()
   6
   7 TYPES
   8     return      nonnegative integer
   9
  10 DESCRIPTION
  11     This function returns the calculation level at which it is called.
  12     When a command is being read from a terminal or from a file,
  13     calc is at calculation level zero.  The level is increased
  14     by 1 each time calculation starts of a user-defined function
  15     or of eval(S) for some expression S which evaluates to a string.  It
  16     decreases to zero if an error occurs or a quit or abort statement
  17     is executed.  Otherwise, it decreases by 1 when the calculation
  18     is completed.  Except when an error occurs or abort is executed,
  19     the input level is not affected by changes in the calculation level.
  20
  21     Zero calculation level is also called top calculation level; greater
  22     values of calclevel() indicate calculation is occurring at greater
  23     depths.
  24
  25 EXAMPLE
  26     n/a
  27
  28 LIMITS
  29     none
  30
  31 LINK LIBRARY
  32     none
  33
  34 SEE ALSO
  35     eval, read, quit, abort, inputlevel
  36