help/eval

   1 NAME
   2     eval - evaluate a string
   3
   4 SYNOPSIS
   5     eval(str)
   6
   7 TYPES
   8     str         string
   9
  10     return      any
  11
  12 DESCRIPTION
  13    For eval(str), the value of str is to be a string that could be the body
  14    of the definition of a function f().  This string may declare local
  15    variables and include keywords (while, for, ...) other than the
  16    reserved keywords (define, show, help, read, write, show, cd) intended
  17    for interactive use or for reading from a file.
  18
  19    If str is the empty string "", eval(str) returns the null value.
  20
  21    The call to eval(str) may return a value by explicit use of a return
  22    statement: "return;" returns the null value, "return expr;" returns the
  23    value of expr.  If execution reaches the end of str and the
  24    value on the execution stack is not null, eval(str) returns that value;
  25    otherwise eval(str) returns the most recently saved value.
  26
  27    Each time eval(str) is called, a temporary function is compiled from
  28    the commands in str, and if there are no syntax errors, this function
  29    is then evaluated.  If str contains syntax errors, eval(str) displays
  30    the scanerror messages and returns the value error(49).
  31
  32 EXAMPLE
  33    > str1 = "2 + 3"; print eval(str1);
  34    5
  35
  36    > i = 10; str2 = "local i = 0; 7; while (i++ < 5) print i^2,:;"
  37    > print i, eval(str2), i
  38    10 1 4 9 16 25 7 10
  39
  40    (The print statements in str2 return the null value, so execution of
  41    eval(str2) ends by returning the saved value 7.  The global variable
  42    i is unchanged.)
  43
  44    > eval("2 + ");
  45    Missing expression
  46         49
  47
  48 LIMITS
  49    The string str in eval(str) should not include a call to itself as in
  50
  51         str = "2 + eval(str)"
  52
  53    For this str, eval(str) causes an "Evaluation stack depth exceeded" error.
  54    Similarly, if str1 = "2 + eval(str2)", str2 should not include a call
  55    to eval(str1), etc.
  56
  57 LINK LIBRARY
  58    none
  59
  60 SEE ALSO
  61     command, expression, define, prompt
  62