home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / misc / arpdoc13.lzh / ASK < prev    next >
Encoding:
Text File  |  1989-06-30  |  1.9 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      Ask(V1.3)               ARP User's Manual               Ask(V1.3)
  5.  
  6.  
  7.  
  8.      NAME
  9.           Ask - Query user interactively.
  10.  
  11.      SYNOPSIS
  12.           Ask Prompt WARN OK TIMEOUT
  13.  
  14.      DESCRIPTION
  15.           Ask is a program that allows you to get a simple form of
  16.           input from a user.  It is most useful in Execute scripts.
  17.  
  18.           You may specify a Prompt string, which will be displayed to
  19.           the user, and you may also specify a string to match on for
  20.           both YES and NO responses, as well as specifying a time
  21.           limit on the users response in seconds.  All of these
  22.           strings have default values, the default for the WARN string
  23.           is 'Y', the default for the OK string is 'N', and the
  24.           default for the Prompt is a single question mark.
  25.  
  26.           If the user enters a string which matches the WARN string,
  27.           Ask will exit with a return code that will cause an IF WARN
  28.           statement to succeed.  If the user enters a string which
  29.           matches the OK string, exceeds the value given in TIMEOUT,
  30.           or simply hits RETURN then Ask will exit with a ZERO return,
  31.           suitable for the ELSE portion of such an IF statement.
  32.  
  33.           If the user enters a string other than those specified in
  34.           WARN and OK, then ASK will redisplay the prompt, urging the
  35.           user to give a better answer.
  36.  
  37.      EXAMPLE
  38.           Here is an example of an Ask command which will return a
  39.           WARNING if the user types "Amiga", and an OK if the user
  40.           types "BigBlue", or waits longer than 10 seconds to respond:
  41.  
  42.           Ask "Amiga or BigBlue?" "Amiga" "BigBlue" Timeout 10
  43.           IF WARN  ; typed amiga!
  44.           Echo "Obviously a person of quality"
  45.           ELSE ; typed big blue? or couldn't decide
  46.           Echo "You seem to be misguided"
  47.           ENDIF
  48.  
  49.  
  50.  
  51.      SEE ALSO
  52.           AshManual, Execute
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/28/89)
  64.  
  65.  
  66.  
  67.