Command: get
  
Syntax: 
  include get.e
  s = get(fn)
  
Description: 
  Input, from file fn, a human-readable string of characters 
  representing a Euphoria object. Convert the string into the 
  numeric value of that object. s will be a 2-element sequence: 
  {error status, value}. Error status values are:
  
  GET_SUCCESS  -- object was read successfully
  GET_EOF      -- end of file before object was read
  GET_FAIL     -- object is not syntactically correct
  
  get() can read arbitrarily complicated Euphoria objects. You 
  could have a long sequence of values in braces and separated by 
  commas, e.g. {23, {49, 57}, 0.5, -1, 99, 'A', "john"}. A single
  call to get() will read in this entire sequence and return it's
  value as a result. 
  
  Each call to get() picks up where the previous call left off. For 
  instance, a series of 5 calls to get() would be needed to read 
  in: 
  
  99  5.2  {1,2,3}  "Hello"  -1
  
  On the sixth and any subsequent call to get() you would see a
  GET_EOF status. If you had something like:
  
  {1,2,xxx}
  
  in the input stream you would see a GET_FAIL error status
  because xxx is not a Euphoria object.
  
  Distinct "top-level" objects in the input stream must be 
  separated from each other with one or more "whitespace" 
  characters (blank, tab or \n). Whitespace is not necessary 
  *within* a top-level object.
  
Comments: 
  The combination of print() and get() can be used to save any 
  Euphoria object to disk and later read it back. This technique
  could be used to implement a database as one or more large 
  Euphoria sequences stored in disk files. The sequences could be
  read into memory, updated and then written back to disk after
  each series of transactions is complete. 
  
  The value returned is not meaningful unless you have a 
  GET_SUCCESS status.
  
Example: 
     Suppose your program asks the user to enter a number from the
        keyboard. If he types 77.5, get(0) would return:
         
         {GET_SUCCESS, 77.5} 
        
        whereas gets(0) would return
          
          "77.5\n" 
 
Example Program: 
 see demo\mydata.ex. 

See Also: 
  print, value, gets, getc
  
