c_cpp/etc/calc/help/inputlevel

   1 NAME
   2     inputlevel - current input level
   3
   4 SYNOPSIS
   5     inputlevel()
   6
   7 TYPES
   8     return      nonnegative integer
   9
  10 DESCRIPTION
  11     This function returns the input level at which it is called.
  12     When calc starts, it is at level zero.  The level is increased
  13     by 1 each time execution starts of a read file command or a call to
  14     eval(S) for some expression S which evaluates to a string.  It
  15     decreases by 1 when a file being read reaches EOF or a string
  16     being eval-ed reaches '\0', or earlier if a quit statement is
  17     encountered at top calculation-level in the flle or string.  It
  18     decreases to zero if an abort statement is encountered at any
  19     function-level in the file or string.  If a quit or abort
  20     statement is encountered at top calculation-level at top input-level,
  21     calc is exited.
  22
  23     Zero input level is also called top input level; greater values
  24     of inputlevel() indicate reading at greater depths.
  25
  26 EXAMPLE
  27     n/a
  28
  29 LIMITS
  30     none
  31
  32 LINK LIBRARY
  33     none
  34
  35 SEE ALSO
  36     read, eval, quit, abort, calclevel
  37
  38 ## Copyright (C) 1999  Landon Curt Noll
  39 ##
  40 ## Calc is open software; you can redistribute it and/or modify it under
  41 ## the terms of the version 2.1 of the GNU Lesser General Public License
  42 ## as published by the Free Software Foundation.
  43 ##
  44 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  45 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  46 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  47 ## Public License for more details.
  48 ##
  49 ## A copy of version 2.1 of the GNU Lesser General Public License is
  50 ## distributed with calc under the filename COPYING-LGPL.  You should have
  51 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  52 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  53 ##
  54 ## @(#) $Revision: 30.1 $
  55 ## @(#) $Id: inputlevel,v 30.1 2007/03/16 11:10:42 chongo Exp $
  56 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/inputlevel,v $
  57 ##
  58 ## Under source code control:   1999/10/31 06:01:21
  59 ## File existed as early as:    1999
  60 ##
  61 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  62 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/