Command: value
  
Syntax: 
  s = value(st)
  
Description: 
  Read the string representation of a Euphoria object, and compute
  the value of that object. A 2-element sequence, 
  {error_status, value} is actually returned, where error_status
  can be one of: (defined in include/get.e)
  
  GET_SUCCESS = 0    -- a valid object representation was found
  GET_EOF     = -1   -- end of string reached too soon
  GET_FAIL    = 1    -- syntax is wrong 
  
Comments: 
  This works the same as get(), but it reads from a string
  that you supply, rather than from a file or device.
  
Example 1: 
   s = value("12345"}
       -- s is {GET_SUCCESS, 12345}
       
Example 2: 
   s = value("{0, 1, -99.9}")
       -- s is {GET_SUCCESS, {0, 1, -99.9}}
       
Example 3: 
   s = value("+++")
       -- s is {GET_FAIL, 0}

See Also: 
  get, sprintf, print
  
