F$INPUT()

Description

F$INPUT() is used to return the last user entered input as a string.

Call Signature

string F$INPUT ( )

Return Value

string

An empty string "" is returned if no user input has yet occurred.

Example

The following example will loop requesting input and handle exceptional circumstances by examining the value of F$ERRNUM and F$INPUT.

 local integer value

 main_loop: \
 while( 1 > 0 )
     input "Value > " value onerror goto error_handler
     print "You entered:",value
 endwhile

 error_handler: \
    if( F$INPUT = "bye" ) return
    value = 0
    print "Error number ",F$ERRNUM," has occurred on input:",F$INPUT
    goto main_loop